Chapter 1. Control Subroutines

The control subroutines allow your application to have access to and control over the graphical resources available when using the graPHIGS API (*)

You can open and close the graPHIGS API and invoke the diagnostic trace for debugging.

When an application opens the graPHIGS API, a nucleus, which is the collection of resources available to your application, is connected to your application. When you connect the nucleus, you can create resources, such as workstations, structure stores, and font directories for use by your application. You can connect several application processes to the nucleus. Using the attach subroutines, several application processes share resources. Using message subroutines, application processes communicate with each other. In addition, your application can control the timing of when the graPHIGS API sends buffered transactions to the nucleus for processing.

Also invoke these subroutines to affect the timing of update operations and to explicitly control the update and redraw operations on a workstation.

These subroutines do not store or modify graphics data.

GPATR - Attach Resource

Purpose

Use GPATR to allow your application the use of resources created by other application processes that are connected to the specified nucleus. Use this subroutine when several application processes in different nodes (such as a host application and a Distributed Application Process [DAP]) share access and control of the same resource (such as a workstation or structure store)

The id parameter specifies an identifier to be assigned by your application to the attached resource. For example, if the type parameter specifies 1=WORKSTATION , then the application uses the specified id as the workstation identifier (wsid) of the attached workstation. Similarly, for the other resource types, the id parameter is used as the structure store identifier (ssid), image board identifier (ibid), font directory identifier (fdid), or archive file identifier (arid) respectively.

The rid parameter is obtained by the application process that created the resource by issuing the Inquire Nucleus Resource Identifier (GPQNCR) subroutine. It is the resource identifier assigned by the nucleus to the resource when it was created. The application process must then provide the assigned identifier (rid) and any required password (pass) to your application process for use by this subroutine.

If the specified resource type is 1=WORKSTATION , then the current workstation state is set to Workstation Open (WSOP)

If the specified resource type is 2=STRUCTURE_STORE , then the current structure state is set to Structure Store Open (SSOP) After attaching to the specified structure store, your application must issue the Select Structure Store (GPSSS) subroutine before any editing of the structure store is allowed.

If the specified resource type is 5=ARCHIVE_FILE , then the current archive state is set to Archive Open (AROP)

Parameters