In This Topic ▼

Encrypt Annotation Object

(Document and Medical Imaging toolkits)

The Encrypt annotation object (ANNOBJECT_ENCRYPT) is a rectangular object that is used to encrypt rectangular portions of a bitmap.

It can also be used to encrypt the entire bitmap. In automated mode, the Encrypt object is created by clicking and dragging the mouse to create the rectangular encrypt object. In design mode, the Encrypt object is visible but partially transparent to show the part of the image that it covers. In run mode, the encrypt object is invisible.

You must call the L_AnnEncryptApply function to apply the Encrypt object. Once applied, the portion of the bitmap under the Encrypt object becomes scrambled, and the Encrypt object state changes to decryptor. Using different keys before calling this function gives different scrambling patterns The decryptor state differs from the encryptor state in that a decryptor cannot be moved, and cannot be changed to an encryptor. The scrambling can be removed by calling the L_AnnEncryptApply on the decrypt object with the appropriate arguments. If successful, the decryptor state changes to encryptor. An Encrypt object in the encryptor state can be moved, can have its key changed, and can be changed to a c object.

The Encrypt object is useful for encrypting portions of a bitmap. After encrypting, the scrambled bitmap cannot easily be unscrambled without the associated annotation file. The scrambling can be removed by using the associated annotation file, or by using automation mode to manually change the state from encryptor to a decryptor, position it correctly, and setting the key appropriately.

For information on flipping, reversing or rotating annotation objects, refer to Flipping, Reversing and Rotating Annotation Objects.

With low-level functions, you must define the size and position of the rectangle. Other applicable properties have the following defaults, which you can change:

Property Defaults
Visible Defaults to FALSE. It can be changed using the L_AnnSetVisible function.
Selected Defaults to FALSE. It can be changed using the L_AnnSetSelected function.
Name Defaults to an empty string. It can be changed using the L_AnnSetNameOptions function.
Metafile Defaults to a black skeleton key. It can be changed using the L_AnnSetMetafile function.
Secondary Metafile Defaults to a red skeleton key. It can be changed using the L_AnnSetMetafile function.
Hyperlink Defaults to None. It can be changed using the L_AnnSetHyperlink function.
Tag (identifier) Defaults to 0. It can be changed using the L_AnnSetTag function.
Window handle Defaults to NULL or the handle inherited from the container. It can be changed for all objects using the L_AnnSetWnd function.
User mode Defaults to design mode or the mode inherited from the container. It can be changed for all objects using the L_AnnSetUserMode function.
Help Version 21.0.2023.2.15
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.