Funktionreferenz

_GDIPlus_ParamAdd

Beschreibung anzeigen in

Fügt einen Wert zu einer Encoder-Parameter-Liste hinzu

#include <GDIPlus.au3>
_GDIPlus_ParamAdd ( ByRef $tParams, $sGUID, $iNbOfValues, $iType, $pValues )

Parameter

$tParams $tagGDIPPENCODERPARAMS Struktur zurückgegeben aus _GDIPlus_ParamInit()
$sGUID Encoder Parameter GUID. Kann einer der folgenden Optionen sein:
    $GDIP_EPGCHROMINANCETABLE - Einstellungen der Farbwert-Tabelle
    $GDIP_EPGCOLORDEPTH - Einstellungen der Farbtiefe
    $GDIP_EPGCOMPRESSION - Einstellungen der Komprimierung
    $GDIP_EPGLUMINANCETABLE - Einstellungen der Leuchtdichte-Tabelle
    $GDIP_EPGQUALITY - Qualitätseinstellungen
    $GDIP_EPGRENDERMETHOD - Einstellungen der Render-Methode
    $GDIP_EPGSAVEFLAG - Einstellungen der Speichern-Flag
    $GDIP_EPGSCANMETHOD - Einstellungen des Scan-Modus
    $GDIP_EPGTRANSFORMATION - Transformationseinstellungen
    $GDIP_EPGVERSION - Einstellungen der Software-Version
$iNbOfValues Anzahl der Elemente im Array $pValues
$iType Encoder Typ des Parameter Wertes. Kann einer der folgenden Optionen sein:
    $GDIP_EPTBYTE - 8 Bit vorzeichenloser Integer (unsigned integer)
    $GDIP_EPTASCII - Null-terminierter String
    $GDIP_EPTSHORT - 16 Bit vorzeichenloser Integer (unsigned integer)
    $GDIP_EPTLONG - 32 Bit vorzeichenloser Integer (unsigned integer)
    $GDIP_EPTRATIONAL - Zwei longs (Zähler, Nenner)
    $GDIP_EPTLONGRANGE - Zwei longs (low, high)
    $GDIP_EPTUNDEFINED - Array von Bytes (jedes Typs)
    $GDIP_EPTRATIONALRANGE - Zwei longs (low, high)
$pValues Zeiger auf ein Array von Werten. Jeder Wert hat den Typ, der von dem Datenelement $iType festgelegt wurde.

Rückgabewert

Keine.

Verwandte Funktionen

$tagGDIPENCODERPARAMS, _GDIPlus_ParamInit

Beispiel

#include <GDIPlus.au3>
#include <ScreenCapture.au3>

Example()

Func Example()
    Local $hImage, $sCLSID, $tData, $tParams

    ; Erstellt vom kompletten Bildschirm einen Screenshot
    _ScreenCapture_Capture(@MyDocumentsDir & "\GDIPlus_Image.jpg")

    ; Initialisiert (startet) Microsoft Windows GDI+
    _GDIPlus_Startup()

    ; Lädt ein Bild
    $hImage = _GDIPlus_ImageLoadFromFile(@MyDocumentsDir & "\GDIPlus_Image.jpg")

    ; Gibt die Encoder CLSID für einen festgelegten Bild-Dateityp zurück
    $sCLSID = _GDIPlus_EncodersGetCLSID("JPG")

    ; Setzt die Parameter für eine 90 Grad Rotation
    $tData = DllStructCreate("int Data")
    DllStructSetData($tData, "Data", $GDIP_EVTTRANSFORMROTATE90)
    $tParams = _GDIPlus_ParamInit(1)
    _GDIPlus_ParamAdd($tParams, $GDIP_EPGTRANSFORMATION, 1, $GDIP_EPTLONG, DllStructGetPtr($tData, "Data"))

    ; Speichert das gedrehte Bild
    _GDIPlus_ImageSaveToFileEx($hImage, @MyDocumentsDir & "\GDIPlus_Image2.jpg", $sCLSID, DllStructGetPtr($tParams))

    ; Gibt die durch Microsoft Windows GDI+ verwendeten Ressourcen wieder frei
    _GDIPlus_Shutdown()

    ShellExecute(@MyDocumentsDir & "\GDIPlus_Image2.jpg")
EndFunc   ;==>Example