@pixerate/editor 0.267.0 → 0.268.0

package/dist/paint-editor/engine.d.cts

@@ -88,6 +88,8 @@ export interface PenDab extends Dab {
     lean: number;
     /** Pen speed (px/ms), or `null` when the samples carry no time. */
     speed: number | null;
+    /** Mirrored across the tip's x axis (bit 1) and y axis (bit 2), from `dynamics.flip`; 0 or missing: not mirrored. */
+    flip?: number;
 }
 /**
  * Walks pen samples into dabs, incrementally (any chunking gives the same dabs). Dab angles are in
@@ -115,6 +117,8 @@ export declare class PenDabWalker {
     private dab;
     push(p: PenPoint, out: PenDab[]): void;
     finish(out: PenDab[]): void;
+    /** The dabs of one spacing step: `dynamics.count` of them, each with its own index and so its own jitter. */
+    private lay;
 }
 export interface DryStrokeOptions {
     /** The paper's dry height field, or `null` for no grain. */
@@ -127,7 +131,10 @@ export interface DryStrokeOptions {
     copies?: readonly StrokeCopy[];
     /** Effect paint: each pixel takes its colour (and alpha) from these canvas-sized pixels. */
     effect?: EffectPaintPixels | null;
-    /** Loaded sticker art, for a stamp tip of a sticker from the sticker library (`brush.stamp`); without it such a tip paints round. */
+    /**
+     * Loaded art for a stamp tip of a sticker or an image source (`brush.stamp`) and for an image
+     * tip grain (`brush.tipGrain.source`); without it such a tip paints round, and the grain is left out.
+     */
     stampArt?: StickerArtLookup;
 }
 /**
@@ -149,13 +156,15 @@ export declare class DryStroke {
     private lastFed;
     /** The stamp tip's shape, or `null` for the round computed tip. */
     private readonly stamp;
+    /** The tip's own grain, or `null`. */
+    private readonly tipGrain;
     constructor(brush: PaintBrush, options: DryStrokeOptions);
     /** Feeds raw pen samples; returns the document rectangles the new dabs touched. */
     push(points: readonly PenPoint[]): RasterRect[];
     /** Ends the stroke: the smoothed path catches up with the last raw sample; a single tap paints one dab. */
     finish(): RasterRect[];
     private paint;
-    /** Lays one mark (a dab, or a spray droplet of dab `d`): the round tip or the stamp, the paper grain, effect paint. */
+    /** Lays one mark (a dab, or a spray droplet of dab `d`): the round tip or the stamp, the tip grain, the paper grain, effect paint. */
     private mark;
 }
 /** The shared engine's tip for the Mixer Brush engine (it smooths and walks by itself, so smoothing is applied before). */

package/dist/paint-editor/engine.d.ts

@@ -88,6 +88,8 @@ export interface PenDab extends Dab {
     lean: number;
     /** Pen speed (px/ms), or `null` when the samples carry no time. */
     speed: number | null;
+    /** Mirrored across the tip's x axis (bit 1) and y axis (bit 2), from `dynamics.flip`; 0 or missing: not mirrored. */
+    flip?: number;
 }
 /**
  * Walks pen samples into dabs, incrementally (any chunking gives the same dabs). Dab angles are in
@@ -115,6 +117,8 @@ export declare class PenDabWalker {
     private dab;
     push(p: PenPoint, out: PenDab[]): void;
     finish(out: PenDab[]): void;
+    /** The dabs of one spacing step: `dynamics.count` of them, each with its own index and so its own jitter. */
+    private lay;
 }
 export interface DryStrokeOptions {
     /** The paper's dry height field, or `null` for no grain. */
@@ -127,7 +131,10 @@ export interface DryStrokeOptions {
     copies?: readonly StrokeCopy[];
     /** Effect paint: each pixel takes its colour (and alpha) from these canvas-sized pixels. */
     effect?: EffectPaintPixels | null;
-    /** Loaded sticker art, for a stamp tip of a sticker from the sticker library (`brush.stamp`); without it such a tip paints round. */
+    /**
+     * Loaded art for a stamp tip of a sticker or an image source (`brush.stamp`) and for an image
+     * tip grain (`brush.tipGrain.source`); without it such a tip paints round, and the grain is left out.
+     */
     stampArt?: StickerArtLookup;
 }
 /**
@@ -149,13 +156,15 @@ export declare class DryStroke {
     private lastFed;
     /** The stamp tip's shape, or `null` for the round computed tip. */
     private readonly stamp;
+    /** The tip's own grain, or `null`. */
+    private readonly tipGrain;
     constructor(brush: PaintBrush, options: DryStrokeOptions);
     /** Feeds raw pen samples; returns the document rectangles the new dabs touched. */
     push(points: readonly PenPoint[]): RasterRect[];
     /** Ends the stroke: the smoothed path catches up with the last raw sample; a single tap paints one dab. */
     finish(): RasterRect[];
     private paint;
-    /** Lays one mark (a dab, or a spray droplet of dab `d`): the round tip or the stamp, the paper grain, effect paint. */
+    /** Lays one mark (a dab, or a spray droplet of dab `d`): the round tip or the stamp, the tip grain, the paper grain, effect paint. */
     private mark;
 }
 /** The shared engine's tip for the Mixer Brush engine (it smooths and walks by itself, so smoothing is applied before). */