HIC_Record_Selection

PURPOSE

Tells the system that a particular geometry element has been selected.

CALLING SEQUENCE

HIC_Record_Selection (nr, xyoff, bz, off1, offf2, off3)

----------------------------------------------------
nr      HT_Rendition   Rendition. Passed by reference.  
xyoff   float          Proximity.                       
bz      float          Z coordinate                     
off1    int            Offsets                          
off2    float                                           
off3    float                                           
----------------------------------------------------

DETAILS

This function lets you fake a selection, irrespective of what the user was pointing at in a selection event. It makes sense to call it only from a "select ..." callback function.

This function enters into the current selection list an item determined by the geometry in progress at the callback point (or the segment or window if called from a segment or window level callback), provided that the type of this geometry satisfies the current selectability and visibility criteria.

Further, you can specify the other relevant selection parameters as arguments to this function. In particular, the proximity xyoff is interpreted as the distance from the item to the locator position and bz is interpreted as the z coordinate. off1, offf2, and off3 are interpreted as the offsets specifying which part of the geometry element comes closest to the locator position, in a way that depends on the geometry type. See the discussion of Show_Selection_Element for the details.

Back


HIC_Restrict_Clipping

PURPOSE

Reduces the size of the clipping rectangle.

CALLING SEQUENCE

HIC_Restrict_Clipping (nr, nleft, nright, nbottom, ntop)

----------------------------------------------------------------------
nr        HT_Rendition   Rendition created with HIC_New_Rendition.        
                         Passed by reference.                             
nleft     int            Integer device coordinates of new clipping rect  
                         angle.                                           
nright    int                                                             
nbottom   int                                                             
ntop      int                                                             
----------------------------------------------------------------------

DETAILS

This function can only make the clipping rectangle smaller than it was. That is, if any of the specified new clipping limits nleft, nright, nbottom, ntop, lies outside the clipping rectangle already specified in the rendition nr, the value in the rendition is not changed.

Back