Drop shadow & stroke (ShadowOptions, StrokeOptions)

Shadows and strokes are layer-level options on ImageProperties (and on groupTransform for grouped composites). They apply to bitmaps and shapes, with one shadow quirk for complex shapes.

Types ShadowOptions and StrokeOptions are exported from apexify.js (see types/common).

#Shadow — shadow?: ShadowOptions

##Bitmap shadow

For images, the shadow is cast from the layout box (x, y, width, height) before the image is clipped — so borderRadius / clipPath crop the bitmap but the shadow still reads as a natural drop shadow.

##Shape shadow

• rectangle, circle, triangle, trapezium, polygon, arc, pieSlice, square: use the rectangular shadow (same as bitmaps) for the layout box.
• heart and star: use a geometry-accurate shadow (outline-based), so borderRadius on shadow does not apply the same way.

1await painter.createImage(2  {3    source: './card.png',4    x: 48,5    y: 48,6    width: 320,7    height: 180,8    fit: 'cover',9    borderRadius: 16,10    borderPosition: 'all',11    shadow: {12      color: '#00000055',13      offsetX: 0,14      offsetY: 12,15      blur: 24,16      borderRadius: 16,17      roundedCorners: 'all',18    },19  },20  buffer21);

#Stroke — stroke?: StrokeOptions

##Bitmap stroke

Strokes run after the image itself, filters, and effects — see Paint order. The stroke follows the layout box (with optional rounded corners), not the alpha silhouette of the PNG.

##Shape stroke

Stroke follows the real shape path (star, heart, polygon, arc, …), using the same shape fields as the fill so outline and fill stay aligned.

1await painter.createImage(2  {3    source: 'circle',4    x: 100,5    y: 80,6    width: 160,7    height: 160,8    shape: { fill: true, color: '#e0e7ff' },9    stroke: { color: '#3730a3', width: 6, style: 'solid' },10  },11  buffer12);

#Known limitations (bitmaps)

If you use filterOrder: 'pre', distortion, or meshWarp, the bitmap path returns early in the implementation: stroke, effects, and post filters may not run. See Paint order for the exact table.