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)

Text retarget conversion method Images some images need updated
Proposed fixes: none

Skeleton Sketching

The Skeleton Sketching panel in its default (inactive) state.

If you think that creating a whole rig by hand, bone after bone, is quite boring, be happy: some Blender developers had the same feeling, and created the Skeleton Sketching tool, formerly the Etch-a-ton tool, which basically allows you to “draw” (sketch) whole chains of bones at once.

Skeleton Sketching is obviously only available in Edit mode, in the 3D views. You control it through its Skeleton Sketching panel in the Transform panel, which you can open with N. Use mouse (LMB Template-LMB.png to draw strokes, and RMB Template-RMB.png for gestures. Showing its tool panel won’t enable sketching – you must tick the checkbox next to Skeleton Sketching to start drawing bone chains (otherwise, you remain in the standard Edit mode…).

Sketching is done in two steps:

  1. Drawing some “smooth” and/or polygonal lines (called “strokes”). Each stroke corresponds to a chain of bones.
  2. Converting these strokes into real chains of bones, using different methods.

The point of view is important, as it determines the future bones’ roll angle: the Z axis of a future bone will be aligned with the view Z axis of the 3D view in which you draw its “parent” stroke (unless you use the Template converting method…). Strokes are drawn in the current view plane passing through the 3D cursor, but you can create somewhat “3D” strokes using the Adjustdrawing option in different views (see below).

If you enable the small Quick Sketch option, the two steps are merged into one: once you have finalized the drawing of a stroke (see below), it is immediately converted to bones (using the current active method) and deleted. This option makes bone sketching quick and efficient, but you lose all the advanced stroke editing possibilities…

Sketches are not saved into Blender files, so you can’t interrupt a sketching session without losing all your work! Note also that the sketching is common to the whole Blender session, i.e. there is only one set of strokes (one sketch) in Blender, and not one per armature, or even per file…

Drawing Chains

Strokes example. From top to bottom:
A selected polygonal stroke of four straight segments, oriented from left to right.
An unselected free stroke of two segments, oriented from left to right.
A mixed stroke, with one straight segment between two free ones, right to left.

So, each stroke you draw will be a chain of bones, oriented from the starting point (the reddest or most orange part of the stroke) to its end (its whitest part). A stroke is made of several segments, delimited by small black dots – there will be at least one bone per segment (except with the Template conversion method, see next page), so all black points represents future bones’ ends. There are two types of segments, which can be mixed together:

Straight Segments

To create a straight segment, click LMB Template-LMB.png at its starting point. Then move the mouse cursor, without pressing any button – a dashed red line represents the future segment. Click LMB Template-LMB.png again to finalize it. Each straight segment of a stroke will always create one and only one bone, whatever convert algorithm you use (except for the Retarget conversion method).

The first segment has been started (LMB Template-LMB.png click) and the mouse moved to its end point.
The first segment has been finalized by a second LMB Template-LMB.png click, which also started a new segment…
Repeating these steps, we now have a four-segment polygonal stroke.

Free Segments

To create a free (curved) segment, click and hold LMB Template-LMB.png at its starting point. Then draw your segment by moving the mouse cursor – as in any paint program! Release LMB Template-LMB.png to finalize the segment – you will then be creating a new straight segment, so if you would rather start a new free segment, you must immediately re-press LMB Template-LMB.png… The free segments of a stroke will create different number of bones, in different manners, depending on the conversion method used. The future bones’ ends for the current selected method are represented by small green dots for each one of those segments, for the selected strokes only.

The free segment drawing uses the same Manhattan Dist setting as the grease pencil tool (User Preferences window, Edit Methods “panel”, Grease Pencil group) to control where and when to add a new point to the segment – so if you feel your free segments are too detailed, raise this value a bit, and if you find them too jagged, lower it.
While drawing a first free segment (LMB Template-LMB.png click and drag).
The first free segment finalized (releasing LMB Template-LMB.png).
If you now move the mouse without pressing LMB Template-LMB.png again, you’ll create a straight segment…
But if you immediately click again and drag LMB Template-LMB.png, you’ll instead start a new free segment.
Drawing free segments example.

You finalize a whole stroke by clicking RMB Template-RMB.png. You can cancel the stroke you are drawing by hitting Esc. You can also snap strokes to underlying meshes by holding Ctrl while drawing. By the way, the Peel Objects button at the bottom of the Bone Sketching panel is the “same thing” as the “monkey” button of the snapping header bar controls shown when Volume snap element is selected – see the snap to mesh page for details.

Selecting Strokes

A stroke can be selected (materialized by a solid red-to-white line), or not (shown as a orange-to-white line) – see (Strokes example) above. As usual, you select a stroke by clicking RMB Template-RMB.png on it, you add one to/remove one from the current selection with a ⇧ ShiftRMB Template-RMB.png click, and A (de)selects all strokes…


Hitting X or clicking on the Delete button (Bone Sketching panel) deletes the selected strokes (be careful, no warning/confirmation pop-up menu here…). See also the gesture description below.

Modifying Strokes

You can adjust, or “redraw” your strokes by enabling the Overdraw Sketching option of the Bone Sketching panel. This will modify the behavior of the strokes drawing (i.e. LMB Template-LMB.png clicks and/or hold): when you draw, you won’t create a new stroke, but rather modify the nearest one. The part of the old stroke that will be replaced by the new one are drawn in gray. This option does not take into account stroke selection, i.e. all strokes can be modified this way, not just the selected ones… Note also that even if it is enabled, when you draw too far away from any other existing stroke, you won’t modify any of them, but rather create a new one, as if Overdraw Sketching was disabled.

Adjusting a stroke: the gray part of the “unselected” (orange) stroke will be replaced by the currently drawn “replacement”.
Stroke adjusted.
Adjusting stroke example.

Finally, note that there is no undo/redo for sketch drawing…


There quite a few things about strokes editing that are only available through gestures. Gestures are started by clicking and holding ⇧ Shift+LMB Template-LMB.png (when you are not already drawing a stroke…), and materialized by blue-to-white lines. A gesture can affect several strokes at once.

There is no direct way to cancel a gesture once you’ve started “drawing” it. So the best thing to do, if you change your mind (or made a “false move”), is to continue to draw until you get a disgusting scribble, crossing your stroke several times – in short, something that the gesture system would never recognize!

Damn! I didn’t want to cut this stroke here!
Let’s doodle a bit…
Phew! That was close, but the stroke is still in one piece…


To cut a segment (i.e. add a new black dot inside it, making two segments out of one), “draw” a straight line crossing the chosen segment where you want to split it.



To delete a stroke, draw a “V” crossing the stroke to delete twice.



To reverse a stroke (i.e. the future chain of bones will be reversed), draw a “C” crossing twice the stroke to reverse.


Converting to Bones

Once you have one or more selected strokes, you can convert them to bones, using either the Convert to Bones button of the Skeleton Sketching panel. Each selected stroke will generate a chain of bones, oriented from its reddest end to its whitest one. Note that converting a stroke does not delete it.

There are four different conversion methods – three “simple” ones, and one more advanced and complex, Retarget, that reuses bones from the same armature or from another one as a template for the strokes to convert, and which is detailed in the next page. Anyway, remember that straight segments are always converted to one and only one bone (except for the Template conversion method), and that the future bones’ ends are shown as green dots on selected free segments.

Remember also that the roll rotation of the created bones has been set during their “parent” stroke drawing (except for the Template conversion method) – their Z axis will be aligned with the view Z axis of the active 3D view at draw time.


With this method, each free segment of the selected strokes will be uniformly divided in n parts (set in Num numeric field), i.e. will give n bones.

The Fixed conversion settings and its preview on selected strokes.
The Fixed conversion result.


With this method, each free segment of the selected strokes will create as many bones as necessary to follow its shape closely enough – this “closely enough” parameter being set by the Threshold numeric field; higher values giving more bones, following more closely the segments’ shape. So the more twisted a free segment, the more bones it will generate.

The Adaptative conversion settings and its preview on selected strokes.
The Adaptative conversion result.


With this method, each free segment of the selected strokes will create as many bones as necessary, so that none of them is longer than the Length numeric field value (in Blender Units).

The Length conversion settings and its preview on selected strokes.
Using a larger length value.
The Length conversion result.


Retarget template bone chain to stroke.

Template armature that will be retargeted to the stroke. This is a more complex topic, detailed in its own page.

Retarget roll mode
Method used to adjust the roll of bones when retargeting
Don’t adjust roll.
Roll bones to face the view.
Roll bone to original joint plane offset.
Automatically generate values to replace &N and &S suffix placeholders in template names
Text to replace &N with (e.g. ‘Finger.&N’ -> ‘Finger.1’ or ‘Finger.One’)
Text to replace &S with (e.g. ‘Arm.&S’ -> ‘Arm.R’ or ‘Arm.Right’)

See more details about this method here.

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