Cavalry
  • Welcome
  • Getting Started
    • Requirements
    • Installation
    • Sign In
      • Proxy Server
    • Quick Start
    • Example Files
    • Key Concepts
      • Nodes
      • Connections
      • Context
  • User Interface
    • Menus
      • File menu
      • Edit menu
      • View menu
      • Composition menu
      • Create menu
      • Animation menu
      • Shape menu
      • Tool menu
        • Select tool
        • Edit Shape tool
        • Pen tool
        • Pencil tool
        • Line tool
        • Text tool
        • Rectangle tool
        • Ellipse tool
        • Polygon tool
        • Star tool
        • Arc tool
        • Super Ellipse tool
        • Cog tool
        • Arrow tool
        • Capsule tool
      • Window menu
        • Align Window
        • Animation Utilities
        • Assets Window
          • Google Sheets Asset
          • Image Sequences
          • Project Settings
        • Attribute Editor
          • Control Rows
            • Controls Rows - Types
            • Control Rows - Interaction
        • Color window
          • Palettes
        • Control Center
        • Quick Add window
        • Flow Graph
        • Glyph Browser
        • Playback Controls
        • Preferences
        • Render Manager
          • Lottie Export
          • Dynamic Rendering
          • Render Tokens
        • Scene Window
          • Scene Tree
            • Composition Settings
          • Time Editor
          • Graph Editor
          • Keyframe Layers
        • Shelf
        • Tags
        • Toolbar
        • Viewport
          • Rulers
      • Help menu
    • Widgets
      • Gradient
      • Graph Attribute
    • General
      • Aliasing
      • Blend Modes
      • Distribution Types
        • Array Distribution
        • Circle Distribution
        • Fibonacci Distribution
        • Grid Distribution
        • Linear Distribution
        • Mask Distribution
        • Math Distribution
        • Path Distribution
        • Point Distribution
        • Random Distribution
        • Rose Distribution
        • Shape Edges Distribution
        • Shape Points Distribution
        • Shuffle Distribution
        • Sub-Mesh Distribution
        • Voxelize Distribution
      • Color Management
      • Motion Blur
      • Vector artwork support
  • Nodes
    • Shapes
      • Common Attributes (Shapes)
      • Background Shape
      • Basic Line
        • Bézier
        • Line
        • Spiral
      • Basic Shape
        • Arc
        • Arrow
        • Capsule
        • Cogwheel
        • Ellipse
        • Polygon
        • Rectangle
        • Ring
        • Star
        • Super Ellipse
      • Cel Animation Shape
      • Composition
      • Connect Shape
      • Convex Hull
      • Custom Shape
      • Duplicator
      • Editable Shape
      • Footage Shape
      • Group
      • Image to Shapes
      • Layout Shape
        • Grid Layout
        • Horizontal Layout
        • Vertical Layout
      • Outline
      • Points to Curve
      • Quad Tree Shape
      • Rectangle Pattern
      • SVG
      • Spacer
      • Sub-Mesh Bounding Box
      • Text Shape
      • Trails
    • Behaviours
      • Common Attributes (Behaviours)
      • 3D Matrix
      • Add Divisions
      • Align
      • Alpha Material Override
      • Apply Distribution
      • Apply Layout
      • Behaviour Mixer
      • Bevel
      • Blend Shape
      • Blend Sub-Mesh Positions
      • Boolean
      • Clean Up
      • Color Blend
      • Color Material Override
      • Curve to Lines
      • Distance
      • Fill Rule
      • Flare
      • Flatten Shape Layers
      • Frame
      • Get Vector
      • HSV Material Overide
      • Is Within
      • Look At
      • Manipulator
      • Material Sampler
      • Modulate
      • Morph
      • Noise
      • Number Range
      • Number Range to Color
      • Oscillator
      • Path Offset
      • Pathfinder
      • Pinch
      • Position Blend
      • Push Along Vector
      • Random
      • Resample Path
      • Round
      • Rubber Hose Limb
      • Simple Value Solver
      • Simple Value2 Solver
      • Skew
      • Sound
      • Split Path
      • Spring
      • Squetch
      • Stagger
      • Sub-Mesh
      • Subdivide
      • Swap Color Override
      • Value
      • Value 2
      • Value Blend
      • Value2 Blend
      • Visibility Sequence
      • Voxelize
    • Utilities
      • Animation Control
      • Apply Font Size
      • Array Manipulator
      • Asset Array
      • Bounding Box
      • Bounding Box Constraint
      • Color Array
      • Color Info
      • Composition Constraint
      • Component Constraint
      • Context Index
      • Falloff
      • Get Name
      • HSV Color
      • If Else
      • Index to Color
      • JS Math
      • Length Context
      • Local Time
      • Math
      • Math2
      • Math 3
      • Measure
      • Mesh Array
      • Null
      • Path Length
      • Regex
      • Rig Control
      • Sequence
      • Shader Array
      • Spreadsheet
      • Spreadsheet Lookup
      • String
      • String Array
      • String Generator
        • Formatted String Generator
        • Hash Generator
        • Hexadecimal Generator
        • Random Date Generator
        • Random Number Generator
        • Timecode Generator
        • Value Generator
      • String Length
      • String Manipulator
        • Change String Case Manipulator
        • Join String Manipulator
        • Replace String Manipulator
        • Regex String Manipulator
        • Resize String Manipulator
        • Shuffle String Manipulator
        • Sub-String Manipulator
        • Transition String Maniplulator
      • Transform Constraint
      • Typeface
      • Typeface Array
      • Value Array
      • Value 2 Array
      • Value 2 Array
      • Velocity Context
      • Velocity Magnitude Context
    • Effects
      • Blur
      • Color Shader
      • Drop Shadow
      • Fill
      • Gradient Shader
      • Image Shader
      • Invert
      • Levels
      • Linear Wipe
      • Mask Blur
      • Noise Shader
      • Radial Wipe
      • SkSL Shader
      • Shape to Shader
      • Tri Tone
      • Venetian Blinds
  • Tips
    • Shortcuts
  • Applications
    • Cavalry Player
    • Cavalry CLI
  • Technical Information
    • Licencing
    • Logs
    • Mathematical Expressions
    • Release Notes
      • 1.1.1 Release Notes
      • 1.1 Release Notes
      • 1.0.3 Release Notes
      • 1.0.2 Release Notes
      • 1.0.1 Release Notes
    • User Preferences
Powered by GitBook
On this page
  • Tool Settings
  • Shortcuts

Was this helpful?

  1. User Interface
  2. Menus
  3. Tool menu

Edit Shape tool

Select and manipulate points on editable Shapes.

PreviousSelect toolNextPen tool

Last updated 4 years ago

Was this helpful?

The Edit Shapes tool only works with editable Shapes. To make an editable Shape either check the Make Editable Primitives option when using the / / / Tools or use the Make Editable command from the menu (cmd/ctrl + e). The , and tools all make editable Shapes by default.

The Edit Shape tool can be used to manipulate points on editable Shapes.

Select

To select a point(s) click a shape and then either:

  • click a point.

  • click + drag to marquee select several points (pre selection highlighting to come).

  • cmd/ctrl + click to add points to your selection.

  • double click a point to select all the points on a Shape.

Clicking anywhere outside a Shape will deselect all points.

Move

To move a point simply click + drag one.

Edit

Points can be either corner or bezier points.

To convert a point or points from corner to bezier you can use the Shape > Convert to Bezier Point command. To convert a point or points from bezier to corner you can use the Shape > Convert to Corner Point command.

A quicker way to do this is to simply alt + click a point (or points) to toggle between bezier and corner points (e.g. a corner will become a bezier and vice versa).

When converting from corner to bezier you can also control the length of the bezier handles by using alt + click + drag. This will convert a corner point to a bezier point and drag the bezier handles out until you release the mouse.

Where bezier points exist, bezier handles will appear. These handles can exist in two states:

  • Locked - as you move a handle, the opposing handle also moves in an opposing direction.

  • Unlocked - each handle can be moved independently of the other.

You can use the Lock/ Unlock Bezier Handle commands under the Shape menu to convert points to either state.

Alternatively, a quicker way to do this on a point by point basis is to alt + drag a handle. If a bezier handle is locked, alt + dragging one side of the handle will unlock it. And conversely, if a bezier handle is unlocked, alt + dragging one side of the handle will lock it.

Within a certain range, any bezier handles will appear automatically. This is intended to speed up your workflow. e.g. rather than having to click on a point first and then grabbing a handle you can just get straight to it. To give you a better visual picture of how other handles are determining the shape of your path, incoming handles from the previous/ next point will also be shown when handles or points are selected.

You can close an open path by simply dragging one end of the path onto the other. As you do, a small circle will appear in the Viewport to indicate the path will be closed.

Tool Settings

Snap Angle - determine the angle that any movement will snap to.

Tooltips - show info when hovering over points.

Transform Tool - enable the Points Transform Tool to transform selected points.

Close Distance - if you drag a start point within this value of the end point the contour will be closed. Note - this value is independent of the Viewport scale.

Tool Help - enable viewport overlays with tips for hotkeys.

Shortcuts

Shortcut

Description

arrow keys

Move selected in 1px increments in Local Space.

alt + arrow keys

Move selected in 1px increments in World Space.

Shift + arrow keys

Move selected in 5px increments in Local Space.

alt + Shift + arrow keys

Move selected in 5px increments in World Space.

s + click

Insert a new point along a path.

alt + click

Convert a bezier point to a corner point (or vice versa).

Rectangle
Ellipse
Polygon
Star
Edit
Pen
Pencil
Line