user: Describe Viewport Display from the Blender manual or Python API, including usage steps and snippets.

assistant: # Viewport Display

[image reference removed]

The Display panel.

Display As
:   This controls the way the all the bones of the armature appear in the 3D Viewport.
    Individual bones can also can override this using bone [Display Type](../bones/properties/display.html#bpy-types-bone-display-type).

    |  |  |
    | --- | --- |
    | <../../../_images/animation_armatures_properties_display_octahedral.png>   Octahedral bone display. | <../../../_images/animation_armatures_properties_display_stick.png>   Stick bone display. |
    | <../../../_images/animation_armatures_properties_display_b-bone.png>   B-Bone bone display. | <../../../_images/animation_armatures_properties_display_envelope.png>   Envelope bone display. |

    Octahedral
    :   This is the default visualization, well suited for most of editing tasks. It materializes:

        - The bone root (“big” joint) and tip (“small” joint).
        - The bone “size” (its thickness is proportional to its length).
        - The bone roll (as it has a square section).

        [[image reference removed]](../../../_images/animation_armatures_properties_display_type-octahedral.png)

        Note the 40° rolled Bone.001 bone.

    Stick
    :   This is the simplest and most non-intrusive visualization.
        It just materializes bones by sticks of constant (and small) thickness,
        so it gives you no information about root and tip, nor bone size or roll angle.

        [[image reference removed]](../../../_images/animation_armatures_properties_display_type-stick.png)

        Note that Bone.001 roll angle is not visible (except by its XZ axes).

    B-Bone
    :   This visualization shows the curves of “smooth” multi-segmented bones;
        see the [Bendy Bones](../bones/properties/bendy_bones.html) for details.

        |  |  |
        | --- | --- |
        | <../../../_images/animation_armatures_bones_properties_bendy-bones_b-bones-1.png>   An armature of B-Bones, in Edit Mode. | <../../../_images/animation_armatures_bones_properties_bendy-bones_b-bones-3.png>   The same armature in Object Mode. |

    Envelope
    :   This visualization materializes the bone deformation influence.
        More on this in the [bone page](../bones/structure.html#armature-bone-influence).

        [[image reference removed]](../../../_images/animation_armatures_bones_structure_envelope-pose-mode.png)

    Wire
    :   This simplest visualization shows the curves of “smooth” multi-segmented bones.

        |  |  |
        | --- | --- |
        | <../../../_images/animation_armatures_properties_display_type-wire-pose-mode.png>   An armature of Wire, in Pose Mode. | <../../../_images/animation_armatures_properties_display_type-wire-edit-mode.png>   The same armature in Edit Mode. |

Show
:   Names
    :   Displays the name of each bone.

    Shapes
    :   When enabled, the default standard bone shape is replaced,
        in *Object Mode* and *Pose Mode*, by the shape of a chosen object
        (see [Shaped Bones](../bones/properties/display.html) for details).

    Bone Colors
    :   Draws bones in their configured colors. Disable to always draw bones in the default color.
        For more details see [Bone Colors](../bones/properties/display.html#bpy-types-bone-color).

    In Front
    :   When enabled, the bones of the armature will always be shown on top of
        the solid objects (meshes, surfaces, …). I.e. they will always be visible and selectable
        (this is the same option as the one found in the *Display* panel of the *Object data* tab).
        Very useful when not in *Wireframe* mode.

Axis
:   When enabled, the (local) axes of each bone are displayed (only relevant for *Edit Mode* and *Pose Mode*).

    Position
    :   The position for the axes display on the bone.
        Increasing the value moves it closer to the tip; decreasing moves it closer to the root.

Relations
:   Whether the [Relationship Lines](../../../editors/3dview/display/overlays.html#bpy-types-view3doverlay-show-relationship-lines)
    overlay should be drawn from each parent’s tail or head.
    The lines are always drawn towards the children’s heads.