GDIndex.gif Previous-2.gif Next-3.gif

GDcreate_instance- GD API


Synopsis

create an instance from a given template name

 

OMobj_id   GDcreate_instance (
OMobj_id   parent_id ,
char  * class_name ,
char  * instance_name  );

Description

GDcreate_instance creates an instance given a template name.

Parameters

parent_id

The id of the new instance's parent object. The new object becomes an immediate subobject parent_id .

You can specify NULL. The new object becomes an immediate subobject of Applications, Default Applications, ModuleStack, or ScratchPad.

class_name

The name of the new object's class object, such as DefaultView.

instance_name

A name for the new instance.

Returned value

The object id of the new object; NULL if GDcreate_instance failed.

Example


/* Create a camera called mycamera. Its parent is app1_id.
  Its template is DefaultCamera. */
OMobj_id  app1_id; /* Assume this has been set. */
OMobj_id  mycamera_id;
...
mycamera_id = GDcreate_instance(app1_id, "DefaultCamera",
"mycamera");
if (OMis_null_elem(mycamera_id))
printf("Error creating camera\n");

 



GDIndex.gif Previous-2.gif Next-3.gif