This .NET class wraps the AcDbRasterImage ObjectARX class.
The RasterImage entity (or "image entity") works with the RasterImageDef object (or "image definition object") to implement raster images inside AutoCAD. The relationship between these two classes is much like the relationship between an AutoCAD block definition object and a block insert entity.
The image entity is a drawable, selectable AutoCAD entity that places a raster image in model or paper space at a particular location and orientation. The image entity is linked to exactly one image definition object, to which it sends requests for image processing operations needed for displaying and plotting images. Because the image definition object manages all the image information, the image entity is relatively small. Besides the image location and orientation, it contains a clip boundary, image fade, contrast and brightness parameters and other typical Entity properties like layer and color.
Two or more image entities can be linked to a single image definition object. Since each image entity has its own clip boundary, this is an efficient way to display different regions of a single raster image at different positions in the drawing.
The RasterImage entity must sometimes translate between two coordinate systems: 3D model coordinates in which Entities live and 2D pixel coordinates that the RasterImageDef object understands. For this purpose, the image entity carries inside it a planar bounding rectangle, specified in 3D World Coordinates, that outlines the raw image boundary as it floats in space. Several API functions are available to help translate between pixel and model coordinates.
The image definition object plays a behind-the-scenes role like the block definition, maintaining links to the source image file and managing low-level image processing operations required to display and plot images. Image definition objects are stored in a special AutoCAD dictionary. They are not AutoCAD entities, so they can't be displayed or selected directly by the end user. They understand only 2D pixel coordinates, so all image processing requests must be expressed as 2D operations.
Image processing operations, like scaling and rotating the image for display, are executed by the Autodesk Image Engine. The Image Engine has its own extensive developer API on which sophisticated image editing applications can be built. (Information on the Autodesk Image Engine is available through the Autodesk Developer Program.)
The RasterImage entity cannot be used by itself. It must be linked to an RasterImageDef object to display images by using RasterImage.ImageDefId. Furthermore, an RasterImageDefReactor must be constructed and linked to RasterImage entity and RasterImageDef object.
Public Class RasterImage Inherits Image
public class RasterImage : Image;
| Comments? |