formZ SDK | 5.0 API Reference | Project | Modeling | Selection (Pick)
Description
Retrieves world space coordinate of click locations for an item in the modeling Pick Buffer.
This is the 3D point on the selected entity at the click point.
For example, when a segment is selected, the value will be the 3D coordinate of the clicked location on the segment.
These values are sensitive to grid and direction snaps. For example, when a segment is selected near the midpoint of the segment,
and the midpoint snap is enabled, the point returned will be the midpoint of the segment.
If the selection was made using a non graphical pick, then an error is returned. Examples of non graphic
picking are the Objects Palette, The Select By dialog, Select All, a plugin function call or an area pick.
If the pick method uses a single point, then wpt2 will be {0.0,0.0,0.0}. Otherwise it will be a valid 3D point.
To determine if wpt2 is a valid pick point, use to get the screen coordiantes of the pick point.
If they are valid (i.e. not {-1,-1}), then wpt2 is also valid.
Plugin Prototype
fzrt_error_td fz_model_pick_get_pnts_world(
fzrt_int | windex, |
fzrt_int | pick_indx, |
wpt1, | |
wpt2 ) |
Parameters
windex [Input]
project window index
pick_indx [Input]
index of item in pick buffer.
Range: pick_indx >= 0
Range: pick_indx < ()
wpt1 [Result, Optional]
world point for first click point or {0.0,0.0,0.0} if none
wpt2 [Result, Optional]
world point for second click point or {0.0,0.0,0.0} if none
Returns
MODEL_ERR_PICK_INVALID if non graphical pick.
Availability
5.0.0.0
See Also
Function Set
Defined in