C_SaveModel3DViewMetafileToFile

Call C_SaveModel3DViewMetafileToFile to save an enhanced metafile containing an OrcaFlex 3D view of the specified model to file.

The C_SetSimulationDrawTime function can be used to control the way this function behaves. It allows you to produce drawings of the OrcaFlex model at a number of different points of a simulation. See C_SetSimulationDrawTime for details.

void C_SaveModel3DViewMetafileToFile(

TOrcFxAPIHandle ModelHandle,

const TViewParameters *lpViewParameters,

LPCTSTR lpFileName,

int *lpStatus

);

Parameters

ModelHandle (IN)

The handle of the model.

lpViewParameters (IN)

Points to a structure containing the view parameters.

Before calling the C_SaveModel3DViewMetafileToFile function, set the Size member of the TViewParameters data structure to sizeof(TViewParameters).

If this parameter is passed as NULL then default view parameters are used. These default parameters are the same as those returned by C_GetDefaultViewParameters.

lpFileName (IN)

Points to a null-terminated string containing the name of the file to be saved. Note that existing files will be overwritten.

lpStatus (OUT)

Points to a variable in which the status result for the function call will be returned.

Remarks

This function requires that the calling thread is DPI aware.

Unicode and ANSI

The Unicode function name is C_SaveModel3DViewMetafileToFileW and the ANSI function name is C_SaveModel3DViewMetafileToFileA.