From BlenderWiki

Jump to: navigation, search
Blender3D FreeTip.gif
IMPORTANT! Do not update this page!
We have moved the Blender User Manual to a new location. Please do not update this page, as it will be locked soon.

Page status (reviewing guidelines)

Page reviewed and in good shape

Transform Orientations

Mode: Object and Edit modes

Hotkey: AltSpace

Transform orientations selection menu.

Orientations affect the behavior of Transformations: Location, Rotation, and Scale. You will see an effect on the 3D Manipulator (the widget in the center of the selection), as well as on transformation constraints (like axis locking). This means that, when you hit GX, it will constrain to the global x-axis, but if you hit GXX it will constrain to your Transform Orientations x-axis.

Alt+Space Menu.

The Orientations options can be set on the 3D View's header (or "footer", since it is at the bottom of the view by default), or with AltSpace or through the Orientation menu in a 3D view header.

In addition to the four built-in options, you can define a Custom Orientation.

Our Demo Cube

To demonstrate the various behaviors, we add some colors to the default cube, rotate it -15º along its local z- and x-axes, and we scale its "y" face down.

Please note two things:

  • The "Mini-axis" in the lower-left corner, which represents the Global x/y/z orientation.
  • The "Object Manipulator" widget emanating from the selection, which represents the current Transform Orientation.
    • If you click on one of the axes of the Manipulator with LMB Template-LMB.png, it will allow you to constrain movement to only this direction. An example of a keyboard equivalent is GZZ.
    • If you ⇧ ShiftLMB Template-LMB.png click, it will lock the axis you clicked on and allow you to move in the plane of the two remaining axes. The keyboard analogue is G⇧ ShiftZ⇧ ShiftZ.




The manipulator matches the global axis. When using the Global orientation, the orientation's x,y,z matches world's x,y,z axis. When this mode is selected, the local coordinates of the object are subjected to the Global coordinates. This is good to place objects in the scene. To constrain an axis, hit G and the desired axis. To constrain to a local axis, hit the desired axis two times. The difference between Global and Local, is more noticeable when you have an object in which the origin is not located at the exact center of the object, and doesn't match the Global coordinates.



The manipulator matches the object axis. Notice that, here, the Manipulator is at a slight tilt (it is most visible on the object's y-axis, the green arrow). This is due to our 15º rotation of the object. This demonstrates the difference between local coordinates and global coordinates. If we had rotated the object 90º along its x-axis, we would see that the object's "Up" is the world's "Forward" -- or the object's z-axis would now be the world's y-axis. This orientation has an effect on many parts of the interface, so it is important to understand the distinction.



The z-axis of the manipulator will match the normal vector of the selected object. In Object Mode, this is equivalent to Local Orientation, but in Edit Mode, it becomes more interesting.

As you see, the light blue lines indicate the faces' normals, and the darker blue lines indicate the vertex normals (these were turned on in the N Properties Panel under Mesh Display » Normals » Face and Vertex). Selecting any given face will cause our Manipulator's z-axis to align with that normal. The same goes for Vertex Select Mode. Edge Select is different--A selected Edge has the z-axis aligned with it (so you will have to look at the Manipulator widget to determine the direction of x and y). If you select several elements, it will orient towards the average of those normals.

A great example of how this is useful is in Vertex Select Mode: Pick a vertex and then do GZZ to tug it away from the mesh and shove it into the mesh. To make this even more useful, select a nearby vertex and hit ⇧ ShiftR to repeat the same movement---except along that second vertex's normal instead.



Gimbal's behavior highly depends on the Rotation Mode that you are in (accessible in the N Properties Panel in the 3D View, in top section, Transform).

XYZ Euler
the default rotation mode, the object Manipulator's z-axis will always point to the global z-axis, where the other two will remain perpendicular to each other.
In the other Euler rotation modes, the last axis applied will be the one for which the Manipulator stays fixed. So, for YZX Euler, the x-axis of the Manipulator will be the same as the global x-axis.
Axis Angle
The x, y, and z coordinates define a point relative to the object origin through which an imaginary "skewer" passes. The w value is the rotation of this skewer. Here, the Manipulator's z-axis stays aligned with this skewer.
Though Quaternion rotation is very different from the Euler and Axis Angle rotation modes, the Manipulator behaves the same as in Local mode.



The manipulator will match the 3D view, Y → Up/Down, X → Left/Right, Z → Towards/Away from you.

This way you can constrain movement to one View axis with GXX.

Custom Orientations

Mode: Object and Edit modes

Hotkey: CtrlAltSpace

custom orientation

You can define custom transform orientations, using object or mesh elements. Custom transform orientations defined from objects use the local orientation of the object whereas those defined from selected mesh elements (vertices, edges, faces) use the normal orientation of the selection.

The Transform Orientations panel, found in the "N Properties Panel," can be used to manage transform orientations: selecting the active orientation, adding and deleting custom orientations.

Renaming a Custom Orientation

The default name for these orientations comes from whatever you have selected. If an edge, it will be titled, "Edge," if an object, it will take that object's name, etc. The Toolshelf (T in the 3D View) allows you to rename the custom orientation after you hit CtrlAltSpace.

Figure 1.

The technique of creating custom orientations can become important in creating precise meshes. In Figure 1, to achieve this effect:

  1. Select the object's sloping top edge
  2. Create a Custom Orientation with CtrlAltSpace and rename it "Top Edge".
  3. Select the objects's bottom, right edge.
  4. Extrude with E.
  5. Cancel the extrusion's default movement by hitting RMB Template-RMB.png or Escape.
  6. Hit G to reinitiate movement.
  7. Hit ZZ to constrain to the "Top Edge" orientation.

Blender3D FreeTip.gif
This is the old manual!
For the current 2.7x manual see

User Manual

World and Ambient Effects


World Background

Ambient Effects

Stars (2.69)

Game Engine


Introduction to the Game Engine
Game Logic Screen Layout


Logic Properties and States
The Logic Editor


Introduction to Sensors
Sensor Editing
Common Options
-Actuator Sensor
-Always Sensor
-Collision Sensor
-Delay Sensor
-Joystick Sensor
-Keyboard Sensor
-Message Sensor
-Mouse Sensor
-Near Sensor
-Property Sensor
-Radar Sensor
-Random Sensor
-Ray Sensor
-Touch Sensor


Controller Editing
-AND Controller
-OR Controller
-NAND Controller
-NOR Controller
-XOR Controller
-XNOR Controller
-Expression Controller
-Python Controller


Actuator Editing
Common Options
-2D Filters Actuator
-Action Actuator
-Camera Actuator
-Constraint Actuator
-Edit Object Actuator
-Game Actuator
-Message Actuator
-Motion Actuator
-Parent Actuator
-Property Actuator
-Random Actuator
-Scene Actuator
-Sound Actuator
-State Actuator
-Steering Actuator
-Visibility Actuator

Game Properties

Property Editing

Game States



Camera Editing
Stereo Camera
Dome Camera




Material Physics
No Collision Object
Static Object
Dynamic Object
Rigid Body Object
Soft Body Object
Vehicle Controller
Sensor Object
Occluder Object

Path Finding

Navigation Mesh Modifier

Game Performance

Framerate and Profile
Level of Detail

Python API

Bullet physics


Standalone Player
Licensing of Blender Game

Android Support

Android Game development