C_DrawModel3DViewToBitmapCanvas

Call C_DrawModel3DViewToBitmapCanvas to add a snapshot image to an existing bitmap canvas.

void C_DrawModel3DViewToBitmapCanvas(

TOrcFxAPIHandle CanvasHandle,

TOrcFxAPIHandle ModelHandle,

const TViewParameters *lpViewParameters,

int *lpStatus

);

Parameters

CanvasHandle (IN)

The canvas handle obtained by calling C_CreateBitmapCanvas or C_CreateBitmapCanvasClone.

ModelHandle (IN)

The handle of the model that defines the snapshot image.

lpViewParameters (IN)

Points to a structure containing the view parameters.

Before calling C_DrawModel3DViewToBitmapCanvas, 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.

lpStatus (OUT)

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

Remarks

To draw a snapshot at a specific time in a simulation, call C_SetSimulationDrawTime before calling C_DrawModel3DViewToBitmapCanvas.

The Width and Height members of lpViewParameters are ignored because the bitmap size is specified in the call to C_CreateBitmapCanvas.

The FileFormat and JpegCompressionQuality members of lpViewParameters are ignored because they are specified in the TBitmapCanvasSaveFormat structure that is passed to C_SaveBitmapCanvas or C_SaveBitmapCanvasMem.