.. highlightlang:: us

.. index:: ImageCreate

.. _imagecreate:

ImageCreate
===========

.. us.tag  ImageCreate NOTREADYGERMAN Image New360 Changed400 Changed427 Changed532 Changed6000

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

.. function::  hImg = ImageCreate(ssFileName)
               hImg = ImageCreate(hImgOther)
               hImg = ImageCreate(width, height)

.. us.return

**Returnwert**

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

.. us.params

**Parameter**

.. uparam:: hImgOther

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

.. uparam:: ssFileName

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

   .. list-table::
      :header-rows: 1

      * - 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``.

.. uparam:: width

   *width* ist die Breite in Pixel.

.. uparam:: height

   *height* ist die Höhe in Pixel.

.. us.example

**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);

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - 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).

.. seealso::
   :ref:`uberblick-bilder`,
   :ref:`ImageUpdate`,
   :ref:`ObjCopy`

:sub:`id-1488459`