# Drawing Layer

The Drawing layer is at the core of a scene's structure. A drawing layer is linked to an element, which contains a series of drawing, and its Xsheet column, which indicates when and for how long each drawing is exposed. The layer is what connects the element and its exposure to the rendered image. It indicates the position of the drawings relative to other elements and to the stage, as well as the drawing's connections with pegs, groups and effects, if any.

Although drawing layers can be transformed and animated on their own, it is typical to connect them under a parent peg. This allows you to keep the position and animation information of the element in the peg, making it easier to manipulate the exposure and the transformations separately. This is especially useful in digital cut-out animation where manipulating and transforming layers is often the main method of simulating movement, and changing drawings is the secondary method.

You can also connect a drawing layer as a child of another drawing layer. Just like with pegs, any transformation done to the parent layer, whether on itself or through one of its parents, will also be applied to the child layer.

Optionally, you can connect a matte drawing to a drawing layer. When a drawing layer has a matte drawing, only the parts of the drawings that intersect with the opaque areas of the matte drawing will be rendered. This allows you to accomplish the same effect as connecting the drawing layer to a cutter effect.

## Layer Properties

The drawing layer's properties are organized in the following tabs:

### Transformation Tab

The Transformation tab contains parameters for adjusting the position, scale, rotation, skew and pivots of an element.

 Parameter Description Position 3D Path: Use a 3D path to position the element. A 3D path uses a single function to define the position on the X, Y and Z axes. This function is made of control points linked by a curvilinear path, making the movement follow a natural curve. The pace and ease of the movement is determined by a single velocity function. Separate: Positions the element using separate functions for the X, Y and Z axes. This allows to control the direction and pace of the movement across all three axes separately. Unless ease is applied to the axes, the trajectory of the element will follow straight lines going between each keyframe. Path: If the 3D Path option is selected, this field allows you to create or select the 3D Path function used to position the element. Path (x) Axis: The position of the element on the East-West axis, in fields. Path (y) Axis: The position of the element on the South-North axis, in fields. Path (z) Axis: The position of the element in the Back-Front axis, in fields. Velocity: If the 3D Path option is selected, this function is used to control the pace at which the element moves towards each control point in the 3D Path function, on all three axes simultaneously. Scale Locked: Uses a single scale parameter to scale the element, preserving its proportions. Separate: Uses a separate parameter to scale the element on the X and Y axis, allowing to stretch or squash the element. (x) Axis: The horizontal scale factor. The default value is 1. (y) Axis: The vertical scale factor. The default value is 1. Scale in Fields: With this option enabled, the scale factor is based on the amount of fields in the scene. For example, to shrink one of the dimensions of an element to half its original size, the scale factor would normally bet set to 0.5. If this option is enabled and the amount of fields in the scene is 12, then the scale factor to shrink the element by half would be 6. Ignore Parent Scaling: When this option is enabled, scaling factors applied to a parent layer will not be applied to the current layer. This can be handy in cut-out rigs when you need to scale an arm without affecting the forearm. Rotation Angle z: The angle at which the element is rotated, based on the 360 degrees scale. Values below 0 or above 360 degrees will cause the rotation to cycle. Skew Skew: The angle at which the element is skewed. This value can range from -90 to 90 degrees. Pivot (x) Axis: The horizontal position of the pivot point of the element relative to the pivot point of the drawing, in fields. (y) Axis: The vertical position of the pivot point of the element relative to the pivot point of the drawing, in fields. NOTE These parameters can be changed visually by clicking and dragging the pivot point when using on of the tools in the Advanced Animation toolbar. Drawing Pivot An element layer has two pivots: The pivot of the element, which is set by the Pivot parameters above. The pivot of the currently exposed drawing, which is set using the Drawing Pivot tool. This preference is used to determine what to do with the pivot point of the currently exposed drawing: Don't Use Embedded Pivot: Ignores the pivot point of the exposed drawing. The pivot point of the element is positioned using the Pivot parameters above, relative to the centre of the drawing. Apply Embedded Pivot on Parent Peg: Use the pivot point of the exposed drawing to determine the position of the pivot point of the parent peg of the drawing layer. This is useful when making a character rig where each element has a parent peg, and those parent pegs are intended to be used for animation. The pivot point of these parent pegs will be based on the pivot point set for the exposed drawing. Apply Embedded Pivot on Drawing Layer: Use the pivot point of the drawing to determine the pivot point of the element. This means the pivot point is positioned using the Pivot parameters above, but relative to the pivot point of the drawing. TIP The two latter options are useful when making a character rig where a layer can represent a body part from different angles. Since each angle is represented by a drawing, and each angle is liable to have a different pivot point, you can set the pivot point of each angle by using the Drawing Pivot tool on each drawing. Then, if you want to animate the drawing layers directly, you can set this parameter to the Apply Embedded Pivot on Drawing Layer option, and if you want to animate using the parent pegs of the drawing layers, you can set this parameter to the Apply Embedded Pivot on Parent Peg option, so that these pivots are used when animating the different parts of the rigs.

### Drawing Tab

The Drawing tab contains parameters for the art layers, bitmap images and the element's matte drawing.

 Parameter Description Element Columns Drawing Path: Displays the full path to the current drawing. Art Layers These parameters allow you to set whether each art layer in the drawing layer is enabled, and whether they should contain vector or bitmap artwork. By default, options for the Line Art and Colour Art layers will be available. If the Enable Overlay and Underlay Arts preference is enabled, options for the Overlay Art and Underlay Art layers will also be available. Enabled: Determines whether the art layer is displayed. Vector: Makes the art layer enabled for vector artwork, Vector drawing tools will be used to draw in this art layer, and vector artwork information will be preserved. Bitmap: Makes the art layer enabled for bitmap artwork. Only bitmap-compatible drawing tools will be enabled when drawing on this layer, and all artwork will be rasterized into a bitmap image. Bitmap File Options Colour: Determines whether or not the colours in the image is processed. If unchecked, the image will be solid black. Transparency: Determines whether or not the transparency in the image is processed. If unchecked, the image will be fully opaque. Transparency Type: If the layer contains bitmap images with a transparency channel, there are several approaches to rendering the image's transparency. You may need to select the proper transparency type to make sure Harmony renders the image as intended. Premultiplied with Black: Semi-transparent pixels in the original image are blended with black. Premultiplied with White: Semi-transparent pixels in the original image are blended with white. Straight: Semi-transparent pixels in the original image are left as is (unmatted). Clamp Colour to Alpha: Semi-transparent pixels in the original image are blended with black. On import, each of the RGB channels is clamped so that a color value never exceed the alpha value for a given pixel. When the RGB values are multiplied with the alpha value, that is to say, if you have a pixel of value R=247, G=188, B=29 and the alpha is 50% or the image has a 50% transparency, then the actual RGB values output would be half of the amounts listed above. Colour Space: If the element is displaying original bitmap files that are not tagged with their colour space information, this allows you to set the colour space in which Harmony should render the image. Linear: The default value. The linear colour space is one where the intensity of each primary is directly proportional to their value. Typically, visuals are rendered in a linear colour space until the final compositing stage. sRGB: The most common colour space used with computer and digital device displays. With this colour space, the relation between the value of each primary and their intensity is defined by a gamma function. Rec.709: A colour space commonly used for HD television. It is very similar to sRGB with a slightly lower gamma curve. Tile Horizontally: Repeats the bitmap image infinitely to the left and to the right of the layer. This can be useful for making looping backgrounds. Tile Vertically: Repeats the bitmap image infinitely to over and underneath the layer. This can be useful for making looping backgrounds. NOTE When both the Tile Horizontally and Tile Vertically options are used together, the bitmap image is tiled all over the scene. Matte Invert Matte: If a drawing, group or effect is added to the drawing's Matte attribute, the part of the drawing that intersect with the matte's opaque areas will be cut out by default. If this parameter is enabled, the part of the drawing that intersect with the matte's transparent areas will be cut out instead.

### Controls Tab

The Controls tab contains animation control options.

 Parameter Description Animation Animate Using Animation Tools: By default, a drawing layer can be animated directly, as if it was its own peg. If you disable this option, it will only be possible to animate the layer using its parent peg. If the layer has no parent peg, it will be immutable. This can be useful if you want to create cut-out character rigs that should only be animated using pegs, which can help separate the drawing exposure from the transformations on the drawings. If every drawing layer in a character rig has this option disabled, only layers that have a parent peg will be animatable, and the animator will only be able to animate on the pegs. This also rules out the possibility of accidentally animating an element directly and using its parent peg concurrently. When this option is disabled, clicking on the drawing layer in the Camera view with the Transform tool will automatically select the layer's parent peg. Spline Offset If the layer's controls are displayed, you can see its animation trajectory in the Camera view. This is referred to as the spline. By default, the position of each point in the spline is based on the element's pivot point. However, you can use the spline offset to give it a more fitting position if desired. You can do this by using the Spline Offset tool of the Advanced Animation toolbar, or by manually entering the offset values in the Spline Offset fields. (x) Axis: The horizontal offset of the spline, in fields. (y) Axis: The vertical offset of the spline, in fields. (z) Axis: The depth offset of the spline, in fields. TIP To display the animation trajectory of the layer in the Camera view, select the layer, then do one of the following: In the Camera toolbar, click on Show Control . From the top menu, select View > Show > Control. Press Shift + F11 (Windows/Linux) or ⌘ + F11 (macOS).

### Line Thickness

The Line Thickness tab contains options regarding the way pencil lines in the element are rendered. These options can be very useful to enhance the quality of line art without having to work on it.