AGD_ASSOC - Associate a device with AGI and IDI

Description:

This is a wrap-up routine to associate a device with the AGI database via the ADAM parameter system and open IDI on it. The size and position of an IDI window corresponding to the current picture in the database is returned. This routine calls AGI_ASSOC, AGI_BEGIN , AGD_ACTIV and AGD_NWIND. Also if the name string is not blank then AGI_RCL is called to recall the last picture of that name. This routine should be matched by a closing call to AGD_DEASS.

Invocation:

$\parbox{135mm}{CALL AGD\_ASSOC ( PARAM, ACMODE, PNAME, MEMID, PICID, DISPID, \\ XSIZE, YSIZE, XOFF, YOFF, STATUS )}$

Arguments:

PARAM = CHARACTER $*$ ( $*$ ) (Given)

The name of the ADAM parameter for accessing device names

ACMODE = CHARACTER $*$ ( $*$ ) (Given)

Access mode for pictures. 'READ', 'WRITE' or 'UPDATE'.

PNAME = CHARACTER $*$ ( $*$ ) (Given)

Recall last picture of this name if not blank.

MEMID = INTEGER (Given)

IDI Memory identifier.

PICID = INTEGER (Returned)

Picture identifier for current picture on given device.

DISPID = INTEGER (Returned)

IDI Display identifier.

XSIZE = INTEGER (Returned)

X size of window

YSIZE = INTEGER (Returned)

Y size of window

XOFF = INTEGER (Returned)

X offset of window from memory origin

YOFF = INTEGER (Returned)

Y offset of window from memory origin

STATUS = INTEGER (Given and Returned)

The global status.