Syntax

[C/C++:]
void gEnqSegTransform(int nseg, float *xsca, float *ysca, float *ang, GPOINT *pos);
void gEnqSegTransform2D(int nseg, GMAT2D a);

[F90:]
subroutine gEnqSegTransform(nseg, xsca, ysca, ang, pos)
subroutine gEnqSegTransform(nseg, xsca, ysca, ang, pos, xshear, yshear)
subroutine gEnqSegTransform2D(nseg,a)

integer, intent(in) :: nseg
real, intent(out) :: xsca,ysca,ang,xshear,yshear
type (GPOINT), intent(out) :: pos
real, intent(out) :: a(6)

Arguments

nseg
Picture segment number

xsca
Scaling factor for X coordinates

ysca
Scaling factor for Y coordinates

ang
Angle of rotation about anchor point

pos
Received coordinates of current anchor point

xshear
Optional shear factor in X direction

yshear
Optional shear factor in Y direction

a
3 x 2 array to receive the 2-D segment transformation matrix

Description

The routines gEnqSegTransform() and gEnqSegTransform2D() return the current segment transformation for segment nseg either as individual transformation elements or as a 2D transformation matrix.

These routines match the equivalent routines to set the segment transformation matrix, however, gEnqSegTransform() can only be used if the segment transformation was set using gSetSegTransform() which also uses separate values for the scale, rotation and position elements. gEnqSegTransfrom2D() can be used whichever routine was used to set the segment transform.

Where possible this information is obtained from the display file held in the device. If the software display file has been activated using gSetSegMode(), any information not obtainable from the hardware will be supplemented from information held in the software display file.

If no display file is being used or the segment doesn't exist, all arguments are returned as zero.

See Also

gEnqSegTransform Usage
gSetSegMode
gSetSegTransform

---