Syntax

[C/C++:]
void gEnqSegHit(int *nseg, float x, float y, float radius, ...);

[F90:]
subroutine gEnqSegHit(nseg, x, y, radius)

integer, intent(out) :: nseg
real, intent(in) :: x,y,radius
integer, optional, intent(in) :: gOrder

Arguments

nseg
Picture segment number

= -1,

No picture segment in hit area

x,y
Picture coordinates of hit centre

radius
Radius of hit area in current units

Optional Args

gOrder
The order in which all segments are searched when using the Software Display File

= GCREATED,

Search in created order (default)

= GNUMERIC,

Search in numerical order

Description

The routine gEnqSegHit() simulates a light pen hit in a picture segment. The display buffer is searched for picture segments that are hit sensitive (see gSetSegHit()) and that cross the hit area radius. If none are found nseg will be set to -1. The hit area is centred at x,y and has a radius specified by radius. If more than one picture segment crosses the hit area, either the one closest to the hit centre or the next in the display file is chosen.

Some devices that support segments do not support this routine in hardware and software emulation is required.

See Also

gEnqSegHit Usage
gSetSegHit
gSetSegMode

---