This topic provides information on how to...

Import Annotations

Once ART marks have been exported/saved, they can be imported/reloaded (by the same user or a different user, using the same program or using any other ImageGear-enabled application). The way that the marks were saved will determine how they must be reloaded:

• .ART / .XML / .NXXML / image file / PDF file: Your application loads the image using any of the ImGearFileFormats Class Loadxxx methods and then loads ART page using the appropriate ImGearART.LoadPage Method.
• Burned In: Your application loads the image using any of the ImGearFileFormats Class Loadxxx methods. The burned-in remains of the marks are loaded as part of the image.  

Load Events

The ImGearART.LoadPage method allows the use of the following events:

• ImGearARTLoadEvents.CreateSecureObjectData
• ImGearARTLoadEvents.CreatingMark
• ImGearARTLoadEvents.CreatingGroup
• ImGearARTLoadEvents.CreatingPage
• ImGearARTLoadEvents.DroppedMark
• ImGearARTLoadEvents.DroppedAttribute
• ImGearARTLoadEvents.GetNotateXpressLayerPassword

These events occur during the loading of ART or NotateXpress™ marks.

• CreateSecureObjectData event is fired if the loaded Art object contains SecureObjectData.
• CreatingGroup event is fired before adding group object to ImGearARTPage.
• CreatingMark event is fired before adding mark object to ImGearARTPage.
• CreatingPage even is fired before returning a constructed Art Page object.
• DroppedMark event is fired for unsupported annotations.
• DroppedAttribute event is fired for unsupported annotation’s attributes/elements.
• GetNotateXpressLayerPassword event is fired during the loading of NotateXpress annotation file for all layers that were saved with a password.

Export Annotations

Once the end user of your application has created some marks, they may want to export/save them somewhere. Your application has the following choices of where to export them:

• Save them to a separate .ART file. This is a legacy ART storage format supported in previous versions of ImageGear ART. Using this method, your application will have to keep track of which .ART file goes with which image file, and load them together. Use ImGearART.SavePage Method with ImGearARTSaveType Enumeration.LEGACY parameter to do this.
• Save them to a separate .XML file. This is a more flexible and extendable storage format highly recommended for using. Using this method, your application will have to keep track of which .XML file goes with which image file, and load them together. Use ImGearART.SavePage Method with ImGearARTSaveType Enumeration.XML parameter to do this.
• Save the ART marks as tags or objects inside the image file. This option is only available for the raster file formats that support storing annotations, like TIFF files. Use the ImGearART.SavePage Method that takes ImGearPage Class to do this.
• Save the ART marks as annotations inside the PDF file. This option is only available for PDF format. Use the ImGearART.SavePage Method that takes ImGearPage Class to do this.
• "Burn In" the ART marks. This converts the ART marks from their native representation to the format of the raster image file, which usually destroys a lot of their functionality (for instance, once a mark is burned in to a JPEG image, it cannot be moved, resized or hidden). Use ImGearART.BurnIn Method to do this.