# Actions files (`.atn`)

PhotoCraft loads and saves action sets in the reference application's `.atn` format: Load Actions and
Save Actions in the Actions panel menu, `actions.load` / `actions.save` for agents, and
`photocraft batch --actions set.atn` on the command line. Reading and writing the file lives in
`photocraft-psd` (`crates/psd/src/atn.rs`, version 16 sets, exact round trip); the mapping between the
application's events and PhotoCraft commands lives in `photocraft-engine`
(`crates/engine/src/cmd/atn_cmds/`, table `EVENTS` in `events.rs`).

A step whose event is in the table below loads as the PhotoCraft command it names, plays, and saves back
as the same event. Any other step loads as a kept step (`actions.photoshopStep`), and Save Actions writes
it back unchanged. Playback stops at an enabled kept step with its name, so an action never silently skips
work. Kept steps with no effect on the document (tool selections and the like) are imported switched off,
so playback skips them.

This page covers the events PhotoCraft maps today, the settings some of them still lose, how steps name
layers and documents, newer and older events and files, and a measured reference for the events it does not
map yet, with everything needed to implement them without
the reference application.

## Supported events (144)

| Code | String ID | Label | PhotoCraft command(s) |
|---|---|---|---|
| `AdNs` | addNoise | Add Noise | `filter.noise.addNoise` |
| `Algn` | align | Align | `layer.align.leftEdges`, `layer.align.horizontalCenters`, `layer.align.rightEdges`, `layer.align.topEdges`, `layer.align.verticalCenters`, `layer.align.bottomEdges` |
| `AppI` | applyImageEvent | Apply Image | `image.applyImage` |
| (string ID only) | applyComp | Apply Layer Comp | `layerComp.apply` |
| (string ID only) | applyLocking | Apply Locking | `layer.lockLayers` |
| (string ID only) | assignProfile | Assign Profile | `edit.assignProfile` |
| (string ID only) | autoColor | Auto Color | `image.autoColor` |
| `Avrg` | Avrg | Average | `filter.blur.average` |
| (string ID only) | blackAndWhite | Black & White | `image.adjustments.blackWhite` |
| `Blr ` | blur | Blur | `filter.blur.blur` |
| `BlrM` | blurMore | Blur More | `filter.blur.blurMore` |
| `Brdr` | border | Border | `select.modify.border` |
| (string ID only) | boxblur | Box Blur | `filter.blur.boxBlur` |
| `BrgC` | brightnessEvent | Brightness/Contrast | `image.adjustments.brightnessContrast` |
| (string ID only) | Adobe Camera Raw Filter | Camera Raw Filter | `filter.cameraRaw` |
| `CnvS` | canvasSize | Canvas Size | `image.canvasSize` |
| `ChnM` | channelMixer | Channel Mixer | `image.adjustments.channelMixer` |
| (string ID only) | clearEvent | Clear | `select.editInQuickMaskMode`, `history.clear` |
| `Cls ` | close | Close | `file.close` |
| `Clds` | clouds | Clouds | `filter.render.clouds` |
| (string ID only) | collapseAllGroupsEvent | Collapse All Groups | `layer.setExpanded` |
| `ClrB` | colorBalance | Color Balance | `image.adjustments.colorBalance` |
| `ClrR` | colorRange | Color Range | `select.colorRange` |
| `Cntc` | contract | Contract | `select.modify.contract` |
| `CnvM` | convertMode | Convert Mode | `image.mode.rgb`, `image.mode.grayscale`, `image.mode.cmyk`, `image.mode.lab`, `image.mode.multichannel`, `image.mode.bits8`, `image.mode.bits16`, `image.mode.bits32`, `image.mode.bitmap` |
| (string ID only) | convertToProfile | Convert to Profile | `edit.convertToProfile` |
| (string ID only) | newPlacedLayer | Convert to Smart Object | `layer.smartObjects.convertToSmartObject` |
| `copy` | copyEvent | Copy | `edit.copy` |
| (string ID only) | copyEffects | Copy Layer Style | `layer.layerStyle.copyLayerStyle` |
| `CpyM` | copyMerged | Copy Merged | `edit.copyMerged` |
| `GrpL` | groupEvent | Create Clipping Mask | `layer.createClippingMask` |
| `Crop` | crop | Crop | `image.crop` |
| `Crst` | crystallize | Crystallize | `filter.pixelate.crystallize` |
| `Crvs` | curves | Curves | `image.adjustments.curves` |
| `Cstm` | custom | Custom | `filter.other.custom` |
| `cut ` | cut | Cut | `edit.cut` |
| `Dntr` | deInterlace | De-Interlace | `filter.video.deInterlace` |
| `Dfrg` | defringe | Defringe | `layer.matting.defringe` |
| `Dlt ` | delete | Delete | `layer.delete`, `edit.clear`, `layer.layerMask.delete`, `layer.smartFilter.deleteFilterMask` |
| `Dstt` | desaturate | Desaturate | `image.adjustments.desaturate` |
| (string ID only) | selectNoLayers | Deselect Layers | `select.deselectLayers` |
| `Dspc` | despeckle | Despeckle | `filter.noise.despeckle` |
| `DfrC` | differenceClouds | Difference Clouds | `filter.render.differenceClouds` |
| `Dfs ` | diffuse | Diffuse | `filter.stylize.diffuse` |
| `Dplc` | duplicate | Duplicate | `layer.duplicate`, `image.duplicate` |
| `DstS` | dustAndScratches | Dust & Scratches | `filter.noise.dustAndScratches` |
| (string ID only) | placedLayerEditContents | Edit Contents | `layer.smartObjects.editContents` |
| `Embs` | emboss | Emboss | `filter.stylize.emboss` |
| `Eqlz` | equalize | Equalize | `image.adjustments.equalize` |
| `Exch` | exchange | Exchange | `tools.swapColors` |
| `Expn` | expand | Expand | `select.modify.expand` |
| `Expr` | export | Export | `file.export.saveForWebLegacy` |
| `Exps` | exposure | Exposure | `image.adjustments.exposure` |
| `Fthr` | feather | Feather | `select.modify.feather` |
| `Fbrs` |  | Fibers | `filter.render.fibers` |
| `Fl  ` | fill | Fill | `edit.fill`, `paint.bucket` |
| `GEfc` | filterGallery | Filter Gallery | `filter.gallery.accentedEdges`, `filter.gallery.angledStrokes`, `filter.gallery.basRelief`, `filter.gallery.chalkCharcoal`, `filter.gallery.charcoal`, `filter.gallery.chrome`, `filter.gallery.coloredPencil`, `filter.gallery.conteCrayon`, `filter.gallery.craquelure`, `filter.gallery.crosshatch`, `filter.gallery.cutout`, `filter.gallery.darkStrokes`, `filter.gallery.diffuseGlow`, `filter.gallery.dryBrush`, `filter.gallery.filmGrain`, `filter.gallery.fresco`, `filter.gallery.glass`, `filter.gallery.glowingEdges`, `filter.gallery.graphicPen`, `filter.gallery.halftonePattern`, `filter.gallery.inkOutlines`, `filter.gallery.mosaicTiles`, `filter.gallery.neonGlow`, `filter.gallery.notePaper`, `filter.gallery.oceanRipple`, `filter.gallery.paintDaubs`, `filter.gallery.paletteKnife`, `filter.gallery.patchwork`, `filter.gallery.photocopy`, `filter.gallery.plaster`, `filter.gallery.plasticWrap`, `filter.gallery.posterEdges`, `filter.gallery.reticulation`, `filter.gallery.roughPastels`, `filter.gallery.smudgeStick`, `filter.gallery.spatter`, `filter.gallery.sponge`, `filter.gallery.sprayedStrokes`, `filter.gallery.stainedGlass`, `filter.gallery.stamp`, `filter.gallery.sumiE`, `filter.gallery.texturizer`, `filter.gallery.tornEdges`, `filter.gallery.underpainting`, `filter.gallery.waterPaper`, `filter.gallery.watercolor`, `filter.gallery.grain` |
| `FltI` | flattenImage | Flatten Image | `layer.flattenImage` |
| `Flip` | flip | Flip | `image.imageRotation.flipCanvasHorizontal`, `image.imageRotation.flipCanvasVertical`, `edit.transform.flipHorizontal`, `edit.transform.flipVertical` |
| (string ID only) | focusMask | Focus Area | `select.focusArea` |
| `GsnB` | gaussianBlur | Gaussian Blur | `filter.blur.gaussianBlur` |
| (string ID only) | gradientMapEvent | Gradient Map | `image.adjustments.gradientMap` |
| `Grow` | grow | Grow | `select.grow` |
| `Hd  ` | hide | Hide | `layer.hideLayers` |
| `HghP` | highPass | High Pass | `filter.other.highPass` |
| `HsbP` | HsbP | HSB/HSL | `filter.other.hsbHsl` |
| `HStr` | hueSaturation | Hue/Saturation | `image.adjustments.hueSaturation` |
| (string ID only) | conditional | If | `actions.conditional` |
| `ImgS` | imageSize | Image Size | `image.imageSize` |
| `Invs` | inverse | Inverse | `select.inverse` |
| `Invr` | invert | Invert | `image.adjustments.invert` |
| `CpTL` | copyToLayer | Layer Via Copy | `layer.new.layerViaCopy` |
| `CtTL` | cutToLayer | Layer Via Cut | `layer.new.layerViaCut` |
| `LnsF` | lensFlare | Lens Flare | `filter.render.lensFlare` |
| `Lvls` | levels | Levels | `image.adjustments.levels`, `image.autoTone`, `image.autoContrast` |
| `Mk  ` | make | Make | `layer.new.layer`, `layer.new.group`, `layer.groupLayers`, `layer.duplicate`, `layer.new.layerViaCopy`, `layer.new.layerViaCut`, `layer.newFillLayer.solidColor`, `layer.newFillLayer.pattern`, `layer.newAdjustmentLayer.levels`, `layer.newAdjustmentLayer.curves`, `layer.newAdjustmentLayer.hueSaturation`, `layer.newAdjustmentLayer.brightnessContrast`, `layer.newAdjustmentLayer.threshold`, `layer.newAdjustmentLayer.posterize`, `layer.newAdjustmentLayer.invert`, `layer.newAdjustmentLayer.colorBalance`, `layer.newAdjustmentLayer.vibrance`, `layer.newAdjustmentLayer.exposure`, `layer.newAdjustmentLayer.photoFilter`, `layer.newAdjustmentLayer.blackWhite`, `layer.newAdjustmentLayer.channelMixer`, `layer.newAdjustmentLayer.selectiveColor`, `layer.newAdjustmentLayer.gradientMap`, `layer.layerMask.revealAll`, `layer.layerMask.hideAll`, `layer.layerMask.revealSelection`, `layer.layerMask.hideSelection`, `file.new`, `file.newFromClipboard`, `history.newSnapshot` |
| (string ID only) | animationFramesFromLayers | Make Frames from Layers |  |
| (string ID only) | matchColor | Match Color | `image.adjustments.matchColor` |
| `Mxm ` | maximum | Maximum | `filter.other.maximum` |
| `Mdn ` | median | Median | `filter.noise.median` |
| `Mrg2` | mergeLayersNew | Merge Layers | `layer.mergeLayers` |
| `MSpt` | mergeSpotChannel | Merge Spot Channel | `channel.mergeSpot` |
| `MrgV` | mergeVisible | Merge Visible | `layer.mergeVisible`, `layer.stampVisible` |
| `Mnm ` | minimum | Minimum | `filter.other.minimum` |
| `MtnB` | motionBlur | Motion Blur | `filter.blur.motionBlur` |
| `move` | move | Move | `layer.translate`, `layer.moveTo`, `layer.arrange.bringToFront`, `layer.arrange.sendToBack`, `layer.arrange.bringForward`, `layer.arrange.sendBackward` |
| `NTSC` | NTSC | NTSC Colors | `filter.video.ntscColors` |
| `Ofst` | offset | Offset | `filter.other.offset` |
| (string ID only) | oilPaint | Oil Paint | `filter.stylize.oilPaint` |
| `Opn ` | open | Open | `file.openAs` |
| `past` | paste | Paste | `edit.paste`, `edit.pasteSpecial.pasteInPlace` |
| (string ID only) | pasteEffects | Paste Layer Style | `layer.layerStyle.pasteLayerStyle` |
| (string ID only) | photoFilter | Photo Filter | `image.adjustments.photoFilter` |
| `Pnch` | pinch | Pinch | `filter.distort.pinch` |
| `Plc ` | placeEvent | Place | `file.placeEmbedded`, `file.placeLinked` |
| `Ply ` | play | Play | `actions.play` |
| `Plr ` | polar | Polar Coordinates | `filter.distort.polarCoordinates` |
| `Pstr` | posterize | Posterize | `image.adjustments.posterize` |
| `Prge` | purge | Purge | `edit.purge.all`, `edit.purge.clipboard`, `edit.purge.histories`, `edit.purge.undo` |
| `RdlB` | radialBlur | Radial Blur | `filter.blur.radialBlur` |
| (string ID only) | rasterizeLayer | Rasterize | `layer.rasterize.layer` |
| `Ungr` | ungroup | Release Clipping Mask | `layer.releaseClippingMask` |
| (string ID only) | removeBackground | Remove Background | `layer.removeBackground` |
| `RmvB` | removeBlackMatte | Remove Black Matte | `layer.matting.removeBlackMatte` |
| `RmvW` | removeWhiteMatte | Remove White Matte | `layer.matting.removeWhiteMatte` |
| `Rset` | reset | Reset | `tools.defaultColors` |
| `RvlA` | revealAll | Reveal All | `image.revealAll` |
| `Rvrt` | revert | Revert | `file.revert` |
| `Rple` | ripple | Ripple | `filter.distort.ripple` |
| `Rtte` | rotateEventEnum | Rotate | `image.imageRotation.90cw`, `image.imageRotation.90ccw`, `image.imageRotation.180`, `image.rotation.arbitrary`, `edit.transform.rotate90Cw`, `edit.transform.rotate90Ccw`, `edit.transform.rotate180` |
| `save` | save | Save | `file.save`, `file.saveAs`, `file.saveACopy` |
| `slct` | select | Select | `layer.select`, `layer.selectAbove`, `layer.selectBelow`, `layer.addAboveToSelection`, `layer.addBelowToSelection`, `layer.selectTop`, `layer.selectBottom`, `channel.target`, `edit.undo`, `edit.redo`, `view.fitOnScreen`, `view.actualPixels`, `view.zoomIn`, `view.zoomOut`, `document.activate` |
| (string ID only) | selectAllLayers | Select All Layers | `select.allLayers` |
| (string ID only) | refineSelectionEdge | Select and Mask | `select.refineEdge` |
| (string ID only) | smartBrushWorkspace | Select and Mask | `select.refineEdge` |
| (string ID only) | autoCutout | Select Subject | `select.subject` |
| `SlcC` | selectiveColor | Selective Color | `image.adjustments.selectiveColor` |
| `setd` | set | Set | `select.all`, `select.deselect`, `select.reselect`, `select.loadSelection`, `select.rect`, `select.lasso`, `select.editInQuickMaskMode`, `tools.setColors`, `layer.setProps`, `layer.renameLayer`, `layer.setLabelColor`, `layer.setAdjustment`, `layer.fill.pattern.set`, `layer.new.layerFromBackground`, `layer.layerStyle.blendingOptions`, `layer.smartFilter.blendingOptions` |
| (string ID only) | adaptCorrect | Shadows/Highlights | `image.adjustments.shadowsHighlights` |
| `Shrp` | sharpen | Sharpen | `filter.sharpen.sharpen` |
| `ShrE` | sharpenEdges | Sharpen Edges | `filter.sharpen.sharpenEdges` |
| `ShrM` | sharpenMore | Sharpen More | `filter.sharpen.sharpenMore` |
| `Shw ` | show | Show | `layer.showLayers`, `layer.showOnly` |
| `Smlr` | similar | Similar | `select.similar` |
| (string ID only) | selectSky | Sky | `select.sky` |
| `SmrB` | smartBlur | Smart Blur | `filter.blur.smartBlur` |
| (string ID only) | smartSharpen | Smart Sharpen | `filter.sharpen.smartSharpen` |
| `Smth` | smoothness | Smooth | `select.modify.smooth` |
| `Sphr` | spherize | Spherize | `filter.distort.spherize` |
| `SplC` | splitChannels | Split Channels | `channel.split` |
| `Stop` | stop | Stop | `STOP_MESSAGE` |
| `Strk` | stroke | Stroke | `edit.stroke` |
| (string ID only) | surfaceBlur | Surface Blur | `filter.blur.surfaceBlur` |
| `Thrs` | threshold | Threshold | `image.adjustments.threshold` |
| `Trnf` | transform | Transform | `edit.transform`, `select.transformSelection` |
| `Trap` | trap | Trap | `image.trap` |
| (string ID only) | trim | Trim | `image.trim` |
| `Twrl` | twirl | Twirl | `filter.distort.twirl` |
| (string ID only) | ungroupLayersEvent | Ungroup Layers | `layer.ungroupLayers` |
| `UnsM` | unsharpMask | Unsharp Mask | `filter.sharpen.unsharpMask` |
| (string ID only) | updatePlacedLayer | Update Smart Objects | `layer.smartObjects.updateModifiedContent` |
| (string ID only) | vibrance | Vibrance | `image.adjustments.vibrance` |
| `Wave` | wave | Wave | `filter.distort.wave` |
| `ZgZg` | zigZag | ZigZag | `filter.distort.zigZag` |

### Settings retained by mapped events

- Transform keeps its recorded `FTcs` reference point. Show with `TglO` true maps to
  `layer.showOnly`; repeating it restores the other layers' visibility.
- Make keeps top-level group names, new-layer clipping (`Usng.Grup`) and adjustment colour labels
  (`Usng.Clr `). Layer via Copy / Cut keeps names, blend modes, opacity and colour labels.
- Loading another layer's transparency keeps its source reference. Background property references
  remain independent of translated names; ordinary layer-name references remain names.
- Close without `Svng` preserves the unanswered save choice. Headless playback refuses to discard a
  changed document. Native `file.close` still defaults to discard; `save: "ask"` opts into this policy.
- Photo Filter converts recorded Lab colours through `photocraft-cms`.
- Direct Vibrance and Gradient Map save as the string events `vibrance` and `gradientMapEvent`.
  Stroke Outside uses `StrL.Otsd`, group Pass Through uses `BlnM.passThrough`, Canvas Size extension
  colours use `FrgC` and `Clr `, and Absolute Colorimetric intent uses `Inte.AClr`.
- Make adjustment layers keeps surrounding `Usng.Opct` as layer opacity, independently of the
  adjustment settings. Recorded percentages use eight-bit layer-opacity storage at every document
  depth: 70 % becomes 179/255. Native creation accepts an optional 0..1 `opacity` fraction.
  A default adjustment with only layer opacity still saves as a default preset.
- Document offsets wrap in opening order, independently of dragged tabs. An ATN zero offset remains
  a kept step; the native command retains its existing zero-offset no-op.
- Convert Mode saves `T   ` as a class. Layer-retaining RGB, grayscale, CMYK and Lab conversions
  read and write explicit false `Fltt` and `Rstr` flags. True or malformed flags remain kept steps;
  depth, bitmap and multichannel recordings with these flags also remain kept.
- Canvas Size preserves percentage units and resolves them against the playback document.
  Percentages are absolute sizes; mixed units and relative percentages remain kept steps.
- Image Size preserves points (`#Rlt`) and resolves them using the playback document's resolution.
  Mixed units and unsupported physical-size/resolution combinations remain kept steps.
  Without resampling, native Image Size still changes only resolution.

Shape creation (`contentLayer`) with geometry or stroke settings remains a kept step. Save preserves
its descriptor, and enabled playback stops instead of creating a canvas-wide solid fill. Editable
shape creation is not mapped yet.

The Vibrance event and adjustment-opacity handling incorporate [@bommerts' contribution in #8659](https://github.com/storytold/photocraft/pull/8659).

### Command options retained by mapped events

- Image Size preserves `scaleStyles`. Native calls default to true; an absent ATN flag means
  false (the reference application plays both alike), so Save writes the key only when it is true.
  Crop and resolution-only resizing retain their existing behavior.
- Convert to Profile preserves `Dthr`, `Fltt` and `rasterizePlaced`, defaulting to false.
  `sdwM` is written as the reference application records it (-1); other values and malformed
  flags remain kept steps. Absolute intent writes `AClr`, with `AbsC` still accepted on import.
- Content-Aware Fill preserves colour, quarter-turn rotation, scale and mirror adaptation.
  Existing native defaults remain unchanged.
- Paste Layer Style preserves `allowPasteFXOnLayerSet`. False skips selected groups without
  applying their styles to children; a selection with no eligible targets fails without editing.
- Paste preserves `As ` path or shape using the original bounded SVG source. Unsupported
  geometry fails instead of silently rasterizing. `As Pxel` plays as an ordinary Paste (or Paste
  in Place), as does omission.

Generated fixtures verify these native options and their load/save/playback behavior. Conversion order,
SVG rasterization and placement were not compared with the reference application.

### Render filters

Native commands without an explicit Lens Flare center still use 0.5 / 0.5. Imported steps materialize the measured center above. A missing Fibers seed is captured once at import and preserved for later playback and export. Native color overrides and other settings without ATN fields are refused during strict export.

## Recognized steps kept disabled

These recognized events have no playable command. They load as kept steps switched
off, and Save Actions preserves their descriptors. They are excluded from the
supported-event count and the measured unmapped reference.

| String ID | Label |
|---|---|
| animationFramesFromLayers | Make Frames from Layers |

## Known gaps in mapped events

A mapped event can still lose a setting. Every mapped event was checked on 2026-11-01: the 5 296 steps of
the `.atn` corpus (sets the reference application recorded) and factory descriptors measured in the
reference application went through `actions.load` and `actions.save`, and each saved descriptor was compared
with the original. Then every step PhotoCraft saves for the cases in
`every_mapped_command_exports_and_imports_back` was played in the reference application: 128 of 151 ran.
Three failed on a wrong code (Vibrance, Gradient Map, Stroke Outside); the others needed a document the test
did not have (a mask, a group, a named pattern or channel). Checking every code the mapping writes found
three more (Pass Through, canvas extension colour, Absolute Colorimetric). The steps below change what a
step does. Every one of them is fixed now: the sections "Settings retained by mapped events" and
"Command options retained by mapped events" above say how each setting is kept. What remains are
differences that do not change what a step does.

### Differences that do not change the result

- Value types: `long` and unit values are interchangeable for the reference application (Motion Blur
  `Angl`, Dust & Scratches `Rds `, Apply Image `Ofst`: same pixels either way); Apply Image's `With`
  object plays the same with class `null`.
- Save writes the 4-character event code where the file had the string ID, writes `null` as the
  top-level class (the application writes the event code), and writes an empty descriptor for steps that
  had none.
- Ids of the recording session (`LyrI`, `DocI`, `Idnt`, `layerSectionStart`, `layerSectionEnd`, `Vrsn`,
  `forceNotify`) and default flags (`MkVs` false, `Adjs` false) are not written back.
- An adjustment layer's values equal to the defaults are not written back (other values are).
- Colours are kept as 8-bit values (51.0031 becomes 51); gradient names become "Custom".
- Levels and Curves write the composite as `Chnl.Cmps` (the application skips `Ordn.Trgt`, #8543).

## Reference forms

How the reference application resolves a layer or document a step names, measured on 2026-11-01 by
playing `select` and `move` steps with each form (documents with and without a Background, a group,
layers above and below it). A recorded step can use any of these; PhotoCraft reads names and the target
today.

### Layers

The stack is counted from the bottom and includes a hidden "group end" entry below each group's
children. Example stack, bottom to top: Background, L1, L2, *group end*, Gchild, G (the group), L3.

| Form | Meaning | Measured |
|---|---|---|
| By name (`name`) | The layer with that name (the first match). | (supported) |
| Target (`Ordn.Trgt`) | The active layer. | (supported) |
| By index (`indx`) | Position in the stack above. With a Background, the Background is 0 and L1 is 1. Without one, the bottom layer is 1, and 0 fails. The group end is a position but cannot be selected: the step leaves the selection unchanged. A number past the top fails. | with Background: 0 Background, 1 L1, 2 L2, 3 (group end: no change), 4 Gchild, 5 G, 6 L3, 7 fails |
| By id (`Idnt`) | The layer id of the document the step was recorded in (`LyrI`, never reused in that document). In another document it names an unrelated layer or none. | id 3 = L2 with a Background, L1 without |
| By offset (`rele`) | Not supported for layers: every offset fails. | -3..3 all fail |
| `Ordn.Frwr` / `Ordn.Bckw` | The next layer up / down in the stack, entering groups (group ends are skipped). | from L2: Frwr Gchild, Bckw L1 |
| `Ordn.Frnt` / `Ordn.Back` | The top layer / the bottom layer (the Background when there is one). | L3 / Background |

**Move to an index** (`move`, `T` = layer by index `m`): counted as above on the stack before the move.
Moving down, the layer lands at index `m`; moving up, at `m - 1` (directly below the layer that had index
`m`). With a Background, `m` = 0 fails; without one, `m` = 0 sends the layer to the bottom. Moving to an
index inside a group puts the layer into that group.

| m (with Background, moving L2 at index 2) | 0 | 1 | 2, 3 | 4 | 5 | 6 |
|---|---|---|---|---|---|---|
| Stack after | fails | Bg, L2, L1, ... | unchanged | Bg, L1, *end*, L2, Gchild, G, L3 (L2 inside G, bottom) | ... *end*, Gchild, L2, G (inside G, top) | ... G, L2, L3 |

### Documents

| Form | Meaning | Measured (D1, D2, D3 opened in that order, D2 active) |
|---|---|---|
| By offset (`rele`) | That many documents after (positive) or before (negative) the active one, in opening order, **wrapping around** at the ends. 0 fails. | -1 D1, +1 D3, -2 D3, +2 D1 |
| By index (`indx`) | 1-based, in opening order; 0 fails. | 1 D1, 2 D2, 3 D3 |

PhotoCraft's `document.activate {"offset"}` refuses to wrap (#7103); the reference application wraps.

### Layer comps

Measured with three comps (CompA, CompB, CompC) that each show a different layer, applied with
`applyComp` and every reference form. The document's `compsList` gives each comp's `title`, `itemIndex`
(1-based), `ID` (long) and `selection`.

| Form | Result |
|---|---|
| By name (`name`) | Applies that comp. An unknown name fails. |
| By index (`indx`) | 1-based, in panel order. 0, negative and past-the-end indexes are **accepted and change nothing**. |
| By ID (`Idnt`) | Applies the comp with that `ID`. An unknown ID fails. |
| By offset (`rele`) | Always fails, for every offset. |
| Ordinal (`Ordn`) `Trgt`, `Nxt `, `Prvs` | Applies the current (last applied) comp; `Nxt ` and `Prvs` do not move. |
| Ordinal `Frst`, `Lst `, `Al  ` | Applies the **first** comp (also for `Lst `). |

Delete (`Dlt `) by index uses the same 1-based numbering. PhotoCraft's `applyComp` import reads only the
name form today; the index, ID and ordinal forms load as kept steps.

## Newer events (string ID only)

The events the reference application records for the menu items PhotoCraft has that are neither mapped
nor in the reference below: 63 candidates from PhotoCraft's menu catalogue, each run in the reference
application without a dialog on a document prepared for it (layers, a selection, a smart object, a type
layer, a layer style or a group) on 2026-11-01. 27 more menu items record no event of their own (puppet
warp and warp splits, combine shapes, scripts such as Load Files into Stack and Statistics, artboard and
video export, missing-font commands): they cannot be recorded or play as a script step.

**Measured: no settings beyond the target.** A step with these events carries at most `null` (the target
layer reference, `Ordn.Trgt`); mapping them needs only the event name.

| Event | Menu item |
|---|---|
| `reverse` | Layer > Arrange > Reverse (several layers selected) |
| `linkSelectedLayers` / `unlinkSelectedLayers` | Layer > Link Layers / Unlink Layers |
| `selectLinkedLayers` | Layer > Select Linked Layers |
| `disableLayerStyle` | Layer > Layer Style > Clear Layer Style |
| `placedLayerMakeCopy` | Layer > Smart Objects > New Smart Object via Copy |
| `placedLayerConvertToLayers` | Layer > Smart Objects > Convert to Layers |
| `placedLayerConvertToEmbedded` | Layer > Smart Objects > Embed Linked |
| `placedLayerUpdateAllModified` | Layer > Smart Objects > Update All Modified Content (the returned `documentID` and `layerIDs` are session ids, not settings) |
| `rasterizeAll` | Layer > Rasterize > All Layers |
| `addBlankVideoLayer` | Layer > Video Layers > New Blank Video Layer |
| `isolateLayers` | Select > Isolate Layers |
| `textLoadDefaultTypeStyles` / `textSaveDefaultTypeStyles` | Type > Load / Save Default Type Styles |
| `recordMeasurements` | Image > Analysis > Record Measurements |
| `CropPhotosAuto0001` | File > Automate > Crop and Straighten Photos |

**Measured: settings.**

| Event | Menu item | Keys |
|---|---|---|
| `placedLayerExportContents` | Layer > Smart Objects > Export Contents | `null`: path of the file written |
| `placedLayerConvertToLinked` | Layer > Smart Objects > Convert to Linked | `null`: target layer; `Usng`: path of the file written |
| `placedLayerRelinkToFile` | Layer > Smart Objects > Relink to File | `null`: path; `LyrI`: session layer id |
| `placedLayerReplaceContents` | Layer > Smart Objects > Replace Contents | `null`: path; `LyrI`: session layer id |
| `artboardFromLayerGroupEvent` | Layer > New > Artboard from Group | `null` target; `artboard` (object: `guideIDs` list, `artboardPresetName` text, `Clr ` RGB background colour, `artboardBackgroundType` long: 1 white, 2 black, 3 transparent, 4 other = `Clr `); `changeBackground` long. See *Artboard from Group: guides and background* below. |
| `shapeBlur` | Filter > Blur > Shape Blur | `Rds ` radius in pixels (factory 10); the shape itself comes from the dialog |
| Make `contentLayer` with `Usng` = reference to `textLayer` `Ordn.Trgt` | Type > Convert to Shape (recorded as Make, not as `convertToShape`) | `null`: class `contentLayer`; `Usng`: the type layer |

**Recorded through the menus** (2026-11-01, steps read back from the saved Actions panel):

| Menu | Recorded step | Keys |
|---|---|---|
| Layer > Layer Style > Scale Effects | `scaleEffectsEvent` | `Scl ` percent, whole number 1..1000 (the dialog clamps) |
| Layer > Layer Style > Create Layer(s) | Make, `null` = class `Lyr `, `Usng` = reference to the `Lefx` property of the target layer | none; the dialog first warns that some effects cannot be reproduced with layers (OK / Cancel) |
| Layer > New > Frame from Layers | Make, `null` = class `framedGroupSection`, `From` = layer **by name**, `layerSectionStart`, `layerSectionEnd` long, `Nm  ` text | the dialog also shows width and height, which are not recorded |
| Layer > New > Artboard from Layers | Make, `null` = class `artboardSection`, `From` = layer target, `layerSectionStart`, `layerSectionEnd`, `Nm  ` | |
| Layer > New > Artboard | Make, `null` = class `artboardSection`, `layerSectionStart`, `layerSectionEnd`, `Nm  `, `artboardRect` (`Top `, `Left`, `Btom`, `Rght` doubles, pixels) | |
| Properties panel > Artboard Background Color (Artboard selected) | `editArtboardEvent` | `null` target; `artboard` (object: `artboardRect` `Top `/`Left`/`Btom`/`Rght` pixels, `guideIDs` list, `artboardPresetName` text, `Clr `, `artboardBackgroundType` 1..4 as above); `changeSizes` long (8 when only the background changed), `changeBackground` 1. `Clr ` is only meaningful with type 4: with types 1..3 it holds the previously used colour |
| Layer > Smart Objects > Stack Mode > mode | `applyImageStackPluginRenderer`: `imageStackPlugin` **class** with the mode's code, `Nm  ` text = the menu name (localised, except "Entropy") | codes: Range `rang`, Entropy `entr`, Kurtosis `kurt`, Maximum `maxx`, Median `medn`, Minimum `minn`, Mean `avrg`, Skewness `skew`, Standard Deviation `stdv`, Summation `summ`, Variance `vari` |
| Layer > Smart Objects > Stack Mode > None | `imageStackConvertSmartObject` | none |
| Layer > Video Layers > New Blank Video Layer, Insert Blank Frame, Delete Frame, Show / Hide Altered Video | `addBlankVideoLayer`, `insertBlankFrame`, `deleteFrame`, `showAlteredVideo` / `hideAlteredVideo` | none |
| Layer > Video Layers > Interpret Footage | `interpretFootage` | `Vrsn` long (1), `interpretAlpha` (`alphaInterpretation`: `Ignr` ignore, …), `colorConvertAlterations` bool |
| Type > Create Work Path | Make, `null` = class `Path`, `From` = text layer (`TxLr`) target | |
| Edit > Find and Replace Text (Replace All) | `replace`, `null` = reference: property `replace` of all text layers (`TxLr` `Ordn.Al`), `Usng` = `find` text, `replace` text, `checkAll`, `Fwd `, `caseSensitive`, `wholeWord`, `ignoreAccents` bool | |
| Edit > Check Spelling | `spellCheck`, `null` = property `spellCheck` of all text layers, `Usng` = `checkAll` bool | recorded with its dialog switched on; the corrections themselves are not recorded |
| Image > Analysis > Set Measurement Scale > Custom | Set, `null` = property `measurementScale` of the document target, `T   ` = `pixelLength` long, `logicalLength` double, `logicalUnits` text | |
| Image > Analysis > Place Scale Marker | a script step (`AdobeScriptAutomation Scripts`) with `jsop` = `measurementScaleMarkerLength`, `measurementScaleMarkerDisplayText`, `measurementScaleMarkerTextPositionBottom` bool, `measurementScaleMarkerColor` text (`FFFFFF` / `000000`), `measurementScaleMarkerFont`, `measurementScaleMarkerFontSize` text ("4 pt") | the dialog is a bundled script; the step stores its options |
| Image > Analysis > Record Measurements | `recordMeasurements` | none |
| File > Close All | one `close` per document: `Svng` (`YsN ` `N   ` when "don't save" was chosen), `DocI`, `forceNotify` | not a `closeAll` event |

**Not recorded:** File > Close Others, Image > Variables > Define (the variables are kept, no step).

**Recorded with source files** (2026-11-01):

| Menu | Recorded step | Keys |
|---|---|---|
| Image > Apply Data Set | `apply`, `null` = `dataSetClass` **by name** | |
| File > Export > Data Sets as Files | `exportDataSet`, `null` = class `dataSetClass` | `All ` bool (all data sets), `T   ` alias (folder), `fileNamingRules` (`fileNamingComponents` list of 7 incl. `None`; components as in Batch plus `underscore` and `dataSetName`; `Mcnt`, `Win `, `unix`) |
| File > Import > Variable Data Sets | `importDataSets`, `null` = class `dataSetClass` | `Usng` alias (the text file), `Encd` (`dataSetEncoding`: `dataSetEncodingAuto`, …), `eraseAll` bool (replace existing), `useFirstColumn` bool (first column = data set names) |
| File > Package | `packageFile` | `T   ` alias (folder); writes "<document> Folder" (localised) with the document and a `Links` folder |
| File > Import > Video Frames to Layers | `importVideoToLayers` | `Usng` alias (video), `makeAnimation` bool, `frameSkip` long (limit to every n-th frame; absent when off) |
| File > Import > Notes (Annotations) | `importAnnots` | `Usng` alias (PDF). A file without notes shows "No annotations were imported" and records nothing |
| Layer > Video Layers > New Video Layer from File | `addVideoLayer` | `null` alias (video) |
| Layer > Video Layers > Replace Footage | `replaceFootage` | `null` alias (video) |
| Layer > Video Layers > Duplicate Frame, Restore Frame, Restore All Frames, Reload Frame | `duplicateFrame`, `restoreFrame`, `restoreAllFrames`, `reloadFrame` | none. Duplicate needs a painted frame; Restore needs an altered frame; Restore All asks for confirmation |
| File > Automate > Photomerge | the steps the script runs (open dialog, open, duplicate, `addLayerFromFile`, `align` with `layerTransformation`, `mergeAlignedLayers` …), then the script event `0f9db13f-a772-4035-9020-840f0e5e2f02` with an empty descriptor (class `cjsp`) | the layout and options are not in the step |
| File > Automate > Crop and Straighten Photos | `CropPhotosAuto0001` (no keys), then the steps it runs: `CropPhotos0001` with `Vl  ` (list of 8 doubles: the four corners), duplicate, `crop` | needs a selected, visible, unlocked layer, otherwise an error message and a step without effect |
| File > Automate > Conditional Mode Change | the Convert Mode it runs, then `8cba8cd6-cb66-11d1-bc43-0060b0a13dc4` | `Msge` text, `SrcM` list of `Cndn` enums (`UGry`, `URGB`, …: the source modes), `DstM` object whose class is the target mode (`CMYM` for CMYK) |
| File > Automate > Fit Image | the Image Size it runs, then `3caa3434-cb67-11d1-bc43-0060b0a13dc4` | `Msge` text, `Hght`, `Wdth` pixels, `limit` bool (don't enlarge) |

**Not recorded:** importing or applying inside Image > Variables > Data Sets (only the separate menu
commands record).

**Artboard from Group: guides and background** (measured 2026-11-02, script runs and a recording through the menu):

- **Recorded form:** the menu item opens no dialog. The step always has `guideIDs` empty, `artboardPresetName` "", `changeBackground` 1, and the
  background type and colour **last used** for an artboard (the Properties panel choice is sticky: after picking Black for one artboard, the
  next Artboard from Group records type 2 and makes a black artboard). Guides in the document do not change the recorded step.
- **`guideIDs`:** session metadata, not a playback input. Guide ids are a counter for the whole application session (a new document's
  guides got 5, 6, 7 after an earlier one's 2, 3, 4). Playing the step with the document's own guide ids, an unknown id (99999) or an
  empty list gives the same result: no error, the guides stay document guides (`kind` document), and the new artboard's `guideIDs` is empty.
  An implementation can ignore the list on playback and write `[]`.
- **`changeBackground`:** 1 or absent applies `artboardBackgroundType` and `Clr `. Any other value (0, 2, 3, -1, 7 tried) ignores both and
  makes a white artboard (type 1, `Clr ` 255/255/255), and the step's result then has no `changeBackground` key.
  `artboardBackgroundType` absent with `changeBackground` 1 gives type 1 (white).
- The artboard takes the group's bounds; `Clr ` is stored on the artboard as given even when the type is 1..3.

**Measured for the mapped events** (2026-11-02, script runs in the reference application):

- **Transform reference point** (`FTcs`, type `QCSt`): `Qcs0` top-left, `Qcs1` top-right, `Qcs2` bottom-right, `Qcs3` bottom-left
  corner; `Qcs4` top, `Qcs5` right, `Qcs6` bottom, `Qcs7` left edge centre; `Qcsa` the centre. `Qcs8` and unknown values also scale
  about the centre (not recorded).
- **Convert to Profile** records `sdwM` = -1 (with `Inte`, `Dthr`, `Fltt`, `rasterizePlaced`).
- **Plain Edit > Paste** records `AntA` = `Annt.Anno` and `As  ` = class `Pxel`.
- **Link Layers** (`linkSelectedLayers`) toggles when played: played twice on the same two layers it links, then unlinks them.
- **Split Channels** splits a document with a single layer, Background or not (a lone layer gives one more document); a document
  with more than one layer is refused.
- **Load Actions** with a set whose name is already in the panel adds a second set of that name; nothing is replaced.

## Measured through dialogs and recordings

Measured on 2026-11-01 in two ways: by running the event with its dialog and pressing OK (the reference
application then returns the full descriptor), and by recording actions through the menus and reading
the recorded steps back from the saved Actions panel. Ranges come from the dialog's own "a value between
… is required" message.

| Event | Keys (recorded order) | Notes |
|---|---|---|
| Custom (`Cstm`) | `Scl ` long 1..9999, `Ofst` long -9999..9999, `Mtrx` list of 25 longs -999..999 | Without the dialog the step needs all 25 cells, or the application fails. |
| Fibers (`Fbrs`) | `Vrnc` long 1..64, `Strg` long 1..64, `RndS` long (seed) | |
| Displace (`Dspl`) | `HrzS`, `VrtS` long -999..999; `DspM` (`StrF` stretch to fit, or tile); `UndA` (`RptE` repeat edge pixels, or wrap around); `DspF` alias: path of the displacement map (.psd) | The map file is chosen after OK. |
| Color Lookup (`colorLookup`) | `lookupType` (`colorLookupType`: `3DLUT`, abstract, device link); `Nm  ` text: the file's path; `Dthr` bool; `profile` raw data (ICC); `LUTFormat` (`LUTFormatType`, e.g. `LUTFormatLOOK`); `LUT3DFileData` raw data: the LUT file itself; `LUT3DFileName` text | The LUT travels inside the step. |
| Shape Blur (`shapeBlur`) | `Rds ` pixels 5..1000; `customShape` object (`Nm  ` text, `Idnt` text: the shape's id); `keyOriginType` long (9) | |
| Lighting Effects (`lightFilterLightingEffects`) | `k3DLights` list of lights (`Nm  `, colour `Rd  `/`Grn `/`Bl  ` 0..1, `hots`, `FlOf`, `shdw`, attenuation keys, `Type`, `ison`, `key3DMatrix` raw + floats, `X   `/`Y   `/`Z   `, target `tarx`/`tary`/`tarz`, `key3DPosition`), `key3DCurrentCameraPosition`, `Glos`, `Mtrl`, `Exps`, `AmbB`, `AmbC` RGB, `BmpA`, `BmpC` (texture channel by name, localised: "Ohne" = none), `Wdth`, `Hght` | A dialog-less run returns nothing; only a recording shows the keys. |
| Blur Gallery (`blurbTransform`) | `blurbType`, `VrsM`, `VrsN`, `referenceRect` (rectangle), `blurbOpenPanel`, `blurbGeneralBlurEffectApplied`, `blurbSaveMaskChannel`, `blurbHighQuality`, `blurbWidgetList` (per widget: `blurbWidgetType` (0 = field blur), `blurbWidgetLocationX`/`Y`, `blurbWidgetSelected`, `blurbWidgetEffectEnabled`, `blurbGeneralBlurAmount`) | One event for all five Blur Gallery filters. |
| Liquify (`LqFy`) | `LqMe` raw data: the mesh | Opaque; keep the step as recorded. |
| Camera Raw Filter | `CrVe` text (version), `PrVN` long, `PrVe` long | With settings at their defaults; changed settings add keys. |
| Vanishing Point (`VnPt`) | none | The planes are not recorded. |
| Calculations | recorded as Make: `Nw  ` class channel, `Usng` object (`T   ` reference: source 1 channel and layer, `Clcl` blend mode, `Src2` reference) | Not a `calculations` event. |
| Image Size, size in cm or inches | `Wdth` in `#Rlt` (points), `scaleStyles`, `CnsP`, `Intr` | A physical size is recorded in points, not pixels: playback needs the document's resolution. |
| Canvas Size | only the changed side; `canvasExtensionColorType` `FrgC` for the foreground colour | |
| Convert Mode, several layers, "Don't Flatten" | `T   ` as a **class** (`Grys`), `Fltt` false, `Rstr` false | With `Fltt` and `Rstr` the step plays without the flatten question. |
| New Group with a colour | `Usng` (`Clr ` label), `layerSectionStart`, `layerSectionEnd`, top-level `Nm  ` | |
| Shear (`Shr `) | `ShrP` list of `Pnt ` (`Hrzn`, `Vrtc` doubles), `UndA` (`WrpA` wrap around, `RptE` repeat edge pixels), `ShrS` long, `ShrE` long | The dialog writes whole numbers: `Hrzn` -64..63 (dragging past the grid clamps), `Vrtc` 1..128 with the first point at 1 and the last at 128; dragging a point out of the grid deletes it. `ShrS` is 0 and `ShrE` the last point's index (count - 1). Script runs take any value unclamped and crashed on far-off `ShrE`/`ShrS` or a first `Vrtc` below 1. |
| Gradient tool, classic (`Grdn` / `gradientClassEvent`) | `From`, `T   ` points in pixels; `Opct` percent, `Md  ` blend mode, `Type` (`GrdT`: `Lnr `, `Rdl `, `Angl`, `Rflc`, `Dmnd`), `Rvrs` bool, `Dthr` bool, `UsMs` bool (transparency), `gradientsInterpolationMethod` (`Perc` perceptual, …), `Grad` gradient object (as in Gradient Map) | Recorded in that order. `Opct`, `Md  ` and `Rvrs` appear only when they differ from 100 %, Normal and off; `Dthr` and `UsMs` only when on. The five types are the only accepted values. A step without `Grad` fails. |
| Gradient tool, default mode | two steps: Make (`null` = class `contentLayer`, `Usng` = `Type` gradient layer object) then Set (`null` = `contentLayer` target, `T   ` = the same object plus `Algn` false) | The object: `Dthr`, `gradientsInterpolationMethod`, `Angl` angle, `Type`, `Scl ` percent, `Ofst` (`Hrzn`, `Vrtc` percent), `Grad`. The new tool makes a gradient fill layer; Make holds the first click, Set the finished drag. |
| Content-Aware Fill (`cafWorkspace`) | `cafSamplingRegion` (`cafSamplingRegionRectangular`, …), `cafSampleAllLayers` bool, `cafColorAdaptationLevel` (`cafColorAdaptationDefault`, …), `cafRotationAmount` (`cafRotationAmountNone`, …), `cafScale` bool, `cafMirror` bool, `cafOutput` (`cafOutputToNewLayer`, …) | Runs on the selection, which is recorded as its own step before it. |
| Perspective Warp (`perspectiveWarpTransform`) | `null` = layer target, `Md  ` (`perspectiveWarpMode`: `warp`), `referenceRect` rectangle in pixels, `vertices` list of points in pixels (the layout quad), `warpedVertices` (the same points after warping), `quads` list of `indices` (4 vertex indexes each) | Layout and warp are one step. |
| Print (`print`) then Print One Copy (`printOneCopy`) | `print`: `null` = reference `printOutput` property of the target document; `printOutput` (`PstS`, `Inte`, `printSixteenBit`, `printerName` text, `printProofSetup`), `printViewProofSetup`, `printOutputOptions` (caption, marks, `Bckg` colour, `BrdT`, `Bld `, `Rslt`, `vectorData`, `PgPs`, `Left`, `Top `, `Scl `, crop rectangle), `osSpecificPrintInfo` raw data, `Cptn` text. `printOneCopy` has no keys. | Pressing Print in the dialog records both steps. |
| Create Droplet (`CrtD`) | `In  ` alias: the droplet file; `Fldr` bool (include subfolders); `Usng` reference to the action; then the Batch keys below (destination, file naming, error log) when set | The same settings as Batch, with the droplet file instead of a source folder. |
| Sky Replacement (`skyReplacement`) | `shiftEdge` double, `borderSmoothness` long (fade edge, default 50), `Brgh` long, `temperature` long, `harmonizationOpacity` long (35), `foregroundLightingOpacity` long, `lightingMode` blend mode (`Mltp`), `edgeLightingOpacity` long (70), `skyReplacementOutput` (`skyReplacementOutputToNewSheets` new layers, …), `Idnt` text (the sky preset's id), `Nm  ` text (its name), `File` alias (the sky image) | Scale and Flip are **not** in the step: with 150 % and Flip on, the returned keys were the same. `foregroundLightingOpacity` is computed from the sky (44 and 29 for two skies). Without a chosen sky the dialog returns no keys. |

**Not recordable:** Edit > Purge (no step is recorded; this version's Purge menu has Clipboard,
Histories, All and Video Cache, no Undo); File > Export > Export As and Quick Export as PNG (the file
is written, no step is recorded). `vectorStrokeToFill` (Convert Stroke to Fill) exists only internally: the reference application knows
it by a localised command name ("command … is not currently available"), but it is in no menu, panel
menu, context menu, the stroke options (incl. their gear menu), the Properties panel or the Keyboard
Shortcuts summary of all commands and tools, and the event is refused even with a stroked path component
selected. It can't be triggered, so it is never recorded: no action contains it, nothing to map.

### Batch

Running Batch while recording records the steps the batch played, not a Batch step. The Batch
descriptor itself (`Btch`, as the dialog returns it):

| Key | Type | Meaning |
|---|---|---|
| `null` | alias, or enum | source folder; for open documents the enum `batchSourceType` `sourceOpenFiles` |
| `OvrO` | bool | override action "Open" commands (written only when on) |
| `Fldr` | bool | include all subfolders |
| `suppressWarnings` | bool | suppress colour profile warnings |
| `suppressOpenOptions` | bool | suppress file open options dialogs |
| `Usng` | reference | the action: `Actn` by name in `ASet` by name |
| `T   ` | alias | destination folder (destination Folder) |
| `SvAn` | bool | destination Save and Close (written instead of `T   `) |
| `Ovrd` | bool | override action "Save As" commands (written only when on) |
| `fileNamingRules` | object | file naming (below) |
| `Log ` | alias | folder of the error log ("log errors to file") |
| `Nm  ` | text | error log file name |

`fileNamingRules`: `fileNamingComponents` (list of up to six objects; each is `component` enum
`fileNamingComponent`, or `Txt ` text for typed text), `Strt` long (starting serial number), `Mcnt`, `Win `,
`unix` bool (compatibility).

| Component | Menu entry |
|---|---|
| `Nm  ` / `lowerCase` / `upperCase` | Document Name / document name / DOCUMENT NAME |
| `oneDigit` `twoDigit` `threeDigit` `fourDigit` | 1, 2, 3, 4 digit serial number |
| `lowerCaseSerial` / `upperCaseSerial` | serial letter (a, b, c…) / (A, B, C…) |
| `mmddyy` `mmdd` `yyyymmdd` `yymmdd` `yyddmm` `ddmmyy` `ddmm` | dates |
| `lowerCaseExtension` / `upperCaseExtension` | extension / EXTENSION |

The extension component is written **without a dot, unless it is the last component**, and nothing
else adds an extension: the name is exactly what the components spell. Measured on `a.png`:

| Components | Saved as |
|---|---|
| Name + extension | `a.png` |
| Name + EXTENSION | `a.PNG` |
| Name + extension + 3 digit serial | `apng001` (no extension) |
| Name + 3 digit serial | `a001` (no extension) |
| Name + extension + text `x` | `apngx` |
| Name + extension + extension | `apng.png` |
| Name + text `.jpg` | `a.jpg` (still PNG data) |
| DOCUMENT NAME + `_` + serial letter + `_` + SERIAL LETTER | `A_a_A` |

The two short date entries are `mmdd` and `ddmm` (on 1 November they give `1101` and `0111`).

#### Batch behaviour

Measured with a folder `in` holding `a.png`, `b.png`, `notes.txt` and `sub/a.png`, `sub/c.png`,
`sub/deeper/d.png`:

- **Order:** the folder's files by name, then each subfolder (by name, depth first). The serial number
  counts across all of them: `a_001` (`in/a`), `b_002`, `a_003` (`in/sub/a`), `c_004`, `d_005`.
- **Include All Subfolders:** results all go **flat into the destination folder**; the subfolder structure
  is not rebuilt. A later file with the same output name **silently overwrites** an earlier one
  (`in/a.png` and `in/sub/a.png` give one `a.png`).
- **Destination None:** every processed file stays open, changed and unsaved. **Save and Close** saves
  each file over itself in its own format and closes it. **Folder** saves a copy named by the file
  naming rules. An open document that was never saved asks with a Save As dialog (Photoshop format,
  the document's name) even with Folder as the destination.
- **Override Open:** files are opened only by the action's own Open steps; without one the action runs
  with no document and every file fails. **Override Save As:** files are saved only by the action's own
  Save As steps, into the destination folder; without one nothing is saved. The dialog says both when
  the box is ticked.
- **Files that are not images** (`notes.txt`) are an error for that file (code -25600, "extension not
  recognised"), not skipped silently.
- **Errors, Stop For Errors** (no `Log ` key): the batch stops at the failing file; files before it are
  saved, nothing after it is processed.
- **Errors, Log Errors To File:** the batch goes on, and at the end a message says an error occurred and
  the details are in the log. The log file is **UTF-16 LE with BOM and CRLF**, and is written even when
  nothing failed. In German the lines are (the application's own language):

  ```
  Stapelanfang
  <blank>
  Datei: "<full path, or the document's name for open documents>"
  Fehler: <message> (<error code>)
  <blank>
  …one pair per failed file…
  Stapelende
  ```
- **Cancel:** Esc during a batch stops the running command and asks "A command was cancelled or stopped
  during batch processing. Continue with the next file or stop?" (Continue / Stop). Stop ends the batch
  at once; the file being processed is not saved (12 of 60 written in the test). There is no progress
  bar: the documents open and close in the window as they are processed.
- **Return value:** when any file failed, the Batch step itself reports "cancelled" (the dialog returns no
  descriptor); a script run with Stop For Errors reports success even though it stopped.

### Actions panel menu

Button Mode; New Action, New Set, Duplicate, Delete, Play; Start Recording, Record Again, Insert Menu
Item, Insert Stop, Insert Conditional, Insert Path; Action Options, Playback Options, Allow Tool
Recording; Clear All Actions, Reset Actions, Load Actions, Replace Actions, Save Actions; the bundled sets
(Commands, Frames, Image Effects, LAB Black & White Technique, Production, Star Trails, Text Effects,
Textures, Video Actions); Close, Close Tab Group. Playback Options: Accelerated, Step by Step, Pause For
1..60 seconds.

How two menu entries record: **Insert Menu Item** records the chosen menu command's own event with no
descriptor (Image > Image Size gives an `imageSize` step without settings; playback opens its dialog).
**Insert Path** records a `set` of the work path: `null` = reference `Path` property `WrPt`, `T   ` = list
of path components (`shapeOperation`, `SbpL` list of subpaths, each with `Clsp` closed and `Pts ` list of
points with `Anch` in pixels).

## Recording that plays on any document

What the reference application records when a user works normally, measured on 2026-11-01 by recording
an action through the panel, mouse and keyboard on a document with layers A, B and C and a second open
document, then reading the steps back. This is the form PhotoCraft's recorder should write (AUTO-219-1);
today it copies journal entries with explicit layer ids.

| User action | Recorded step |
|---|---|
| Click a layer in the Layers panel | `select`, `null` = layer **by name** (`"B"`), `MkVs` false, `LyrI` list of layer ids (a hint, not the reference) |
| Ctrl+J (Layer via Copy) | `copyToLayer`, no keys |
| Click an empty spot of the canvas with Auto-Select on | `selectNoLayers`, `null` = layer target |
| Arrow keys with the Move tool | **one** `move` step per run of key presses, `null` = layer target, `T   ` offset in pixels: Right, Right, Right, Shift+Down gave `Hrzn` 3, `Vrtc` 10 |
| Eye icon | `hide` (or `show`), `null` = **list** of layers by name |
| Opacity typed in the Layers panel | `set` of the target layer, `T   ` = `Opct` percent (pressing Enter after typing recorded the same step twice) |
| Select All, Deselect | `set` of the selection (`fsel`) to `Al  ` / `None` |
| Alt+Backspace (fill with foreground) | `fill`, `Usng` `FrgC`, `Opct` 100 %, `Md  ` Normal |
| Type tool: click, type "Hallo", commit | **one** `make` of a text layer (`TxLr`) with `Txt ` = the whole text; position `TxtC` in **percent of the canvas**; bounds in points |
| Ctrl+E (Merge Down) | `mergeLayersNew`, no keys |
| Ctrl+Tab / Ctrl+Shift+Tab | `select` of a document **by offset** (`rele` +1 / -1) plus `DocI` (the document id, a hint) and `forceNotify` |

So the recorder names layers by name and acts on the target layer, never by id; it merges a run of
nudges into one relative move and a typing session into one text step; text and document positions are
relative.

### Playing on another document

The same recording played on two other documents (Play from step 2, skipping the setup step):

- **Same layer names, new ids:** plays through; layers are found by name, `LyrI` and `DocI` are ignored.
- **No layer with that name** (layers X, Y, Z): each step that names a missing layer stops with a
  message and Continue / Stop. Select by name: "The command 'Select' is not currently available". Hide by
  name: "The object 'Layer "A"' is not currently available". Steps on the target layer act on whatever
  layer is selected (Ctrl+J copied Z into "Z Kopie").
- **After `selectNoLayers`**, steps that need a target layer (move, set opacity, fill) each stop with
  "The command '…' is not currently available" and Continue / Stop. Continue skips the step; nothing is
  undone.
- **Play from a step:** selecting a step in the panel and pressing Play plays from that step to the end.

## Older files: version 12

Action sets saved by the reference application's version 5 era use file version 12. PhotoCraft rejects
them today; this is what reading them needs. Checked on 2026-11-01 on 325 real version 12 sets (all parse
to the end with this layout) and against AtnKit (MIT), which reads version 12 but gets two details wrong
(noted below).

**Only the descriptor differs.** The file header, the action record and the step record are the same as
in version 16 (set and action names are UTF-16 strings with a counted NUL; events are almost always
4-character codes, so the existing event table applies). Trailing bytes after the last action occur in
22 of 325 files (stale data from an overwritten file): keep them a warning.

The version 12 descriptor:

- The step's descriptor has no name and no class: it starts with the item count.
- Every identifier is a bare 4-byte code, with no length prefix: keys, classes, enum types and values,
  units, reference classes. No Unicode class names anywhere.
- Strings (`TEXT`, reference names) are the same UTF-16 strings as in version 16.

```text
step descriptor := count u32, count × (key [4], type [4], value)
object          := class [4], count u32, count × (key [4], type [4], value)

bool u8 | long i32 | comp i64 | doub f64 | UntF unit [4] + f64
UnFl unit [4] + n u32 + n × f64
TEXT UTF-16 string | enum type [4] + value [4]
Objc / GlbO object | type / GlbC class [4]
VlLs n u32 + n × (type [4] + value)
ObAr class [4] + object count u32 + count u32 + count × (key [4], type [4], value)
obj  n u32 + n × reference item
tdta / alis / Pth  u32 length + bytes

reference item := form [4] + class [4] + (prop: key [4] | Clss: nothing | Enmr: type [4] + value [4]
                  | rele: i32 | indx: u32 | Idnt: u32 | name: UTF-16 string)
```

AtnKit reads `indx` without its class code and has no case for `UnFl`, `ObAr` and `Pth `; with those
fixed, all 325 files parse. `Idnt` was not seen in a version 12 file; its layout follows `indx`.

**Into PhotoCraft's model:** every id becomes a 4-character code; the step descriptor gets the empty name
and class `null` that version 16 files use for code events; nested classes get the empty name. Save Actions
keeps writing version 16. Version 7 files (a different layout with 8-bit strings) and sets wrapped in
MacBinary stay rejected.

## Event reference: measured specs

Each entry below is an event the reference application records, as measured there: its 4-character code
and string ID, the PhotoCraft command it maps to (or should map to), and every key the step carries, in the
order it is recorded, with type, unit, factory default and allowed values. The Supported events table says
which of them PhotoCraft maps today; for the others an entry has everything needed to implement them. When
an event is implemented, add it to that table in the same change.

### How these values were measured

- **Keys, order, types, units, defaults:** each event was run in the reference application without a
  dialog on an RGB 8-bit document (with a selection, the clipboard or several layers where the step
  needs them), and the descriptor it returned was read back. That descriptor is what an action records.
  Settings were reset first, so the defaults are factory defaults. Steps that need a prepared document
  (a selection, the clipboard, several layers) were run with example values; their tables say so and show
  those values instead of defaults.
- **Ranges:** every number was set far above and below its range. The application clamps instead of
  refusing, so the values it returned are the exact limits. "Out-of-range values are clamped" in a table
  means exactly that; implement the same clamping on import.
- **Enum values:** every known enum value was tried; only values the application accepted and returned
  unchanged are listed. A value outside the list should keep the step as a kept step.
- **Names:** keys are stored by their 4-character code. The string ID column is a label; where one code
  has two names in the application, the one that fits the setting is shown.
- **Filter Gallery effects:** the "PhotoCraft today" column compares each value with PhotoCraft's own
  effect parameters (`crates/algo/src/artistic.rs`). All ranges and defaults already match; 26 parameters
  have a different name in PhotoCraft, given in that column.

### What an implementation needs to do

1. **Import:** `actions.load` maps the step to the command and params listed, using every key in the
   table; missing keys take the default from the table.
2. **Out-of-range values:** clamped to the allowed range, as the reference application does. Enum values
   outside the allowed list keep the step as a kept step, never a silent default.
3. **Export:** `actions.save` writes the same event with all keys in the order of the table, defaults
   included, with the units shown.
4. **Round trip:** load, then save, gives identical descriptors, for a step with defaults and for one
   with every value changed.
5. **Tests:** add the event to `every_mapped_command_exports_and_imports_back` and test the params that
   reach the command.

### Group A: The 47 Filter Gallery effects

Each Filter Gallery effect is recorded as its own event (one per effect), carrying a `GEfk` key with the effect id plus the effect's settings. Today only Spatter (`GEfk` = `Spt`) is mapped (to `filter.gallery.spatter`); the other effects load as kept steps that stop at playback. PhotoCraft already has every effect (`crates/algo/src/artistic.rs`) behind `filter.filterGallery`; this issue only maps them. Where our own range or default differs from the measured one, fix ours to match (marked in each table).

#### Accented Edges

- Event: `AccE` / `accentedEdges`
- PhotoCraft command: `filter.filterGallery effect "accentedEdges"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `EdgW` | edgeWidth | integer |  | 2 | 1 .. 14 (out-of-range values are clamped) | same |
| `EdgB` | edgeBrightness | integer |  | 38 | 0 .. 50 (out-of-range values are clamped) | same |
| `Smth` | smoothness | integer |  | 5 | 1 .. 15 (out-of-range values are clamped) | same |

#### Angled Strokes

- Event: `AngS` / `angledStrokes`
- PhotoCraft command: `filter.filterGallery effect "angledStrokes"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `DrcB` | directionBalance | integer |  | 50 | 0 .. 100 (out-of-range values are clamped) | same |
| `StrL` | strokeLength | integer |  | 15 | 3 .. 50 (out-of-range values are clamped) | same |
| `Shrp` | sharpness | integer |  | 3 | 0 .. 10 (out-of-range values are clamped) | maps to our `sharpness` (same range and default) |

#### Bas Relief

- Event: `BsRl` / `basRelief`
- PhotoCraft command: `filter.filterGallery effect "basRelief"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `Dtl ` | detail | integer |  | 13 | 1 .. 15 (out-of-range values are clamped) | same |
| `Smth` | smoothness | integer |  | 3 | 1 .. 15 (out-of-range values are clamped) | same |
| `LghD` | lightDirection | enumerated |  | `LDBt` lightDirBottom | `LDBL` lightDirBottomLeft, `LDBR` lightDirBottomRight, `LDBt` lightDirBottom, `LDLf` lightDirLeft, `LDRg` lightDirRight, `LDTL` lightDirTopLeft, `LDTR` lightDirTopRight, `LDTp` lightDirTop |  |

#### Chalk Charcoal

- Event: `ChlC` / `chalkCharcoal`
- PhotoCraft command: `filter.filterGallery effect "chalkCharcoal"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `ChrA` | charcoalArea | integer |  | 6 | 0 .. 20 (out-of-range values are clamped) | same |
| `ChlA` | chalkArea | integer |  | 6 | 0 .. 20 (out-of-range values are clamped) | same |
| `StrP` | strokePressure | integer |  | 1 | 0 .. 5 (out-of-range values are clamped) | same |

#### Charcoal

- Event: `Chrc` / `charcoal`
- PhotoCraft command: `filter.filterGallery effect "charcoal"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `ChAm` | charcoalAmount | integer |  | 1 | 1 .. 7 (out-of-range values are clamped) | maps to our `charcoalThickness` (same range and default) |
| `Dtl ` | detail | integer |  | 5 | 0 .. 5 (out-of-range values are clamped) | same |
| `LgDr` | lightDark | integer |  | 50 | 0 .. 100 (out-of-range values are clamped) | maps to our `lightDarkBalance` (same range and default) |

#### Chrome

- Event: `Chrm` / `chrome`
- PhotoCraft command: `filter.filterGallery effect "chrome"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `Dtl ` | detail | integer |  | 4 | 0 .. 10 (out-of-range values are clamped) | same |
| `Smth` | smoothness | integer |  | 7 | 0 .. 10 (out-of-range values are clamped) | same |

#### Colored Pencil

- Event: `ClrP` / `coloredPencil`
- PhotoCraft command: `filter.filterGallery effect "coloredPencil"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `Pncl` | pencilWidth | integer |  | 4 | 1 .. 24 (out-of-range values are clamped) | maps to our `pencilWidth` (same range and default) |
| `StrP` | strokePressure | integer |  | 8 | 0 .. 15 (out-of-range values are clamped) | same |
| `PprB` | paperBrightness | integer |  | 25 | 0 .. 50 (out-of-range values are clamped) | same |

#### Conte Crayon

- Event: `CntC` / `conteCrayon`
- PhotoCraft command: `filter.filterGallery effect "conteCrayon"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `FrgL` | foregroundLevel | integer |  | 11 | 1 .. 15 (out-of-range values are clamped) | same |
| `BckL` | backgroundLevel | integer |  | 7 | 1 .. 15 (out-of-range values are clamped) | maps to our `backgroundLevel` (same range and default) |
| `TxtT` | textureType | enumerated |  | `TxCa` texTypeCanvas | `TxBr` texTypeBrick, `TxBu` texTypeBurlap, `TxCa` texTypeCanvas, `TxSt` texTypeSandstone |  |
| `Scln` | scaling | integer |  | 100 | 50 .. 200 (out-of-range values are clamped) | same |
| `Rlf ` | relief | integer |  | 4 | 0 .. 50 (out-of-range values are clamped) | same |
| `LghD` | lightDirection | enumerated |  | `LDTp` lightDirTop | `LDBL` lightDirBottomLeft, `LDBR` lightDirBottomRight, `LDBt` lightDirBottom, `LDLf` lightDirLeft, `LDRg` lightDirRight, `LDTL` lightDirTopLeft, `LDTR` lightDirTopRight, `LDTp` lightDirTop |  |
| `InvT` | invertTexture | boolean |  | false |  |  |

#### Craquelure

- Event: `Crql` / `craquelure`
- PhotoCraft command: `filter.filterGallery effect "craquelure"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `CrcS` | crackSpacing | integer |  | 15 | 2 .. 100 (out-of-range values are clamped) | same |
| `CrcD` | crackDepth | integer |  | 6 | 0 .. 10 (out-of-range values are clamped) | same |
| `CrcB` | crackBrightness | integer |  | 9 | 0 .. 10 (out-of-range values are clamped) | same |

#### Crosshatch

- Event: `Crsh` / `crosshatch`
- PhotoCraft command: `filter.filterGallery effect "crosshatch"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `StrL` | strokeLength | integer |  | 9 | 3 .. 50 (out-of-range values are clamped) | same |
| `Shrp` | sharpness | integer |  | 6 | 0 .. 20 (out-of-range values are clamped) | maps to our `sharpness` (same range and default) |
| `Strg` | strength | integer |  | 1 | 1 .. 3 (out-of-range values are clamped) | maps to our `strength` (same range and default) |

#### Cutout

- Event: `Ct  ` / `cutout`
- PhotoCraft command: `filter.filterGallery effect "cutout"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `NmbL` | numberOfLayers | integer |  | 4 | 2 .. 8 (out-of-range values are clamped) | maps to our `numberOfLevels` (same range and default) |
| `EdgS` | edgeSimplicity | integer |  | 4 | 0 .. 10 (out-of-range values are clamped) | same |
| `EdgF` | edgeFidelity | integer |  | 2 | 1 .. 3 (out-of-range values are clamped) | same |

#### Dark Strokes

- Event: `DrkS` / `darkStrokes`
- PhotoCraft command: `filter.filterGallery effect "darkStrokes"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `Blnc` | balance | integer |  | 5 | 0 .. 10 (out-of-range values are clamped) | same |
| `BlcI` | blackIntensity | integer |  | 6 | 0 .. 10 (out-of-range values are clamped) | same |
| `WhtI` | whiteIntensity | integer |  | 2 | 0 .. 10 (out-of-range values are clamped) | same |

#### Diffuse Glow

- Event: `DfsG` / `diffuseGlow`
- PhotoCraft command: `filter.filterGallery effect "diffuseGlow"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `Grns` | graininess | integer |  | 6 | 0 .. 10 (out-of-range values are clamped) | same |
| `GlwA` | glowAmount | integer |  | 10 | 0 .. 20 (out-of-range values are clamped) | same |
| `ClrA` | clearAmount | integer |  | 15 | 0 .. 20 (out-of-range values are clamped) | same |

#### Dry Brush

- Event: `DryB` / `dryBrush`
- PhotoCraft command: `filter.filterGallery effect "dryBrush"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `BrsS` | brushSize | integer |  | 2 | 0 .. 10 (out-of-range values are clamped) | same |
| `BrsD` | brushDetail | integer |  | 8 | 0 .. 10 (out-of-range values are clamped) | same |
| `Txtr` | texture | integer |  | 1 | 1 .. 3 (out-of-range values are clamped) | same |

#### Film Grain

- Event: `FlmG` / `filmGrain`
- PhotoCraft command: `filter.filterGallery effect "filmGrain"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `Grn ` | grain | integer |  | 4 | 0 .. 20 (out-of-range values are clamped) | same |
| `HghA` | highlightArea | integer |  | 0 | 0 .. 20 (out-of-range values are clamped) | same |
| `Intn` | intensity | integer |  | 10 | 0 .. 10 (out-of-range values are clamped) | same |

#### Fresco

- Event: `Frsc` / `fresco`
- PhotoCraft command: `filter.filterGallery effect "fresco"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `BrsS` | brushSize | integer |  | 2 | 0 .. 10 (out-of-range values are clamped) | same |
| `BrsD` | brushDetail | integer |  | 8 | 0 .. 10 (out-of-range values are clamped) | same |
| `Txtr` | texture | integer |  | 1 | 1 .. 3 (out-of-range values are clamped) | same |

#### Glass

- Event: `Gls ` / `glass`
- PhotoCraft command: `filter.filterGallery effect "glass"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `Dstr` | distortion | integer |  | 5 | 0 .. 20 (out-of-range values are clamped) | maps to our `distortion` (same range and default) |
| `Smth` | smoothness | integer |  | 3 | 1 .. 15 (out-of-range values are clamped) | same |
| `TxtT` | textureType | enumerated |  | `TxFr` texTypeFrosted | `TxBr` texTypeBrick, `TxBu` texTypeBurlap, `TxCa` texTypeCanvas, `TxSt` texTypeSandstone |  |
| `Scln` | scaling | integer |  | 100 | 50 .. 200 (out-of-range values are clamped) | same |
| `InvT` | invertTexture | boolean |  | false |  |  |

#### Glowing Edges

- Event: `GlwE` / `glowingEdges`
- PhotoCraft command: `filter.filterGallery effect "glowingEdges"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `EdgW` | edgeWidth | integer |  | 2 | 1 .. 14 (out-of-range values are clamped) | same |
| `EdgB` | edgeBrightness | integer |  | 6 | 0 .. 20 (out-of-range values are clamped) | same |
| `Smth` | smoothness | integer |  | 5 | 1 .. 15 (out-of-range values are clamped) | same |

#### Graphic Pen

- Event: `GraP` / `graphicPen`
- PhotoCraft command: `filter.filterGallery effect "graphicPen"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `StrL` | strokeLength | integer |  | 15 | 1 .. 15 (out-of-range values are clamped) | same |
| `LgDr` | lightDark | integer |  | 50 | 0 .. 100 (out-of-range values are clamped) | maps to our `lightDarkBalance` (same range and default) |
| `SDir` | strokeDirection | enumerated |  | `SDRD` strokeDirRightDiag | `SDHz` strokeDirHorizontal, `SDLD` strokeDirLeftDiag, `SDRD` strokeDirRightDiag, `SDVt` strokeDirVertical |  |

#### Halftone Screen

- Event: `HlfS` / `halftoneScreen`
- PhotoCraft command: `filter.filterGallery effect "halftonePattern"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `HlSz` | halftoneSize | integer |  | 1 | 1 .. 12 (out-of-range values are clamped) | maps to our `size` (same range and default) |
| `Cntr` | contrast | integer |  | 5 | 0 .. 50 (out-of-range values are clamped) | maps to our `contrast` (same range and default) |
| `ScrT` | screenType | enumerated |  | `ScrD` screenDot | `ScrC` screenCircle, `ScrD` screenDot, `ScrL` screenLine |  |

#### Ink Outlines

- Event: `InkO` / `inkOutlines`
- PhotoCraft command: `filter.filterGallery effect "inkOutlines"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `StrL` | strokeLength | integer |  | 4 | 1 .. 50 (out-of-range values are clamped) | same |
| `DrkI` | darkIntensity | integer |  | 20 | 0 .. 50 (out-of-range values are clamped) | same |
| `LghI` | lightIntensity | integer |  | 10 | 0 .. 50 (out-of-range values are clamped) | same |

#### Mosaic  Tiles

- Event: `MscT` (no string ID)
- PhotoCraft command: `filter.filterGallery effect "mosaicTiles"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `TlSz` | tileSize | integer |  | 12 | 2 .. 100 (out-of-range values are clamped) | same |
| `GrtW` | groutWidth | integer |  | 3 | 1 .. 15 (out-of-range values are clamped) | same |
| `LghG` | lightenGrout | integer |  | 9 | 0 .. 10 (out-of-range values are clamped) | same |

#### Neon Glow

- Event: `NGlw` / `neonGlow`
- PhotoCraft command: `filter.filterGallery effect "neonGlow"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `Sz  ` | size | integer |  | 5 | -24 .. 24 (out-of-range values are clamped) | maps to our `glowSize` (same range and default) |
| `Brgh` | brightness | integer |  | 15 | 0 .. 50 (out-of-range values are clamped) | maps to our `glowBrightness` (same range and default) |
| `Clr ` | color | object |  | obj 'RGBC' RGBColor |  |  |

Nested values as recorded (defaults):
```
    'Rd  ' red : DOUBLETYPE = 0
    'Grn ' green : DOUBLETYPE = 0
    'Bl  ' blue : DOUBLETYPE = 255
```

#### Note Paper

- Event: `NtPr` / `notePaper`
- PhotoCraft command: `filter.filterGallery effect "notePaper"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `ImgB` | imageBalance | integer |  | 25 | 0 .. 50 (out-of-range values are clamped) | same |
| `Grns` | graininess | integer |  | 10 | 0 .. 20 (out-of-range values are clamped) | same |
| `Rlf ` | relief | integer |  | 11 | 0 .. 25 (out-of-range values are clamped) | same |

#### Ocean Ripple

- Event: `OcnR` / `oceanRipple`
- PhotoCraft command: `filter.filterGallery effect "oceanRipple"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `RplS` | rippleSize | integer |  | 9 | 1 .. 15 (out-of-range values are clamped) | same |
| `RplM` | rippleMagnitude | integer |  | 9 | 0 .. 20 (out-of-range values are clamped) | same |

#### Paint Daubs

- Event: `PntD` / `paintDaubs`
- PhotoCraft command: `filter.filterGallery effect "paintDaubs"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `Sz  ` | size | integer |  | 8 | 1 .. 50 (out-of-range values are clamped) | maps to our `brushSize` (same range and default) |
| `Shrp` | sharpness | integer |  | 7 | 0 .. 40 (out-of-range values are clamped) | maps to our `sharpness` (same range and default) |
| `BrsT` | brushType | enumerated |  | `BrSm` brushSimple | `BrDR` brushDarkRough, `BrSm` brushSimple, `BrSp` brushSparkle, `BrbW` brushWideBlurry, `BrsL` brushLightRough, `BrsW` brushWideSharp |  |

#### Palette Knife

- Event: `PltK` / `paletteKnife`
- PhotoCraft command: `filter.filterGallery effect "paletteKnife"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `StrS` | strokeSize | integer |  | 25 | 1 .. 50 (out-of-range values are clamped) | same |
| `StDt` | strokeDetail | integer |  | 3 | 1 .. 3 (out-of-range values are clamped) | same |
| `Sftn` | softness | integer |  | 0 | 0 .. 10 (out-of-range values are clamped) | same |

#### Patchwork

- Event: `Ptch` / `patchwork`
- PhotoCraft command: `filter.filterGallery effect "patchwork"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `SqrS` | squareSize | integer |  | 4 | 0 .. 10 (out-of-range values are clamped) | same |
| `Rlf ` | relief | integer |  | 8 | 0 .. 25 (out-of-range values are clamped) | same |

#### Photocopy

- Event: `Phtc` / `photocopy`
- PhotoCraft command: `filter.filterGallery effect "photocopy"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `Dtl ` | detail | integer |  | 7 | 1 .. 24 (out-of-range values are clamped) | same |
| `Drkn` | darkness | integer |  | 8 | 1 .. 50 (out-of-range values are clamped) | maps to our `darkness` (same range and default) |

#### Plaster

- Event: `Plst` / `plaster`
- PhotoCraft command: `filter.filterGallery effect "plaster"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `ImgB` | imageBalance | integer |  | 20 | 0 .. 50 (out-of-range values are clamped) | same |
| `Smth` | smoothness | integer |  | 2 | 1 .. 15 (out-of-range values are clamped) | same |
| `LghP` | lightPosition | enumerated |  | `LPTp` lightPosTop | `LPBL` lightPosBottomLeft, `LPBr` lightPosBottomRight, `LPBt` lightPosBottom, `LPLf` lightPosLeft, `LPRg` lightPosRight, `LPTL` lightPosTopLeft, `LPTR` lightPosTopRight, `LPTp` lightPosTop |  |

#### Plastic Wrap

- Event: `PlsW` / `plasticWrap`
- PhotoCraft command: `filter.filterGallery effect "plasticWrap"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `HghS` | highlightStrength | integer |  | 15 | 0 .. 20 (out-of-range values are clamped) | same |
| `Dtl ` | detail | integer |  | 9 | 1 .. 15 (out-of-range values are clamped) | same |
| `Smth` | smoothness | integer |  | 7 | 1 .. 15 (out-of-range values are clamped) | same |

#### Poster Edges

- Event: `PstE` / `posterEdges`
- PhotoCraft command: `filter.filterGallery effect "posterEdges"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `EdgT` | edgeThickness | integer |  | 2 | 0 .. 10 (out-of-range values are clamped) | same |
| `EdgI` | edgeIntensity | integer |  | 1 | 0 .. 10 (out-of-range values are clamped) | same |
| `Pstr` | posterization | integer |  | 2 | 0 .. 6 (out-of-range values are clamped) | same |

#### Reticulation

- Event: `Rtcl` / `reticulation`
- PhotoCraft command: `filter.filterGallery effect "reticulation"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `Dnst` | density | integer |  | 12 | 0 .. 50 (out-of-range values are clamped) | same |
| `BlcL` | blackLevel | integer |  | 40 | 0 .. 50 (out-of-range values are clamped) | maps to our `foregroundLevel` (same range and default) |
| `WhtL` | whiteLevel | integer |  | 5 | 0 .. 50 (out-of-range values are clamped) | maps to our `backgroundLevel` (same range and default) |

#### Rough Pastels

- Event: `RghP` / `roughPastels`
- PhotoCraft command: `filter.filterGallery effect "roughPastels"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `StrL` | strokeLength | integer |  | 6 | 0 .. 40 (out-of-range values are clamped) | same |
| `StDt` | strokeDetail | integer |  | 4 | 1 .. 20 (out-of-range values are clamped) | same |
| `TxtT` | textureType | enumerated |  | `TxCa` texTypeCanvas | `TxBr` texTypeBrick, `TxBu` texTypeBurlap, `TxCa` texTypeCanvas, `TxSt` texTypeSandstone |  |
| `Scln` | scaling | integer |  | 100 | 50 .. 200 (out-of-range values are clamped) | same |
| `Rlf ` | relief | integer |  | 20 | 0 .. 50 (out-of-range values are clamped) | same |
| `LghD` | lightDirection | enumerated |  | `LDBt` lightDirBottom | `LDBL` lightDirBottomLeft, `LDBR` lightDirBottomRight, `LDBt` lightDirBottom, `LDLf` lightDirLeft, `LDRg` lightDirRight, `LDTL` lightDirTopLeft, `LDTR` lightDirTopRight, `LDTp` lightDirTop |  |
| `InvT` | invertTexture | boolean |  | false |  |  |

#### Smudge Stick

- Event: `SmdS` / `smudgeStick`
- PhotoCraft command: `filter.filterGallery effect "smudgeStick"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `StrL` | strokeLength | integer |  | 2 | 0 .. 10 (out-of-range values are clamped) | same |
| `HghA` | highlightArea | integer |  | 0 | 0 .. 20 (out-of-range values are clamped) | same |
| `Intn` | intensity | integer |  | 10 | 0 .. 10 (out-of-range values are clamped) | same |

#### Spatter

- Event: `Spt ` / `spatter`
- PhotoCraft command: `filter.filterGallery effect "spatter"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `SprR` | sprayRadius | integer |  | 10 | 0 .. 25 (out-of-range values are clamped) | same |
| `Smth` | smoothness | integer |  | 5 | 1 .. 15 (out-of-range values are clamped) | same |

#### Sponge

- Event: `Spng` / `sponge`
- PhotoCraft command: `filter.filterGallery effect "sponge"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `BrsS` | brushSize | integer |  | 2 | 0 .. 10 (out-of-range values are clamped) | same |
| `Dfnt` | definition | integer |  | 12 | 0 .. 25 (out-of-range values are clamped) | same |
| `Smth` | smoothness | integer |  | 5 | 1 .. 15 (out-of-range values are clamped) | same |

#### Sprayed Strokes

- Event: `SprS` / `sprayedStrokes`
- PhotoCraft command: `filter.filterGallery effect "sprayedStrokes"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `StrL` | strokeLength | integer |  | 12 | 0 .. 20 (out-of-range values are clamped) | same |
| `SprR` | sprayRadius | integer |  | 7 | 0 .. 25 (out-of-range values are clamped) | same |
| `SDir` | strokeDirection | enumerated |  | `SDRD` strokeDirRightDiag | `SDHz` strokeDirHorizontal, `SDLD` strokeDirLeftDiag, `SDRD` strokeDirRightDiag, `SDVt` strokeDirVertical |  |

#### Stained Glass

- Event: `StnG` / `stainedGlass`
- PhotoCraft command: `filter.filterGallery effect "stainedGlass"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `ClSz` | cellSize | integer |  | 10 | 2 .. 50 (out-of-range values are clamped) | same |
| `BrdT` | borderThickness | integer |  | 4 | 1 .. 20 (out-of-range values are clamped) | same |
| `LghI` | lightIntensity | integer |  | 3 | 0 .. 10 (out-of-range values are clamped) | same |

#### Stamp

- Event: `Stmp` / `stamp`
- PhotoCraft command: `filter.filterGallery effect "stamp"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `LgDr` | lightDark | integer |  | 25 | 0 .. 50 (out-of-range values are clamped) | maps to our `lightDarkBalance` (same range and default) |
| `Smth` | smoothness | integer |  | 5 | 1 .. 50 (out-of-range values are clamped) | same |

#### Sumie

- Event: `Smie` / `sumie`
- PhotoCraft command: `filter.filterGallery effect "sumiE"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `StrW` | strokeWidth | integer |  | 10 | 3 .. 15 (out-of-range values are clamped) | same |
| `StrP` | strokePressure | integer |  | 2 | 0 .. 15 (out-of-range values are clamped) | same |
| `Cntr` | contrast | integer |  | 16 | 0 .. 40 (out-of-range values are clamped) | maps to our `contrast` (same range and default) |

#### Texturizer

- Event: `Txtz` / `texturizer`
- PhotoCraft command: `filter.filterGallery effect "texturizer"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `TxtT` | textureType | enumerated |  | `TxCa` texTypeCanvas | `TxBr` texTypeBrick, `TxBu` texTypeBurlap, `TxCa` texTypeCanvas, `TxSt` texTypeSandstone |  |
| `Scln` | scaling | integer |  | 100 | 50 .. 200 (out-of-range values are clamped) | same |
| `Rlf ` | relief | integer |  | 4 | 0 .. 50 (out-of-range values are clamped) | same |
| `LghD` | lightDirection | enumerated |  | `LDTp` lightDirTop | `LDBL` lightDirBottomLeft, `LDBR` lightDirBottomRight, `LDBt` lightDirBottom, `LDLf` lightDirLeft, `LDRg` lightDirRight, `LDTL` lightDirTopLeft, `LDTR` lightDirTopRight, `LDTp` lightDirTop |  |
| `InvT` | invertTexture | boolean |  | false |  |  |

#### Torn Edges

- Event: `TrnE` / `tornEdges`
- PhotoCraft command: `filter.filterGallery effect "tornEdges"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `ImgB` | imageBalance | integer |  | 25 | 0 .. 50 (out-of-range values are clamped) | same |
| `Smth` | smoothness | integer |  | 11 | 1 .. 15 (out-of-range values are clamped) | same |
| `Cntr` | contrast | integer |  | 17 | 1 .. 25 (out-of-range values are clamped) | maps to our `contrast` (same range and default) |

#### Underpainting

- Event: `Undr` / `underpainting`
- PhotoCraft command: `filter.filterGallery effect "underpainting"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `BrsS` | brushSize | integer |  | 6 | 0 .. 40 (out-of-range values are clamped) | same |
| `TxtC` | textureCoverage | integer |  | 16 | 0 .. 40 (out-of-range values are clamped) | maps to our `textureCoverage` (same range and default) |
| `TxtT` | textureType | enumerated |  | `TxCa` texTypeCanvas | `TxBr` texTypeBrick, `TxBu` texTypeBurlap, `TxCa` texTypeCanvas, `TxSt` texTypeSandstone |  |
| `Scln` | scaling | integer |  | 100 | 50 .. 200 (out-of-range values are clamped) | same |
| `Rlf ` | relief | integer |  | 4 | 0 .. 50 (out-of-range values are clamped) | same |
| `LghD` | lightDirection | enumerated |  | `LDTp` lightDirTop | `LDBL` lightDirBottomLeft, `LDBR` lightDirBottomRight, `LDBt` lightDirBottom, `LDLf` lightDirLeft, `LDRg` lightDirRight, `LDTL` lightDirTopLeft, `LDTR` lightDirTopRight, `LDTp` lightDirTop |  |
| `InvT` | invertTexture | boolean |  | false |  |  |

#### Water Paper

- Event: `WtrP` / `waterPaper`
- PhotoCraft command: `filter.filterGallery effect "waterPaper"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `FbrL` | fiberLength | integer |  | 15 | 3 .. 50 (out-of-range values are clamped) | same |
| `Brgh` | brightness | integer |  | 60 | 0 .. 100 (out-of-range values are clamped) | same |
| `Cntr` | contrast | integer |  | 80 | 0 .. 100 (out-of-range values are clamped) | maps to our `contrast` (same range and default) |

#### Watercolor

- Event: `Wtrc` / `watercolor`
- PhotoCraft command: `filter.filterGallery effect "watercolor"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `BrsD` | brushDetail | integer |  | 9 | 1 .. 14 (out-of-range values are clamped) | same |
| `ShdI` | shadingIntensity | integer |  | 1 | 0 .. 10 (out-of-range values are clamped) | maps to our `shadowIntensity` (same range and default) |
| `Txtr` | texture | integer |  | 1 | 1 .. 3 (out-of-range values are clamped) | same |

#### Grain

- Event: `Grn ` / `grain`
- PhotoCraft command: `filter.filterGallery effect "grain"`

| Key | String ID | Type | Unit | Default | Allowed | PhotoCraft today |
|---|---|---|---|---|---|---|
| `Intn` | intensity | integer |  | 40 | 0 .. 100 (out-of-range values are clamped) | same |
| `Cntr` | contrast | integer |  | 50 | 0 .. 100 (out-of-range values are clamped) | maps to our `contrast` (same range and default) |
| `Grnt` | grainType | enumerated |  | `GrnR` grainRegular | `GrCn` grainContrasty, `GrSf` grainSoft, `GrSp` grainSpeckle, `GrSr` grainSprinkles, `GrSt` grainStippled, `GrnC` grainClumped, `GrnE` grainEnlarged, `GrnH` grainHorizontal, `GrnR` grainRegular, `GrnV` grainVertical |  |

### Group B: The Render filters Clouds, Difference Clouds, Fibers and Lens Flare

All four commands exist in PhotoCraft; only the `.atn` mapping is missing. Lighting Effects is covered with the events that need a recorded step (its lights are only recorded through the dialog).

#### Clouds

- Event: `Clds` / `clouds`
- PhotoCraft command: `filter.render.clouds`
- Uses the current foreground and background colours; the step itself carries no colours.

No parameters: the step carries an empty descriptor.

#### Difference Clouds

- Event: `DfrC` / `differenceClouds`
- PhotoCraft command: `filter.render.differenceClouds`
- Same as Clouds, blended with Difference.

No parameters: the step carries an empty descriptor.

#### Fibers

- Event: `Fbrs` (no string ID)
- PhotoCraft command: `filter.render.fibers`
- `randomSeed` makes playback reproduce the recorded result; keep it.

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `Vrnc` | (none) | integer |  | 16 | not clamped in the step (values are returned unchanged); limits pending, see "Events that need a step recorded through their dialog" |
| `Strg` | strengthPlugin | integer |  | 4 | not clamped in the step (values are returned unchanged); limits pending, see "Events that need a step recorded through their dialog" |
| `RndS` | randomSeed | integer |  | random | any 32-bit integer; a new random value per recording |

#### Lens Flare

- Event: `LnsF` / `lensFlare`
- PhotoCraft command: `filter.render.lensFlare`
- Lens types: `Zm  ` 50-300 mm Zoom, `Nkn ` 35 mm Prime, `Nkn1` 105 mm Prime, `PnVs` Movie Prime.

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `Brgh` | brightness | integer |  | 100 | 10 .. 300 (out-of-range values are clamped) |
| `FlrC` | flareCenter | object |  | obj 'Pnt ' point | `Hrzn` / `Vrtc` doubles, 0.4 / 0.4 by default; not clamped: (5, -5) is kept as given and plays |
| `Lns ` | lens | enumerated |  | `Zm  ` zoom | `Nkn ` nikon, `Nkn1` nikon105, `PnVs` panaVision, `Zm  ` zoom |

Nested values as recorded (defaults):
```
    'Hrzn' horizontal : DOUBLETYPE = 0.40000000596046
    'Vrtc' vertical : DOUBLETYPE = 0.40000000596046
```

### Group C: The Distort filters (Pinch, Polar Coordinates, Shear, Spherize, Twirl, Wave, ZigZag)

All commands exist in PhotoCraft (`filter.distort.*`); only the `.atn` mapping is missing. Displace needs a displacement map file and is listed separately at the end.

#### Pinch

- Event: `Pnch` / `pinch`
- PhotoCraft command: `filter.distort.pinch`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `Amnt` | amount | integer |  | 50 | -100 .. 100 (out-of-range values are clamped) |

#### Polar Coordinates

- Event: `Plr ` / `polar`
- PhotoCraft command: `filter.distort.polarCoordinates`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `Cnvr` | convert | enumerated |  | `RctP` rectToPolar | `PlrR` polarToRect, `RctP` rectToPolar |

#### Shear

- Event: `Shr ` / `shear`
- PhotoCraft command: `filter.distort.shear`
- `shearPoints` is a list of curve points; keep their order and count.

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `ShrP` | shearPoints | list |  | list[2] | list of `Pnt ` points (`Hrzn`, `Vrtc`) from top to bottom; default two points (0, 1) and (0, 128). The dialog writes whole numbers: `Hrzn` -64..63 (dragging past the grid edge clamps), `Vrtc` 1..128 with the first point at 1 and the last at 128; dragging a point out of the grid deletes it. A script run accepts any value without clamping (e.g. `Hrzn` ±10000, fractions) and crashed on a first point with `Vrtc` < 1: clamp to the dialog ranges on import |
| `UndA` | undefinedArea | enumerated |  | `WrpA` wrapAround | `RptE` repeatEdgePixels, `WrpA` wrapAround |
| `ShrS` | shearStart | integer |  | 0 | index of the first curve point; the dialog always writes 0 |
| `ShrE` | shearEnd | integer |  | 1 | index of the last curve point (point count - 1); the dialog writes it. Script runs with other values change the result, and far-off values (`ShrE` 100 or 1000, `ShrS` -1000) crashed the application: on import accept only `ShrS` 0 and `ShrE` = point count - 1, otherwise keep the step as a kept step |

Nested values as recorded (defaults):
```
    [0] OBJECTTYPE = obj 'Pnt ' point
        'Hrzn' horizontal : DOUBLETYPE = 0
        'Vrtc' vertical : DOUBLETYPE = 1
    [1] OBJECTTYPE = obj 'Pnt ' point
        'Hrzn' horizontal : DOUBLETYPE = 0
        'Vrtc' vertical : DOUBLETYPE = 128
```

#### Spherize

- Event: `Sphr` / `spherize`
- PhotoCraft command: `filter.distort.spherize`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `Amnt` | amount | integer |  | 100 | -100 .. 100 (out-of-range values are clamped) |
| `SphM` | spherizeMode | enumerated |  | `Nrml` normal | `HrzO` horizontalOnly, `Nrml` normal, `VrtO` verticalOnly |

#### Twirl

- Event: `Twrl` / `twirl`
- PhotoCraft command: `filter.distort.twirl`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `Angl` | angle | integer |  | 50 | -999 .. 999 (out-of-range values are clamped) |

#### Wave

- Event: `Wave` / `wave`
- PhotoCraft command: `filter.distort.wave`
- `randomSeed`: keep it so playback reproduces the recorded result.

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `Wvtp` | waveType | enumerated |  | `WvSn` waveSine | `WvSn` waveSine, `WvSq` waveSquare, `WvTr` waveTriangle |
| `NmbG` | numberOfGenerators | integer |  | 5 | 1 .. 999 (out-of-range values are clamped) |
| `WLMn` | wavelengthMin | integer |  | 10 | 1 .. 999 (out-of-range values are clamped) |
| `WLMx` | wavelengthMax | integer |  | 120 | 1 .. 999 (out-of-range values are clamped) |
| `AmMn` | amplitudeMin | integer |  | 5 | 1 .. 999 (out-of-range values are clamped) |
| `AmMx` | amplitudeMax | integer |  | 35 | 1 .. 999 (out-of-range values are clamped) |
| `SclH` | scaleHorizontal | integer |  | 100 | 1 .. 100 (out-of-range values are clamped) |
| `SclV` | scaleVertical | integer |  | 100 | 1 .. 100 (out-of-range values are clamped) |
| `UndA` | undefinedArea | enumerated |  | `RptE` repeatEdgePixels | `RptE` repeatEdgePixels, `WrpA` wrapAround |
| `RndS` | randomSeed | integer |  | random | any 32-bit integer; a new random value per recording |

#### ZigZag

- Event: `ZgZg` / `zigZag`
- PhotoCraft command: `filter.distort.zigZag`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `Amnt` | amount | integer |  | 10 | -100 .. 100 (out-of-range values are clamped) |
| `NmbR` | numberOfRipples | integer |  | 5 | 0 .. 20 (out-of-range values are clamped) |
| `ZZTy` | zigZagType | enumerated |  | `PndR` pondRipples | `ArnC` aroundCenter, `OtFr` outFromCenter, `PndR` pondRipples |

#### Displace

Displace reads a displacement map from a file chosen in a dialog; record one step and add its keys (file path form) before implementing.

### Group D: The Stylize and Pixelate filters

All commands exist in PhotoCraft (`filter.stylize.*`, `filter.pixelate.*`); only the `.atn` mapping is missing.

#### Extrude

- Event: `Extr` / `extrude`
- PhotoCraft command: `filter.stylize.extrude`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `ExtS` | extrudeSize | integer |  | 30 | 2 .. 255 (out-of-range values are clamped) |
| `ExtD` | extrudeDepth | integer |  | 30 | 1 .. 255 (out-of-range values are clamped) |
| `ExtF` | extrudeSolidFace | boolean |  | false |  |
| `ExtM` | extrudeMaskIncomplete | boolean |  | false |  |
| `ExtT` | extrudeType | enumerated |  | `Blks` blacks | `Blks` blacks, `Pyrm` pyramids |
| `ExtR` | extrudeRandom | enumerated |  | `Rndm` random | `LvlB` levelBased, `Rndm` random |

#### Find Edges

- Event: `FndE` / `findEdges`
- PhotoCraft command: `filter.stylize.findEdges`

No parameters: the step carries an empty descriptor.

#### Solarize

- Event: `Slrz` / `solarize`
- PhotoCraft command: `filter.stylize.solarize`

No parameters: the step carries an empty descriptor.

#### Trace Contour

- Event: `TrcC` / `traceContour`
- PhotoCraft command: `filter.stylize.traceContour`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `Lvl ` | level | integer |  | 128 | whole number 0..255 (the dialog clamps to the nearest value). A recorded step carries the real level (e.g. 77); only a script run echoes 128 back. Levels <= 0 and >= 255 give the same image. |
| `Edg ` | edge | enumerated |  | `Upr ` upper | `CntE` enum: `Lwr ` lower, `Upr ` upper; recorded as set in the dialog |

#### Wind

- Event: `Wnd ` / `wind`
- PhotoCraft command: `filter.stylize.wind`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `WndM` | windMethod | enumerated |  | `Wnd ` wind | `Blst` blast, `Stgr` stagger, `Wnd ` wind |
| `Drct` | direction | enumerated |  | `Left` left | `Left` left, `Rght` right |

#### Tiles

- Event: `Tls ` / `tiles`
- PhotoCraft command: `filter.stylize.tiles`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `TlNm` | tileNumber | integer |  | 10 | 1 .. 99 (out-of-range values are clamped) |
| `TlOf` | tileOffset | integer |  | 10 | 1 .. 99 (out-of-range values are clamped) |
| `FlCl` | fillColor | enumerated |  | `FlBc` fillBack | `FlBc` fillBack, `FlFr` fillFore, `FlIn` fillInverse, `FlSm` fillSame |

#### Color Halftone

- Event: `ClrH` / `colorHalftone`
- PhotoCraft command: `filter.pixelate.colorHalftone`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `Rds ` | radius | integer |  | 8 | 4 .. 127 (out-of-range values are clamped) |
| `Ang1` | angle1 | integer |  | 108 | -10000 .. 10000 (out-of-range values are clamped) |
| `Ang2` | angle2 | integer |  | 162 | -10000 .. 10000 (out-of-range values are clamped) |
| `Ang3` | angle3 | integer |  | 90 | -10000 .. 10000 (out-of-range values are clamped) |
| `Ang4` | angle4 | integer |  | 45 | -10000 .. 10000 (out-of-range values are clamped) |

#### Facet

- Event: `Fct ` / `facet`
- PhotoCraft command: `filter.pixelate.facet`

No parameters: the step carries an empty descriptor.

#### Fragment

- Event: `Frgm` / `fragment`
- PhotoCraft command: `filter.pixelate.fragment`

No parameters: the step carries an empty descriptor.

#### Mezzotint

- Event: `Mztn` / `mezzotint`
- PhotoCraft command: `filter.pixelate.mezzotint`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `MztT` | mezzotintType | enumerated |  | `FnDt` fineDots | `CrsD` coarseDots, `FnDt` fineDots, `GrnD` grainyDots, `LngL` longLines, `LngS` longStrokes, `MdmD` mediumDots, `MdmL` mediumLines, `MdmS` mediumStrokes, `ShSt` shortStrokes, `ShrL` shortLines |

#### Mosaic

- Event: `Msc ` / `mosaic`
- PhotoCraft command: `filter.pixelate.mosaic`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `ClSz` | cellSize | unitdouble |  | 2 | 2 .. 200 pixels (out-of-range values are clamped). Write it as a unit double in `#Pxl`: the application accepts that and returns it unchanged. Read a value without a unit as pixels (the application returns its own default that way). |

#### Pointillize

- Event: `Pntl` / `pointillize`
- PhotoCraft command: `filter.pixelate.pointillize`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `ClSz` | cellSize | integer |  | 5 | 3 .. 300 (out-of-range values are clamped) |

### Group E: Video, Other and matting filters and the direct Gradient Map / Replace Color adjustments

All commands exist in PhotoCraft; only the `.atn` mapping is missing. Gradient Map and Replace Color here are the direct adjustments (Image > Adjustments), not adjustment layers (those are already mapped).

#### De-Interlace

- Event: `Dntr` / `deInterlace`
- PhotoCraft command: `filter.video.deInterlace`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `IntE` | interlaceEliminateType | enumerated |  | `ElmO` eliminateOddFields | `ElmE` eliminateEvenFields, `ElmO` eliminateOddFields |
| `IntC` | interlaceCreateType | enumerated |  | `CrtI` createInterpolation | `CrtD` createDroplet, `CrtI` createInterpolation |

#### NTSC Colors

- Event: `NTSC` (no string ID)
- PhotoCraft command: `filter.video.ntscColors`

No parameters: the step carries an empty descriptor.

#### HSB/HSL

- Event: `HsbP` (no string ID)
- PhotoCraft command: `filter.other.hsbHsl`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `Inpt` | input | enumerated |  | `RGBC` RGBColor | `HSBl` HSBColorEnum, `HSLC` HSLColor, `RGBC` RGBColor |
| `Otpt` | output | enumerated |  | `HSBl` HSBColorEnum | `HSBl` HSBColorEnum, `HSLC` HSLColor, `RGBC` RGBColor |

#### Remove Black Matte

- Event: `RmvB` / `removeBlackMatte`
- PhotoCraft command: `layer.matting.removeBlackMatte`

No parameters: the step carries an empty descriptor.

#### Remove White Matte

- Event: `RmvW` / `removeWhiteMatte`
- PhotoCraft command: `layer.matting.removeWhiteMatte`

No parameters: the step carries an empty descriptor.

#### Gradient Map (direct)

- Event: `GrMp` (no string ID)
- PhotoCraft command: `image.adjustments.gradientMap`
- The `gradient` object is the same gradient form the adjustment layer already maps; reuse that code.

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `` | gradientsInterpolationMethod | enumerated |  |  gradientInterpolationMethodType.'Gcls' classic |  |
| `Grad` | gradient | object |  | obj 'Grdn' gradientClassEvent |  |

Nested values as recorded (defaults):
```
    'Nm  ' name : STRINGTYPE = "Vorder- zu Hintergrundfarbe"
    'GrdF' gradientForm : ENUMERATEDTYPE = 'GrdF' gradientForm.'CstS' customStops
    'Intr' interfaceIconFrameDimmed : DOUBLETYPE = 4096
    'Clrs' colors : LISTTYPE = list[2]
        [0] OBJECTTYPE = obj 'Clrt' colorStop
            'Clr ' color : OBJECTTYPE = obj 'RGBC' RGBColor
                'Rd  ' red : DOUBLETYPE = 0
                'Grn ' green : DOUBLETYPE = 0
                'Bl  ' blue : DOUBLETYPE = 0
            'Type' type : ENUMERATEDTYPE = 'Clry' colorStopType.'UsrS' userStop
            'Lctn' location : INTEGERTYPE = 0
            'Mdpn' midpoint : INTEGERTYPE = 50
        [1] OBJECTTYPE = obj 'Clrt' colorStop
            'Clr ' color : OBJECTTYPE = obj 'RGBC' RGBColor
                'Rd  ' red : DOUBLETYPE = 255
                'Grn ' green : DOUBLETYPE = 255
                'Bl  ' blue : DOUBLETYPE = 255
            'Type' type : ENUMERATEDTYPE = 'Clry' colorStopType.'UsrS' userStop
            'Lctn' location : INTEGERTYPE = 4096
            'Mdpn' midpoint : INTEGERTYPE = 50
    'Trns' transparency : LISTTYPE = list[2]
        [0] OBJECTTYPE = obj 'TrnS' transferSpec
            'Opct' opacity : UNITDOUBLE = 100 '#Prc' percentUnit
            'Lctn' location : INTEGERTYPE = 0
            'Mdpn' midpoint : INTEGERTYPE = 50
        [1] OBJECTTYPE = obj 'TrnS' transferSpec
            'Opct' opacity : UNITDOUBLE = 100 '#Prc' percentUnit
            'Lctn' location : INTEGERTYPE = 4096
            'Mdpn' midpoint : INTEGERTYPE = 50
```

#### Average

- Event: `Avrg` (no string ID)
- PhotoCraft command: `filter.blur.average`
- Measured with example values in a prepared document: the Value column shows what was sent and recorded, not a factory default (a step always carries the values the user set).

No parameters: the step carries an empty descriptor.

#### Custom

- Event: `Cstm` / `custom`
- PhotoCraft command: `filter.other.custom`
- Measured with example values in a prepared document: the Value column shows what was sent and recorded, not a factory default (a step always carries the values the user set).

| Key | String ID | Type | Unit | Example value | Allowed |
|---|---|---|---|---|---|
| `Scl ` | scale | integer |  | 1 | 1 .. 9999 (measured in the dialog); applied also when played without the dialog (scale 2 halves the result) |
| `Ofst` | offset | integer |  | 0 | -9999 .. 9999 (measured in the dialog); applied also when played without the dialog (offset 50 adds 50) |
| `Mtrx` | matrix | list |  | none: a step always carries all 25 cells | exactly 25 integers (5 x 5, row by row), each -999 .. 999; a 3 x 3 list makes the application fail |

#### Replace Color

- Event: `RplC` / `replaceColor`
- PhotoCraft command: `image.adjustments.replaceColor`
- Measured with example values in a prepared document: the Value column shows what was sent and recorded, not a factory default (a step always carries the values the user set).

| Key | String ID | Type | Unit | Example value | Allowed |
|---|---|---|---|---|---|
| `Fzns` | fuzziness | integer |  | 40 | 0 .. 200 (out-of-range values are clamped) |
| `Mnm ` | minimum | object |  | obj 'LbCl' labColor |  |
| `Mxm ` | maximum | object |  | obj 'LbCl' labColor |  |
| `H   ` | hue | integer |  | 30 | -180 .. 180 (out-of-range values are clamped) |
| `Strt` | saturation | integer |  | 0 | -100 .. 100 (out-of-range values are clamped) |
| `Lght` | lightness | integer |  | 0 | -100 .. 100 (out-of-range values are clamped) |
| `` | colorModel | integer |  | 0 |  |

Nested values as recorded (example values):
```
    'Lmnc' luminance : DOUBLETYPE = 40
    'A   ' a : DOUBLETYPE = 30
    'B   ' b : DOUBLETYPE = 40
    'Lmnc' luminance : DOUBLETYPE = 40
    'A   ' a : DOUBLETYPE = 30
    'B   ' b : DOUBLETYPE = 40
```

### Group F: Selection combinations, Paste Into/Outside, Fade, Link, Distribute, Define Pattern and older merge/mask events

Steps recorded in an ordinary editing session. The values below were measured in a document set up for each step (a selection, the clipboard, linked or several selected layers). Align, Copy/Paste Layer Style and Rename are already mapped under their current events and are not repeated here.

#### Add to Selection (rectangle)

- Event: `AddT` / `addTo`
- PhotoCraft command: `select.rect {"mode":"add"}`
- Shift-drag with the Rectangular Marquee.
- Measured with example values in a prepared document: the Value column shows what was sent and recorded, not a factory default (a step always carries the values the user set).

| Key | String ID | Type | Unit | Example value | Allowed |
|---|---|---|---|---|---|
| `null` | null | reference |  | ref 'Chnl' channel prop 'fsel' selection |  |
| `T   ` | to | object |  | obj 'Rctn' rectangle |  |

Nested values as recorded (example values):
```
    'Top ' top : UNITDOUBLE = 30 '#Pxl' pixelsUnit
    'Left' left : UNITDOUBLE = 30 '#Pxl' pixelsUnit
    'Btom' bottom : UNITDOUBLE = 90 '#Pxl' pixelsUnit
    'Rght' right : UNITDOUBLE = 90 '#Pxl' pixelsUnit
```

#### Add to Selection (ellipse)

- Event: `AddT` / `addTo`
- PhotoCraft command: `select.rect {"mode":"add","ellipse":true}`
- Same event with an `Elps` target and anti-aliasing.
- Measured with example values in a prepared document: the Value column shows what was sent and recorded, not a factory default (a step always carries the values the user set).

| Key | String ID | Type | Unit | Example value | Allowed |
|---|---|---|---|---|---|
| `null` | null | reference |  | ref 'Chnl' channel prop 'fsel' selection |  |
| `T   ` | to | object |  | obj 'Elps' ellipse |  |
| `AntA` | antiAlias | boolean |  | true |  |

Nested values as recorded (example values):
```
    'Top ' top : UNITDOUBLE = 30 '#Pxl' pixelsUnit
    'Left' left : UNITDOUBLE = 30 '#Pxl' pixelsUnit
    'Btom' bottom : UNITDOUBLE = 90 '#Pxl' pixelsUnit
    'Rght' right : UNITDOUBLE = 90 '#Pxl' pixelsUnit
```

#### Subtract from Selection

- Event: `SbtF` / `subtractFrom`
- PhotoCraft command: `select.rect {"mode":"subtract"}`
- Measured with example values in a prepared document: the Value column shows what was sent and recorded, not a factory default (a step always carries the values the user set).

| Key | String ID | Type | Unit | Example value | Allowed |
|---|---|---|---|---|---|
| `null` | null | reference |  | ref 'Chnl' channel prop 'fsel' selection |  |
| `T   ` | to | object |  | obj 'Rctn' rectangle |  |

Nested values as recorded (example values):
```
    'Top ' top : UNITDOUBLE = 30 '#Pxl' pixelsUnit
    'Left' left : UNITDOUBLE = 30 '#Pxl' pixelsUnit
    'Btom' bottom : UNITDOUBLE = 60 '#Pxl' pixelsUnit
    'Rght' right : UNITDOUBLE = 60 '#Pxl' pixelsUnit
```

#### Intersect with Selection

- Event: `IntW` / `interfaceWhite`
- PhotoCraft command: `select.rect {"mode":"intersect"}`
- Measured with example values in a prepared document: the Value column shows what was sent and recorded, not a factory default (a step always carries the values the user set).

| Key | String ID | Type | Unit | Example value | Allowed |
|---|---|---|---|---|---|
| `null` | null | reference |  | ref 'Chnl' channel prop 'fsel' selection |  |
| `T   ` | to | object |  | obj 'Rctn' rectangle |  |

Nested values as recorded (example values):
```
    'Top ' top : UNITDOUBLE = 30 '#Pxl' pixelsUnit
    'Left' left : UNITDOUBLE = 30 '#Pxl' pixelsUnit
    'Btom' bottom : UNITDOUBLE = 120 '#Pxl' pixelsUnit
    'Rght' right : UNITDOUBLE = 120 '#Pxl' pixelsUnit
```

#### Paste Into

- Event: `PstI` / `pasteInto`
- PhotoCraft command: `edit.pasteSpecial.pasteInto`
- Measured with example values in a prepared document: the Value column shows what was sent and recorded, not a factory default (a step always carries the values the user set).

| Key | String ID | Type | Unit | Example value | Allowed |
|---|---|---|---|---|---|
| `AntA` | antiAlias | enumerated |  | `Anno` antiAliasNone | not measured yet |
| `As  ` | as | class |  | class 'Pxel' pixel |  |

#### Paste Outside

- Event: `PstO` / `pasteOutside`
- PhotoCraft command: `edit.pasteSpecial.pasteOutside`
- Measured with example values in a prepared document: the Value column shows what was sent and recorded, not a factory default (a step always carries the values the user set).

| Key | String ID | Type | Unit | Example value | Allowed |
|---|---|---|---|---|---|
| `AntA` | antiAlias | enumerated |  | `Anno` antiAliasNone | not measured yet |
| `As  ` | as | class |  | class 'Pxel' pixel |  |

#### Fade

- Event: `Fade` / `fade`
- PhotoCraft command: `edit.fade`
- Recorded right after the step it fades.
- Measured with example values in a prepared document: the Value column shows what was sent and recorded, not a factory default (a step always carries the values the user set).

| Key | String ID | Type | Unit | Example value | Allowed |
|---|---|---|---|---|---|
| `Opct` | opacity | unitdouble | `#Prc` | 50 | 0 .. 100 (out-of-range values are clamped) |
| `Md  ` | mode | enumerated |  | `Mltp` multiply | not measured yet |

#### Link Layers

- Event: `` / `linkSelectedLayers`
- PhotoCraft command: `layer.linkLayers`
- Measured with example values in a prepared document: the Value column shows what was sent and recorded, not a factory default (a step always carries the values the user set).

| Key | String ID | Type | Unit | Example value | Allowed |
|---|---|---|---|---|---|
| `null` | null | reference |  | ref 'Lyr ' layer enum 'Ordn' ordinal.'Trgt' targetEnum |  |

#### Distribute

- Event: `Dstr` / `distort`
- PhotoCraft command: `layer.distribute.leftEdges (one command per edge)`
- `Usng` selects the edge or centre; one enum value per Distribute menu item.
- Measured with example values in a prepared document: the Value column shows what was sent and recorded, not a factory default (a step always carries the values the user set).

| Key | String ID | Type | Unit | Example value | Allowed |
|---|---|---|---|---|---|
| `null` | null | reference |  | ref 'Lyr ' layer enum 'Ordn' ordinal.'Trgt' targetEnum |  |
| `Usng` | using | enumerated |  | `AdLf` ADSLefts | not measured yet |

#### Remove Layer Mask (older files)

- Event: `RmvL` / `removeLayerMask`
- PhotoCraft command: `layer.layerMask.delete`
- The reference application asks "Apply mask before deleting?" when this step plays without the apply choice; see the table for the key it records.
- Measured with example values in a prepared document: the Value column shows what was sent and recorded, not a factory default (a step always carries the values the user set).

No parameters: the step carries an empty descriptor.

#### Define Pattern

- Event: `DfnP` / `definePattern`
- PhotoCraft command: `edit.definePattern`

No parameters: the step carries an empty descriptor.

#### Merge Layers (older files)

- Event: `MrgL` (no string ID)
- PhotoCraft command: `layer.mergeLayers`

No parameters: the step carries an empty descriptor.

### Group G: Split Channels, Merge Spot Channel, Trap and Match Color

Channel and colour steps. Trap was measured in a CMYK document (it only exists there).

#### Split Channels

- Event: `SplC` / `splitChannels`
- PhotoCraft command: `channel.split`
- Measured with example values in a prepared document: the Value column shows what was sent and recorded, not a factory default (a step always carries the values the user set).

| Key | String ID | Type | Unit | Example value | Allowed |
|---|---|---|---|---|---|
| `` | documentIDs | list |  | list[3] |  |

Nested values as recorded (example values):
```
    [0] 182
    [1] 185
    [2] 188
```

#### Merge Spot Channel

- Event: `MSpt` / `mergeSpotChannel`
- PhotoCraft command: `channel.mergeSpot`
- Measured with example values in a prepared document: the Value column shows what was sent and recorded, not a factory default (a step always carries the values the user set).

No parameters: the step carries an empty descriptor.

#### Trap

- Event: `Trap` / `trap`
- PhotoCraft command: `image.trap`
- Measured with example values in a prepared document: the Value column shows what was sent and recorded, not a factory default (a step always carries the values the user set).

| Key | String ID | Type | Unit | Example value | Allowed |
|---|---|---|---|---|---|
| `Wdth` | width | unitdouble | `#Pxl` | 2 | up to 32767 (clamped); the minimum was not measured (a huge negative value ran out of memory) |

#### Match Color

- Event: `` / `matchColor`
- PhotoCraft command: `image.adjustments.matchColor`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `Lght` | lightness | integer |  | 100 |  |
| `ClrR` | colorRange | integer |  | 100 |  |
| `Fade` | fade | integer |  | 0 |  |
| `` | noReference | boolean |  | true |  |

### Group I: Newer features (Focus Area, Remove Background, Select Sky, Oil Paint, Smart Sharpen)

These events only have a string ID (no 4-character code). Steps recorded in newer versions use them.

#### Select > Focus Area

- Event: `` / `focusMask`
- PhotoCraft command: `select.focusArea`

No parameters: the step carries an empty descriptor.

#### Remove Background (quick action)

- Event: `` / `removeBackground`
- PhotoCraft command: `layer.removeBackground`

No parameters: the step carries an empty descriptor.

#### Select > Sky

- Event: `` / `selectSky`
- PhotoCraft command: `select.sky`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `` | sampleAllLayers | boolean |  | false |  |

#### Filter > Stylize > Oil Paint

- Event: `` / `oilPaint`
- PhotoCraft command: `filter.stylize.oilPaint`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `` | lightingOn | boolean |  | true |  |
| `` | stylization | double |  | 4 |  |
| `` | cleanliness | double |  | 2.29999995231628 |  |
| `` | brushScale | double |  | 0.80000001192093 |  |
| `` | microBrush | double |  | 10 |  |
| `LghD` | lightDirection | integer |  | -60 |  |
| `` | specularity | double |  | 1.29999995231628 |  |

#### Filter > Sharpen > Smart Sharpen

- Event: `` / `smartSharpen`
- PhotoCraft command: `filter.sharpen.smartSharpen`

| Key | String ID | Type | Unit | Default | Allowed |
|---|---|---|---|---|---|
| `` | presetKind | enumerated |  |  presetKindType. presetKindCustom |  |
| `` | useLegacy | boolean |  | true |  |
| `Amnt` | amount | unitdouble | `#Prc` | 200 |  |
| `Rds ` | radius | unitdouble | `#Pxl` | 1 |  |
| `` | moreAccurate | boolean |  | false |  |
| `blur` | blur | enumerated |  |  blurType. lensBlur |  |

### Events that need a step recorded through their dialog

These carry settings that only exist once their dialog was used, so a dialog-less run returns no
values or ignores the ones it was given. They are listed so nobody measures them again from scratch;
their tables will be added once a recorded step was read.

| Event | Why |
|---|---|
| Generative Fill (`syntheticFill`) | AI feature: in PhotoCraft this goes through the shared AI layer; until then such steps stay kept steps. |

### Recorded under another event

Some older events are no longer what the application records; PhotoCraft already maps the current one:
Clear (recorded as Delete), Rasterize Type (`rasterizeLayer`), Convert to Profile (`convertToProfile`),
Copy and Paste Layer Style (`copyEffects`, `pasteEffects`), Align (`align`), Rename Layer (Set of the
layer's name), Deselect (Set of the selection to None). Steps recorded with Backlight, Fill Flash, Color
Cast, Variations, Texture Fill and the old Snapshot events come only from very old versions and stay kept
steps.