NAME

DsInqRendererNames − Return a list of the names of the installed renderers

SYNOPSIS

C:

void DsInqRendererNames(names)
DtPtr names[];

FORTRAN:

DSQRNS(NAMES, LENGTH)
CHARACTER NAMES(∗)∗LENGTH
INTEGER∗4 LENGTH

DESCRIPTION

DsInqRendererNames returns in the array names the names of the available renderers in the current Doré system.  The array names is assumed to be long enough to contain the complete list.  DsInqNumRenderers <DSQNR> returns the number of renderers and should be used to determine the necessary size of the array names. 

For example, in C you can dynamically allocate the necessary space:
 

DtPtr ∗names;
DtInt cnt;
cnt = DsInqNumRenderers();
names = (DtPtr ∗)malloc(cnt∗sizeof(DtPtr));
DsInqRendererNames(names);

FORTRAN, you can check to see if you have allocated enough space:
 

CHARACTER∗80 NAMES(10)
INTEGER∗4 CNT
CNT = DSQNR( )
IF (CNT .GT. 10)
WRITE (6,∗)’more than 10 renderers’
ELSE
DSQRNS(NAMES,80)
ENDIF

FORTRAN SPECIFIC

The parameter LENGTH specifies the length of each of the character arrays passed to DSQRNS.  Renderer names that are longer than LENGTH will be truncated to fit in the specified size. 

SEE ALSO

DsInqNumRenderers(3D)

September 02, 1992