Syntax

[C/C++:]
void gEditSeg2D(int nseg, int tag, GMAT2D t2, int sw);
void gEditSeg3D(int nseg, int tag, GMAT3D t3, int sw);

[F90:]
subroutine gEditSeg2D(nseg, tag, t2, sw)
subroutine gEditSeg3D(nseg, tag, t3, sw)

integer, intent(in) :: nseg,tag
real, intent(in) :: t2(6),t3(16)
integer, intent(in) :: sw

Arguments

nseg
Picture segment number

tag
Segment tag identifier

t2,t3
2D or 3D transformation matrix

sw
Transformation mode switch

= GAPPLY,

Apply matrix according to current transformation mode

= GREPLACE,

Replace current transformation matrix

Description

The routines gEditSeg2D() and gEditSeg3D() replace the modelling transformation matrix that immediately follows the identifier tag in segment nseg, with matrix t2 or t3.

The argument sw determines the way in which the matrix will affect the modelling transformation when the segment is redrawn. If sw = GAPPLY then the new transformation matrix t2/t3 will be added to the existing modelling transformation matrix according to the current transformation mode (see gSetTransformMode()). If sw = GREPLACE then the matrix t2/t3 will replace the existing modelling transformation with the new matrix.

If the segment tag occurs more than once in the segment, all matrices following the tag will be edited.

If the identifier tag does not exist within the segment a warning message is output but if the tag is not followed by a transformation matrix, no action is taken.

See Also

gEditSeg2D Usage
gInsertSegTag
gSetTransformMode

---