Flipping, Reversing and Rotating Annotation Objects

LEADTOOLS provides several methods for manipulating annotation objects so they are flipped, reversed, or rotated.

Use the LAnnotation::Flip function to flip one or more annotation objects, top to bottom. Objects that contain text cannot be flipped or reversed. If one or more such objects is in a group of objects that is flipped or reversed on a common axis, the text will move to the new position, but will retain its orientation.

Use the LAnnotation::Reverse function to reverse one or more annotation objects, left to right. Objects that contain text cannot be flipped or reversed. If one or more such objects is in a group of objects that is flipped or reversed on a common axis, the text will move to the new position, but will retain its orientation.

Use the LAnnotation::Rotate function to rotate one or more annotation objects.

New with Version 14.5 of LEADTOOLS are the LAnnotation::GetRotateOptions and the LAnnotation::SetRotateOptions functions to control the interface used for performing rotations. For Version 14.5 of LEADTOOLS, enable these functions by calling the LAnnotation::SetOptions function and passing OPTIONS_NEW_ROTATE. For more information, refer to New Annotation Features of Version 14.5.

Certain objects cannot be rotated (see the following list). If one or more such objects are in a group of objects that is rotated around a common center, those objects will move to new positions, but will retain their orientation.

Flipping and Reversing:

All annotation objects flip or reverse with the following notes:

ANN_OBJECT_AUDIO - metafile does not flip/reverse

ANN_OBJECT_BUTTON - text itself does not flip/reverse

ANN_OBJECT_ENCRYPT - metafile does not flip/reverse

ANN_OBJECT_FREEHANDHOTSPOT -- metafile does not flip/reverse

ANN_OBJECT_HOTSPOT - metafile does not flip/reverse

ANN_OBJECT_NOTE - text itself does not flip/reverse

ANN_OBJECT_POINT - if the point uses an image, the image does not flip/reverse

ANN_OBJECT_PUSHPIN - text itself does not flip/reverse

ANN_OBJECT_RTF - text itself does not flip/reverse

ANN_OBJECT_STAMP – the text flips/reverses, but the image and metafile do not flip/reverse

ANN_OBJECT_TEXT - text itself does not flip/reverse

ANN_OBJECT_TEXTPOINTER - the tail flips, but the text does not flip/reverse

ANN_OBJECT_VIDEO - metafile does not flip/reverse

Rotating:

All objects rotate EXCEPT for the following objects:

ANN_OBJECT_AUDIO

ANN_OBJECT_BUTTON

ANN_OBJECT_ENCRYPT

ANN_OBJECT_FREEHANDHOTSPOT – the object rotates, but not the metafile

ANN_OBJECT_HOTSPOT

ANN_OBJECT_NOTE

ANN_OBJECT_POINT

ANN_OBJECT_PUSHPIN

ANN_OBJECT_RTF

ANN_OBJECT_TEXTPOINTER

ANN_OBJECT_VIDEO

See Also

Displaying and Manipulating Annotation Objects