Object ProDisp

Function ProDispObjectCreate


Description
Create a Display Object. Display object is used to record application specific triangle data which is then displayed by Creo using creo lighting and materials. Display objects are attached to creo scene graph using ProDispObjectAttach and are rendered along creo native scene. Display objects will not participate in creo HLR calculations. They will always be displayed in shaded mode irrespective of what current view display mode is.
Synopsis
#include <ProDispObject.h>
ProErrorProDispObjectCreate(
ProName object_name
/* (In)
Name of new object. Name must be unique.
*/
int flag
/* (In)
Bit encoded flag to set property of display object 0x0 : If no bit is set display object will behave like a solid PRO_DISP_OBJECT_TWO_SIDED: When this bit is set object will behave like quilts PRO_DISP_OBJECT_DYNAMIC_PREVIEW: Object is temporary and will be deleted/recreated frequently. If this flag is not set then creo will try to put the data on graphics card to speed up its display. But if the flag is set this optimization will not be done because transferring data to graphics card will take more time than performance gain we will achieve by such transfer.
*/
int num_strips
/* (In)
The number of triangle strips
*/
int* strip_size
/* (In)
ProArray (of size num_strips) indicating the number of triangles in each strip
*/
ProTriVertex** strips_array
/* (In)
An array of num_strips triangle strips.
*/
ProDispObject* p_disp_obj
/* (Out)
a handle to the object that was created
*/
)
Returns
PRO_TK_NO_ERRORThe function succeeded.
PRO_TK_E_FOUNDObject with same name already exist. Delete previous object (or use new name)
PRO_TK_BAD_INPUTSOne or more input arguments was invalid.

Manual References:

  1. User Interface: Basic Graphics: Creating 3D Shaded Data for Rendering
  2. User Interface: Basic Graphics: Creating 3D Shaded Data for Rendering

Sample Code References:

  1. pt_examples ( TestDispObject.c )
  2. pt_examples ( TestDispObject.c )