NAME

DeAddClass − Add a user-defined class (object type)

SYNOPSIS

C:

DtInt DeAddClass(name, count, list, default_routine)
DtPtr name;
DtInt count;
DtInt list[];
DtPFI default_routine;

FORTRAN:

INTEGER∗4 DEAC(NAME, N, COUNT, LIST, DFLTRT)
CHARACTER∗N NAME
INTEGER∗4 COUNT
INTEGER∗4 LIST(∗)
EXTERNAL DFLTRT
 DEAMTH(LIST, METHOD, RTN, MTHCNT)
INTEGER∗4 LIST(∗)
INTEGER∗4 METHOD
EXTERNAL RTN
INTEGER∗4 MTHCNT

DESCRIPTION

DeAddClass adds a new class (object type) to the Doré system.  It returns a unique class identification number. 

Each class in Doré must have a unique name.  The parameter name specifies the name for the new class.   The convention is to name the class the same as the routine for creating an object of the new class. 

The parameter list is a list of Doré symbolic method names, and pointers to user-provided routines to be used as those methods in the new class.  Elements 0, 2, 4, etc. are method names.  Elements 1, 3, 5, etc. are the pointers to the user-provided routines.  Routine list[2n+1] is associated with method list[2n].  The parameter count specifies the number of methods in list. 

The parameter default_routine is a pointer to a routine that will be used for methods that are not specified in list, or DcNullPtr <DCNULL>. 

Methods used by user-defined primitives are:

DcMethodCmpBndVolume   <DCMCBV>
Compute bounding volume box.

DcMethodDestroy   <DCMDST>
Deallocate space used by object.

DcMethodDynRender   <DCMDR>
Dynamic rendering, if different from DcMethodStdRenderDisplay. 

DcMethodGlbrndIniObjs   <DCMGIO>
Production rendering, if different fromDcMethodStdRenderDisplay. 

DcMethodPick   <DCMPCK>
Determine if object has been picked.

DcMethodPrint   <DCMPRT>
Print object information.

DcMethodStdRenderDisplay <DCMSRD>
Update and execute alternate object.

DcMethodUpdStdAltObj <DCMSAO>
Update and return alternate object.

FORTRAN SPECIFIC

The parameter NAME is a string of length N representing the name of the new class. 

FORTRAN the method list is built using DEAMTH.  The calling routine must allocate space for the list (twice as many elements as methods to be inserted).  DEAMTH is called once for every method/routine pair to be added to the list.  The parameter MTHCNT is the number of methods that have already been added to the list. 

ERRORS

DeAddClass will fail if a method in list is invalid. 

[WARNING - invalid method]

September 02, 1992