Combine

Create a new luminaire by combining weighted intensity distributions.

Undo support: Registered as undoable; see limitations below.

Syntax

Combine <emitterId> <ratio> [<emitterId> <ratio> ...] [<A|B|C|H> <symmetry> <planarAngles...> / <conicAngles...>]

Parameters

Supply ID/weight pairs. Ratios are multipliers, not percentages: use 1 for full contribution. Without an explicit grid, the first source supplies the output grid. An explicit grid requires strictly increasing nonempty angle lists; symmetry codes are 0 through 4, and H cannot use 4.

Example

Combine 12 1.0 13 0.5

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

Response

OK on completion, not a structured list of created IDs. If no source is valid, a descriptive failure message is returned; inspect the session and console.

Notes

Current limitation: although registered as undoable, the output-unregistration code is not implemented. Do not rely on Undo to remove the created luminaire.

Implementation: EikonalWorksTools/EWIntensityView/src/actions/edit/CombineAction.h.

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