docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Editor tools and shortcuts


    Labelled 2D Animation Skinning Editor tools

    The Skinning Editor tools are split-up into the following groups:

    A. Editor toolbar

    B. Pose tools

    C. Bone tools

    D. Geometry tools

    E. Weight tools

    F. Rig tools

    Editor toolbar

    This toolbar lets you toggle between Character and Sprite Sheet modes. It also contains the Visibility toggle.

    Tool Default Shortcut Function
    Toggle View Mode
    Toggle View Mode
    Shift + 2 Switch between the Character and Sprite Sheet view modes.
    Visibility eyecon
    Visibility
    Shift + P Toggles the Sprite visibility panel, which controls the visibility of the Sprite meshes and bones in the editor window.
    Toggle Tool Text Shift + ` Show or hide text on tool buttons.

    Pose tools

    This is a toolbar that contains the options to Preview Pose and restore the default pose with Restore Pose.

    Tool Default Shortcut Function
    Preview Pose
    Preview Pose
    Shift + Q Enable this mode when moving and rotating an actor's model and joints to preview its poses after rigging. Any changes made in this mode are not saved.
    Reset Pose
    Reset Pose
    Shift + 1 Restores an actor's bones and joints to their original positions.
    Set Pivot
    Set Pivot
    Shift + T Enable this tool to edit the pivot point of the actor with the Pivot Panel options.

    Pivot Panel

    The Pivot Panel appears when you enable the Set Pivot tool.

    Property Function
    Pivot Select the desired location of the Pivot from the dropdown menu.
    Position Enter a value from 0 to 1 to adjust the X and Y position of the pivot. This is a normalized value from 0 to 1, where (0,0) is lower left of workspace and (1,1) is the upper right of the workspace.

    Bone tools

    Use the Bone Tools to create and edit the bones of your character and their hierarchy.

    Tool Default Shortcut Function
    Edit Bone
    Edit Bone
    Shift + W Reposition the bones into a new position. These changes are automatically saved as the default bind pose for the Restore Bind Pose tool. Sprite geometry does not deform with the bones in this mode, even if the bones are attached as influencers.
    Create Bone
    Create Bone
    Shift + E Click and drag to create bones.
    Split Bone
    Split Bone
    Shift + R Splits the selected bone.

    Bone panel

    The Bone panel appears at the lower right of the editor window when you select a bone with one of the Bone Tools active.

    Property Function
    Name Displays the name of the selected bone. Enter a new name here to rename the selected bone.
    Position The world position of the bone.
    Rotation The world rotation value of the bone.
    Bone Color The color of the bone.
    Depth Displays the Z-value of the selected bone that determines the render order of the vertices under its influence (refer to the examples below). Enter a new value (which can be negative) to change the render order of the affected vertices. Refer to the bone tab and hierarchy tree documentation for more information on how the Depth value affects the way the Sprite mesh is rendered and deformed.

    Setting the Depth value

    The following examples show how the Depth value of a selected bone affects the render order of the mesh vertices it influences. In this example, the selected bone (orange) and has an intitial Depth value of 1.

    Example 1: With the Depth value of 1, the vertices that are influenced by it (the blue are of the Sprite and mesh) appear in front of the other vertices, which have a lower Depth value.

    However, by setting the bone's Depth to -1 instead,

    When the selected bone’s Depth is set to -1 instead, the vertices that are influenced by it appears behind of the other vertices.

    Geometry tools

    Use the Geometry tools to generate and edit the meshes of the different Sprites that make up your character.

    Tool Default Shortcut Function
    Auto Geometry
    Auto Geometry
    Shift + A Select to auto-generate meshes for Sprites. When this tool is selected, the Geometry panel becomes available at the lower right of the Skinning Editor.
    Edit Geometry
    Edit Geometry
    Shift + S Edit generated meshes by repositioning vertices.
    Create Vertex
    Create Vertex
    Shift + D Create new vertices to create geometry.
    Create Edge
    Create Edge
    Shift + G Create new edges to create geometry.
    Split Edge
    Split Edge
    Shift + H Split an existing edge into two.

    Geometry panel

    The Geometry panel is only visible when Auto Geometry is enabled. It contains the available settings that affect how the geometry of selected Sprites are generated.


    Visible only when Auto Geometry is enabled.

    Property Function
    Outline Detail Use the slider to adjust the accuracy of the generated geometry’s outline to the outline of the Sprite. Smaller values create simpler outlines, while larger values create denser outlines that fit to the Sprite’s outline more accurately.
    Alpha Tolerance Use the slider to set the alpha value threshold to consider when generating geometry. Pixels with an alpha value lower than the set tolerance value are considered transparent during outline detection when the geometry is generated.
    Subdivide Use the slider to adjust the tessellation of the Sprite mesh by adding or decreasing the number of vertices inside the generated mesh.
    Weights Enable to automatically assign weights between the generated geometry mesh and nearby bones.
    Generate For Selected/Generate For All Visible Select this button to generate a geometry mesh for selected Sprites based on the property settings above. To generate geometry for all Sprites in the Skinning Editor, do not have any Sprite selected when you select this button.

    Weight tools

    Vertices in the generated geometry meshes are influenced by different bones which affect how the meshes deform during animation. The percentage of influences from different bones for each vertex is contained in the weight information assigned to that vertex, which you can control with the following Weight tools.

    To add weights to your Sprites, you can first ensure that there are bones overlaying the Sprites and geometry has been generated.

    Tool Default Shortcut Function
    Auto Weights
    Auto Weights
    Shift + Z Auto-generate weights between the geometry and bones. When this tool is selected, the Weights panel becomes available at the lower right of the Skinning Editor that displays the available settings and the option to generate weights for.
    Weight Slider
    Weight Slider
    Shift + X Use the slider to adjust weights.
    Weight Brush
    Weight Brush
    Shift + N Adjust weights by painting with a brush.
    Bone Influence
    Bone Influence
    Shift + V Select which bones influence a Sprite.
    Sprite Influence
    Sprite Influence
    Shift + M Select which Sprites are being influenced by a bone.

    Weights panel

    The Weights panel appears at the lower right of the Sprite Editor window when Auto Weights under the Weight tools is selected.

    Property Function
    Associate Bones Select this box to automatically associate bones to the Sprite geometry they overlay.
    Generate/Generate All Select this button to generate weights for the currently selected Sprite, or for all Sprites if no Sprite is selected. This does not do anything if geometry has not been generated for the Sprites, or if no bones are associated with the Sprite geometry.
    Normalize Normalizes the weights of the selected Sprite, or all Sprites if no specific Sprite is selected.
    Clear Clear the weights of the selected Sprite, or of all Sprites if no specific Sprite is selected.

    Weight Slider

    Property Function
    Mode The current behavior of the Weight Slider tool.
        Add and Subtract Select this mode to have all sliders influence all vertices around the selected bone (currently displayed in the Bone property).
        Grow and Shrink Select this mode to have all sliders influence only vertices that are already affected by the selected bone (which is selected in the Bone property).
        Smooth Averages the weights of all vertices with their neighbors to create an even distribution of weight across all vertices.
    Bone (unavailable if Mode > Smooth) Displays the currently selected bone. Use the drop-down menu to select a different bone, or select another bone.
    Normalize Select this to ensure the total normalized weight of all vertices of a selected Sprite mesh is equal to one.
    Amount Amount of weight applied on selected vertices.
    Vertex Weight Adjust the bone weights of selected vertices.

    Weight Brush

    Property Function
    Mode The current behavior mode of the weights tool.
        Add and Subtract Select this mode to have all sliders influence all vertices around the selected bone.
        Grow and Shrink Select this mode to have all sliders influence only vertices that are already affected by the selected bone.
        Smooth Averages the weights of vertices with their neighbors to create a smoother distribution of weights.
    Bone The bone that the Brush is painting influence for. Select a different bone via the drop-down menu.
    Normalize Enable to ensure the normalized weight of painted vertices will equal to 1.
    Size Size of the weight brush cursor.
    Hardness Amount of weight applied by the brush per brushstroke. Higher values increase the weight per brushstroke, up to the maximum of 100 where the full weight is applied at once.
    Step Number of increments needed to apply the full weight of brush.

    Bone Influences panel

    The Bone Influences panel displays a list of bones that are currently influencing the selected Sprite mesh.

    When the Skinning Editor is set to Character mode, the Bone Influences panel allows you to add a bone to the list which includes its influence in the deformation of the selected Sprite’s mesh, or remove a bone from the list which removes its influence instead.

    To add a bone to the list, select the bone in the Skinning Editor window and then select Add (+) at the lower right of the panel. To remove a bone from the list, select the bone in the list or in the editor window and then select Remove (-).

    Rearranging bone order

    You can rearrange the bone order in the Bone Influences panel by selecting and the dragging the respective bone entries up or down the list.

    The order of the bones in the Bone Influences panel determines the order of the bones on the Sprite Skin component. This is especially important when replacing the Sprite for deformation in the Sprite Renderer, such as when using Sprite Swap, as you can ensure the bone order remains the same between the Sprites and that the correct Transform drives the correct deformation.

    Sprite Influences panel

    The Sprite Influences panel displays a list of Sprite meshes that are currently being influenced by the selected bone.

    When the Skinning Editor is set to Character mode, the Sprite Influences panel allows you to remove an unwanted Sprite mesh from the list so that it’s not influenced by the selected bone. It’s also possible to add a selected Sprite to the list which will include the selected bone’s influence in its deformation.

    To add a Sprite mesh to the list, select the bone in the Skinning Editor window as well as the Sprite you want to add, and then select Add (+) at the lower right of the panel. To remove a Sprite from the list, select it in the list or in the editor window and then select Remove (-).

    Rig tools

    The Rig tools contain the option to Copy and Paste bones from and into a skeleton rig.

    Tool Default Shortcut Function
    Copy
    Copy
    Ctrl + C Copies the bone and mesh data from the current selection.
    Paste
    Paste
    Ctrl + V Pastes the copied bone and mesh data to the current selection.
    Paste
    Paste
    Shift + B Use this shortcut to show additional pasting options.

    Copy and Paste behavior

    Once you have rigged the skeleton and bone weights of your actor, you can reuse the same rigged skeleton with other Model Prefabs by using the Copy and Paste options on the Rig tools. This is useful if you need to quickly create characters that share the same build and animations.

    You can only Copy and Paste if the source and destination Model Prefabs have the same number of Sprites and Sprite names. When you Copy and Paste the bone and mesh data, the following occurs:

    1. Copied bone data is pasted to the destination.
    2. Mesh, weights, and bone association of source Sprite(s) are pasted to destination Sprite(s) with the same names.

    Copy behavior

    To copy sprite data, select a sprite and then select Copy. This copies the mesh and bone data associated with that sprite. If no sprite is selected, then this copies the data of all sprites' currently in the Skinning Editor window instead.

    Paste behavior

    To paste copied sprite data, select the Paste button. This opens the Paste panel at the lower right of the editor window which contains the following data options. Select which data you want to paste from the copied sprite data.


    Paste dialog box.

    Option Function
    Bones Paste bone data.
    Mesh Paste mesh data.
    Flip X Paste the data but mirrored along the X-axis.
    Flip Y Paste the data but mirrored along the Y-axis.

    To paste copied sprite data, select a sprite and then select Paste. This pastes the selected data to a selected sprite. If no sprite is selected, then this pastes the data to all sprites’ currently in the Skinning Editor window with the same name as the copied sprite.

    In This Article
    Back to top
    Copyright © 2024 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)