Navigation: Scripting Reference Manual

 

Scripting Reference Manual

 

Contact Us: fredsupport@photonengr.com

 

The following is a list of BASIC functions and subroutines that are unique FRED extensions to the scripting language. They are grouped according to common usage.

 

 


Script and File Functions

 

CloseFred  Immediately closes FRED without saving

GetDocDir  Gets document directory path

GetFredVersionIdString  Gets FRED version
GetTitle  Gets document title

GetUnitConvFactor Returns the scale factor required to convert between the specified spatial units

GetUnits  Gets document geometry units
RunFile  Runs the given script file
SetUnits  Sets document geometry units

SysClose  Closes the named FRED doc
SysCloseAll  Closes all FRED docs
SysCloseNoSave  Closes the named FRED doc with no file save
SysIsOpen  Returns True if a FRED doc with the given file name is open
SysNew  Opens new FRED doc with the given title
SysNewOrReset  Opens new FRED doc if doesn't exist, or restart if it does
SysOpen  Opens an existing FRED doc with the given file
SysReset  Opens new FRED doc if doesn't exist, or restart if it does
SysSave  Saves the associated file
SysSaveTo  Saves to file

 

Back to top


Repository

 

RepositoryCreate  Creates a repository for document control

RepositoryCopyFileTo  Copies a file to a specified repository

RepositoryDeleteFile  Deletes a file from specified repository

RepositoryMoveFileTo  Moves a file to a specified repository

RepositoryOpenFileToDoc  Opens a FRED file from a specified repository

RepositorySaveFredDocTo  Saves a FRED document to the specified repository

 

Back to top


Charts

 

AddUser2DPlot  Adds a new (empty) user 2D chart

AddUser2DPlotSeries  Adds a new data series to an existing user 2D chart

DeleteUser2DPlot Deletes a 2D chart

DeleteUser2DPlotSeries Deletes a data series from an existing user 2D chart

FindUser2DPlot Returns the plot identification number given a graph title string

Get2DChart Retrieves the chart Object for a currently displayed 2D plot and returns the number of currently displayed 2D plots

Get3DChartTriplet Retrieves the 3D and two 2D chart objects from an open plot window and returns the number of currently displayed 3D plots

GetObjUser2DPlot Returns the 2D chart object for a designated chart

GetUser2DPlotGraphTitle Returns the graph title from an existing user 2D chart

GetUser2DPlotInfoText Returns the info text string from an existing user 2D chart

GetUser2DPlotLegendLabel Returns the legend label string for a data series in an existing 2D chart

GetUser2DPlotPoint Retrieves the X,Y value for a point in a given data series

GetUser2DPlotPointCount Returns the number of points in a given data series of an existing 2D chart

GetUser2DPlotSeries Retrieves the x and y data arrays from a specific series in a 2D chart

GetUser2DPlotSeriesCount Returns the number of series currently displayed in an existing user 2D chart

GetUser2DPlotWindowTitle Returns the window title string from an existing user 2D chart

GetUser2DPlotXAxisTitle Returns the X-axis title from an existing user 2D chart

GetUser2DPlotYAxisTitle Returns the Y-axis title from an existing user 2D chart

SaveUser2DPlotGraphToFile Saves a bitmap image of an existing user 2D chart

SetUser2DPlotGraphTitle Sets the text title for an existing user 2D chart

SetUser2DPlotInfoText Sets the info text for an existing user 2D chart

SetUser2DPlotLegendLabel Sets the legend label for a series in an existing user 2D chart

SetUser2DPlotPoint Sets the X,Y value for a point in a given data series

SetUser2DPlotSeries Sets the X and Y data arrays for a given series in an existing user 2D chart

SetUser2DPlotXAxisTitle Sets the X-axis text title for an existing user 2D chart

SetUser2DPlotXLimits Specifies explicit minimum and maximum limits along the X axis of a user 2D chart

SetUser2DPlotXLimitsAuto Specifies the state of the X axis range auto-calculate function of a user 2D chart

SetUser2DPlotYAxisTitle Sets the Y-axis text title for an existing user 2D chart

SetUser2DPlotYLimits Specifies explicit minimum and maximum limits along the Y axis of a user 2D chart

SetUser2DPlotWindowTitle Sets the window title for an existing user 2D chart

 

Back to top


FREDMPC (GPU)

 

MPCRaytrace Performs a GPU raytrace and/or analysis, or renders and image of the 3D view using GPUs

MPCAdvancedRaytrace Performs an MPC Trace Advanced calculation using GPUs

MPCGetAdvancedParameters Retrieves the advanced parameters and return ray flags used during an Advanced MPC trace

MPCGetRaySumMode Retrieves the active state flag and single precision flags of the GPU coherent ray summation mode

MPCInitAdvancedRaytrace Initializes a T_MPCADVANCEDRAYTRACE data structure for use with MPCAdvancedRaytrace

MPCSetAdvancedParameters Sets the advanced parameters and return ray flags used during an Advanced MPC trace

MPCSetRaySumMode Sets the active state flag and single precision flag for the GPU coherent ray summation mode

 

Back to top


Distributed Computing

*IPC = Inter-Process Communication

 

IPCConnect Issues a connection request to each of the active remote nodes designated in a connections array

IPCDeclareTotalWorkUnits Specifies the total number of work units to be distributed across all remote instances

IPCDeleteRemoteFile Issues a request to delete a specific file from all active nodes in a connections array

IPCDisconnect Issues a disconnect request to all active nodes in a connections array but does not halt or close the associated remote FRED instances

IPCExecEmbeddedScript Issues a request to execute an embedded script for all active nodes in a connections array

IPCExecScriptFile Issues a request to execute a standalone script for all active nodes in the connections array

IPCGetLoadBalance Retrieves the currently assigned load balancing mode

IPCGetWorkUnits Used in a remote script, this retrieves the currently assigned work units

IPCLoadConfigFile Populates an array of T_IPCINSTANCE (referred to as the "connections array") using remote node information stored in a CSV file

IPCLoadModel Issues a request to load a FRED file for all active nodes in the connections array

IPCPullFile Pulls (copies) one or more files from the remote nodes to a destination folder (typically on the master node)

IPCPushFile Pushes (copies) one or more files from a source folder (typically on the master node) to the remote nodes

IPCPushPreferences Pushes the preference settings from the master node out to the remote nodes

IPCQueryStatus Queries each of the remote nodes in a connections array for their status and prints the results of the query to the output window

IPCReconnect Uses a snap shot file of a previous connections array to re-establish communication with any active nodes

IPCRecoverConnections Attempts to use the auto-generated snapshot file in the Undo directory of the master node to reconnect to orphaned remote FRED instances

IPCSaveConfigFile Writes the current connections array information to a CSV file for (potentially) use later in reestablishing connections to the remote FRED instances

IPCSetLoadBalance Specifies whether load balancing on the remotes should be "static" or "dynamic"

IPCTerminate Disconnects and queues all active connections for termination with an optional wait parameter

IPCWaitForIdle Instructs the master script to wait a designated amount of time for the active remote nodes to become idle before continuing execution

 

Back to top


Text Window Functions

 

ClearOutputWindow Clears the output window of text
EnableTextPrinting  Enables/disables printing to the text window
FindTextString  Searches for the given string
FindTextSubString  Searches for the given substring
GetTextCurCol  Gets current column number
GetTextCurRow  Gets current row number
GetTextNumber  Gets number at the given row & column
GetTextPosition  Gets current print position
GetTextString  Gets string at the given row & column
SetTextColorOff  Restores the default output window text color
SetTextFile  Prints to text file
SetTextFileAppend  Prints to text file
SetTextFileOff  Turns off printing to text file
SetTextPosition  Sets current print position

 

Back to top


Visualization Window

 

AddToIsolateAndFit3DView  Adds surfaces to an isolated 3D view

EnableIsolateFeature  Toggles isolate feature on and off

GetBackgroundGrid  Gets attributes of 3D visualization background grid
GetCamera  Gets 3D visualization camera attributes

IsolateAndFit3DView  Enables isolated 3D view for surfaces matching the given nodes array

RemoveFromIsolateAndFit3DView  Removes surfaces from an isolated 3D view
SaveJPEG  Saves the current OpenGL View as a JPEG

SaveJPEGSize  Saves the current OpenGL View as a JPEG with a user defined resolution
SetBackgroundGrid  Sets attributes of 3D visualization background grid
SetCamera  Sets 3D visualization camera attributes

 

Back to top


Math Functions

 

AccumulateFileInFile  Sums separately the components of two data files with matching formats

Acos  Arc cosine
Asin  Arc sine
ArrayStats  Computes statistics of an array
Atn2  Arc tangent of y/x

BessJ0  Zeroth order Bessel Function of the first kind

BessJn  nth order Bessel Function of the first kind

BessY0  Zeroth order Bessel Function of the second kind

BessYn  nth order Bessel Function of the second kind
BlackBodyRadianceEnergy  Radiance energy
BlackBodyRadiancePhotons  Radiance photons
BlackBodyFractionalEnergy  Fractional black body integral energy
BlackBodyFractionalPhotons  Fractional black body integral photons
CmpxAbs  Absolute value of complex number
CmpxAbs2  Square of absolute value of complex number
CmpxAdd  Complex addition
CmpxArg  Argument of complex number
CmpxDiv  Complex division
CmpxMult  Complex multiplication
CmpxSqrt  Complex square root
CmpxSub  Complex subtraction
Cosh  Hyperbolic cosine
CrossProd3D  Cross product of two vectors

DegToRad Converts a number from degrees to radians
DirCosinesToTypeAPhotometry  Converts direction cosines to IES type A photometry angles
DirCosinesToTypeBPhotometry  Converts direction cosines to IES type B photometry angles
DirCosinesToTypeCPhotometry  Converts direction cosines to IES type C photometry angles
DotProd3D  Dots product of two vectors (x1,y1,z1) and (x2,y2,z2)
Erff  Calculates the error function of a given value x.
FFT2D  2D Fourier Transform on complex double precision array
Gaus  Gaussian:  exp(-x2)
Gaus2  Gaussian:  exp(-px2)
GetAnalysisValue  Get interpolated value in the array
GetDim  Gets the number of dimensions in an array
GetLength3D  Gets length of vector (x,y,z)

GetRandomDouble Returns a high quality random number suitable for multi-threading
Herm  Hermite polynomial
Lagr  Generalized Laguerre polynomial
LinearEquationSolve  Solves the matrix equation  M*x=b
LoadTable  Loads values into an array
Log10  Logarithm base 10
MatMatMult  Multiplies two double precision matrices
MatVecMult  Multiplies a double precision matrix by a double precision vector
Max  Finds maximum of two numbers
Max3  Finds maximum of three numbers
Max4  Finds maximum of four numbers

Min  Finds minimum of two numbers
Min3  Finds minimum of three numbers
Min4  Finds minimum of four numbers

Photopic  Photopic curve

PI Returns the value of PI as 3.14159265358979

PolynomialSolve Fit x,y data to a specific polynomial order and return the coefficients of the fit
Power  X raised to Y power

RadToDeg Converts a number from radians to degrees

RanDbl Returns a high quality random number suitable for multi-threading - not limited to scripts associated with FRED documents

Round  Rounds floating point numbers to integers

Scotopic  Scotopic curve
SetLength3D  Sets length of vector (x,y,z)
Sinc  sin(x)/x
Sinc2  sin(px)/(px)
Sinh  Hyperbolic sine
Somb  Sombrero:  2*J1(x)/x
Somb2  Sombrero:  2*J1(px)/(px)
StrToDbl  Convert: string --> double
Tanh  Hyperbolic tangent
TypeAPhotometryToDirCosines  Converts IES type A photometry angles to direction cosines
TypeBPhotometryToDirCosines  Converts IES type B photometry angles to direction cosines
TypeCPhotometryToDirCosines  Converts IES type C photometry angles to direction cosines
 

Back to top


Miscellaneous Functions

 

Color and Images

ChromaticityToCCT Converts chromaticity coordinates to a correlated color temperature (CCT) value

ConvertColorImageFileXYZToBitmap Produces a bitmap image from a Color Image data file

RGBToBitmap  Writes the RGB arrays to a bitmap file
RGBToBitmap2  Writes the RGB arrays to a bitmap file
RGBToTriStimulus  Converts Red, Green, Blue values to visual tristimulus values

TriStimulusToChromaticity Converts visual tristimulus values to chromaticity coordinates
TriStimulusToRGB  Converts visual tristimulus values to Red, Green, Blue values
WavelengthToRGB  Computes RGB for the given wavelength (mm)
WavelengthToTriStimulus  Computes visual tristimulus values for the given wavelength (mm)

XYZImageToRGBImage  Converts image array of XYZ tristimulus values to an image array of Red, Green, Blue values

 

Comments

AddComment  Appends to doc's comment string
GetComment  Gets doc's comment string
SetComment  Sets doc's comment string
 

Computer Information

GetTotalProcessorCount  Returns the total number of processors on your computer

GetRelativeMaxProcessorCount  Returns the number of processors FRED is currently allowed

SetRelativeMaxProcessorCount  Sets the number of processors FRED is allowed to use

 

Global Script Variables

AddGlobalVar Adds a new global script variable to the document

DeleteGlobalVar Deletes a global script variable from the document

FindGlobalVar Gets the ID number of a global script variable by its name

GetGlobalVar Gets the name, value and comment for a global script variable

GetGlobalVarCount Gets the number of global script variables in the document

GetGlobalVarValue Gets the value of a global script variable

SetGlobalVar Sets the name, value and comment for a global script variable

SetGlobalVarValue Sets the value for a global script variable

 

Library Objects

CreateLib Compiles and return a script library object
GetLib Returns a previously compiled script library
 

Pre and Post Update Scripts

AddPostUpdateScript  Appends to document post-update script
AddPreUpdateScript  Appends to document pre-update script
GetPostUpdateScript  Gets document post-update script
GetPostUpdateScriptActive  Gets the active status of the post-update script
GetPreUpdateScript  Gets doc's pre-update script
GetPreUpdateScriptActive  Gets the active status of the pre-update script
SetPostUpdateScript  Sets document post-update script
SetPostUpdateScriptActive  Sets the active status of the post-update script
SetPreUpdateScript  Sets document pre-update script
SetPreUpdateScriptActive  Sets the active status of the pre-update script
 

Preferences

PrefsGetARNRetainCount Retrieves the preference value controlling the number of ARNs to retain prior to auto-deletion

PrefsGetDisplayEnhRaytraceStats Retrieves the preference setting for displaying enhanced raytrace statistics data

PrefsGetFGDUseBinaryFormat  Retrieves preference to write data files in binary format

PrefsGetRandomReseed Retrieves the preference for reseeding the random number generator before every raytrace

PrefsSetDisplayEnhRaytraceStats Sets the preference for displaying enhanced raytrace statistics data

PrefsSetFGDUseBinaryFormat  Sets preference to write data files in binary format

PrefsSetARNRetainCount Sets the preference value controlling the number of ARNs to retain prior to auto-deletion
PrefsSetRandomReseed  Sets the preference for reseeding the random number generator before every raytrace

ReadPreferences  Reads preferences from a text file and applies them

SavePreferences  Saves currently defined preferences to a text file
 

Shell

ShellExecuteAndWait Executes a command in Shell and waits for completion before returning to the FRED script

 

Text Strings 

Format  Controls formatting of expressions

InStrOneOf  Finds first occurrence in a string of any character in a character set
ParseString Parses an input string based upon given delimiters and loads arrays with tokens

 

Time

ElapsedTime Displays the elapsed time since the FRED session started

Wait  Sleeps for the given number of seconds

 

Units and Scaling

ScaleEntity Scales the designated entity and its descendants by the specified scale factor

ScaleToUnits Scales the system to the designated units

ScaleSystem Scales the system by a designated value

 

Updating

ForceUpdate Debugging function that forces a full document update.  Should only be used in specific cases where the standard Update subroutine does not work properly.

RedrawOnUpdate  Forces a surface to re-tessellate and redraw
Update Triggers the document update cycle to reflect any changes submitted via scripting

 

Back to top


Embedded Scripts

 

AddEmbeddedScript  Adds an Embedded script

DeleteEmbeddedScript  Deletes Embedded script at given array index

FindEmbeddedScript  Returns ID of named Embedded script

GetEmbeddedScript  Gets an Embedded script

GetEmbeddedScriptCount  Returns the number of Embedded scripts

GetEmbeddedScriptDesc  Gets the Embedded script description

GetEmbeddedScriptLib  Returns an Embedded script as a library

GetEmbeddedScriptName  Gets the Embedded script name

SetEmbeddedScript  Sets an Embedded script

SetEmbeddedScriptDesc  Sets the Embedded script description

SetEmbeddedScriptName  Sets the Embedded script name

RunEmbeddedScript  Runs an Embedded script

 

Back to top


Optimization

 

Generic

Optimize  Initiates an optimization
OptimizeUndo  Restores initial values after an optimization

MzrSensitivity Performs a sensitivity analysis on the active optimization variables
 

Merit Function Aberrations
AddMzrAberration  Adds a Merit Function aberration
DeleteIthMzrAberration  Deletes a Merit Function aberration

EvaluateMeritFunction Evaluates and returns the Merit Function value
GetIthMzrAberration  Retrieves the i'th Merit Function aberration
GetMzrAberrationCount  Returns the number of Merit Function aberrations defined

GetMzrAberrationTarget Retrieves the target value from a merit function aberration
InitMzrAberration  Initializes a T_MZRABERRATION structure

InsertIthMzrAberration  Inserts a Merit Function aberration

IsMzrAllowARNs Returns a boolean indicating whether ARN generation by detector entities during optimization raytracing is allowed
SetIthMzrAberration  Sets the i'th Merit Function aberration

SetMzrAberrationTarget Sets the target value for a specific merit function aberration

SetMzrAllowARNs Specifies whether ARN generation by detector entities should be allowed during optimization raytracing
 

Optimization Method
GetMzr1DVariable  Returns the 1D variable

GetMzrAnnealStartTemperature Returns the starting temperature for a simulated annealing optimization

GetMzrAnnealStopAfterSteps Returns the number of temperature reduction steps for a simulated annealing optimization

GetMzrAnnealStopBelowMinTemperature Returns the minimum temperature stopping criteria for a simulated annealing optimization

GetMzrAnnealTemperatureReduceFraction Returns the temperature reduction fraction value for a simulated annealing optimization
GetMzrLogToOutputWindowCount  Returns the number of iterations to be skipped between log data being printed to the Output Window

GetMzrMethod  Returns the Optimization Method

GetMzrMultiStarts Returns the number of multiple restarts allowed in an optimization

GetMzrRedraw3DViewCount  Returns the number of iterations to be skipped between redraws of the 3D View
GetMzrRedrawRaysCount  Returns the number of iterations to be skipped between redraws of the rays
GetMzrStopMeritFunctionChangeValue  Returns the value of Stopping/Convergence Criteria "merit function changes less than"
GetMzrStopMeritFuncThresholdValue  Returns the value of Stopping/Convergence Criteria "merit function falls below"
GetMzrStopOnIterCountValue  Returns the value of Stopping/Convergence Criteria "after iterations"
GetMzrStopVarChangeValue  Returns the value of Stopping/Convergence Criteria "variable changes less than"

 

IsMzrHaltOnMeritError  Returns True if Optimization is to be halted on a merit function error

IsMzrLogBeforeAndAfter Returns True if variable and aberration value before and after optimization logging is active

IsMzrLogMeritFunctions  Returns True if Merit Function values are to written to the Output Window
IsMzrLogToOutputWindow  Returns True if log information is to written to the Output Window
IsMzrLogVariableValues  Returns True if Variable values are to written to the Output Window

IsMzrLogVerboseMeritFunc Returns True if the verbose output is active or False if inactive
IsMzrRedraw3DView  Returns True if the 3D View is to be redrawn
IsMzrRedrawRays  Returns True if the rays are to be redrawn
IsMzrStopMeritFunctionChange  Returns True if the Stopping/Convergence Criteria is "merit function changes less than"
IsMzrStopMeritFuncThreshold  Returns True if the Stopping/Convergence Criteria is "merit function falls below"
IsMzrStopOnIterCount  Returns True if the Stopping/Convergence Criteria is "after iterations"
IsMzrStopVarChange  Returns True if the Stopping/Convergence Criteria is "variable changes less than"
IsMzrVariableSoftBoundary  Returns True if the Soft limit (penalty) is enabled


SetMzr1DVariable  Sets the 1D variable

SetMzrAnnealStartTemperature Sets the starting temperature for a simulated annealing optimization

SetMzrAnnealStopAfterSteps Sets the stopping criteria in a simulated annealing optimization to use a designated number of steps

SetMzrAnnealStopBelowMinTemperature Sets the stopping criteria in a simulated annealing optimization to use a designated minimum temperature

SetMzrAnnealTemperatureReduceFraction Sets the temperature reduction fraction value for a simulated annealing optimization
SetMzrHaltOnMeritError  Sets Optimization to halt on a merit function error

SetMzrLogBeforeAndAfter Sets the flag to log variable and aberration values from before and after optimization for printing to the output window

SetMzrLogMeritFunctions  Sets the flag to allow Merit Function values to be written to the Output Window
SetMzrLogToOutputWindow  Sets the flag to allow log information to be written to the Output Window
SetMzrLogToOutputWindowCount  Sets the number of iterations to be skipped between log data being printed to the Output Window
SetMzrLogVariableValues  Sets the flag to allow Variable values to be written to the Output Window

SetMzrLogVerboseMeritFunc Sets the active flag for the verbose merit function calculation output
SetMzrMethod  Sets the Optimization Method

SetMzrMultiStarts Sets the number of multiple random restarts for an optimization
SetMzrRedraw3DView  Specifies whether the 3D view should be redrawn during optimization

SetMzrRedraw3DViewCount  Sets the number of iterations to be skipped between redraws of the 3D View

SetMzrRedrawRays  Specifies whether the rays should be redrawn during optimization

SetMzrRedrawRaysCount  Sets the number of iterations to be skipped between redraws of the rays

SetMzrStopVarChange  Sets the Stopping/Convergence Criteria "variable changes less than"
SetMzrStopMeritFunctionChange  Sets the Stopping/Convergence Criteria "merit function changes less than"
SetMzrStopMeritFuncThreshold  Sets the Stopping/Convergence Criteria to "merit function falls below"

SetMzrStopOnIterCount  Sets the Stopping/Convergence Criteria "after iterations"
SetMzrStopVarChangeValue  Sets the value of Stopping/Convergence Criteria "variable changes less than"
SetMzrStopMeritFunctionChangeValue  Sets the value of Stopping/Convergence Criteria "merit function changes less than"
SetMzrStopMeritFuncThresholdValue  Sets the value of Stopping/Convergence Criteria "merit function falls below"
SetMzrStopOnIterCountValue  Sets the value of Stopping/Convergence Criteria "after iterations"

SetMzrVariableSoftBoundary  Specifies whether the soft-limit penalty should be applied when variables range out of bounds
 

Optimization Results
AddMzrResult Adds a new optimization result to the results list

DeleteMzrResult Deletes the optimization result from the results list

DeleteMzrResultAll Deletes all optimization results from the results list

GetMzrResult Retrieves a result from the specified index in the results list

GetMzrResultCount Retrieves the number of optimization results in the results list

 

Optimization Variables
AddMzrVariable  Adds an Optimization Variable
DeleteIthMzrVariable  Deletes the ith Optimization Variable
GetIthMzrVariable  Retrieves the ith Optimization Variable

GetMzrVariableCount  Returns the number of Optimization Variables
InitMzrVariable  Initializes a T_MZRVARIABLE structure
InsertIthMzrVariable  Inserts an Optimization Variable after the ith variable
SetIthMzrVariable  Sets the ith Optimization Variable
 

Back to top


Pickups

 

AddPickup Adds a new parameter pickup to the document pickup list

DeletePickup Deletes the pickup entry at the specified index in the document pickup list

GetPickup Retrieves the pickup entry definition at the specified index and stores the result in a T_PICKUP structure

GetPickupCount Returns the number of entries in the pickup list

GetPickupsActiveFlag Retrieves the active flag status for parameter pickups

InitPickup Initializes a T_PICKUP data structure with default values

SetPickup Sets the parameter values for a pickup entry in the document pickup list

SetPickupsActiveFlag Sets the active flag status for parameter pickups

 

Back to top


Configurations

 

AddConfig Adds a new configuration to the end of the configuration list

AddConfigVariable Adds a new configuration variable

DeleteConfigVariable Deletes the configuration variable at the designated index

DeleteIthConfig Deletes the configuration at the designated index

GetConfigCount Returns the number of configurations defined in the document

GetConfigValue Retrieves the variable value for a given configuration

GetConfigVariable Retrieves a specified configuration variable definition

GetConfigVariableCount Returns the number of variables in the configuration list

GetCurrentConfig Returns the configuration number that the document is currently in

InitConfigVariable Initializes a T_CONFIGURATION data structure with default member values

InsertIthConfig Inserts a new configuration at the designated index

SetConfigValue Sets the configuration value for a given variable and configuration

SetConfigVariable Sets the parameter values for an existing configuration variable

SetCurrentConfig Sets the document state to a current configuration

 

Back to top


Group Functions

 

AddGroup Appends new group
AddToNthGroup Adds item to n'th group

DeleteAllGroups Deletes all groups
DeleteAllFromNthGroup Deletes all items from n'th group
DeleteFromNthGroup Deletes i'th item from n'th group
DeleteGroup Deletes the n'th group

FindEntityInGroup Find entity id, 'i', in n'th group
FindGroup Returns the ID of a named group
FindGroupFromEntity  Finds entity id, 'i', in n'th group

GetFromNthGroup Gets i'th item from n'th group
GetGroupCount Returns number of groups
GetGroupDescription Returns the description of the n'th group
GetGroupName Returns the name of the n'th group
GetNthGroupCount Returns number of items in n'th group

SetGroupDescription Sets the description of the n'th group
SetGroupName Sets the name of the n'th group

 

Back to top


Import/Export

 

DoCADExport Executes an export of the model to a CAD file

DoCADImport Executes an import of CAD geometry into the associated document

InitCADImport Initializes a T_CADIMPORT data structure with default member values

InitCADExport Initializes a T_CADEXPORT data structure with default member values

 

Back to top


Element Primitives

 

Add Primitive

ElemAddBeveledWedge Adds a Beveled Wedge type element primitive

ElemAddBlock Adds a Block type element primitive

ElemAddCircularPyramid Adds a Circular Pyramid type element primitive

ElemAddCoil Adds a Coil type element primitive

ElemAddCPC Adds a CPC type element primitive

ElemAddCube Adds a Cube type element primitive

ElemAddCylinder Adds a new Cylinder type element primitive

ElemAddCylinderLens Adds a Cylinder Lens type element primitive

ElemAddEllipsoid Adds an Ellipsoid type element primitive

ElemAddEllipsoidTrunc Adds a Truncated Ellipsoid type element primitive

ElemAddFrustum Adds a Frustum type element primitive

ElemAddHemisphereShell Adds a Hemisphere Shell type element primitive

ElemAddHemisphereSolid Adds a Hemisphere Solid type element primitive

ElemAddHemisphereSurface Adds a Hemisphere Surface type element primitive

ElemAddIdealLens Adds an Ideal Lens type element primitive

ElemAddMultimodeFiberOptic Adds a Multimode Fiber Optic type element primitive

ElemAddNsidedExtrudedSolid Adds an N-sided Extruded Solid type element primitive

ElemAddNsidedExtrudedSurface Adds an N-sided Exttruded Surface type element primitive

ElemAddNsidedPipe Adds an N-sided Pipe type element primitive

ElemAddNsidedPlane Adds an N-sided Plane type element primitive

ElemAddNsidedPyramidSolid Adds an N-sided Pyramid Solid type element primitive

ElemAddParabolicTrough Adds a Parabolic Trough type element primitive

ElemAddParaboloid Adds a Paraboloid type element primitive

ElemAddPipe Adds a Pipe type element primitive

ElemAddPlane Adds a Plane type element primitive

ElemAddPlaneWithNsidedHole Adds a Plane with N-sided Hole type element primitive

ElemAddRod Adds a Rod type element primitive

ElemAddSphere Adds a Sphere type element primitive

ElemAddTorus Adds a Torus type element primitive

ElemAddWedge Adds a Wedge type element primitive

 

Parameters

ElemGetCPC Retrieves the construction data from a CPC element primitive into a data structure

ElemGetParmCount Gets the number of parameters used to define the element primitive

ElemGetParmDescription Gets the description of an element primitive parameter

ElemGetParmName Gets the name of an element primitive parameter

ElemGetParmValue Gets the value of an element primitive parameter

ElemSetCPC Sets the construction data for a CPC element primitive using a data structure

ElemSetParmValue Sets the value of an element primitive parameter

 

Properties

ElemAddScatter Adds a scatter model to all surfaces in the element primitive

ElemSetCoating Sets the coatings for all surfaces in the element primitive

ElemSetMaterials Sets the materials for all surfaces in the element primitive

ElemSetRaytraceCtrl Sets the raytrace control set for all surfaces in the element primitive

 

Status

IsElementPrimitive Checks to see if a node is, or is not, an element primitive

 

Back to top


Element Composites (solids)

 

ElemAddBoolean Adds an element composite do the document

ElemBooleanGetSpec Gets the boolean operation string from an element composite

ElemBooleanSetSpec Sets the boolean operation string for an element composite

 

Back to top


Raytrace Functions

 

Advanced
AdvancedRaytrace  Advanced raytrace

InitAdvancedRaytrace  Initializes the advanced raytrace variable type
InitTargetedRay Initializes the Targeted Ray variable type

TargetedRay Performs the targeted ray trace
 

Basic
CreateSource  Creates source with node id n
CreateSources  Creates all sources
DeleteRays  Deletes all rays

TraceCreate  Creates all, trace, and no draw
TraceCreateDraw  Creates all, trace, and draw
TraceExisting  Traces existing rays, and no draw
TraceExistingDraw  Traces existing rays, and draw

 

Ray buffer handling
AddFilteredRaysFromCurrentBufferToNewBuffer A new ray buffer is created and populated with copies of rays from the current buffer that match an array of ray selection filter criteria.

AddRayBuffer  Adds a ray buffer to the main raybuffer array

CopyRayAuxBufferToBuffer  Copies a ray from an aux ray buffer to the main ray buffer

CopyFilteredRaysBufferToBuffer Copies, in bulk, all rays passing an array of ray selection filter criteria from one buffer to another

CopyRayBufferToBuffer  Copies a ray from one ray buffer to another
DeleteRayBuffer  Deletes the n'th ray buffer

GetActiveRayBufferIndex  Returns the raybuffer array index of the active ray buffer

GetAuxRayBufferCount   number of ray buffers in the auxiliary ray buffer array
GetAuxRayBufferLiveRayCount  number of actual live rays in the n'th auxilliary ray buffer

GetAuxRayBufferRayCount  number of rays in the n'th auxiliary ray buffer
GetRayBufferCount  number of existing ray buffers in the main raybuffer array
GetRayBufferLiveRayCount  number of actual live rays in the n'th ray buffer

GetRayBufferRayCount  number of rays in the n'th ray buffer

GetTracingRay Retrieves the T_RAY structure corresponding to the ray currently being traced in the ray buffer
MoveRayBufferToBuffer  Moves a ray from one ray buffer to another
SetActiveRayBufferIndex  Makes the n'th ray buffer be the active one

SetTracingRay Sets the T_RAY structure member variable values to the ray currently being traced in the ray buffer
 

Back to top


Analyses

 

BestFocus  Performs a Geometric Best Focus analysis in a user-specified coordinate system

CalcOPDMapsAuto Performs a Geometric OPD Map analysis with FRED auto-determining the best-fit reference sphere

CalcOPDMapsCurve Performs a Geometric OPD Map analysis with a user-defined reference sphere specified using a curvature and tilt vector

CalcOPDMapsFocus Performs a Geometric OPD Map analysis with a user-defined reference sphere specified as the sphere's x,y,z center position

CoherentRaySize  Gaussian beam size (e^-2 power)
ColorImage  Performs a Color Image analysis and returns arrays containing the X,Y,Z tristimulus values

ColorImageToARN  Performs a Color Image analysis and stores the result in an ARN

ColorImageToFile  Performs a Color Image analysis and writes the result directly to a file

ColorImageToFileAS  A variation of ColorImageToFile that leverages an Analysis Surface for grid and ray filtering specification

ConvertColorImageFileXYZToBitmap Produces a bitmap image from a Color Image data file.

DecomposeWavefrontToZernikes  Computes Zernike coefficients for a wavefront
DisplayPlotFile  Displays an existing plot file in the 3D Chart Viewer

EnergyDensity  Computes energy density

EnergyDensityToARN  Computes Energy Density and return results to an ARN

EnergyDensityToFile  Computes Energy Density and write result to file

EnergyDensityToFileAS  Computes Energy Density write result to file using only Analysis Surface settings
FiberCoupleGaussian   Computes fiber coupling coefficient for a Gaussian fiber mode

FiberCoupleStepIndex   Computes fiber coupling coefficient for a step index single core fiber
GetSurfAbsorbedPower  Returns absorbed power on the surf
GetSurfIncidentPower  Returns incident power on the surf

GetSurfIncidentRayCount  Returns the number of rays incident on a surface during the most recent raytrace

IlluminanceToARN Computes illuminance and return to an ARN

IlluminanceToFileAS Computes illuminance and write to a file
Intensity  Computes intensity

IntensityAtSpecifiedDirections  Computes intensity or luminous intensity at user specified directions given an acceptance cone size

IntensityToARN Computes Intensity in polar coordinates and returns results to an ARN

IntensityToFileDAE  Computes Intensity in polar coordinates

Irradiance  Computes irradiance

IrradianceToARN Computes irradiance and store results in an ARN

IrradianceToFile  Computes irradiance and write to file

IrradianceToFileAS  Computes irradiance and write to file using only Analysis Surface settings
LuminousIntensityToARN Computes the luminous intensity and store results in an ARN

LuminousIntensityToFileDAE Computes the luminous intensity using a DAE and write the results to a file
PrintBestFocus  Prints best focus
RayStats  Prints ray statistics
RayStatus  Prints ray status
RaySummary  Prints ray summary

RaySummaryInfo Computes the ray summary information and store the results in a dictionary object
ScalarField  Computes a complex scalar field

ScalarFieldToARN  Computes a complex scalar field and return results to an ARN

ScalarFieldToFile  Computes a complex scalar field and write to file

ScalarFieldToFileAS Computes a complex scalar field and write to file using only Analysis Surface settings

SpectralAnalysis Performs a spectral analysis and creates a spectrum node containing the result

SurfPowers  Prints incident/absorbed ray powers
VectorField  Computes a complex vector field

VectorFieldToARN  Computes a complex vector field and return results to an ARN

VectorFieldToFile  Computes a complex vector field and write to file

VectorFieldToFileAS Computes a complex vector field and write to file using only Analysis Surface settings

Wavefront  Computes wavefront from a complex scalar field

WavefrontToARN Computes the wavefront of a complex scalar field and stores the result in an ARN
WriteToPlotFile  Writes sample analysis data to 3D chart compatible file

WriteToPlotFileWithComment - Writes sample analysis data to 3D chart compatible file with text comments included
 

Back to top


Data Collector Surface Visualization

 

IsDataCollectorSurf Query a surface to determine if it is a data collector surface object

 

DataCollectorPropertiesInit Initializes the members of a T_COLLECTOR_PROPERTIES data structure

DataCollectorPropertiesGet Retrieves the property configuration of the Data Collector Surface Visualization analysis function

DataCollectorPropertiesSet Sets the property configuration of the Data Collector Surface Visualization analysis function

 

DataCollectorSurfIsDataAvailable Queries a data collector surface to check if the collector is initialized

DataCollectorSurfIsCollectData Retrieves the data collection Active flag status of a data collector surface object

DataCollectorSurfSetCollectData Sets the Active flag state of a data collector surface object

DataCollectorSurfGetDataStats Retrieves the Active flag state of a data collector surface object

 

DataCollectorSurfGetDatum Retrieves a datum from a specific facet ID of a data collector surface object

DataCollectorSurfGetDatumCount Retrieves the number of datum from a data collector surface object

DataCollectorSurfSetDatum Applies a datum to a specific facet ID of a data collector surface object

 

DataCollectorSurfReadCollectedDataFile Reads datum from a CSV file into the facets of a data collector surface object

DataCollectorSurfWriteCollectedDataFile Writes datum from facets of a data collector surface object into a CSV file

 

Back to top


Analysis Surfaces

 

Analysis Surfaces

AddAnalysisSurf  Adds an analysis surface
AddAnalysisSurfOp  Appends a ray filter operation
DeleteAnalysisSurfIthOp  Deletes a ray filter operation

GetAnalysisSurf  Gets analysis surface
GetAnalysisSurfIthOp  Gets a ray filter operation
GetAnalysisSurfOpCount  Gets number of ray filter ops

GetRayFilter Retrieves all ray filter operations from an analysis surface and populates an array of T_RAYFILTEROP data structures

LoadAnalysis  Loads T_ANALYSIS structure with appropriate data from 'nEntity'

SetAnalysisParameters  Sets T_ANALYSIS parameters

SetAnalysisSurf  Sets analysis surface
SetAnalysisSurfIthOp  Sets the Ith ray filter operation on an analysis surface

 

Directional Analysis Entities

AddDirAnaEntity  Adds a Directional Analysis Entity

AddDirAnaEntityOp  Adds a Ray Specification to a Directional Analysis Entity

DeleteDirAnaEntityIthOp  Deletes a Ray Specification from a Directional Analysis Entity

GetDirAnaEntityAutoScale  Returns the autoscale parameter setting for a Directional Analysis Entity

GetDirAnaEntityAxes  Returns the Axes parameter setting for a Directional Analysis Entity

GetDirAnaEntityAzimuthalRange  Returns the Azimuthal Range settings for a Directional Analysis Entity

GetDirAnaEntityDrawProperties  Returns the Draw Properties for a Directional Analysis Entity

GetDirAnaEntityIthOp  Returns the Ith Ray Specification from a Directional Analysis Entity

GetDirAnaEntityOpCount  Returns the number of Ray Specifications for a Directional Analysis Entity

GetDirAnaEntityPolarRange  Returns the Polar Range setting for a Directional Analysis Entity

IsDirectionalAnalysisEntity Checks if a given node is a Directional Analysis Entity

SetDirAnaEntityAutoScale  Sets the autoscale parameter for a Directional Analysis Entity

SetDirAnaEntityAxes  Sets the Axes parameter for a Directional Analysis Entity

SetDirAnaEntityAzimuthalRange  Sets the Azimuthal Range for a Directional Analysis Entity

SetDirAnaEntityDrawProperties  Sets the Draw Properties for a Directional Analysis Entity

SetDirAnaEntityIthOp  Sets the Ith Ray Specification for a Directional Analysis Entity

SetDirAnaEntityPolarRange  Sets the Polar Range for a Directional Analysis Entity

 

Back to top


Detector Entities

 

DEAddOp Adds a ray filter operation to a detector entity

DECreate Adds a new detector entity to the document

DEDeleteIthOp Deletes a specific ray filter operation from a detector entity

DEGetIthOp Retrieves a specific ray filter operation from a detector entity

DEGetMostRecentARNNum Returns the node number of the most recent ARN created by a detector entity

DEGetOpCount Returns the number of ray filter operations applied to a detector entity

DEGetParam Returns the value of a specific detector entity parameter

DEGetParamNames Populates a string array with all of the parameter names for a specific detector entity

DEGetParams Returns a single string containing all parameter name and value pairs for a detector entity

DEGetType Returns the type string for a specific detector entity          

DEPerformAnalysis Performs the analysis for a detector entity

DESetIthOp Sets a specific ray filter operation for a detector entity

DESetParam Sets a single parameter value for a detector entity

DESetParams Sets one or more parameter values simultaneously for a detector entity

IsDetectorEntity Checks if a node is a detector entity

 

Back to top


Analysis Results Nodes

 

ARN Data Computations

ARNAccumulate Linearly combines one or more ARNs together with scaling factors and returns a new ARN containing the resulting data

ARNAverageAlongAAxis Sets each cell in a row along the A-axis to be the average for that row

ARNAverageAlongBAxis Sets each cell in a row along the B-axis to be the average for that row

ARNCompute2DCellStatistics Calculates the statistics of the data contained in an ARN

ARNCompute3DGridWallCellStatistics Calculates the statistics of the data contained in a 3D Grid Wall ARN

ARNComputeCCT Calculates Correlated Color Temperature from a Color Image ARN

ARNComputeIntegral Calculates the integral value (cell value*cell area for all cells) of the data in a 2D ARN and returns the result

ARNComputeStandardDev Calculates the standard deviation of the cell values in a 2D ARN and returns the result

ARNComputeSum Performs a summation of all cell values in a 2D ARN and returns the result

ARNComputeTotalPower Calculates the total power for the data contained in an ARN

ARNComputeWavefront Extracts the wavefront data array from a scalar field type ARN

ARNDecomposeToZernikes Performs a Zernike decomposition on an ARN with single-valued cell data of type Double

ARNFFT2D Performs a two dimensional FFT on an ARN in place (no copy is made)

ARNInterpolateCellValue3D Interpolates the value at position x,y,z from a 3D Grid Wall type ARN

ARNInterpolateCellValue2D Interpolates the value at position x,y from a 2D ARN

ARNLinearCombination Linearly combines exactly two ARNs together with scale factors

ARNLog10WithAbsoluteFloor Logs the data in an ARN and specify an absolute floor value below which the log is not taken

ARNLog10WithRelativeFloor Logs the data in an ARN and specify a floor value relative to the peak of the data

 

ARN Node Information

ARNGetLocked Queries an ARN for its lock status

ARNGetMaxNodeNum  Gets maximum ARN node number
ARNGetNodeCount  Gets number of ARN nodes
ARNIsValidNode  Checks validity of ARN node number

ARNSetLocked Sets the lock status for an ARN

 

Creating an ARN

ARNCreate2DGrid  Creates an ARN data format

ARNCreate2DSubsetByCellIndices Creates a new 2D ARN from a subset of data in an existing 2D ARN by specifying axes index ranges

ARNCreate2DSubsetByRange Creates a new 2D ARN from a subset of data in an existing 2D ARN by specifying axes value ranges
ARNCreate2DComplexFromComplex3D Creates a new 2D ARN with complex valued data (i.e. scalar field)  from an existing ARN whose data type is Complex3D (i.e. vector field) by extracting a specified field component

ARNCreate2DComplexFromDouble Creates a new 2D ARN with complex valued data (i.e. scalar field) from an existing ARN whose data type is Double

ARNCreate2DDoubleFromComplex Creates a new 2D ARN with data type Double from an existing ARN whose data type is complex (i.e. scalar field) by extracting a specified field component

ARNCreateCopy Creates a copy of an existing ARN

ARNCreateFromDirectory Searches a directory path for *.fgd and *.dat files and creates ARNs from all identified files

ARNCreateFromFile  Creates ARN from FRED Grid Data file (*.fgd)

 

Displaying an ARN

ARNCancelDisplayInVisualizationView Removes an ARN from display in the 3D view

ARNDisplayInChart  Displays an ARN in FRED's chart view

ARNDisplayInChartTriplet Displays an ARN in a chart window and return the 3D and 2D chart objects, allowing customization of the charts

ARNDisplayInVisualizationView  Displays an ARN in FRED's 3D visualization viewer for context

ARNSetDisplayScale Sets the color range scaling for one or more ARNs being displayed in the 3D visualization viewer

 

Finding / Deleting an ARN

ARNDelete  Deletes given ARN
ARNDeleteAllNodes  Deletes all ARN

ARNFindName Finds node number of named ARN 

 

Get / Set ARN Name and Description

ARNGetDescription  Gets text description from given ARN

ARNGetName  Gets name of given ARN node
ARNSetDescription  Sets text description of existing ARN
ARNSetName  Sets name of existing ARN

 

Get / Set ARN Information

ARNAppendToInfo  Appends to info in existing ARN
ARNGet2DPixelSize Retrieves the A and B axes lengths of an individual pixel

ARNGetAAxisDim  Gets A-axis dimension of existing ARN
ARNGetAAxisDir  Gets direction of A-axis for existing ARN
ARNGetAAxisParams  Gets A-axis parameters of existing ARN
ARNGetAAxisRange  Gets A-axis range for existing ARN
ARNGetAAxisValueAt  Gets A-axis value at given index in ARN
ARNGetBAxisDim  Gets B-axis dimension of existing ARN
ARNGetBAxisParams  Gets B-axis parameters of existing ARN
ARNGetBAxisDir  Gets direction of B-axis for existing ARN
ARNGetBAxisRange  Gets B-axis range for existing ARN
ARNGetBAxisValueAt  Gets B-axis value at given index in ARN

ARNGetCAxisDim Gets the dimension of the C-axis

ARNGetCAxisDir Gets the unit vector direction of the C-axis for an existing ARN (3D results only)

ARNGetCAxisParams Gets the C-axis parameters of an existing ARN (3D results only)

ARNGetCAxisRange Gets C-axis range for an existing ARN (3D results only)

ARNGetCAxisValueAt Retrieves the C-axis value at the given index in the ARN (3D results only)

ARNGetCellIndicesClosestToLocation2D Retrieves the A and B axis index positions which are closest to a designated physical location in the grid

ARNGetDataSpatialUnits Retrieves the data spatial units string from an existing ARN

ARNGetDataType  Gets ARN data type
ARNGetDataUnits  Gets ARN data units
ARNGetInfo  Gets info from existing ARN
ARNGetOriginPos  Gets origin position of existing ARN
ARNGetPhysicalMeaning  Gets physical meaning of existing ARN
ARNGetPolarAxis Gets the direction of the polar axis

ARNGetPlaneCenter  Returns the center coordinates of ARN

ARNGetPowerUnits Returns the ARN's power units string
ARNGetTagValueAsDouble  Gets double value of user-defined tag

ARNGetTagValueAsDoubleArray Gets a tag value as a double array
ARNGetTagValueAsInt  Gets integer value of user-defined tag
ARNGetTagValueAsString  Gets string value of user-defined tag
ARNGetTitle  Gets ARN title
ARNGetWavelenAndRefIndex  Gets wavelength and refractive index of existing ARN
ARNSet2DAxesDirections  Sets direction for axes of existing ARN
ARNSetAAxisParams  Sets A-axis parameters of existing ARN
ARNSetBAxisParams  Sets B-axis parameters of existing ARN

ARNSetDataSpatialUnits Sets the data spatial units for an existing ARN
ARNSetDataUnits  Sets ARN data units
ARNSetInfo  Sets info in existing ARN
ARNSetOriginPos  Sets origin position of existing ARN
ARNSetPhysicalMeaning  Sets physical meaning of existing ARN
ARNSetPolarAxis Sets the direction of the polar axis

ARNSetPowerUnits Sets the power units string of an existing ARN

ARNSetTagValueAsDouble Sets a tag value as a double

ARNSetTagValueAsDoubleArray Sets a tag value as a double array

ARNSetTagValueAsInt Sets a tag value as an int

ARNSetTagValueAsString  Sets string value of user-defined tag
ARNSetTitle  Sets ARN title
ARNSetWavelenAndRefIndex  Sets wavelength and refractive index of existing ARN

 

Get / Set ARN Data

ARN3DGridWallGetAbsorbedFluxData Gets the AbsorbedFlux cell data from a 3D Grid Wall analysis results node as a three dimensional array of doubles

ARN3DGridWallGetInCountData Gets the cell ray counts for InFlux contributors from a 3D Grid Wall analysis results node as a three dimensional array of longs

ARN3DGridWallGetInFluxData Gets the InFlux cell values from a 3D Grid Wall ARN and stores them in a 3D array

ARN3DGridWallGetOutCountData Gets the cell ray counts for OutFlux contributors from a 3D Grid Wall analysis results node as a three dimensional array of longs

ARN3DGridWallGetOutFluxData Gets the OutFlux cell values from a 3D Grid Wall ARN and stores them in a 3D array

ARNGetCellValueAsDoubleArray2D Gets multi-dimensional cell values and stores them in a 2D array

ARNGetDataAsDoubleArray  Gets data from ARN into double array

ARNGetHoleValueAsDoubleArray  Gets Hole value
ARNGetNumberOfDoublesPerCell  Retrieves number of doubles per data cell
ARNSetCellValueAsDoubleArray2D Sets the cell value of an ARN from a double array

ARNSetDataAsDoubleArray  Sets data into ARN double array

ARNSetHoleValueAsDoubleArray  Sets hole value

 

Multi-slice ARNs

ARNCombineIntoMultiSlice Combines one or more 2D ARNs into a single multi-slice ARN

ARNCreateSlice2DGrid Creates a new slice in an ARN with an empty data grid

ARNCreateSliceCopy Creates a copy of the active slice from one ARN and places it into a destination ARN

ARNGetActiveSlice Retrieves the active slice index from an ARN

ARNGetSliceCount Retrieves the number of slices in an ARN

ARNMoveSliceFromARN Moves the active slice from one ARN into a destination ARN

ARNRemoveSlice Removes the active slice from an ARN

ARNReorderSlices Specifies a new ordering for the slices within an ARN

ARNSetActiveSlice Specifies the slice index that should become the active slice in an ARN

ARNShuffleSliceTo Moves the active slice of an ARN to a new index position within the same ARN

 

Writing to File

ARNSaveToFITS Writes ARN data to a Flexible Image Transport System (FITS) file

ARNSaveToImage Writes ARN data to BMP, JPEG, GIF or TIFF image files

ARNSaveToVideo Writes multiple ARNs (or all all slices of a multi-slice ARN) to an output video file

ARNExportToBOVFiles Writes the cell data in a 3D Grid Wall type analysis results node to a set of BOV files

ARNExportToLMAFile Writes the cell data in a 3D Grid Wall type analysis results node to an LMA file

ARNExportToVTKFile Writes the cell data in a 3D Grid Wall type analysis results node to a VTK file

ARNWriteToFile  Writes ARN contents to FRED Grid Data file (*.fgd)
 

Back to top


Tree Operations

 

CopyEntity  Creates a copy of a given entity

DeleteEntity  Deletes the entity and its descendants recursively

Find  Finds a Source entity, Geometry entity, or Analysis Surface entity with the given base name

FindFullName  Returns id number of the entity with the given full name (unique)
FindName  Returns id number for the first entity with the given name (not unique)
FindNameNoCase  Returns id number for the first entity with the given name, irrespective of case

FindText  Searches node names/descriptions for the given text

GetChild  Returns array index of child (-1 if no child)
GetEntityCount  Returns the number of items on the object tree

GetParent  Returns array index of parent (-1 if no parent)
GetSibling  Returns array index of sibling (-1 if no sibling)
GetType  Returns the type of the entity at array index

 

Back to top


Entity Info Functions

 

FindColorScheme  Finds index of given color scheme

GetAxesDrawable  Axes drawable flag
GetColorSchemeAssignment  Gets Scolor Scheme assignment for given entity

GetColorSchemeCount  Gets Color Scheme count

GetColorSchemeName  Gets Color Scheme name

GetEntity  Gets general info
GetDescription  Description
GetFullName  Returns the full hierarchical name of an entity provided a node number
GetLimitsDrawable  Limits drawable flag
GetName  Returns the name of an entity provided a node number
GetNeverTraceable  Never traceable flag
GetTraceable  Traceable flag

InitEntity  Initializes a T_ENTITY structure with default values
IsAnalysisSurf  Returns True if the given entity is an analysis surface
IsCurve  Returns True if the given entity is a curve
IsCustomElement  Returns True if the given entity is a custom element
IsElement  Returns True if the given entity is an element
IsEntitySelected  Returns True if the given entity is selected
IsLens  Returns True if the given entity is a lens element
IsMirror  Returns True if the given entity is a mirror element
IsPrism  Returns True if the given entity is a prism element
IsSource  Returns True if the given entity is a source
IsSubassembly  Returns True if the given entity is a subassembly
IsSurface  Returns True if the given entity is a surface

ListColorSchemes  Lists all color schemes

SetColorSchemeByIndex  Sets color scheme for given entity by index

SetColorSchemeByName  Sets color scheme for given entity by name

SetDescription Sets the description of an entity
SelectEntity  Selects the entity
SetEntity  Sets general info

SetName Sets the name of an entity
SetNeverTraceable  Sets NeverTraceable flag

SetParent   Sets an entity's parent
SetTraceable  Sets traceable flag

 

Entity Arrays

DeleteEntityArray  Deletes the "array" property from the entity

GetEntityArray  Gets entity array info

InitEntityArray  Initializes a T_ENTITYARRAY structure with default values
IsEntityArray  Returns True is the given entity has been "arrayed"

SetEntityArray  Sets entity array info
 

Back to top


Rays

 

Basic Geometric Ray Handling
AddRay  Adds a geometric ray

ApplyFilterToRays Applies an array of T_RAYFILTEROP data structures to the active ray buffer

DeleteRay  Deletes a geometric ray

GetRay  Gets the n'th ray's geometric data

PrintRayFilter Prints a text summary of an array of T_RAYFILTEROP data structures to the output window or to an output text file
ReverseRay  Reverses the trajectory of a specified ray

ReverseRays  Reverses the trajectory of all active rays

SetRay  Sets the n'th ray's geometric data

 

Ray Buffer Ray Count

GetLiveRayCount  Returns the actual number of live (nonzombie/nonhole) rays in the ray buffer

GetRayCount  Returns the number of rays in the ray buffer

 

Ray Buffer Compaction

CompressRayBuffer

CompressRayBufferWithFilter

 

Ray Data Retrieval
CoherentRaySize  Gaussian beam size (e-2 power)
GetPolarization  Gets polarization state (user quantities)
GetPolarization2  Gets polarization state (intrinsic quantities)
GetRayA  Gets the n'th Ray's A direction cosine
GetRayB  Gets the n'th Ray's B direction cosine
GetRayC  Gets the n'th Ray's C direction cosine
GetRayCoherent  Gets the Ray's coherent state information
GetRayConsecutiveIntersects  Returns n'th ray's consecutive intersect count

GetRayDiffractDepth Returns the number of diffraction events that a ray has undergone
GetRayDirection  Ray direction
GetRayEntity  Ray's surface node index
GetRayEntityArrayIndices  Gets the cell array indices (if any)

GetRayIncidentOrDepartureAngle Calculates the incident or departure angle in degrees for a given ray

GetRayIncidentOrDepartureSidedness Calculates whether a ray is incident on (or departing from) the positive or negative surface normal side of its current surface

GetRayInitialPower  Returns n'th ray's starting power
GetRayIntersects  Ray total intersect count
GetRayMaterial  Ray's current material array index
GetRayOldestAncestor  The ray's original ray number

GetRayOrdinaryExtraType Returns a string indicating whether the ray is an ordinary or extraordinary ray in the context of its current immersion material
GetRayParent  Parent ray number
GetRayPath  Returns n'th ray's index into the raypath array
GetRayPathLength  Ray optical path length
GetRayPosition  Ray position
GetRayPower  Ray incoherent flux
GetRayScatterDepth  Ray's scatter ancestry depth
GetRaySource  Ray's source array index
GetRaySourceRayNumber  Returns n'th ray's ray number in the source
GetRaySpecularDepth  Ray's specular ancestry depth
GetRaySurfaceNormal Retrieves the vector normal to the last surface a particular ray touched.

GetRayWavelength  Ray wavelength (mm)

GetRayWaveVector Queries a ray for the direction components of its wave vector.
GetRayWhyFailed   Identifies the reason why a ray stopped tracing
GetRayX  Gets the n'th Ray's X coordinate
GetRayY  Gets the n'th Ray's Y coordinate
GetRayZ  Gets the n'th Ray's Z coordinate
IsCoherent  Returns True if n'th ray is coherent
IsPolarized  Returns True if n'th ray is polarized

IsRayAbsorbed  Returns True if n’th ray is an absorbed ray

IsRayActive  Returns True if n’th ray is active
IsRayLive  Returns True if n'th ray is live (not deleted and not a hole)
IsRayOnEntityArray  Returns True if n'th ray is on the cell of an entity array

RayScalarFieldAtPoint  Retrieves the real and imaginary field contributions at a given (xyz) point in space for the beamlet of a specified (base) ray

 

Ray Data Setting
SetPolarization  Sets polarization state (user quantities)
SetPolarization2  Sets polarization state (intrinsic quantities)
SetRayA  Sets the n'th Ray's A direction cosine
SetRayActive  Sets state of n’th ray’s active flag
SetRayB  Sets the n'th Ray's B direction cosine
SetRayC  Sets the n'th Ray's C direction cosine
SetRayCoherent  Sets the n'th Ray's coherence properties
SetRayDirection  Ray Direction
SetRayPathLength  Ray optical path length
SetRayPosition  Ray position
SetRayPower  Ray incoherent flux
SetRayWavelength  Ray wavelength (mm)

SetRayX  Sets the n'th Ray's X coordinate
SetRayY  Sets the n'th Ray's Y coordinate
SetRayZ  Sets the n'th Ray's Z coordinate

 

Ray History

IsRayHistory Returns a True/False indicating whether ray history information is available

RedrawRayHistory Redraws ray history for all rays meeting the supplied ray selection criteria requirements

SaveRayHistory Saves the current ray history information to a text file

 

Ray Iteration

GetFirstFilteredRay Retrieves the first ray in the buffer passing a ray selection filter criteria

GetFirstRay Ray forward iteration first position

GetLastFilteredRay Retrieves the last ray in the buffer passing a ray selection filter criteria

GetLastRay  Ray backward iteration first position
GetNextRay  Ray forward iteration
GetPreviousRay  Ray backward iteration

InitGetNextRay  Initializes index for GetNextRay (Alternative to GetFirstRay)

InitGetPreviousRay  Initializes index for GetPreviousRay (Alternative to GetLastRay)

 

Ray Status
GetRayFailCode  Returns fail code, or 0 if not failure
GetRayStatus  Gets n'th ray's status. (Advanced command)

IsInvalidCoherentRay Returns a boolean indicating whether a specific ray is valid or invalid for the purposes of coherent calculations
SetRayStatus  Sets n'th ray's status. (Advanced command)

 

Read/Write Rays to Ray Buffer

ReadBasicRayDataFromFile  Reads FCR-formatted ray files to ray buffer

ReadRaysFromFRBSFileToRayBuffer  Reads coherent/polarized rays from FRBS file

WriteBasicRayDataToFCRFile  Writes rays to FCR file format

WriteBasicRayDataToFCRFileEx Writes rays to FCR file format with options for including ray wavelengths and applying analysis entity ray filters

WriteRaysFromRayBufferToFRBSFile  Writes coherent/polarized rays to FRBS file

 

Back to top


Raypath Functions

 

ApplyFilterToRayPaths Applies a ray selection filter to the raytrace paths database, allowing identification of paths meeting the filter requirements

FindPathsContributingToArea Returns contributing raytrace path information for rays within a specified area of an analysis surface

FindPathsContributingToPolarAngularRegion Returns contributing raytrace path information for rays within a specified direction region of a directional analysis entity

IsUserDefinedRayPathMode  Returns True if access user-defined paths, return False if raytrace paths

PathAdd  Adds a user-defined path

PathAddEvent  Adds a user-defined path event

PathCount  Gets number of paths
PathDelete  Deletes path

PathDeleteAll  Deletes all paths

PathDescription  Gets path description

PathEvent  Gets all information corresponding to the path event

PathEvent2  Gets all information corresponding to the path event with additional information about diffraction events

PathEventDiffractOrder  Returns the diffraction order
PathEventCount  Number of events in path 'path'
PathEventIsAbsorb  Returns True if event is absorbing
PathEventIsChild  Returns True if event is for a generated child ray

PathEventIsDiffract  Returns True if event was a diffracted order from a grating

PathEventIsNonsequential  Returns True if event is non-sequential
PathEventIsParent  Returns True if event is for the parent ray
PathEventIsPause  Returns True if event is paused
PathEventIsReflect  Returns True if event is reflecting
PathEventIsScatter Identifies if the path event is scatter
PathEventIsSequential  Returns True if event is sequential
PathEventIsSpecular Identifies if the path event is specular
PathEventIsTransmit  Returns True if event is transmitting
PathEventItemID  Item ID in event 'event' of path 'path'

PathFilteredPaths Populates an array of ray path numbers for paths with either zero, or nonzero, Filtered Ray Count values

PathFilteredPower Returns the Filtered Power value from the specified path number

PathFilteredRayCount Returns the Filtered Ray Count value from the specified path number

PathFind  Returns index of path with the given name
PathName  Gets path name
PathPower  Total power in the path
PathRayCount  Number of rays in the path
PathScatterAncestry  Gets the scatter ancestry of the path
PathSpecularAncestry  Gets the specular ancestry of the path

ReadRaytraceRayPathsFromFile Reads raytrace ray path data from a binary file into the raytrace paths list

SaveRaytraceRayPathsToFile Saves the current raytrace paths to a binary file

SetUserDefinedRayPathMode  Sets True for user-defined path access, False (default) for raytrace paths

StrayLightReport Prints the stray light report for all paths ending on the specified entity node to either the FRED output window or a comma delimited text file

StrayLightReportByEntity Prints a compressed form of the stray light report by grouping raytrace paths according to their sequence of splitting events
 

Back to top


Elements and Subassemblies

 

 

Custom Elements

AddCustomElement   Adds a new custom element to the FRED document
GetCustomElement   Gets attributes of a custom element
SetCustomElement   Sets attributes of a custom element

 

Custom Prisms
AddCustomPrism  Adds prism
GetCustomPrism  Gets prism
InitCustomPrism  Initializes a T_PRISMCUSTOM structure with default values
SetCustomPrism  Sets prism

 

Edges and Holes (for Lenses and Mirrors only)
GetElementEdgeBevels  Gets edge
GetElementEdgeNone  Gets edge
GetElementEdgeRectangle  Gets edge
GetElementEdgeTube  Gets edge
GetElementHoleNone  Gets hole
GetElementHoleTube  Gets hole
IsElementEdgeBevels  is the element edge a beveled edge
IsElementEdgeNone   is the element edge nonexistent
IsElementEdgeRectangle  is the element edge a rectangular edge
IsElementEdgeTube  is the element edge a tubular edge
SetElementEdgeBevels  Sets edge
SetElementEdgeNone  Sets edge
SetElementEdgeRectangle  Sets edge
SetElementEdgeTube  Sets edge
SetElementHoleNone  Sets hole
SetElementHoleTube  Sets hole

 

Generic

ConvertToCustomElement  Converts an element from predefined to custom
UpdateElement  Updates the element

 

Lenses

AddLens  Adds lens element to the FRED doc
GetLens  Gets lens element from the FRED doc
GetLensBending  Gets the lens' bending parameter
GetLensCurv1  Gets the lens' first curvature
GetLensCurv2  Gets the lens' second curvature
GetLensFocalLen  Gets the lens' focal length
InitLens  Initializes a T_LENS structure with default values
SetLens  Sets lens element in the FRED doc
SetLensBending  Sets the lens' bending parameter
SetLensCurv1  Sets the lens' first curvature
SetLensCurv2  Sets the lens' second curvature
SetLensFocalLen  Sets the lens' focal length

 

Subassemblies
AddSubassembly  Adds a new subassembly to the FRED document
GetSubassembly   Gets attributes of a subassembly
SetSubassembly   Sets attributes of a subassembly

 

Mirrors
AddMirror  Adds Mirror Element to the FRED doc
GetMirror  Gets Mirror Element properties
GetMirrorCurv  Gets the Mirror Element first curvature

GetMirrorConic  Gest the Mirror Element conic constant
GetMirrorFocalLen  Gets the Mirror Element focal length
SetMirror  Sets Mirror Element properties
SetMirrorCurv  Sets the Mirror Element first curvature

SetMirrorConic  Sets the Mirror Element conic constant
SetMirrorFocalLen  Sets the Mirror Element focal length

 

Vendor Catalogs

AddCatalogLens  Adds catalog lens

AddCatalogLensReversed  Adds catalog lens with the ordering of the surfaces reversed from their catalog definition
AddCatalogPrism  Adds catalog prism

 

Back to top


Surfaces

 

Asphere
AddAsphere  Adds a standard aspheric surface
GetAsphere  Gets the attributes of a standard aspheric surface
GetAsphereEvenCoef  Returns the I'th even order coefficient of a standard asphere
GetAsphereEvenCount  Returns the number of even order coefficients of a standard aspheric surface
GetAsphereOddCoef  Returns the I'th odd order coefficient of a standard asphere
GetAsphereOddCount  Returns the number of odd order coefficients of a standard aspheric surface
SetAsphere  Sets the attributes of a standard aspheric surface
SetAsphereEvenCoef  Sets the I'th even order coefficient of a standard asphere
SetAsphereOddCoef  Sets the I'th odd order coefficient of a standard asphere

 

Auxiliary Data
AuxDataFindName Finds first surf that has given aux data name
AuxDataFindNameAndData Finds first surf that has given aux name and data

AuxDataFindNameOnSurf  Finds the given name on a specified surface

AuxDataGetCount Returns the number of auxiliary data items defined for a surface
AuxDataGetData Returns aux data value
AuxDataGetIthName Returns the i'th aux data name for a surface
AuxDataRemoveName  Removes a specific entry from the Aux Tab

AuxDataRemoveAll  Removes all entries from a specific Aux Tab

AuxDataSetData Sets aux data value

 

Bicubic Mesh (sampled)
AddSampledSurf  Adds sampled bicubic mesh surface
GetSampledSurfSize  Gets the size of a Sampled surface

GetSampledSurfValue Gets specific z-values of a Sampled Surface

GetSampledSurfXcoordinate  Gets the x-coordinate for a specified row and column
GetSampledSurfYcoordinate  Gets the y-coordinate for a specified row and column
GetSampledSurfZ  Gets z-value interpolated from mesh data
SetSampledSurfSize  Sets the size of a Sampled surface

SetSampledSurfValue  Sets specific z-values of a Sampled Surface

SetSampledSurfXcoordinate  Sets the x-coordinate for a specified row and column

SetSampledSurfYcoordinate  Sets the y-coordinate for a specified row and column

 

Coil
AddCoil Adds a Coil surface type to the document

GetCoil Retrieves the parameters for a Coil surface type

SetCoil Sets the parameters of a Coil surface type

 

Conic
AddConic  Adds a conic surface
GetConic  Gets the attributes of a conic surface
SetConic  Sets the attributes of a conic surface

 

Conic Foci
AddConicFoci  Adds a conic foci surface
GetConicFoci  Gets the attributes of a conic foci surface
InitConicFoci  Initializes a T_CONICFOCI structure with default values
SetConicFoci  Sets the attributes of a conic foci surface

 

Faceted Surface

FacetedSurfCreateFromFile Adds a new Faceted Surface from a file on disk (*.obj or *.stl)

FacetedSurfExportToObjFile Exports a Faceted Surface from the FRED model to an *.obj file on disk

FacetedSurfGetFacetCount Retrieves the number of facets defined in a Faceted Surface

FacetedSurfGetUseVertexNormals Retrieves the flag that specifies whether a Faceted Surface is using vertex normal data

FacetedSurfHasVertexNormals Retrieves the flag that indicates the presence of vertex normal data for a Faceted Surface

FacetedSurfSetFromFile Sets the faceted surface data for an existing faceted surface node using data in a file

FacetedSurfSetUseVertexNormals Sets the flag that indicates whether a Faceted Surface should use vertex normal dataGeneric

 

Generic

ChangeSurfRayColor Changes the integer RGB values for a color assigned to a specific ray color option

ChangeSurfRayColorOff  Turns off the specified ray color option

ExplicitSurfEval  Evaluates xyz point and surface normal for given surface and uv parameters

ExplicitSurfEvalUV  Evaluates xyz point and surface normal vectors in UV space for given surface and uv parameters

GetChangeSurfRayColor Retrieves the integer RGB values for a color assigned to a specific ray color option

GetSurfRayPathNode Retrieves the node ID that a surface is reporting for ray path purposes

IsChangeSurfRayColor  Determines the active state of a specific ray color setting

Sag  Computes the sag of a specified Surface entity at given local X,Y coordinates

SetSurfRayPathNode Sets the ray path node ID that a surface will report for ray path purposes for an individual surface

SetSurfRayPathNodes Sets the ray path node ID that a surface will report for ray path purposes for an array of surfaces

SetSurfsAssignCoating Assigns a coating to all surfaces of an input array or to all descended surfaces of an input array

SetSurfsAssignMaterials Assigns two materials to all surfaces of an input array or to all descended surfaces of an input array

SetSurfsAssignRaytraceCtrl Assigns a raytrace control to all surfaces of an input array or to all descended surfaces of an input array

SetSurfsAssignScatter Assigns a scatter model to all surfaces of an input array or to all descended surfaces of an input array

SetSurfsAssignSurfRough Assigns a surface roughener to all surfaces of an input array or to all descended surfaces of an input array

SetSurfsRemoveScatter Removes a scatter model from all surfaces of an input array or from all descended surfaces of an input array

 

Get / Set Materials, Coating, Raytrace Control, and Scatter
AddAllScatterProp  Adds a scatter model on all surfs descended from the given entity
AddAllScatterPropGrp  Adds a scatter model on all surfs descended from the given group entities
AddSurfScatter  Adds a scatter model to the surface
DeleteSurfIthScatter  Deletes the surface's I'th scatter model

GetSurfCoating  Returns the array index of the surface's coating
GetSurfIthScatter  Return the array index of the surface's I'th scatter model

GetSurfIthScatterActive  Returns active flag of surf's I'th scatter model
GetSurfScatterCount  Returns the number of scatter models assigned to the surface
GetSurfMaterials  Gets the array indices of the surface's two materials
GetSurfRaytraceCtrl  Returns the array index of the surface's raytrace control

SetAllCoatingProp  Sets coating on all surfs descended from the given entity
SetAllCoatingPropGrp  Sets coating on all surfs descended from the given group entities
SetAllImpSampActive  Sets all importance sample active flags on all surfs descended from the given entity
SetAllImpSampActiveGrp  Sets all importance sample active flags on all surfs descended from the given group entities
SetAllMaterialProp  Sets materials on all surfs descended from the given entity
SetAllMaterialPropGrp  Sets materials on all surfs descended from the given group entities
SetAllRaytraceControlProp  Sets raytrace control on all surfs descended from the given entity
SetAllRaytraceControlPropGrp  Sets raytrace control on all surfs descended from the given group entities
SetAllScatterActive  Sets all scatter active flags on all surfs descended from the given entity
SetAllScatterActiveGrp  Sets all scatter active flags on all surfs descended from the given group entities
SetAllSpecularProperties  Sets specular properties on all surfs descended from the given entity
SetAllSpecularPropertiesGrp  Sets specular properties on all surfs descended from the given group entities
SetSurfCoating  Sets the array index of the surface's coating
SetSurfRaytraceCtrl  Sets the array index of the surface's raytrace control
SetSurfIthScatter  Sets the array index of the surface's I'th scatter model
SetSurfIthScatterActive  Sets active flag of surf's I'th scatter model
SetSurfMaterials  Sets the array indices of the surface's two materials

 

Gluing
AddGlue  Adds a glue surf to the list
DeleteIthGlue  Deletes a glue surf from the list
GetGlueCount  Returns the number of surfaces glued to the surface 'n'
GetIthGlue  Gets a glue surf from the list
SetIthGlue  Sets a glue surf in the list

 

Implicit Script Surface
AddImplicitScriptsurf   Adds an Implicit Script Surface
GetImplicitScript  Gets the script
GetImplicitScriptSurf  Gets the attributes of an Implicit Script Surface
SetImplicitScript  Sets the script
SetImplicitScriptSurf  Sets the attributes of an Implicit Script Surface

 

Lens Module Surface
ModulePerfLensAfocalAdd Adds an afocal lens module surface to the document

ModulePerfLensAfocalGet Retrieves the properties of an afocal lens module surface

ModulePerfLensAfocalSet Sets the properties of an afocal lens module surface

ModulePerfLensFiniteAdd Adds a finite conjugate lens module surface to the document

ModulePerfLensFiniteGet Retrieves the properties of a finite conjugate lens module surface

ModulePerfLensFiniteSet Sets the properties of a finite conjugate lens module surface

ModulePerfLensInfiniteAdd Adds an infinite conjugate lens module surface to the document

ModulePerfLensInfiniteGet Retrieves the properties of an infinite conjugate lens module surface

ModulePerfLensInfiniteSet Sets the properties of an infinite conjugate lens module surface

ModulePerfSurfInfiniteAdd Adds a new surface module surface type to the document

ModulePerfSurfInfiniteGet Retrieves the properties of a surface module surface type

ModulePerfSurfInfiniteSet Sets the properties of a surface module surface type

ModuleSphereSurfAdd Adds a spherical surface lens module to the document

ModuleSphereSurfGet Retrieves the properties of a spherical surface lens module

ModuleSphereSurfSet Sets the properties of a spherical surface lens module

 

Modifiers - Retro-Reflection

GetRetroReflect   Gets the retro-reflect attributes of a surface

SetRetroReflect   Sets the retro-reflect attributes of a surface

 

Modifiers - Surface Deformation

GetSurfDeform    Gets the attributes of a deformed surface

GetSurfDeformFlag    Sets enable/disable flag for surface deformation

GetSurfDeformSurf    Gets the node number of a deforming surface

GetSurfDeformScale    Gets the scale factor imposed on a deforming surface

GetSurfDeformInBaseCoordSysFlag    Gets the Base Coordinate System setting on a deformed surface

SetSurfDeform    Sets the attributes of a deformed surface

SetSurfDeformFlag    Sets enable/disable flag for surface deformation

 

Modifiers - Surface Roughness

ApplySurfRoughToSurface Applies a surface roughness node to a surface

RetrieveSurfRoughFromSurface Retrieves the node number of the surface roughness model assigned to a surface

 

NURB Surface
AddNURBSurf  Adds a NURB surface
GetNURBSurf  Gets a NURB surface

GetNURBSurfControlPt  Gets a control point from a NURB surface using linear indexing (as seen in the GUI dialog)

GetNURBSurfControlPtCount  Gets the number of control points from a NURB surface

GetNURBSurfControlPt2  Gets a control point from a NURB surface using u,v indexing (as seen in the GUI dialog)

GetNURBSurfControlPtCount2  Gets the number of control points from a NURB surface along the u,v axes of the control point array

GetNURBSurfParameterLimits  Gets the min/max parameter values
SetNURBSurf  Sets a NURB surface

SetNURBSurfControlPt  Sets a control point for a NURB surface using linear indexing (as seen in the GUI dialog)

SetNURBSurfControlPt2  Sets a control point for a NURB surface using u,v indexing (as seen in the GUI dialog)
SetNURBSurfParameterLimits  Sets the min/max parameter values

 

Patch Box Settings (explicit surfaces only)
GetPatchBoxDrawFlag    Gets an explicit surface's patch box draw flag

GetPatchBoxGranularityU    Gets an explicit surface's patch box sampling granularity in the U direction
GetPatchBoxGranularityV    Gets an explicit surface's patch box sampling granularity in the V direction
SetPatchBoxDrawFlag    Sets an explicit surface's patch box draw flag
SetPatchBoxGranularityU    Sets an explicit surface's patch box sampling granularity in the U direction
SetPatchBoxGranularityV    Sets an explicit surface's patch box sampling granularity in the V direction

 

Plane
AddPlane  Adds a plane surface
GetPlane  Gets the attributes of a plane surface
SetPlane  Sets the attributes of a plane surface

 

Polynomial Asphere
AddPolynomialAsphere  Adds a conic surface with XY polynomial terms
GetPolynomialAsphere  Gets the attributes of a conic surface with XY polynomial terms
GetPolynomialAsphereCoefCount  Returns the number of coefficients in an XY polynomial surface
GetPolynomialAsphereCoefIJ  Returns the coefficient of the X^i*Y^j term of a polynomial surface
GetPolynomialAsphereIthCoef  Returns the I'th coefficient in an XY polynomial surface
SetPolynomialAsphere  Sets the attributes of a conic surface with XY polynomial terms
SetPolynomialAsphereCoefIJ  Sets the coefficient of the X^i*Y^j term of a polynomial surface
SetPolynomialAsphereIthCoef  Sets the I'th coefficient in an XY polynomial surface

 

Polynomial Surface
AddPolynomialSurf  Adds a general XYZ polynomial surface
GetPolynomialSurf  Gets the attributes of a general XYZ polynomial surface
GetPolynomialSurfCoefCount  Returns the number of coefficients of a general XYZ polynomial surface
GetPolynomialSurfCoefIJK  Returns the coefficient of the X^i*Y^j*Z^k term of a general XYZ polynomial surface
GetPolynomialSurfIthCoef  Returns the I'th coefficient of a general XYZ polynomial surface
SetPolynomialSurf  Sets the attributes of a general XYZ polynomial surface
SetPolynomialSurfCoefIJK  Sets the coefficient of the X^i*Y^j*Z^k term of a general XYZ polynomial surface
SetPolynomialSurfIthCoef  Sets the I'th coefficient of a general XYZ polynomial surface

 

QBfs Polynomial Surface

AddQBfsSurf Adds a QBfs type Forbes polynomial surface to the document

GetQBfsSurf Retrieves the parameters from a QBfs type Forbes polynomial surface

GetQbfsSurfForm Retrieves the surface form specification from a Qbfs type Forbes polynomial surface

GetQBfsSurfIthCoef Retrieves the coefficient value of the i'th aspheric term

SetQBfsSurf Sets the parameters for a QBfs type Forbes polynomial surface

SetQbfsSurfForm Sets the surface form specification for a Qbfs type Forbes polynomial surface

SetQBfsSurfIthCoef Sets the i'th aspheric term coefficient value

 

QCon Polynomial Surface

AddQConSurf Adds a QCon type Forbes polynomial surface to the document

GetQConSurf Retrieves the parameters from a QCon type Forbes polynomial surface

GetQConSurfIthCoef Retrieves the coefficient value of the i'th aspheric term

SetQConSurf Sets the parameters for a QCon type Forbes polynomial surface

SetQConSurfIthCoef Sets the i'th aspheric term coefficient value

 

Revolve Surface
AddRevolveSurf  Adds a surface of revolution
GetRevolveSurf  Gets the attributes of a surface of revolution
InitRevolveSurf  Initializes a T_REVOLVESURF structure with default values
SetRevolveSurf  Sets the attributes of a surface of revolution

 

Ruled Surface
AddRuledSurf  Adds a ruled surface
GetRuledSurf  Gets the attributes of a ruled surface
SetRuledSurf  Sets the attributes of a ruled surface

 

Remove / Toggle Materials, Coating, Raytrace Control, and Scatter
RemoveAllScatterProp  Removes all scatter models on all surfs descended from the given entity
RemoveAllImpSampProp  Removes all importance samples on all surfs descended from the given entity
RemoveAllScatterPropGrp  Removes all scatter models on all surfs descended from the given group entities
RemoveAllImpSampPropGrp  Removes all importance samples on all surfs descended from the given group entities

ToggleAllScatterActive  Toggles all scatter active flags on all surfs descended from the given entity
ToggleAllScatterActiveGrp  Toggles all scatter active flags on all surfs descended from the given group entities
ToggleAllImpSampActive  Toggles all importance sample active flags on all surfs descended from the given entity
ToggleAllImpSampActiveGrp  Toggles all importance sample active flags on all surfs descended from the given group entities

 

Spline Surface
AddSplineSurf  Adds a spline surface
GetSplineSurf  Gets a spline surface
SetSplineSurf  Sets a spline surface

 

Super-Gaussians Superposition Surface

SGSurfAdd Adds a Super-gaussians superposition surface

SGSFindTermIndexFromName Retrieves the index value for an SGS surface term provided a string name

SGSurfGetTermCount Retrieves the number of terms in an SGS surface's term list

SGSurfGetIthTermData Retrieves the parameter values for the I'th term of an SGS surface

SGSurfGetIthTermName Retrieves the parameter name for the I'th term of an SGS surface

SGSurfSetTermCount Sets the maximum term count

SGSurfSetIthTermData Sets the parameters for the I'th term in the term list

SGSurfSetIthTermName Sets the name parameter for the I'th term in the term list

 

Tabulated Cylinder
AddTabulatedCylinder  Adds a tabulated cylinder surface
GetTabulatedCylinder  Gets the attributes of a tabulated cylinder surface
SetTabulatedCylinder  Sets the attributes of a tabulated cylinder surface

 

Toroidal Asphere
AddToroidalAsphere  Adds a toroidal aspheric surface
GetToroidalAsphere  Gets the attributes of a toroidal aspheric surface
GetToroidalAsphereCoefCount  Returns the number of aspheric coefficients of a toroidal aspheric surface
GetToroidalAsphereIthCoefs  Gets the A,B coefficients of the Ith term of a toroidal aspheric surface

InitToroidalAsphere  Initializes a T_TOROIDALASPHERE structure with default values
SetToroidalAsphere  Sets the attributes of a toroidal aspheric surface
SetToroidalAsphereIthCoefs  Sets the A,B coefficients of the Ith term of a toroidal aspheric surface

 

Trimmed Parametric
AddTrimmedParametric  Adds a trimmed parametric surface

ChangeTrimmedParametricCompactState Sets the view state for a trimmed parametric surface (compact or expanded)
GetTrimmedParametric  Gets the attributes of a trimmed parametric surface
SetTrimmedParametric  Sets the attributes of a trimmed parametric surface

 

Trimming

GetDotProdSurfTrim Retrieves the advanced dot-product surface trimming specification from a surface node (Faceted Surface excluded)

GetTrimmingSpec  Gets trimming specification
GetTrimVol  Shorthand version of the GetTrimVolume command
GetTrimVolHole  Shorthand to set trimming volume hole

GetTrimVolMinMax  Shorthand to get trimming volume
GetTrimVolume  Gets a surface's trimming volume attributes

SetDotProdSurfTrim Sets the advanced dot-product surface trimming specification for a surface node (Faceted Surface excluded)
SetTrimmingSpec  Sets trimming specification
SetTrimVol  Shorthand to set trimming volume
SetTrimVolHole  Shorthand to set trimming volume hole

SetTrimVolMinMax  Shorthand to set trimming volume

SetTrimVolume  Sets a surface's trimming volume attributes

 

Tube
AddTube  Adds a tube (cylinder) surface
GetTube  Gets the attributes of a tube (cylinder) surface
InitTube  Initializes a T_TUBE structure with default values
SetTube  Sets the attributes of a tube (cylinder) surface

 

Visualization
GetSurfVisualize  Retrieves the visualization attributes from a surface
InitSurfVisualize  Initializes T_SURFVISUALIZE structure with default values
ListColorSchemes  Lists all color schemes

SetAxesDrawable Sets an entity's coordinate axes draw flag

SetColorSchemeByIndex  Sets color scheme for given entity by index

SetColorSchemeByName  Sets color scheme for given entity by name

SetLimitsDrawable Sets an entity's global trimming volume draw flag

SetSurfVisualize  Sets the visualization attributes of a surface

 

XYToroidal Asphere
AddXYToroidalAsphere  Adds an XY toroidal aspheric surface
GetXYToroidalAsphere  Gets the attributes of an XY toroidal aspheric surface
GetXYToroidalAsphereCoefCount  Returns the number of aspheric coefficients of an XY toroidal aspheric surface
GetXYToroidalAsphereIthCoef  Gets the I'th coefficient of an XY toroidal aspheric surface
GetXYToroidalAsphereType  Gets the toroid type X or Y
SetXYToroidalAsphere  Sets the attributes of an XY toroidal aspheric surface
SetXYToroidalAsphereIthCoef  Sets the I'th coefficient of an XY toroidal aspheric surface

SetXYToroidalAsphereType  Sets the toroid type as X or Y

 

Zernike Surface
AddZernikeSurf  Adds a Zernike polynomial surface
GetZernikeSurf  Gets the attributes of a Zernike polynomial surface
GetZernikeSurfAsphCoefCount  Gets the number of aspheric coefficients for a zernike surface
GetZernikeSurfIthAsphTermText  Gets the text description associated with a given aspheric term for a zernike surface
GetZernikeSurfBaseConic  Gets base conic parameters for a Zernike surface
GetZernikeSurfCoefCount  Returns the number of coefficients of a Zernike polynomial surface
GetZernikeSurfCoefInterpretation  Gets interpretation of zernike coefficients

GetZernikeSurfIthAsphCoef  Gets the I'th aspheric coefficient for a Zernike surface
GetZernikeSurfIthCoef  Returns the I'th coefficient of a Zernike polynomial surface
GetZernikeSurfIthTermText  Gets text for functional form of I'th coefficient of Zernike surface

GetZernikeSurfOffaxisAngle  Gets the off-axis angle applied to a Zernike surface

GetZernikeSurfXoffset  Gets the X offset (decenter) applied to a Zernike surface

GetZernikeSurfYoffset  Gets the Y offset (decenter) applied to a Zernike surface

SetZernikeSurf  Sets the attributes of a Zernike polynomial surface
SetZernikeSurfBaseConic  Sets base conic parameters for a Zernike surface
SetZernikeSurfCoefInterpretation  Sets the interpretation of Zernike coefficients
SetZernikeSurfIthAsphCoef  Sets the I'th aspheric coefficient for a Zernike surface
SetZernikeSurfIthCoef  Sets the I'th coefficient of a Zernike polynomial surface

SetZernikeSurfOffaxisAngle  Sets the off-axis angle of the Zernike surface

SetZernikeSurfOffsets  Sets the X and Y offsets (decenters) for a Zernike surface

 

Back to top


Curves

 

Aperture Collection Curve
AddApertureCurve  Adds a collection of curves used to trim a surface
GetApertureCurve  Gets the attributes of a collection of curves used to trim a surface

GetApertureCurveAlgorithm Gets the algorithm being used for the logical interpretation of the aperture curve members
GetApertureCurveOpCount  Returns the number of curves in the collection
GetApertureCurveProjection  Gets the curve projection type
SetApertureCurve  Sets the attributes of a collection of curves used to trim a surface

SetApertureCurveAlgorithm Sets the algorithm for the logical interpretation of the aperture curve members
SetApertureCurveProjection  Sets the curve projection type
 

Circular Arc
AddCircularArc  Adds a circular arc curve
GetCircularArc  Gets the attributes of a circular arc curve
InitCircularArc  Initializes a T_CIRCULARARC structure with default values
SetCircularArc  Sets the attributes of a circular arc curve

 

Composite Curve
AddCompositeCurve  Adds a composite curve consisting of other curves
GetCompositeCurve  Gets the attributes of a composite curve consisting of other curves
SetCompositeCurve  Sets the attributes of a composite curve consisting of other curves
 

Conic Arc
AddConicArc  Adds a conic arc curve
GetConicArc  Gets the attributes of a conic arc curve
InitConicArc  Initializes a T_CONICARC structure with default values
SetConicArc  Sets the attributes of a conic arc curve

 

General
CurveEval  Evaluates xyz point and tangent vector for specified curve and u-parameter

GetCurveBasicInfo  Gets the basic information about a curve
SetCurveBasicInfo  Sets the basic information about a curve

 

Line Segment
AddLine  Adds a straight line curve
GetLine  Gets the attributes of a straight line curve
InitLine  Initializes a T_LINE structure with default values
SetLine  Sets the attributes of a straight line curve

 

NURB Curve
AddNURBCurve Adds a Non-Uniform Rational B-spline curve to the system
GetNURBCurve Gets a Non-Uniform Rational B-spline curve from the system

GetNURBCurveControlPt Retrieves the x,y,z position and weight for a specific control point in a NURB curve

GetNURBCurveControlPtCount Retrieves the number of control points in a NURB curve definition

GetNURBCurvParameterLimits Gets the NURB curve's parameter limits

SetNURBCurve Sets a Non-Uniform Rational B-spline curve in the system

SetNURBCurveControlPt Sets the x,y,z position and weight for a specific control point in a NURB curve
SetNURBCurvParameterLimits Sets the NURB curve's parameter limits

 

Racetrack Curve

AddRacetrackCurve  Adds a Racetrack curve to the system
GetRacetrackCurve  Gets a Racetrack curve from the system
SetRacetrackCurve  Sets a Racetrack curve in the system
 

Segmented Curve
AddSegmentedCurve  Adds a curve consisting of straight line segments
GetSegmentedCurve  Gets the attributes of a curve consisting of straight line segments
GetSegmentedCurveSegCount  Returns the number of segments
SetSegmentedCurve  Sets the attributes of a curve of straight line segments

 

Spline Curve
AddSplineCurve  Adds a spline curve
GetSplineCurve  Gets the attributes of a spline curve
SetSplineCurve  Sets the attributes of a spline curve

 

Back to top


Detailed Sources

 

Acceptance Filters
AddSrcAcceptanceRegionFunction Adds a new Acceptance Filter region to a source node and returns the index number of the Acceptance Filter that was added

DeleteSrcNthAcceptanceRegion Deletes the N’th Acceptance Filter region from a source node

GetSrcAcceptanceRegionCount Queries a source node for the number of Acceptance Filter regions defined

GetSrcNthAcceptanceRegion Retrieves the parameters of the N’th Acceptance Filter region from a designated source and stores them in a T_ACCEPTANCE_FILTER data structure

InitAcceptanceFilter Initializes the members of a T_ACCEPTANCE_FILTER data structure to default values

IsAcceptanceFilterActiveFunction Queries a source node and returns the state of its Acceptance Filter flag

SetAcceptanceFilterActiveFlag  Sets the Active flag state for the Acceptance Filter settings of a designated source node

SetSrcNthAcceptanceRegion Updates the parameters of an existing Acceptance Filter region of a source

 

Apodization Function Information

GetSourceDirApodFuncType  Direction apodization function name

GetSourceDirFuncType  Direction function name
GetSourcePosApodFuncType  Position apodiziation function name
GetSourcePosFuncType  Position function name

 

Coherence
GetSourceBeamOverlap  Gets Gaussian beam overlap
GetSourceCoherence  Gets coherent or not

GetSourceCoherentGridScale Gets the relative scale factors on the size of the internal irradiance grid used for determining coherent source flux

GetSourceCoherentPowerSampling  Gets the number of divisions in power sampling grid
GetSourceSecondaryRayCount  Gets number of parabasal rays
GetSourceSecondaryRayScale  Gets parabasal ray scale factor
IsSourceCoherent  Returns True if source is coherent
SetSourceBeamOverlap  Sets Gaussian beam overlap
SetSourceCoherence  Sets coherent or not

SetSourceCoherentGridScale Sets the relative scale factors on the size of the internal irradiance grid used for determining coherent source flux

SetSourceCoherentPowerSampling  Sets the number of divisions in power sampling grid
SetSourceSecondaryRayCount  Sets number of parabasal rays
SetSourceSecondaryRayScale  Sets parabasal ray scale factor

 

Directional power apodization functions
Gaussian

GetSourceDirApodGaussian  Gets the exponent and semi-angles

IsSourceDirApodGaussian  Returns True if source direction apodization function is Gaussian

SetSourceDirApodGaussian  Sets the exponent and semi-angles for Directional Apodization
 

Inverse Lambertian

GetSourceDirApodIsotropic  Gets source isotropic direction apodization information

IsSourceDirApodIsotropic  Returns True if source direction apodization function is Isotropic
SetSourceDirApodIsotropic  Sets source direction apodization to Isotropic
 

Lambertian

GetSourceDirApodLambertian  Gets source Lambertian direction apodization

IsSourceDirApodLambertian  Returns True if source direction apodization function is Lambertian
SetSourceDirApodLambertian  Sets source direction apodization to Lambertian
 

Sampled as a Function of Spherical Angles

GetSourceDirApodSampled  Gets source sampled direction apodization
IsSourceDirApodSampled  Returns True if source direction apodization function is sampled
SetSourceDirApodSampled  Sets source direction apodization to sampled
SetSourceDirApodSampledImportFile Sets a source's direction apodization to sampled and populate the attributes of the sampling from a file

 

Cos^n or Sin^n in a Given Direction

GetSourceDirApodSinCos  Gets source sin/cos direction apodization

IsSourceDirApodSinCos  Returns True if source direction apodization function is sin/cos raised to a power

SetSourceDirApodSinCos  Sets source direction apodization to sin/cos
 

Super Gaussian

GetSourceDirApodSuperGaussian Gets a source's Super Gaussian direction apodization specification

IsSourceDirApodSuperGaussian Returns True if a source's direction apodization function is Super Gaussian

SetSourceDirApodSuperGaussian Sets a source's Super Gaussian direction apodization specification

 

Uniform

IsSourceDirApodUniform  Returns True if source direction apodization function is uniform

SetSourceDirApodUniform  Sets source direction apodization to uniform

 

Ray Direction Functions
Single Direction (plane wave)

GetSourceDirection  Gets ray direction from a source with a single direction plane wave specification

IsSourceDirection  Determines if source has the "Single direction (plane wave)" ray direction type

SetSourceDirection  Set ray direction for a source with a single direction plane wave specification

 

Random Directions Into an Angular Range

GetSourceDirRange  Retrieves the ray direction data from a source with a "Ray directions into an angular range" type

IsSourceDirRange  Determines if a source has the "Random directions into an angular range" ray direction type

SetSourceDirRange  Sets the ray direction data for a source with the "Ray directions into an angular range" type

 

Random Directions Into a Sphere

GetSourceDirSphere  Retrieves the number of random directions from a source with a "Random directions into sphere" specification

IsSourceDirSphere  Determines if a source has the "Random directions into a sphere" ray direction type

SetSourceDirSphere  Sets the number of random directions for a source with the "Random directions into sphere" specification

 

Focus to/from a Point

GetSourceDirFocus  Retrieves ray direction data from a source with a Focus to/from a point specification

IsSourceDirFocus  Determines if a source has "Focus to/from a point" ray direction type

SetSourceDirFocus  Sets ray direction data for a source with a Focus to/from a point specification
 

Directions to Rectilinear Grid Points

GetSourceDirPositionGrid  Retrieves the ray direction data from a source with a rectilinear grid point ray direction type

IsSourceDirPositionGrid  Determines if the source has "Directions to rectilinear grid points" ray direction type
SetSourceDirPositionGrid  Sets the ray direction data for a source with the rectilinear grid point ray direction type

 

Directions to Hexagonal Grid Points in Angle Space

GetSourceDirGridHex  Retrieves ray direction data from a source with a hexagonal grid points in angle space specification

IsSourceDirGridHex  Determines if a source has the "Directions to hexagonal grid points in angle space" ray direction type

SetSourceDirGridHex  Sets ray direction data for a source with a hexagonal grid points in angle space specification

 

Focus to/from two astigmatic focii

GetSourceDirAstigmaticFocii Retrieves the ray direction specification from a source with the focus to/from astigmatic focii specification

IsSourceDirAstigmaticFocii Queries a source node to determine whether its ray direction specification is the focus to/from astigmatic focii type

SetSourceDirAstigmaticFocii Sets the ray direction specification for a source with the focus to/from astigmatic focii specification

 

Astigmatic Gaussian Beam

GetSourceDirAstigmaticGausBeam Retrieves astigmatic Gaussian beam data from a source

InitSourceDirAstigmaticGausBeam Initializes a T_SOURCEDIRASTIGGAUSBEAM structure with default values

IsSourceDirAstigmaticGausBeam Determines if a specified source direction is an astigmatic Gaussian beam

SetSourceDirAstigmaticGausBeam Sets the astigmatic Gaussian beam data for a source

 

Multiple Source Angles (plane waves)

AddSourceDirIthMultiAngle  Adds an angle specification for a source with the "Multiple source angles (plane waves)"

DeleteSourceDirIthMultiAngle Deletes the i'th angle from a multi-angle directional source

GetSourceDirIthMultiAngle  Retrieves i'th angle from a multi-angle source

GetSourceDirIthMultiAngleActive  Retrieves i'th angle activity state from a multi-angle source

GetSourceDirMultiAngleCount  Retrieves the number of angles in a multi-angle source

InsertSourceDirIthMultiAngle Inserts an angle specification for a source with the "Multiple source angles (plane waves)"

IsSourceDirMultiAngle  Determines if the source direction function is multi-angle plane waves
SetSourceDirIthMultiAngle  Sets the i'th angle for a multi-angle source

SetSourceDirIthMultiAngleActive  Sets the i'th angle activity state for a multi-angle source
SetSourceDirMultiAngle  Sets the source ray direction specification to be type "Multiple source angles (plane waves)"

 

Multiple Source Positions

AddSourceDirIthMultiPos  Adds a position to a multi-position source

DeleteSourceDirIthMultiPos Deletes the i'th position specification from a multiple-position directional source

GetSourceDirIthMultiPos  Retrieves i'th position for a multi-position source

GetSourceDirIthMultiPosActive  Retrieves the i'th position activity state from a multi-position source

GetSourceDirMultiPosCount  Retrieves the number of positions in a multi-position source

InsertSourceDirIthMultiPos Inserts a position specification for a source with the ray direction type, "Multiple source positions"

IsSourceDirMultiPos  Determines if the source direction function is multi-positional
SetSourceDirIthMultiPos  Sets the i'th position for a multi-position source

SetSourceDirIthMultiPosActive  Sets the i'th position activity state for a multi-position source

SetSourceDirMultiPos  Declares the source direction function to be multi-positional
 

Randomly According to Intensity Distribution

GetSourceDirSampledPolar Retrieves attributes of the source's "Random according to intensity distribution" ray direction type

IsSourceDirSampledPolar Determines if a source has the "Random according to intensity distribution" ray direction type
SetSourceDirSampledPolar Sets attributes of the source's "Random according to intensity distribution" ray direction specification

SetSourceDirSampledPolarImportFile Sets the source ray direction to "Randomly according to intensity distribution", specifies the polar and azimuthal axis reference vectors, and populates the intensity table with data from a file

SetSourceDirSampledPolarImportFGDFile Sets the source ray direction to "Randomly according to intensity distribution", specifies the polar and azimuthal axis reference vectors, and populates the intensity table with data from a FGD file

 

Laser Diode Beam

GetSourceDirLaserDiode Retrieves the ray direction data from a source with the "Laser Diode Beam" ray direction type

InitSourceDirLaserDiode Initializes a T_SOURCEDIRLASERDIODE structure with default values

IsSourceDirLaserDiode Determines if a source has the "Laser Diode Beam" ray direction type

SetSourceDirLaserDiode Sets the ray direction data for a source with ray direction type type "Laser Diode Beam"

 

M-Squared Laser Beam

GetSourceDirM2Laser Retrieves the ray direction specification from a source with the "M Squared Laser Beam" ray direction type

InitSourceDirM2Laser Initializes a T_SOURCEDIRM2LASER structure with default values

IsSourceDirM2Laser Determines if a source has the "M Squared Laser Beam" ray direction type
SetSourceDirM2Laser Sets the ray direction specification for a source with ray direction type "M Squared Laser Beam"

 

Miscellaneous
AddSource  Adds default detailed source node to the FRED document

ReadRayFile  Reads ray text file into source of type ray-file

 

Polarization
GetSourcePolarization  Gets polarization properties
IsSourcePolarized  Returns True if source is polarized
SetSourcePolarization  Sets polarization properties

 

Position Power Apodization Functions
Uniform

IsSourcePosApodUniform  Returns True if source position apodization function is Uniform (i.e. no apodization)
SetSourcePosApodUniform  Sets source position apodization to Uniform (i.e. no apodization)

 

Gaussian Apodization

GetSourcePosApodGaussian  Gets source Gaussian position apodization

GetSourcePosApodGaussianExponent  Gets the Gaussian exponent for Position Apodization
GetSourcePosApodGaussianMode  Gets higher order TEMnm Gaussian mode information
IsSourcePosApodGaussian  Returns True if source position apodization function is Gaussian
SetSourcePosApodGaussian  Sets source position apodization function to Gaussian
SetSourcePosApodGaussianExponent  Sets the Gaussian exponent for Position Apodization

SetSourcePosApodGaussianMode  Sets higher order TEMnm Gaussian mode information
 

R^n Distance Apodization From a Given Point

GetSourcePosApodLength  Gets source position apodization length data

IsSourcePosApodLength  Returns True if source position apodization function is length raised to a power
SetSourcePosApodLength  Sets source position apodization length data
 

Amplitude/Phase Mask on Rectilinear Grid

GetSourcePosApodSamp  Gets source position apodization sampled parameter data
GetSourcePosApodSampBotVal  Gets a specific cell bottom value given by (row, col)

GetSourcePosApodSampTopVal  Gets a specific cell top value given by (row, col)

InitSourcePosApodSamp  Initializes T_SOURCEPOSAPODSAMPLED structure with default values
IsSourcePosApodSamp  Returns True if source position apodization function is sampled

SetSourcePosApodSamp  Sets source position apodization to sampled
SetSourcePosApodSampBotVal  Sets value of a specific bottom cell given by (row,col)
SetSourcePosApodSampBotVals  Sets values of all bottom cells
SetSourcePosApodSampExtents  Sets sample array extents data
SetSourcePosApodSampTopVal  Sets value of a specific top cell given by (row,col)
SetSourcePosApodSampTopVals  Sets values of all top cells

 

Super Gaussian Apodization

GetSourcePosApodSuperGaussian Retrieves the width and offset values from a source with the Super Gaussian position apodization

GetSourcePosApodSuperGaussianExponent Retrieves the exponent values from a source with the Super Gaussian position apodization

GetSourcePosApodSuperGaussianMode Retrieves the mode type from a source with the Super Gaussian position apodization
IsSourcePosApodSuperGaussian Returns True if a source is using the Super Gaussian position apodization function
SetSourcePosApodSuperGaussian Sets the width and offset values for a source with the Super Gaussian position apodization

SetSourcePosApodSuperGaussianExponent Sets the exponent values for a source with the Super Gaussian position apodization

SetSourcePosApodSuperGaussianMode Sets the mode type for a source with the Super Gaussian position apodization

 

Ray Position Functions

Grid Plane (rectilinear array of points arranged on a plane)

GetSourcePosGrid  Gets source grid plane position specification
IsSourcePosGrid  Returns True if source position function is grid plane
SetSourcePosGrid  Sets source position function to grid plane
 

Random Plane (random points arranged on a plane)

GetSourcePosGridRandom  Gets source random grid position specification

GetSourcePosGridRandomHoleSemiWidth  Gets source random grid position X and Y hole semi-widths
IsSourcePosGridRandom  Returns True if source position function is grid random
SetSourcePosGridRandom  Sets source position function to random grid

SetSourcePosGridRandomHoleSemiWidth  Sets random grid position function hole X and Y semi-widths
 

Random Volume (random points arranged in a volume)

GetSourcePosVolumeRandom  Gets source random volume position specification
IsSourcePosVolumeRandom  Returns True if source position function is random volume
SetSourcePosVolumeRandom  Sets source position function to random volume

 

Random String (random points arranged in a character or string)

GetSourcePosCharacters  Gets source characters position specification
IsSourcePosCharacters  Returns True if source position function is characters
SetSourcePosCharacters  Sets source position function to characters
 

Random Surface (random points on a designated surface)

GetSourcePosSurface  Gets source surface position specification
IsSourcePosSurface  Returns True if source position function is surface
SetSourcePosSurface  Sets source position function to surface
 

Read Rays from a File and Generate Dynamically

GetSourcePosImported  Gets the filename and parameters of an Imported Rayfile source

GetSourcePosImportedFileIsValid  Checks validity of imported rayfile

GetSourcePosImportedUseWavelengthsFromFile Retrieves the wavelength generation flag from an imported rayfile source

IsSourcePosImported  Returns True if source position function is Imported Rayfile

SetSourcePosImported  Sets filename and parameters of Imported Rayfile source

SetSourcePosImportedUseWavelengthsFromFile Sets the wavelength generation method flag for an imported rayfile source

 

Hexagonal Plane (hexagonal array of points arranged on a plane)

GetSourcePosGridHex  Gets source hex grid position specification

IsSourcePosGridHex  Returns True if source position function is grid hex
SetSourcePosGridHex  Sets source position function to hex grid
 

Bitmap (points specified by bitmap pixels)

GetSourcePosBitmap  Gets source bitmap position specification

IsSourcePosBitmap  Returns True if source position function is bitmap
SetSourcePosBitmap  Sets source position function to bitmap
 

User-defined Rays (manually defined)

AddSourceUserRay  Appends one user ray
AddSourceUserRays  Appends array of user rays
DeleteSourceIthUserRay  Deletes i'th user ray
DeleteSourceUserRays  Deletes 'count' user rays starting at the i'th ray

GetSourceIthUserRay  Gets the i'th user ray
GetSourceUserRayCount  Gets the number of user rays defined in a source
IsSourcePosUser  Returns True if source position function is user defined rays
ReadSourceUserRays  Reads complete ray file into a source
ReadSourceUserRays2  Reads all or a subset of rays from a ray file into a source
SetSourceIthUserRay  Sets i'th user ray

SetSourcePosUser  Sets source's position function to general

 

Pre-propagation Specifications

GetSourceMaterial  Gets source immersion material
GetSourcePhase  Gets additional phase in waves
GetSourcePower  Gets source power
GetSourcePropagationSpec  Gets post-creation propagation
SetSourceMaterial  Sets source immersion material
SetSourcePhase  Sets additional phase in waves
SetSourcePower  Sets source power
SetSourcePropagationSpec  Sets post-creation propagation

 

Visualization
GetSourceVisualization  Gets visualization properties
SetSourceVisualization  Sets visualization properties

 

Wavelengths
AddSourceWavelengthSpec  Adds a wavelength spec
DeleteSourceIthWavelengthSpec  Deletes i'th wavelength spec
GetSourceIthWavelength  Gets i'th wavelength
GetSourceIthWavelengthActive  Gets the active flag for a source wavelength

GetSourceIthWavelengthSpec  Gets i'th wavelength spec

GetSourceWavelengthCount  Returns number of wavelengths
GetSourcePowerUnits Gets the power units of the source

GetSourceRayWavelengthMethod Gets the method of ray wavelength generation for the source

GetSourceRayWavelengthRange Gets the range of wavelengths being generated when using "Random according to spectrum"

GetSourceSpectrum Gets the spectrum being used by the source

SetSourceIthWavelengthActive  Sets the active flag for a source wavelength

SetSourceIthWavelengthSpec  Sets i'th wavelength spec

SetSourcePowerUnits Sets the power units of the source

SetSourceRayWavelengthMethod Sets the ray wavelength generation method of the source

SetSourceRayWavelengthRange Sets the range of wavelengths when using "Random according to spectrum"

SetSourceSpectrum Sets the spectrum being used by the source

 

Back to top


Source Primitives

Generic Source Primitive Commands

AddSourcePrim  Adds a Source Primitive node of the requested type to the document

SourcePrimConvertToDetailed Converts a Source Primitive node to a Detailed Source node

SourcePrimGetDrawColor Retrieves the R,G,B draw color integers from a Source Primitive

SourcePrimGetTypeSource Query a source node to retrieve its Source Primitive type

SourcePrimGetParmCount Retrieves the number of construction parameters in a Source Primitive node

SourcePrimGetParmDescription Retrieves the description string for a specific parameter of a Source Primitive node

SourcePrimGetParmValue Retrieves the value of a specific parameter of a Source Primitive

SourcePrimGetWavelSingle Retrieves the wavelength value from a Source Primitive using the Single wavelength type

SourcePrimGetWavelSpectCount Retrieves the number of options for wavelength specification (Single, List, etc.) supported by a Source Primitive

SourcePrimGetWavelSpectType Given an index into the list of supported wavelength specification options, retrieve the corresponding string type (Single, List, etc.)

SourcePrimGetWavelSpectValue Retrieves the string form of the wavelength type specification from a Source Primitive node

SourcePrimSetDrawColor Sets the draw color for a Source Primitive using R,G,B integers

SourcePrimSetParmValue Sets the value of a specific construction parameter of a Source Primitive node

SourcePrimSetWavelSingle Sets the wavelength value for a Source Primitive using the Single wavelength option

SourcePrimSetWavelSpectValue Sets the wavelength option being used by a Source Primitive node

 

Point Source (coherent) Commands

SourcePrimGetParmPtSrcCohList Retrieves the configuration parameters from a Point Source (coherent) type Source Primitive node that uses the List wavelength option

SourcePrimGetParmPtSrcCohSingle Retrieves the configuration parameters from a Point Source (coherent) type Source Primitive node that uses the Single wavelength option

SourcePrimSetParmPtSrcCohList Sets the configuration parameters for a Point Source (coherent) type Source Primitive node using the List wavelength option

SourcePrimSetParmPtSrcCohSingle Sets the configuration parameters for a Point Source (coherent) type Source Primitive node using the Single wavelength option

 

Astigmatic Gaussian Beam Commands

SourcePrimGetParmAstig Retrieves the configuration parameters from an Astigmatic Gaussian Beam type Source Primitive node

SourcePrimSetParmAstig Sets the configuration parameters for an Astigmatic Gaussian Beam type Source Primitive node

 

Laser Diode Beam (coherent) Commands

SourcePrimGetParmLaser Retrieves the configuration parameters from a Laser Diode Beam or M-Squared Laser Beam type Source Primitive node

SourcePrimSetParmLaser Sets the configuration parameters for a Laser Diode Beam or M-Squared Laser Beam type Source Primitive node

 

Ray Fan Commands

SourcePrimGetParmRayFan Retrieves the configuration parameters from a Ray Fan type Source Primitive node

SourcePrimSetParmRayFan Sets the configuration parameters for a Ray Fan type Source Primitive node

 

LED (far-field) Commands

SourcePrimGetParmLEDff Retrieves the configuration parameters from an LED (far-field) type Source Primitive node

SourcePrimSetParmLEDff Sets the configuration parameters for an LED (far-field) type Source Primitive node

 

Back to top


Coherent Field Synthesis

 

CreateRaysFromScalarField  Synthesizes a rayset from complex scalar field array data

CreateRaysFromScalarFieldFile  Synthesizes a rayset from a complex scalar field file

CreateRaysFromVectorField  Synthesizes a rayset from complex vector field array data

CreateRaysFromVectorFieldFile  Synthesizes a rayset from a complex vector field file

SpatiallyResampleScalarField  Spatially resamples a scalar field on a positional grid with a beamlet overlap of 1.0

SpatiallyResampleScalarField2  Spatially resamples a scalar field on a positional grid and allows user specification of beamlet overlap

SpatiallyResampleVectorField Spatially resamples vector field components on a positional grid with a beamlet overlap of 1.0

SpatiallyResampleVectorField2 Spatially resamples vector field components on a positional grid and allows user specification of beamlet overlap

 

Back to top


Materials

 

Absorption Coefficients
AddMaterialAbsorb  Synonym to SetMaterialAbsorb

DeleteIthMaterialAbsorb  Deletes the i'th material absorption data value

FindMaterialAbsorbWavel  Returns the array index in the material absorption array of the given wavelength
GetIthMaterialAbsorb  Gets i'th wavelength and absorption coefficient of material n
GetMaterialAbsorb  Returns the interpolated absorption coefficient at the given wavelength
GetMaterialAbsorbFlag  Gets material n's absorption flag
GetMaterialAbsorbRefDist  Gets the absorption reference distance

MaterialAbsorbCount  The count of absorption coefficients
SetIthMaterialAbsorb  Sets i'th wavelength and absorption coefficient of material n
SetIthMaterialAbsorbCoeff  Sets i'th absorption coefficient of material n
SetIthMaterialAbsorbWavel  Sets i'th absorption wavelength of material n
SetMaterialAbsorb  Sets an absorption coefficient for material n
SetMaterialAbsorbFlag  Sets material n's absorption flag
SetMaterialAbsorbRefDist  Sets material absorption reference distance

 

Axial / Radial GRIN
AddAxialRadialGRINMaterial  Adds a Axial/Radial GRIN material
AppendAxialRadialGRINMaterial  Appends an entry to the wavelength table of a Axial/Radial GRIN material
GetIthAxialRadialGRINMaterial  Gets the ith entry in wavelength table of Axial/Radial GRIN material

RemoveIthAxialRadialGRINMaterial  Removes the ith entry in wavelength table of Axial/Radial GRIN material
SetIthAxialRadialGRINMaterial  Sets ith entry in wavelength table of Axial/Radial GRIN material

 

Catalog Glass
AddCatalogGlass  Adds a material from a glass catalog
GetCatalogGlass  Gets the name a catalog of a catalog glass

 

Formula Glass Material

AddFormulaGlassMaterial  Adds a Formula Glass material

GetFormulaGlassFormula  Returns code for the Formula Glass formula

GetFormulaGlassNumCoeffs  Returns the number of Formula Glass coefficients

GetFormulaGlassType  Returns the Formula Glass type

GetFormulaGlassTypeName  Returns the given Formula Glass type name

GetFormulaGlassIthCoeff  Returns the ith Formula Glass coefficient

GetFormulaGlassIthCoeffName  Returns the ith Formula Glass coefficient name

SetFormulaGlassIthCoeff  Sets the Formula Glass ith coefficient

SetFormulaGlassType  Sets the Formula Glass type

 

Generic

DeleteMaterial  Deletes material at given array index

FindMaterial  Returns the array index of the named material
GetMaterialCount  Returns the number of defined materials
GetMaterialDescription  Returns the material description
GetMaterialName  Returns the material name
GetMaterialType  Returns the N'th material's type

RefractiveIndex  Returns refractive index at a specified wavelength
RefractiveIndexImag  Returns imaginary part of refractive index at a specified wavelength
SetMaterialName  Sets the material name
SetMaterialDescription  Sets the material description
SetRefractiveIndexPos  Sets position that will be used in subsequent calls to RefractiveIndex routine (useful for GRIN materials)

 

Gegenbauer Volume Scatter

AddGegenbauerCoefs Appends wavelength and coefficients. Return the coefficient count.
DeleteGegenbauerIthCoefs Deletes the I'th wavelength and coefficients

GetGegenbauerCoefCount Returns the count of scattering coefficients
GetGegenbauerIthCoefs Gets the I'th wavelength and scattering coefficients

SetGegenbauerIthCoefs Sets I'th wavelength and scat coefficients

SetVolScatGegenbauer Sets the material to use Gegenbauer Scattering

 

Henyey-Greenstein Volume Scatter

AddHenyeyCoef Appends wavelength and G coefficient. Return the coefficient count.
DeleteHenyeyIthCoef Deletes the I'th wavelength and G coefficient

GetHenyeyCoefCount Returns the count of scattering coefficients
GetHenyeyIthCoef Gets the I'th wavelength and scattering coefficient
SetHenyeyIthCoef Sets I'th wavelength and scat coefficient

SetVolScatHenyey Sets the material to use Henyey-Greenstein Scattering

 

GRIN Material Common Settings

InitGRINMaterialCommon  Initializes a T_GRINCOMMON structure with defaults
GetGRINMaterialCommon  Gets common parameters for a grin material
GetGRINMaterialNumWavelengths  Gets number of wavelengths for which a GRIN material has parameters

SetGRINMaterialCommon  Sets common parameters for a grin material

 

Luneberg GRIN
AddLunebergGRINMaterial  Adds a Luneberg GRIN material
AppendLunebergGRINMaterial  Appends an entry to the wavelength table of a Luneberg GRIN material
GetIthLunebergGRINMaterial  Gets the ith entry in wavelength table of Luneberg GRIN material

RemoveIthLunebergGRINMaterial  Removes the ith entry in wavelength table of Luneberg GRIN material
SetIthLunebergGRINMaterial  Sets ith entry in wavelength table of Luneberg GRIN material

 

Maxwell GRIN
AddMaxwellGRINMaterial  Adds a Maxwell GRIN material
AppendMaxwellGRINMaterial  Appends an entry to the wavelength table of a Maxwell GRIN material
GetIthMaxwellGRINMaterial  Gets the ith entry in wavelength table of Maxwell GRIN material

RemoveIthMaxwellGRINMaterial  Removes the ith entry in wavelength table of Maxwell GRIN material
SetIthMaxwellGRINMaterial  Sets ith entry in wavelength table of Maxwell GRIN material

 

Mie Volume Scatter

SetVolScatMie Sets the material to use Mie volume scatter

SetVolScatMieParticleDensityData Sets the particle diameter distribution function and values

GetVolScatMieParticleDensityData Retrieves the particle diameter distribution function and values

SetVolScatMieParticleRefIndexData Sets the particle reference wavelength and indices for that wavelength

GetVolScatMieParticleRefIndexData Retrieves the particle reference wavelength and indices for that wavelength

 

Model Material
AddModelMaterial  Adds a model material
GetModelMaterial  Gets the attributes of a model material

InitModelMaterial  Initializes a T_MODELMATERIAL structure with default values
SetModelMaterial  Sets the attributes of a model material

 

Power-Law GRIN

AddPowerLawGRINMaterial  Adds a new material node of Power-Law GRIN type

AppendPowerLawGRINMaterial Appends a wavelength sample to the N1,N2 table of a power-law GRIN material

GetConstantsPowerLawGRINMaterial Retrieves the alpha and g parameters of a power-law GRIN material

GetIthPowerLawGRINMaterial Retrieves the wavelength, N1 and N2 parameters from the I'th sample of a power-law GRIN material

RemoveIthPowerLawGRINMaterial Removes the I'th sample from the table in a power-law GRIN material

SetConstantsPowerLawGRINMaterial Sets the alpha and g parameters of a power-law GRIN material
SetIthPowerLawGRINMaterial Sets the wavelength, N1 and N2 values for the I'th sample in a power-law GRIN material

 

Sampled Birefringent Material
AddBirefringentMaterial  Adds a sampled birefringent material
AppendBirefringentMaterialSample  Adds another sample to a sampled birefringent material
GetBirefringentMaterialCrystalAxis  Gets the crystal axis for a sampled birefringent material
GetIthBirefringentMaterialSample  Gets the Ith sample of a sampled birefringent material
RemoveIthBirefringentMaterialSample  Removes Ith sample of a sampled birefringent material
SetBirefringentMaterialCrystalAxis  Sets the crystal axis for a sampled birefringent material
SetIthBirefringentMaterialSample  Sets Ith sample of a sampled birefringent material

 

Sampled Material
AddSampledMaterial  Adds a sample material
AddSampledMaterialWavelength  Adds a wavelength to the sampled material
DeleteSampledMaterialIthWavelength  Deletes the ith sample wavelength data

GetSampledMaterial  Gets the attributes of a sample material
GetSampledMaterialWavelengthCount  Gets number of sampled wavelengths
GetSampledMaterialIthWavelength  Sets the i'th wavelength data sample

SetSampledMaterial  Sets the attributes of a sample material
SetSampledMaterialIthWavelength  Sets the i'th wavelength data sample

 

Script GRIN
AddScriptGRINMaterial  Adds a script GRIN material
GetScriptGRINMaterialScript  Gets script for a script GRIN material

SetScriptGRINMaterial  Sets script for a script GRIN material

 

Selfoc GRIN
AddSelfocGRINMaterial  Adds a Selfoc GRIN material
AppendSelfocGRINMaterial  Appends an entry to the wavelength table of a Selfoc GRIN material
GetIthSelfocGRINMaterial  Gets the ith entry in wavelength table of Selfoc GRIN material

RemoveIthSelfocGRINMaterial  Removes the ith entry in wavelength table of Selfoc GRIN material
SetIthSelfocGRINMaterial  Sets ith entry in wavelength table of Selfoc GRIN material

 

Spherical GRIN
AddSphericalGRINMaterial  Adds a Spherical GRIN material
AppendSphericalGRINMaterial  Appends an entry to the wavelength table of a Spherical GRIN material
GetIthSphericalGRINMaterial  Gets the i'th entry in wavelength table of Spherical GRIN material

RemoveIthSphericalGRINMaterial  Removes the i'th entry in wavelength table of Spherical GRIN material
SetIthSphericalGRINMaterial  Sets i'th entry in wavelength table of Spherical GRIN material

 

Volume Scatter Coefficients
AddVolScatCoef  Appends wavelength and scattering coefficient. Return coefficient count.
DeleteVolScatIthCoef  Deletes the I'th scattering coefficient

GetVolScatCoefCount  Returns the count of scattering coefficient
GetVolScatCoefType  Returns the volume scatter coefficient type (0==>inverse coefficient, else mean free path)
GetVolScatIthCoef  Gets the I'th wavelength and scattering coefficient
SetVolScatCoefType  Sets the volume scatter coefficient type (0==>inverse coefficient, else mean free path)
SetVolScatIthCoef  Sets I'th wavelength and scattering coefficient

 

Volume Scatter Settings

GetVolScatActiveFlag  Returns the volume scatter "active" flag
GetVolScatFunctionType  Returns a string specifying the scatter function type
GetVolScatMaxEvents  Returns the max number of scatter events
GetVolScatScript  Returns a text string containing a scripted volume scatter model definition

SetVolScatActiveFlag  Sets the volume scatter "active" flag
SetVolScatHenyey  Sets the volume scatter function to Henyey-Greenstein

SetVolScatMaxEvents  Sets the max number of scatter events
SetVolScatNone  Removes the volume scatter function
SetVolScatScript  Sets the text string as a scripted volume scatter model definition

 

Back to top


Coatings

 

General Sampled (Rs, Rp, Ts, Tp, angle, wavelength)
AddGeneralCoating  Adds a sampled general coating
AddGeneralCoatingAngle  Adds an angle column of coefficients
AddGeneralCoatingWavelength  Adds a wavelength row of coefficients
DeleteGeneralCoatingAngle  Deletes the column at the given angle
DeleteGeneralCoatingWavelength  Deletes the row at the given wavelength
GetGeneralCoatingAngleCount  Returns the number of angles defined
GetGeneralCoatingAngleSpec  Gets the angle specification
GetGeneralCoatingCoefficients  Sets the coefficients at the given wv, and angle
GetGeneralCoatingIthAngle  Gets the i'th coating data angle
GetGeneralCoatingIthWavelength  Gets the i'th coating data wavelength
GetGeneralCoatingWavelengthCount  Returns the number of wavelengths defined
SetGeneralCoatingAngleSpec  Sets the angle specification
SetGeneralCoatingCoefficients  Sets the coefficients at the given wv, and angle

 

Generic
DeleteCoating  Deletes coating at the given array index

EvaluateCoatingMtrlReflP  Computes coating P-state complex amplitude reflection coefficient using incident and substrate material IDs
EvaluateCoatingMtrlReflS  Computes coating S-state complex amplitude reflection coefficient using incident and substrate material IDs
EvaluateCoatingMtrlTranP  Computes coating P-state complex amplitude transmission coefficient using incident and substrate material IDs

EvaluateCoatingMtrlTranS  Computes coating S-state complex amplitude transmission coefficient using incident and substrate material IDs
EvaluateCoatingReflP  Computes coating P-state complex amplitude reflection coefficient using incident and substrate material index values
EvaluateCoatingReflS  Computes coating S-state complex amplitude reflection coefficient using incident and substrate material index values
EvaluateCoatingTranP  Computes coating P-state complex amplitude transmission coefficient using incident and substrate material index values

EvaluateCoatingTranS  Computes coating S-state complex amplitude transmission coefficient using incident and substrate material index values
FindCoating  Returns the array index of the named coating
GetCoatingCount  Returns the number of defined coatings
GetCoatingDescription  Gets the coating description
GetCoatingName  Gets the coating name
GetCoatingType  Gets coating type
SetCoatingDescription  Sets the coating description
SetCoatingName  Sets the coating name

 

Jones Matrix
AddMatrixCoating  Adds general matrix coating
AddMatrixCoatingType  Adds defined type of matrix coating
GetMatrixCoating  Gets jones matrix of the matrix coating

GetMatrixCoatingExtra Retrieves the node number of the extra coating applied to the jones matrix coating

GetMatrixCoatingPolarizationAlgorithm Retrieves the Jones Matrix coating polarization algorithm for a specified Polarizer / Waveplate (Jones Matrix) coating.
GetMatrixCoatingType  Returns the jones matrix type of the matrix coating
InitMatrixCoating  Initializes a T_JONESMATRIX structure with default values
SetMatrixCoating  Sets parameters of general matrix coating

SetMatrixCoatingExtra Sets the extra coating specification for a jones matrix coating

SetMatrixCoatingPolarizationAlgorithm Sets the Jones Matrix coating polarization algorithm for a specified Polarizer / Waveplate (Jones Matrix) coating.
SetMatrixCoatingType  Sets jones matrix parameters according to specified type

 

Quarter Wave Coating
AddQuarterWaveCoating  Adds a single layer quarter wave coating
GetQuarterWaveCoating  Gets a quarter wave coating
SetQuarterWaveCoating  Sets a quarter wave coating

 

Sampled (R, T, wavelength)
AddSampledCoating  Adds sampled coating with one wavelength
AddSampledCoatingWavelength  Adds one wavelength
DeleteSampledCoatingIthWavelength  Deletes the i'th wavelength
DeleteSampledCoatingWavelength  Deletes the given wavelength
GetSampledCoatingIthWavelength  Gets the I'th wavelength
GetSampledCoatingWavelengthCount  number of wavelengths defined

 

Scripted Coating

AddScriptCoating  Adds a scripted coating

GetScriptCoating  Gets text of a scripted coating

SetScriptCoating  Sets text of a scripted coating

 

Thin Film
AddThinFilmCoating  Adds a thin film coating
AddThinFilmLayer  Appends one thin film layer
DeleteThinFilmIthLayer  Deletes the I'th thin film layer
GetThinFilmCoatingParameters  Gets a thin film coating's parameters
GetThinFilmIthLayer  Gets parameters of the I'th thin film layer
GetThinFilmLayerCount  Returns the number of thin film of layers
SetThinFilmCoatingParameters  Sets a thin film coating's parameters
SetThinFilmIthLayer  Sets parameters of the I'th thin film layer

ThinFilmCoefficients Computes the real and imaginary amplitude coefficients of a custom thin film stack definition

 

Encrypted Thin Film

AddEncryptedThinFilmCoatingFromData Only intended to support reconstruction of FRED models generated by File > Export > FRED Script Format

AddEncryptedThinFilmCoatingFromFile Adds a new Encrypted Thin Film coating model using an *.fec file

GetEncryptedThinFilmFileName Retrieves the name of the *.fec file assigned to the coating

GetEncryptedThinFilmIsSubstrateAtLastLayer Retrieves the flag indicating the orientation of the substrate relative to the coating stack
SetEncryptedThinFilmFileName Sets the *.fec file associated with the encrypted coating

SetEncryptedThinFilmIsSubstrateAtLastLayer Sets the orientation of the substrate relative to the coating stack

 

Uncoated
AddUncoated  Adds Uncoated (bare) coating

 

Back to top


Gratings

 

DiffractHOEExRecord Records the OPL polynomials for a grating of the type, "Two source user-recorded holographic optical element"

 

GetDiffractAddPhasePerLine Returns the phase addition method flag (continuous or modulo 2p)

GetDiffractEfficiency Returns the calculated diffraction efficiency value for a single order given initial conditions

GetDiffractEfficiencyFile Retrieves the full path name for the primary diffraction efficiency file being used by a surface with grating efficiency type "Full efficiency table"

GetDiffractEfficiencyFileSecondary Retrieves the full path name for the secondary diffraction efficiency file being used by a surface with grating efficiency type "Full efficiency table"

GetDiffractEfficiencyTable  Retrieves the primary diffraction efficiency table values from a surface with diffraction efficiency type "Simple efficiency table"

GetDiffractEfficiencyTableSecondary  Retrieves the secondary diffraction efficiency table values from a surface with diffraction efficiency type "Simple efficiency table"

GetDiffractEfficiencyVolHOE  Retrieves the primary diffraction efficiency specification values from a surface with diffraction efficiency type "Volume hologram efficiency"

GetDiffractEfficiencyVolHOEAlgorithm Retrieves the primary algorithm mode specification values from a surface with diffraction efficiency type "Volume hologram efficiency"

GetDiffractEfficiencyVolHOEAlgorithmSecondary Retrieves the secondary algorithm mode specification values from a surface with diffraction efficiency type "Volume hologram efficiency"

GetDiffractEfficiencyVolHOESecondary  Retrieves the secondary diffraction efficiency specification values from a surface with diffraction efficiency type "Volume hologram efficiency"

GetDiffractEfficiencyVolHOESwellingFactor Retrieves the swelling factor from a grating whose Primary diffraction efficiency type is "Volume hologram efficiency"

GetDiffractEfficiencyVolHOESwellingFactorSecondary Retrieves the swelling factor from a grating whose Secondary diffraction efficiency type is "Volume hologram efficiency"

GetDiffractType  Returns the type of diffraction grating specification applied to a surface

GetDiffractHOE  Retrieves the grating specification from a surface with the "Two point exposure holographic optical element" grating type

GetDiffractHOEEx Retrieves the grating specification from a surface with the "Two point user-recorded holographic optical element" grating type
GetDiffractHOECoefCount  Gets the number of phase coefficients from a surface with a grating specification of the Two point holographic optical element type

GetDiffractLinear  Gets the grating specification from a surface with the Linear type
GetDiffractNoPhasePerLine Returns a boolean indicating whether the phase option "none" is toggled

GetDiffractOrderCount  Returns number of diffraction orders in the efficiency table

GetDiffractPhaseOffsetPerLine Returns the line pair offset for use with the continuous phase addition method
GetDiffractWavelengthCount  Returns number of wavelengths in the efficiency table

GetGratingKVector  Retrieves the k-vector and local frequency from a grating for an arbitrary position on the surface

GetInterpolatedDiffractEfficiency Retrieve interpolated efficiency values from a grating with the Full diffraction efficiency table specification

 

IsDiffractingSurface  Returns True if the surface being queried has diffraction grating attribute of any type applied

 

SetDiffractAddPhasePerLine Sets the phase addition method flag (continuous or modulo 2p)
SetDiffractEfficiencyFile Specifies the file to be used for a grating with primary diffraction efficiency type "Full efficiency table"

SetDiffractEfficiencyFileSecondary Specifies the file to be used for a grating with secondary diffraction efficiency type "Full efficiency table"

SetDiffractEfficiencyTable  Specifies the data to be used for a grating with primary diffraction efficiency type "Simple efficiency table"

SetDiffractEfficiencyTableSecondary  Specifies the data to be used for a grating with secondary diffraction efficiency type "Simple efficiency table"

SetDiffractEfficiencyVolHOE  Sets the primary diffraction efficiency specification values for a surface with diffraction efficiency type "Volume hologram efficiency"

SetDiffractEfficiencyVolHOEAlgorithm Sets the algorithm that will be used when computing diffraction efficiency values

SetDiffractEfficiencyVolHOEAlgorithmSecondary Sets the algorithm that will be used when computing diffraction efficiency values

SetDiffractEfficiencyVolHOESecondary  Sets the secondary diffraction efficiency specification values for a surface with diffraction efficiency type "Volume hologram efficiency"

SetDiffractEfficiencyVolHOESwellingFactor For a grating whose Primary diffraction efficiency is the "Volume hologram efficiency" type, this command sets the value of the swelling factor

SetDiffractEfficiencyVolHOESwellingFactorSecondary For a grating whose Secondary diffraction efficiency is the "Volume hologram efficiency" type, this command sets the value of the swelling factor

SetDiffractHOE  Sets diffraction grating specification of the type, "Two point exposure holographic optical element"

SetDiffractHOEEx Sets the diffraction grating specification of the type, "Two point user-recorded holographic optical element"

SetDiffractLinear  Sets diffraction grating specification to the Linear type

SetDiffractNone  Removes any diffraction grating specification on the surface

SetDiffractNoPhasePerLine Toggles a grating surface to use the phase option "none"

SetDiffractPhaseOffsetPerLine Sets the line pair offset for use with the continuous phase addition method

 

Back to top


Scatter

 

ABg

AddAbgScatter  Adds an ABG scatter model
GetAbgScatter  Gets the attributes of an ABG scatter model
InitAbgScatter  Initializes a T_ABGSCATTER structure with default values
SetAbgScatter  Sest the attributes of an ABG scatter model

 

Black Paint

AddBlackPaint  Adds a generic black paint scatter model
GetBlackPaint  Gets the attributes of a black paint scatter model
InitBlackPaint  Initializes a T_BLACKPAINT structure with default values
SetBlackPaint  Sets the attributes of a black paint scatter model
 

Diffuse Binomial

AddDiffuseBinomial  Adds a Diffuse Binomial scatter model

AddDiffuseBinomialFromFile Adds a Diffuse Binomial scatter model from a text file
GetDiffuseBinomial  Gets the attributes of a Diffuse Binomial scatter model

GetTISIntegrationSampling Gets the A and B sampling for TIS integration
InitDiffuseBinomial  Initializes a T_DIFFUSEBINOMIAL structure with default values
SetDiffuseBinomial  Sets the attributes of a Diffuse Binomial scatter model

SetTISIntegrationSampling Sets the A and B sampling for TIS integration
 

Diffuse Polynomial

AddDiffusePolynomial  Adds a Diffuse Polynomial scatter model

AddDiffusePolynomialFromFile Adds a Diffuse Polynomial scatter model from a text file
GetDiffusePolynomial  Gets the attributes of a Diffuse Polynomial scatter model
GetTISIntegrationSampling Gets the A and B sampling for TIS integration
InitDiffusePolynomial  Initializes a T_DIFFUSEPOLYNOMIAL structure with default values
SetDiffusePolynomial  Sets the attributes of a Diffuse Polynomial scatter model
SetTISIntegrationSampling Sets the A and B sampling for TIS integration
 

Extended Harvey Shack

AddHarveyShackExtendedScatter Adds a new Extended Harvey Shack scatter model to the document

GetHarveyShackExtendedScatter Queries an existing Extended Harvey-Shack scatter model for its parameters

InitHarveyShackExtendedScatter Initializes a T_HARVEYSHACKEXTENDEDSCATTER data structure

SetHarveyShackExtendedScatter Sets the parameters for an existing Extended Harvey-Shack scatter model

 

Gaussian Diffuse

AddGaussianScatter  Adds a Gaussian Diffuse scatter model

GetGaussianScatter  Gets the attributes of a Gaussian Diffuse scatter model
InitGaussianScatter  Initializes a T_GAUSSIANSCATTER structure with default values
SetGaussianScatter  Sets the attributes of a Gaussian Diffuse scatter model
 

Generic

AddCatalogScatter Adds a scatter model from one of the scatter catalogs and returns its node number

DeleteScatter  Deletes scatter model at given array index

FindScatter  Returns the array index of the named scatter model

GetScatter  Gets the scatter user-defined type information for the given model
GetScatterCount  Returns the number of defined scatter models
GetScatterDescription  Gets the scatter description
GetScatterName  Gets the scatter name
GetScatterType  Returns the scatter type
InitScatter  Initializes a scatter user-defined type (UDT)
ScatterEval Evaluates the BSDF function for a scatter model

ScatterPrepareForEval Prepares scatter model for BSDF function evaluations
ScatterTIS  Evaluates the TIS function for a scatter model
SetScatter  Sets the scatter user-defined type (UDT) data in the given model
SetScatterDescription  Sets the scatter description
SetScatterName  Sets the scatter name

 

Harvey Shack

AddHarveyShackScatter  Adds a Harvey Shack polished surface scatter model
GetHarveyShackScatter  Gets the attributes of a Harvey Shack polished surface scatter model
InitHarveyShackScatter  Initializes a T_HARVEYSHACKSCATTER structure with default values
SetHarveyShackScatter  Sets the attributes of a Harvey Shack polished surface scatter model
 

K-Correlation

AddKCorrelationScatter  Adds a K Correlation surface scatter model
GetKCorrelationScatter  Gets the attributes of a K Correlation surface scatter model
InitKCorrelationScatter  Initializes a T_KCORRELATIONSCATTER structure with default values
SetKCorrelationScatter  Sets the attributes of a K Correlation surface scatter model
 

Lambertian

AddLambertianScatter  Adds a Lambertian scatter model
GetLambertianScatter  Gets the attributes of a Lambertian scatter model
InitLambertianScatter  Initializes a T_LAMBERTIANSCATTER structure with default values
SetLambertianScatter  Sets the attributes of a Lambertian scatter model
 

Mie (Surface Particulate)

AddMieScatter  Adds a Mie particle scatter model
AddMieScatterSample   Appends one sample point for Mie scatter sampled density function type
GetMieScatSurfCoefficients   Returns the forward scatter reflection and transmission coefficients of a Mie particle scatter model
GetMieScatter  Returns the attributes of a Mie particle scatter model

GetMieScatterCoefficients  Returns the S1 & S2 polarization coefficients for a Mie model
GetMieScatterIthSample   Returns the i'th sample point for Mie scatter sampled density function type

GetMieScatterPercentAreaCoverage Returns the percent area coverage (PAC) for a Mie particle scatter model

GetMieScatterPhaseFunction  Returns the Mie phase function
GetMieScatterSampleCount   Returns the number of Mie scatter samples for sampled density function type

InitMieScatter  Initializes a T_MIESCATTER structure with default values
MieScatterIntensity  Returns the Mie scattering intensity

SetMieScatSurfCoefficients   Sets the forward scatter reflection and transmission coefficients of a Mie particle scatter model
SetMieScatter  Sets the attributes of a Mie particle scatter model
SetMieScatterIthSample   Sets the i'th sample point for Mie scatter sampled density function type
 

Phong

AddPhongScatter  Adds a Phong scatter model

GetPhongScatter  Gets the attributes of a Phong scatter model
InitPhongScatter  Initializes a T_PHONGSCATTER structure with default values
SetPhongScatter  Sets the attributes of a Phong scatter model
 

Scripted
AddScriptScatter  Adds a scripted scatter model

InitScriptScatter  Initializes a T_SCRIPTSCATTER structure with default values

GetScriptScatter  Gets a scripted scatter model
SetScriptScatter  Sets a scripted scatter model

Tabulated BSDF
AddTabulatedScatter  Adds a tabulated (sampled) scatter model using arrays of specular and scatter directions
AddTabulatedScatter2  Adds a tabulated (sampled) scatter model using file data
AddTabulatedScatterData  Adds one dataset to a tabulated (sampled) scatter model
GetTabulatedScatter  Gets a tabulated (sampled) scatter model
GetTabulatedScatterDataCount  Returns the count of datasets for a tabulated (sampled) scatter model
GetTabulatedScatterIthData  Gets one dataset of a tabulated (sampled) scatter model
InitTabulatedScatter  Initializes a T_TABULATEDSCATTER structure with default values
SetTabulatedScatter  Sets a tabulated (sampled) scatter model
SetTabulatedScatterIthData  Sets one dataset of a tabulated (sampled) scatter model
 
Tabulated Power Spectral Density

AddTabulatedPSDScatter  Adds tabulated PSD scatter
AddTabulatedPSDScatterData  Appends one data point
DeleteTabulatedPSDScatterIthData  Deletes one data point
GetTabulatedPSDScatterDataCount  Gets count of data points
GetTabulatedPSDScatterDeltaN  Gets surf delta N
GetTabulatedPSDScatterFileName  Gets file name
GetTabulatedPSDScatterIthData  Gets one data point
GetTabulatedPSDScatterRefl  Gets surf reflectivity
GetTabulatedPSDScatterWavelen  Gets wavelength
ReadTabulatedPSDScatterFile  Reads data file
SetTabulatedPSDScatterDeltaN  Sets surf delta N
SetTabulatedPSDScatterFileName  Sets file name
SetTabulatedPSDScatterIthData  Sets one data point
SetTabulatedPSDScatterRefl  Sets surf reflectivity
SetTabulatedPSDScatterWavelen  Sets wavelength
 

Back to top


Surface Roughness

 

Generic

SurfRoughCopy  Makes a copy of an existing surface roughness node

SurfRoughDelete  Deletes a surface roughness node from the tree

SurfRoughDeleteAllNodes  Deletes all surface roughness nodes from the tree

SurfRoughFindName  Returns the node number of a roughness model provided the string name

SurfRoughGetDescription  Returns the string description for a surface roughness node

SurfRoughGetMaxNodeNum  Return the maximum node number currently occupied by a roughness model

SurfRoughGetName Returns the string name of a surface roughness node

SurfRoughGetNodeCount Returns the number of surface roughness nodes

SurfRoughGetType Returns the string type identifier of a surface roughness node

SurfRoughIsActive Returns the active state for a surface roughness node

SurfRoughIsValidNode Returns a boolean indicating that a node number is a valid roughness model

SurfRoughSetActive  Sets the active state for a surface roughness node

SurfRoughSetDescription Sets the string description for a surface roughness node

SurfRoughSetName Sets the string name for a surface roughness node

 

Sampled Random Surface Normal

SurfRoughSRSNCreate Creates a new SRSN roughness node

SurfRoughSRSNGetEntries Returns the sampled entries

SurfRoughSRSNGetEntryCount Returns the number of sampled entries

SurfRoughSRSNGetIthAngle Returns the angle value in degrees for the I'th sample

SurfRoughSRSNGetIthProbability Returns the probability value for the I'th sample

SurfRoughSRSNGetOverallRoughnessProbability Returns the overall roughness model probability

SurfRoughSRSNSetEntries Sets all sampled entries

SurfRoughSRSNSetOverallRoughnessProbability Sets the overall roughness model probability

 

Back to top


Importance Samples

 

Closed Curve

ImpSampAddCurve  Adds the curve importance sample to a surface

ImpSampGetCurve  Gets the attributes of the given importance sample
ImpSampSetCurve  Sets the attributes of the given importance sample

 

Ellipsoidal Volume
ImpSampAddEllipsoid  Adds the ellipsoid importance sample to a surface
ImpSampGetEllipsoid  Sets the attributes of the ellipsoidal importance sample
ImpSampSetEllipsoid  Sets the attributes of the ellipsoidal importance sample

 

General
ImpSampCopy Copies the I'th importance sample from a surface and duplicates it on a destination node

ImpSampDelete  Deletes i'th importance sample on surface n
ImpSampGetAngleHole  Gets solid angle fractional hole
ImpSampGetAngleScale  Gets solid angle scale factor
ImpSampGetCount  Gets the number of importance samples defined on surface n
ImpSampGetDescription  Gets description of i'th importance sample
ImpSampGetDirectionSampleType Queries an importance sample specification of a surface for the type of directional sampling being used

ImpSampGetName  Gets name of i'th importance sample
ImpSampGetRayCount  Gets number of scattered rays

ImpSampGetScatterLevel Retrieves the scatter ancestry level requirement from an importance sample
ImpSampGetType  Gets type of i'th importance sample
ImpSampIsActive  Is i'th importance sample active?
ImpSampIsReversed  Is i'th importance sample reverse ray directions?
ImpSampSetActive  Sets active state of i'th importance sample
ImpSampSetAngleHole  Sets solid angle fractional hole
ImpSampSetAngleScale  Sets solid angle scale factor
ImpSampSetDescription  Sets description of i'th importance sample
ImpSampSetDirectionSampleType Sets the type of directional sampling being used by an importance sample specification of a surface

ImpSampSetName  Sets name of i'th importance sample
ImpSampSetRayCount  Sets number of scattered rays
ImpSampSetReversed  Sets reverse ray directions flag

ImpSampSetScatterLevel Sets the scatter ancestry level requirement for an importance sample

 

Given Direction

ImpSampAddDir  Adds the direction importance sample to a surface
ImpSampGetDir  Gets the attributes of the given direction importance sample
ImpSampSetDir  Sets the attributes of the given direction importance sample

 

Specular Direction

ImpSampAddSpecular  Adds the specular direction importance sample to a surface

ImpSampGetSpecular  Gets the attributes of the given specular direction importance sample
ImpSampSetSpecular  Sets the attributes of the given specular direction importance sample

 

Towards Entity

ImpSampAddEntity  Adds the node as an importance sample to a surface
ImpSampGetEntity  Gets the attributes of the given entity importance sample

ImpSampSetEntity  Sets the attributes of the given entity importance sample

 

Towards Point
ImpSampAddPos  Adds the position importance sample to a surface
ImpSampGetPos  Gets the attributes of the given position importance sample
ImpSampSetPos  Sets the attributes of the given position importance sample

 

Back to top


 

Keywords

 

KeywordAdd Adds a new keyword with a given name and description

KeywordApplyToItem Assigns a single keyword to a single entity

KeywordCount Retrieves the number of keywords in the document

KeywordDelete Deletes a specified keyword and returns the count of the remaining kewyords

KeywordFind Returns the node number of an existing keyword given a name as input

KeywordGetCountFromItem Returns the number of keywords assigned to a designated item

KeywordGetDescription Returns the description string of a keyword

KeywordGetName Returns the name of a given keyword node

KeywordIsAppliedToItem Returns a boolean indicating whether a specific keyword is assigned to a specific item

KeywordRemoveFromItem Removes a specific keyword from a specific item

KeywordSetDescription Sets the description string for a specific keyword node

KeywordSetName Sets the name string for a specific keyword node

KeywordsApplyToItems Applies one or more keywords to one or more items

KeywordsGetAllFromItem Retrieves an array of keyword nodes that are assigned to a specific item

KeywordsGetAppliedItems Retrieves an array of item node numbers having one or more keyword assignments from those matching an input keywords array

KeywordsRemoveFromItems Removes from an array of items any keyword assignments matching an array of input keywords

 

Back to top


 

Raytrace Controls

 

AddRaytraceCtrl  Adds a new raytrace control

DeleteRaytraceCtrl  Deletes raytrace property at given array index

FindRaytraceCtrl  Returns the index of the raytrace control with the given name

GetRaytraceCtrl  Gets the attributes of a raytrace control
GetRaytraceCtrlCount  Returns the number of defined raytrace controls
GetRaytraceCtrlDescription  Gets the raytrace control description
GetRaytraceCtrlName  Gets the raytrace control name
GetRaytraceCtrlSpecPlusScatCutoff  Returns the specular plus scatter ancestry level cutoff
GetRaytraceCtrlSpecPlusScatIsActive  Returns the specular plus scatter ancestry level active flag

GetRaytraceCtrlType  Returns the raytrace control type

InitRaytraceCtrl  Initializes a T_RAYTRACECTRL structure with default values
SetRaytraceCtrl  Sets the attributes of a raytrace control
SetRaytraceCtrlDescription  Sets the raytrace control description
SetRaytraceCtrlName  Sets the raytrace control name
SetRaytraceCtrlSpecPlusScatCutoff Sets the spec plus scat ancestry level cutoff
SetRaytraceCtrlSpecPlusScatIsActive Sets the spec plus scat ancestry level active flag
 

Back to top


Spectrum

 

SpectrumCombine Linearly combines two spectrum

SpectrumComputeArea Computes the area under a given spectrum

SpectrumComputeChromaticity Computes the X,Y chromaticity coordinates of a spectrum

SpectrumComputeLuminousEfficacy Compute the Luminous Efficacy of a given spectrum

SpectrumCopy Makes a copy of a spectrum

SpectrumCreateBlackbody Creates a Blackbody spectrum

SpectrumCreateGaussian Creates a Gaussian spectrum

SpectrumCreatePredefinedSampled Creates a sampled spectrum of a pre-defined type

SpectrumCreateSampled Creates a sampled spectrum

SpectrumDelete Deletes a sampled spectrum

SpectrumDeleteAllNodes Deletes all spectrum from the document

SpectrumFindName Finds the node number of a spectrum by name

SpectrumGetBlackbodyNormalizationFlag Gets the normalization flag of a spectrum

SpectrumGetBlackbodyTemperature Gets the temperature defining a Blackbody spectrum

SpectrumGetDescription Gets the description of a spectrum

SpectrumGetGaussianCenterWavelength Gets the center wavelength of a Gaussian function

SpectrumGetGaussianHWHM Gets the HWHM of a Gaussian spectrum

SpectrumGetMaxNodeNum Gets the maximum node number of all spectrum in the document

SpectrumGetName Gets the name of a spectrum from its node number

SpectrumGetNodeCount Gets the number of spectrum nodes in the document

SpectrumGetRandomWavelength Gets a random wavelength from a spectrum according to its distribution

SpectrumGetRange Gets the wavelength range of a spectrum

SpectrumGetSampledEntries Gets the wavelength and values for a given sampled spectrum

SpectrumGetSampledEntryCount Gets the number of samples in a sampled spectrum

SpectrumGetSampledIthValue Gets the value of the I'th sample in a sampled spectrum

SpectrumGetSampledIthWavelength Gets the value of the Ith wavelength in a sampled spectrum

SpectrumGetValue Gets the value of a spectrum at an arbitrary wavelength

SpectrumIsValidNode Checks to see if a node number is a valid spectrum

SpectrumSetBlackbodyNormalizationFlag Sets the normalization flag for a Blackbody spectrum

SpectrumSetBlackbodyRange Sets the wavelength range for a Blackbody spectrum

SpectrumSetBlackbodyTemperature Sets the temperature for a Blackbody spectrum

SpectrumSetDescription Sets the description of a spectrum

SpectrumSetGaussianCenterWavelength Sets the center wavelength for a Gaussian spectrum

SpectrumSetGaussianHWHM Sets the half width at half maximum value for a Gaussian spectrum

SpectrumSetGaussianRange Sets the wavelength range for a Gaussian spectrum

SpectrumSetName Sets the name of a spectrum

SpectrumSetSampledEntries Sets the wavelengths and values for a sampled spectrum

 

Back to top


Position/Orientation (Linear Transformations)

 

AddOperation  Adds an operation to a node's linear transformation
DeleteOperation  Deletes the i'th operation of node's linear transformation
GetCoordSys  Gets the node's coordinate system
GetOperation  Gets the i'th operation of node's linear transformation
GetOperationCount  Returns number of primitive operations in entity's linear transformation
LockOperationUpdates  Locks/unlocks updates of the node's linear transformation
PlaceAt  Appends PlaceAt operation
PlaceIthAt  Sets PlaceAt at the i'th operation
RestartCoordSys  Deletes all operations and reset the starting coordinate system
RotateAxis  Appends RotateAxis operation
RotateIthAxis  Sets RotateAxis at the i'th operation operation
RotateIthX  Sets RotateX at the i'th operation
RotateIthXYZ  Sets RotateXYZ at the i'th operation
RotateIthY  Sets RotateY at the i'th operation
RotateIthZ  Sets RotateZ at the i'th operation
RotateIthZYX  Sets RotateZYX at the i'th operation
RotateIthToDirection  Sets RotateToDirection at the i'th operation
RotateToDirection  Appends RotateToDirection operation
RotateX  Appends RotateX operation
RotateXYZ  Appends RotateXYZ operation
RotateY  Appends RotateY operation
RotateZ  Appends RotateZ operation
RotateZYX  Appends RotateZYX operation
SetOperation  Sets the i'th operation of node's linear transformation
ShiftIthX  Sets ShiftX at the i'th operation
ShiftIthXYZ  Sets ShiftXYZ at the i'th operation
ShiftIthY  Sets ShiftY at the i'th operation
ShiftIthZ  Sets ShiftZ at the i'th operation
ShiftX  Appends ShiftX operation
ShiftXYZ  Appends ShiftXYZ operation
ShiftY  Appends ShiftY operation
ShiftZ  Appends ShiftZ operation
StartCoordSys  Sets the starting coordinate system
TransformDirection  Transforms direction cosines from one coordinate system to another
TransformPosition  Transforms position data from one coordinate system to another

 

Back to top


FRED Data Structures

 

Advanced Raytrace
T_ADVANCEDRAYTRACE
T_TARGETEDRAY

 

Analyses

T_RAYSUMMARY

 

Analysis Results Nodes

T_ARN_2D_CELL_STATS

T_ARN_3DGRIDWALL_CELL_STATS

 

Analysis Surfaces

T_ANALYSIS
T_ANALYSISSURF
T_RAYFILTEROP

 

Background Grid
T_BACKGROUNDGRID
 

Best Focus
T_BESTFOCUS
 

Coatings
T_GENERALCOATINGITEM
T_JONESMATRIX
 

Configurations

T_CONFIGURATION

 

Curves
T_APERTURECURVEOP
T_CIRCULARARC
T_CONICARC
T_CURVEBASICINFO
T_LINE
 

Diffraction Gratings
T_HOE
 

Distributed Computing

T_IPCINSTANCE

 

Element

T_CPC_DATA

T_CPC_STRUCT

T_EDGEBEVELS
T_LENS
T_MIRROR
T_PRISMCUSTOM
 

Entity
T_ENTITY
T_ENTITYARRAY
 

FREDMPC (GPU)

T_MPCADVANCEDRAYTRACE
 

Import/Export

T_CADEXPORT

T_CADIMPORT

 

Importance Sampling
T_IMPSAMPELLIPSOID
 

Materials

T_BIREFSAMPLE

T_GRINCOMMON

T_MODELMATERIAL
T_SAMPLEDMATERIAL

 

Optimization

T_MZRABERRATION

T_MZRRESULT

T_MZRVARIABLE

 

Pickups

T_PICKUP

 

Polarization

T_POLARIZE
T_POLARIZE2

 

Position / Orientation

T_COORDSYS
T_OPERATION


Rays
T_RAY
T_RAYCOHERENT 

 

Raytrace Control
T_RAYTRACECTRL
 

Scatter

T_ABGSCATTER
T_BLACKPAINT
T_DIFFUSEPOLYNOMIAL
T_DIFFUSEBINOMIAL
T_HARVEYSHACKSCATTER

T_HARVEYSHACKEXTENDEDSCATTER
T_KCORRELATIONSCATTER
T_LAMBERTIANSCATTER
T_MIESCATTER
T_PHONGSCATTER
T_SCATTER

T_SCATTERSCRIPTEX
T_SCRIPTSCATTER

T_TABULATEDSCATTER
 

Sources
T_ACCEPTANCE_FILTER

T_SOURCEDIRAPODSINCOS

T_SOURCEDIRLASERDIODE

T_SOURCEDIRM2LASER
T_SOURCEDIRPOSITIONGRID
T_SOURCEDIRRANGE
T_SOURCEPOLARIZATION
T_SOURCEPOSAPODLENGTH

T_SOURCEPOSAPODSAMPLED
T_SOURCEPOSSURFACE
T_SOURCEPROPSPEC
T_SOURCEUSERRAY
T_SOURCEVISUALIZE
T_WAVELENGTHSPEC
T_SOURCEPOSBITMAP

T_SYNTH_RAYS_FROM_FIELD
 

Source Primitives

T_SOURCEPRIMASTIG

T_SOURCEPRIMLASER
T_SOURCEPRIMLEDFF

T_SOURCEPRIMPTSRCCOH

T_SOURCEPRIMRAYFAN
 

Surfaces
T_CONICFOCI
T_REVOLVESURF
T_RULEDSURF
T_SURFVISUALIZE
T_TABULATEDCYLINDER
T_TOROIDALASPHERE
T_TUBE
 

Trimming Volume
T_TRIMVOLUME

 

Visualization Camera
T_CAMERA 

 

Back to top

 

 

 

 

 

Copyright © Photon Engineering, LLC