# 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 (121) | 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` | | (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` | | `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` | | (string ID only) | collapseAllGroupsEvent | Collapse All Groups | `layer.setExpanded` | | `ClrB` | colorBalance | Color Balance | `image.adjustments.colorBalance` | | `ClrR` | colorRange | Color Range | `select.colorRange` | | (string ID only) | colorLookup | Color Lookup (embedded 3D LUT forms) | `image.adjustments.colorLookup` | | `Cstm` | custom | Custom | `filter.other.custom` | | `Fbrs` | (code only) | Fibers | `filter.render.fibers` | | (string ID only) | shapeBlur | Shape Blur (custom shape by installed ID) | `filter.blur.shapeBlur` | | `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` | | `cut ` | cut | Cut | `edit.cut` | | `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` | | `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` | | `Fl ` | fill | Fill | `edit.fill`, `paint.bucket` | | `GEfc` | filterGallery | Filter Gallery | `filter.gallery.spatter` | | `FltI` | flattenImage | Flatten Image | `layer.flattenImage` | | `Flip` | flip | Flip | `image.imageRotation.flipCanvasHorizontal`, `image.imageRotation.flipCanvasVertical`, `edit.transform.flipHorizontal`, `edit.transform.flipVertical` | | `GsnB` | gaussianBlur | Gaussian Blur | `filter.blur.gaussianBlur` | | `GdMp` | gradientMapEvent | Gradient Map | `image.adjustments.gradientMap` | | `Grow` | grow | Grow | `select.grow` | | `Hd ` | hide | Hide | `layer.hideLayers` | | `HghP` | highPass | High Pass | `filter.other.highPass` | | `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` | | `Lvls` | levels | Levels | `image.adjustments.levels`, `image.autoTone`, `image.autoContrast` | | `Mk ` | make | Make | `image.calculations`, `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 | | | `Mxm ` | maximum | Maximum | `filter.other.maximum` | | `Mdn ` | median | Median | `filter.noise.median` | | `Mrg2` | mergeLayersNew | Merge Layers | `layer.mergeLayers` | | `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.arrange.bringToFront`, `layer.arrange.sendToBack`, `layer.arrange.bringForward`, `layer.arrange.sendBackward` | | `Ofst` | offset | Offset | `filter.other.offset` | | `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` | | `Plc ` | placeEvent | Place | `file.placeEmbedded`, `file.placeLinked` | | `Ply ` | play | Play | `actions.play` | | `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` | | `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` | | `Smlr` | similar | Similar | `select.similar` | | `SmrB` | smartBlur | Smart Blur | `filter.blur.smartBlur` | | `Smth` | smoothness | Smooth | `select.modify.smooth` | | `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` | | (string ID only) | trim | Trim | `image.trim` | | (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` | | `Vbrn` | vibrance | Vibrance | `image.adjustments.vibrance` | ### Calculations through Make Channel The recorded `Nw ` class `Chnl` with an `Usng` object of class `Clcl` maps to `image.calculations`, creating a new alpha channel in one undoable edit. The supported object writes `T `, explicit `Clcl` (`Clcn`), optional `Scl ` (double 1..2), optional `Ofst` (integer -255..255), then `Src2` in recorded order. Colour-channel enumerations, literal alpha-channel names, single targeted colour or alpha channels, explicit merged transparency, and optional merged or named layers retain their identities. An omitted layer uses the native source document's existing merged-image semantics. The nested types are corroborated by firsthand ScriptListener output for [Add with target and Green](https://community.adobe.com/questions-712/combining-channels-1103103). The later [transparency recording](https://community.adobe.com/questions-712/generating-an-alpha-channel-for-document-1102257) corroborates the Make/Clcl structure but omits the blend key. Omitted blends, other transparency and mask sources, other-document references, unknown settings and unrepresented reference forms remain whole preserved steps. Composite, multiple colour and mask targets fail before mutation when a supported step requests the current channel. These limits remain open under #10705; fresh Photoshop pixel parity has not been measured. ### Custom and Fibers dialog filters Custom uses the mapping from [#10631 by @hectorviov](https://github.com/storytold/photocraft/pull/10631), revision `4ed3f5b5911e2dc50655fc68cd44da68dab7c219`. It retains the 25 integer kernel cells, scale 1..9999 and offset -9999..9999. Fibers uses the corresponding part of [#10620](https://github.com/storytold/photocraft/pull/10620), revision `33ee38b43165610b295e91f8b99841c591cf97b8`, with the now-measured variance and strength limits 1..64. Its seed retains all 32 bits. Both native commands already support these ranges. Unrepresented types, settings, omitted fields or values that would clamp stay complete preserved steps; export refuses native settings that the recorded form cannot retain. ### Color Lookup with an embedded LUT Recorded `colorLookup` steps with a `3DLUT` lookup type, a declared CUBE/3DL/LOOK format, embedded file bytes, a file name and an explicit dither flag map to `image.adjustments.colorLookup`. The existing LUT parsers read the original bytes, including UTF-16 LOOK files. The recorded path is metadata; playback uses the embedded file and does not read that path. The native command also accepts `dataEncoding:"base64"` and `lutFormat:"cube|3dl|look"` for embedded files whose names do not identify their format. Existing text input remains supported. Save retains the original key order, types, names and file bytes. The recorded metadata template excludes the file data, so the action does not store a second copy of a large LUT. Unrepresented native option changes refuse export. Abstract and device-link profiles, nonempty ICC processing data, unknown formats and unknown settings remain complete preserved steps; these parts of #10705 remain unfinished. The native command continues to refuse non-default input domains. Nonlinear 3DL input shapers use Hector Villarreal's existing #9170 implementation for #8982. Shapers the parser cannot retain stay complete preserved steps. PSD-specific LUT Data Order and Table Order handling is separately tracked by #9126 and #9218. ### Shape Blur with a recorded custom shape The measured `shapeBlur` form contains a pixel radius, a `customShape` object with `Nm ` and `Idnt` text, and optionally the recorded `keyOriginType` value 9. The nested object class is corroborated by [ag-psd's public descriptor definitions](https://github.com/Agamnentzar/ag-psd/blob/master/src/descriptor.ts). The ID selects the installed shape even after a rename. If that asset is absent, playback fails without applying a blur; it never substitutes a shape with the same name. CSH libraries use the backend of [@jonathanwxh-cell's #5493](https://github.com/storytold/photocraft/pull/5493), ported from revision `43920ab7804cd386b91b319b33a2a8d0832d4d91` with its bounded reader and import tests. Imported IDs retain their exact text. Empty IDs become anonymous presets usable by name; repeated IDs resolve only when all matching presets have identical geometry. Conflicting geometry fails ID lookup. The native command rasterizes the selected vector shape as a normalized coverage kernel, retaining its aspect ratio and orientation. This follows the [documented use of custom shape presets as blur kernels](https://helpx.adobe.com/ee/photoshop/using/filter-effects-reference.html). It also accepts `shapeName` or portable `shapePath` geometry. Smart Filters keep the vector geometry so native saves can render without the preset library. The built-in shape choices keep their existing kernel path. Fresh Photoshop pixel parity has not been measured. Unknown fields, other origin values and unrepresented descriptor forms remain whole preserved steps. Export refuses native-only geometry and target changes that the recorded form cannot carry. Radius-only recordings still require the separate existing event integration; they are not claimed by this custom-shape converter. ## 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; each line says what is lost and the fix. ### Import or export loses a setting (fix in `atn_cmds` only) | Event | What is lost | Fix | |---|---|---| | Transform (`Trnf`) | The reference point `FTcs` (`QCSt`: `Qcsa` centre, `Qcs0`..`Qcs8` corners and edges) is ignored on load, and save always writes `Qcsa`. A 50 % scale about the top-left corner of a 100 px square at 60,60 ends at 60,60..110,110 in the reference application, at 85,85..135,135 when played about the centre. | Read `FTcs` into the commands' `reference`; write it back. Pure offsets are unaffected. | | Show (`Shw `) with `TglO` true | Alt-click on the eye ("show only this layer", a toggle: a second step restores the others) loads as a plain Show. | `TglO` true maps to `layer.showOnly`, and back. | | Make `layerSection` (Group from Layers) | Newer recordings store the group name as a top-level `Nm ` (no `Usng`); only `Usng.Nm ` is read, so the group gets the default name. | Read the top-level `Nm ` too. | | Make `Lyr ` (New Layer) | `Usng.Grup` true (Use Previous Layer to Create Clipping Mask) is dropped. | Map to `clipToPrevious`; export it (today such a step is refused). | | Make `AdjL` (adjustment layer) | `Usng.Clr ` (the colour label) is dropped. | Map the label; export it. | | Make `contentLayer` with `Shp ` (Rectangle tool shape layer, with `strokeStyle`) | Loads as a solid colour fill layer covering the canvas: the shape and its stroke settings are lost. | Map to the shape command, or keep the step as a kept step until it is mapped. | | Make with `Nw ` + `Usng ArSl.Slct` (Layer via Copy / Cut with layer options) | Only the name is kept; `Md ` (blend mode), `Opct` and `Clr ` are dropped. | Carry them into the `layer.setProps` step that follows. | | Set of the selection to `Chnl.Trsp` of a named layer (Cmd-click on another layer's thumbnail) | The layer in the reference is dropped, so the current layer's transparency is loaded. | Keep the layer in `select.loadSelection`; export it. | | Background layer by property (`Lyr .Bckg`) | Becomes the layer name "Background" on load and is saved as a name reference. A localised reference application has no layer of that name ("Hintergrund" in German), and the step fails there. | Keep the property form: load as the Background layer, save as `Lyr .Bckg`. | | Close (`Cls `) without `Svng` | Without `Svng` the reference application asks whether to save (without a dialog it refuses to close a changed document). Save writes `Svng N` (do not save), so playback there silently discards changes. 244 corpus steps. | Write no `Svng` for a Close that asks. | | Photo Filter (`photoFilter`) with a `LbCl` colour | The reference application's default filter colour is Lab (`Lmnc`, `A `, `B `); only RGB, HSB and gray colours are read, so a recorded Photo Filter usually stays a kept step. | Convert Lab colours (through `photocraft-cms`) on load. | | Vibrance (direct) | Saved as event `Vbrn`, which the reference application does not know: the step fails there ("command not available"). | Save as `vibrance`. | | Gradient Map (direct) | Saved as event `GdMp`, which is the Gradient Map *class*, not an event: the step fails there. | Save as `gradientMapEvent`. | | Stroke, Location Outside | Written as `StrL.OtsF`; the application's value is `Otsd` and it rejects `OtsF` ("parameters not valid"). A recorded `Otsd` does not load. | Use `Otsd` both ways. | | Set layer blend mode Pass Through (groups) | Written as `BlnM.PsTh`; the application rejects it. Its value is `passThrough`. | Save `passThrough`. | | Canvas Size, extension colour Foreground / Other | Written as `canvasExtensionColorType` `Frgd` / `Othr`; the application does not know them and opens the Canvas Size dialog instead. Its values are `FrgC` and `Clr `. | Use `FrgC` and `Clr ` both ways. | | Convert to Profile, intent Absolute Colorimetric | Written as `Inte.AbsC`; the application reads it as Relative Colorimetric (it echoes `Clrm`). Its value is `AClr`; a recorded `AClr` does not load. | Use `AClr` both ways. | | Convert Mode (`CnvM`) | Saved with `T ` as an enum (`ClrS.Grys`); the application records and needs a class (`T ` type `Grys`): with the enum every mode change fails there ("program error"). A recording on a layered document also carries `Fltt` and `Rstr` (false), which avoid the flatten question on playback. | Save `T ` as a class; read and write `Fltt`/`Rstr`. | | Make adjustment layer with `Usng.Opct` | The layer's opacity (e.g. 70 % in the bundled Gradient Map action) is dropped. | Map to the new layer's opacity. | | Canvas Size in percent | A recorded size in `#Prc` (the bundled Frame Channel action records 200 %) stays a kept step. | Scale the current size by the percentage. | | Image Size in cm or inches | Recorded in `#Rlt` (points) with `scaleStyles`; stays a kept step. | Convert with the document's resolution at playback. | | Select a document by offset (`Dcmn` `rele`) | The reference application wraps around at the ends of the opening order (from the second of three documents, -2 is the third, +2 the first); `document.activate` refuses an offset past the ends (#7103), so the step fails in PhotoCraft. See Reference forms. | Wrap like the reference application. | ### The command has no such setting (needs a new command option first) | Event | Setting | Note | |---|---|---| | Image Size (`ImgS`) | `scaleStyles` | Measured: with `scaleStyles` true a 20 px stroke becomes 10 px at 50 %; with false or no key it stays 20 px. `image.imageSize` always scales effects, so a step without the key plays differently in PhotoCraft, and a saved step plays unscaled there. 27 corpus steps carry it. | | Convert to Profile (`convertToProfile`) | `Dthr` (dither), `Fltt` (flatten), `rasterizePlaced`, `sdwM` | Dropped on load. | | Fill (`Fl `) with Content-Aware | `contentAwareColorAdaptationFill`, `contentAwareRotateFill`, `contentAwareScaleFill`, `contentAwareMirrorFill` | Dropped on load. | | Paste Layer Style (`pasteEffects`) | `allowPasteFXOnLayerSet` | Dropped on load. | | Paste (`past`) | `As ` (paste a vector clipboard as pixels, path or shape) | Dropped on load. | ### 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); `changeBackground` long | | `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) | | | 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 " 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). ## 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 Datei: "" Fehler: () …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: events not mapped yet Each entry below is an event the reference application records that PhotoCraft does not map yet: its 4-character code and string ID, the PhotoCraft command it should map to, and every key the step carries, in the order it is recorded, with type, unit, factory default and allowed values. When an event is implemented, move it to the table above 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). Without the dialog the value is ignored | | `Ofst` | offset | integer | | 0 | -9999 .. 9999 (measured in the dialog). Without the dialog the value is ignored | | `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.