AutoCAD Images, Underlays, and OLE Objects

Use this skill when inserting or manipulating raster images, PDF/DWF/DGN underlays, OLE embedded objects, or wipeout masking entities in AutoCAD drawings.

Raster Image Definition

Every raster image requires a RasterImageDef stored in the ACAD_IMAGE_DICT dictionary. The definition holds the source file path and resolution; multiple RasterImage entities can reference the same definition.

public static ObjectId GetOrCreateImageDef(Database db, Transaction tr,
    string imagePath, string dictKey)
{
    ObjectId imageDictId = RasterImageDef.GetImageDictionary(db);
    if (imageDictId.IsNull)
        imageDictId = RasterImageDef.CreateImageDictionary(db);

    DBDictionary imageDict = (DBDictionary)tr.GetObject(
        imageDictId, OpenMode.ForWrite);