NAME

image_psom -- image unit of an existing psom

PROTOTYPE

unitptr image_psom( char *tMask, unitptr uPsom, unitptr uHost)

ARGUMENTS

char *tMask
mask string defining input and output pins
unitptr uPsom
unitptr of existing psom unit
unitptr uHost
host unit

DESCRIPTION:

Return an image unit of an existing psom unit with one input and one output field. The string tMask defines the number and correspondenc of the input pins by an ` i'' or ` I'', the output pins by an ` o '' or ` O ''. The number of character must match the X-dimension of uPsom. An exec call to the unit will copy the input X_in of the image_psom to the psom unit uPsom and executes an exec-call with the appropiate Z_in setting. The specified output pins of uPsom are copied to X_out. This unit does not follow the standart unit independence rule of nst. Each exec call modifies the in[0-3] and out[0-1] fields of the imaged psom unit. Adapt, save, load, and remove calls are not transfered and currently NOPs.

INTERFACE:

X_in[iNumIn]:
input pins mapped to X_in of uPsom. iNumIn equals the number of occurences of [iI] in tMask.
X_out[iNumOut]:
output pins mapped to X_out of uPsom. iNumOut equals the number of occurences of [oO] in tMask.

EXAMPLE:


    uPsom= psom(7, 3, aiKnots, NULL, NULL, ROOT);
    load_unit(fp, uPsom);
    uX2U = image_psom("ii-oo--", uPsom, ROOT);
     
This will create a uX2U with 2 inputs (mapped on uPsom pin 0 and 1) and 2 output pins (mapped on uPsom pin 3 and 4).

FILE

/amnt/loge/users/nistaff02/nistaff/rhaschke/nst7/man/../o.linux//../foldersrc/nst_psom_aux1.c