SaveFile

Save an emitter distribution to a photometric file.

Undo support: Not registered as an undoable operation.

Syntax

SaveFile <emitterId> ["<filename>"] [<emitterId> "<filename>" ...]

Parameters

Provide a complete absolute filename and supported extension for every emitter ID. Omitting a filename opens a file dialog. Avoid filenames consisting solely of digits, which can be interpreted as another ID.

Example

SaveFile 12 "D:\Photometry\edited.ies"

Example IDs are placeholders; replace them with IDs from your current session.

Response

Normally OK; save failures or cancellation may only be recorded in the console. Verify the destination file.

Notes

The current implementation saves a cloned emitter in a new document and adds the saved result as a new luminaire in the session. This is not an in-place save of a complete multi-channel document. Existing destination files may be overwritten.

Implementation: EikonalWorksTools/EWIntensityView/src/actions/fileIO/SaveLidFileAction.h.

See API connection, grammar and client examples for quoting, error handling and model IDs.