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

Chapter 3. Attribute Specification

Attribute values describe the appearance of output primitives, including size, shape, style, and color.

This group of subroutines creates structure elements and requires that the structure state is Structure Open (STOP). When the graPHIGS API encounters the elements in this section at structure traversal time, it modifies the current traversal time registers.

Your application can specify some attribute values directly through a structure element or indirectly by using an index to a bundle table in the Workstation State List (WSL). During structure traversal, the current Attribute Source Flag (ASF) setting determines whether the graPHIGS API draws a primitive using an individual or bundled value of an attribute. For a complete discussion of attributes, see The graPHIGS Programming Interface: Understanding Concepts.

For attribute values supported on a specific workstation, use the appropriate Inquiry programming subroutines or see The graPHIGS Programming Interface: Technical Reference.

ADD NAMES TO SET (PHOP,*,STOP,*)

Purpose

Use Add Names to Set to insert an Add Names to Set structure element into the open structure following the element pointer or replace the element pointed at by the element pointer with an Add Names to Set structure element, depending on the current edit mode.

During structure traversal, this structure element adds the specified class names to the current class set. The traversal default is a null name set.

Class names let an application control the eligibility of a primitive for pickability (detectability), highlighting, and invisibility by associating the primitive with a class set.

When the graPHIGS API encounters a primitive during structure traversal, the primitive belongs to the classes contained in the current class set. If the workstation does not support a specified name, then the graPHIGS API ignores the name and the name has no affect on the primitive.

Also use names to create inclusion and exclusion filters for the specified workstation. The graPHIGS API uses these filters in conjunction with the class set traversal state to determine whether pickability, highlighting, and visibility apply. The filters act independently of each other. During structure traversal, the graPHIGS API compares the current class set to the current filters.

For a complete discussion of class names and filters, see The graPHIGS Programming Interface: Understanding Concepts.

Language Bindings

C

padd_names_set (names)

Input Parameters

const Pint_list *names
Name set to be added.

FORTRAN

PADS (n, namset)

Input Parameters

integer n
Number of names in the set.

integer namset(n)
Name set to be added.

Errors

5
Function Requires State (PHOP,*,STOP,*)

Related Subroutines

  • Inquire PHIGS Facilities

  • Remove Names From Set

  • Set Highlighting Filter

  • Set Invisibility Filter

  • Set Pick Filter


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