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

INQUIRE DEFAULT LOCATOR DEVICE DATA 3 (PHOP,*,*,*)

Purpose

Use Inquire Default Locator Device Data 3 to inquire the default value of the specified locator device for the specified workstation type.

The graPHIGS API returns the default values for the requested locator device. The default initial locator position is in view zero, which has the highest view input priority by default. For more information on the defaults, see The graPHIGS Programming Interface: Technical Reference.

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,*,*,*)
52
Workstation Type Not Recognized By Implementation
51
Information Not Available For Generic Workstation Type
61
Specified Workstation Is Not Of Category Input Or Outin
250
Specified Device Not Available On Workstation

Language Bindings

C

pinq_def_loc_data3 (ws_type, loc_num, store, err_ind, loc_pos, pet_list, echo_vol, loc_data)

Input Parameters

Pint ws_type
Workstation type.

Pint loc_num
Locator device number (>=1).

Pstore store
Handle to the Store object. The graPHIGS API uses an object of type Store to facilitate the use of subroutines which return complex data. See Create Store CREATE STORE (PHOP,*,*,*) subroutine for details on how the graPHIGS API uses this parameter on inquiries.

Output Parameters

Pint *err_ind
Error indicator.

Ppoint3 *loc_pos
Default initial locator position in WC.

Pint_list **pet_list
List of prompt and echo types. The memory referenced by *pet_list is managed by the parameter store.

Plimit3 *echo_vol
Default echo volume in DC.

Ploc_data3 **loc_data
Default locator data record. The memory referenced by *loc_data is managed by the parameter store.

FORTRAN

PQDLC3 (wtype, devno, n, mldr, errind, dpx, dpy, dpz, ol, pet, evol, ldr, datrec)

Input Parameters

integer wtype
Workstation type.

integer devno
Locator device number (>=1).

integer n
List element requested (>=0).

integer mldr
Dimension of data record array (>=0).

Output Parameters

integer errind
Error indicator.

integer dpx
x coordinate of the default initial locator position in WC.

integer dpy
y coordinate of the default initial locator position in WC.

integer dpz
z coordinate of the default initial locator position in WC.

integer ol
Number of available prompt and echo types.

integer pet
nth element of the list of the available prompt and echo types.

real evol(6)
Default echo volume in DC (XMIN, XMAX, YMIN, YMAX, ZMIN, ZMAX).

integer ldr
Number of array elements used in the data record.

character*80 datrec(mldr)
Data record.

Errors

None

Related Subroutines

  • Initialize Locator

  • Initialize Locator 3

  • Inquire Locator Device State

  • Inquire Locator Device State 3

  • Inquire Default Locator Device Data

  • Inquire Workstation Connection And Type

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