ImageCreate

ImageCreate erzeugt ein Bildobjekt. Falls ein Dateiname angegeben wird, wird das Bildobjekt aus der Datei geladen.

hImg = ImageCreate(ssFileName)
hImg = ImageCreate(hImgOther)
hImg = ImageCreate(width, height)

Returnwert

hImg ist die Zugriffsnummer (Handle) des erzeugten Bildobjekts oder 0 falls das Objekt nicht erzeugt werden konnte.

Parameter

hImgOther

Falls hImgOther angegeben wird, erzeugt die Funktion eine Kopie von hImgOther.

ssFileName

ssFileName ist der Name einer Bilddatei. Folgende Typen werden zur Zeit unterstützt:

Typ Bedeutung
JPG Jpeg
PNG PNG
Gif Gif
TIFF Tagged Image File Format
BMP, BMZ Bitmap und Bitmap komprimiert.
WMF, WMZ Windows Meta File und Windows Meta File komprimiert.
EMF, EMZ Enhanced Meta File und Enhanced Meta File komprimiert.
EMF+, EMZ+ Enhanced Meta File with Extensions und Enhanced Meta File with Extensions komprimiert.
EMF+Dual, EMZ+Dual EMF und EMF+ in einer Datei kombiniert.

Anmerkung: Die Typen EMF, EMF+, EMF+Dual haben gewöhnlich alle die Dateierweiterung .emf.

width

width ist die Breite in Pixel.

height

height ist die Höhe in Pixel.

Beispiel

hDoc = DocCreate();
hPage = PageCreate();
hLayer = LayerCreate();
DocAddPage(hDoc, hPage);
PageAddLayer(hPage, hLayer);
ssImage = "d:/c0005.jpg"
hImg = ImageCreate(ssImage);
if (hImg == 0) {
    MessageBoxError("Image \"%s\" not found", ssImage);
    return;
}
LayerAddObjects(hLayer, hImg);
ImageUpdate(hImg);
PageReplot(hPage);

History

Version Beschreibung
R2018 Unterstützt zusätzlich die Formate TIFF, EMF+, EMF+Dual.
5.3.2 Die Funktion kann mit den Parametern width und height aufgerufen werden.
4.2.7 Funktion kann auch mit einem Parameter hImgOther aufgerufen werden (Kopier-Konstruktor).

id-1488459