[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

PACK DATA RECORD (PHOP,*,*,*)

Purpose

Use Pack Data Record to construct a data record for passing to input device initialization routines. The data record constructed by Pack Data Record consists of a header identifying the number of integers, reals, and character strings in the data record, followed by the actual data. Your application can pass the ldr and datrec output parameters to the desired input device initialization subroutine.

Pack Data Record accepts as input a list of integers, a list of reals, and a list of character strings. The length of each character string is specified in a separate array of lengths (lstr).

If the information is available, then the graPHIGS API sets the error indicator to zero and returns the values in the output parameters. If the information is unavailable, then the values returned in the output parameters are unpredictable and the graPHIGS API sets the error indicator to one of the following errors:

2
Function Requires State (PHOP,*,*,*)
2001
Output Parameter Size Insufficient
2003
Invalid Data Record

Note:

This utility is defined only for the FOTRAN binding.

Language Binding

FORTRAN

PPREC (il, ia, rl, ra, sl, lstr, str, mldr, errind, ldr, datrec)

Input Parameters

integer il
Number of integer entries (>=0).

integer ia(*)
Array containing integer entries.

integer rl
Number of real entries (>=0).

real ra(*)
Array containing real entries.

integer sl
Number of character string entries (>=0).

integer lstr(*)
Lengths of each character string entry (>=0).

character*(*) str(*)
Character string entries.

integer mldr
Dimension of the data record array.

Output Parameters

integer errind
Error indicator.

integer ldr
Number of array elements used in datrec.

character*80 datrec(mldr)
Data record.

FORTRAN Subset

PPREC (il, ia, rl, ra, sl, lstr, str, mldr, errind, ldr, datrec)

Input Parameters

integer il
Number of integer entries (>=0).

integer ia (il)
Array containing integer entries.

integer rl
Number of real entries (>=0).

real ra (rl)
Array containing real entries.

integer sl
Number of character string entries (>=0).

integer lstr(sl)
Lengths of each character string entry (>=0).

character*80 str(*)
Character string entries.

integer mldr
Dimension of the data record array.

Output Parameters

integer errind
Error indicator.

integer ldr
Number of array elements used in datrec.

character*80 datrec(mldr)
Data record.

Errors

None

Related Subroutines

  • Initialize Choice

  • Initialize Choice 3

  • Initialize Locator

  • Initialize Locator 3

  • Initialize Pick

  • Initialize Pick 3

  • Initialize String

  • Initialize String 3

  • Initialize Stroke

  • Initialize Stroke 3

  • Initialize Valuator

  • Initialize Valuator 3

  • Unpack Data Record

    • [ Previous | Next | Contents | Glossary | Home | Search ]