Name

pe_pixmap − Creates a pixmap structure element. 

Operating States: PHOP, ∗, STOP, ∗
Digital PHIGS extension function
Creates a structure element

Syntax

void pe_pixmap (
  const Ppoint3   ∗position,    /∗ (I) Point to anchor the pixmap ∗/
  Pint             index        /∗ (I) Index into the pixmap table ∗/
)

Data Structures

typedef struct {
    Pfloat     x;    /∗ x coordinate ∗/
    Pfloat     y;    /∗ y coordinate ∗/
    Pfloat     z;    /∗ z coordinate ∗/
} Ppoint3;

Description

pe_pixmap creates a structure element.  During structure traversal (or immediate mode), Digital PHIGS examines the workstation table for pixmaps and places the pixmap on the screen in the Digital PHIGS xy-plane. 

Depending on the current edit mode, this function either inserts the new structure element directly after the element indicated by the pointer or replaces the element indicated by the pointer.  The pointer then points to the new pixmap element. 

The "hot spot" of the pixmap is at the offset in pixel units measured from the upper-left corner of the pixmap with y increasing down the screen.  The hot spot will be positioned over the projected modeling space pixmap origin (position).  You specify the offset using the pe_set_pixmap_rep function. 

Digital PHIGS follows the current hidden line and hidden surface (HLHSR) methods.  If Z buffering is enabled, Digital PHIGS sends the z value for the position argument to the Z buffer. 

If Digital PHIGS is in immediate mode, it performs this function immediately, but the function does not create a structure element. 

See Also

pe_inq_pixmap_rep
pset_depth_cue_ind
pe_set_pixmap_rep