DsInqRendererNames(3D)

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 Dore 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)