C++
virtual Acad::ErrorStatus load();
Description
This function enables "lazy loading" of the image pixel data from the source image file (specified by AcDbRasterImageDef::setSourceFileName) into an ATIL object. If the image is already loaded, Acad::eOk is returned. Requires that the AcDbRasterImageDef be open for writing. Triggers notification that causes all dependent AcDbRasterImage entities to be redrawn.
Note that with lazy loading, the image isn't physically loaded into memory until it is required (for example, to appear on the screen.) A delay may be noticed later when the image is physically loaded.
Returns Acad::eOk if successful, Acad::eInvalidInput otherwise.