INITIALIZE STRING 3

PINST3

CALL SEQUENCE

PINST3 (WKID, STDNR, LSTR, ISTR, PET, EVOL, LDR, DATREC)

INPUT PARAMETERS

INTEGER	WKID
INTEGER	STDNR
INTEGER	LSTR
CHARACTER*(*)	ISTR
INTEGER	PET
REAL	EVOL(6)
INTEGER	LDR
CHARACTER*80	DATREC(LDR)

ARGUMENTS

WKID

Workstation identifier.

STDNR

STRING input device identifier.

LSTR

Number of characters in the initial string.

ISTR

Initial string.

PET

Echo type.

EVOL(6)

Echo volume in DC.

LDR

Number of data records.

DATREC(LDR)

Data record.

PHIGS STATE

EFFECT

Devices 1 to 20 are available.

The following echo types are available:

1: Displays the current character string in the echo volume inside the graphic window.

Echo volume is given in DC coordinates

-1: Displays the current character string in the echo volume.in a separate window

Echo volume is given in percent of the RootWindow size.

The PPREC function is to be called as follows:

Initialize integer array IA:

IA(1): input buffer size.

IA(2): editing position.

call PPREC(2,IA,0,0,0,0,0,MLDR,IERR,LDR,DATREC) Example:

C Sample program for initialization of a string device 

	program string
 
	include 'PHIGS.H'

	integer wkid,stdnr,lstr,pet,ia(2),ierr,mldr,ldr
	character*6 str
	real evol(6)
	character*80 datrec

C Open PHIGS session 
	call POPPH(6,-1)

C Open workstation
	wkid = 1
	call POPWK(wkid,1,8887)

C Initialize string device number 1 with echo type number -1 
	mldr = 1
	ia(1) = 80
	ia(2) = 7
	call PPREC(2,ia,0,0,0,0,0,mldr,ierr,ldr,datrec)
	stdnr = 1
	lstr = 6
	str(1:6) = 'Enter:'
	pet = -1
	evol(1) = 0.
	evol(2) = .3
	evol(3) = 0.
	evol(4) = .1
	evol(5) = .0
	evol(6) = 1.
	call PINST3(wkid,stdnr,lstr,str,pet,evol
	+		,ldr,datrec)

C Close workstation
	call PCLWK(wkid)

C Close PHIGS session
	call PCLPH

	end

ERRORS

3

Ignoring function, function requires state (PHOP, WSOP,*,*)

54

Ignoring function, the specified workstation is not open

61

Ignoring function, specified workstation is neither of category INPUT nor of category OUTIN

250

Ignoring function, the specified device is not available on the specified workstation

251

Ignoring function, the function requires the input device to be in REQUEST mode

254

Ignoring function, invalid echo area volume: XMIN>=XMAX, YMIN>=YMAX or ZMIN>ZMAX

255

Ignoring function, one of the echo area volume boundary points is outside the range of the device

253

Ignoring function, the specified prompt echo type is not available on the specified workstation

260

Ignoring function, one of the fields within the input device data record is in error

261

Ignoring function, initial value is invalid

263

Ignoring function, length of the initial string is greater than the buffer size

SEE ALSO