Name

pe_circle3 − Specifies the 3D, shorthand form of the unfilled circle primitive. 

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

Syntax

void pe_circle3 (
  const Ppoint3  ∗center,    /∗ (I) Center of the circle, in modeling
                                    coordinates ∗/
  Pfloat          radius     /∗ (I) Radius of the circle, in modeling
                                    coordinates ∗/
)

Data Structures

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

Description

pe_circle3 specifies the three-dimensional (x, y, and z) form of the unfilled circle primitive.  The circle is drawn in the plane z = n, where n is the z value of the argument center.  The circle local coordinate system is the xy-plane as defined in the modeling coordinate system. 

Depending on the 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 unfilled circle 3 element. 

Digital PHIGS generates an unfilled circle 3 during structure traversal.  If the radius of the circle is less than or equal to 0, Digital PHIGS displays a dot at the center of the circle.  Digital PHIGS binds the current values of the polyline primitive as defined in the PHIGS traversal state list to the primitive. 

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

Digital PHIGS Version 4.1 does not support this function.

See Also

padd_names_set
pinq_line_facs
premove_names_set
pset_depth_cue_ind
pset_hlhsr_id
pset_indiv_asf
pset_linetype
pset_linewidth
pset_pick_id
pset_line_colr
pset_line_colr_ind
pset_line_ind
pset_line_shad_method
pset_view_ind