C_CreateBitmapCanvas

C_CreateBitmapCanvas is used to create a bitmap image formed from multiple snapshots from one or more models. This functionality is used by making a sequence of function calls in this pattern:

  1. C_CreateBitmapCanvas specifying the bitmap width and height.
  2. Multiple calls to C_DrawModel3DViewToBitmapCanvas, once for each snapshot.
  3. C_SaveBitmapCanvas or C_SaveBitmapCanvasMem to save the final bitmap.
  4. C_DestroyBitmapCanvas to free memory allocated by C_CreateBitmapCanvas.

As indicated above, you can make a single call to C_CreateBitmapCanvas followed by calls to C_DrawModel3DViewToBitmapCanvas, C_SaveBitmapCanvas or C_SaveBitmapCanvasMem using the canvas handle obtained from C_CreateBitmapCanvas.

Once you have finished with the canvas, you must call C_DestroyBitmapCanvas to free memory allocated by C_CreateBitmapCanvas.

void C_CreateBitmapCanvas(

int Width,

int Height,

TOrcFxAPIHandle *lpCanvasHandle,

int *lpStatus

);

Parameters

Width, Height (IN)

Defines the size of the bitmap in pixels.

lpCanvasHandle (OUT)

Points to a variable in which the canvas handle will be returned.

lpStatus (OUT)

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

See also

C_CreateBitmapCanvasClone, C_DestroyBitmapCanvas, C_DrawModel3DViewToBitmapCanvas, C_SaveBitmapCanvasMem, C_SaveBitmapCanvas.