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
  • Intro
  • UI
  • Fill and Stroke

Was this helpful?

  1. Nodes
  2. Behaviours

Sub-Mesh

Access sub-meshes within Shapes

PreviousStaggerNextSubdivide

Last updated 3 years ago

Was this helpful?

Intro

Meshes in Cavalry can contain a hierarchy of other Shapes within them. We refer to these meshes as ‘Sub-Meshes’. This hierarchy is a tree structure, much like the , only it exists inside a Shape.

For example, consists of Lines, Words and Characters, a is built of many Input Shapes and s can have any number of layers. The Sub-Mesh Behaviour provides a way to access and affect these individual meshes by specifying the level(s) within a hierarchy.

UI

+

Position - set the X and Y position. 0,0 is in the centre of your comp.

Rotation - set the rotation (in degrees).

Scale - set the X and Y scale values.

Opacity - set the opacity.

Visibility - affect the sub-shape's visibility on a per shape basis.

Time Offset - set the animation curve for duplicates on a per shape basis. Tip - connect a Stagger node

Center Pivot - centre the pivot to each sub-mesh's bounding box.

Deformers - a list of connected Deformers.

Filters - a list of connected .

Level Mode - choose which level(s) of a sub-mesh to affect.

  • Custom... - manually set a Custom Level Range.

  • Text (Lines) - used with a Text Shape, this will affect each line.

  • Text (Words) - used with a Text Shape, this will affect each word.

  • Text (Characters) - used with a Text Shape, this will affect each character.

  • All - affects all sub-meshes, regardless of level.

Custom Level Range - set the level within the Sub-Mesh's hierarchy to affect. This can also be used to set a range of levels. For example, setting a range of 1, 2 might be used to override the color of an SVG for all the shapes on levels 1 and 2 but not on level 3.

As the Level value increases the Sub-Mesh travels deeper into the Shape's hierarchy.

Flatten Mesh at Level - all sub-meshes below this level will be merged and brought up to this one.

Fill and Stroke

Replace Fill/Stroke - when checked the Sub-Mesh will overwrite any materials on the shapes it is connected to with the Color and/or Shaders set in this tab.

Replacement Mode - by default, all materials will be replaced but, by using this option, you can target certain conditions:

  • Replace All - Sub-Mesh will replace the Fill/Stroke of all sub-meshes.

  • Replace Missing - Sub-Mesh will only replace the Fill/Stroke of any sub-meshes that do not have Fill/Stroke enabled.

  • Replace Existing - Sub-Mesh will only replace the Fill/Stroke of any sub-meshes that do have Fill/Stroke enabled.

  1. Line.

  2. Word.

  3. Character.

Example usage:

  1. Create a Sub-Mesh node.

  2. Connect subMesh.id > textShape.deformers

  3. Set Position Y on the Sub-Mesh to 30

  4. Right click on the Falloff attribute and select 'Add Falloff'.

When you animate the Falloff through the text each letter will move up 30px.

The Level Mode provides several settings designed to make working with Text easier. For example, the Text (Words) mode sets internal Custom Level Range values of 2, 2. While these settings will affect any words in a , the same settings can also be valid for an .

Sub-Mesh also has Fill and Stroke tabs. They are identical to those found on apart from two exceptions.

Fill/Stroke Overrides - see and .

Levels for are as follows:

Create a .

Scene Window
Text
Duplicator
SVG
Common Attributes
Filters
Text Shape
SVG Shape
Shapes
Color Material Overrride
Alpha Material Override
Text
Text Shape