AcDbRasterImageDef

Class Hierarchy

AcRxObject
    AcGiDrawable
        AcDbObject
            AcDbRasterImageDef

C++

class AcDbRasterImageDef : public AcDbObject;

File

imgdef.h

Description

The AcDbRasterImageDef object (or "image definition object") works with the AcDbRasterImage entity (or "image entity") 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 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 AcDbDictionary named ISM_RASTER_IMAGE_DICT. These objects are not AutoCAD entities, so they can't be displayed or selected directly by the end user. They handle 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.)

Refer to the description of class AcDbRasterImage for more information.

Linking to acISMobj25.lib

Class AcDbRasterImageDef is implemented in an ObjectARX application called acISMui.arx. Your application must link to the ObjectARX API library acISMobj25.lib to use any of the methods specific to this class.

Note that the AcDbObject methods on this class can be accessed without linking to acISMobj25.lib. Simply cast the object pointer (for example, as returned by acdbOpenObject) to class AcDbObject.

Remarks

The library file is located at acISMobj25.lib

Links

AcDbRasterImageDef Enumerations, AcDbRasterImageDef Methods