Skip to main content
Describes how shapes are drawn, including fill or stroke style, thickness, color, gradient, and blending behaviour.

​
Fields

​
style

Describes how shapes are drawn, including fill or stroke style, thickness, color, gradient, and blending behaviour. Painting style of type PaintStyle.

​
join

Stroke join behaviour for corners. See StrokeJoin.

​
cap

Stroke cap used for line endings. See StrokeCap.

​
thickness

Thickness of the stroked path.

​
blendMode

Blending mode used when compositing. See BlendMode.

​
feather

Feathering amount.

​
gradient

Gradient applied to fill (if present).

​
color

Color. See Color.

​
Constructors

​
new

Creates a new Paint object with default settings. Example: 
local paint = Paint.new()
paint.style = 'fill'
paint.color = Color.rgb(255, 200, 80)

​
with

Creates a new Paint initialized from the provided PaintDefinition. Example: 
local strokePaint = Paint.with({
  style = 'stroke',
  thickness = 3,
  color = Color.hex('#FF0066'),
  join = 'round',
  cap = 'round',
})

​
Methods

​
copy

Returns a new Paint that copies this one, optionally overriding selected properties with values from the provided PaintDefinition. Example: 
local base = Paint.with({
  style = 'fill',
  color = Color.rgb(255, 0, 0),
})

local outline = base:copy({
  style = 'stroke',
  thickness = 4,
})
@param values Optional overrides. @return A new Paint instance with merged values.