ImageGear .NET v25.0 - Updated
ImGearARTImage Class
Members  Example 




ImageGear.Art Assembly > ImageGear.ART Namespace : ImGearARTImage Class
Represents ART Image mark.
Object Model
ImGearARTImage ClassImGearARTBorder ClassImGearRectangle StructureImGearRectangle StructureImGearPage Class
Syntax
'Declaration
 
Public Class ImGearARTImage 
   Inherits ImGearARTMark
'Usage
 
Dim instance As ImGearARTImage
public class ImGearARTImage : ImGearARTMark 
public __gc class ImGearARTImage : public ImGearARTMark 
public ref class ImGearARTImage : public ImGearARTMark 
Remarks
During loading of Image mark from XML the syntactic and sematic errors can be detected. Algorithm of loading tries to eliminate such errors and loads mark as possible. Structure of embedded image is presented by Data or PagedData elements. For images whose size is less than 256 kilobytes binary data of image is encoded as Base64 string and placed as inner text in Data element. For images with size greater 256 kilobytes the binary stream of image is divided into parts each of which does not exceed 256 kilobytes. Each part is encoded as Base64 string in DataPart element as inner text. DataPart elements are placed in PagedData. In correct state Mark element can contain only one Data or PagedData element. However, XML loading may processes few variants of their combinations. Loading process distinguishes three types of XML damages: broken Base64 encoding, broken image and image may be loaded but with error. If image has minor damages and may be loaded the loading process concerns such images as completly correct. The following rules are applied to XML during loading:
Example
// Setup rectangle for the image mark's location.
ImGearRectangle igRectangle = new ImGearRectangle(10, 10, 100, 100);
// Create image mark using a file "PNGTEST.png".
ImGearARTImage igARTImage = new ImGearARTImage(
    igRectangle, "PNGTEST.png"
);
// Add the annotation to the ARTPage.
igARTPage.AddMark(igARTImage, ImGearARTCoordinatesType.IMAGE_COORD);
' Setup rectangle for the image mark's location.
Dim igRectangle As New ImGearRectangle(10, 10, 100, 100)
' Create image mark using a file "PNGTEST.png".
Dim igARTImage As New ImGearARTImage( _
 igRectangle, "PNGTEST.png")
' Add the annotation to the ARTPage.
igARTPage.AddMark(igARTImage, ImGearARTCoordinatesType.IMAGE_COORD)
Inheritance Hierarchy

System.Object
   ImageGear.ART.ImGearARTSelection
      ImageGear.ART.ImGearARTMark
         ImageGear.ART.ImGearARTImage

See Also

Reference

ImGearARTImage Members
ImageGear.ART Namespace