The brush property type has several brush types, each having its own properties to set it up. Select the Brush Type first from the drop down. Brush Types include:

• Solid Color Brush – Fills the area with a single color.
• Linear Gradient Brush – Fills the area with a gradient of multiple colors between two points that define a vector.
• Radial Gradient Brush – Fills the area with a gradient of multiple colors originating from a point and expanding to fill a ellipse defined by X and Y radii.
• Image Brush – Fills an area with an image with stretch an tile options.
• SVG Brush – Fills an area with an SVG drawing with stretch and tile options.
• Visual Brush – Fills an area with an image of an existing layer in the layout.

Solid Color Brush #

Allows you to set a color to fill the layer.

Properties #

• Color – A Color type property that defines the color to fill with. Typing a valid color name in the color property will automatically convert the color to its hex value. See Direct Link Values for valid color names, below.

Linear Gradient Brush #

Allows you to set a series of colors that blend between one another to create a gradient from one point in the layer to another.

Properties #

• Start – A position property, indicating the start position and (combined with the End property) direction of the gradient. Mapping the image from the 0.0, 0.0 position being the top left, and 1.0, 1.0 being the bottom right of the image. Values outside that range are allowed.
• End – A Position property indicating the end of the gradient. See Start property, above.
• Gradient Stops – A gradient stop collection property indicating the color, position (from 0.0 to 1.0) and order of gradients.

• Origin – A position property, indicating the start position of the gradient. Mapping the image from the 0.0, 0.0 position being the top left, and 1.0, 1.0 being the bottom right of the image. Values outside that range are allowed.
• Center – A Position property indicating the center of the outermost circle that defines the gradient. See Origin, above.
• Radius X – The radius of of the outermost gradient on the horizontal axis, with 1.0 indicating the width of the layer the gradient is applied to.
• Radius Y – The radius of of the outermost gradient on the vertical axis, with 1.0 indicating the height of the layer the gradient is applied to.
• Gradient Stops – A gradient stop collection property indicating the color, position (from 0.0 to 1.0) and order of gradients.

Notes #

The center of a rectangular layer is 0.5, 0.5, and the radius of a oval to the edge of the layer would be 0.5. Radius x, and y is set to 1 by default because .5 does not reach the corners, which is usually not what you want in a rectangular layer.

Image Brush #

Allows you to fill a layer with an image with stretching and tiling.

Properties #

• Image – path to the image from the project directory.
• Stretch – how to fill the layer with the image. Valid values are:
  • None – The image stays its native size and does not stretch to fill the layer.
  • Uniform – The image is scaled to fit at least one dimension width or height matches the layer. The aspect ratio of the image is preserved, but the image may not fill the layer completely on both width and height.
  • UniformToFill: The image is scaled to fill the layer with the image on both width and height. The aspect ratio of the image is preserved, but the image may exceed the layer’s width or height and be clipped.
  • Fill: The image is scaled to fill the layer with the image on both width and height. The aspect ratio of the image is not preserved because the width and height are scaled independently, but the image may be distorted to completely fill the layer.
• Tile Mode – How to tile the image within the layer to fill it. Valid values are:
  • None – The image is not repeated. The unfilled area of the layer is transparent.
  • FlipX – The image is repeated vertically and horizontally until the area of the layer is filled. Alternating columns are flipped horizontally.
  • FlipY – The image is repeated vertically and horizontally until the area of the layer is filled. Alternating rows are flipped vertically.
  • FlipXY- The image is repeated vertically and horizontally until the area of the layer is filled. Alternating rows are flipped vertically. Alternating columns are flipped horizontally.
  • Tile – The image is repeated vertically and horizontally until the area of the layer is filled.

SVG Brush #

Allows you to fill a layer with an SVG vector drawing with stretching and tiling.

Properties #

• SvgDrawing – path to the SVG file from the project directory.
• Stretch – how to fill the layer with the image. See Image Brush properties, above, for description of possible values.
• Tile Mode – How to tile the image within the layer to fill it. See Image Brush properties, above, for description of possible values.

Visual Brush #

Allows you to fill a layer with another layer in the same layout. This is especially useful, for instance, in the Opacity

Properties #

• Layer- A layer selected from the same layout. This selected layer is drawn as a brush on the current layer. The layer who owns the brush can not select a layer it descends from for the visual.
• Stretch – how to fill the layer with the image. See Image Brush properties, above, for description of possible values.
• Tile Mode – How to tile the image within the layer to fill it. See Image Brush properties, above, for description of possible values.

Notes #

The selected layer’s position in the layout affects the positioning by the brush, so a layer positioned at (0, 0) will draw starting at the top left of the layer the brush is applied to. Also, the selected layer does not need to be visible or enabled for it to be applied as a brush.

Direct Link Values #

The following chart shows valid value that can used in a spreadsheet data source. You can use either the color name (e.g. AliceBlue) or the hex value (e.g. #FF0F8FF). This will assign a solid color brush of the specified color to the brush property of the layer.

Notes #

The expanded color properties are described in Color Property.

Versions #

All versions to current.