OpenFile

Open one or more photometric files and add their luminaires to the session.

Undo support: Not registered as an undoable operation.

Syntax

OpenFile "<path>" ["<path>" ...]

Parameters

Use absolute file paths, each quoted if it contains spaces. Formats are selected from the file extension. Loading runs in the background; the HTTP response waits for completion.

Example

OpenFile "D:\Photometry\sample.ies"

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

Response

OK <count1> <emitterId...> <count2> <emitterId...>: one count and its emitter IDs per input file. A failed file has count 0 if other files loaded; all failures return an error.

Notes

Returned IDs identify emitter intensity models, not parent luminaires. The console records parent luminaire IDs. This action selects the loaded data; do not retry automatically after a timeout.

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

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