C_SaveModel3DViewBitmapToFile

Call C_SaveModel3DViewBitmapToFile to save a bitmap containing an OrcaFlex 3D View of the specified model to file. The format is specified by the FileFormat member of TViewParameters.

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_SaveModel3DViewBitmapToFile(

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_SaveModel3DViewBitmapToFile 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.

Unicode and ANSI

The Unicode function name is C_SaveModel3DViewBitmapToFileW and the ANSI function name is C_SaveModel3DViewBitmapToFileA.

See Also

TViewParameters, C_CreateModel3DViewBitmap, C_GetDefaultViewParameters, C_GetSimulationDrawTime, C_SaveModel3DViewBitmapMem, C_SetSimulationDrawTime.