Add a `--no-timestamp` option to the `node capture` command, allowing users to disable timestamp labeling on captured images. Update the command description and related documentation to reflect this new functionality, ensuring clarity on the capture process and output format. Additionally, implement a utility function for consistent timestamp labeling across the application, improving the overall user experience when capturing node images.
1.1 KiB
1.1 KiB
dapi node capture [id] [-t, --time <time...>]
Focuses the node on the canvas and captures it, writing one PNG to the system temp directory per timeline position. Each capture is stamped in the top-left with its HH:MM:SS:FF timestamp. If [id] is omitted, captures the canvas (the active scene). To grab a video asset's own pixels at full resolution instead of the composited canvas, use media grab.
Input
[id]: node id (optional; defaults to the canvas)-t, --time <time...>: one or more timeline positions at which to record the node, each aTimevalue (optional; defaults to the current playhead position)--no-timestamp: don't stamp each capture with itsHH:MM:SS:FFtimestamp label
Output
One JSON object per line (JSON Lines), in the order the times were given: each has the requested time in seconds (null for the current playhead) and the absolute path to a freshly written PNG in the system temp directory with a uuid filename.
{ time: number | null, path: string } // e.g. { "time": 1.5, "path": "/tmp/3f2c1a8e-....png" }