WinPicSaveImage

obj -> WinPicSaveImage(alpha1[, handle2[, int3[, int4[, int5]]]]) : int

Bildinhalt speichern

Details

• obj: Deskriptor des Picture -Objektes
• alpha1: Dateiname der externen Datei
• handle2: Deskriptor eines Memory -Objektes (optional)
• int3: Optionen (optional)
• int4: Hintergrundfarbe der Zeichnung (optional)
• int5: Qualitätsstufe (optional)
• Resultat: int Fehlercode
• Siehe: Verwandte Befehle , SignMode

Dieser Befehl speichert die Zeichnung aus dem Picture -Objekt (handle) in der Datei (alpha1) oder einem Memory -Objekt (handle2). Wird im Argument (handle2) ein Wert ungleich 0 angegeben, wird der Dateiname (alpha1) ignoriert.

Das Argument (int3) definiert das Dateiformat und die zu speichernden Inhalte. Folgende Konstanten können angegeben werden:

• _WinPicSignSaveAsExt - Format wird anhand des Dateinamens (alpha1) bestimmt. Dies ist nur möglich, wenn kein Memory -Objekt (handle2) angegeben wurde.
• _WinPicSignSaveAsJpg - Zeichnung im JPEG-Format speichern.
• _WinPicSignSaveAsPng - Zeichnung im PNG-Format speichern.
• _WinPicSignSaveAsTif - Zeichnung im TIFF-Format speichern.
• _WinPicSignSavePic - Inhalt des Picture -Objektes wird gespeichert.
• _WinPicSignSaveSign - Zeichnung wird gespeichert.
• _WinPicSignReset - Zeichnung wird gelöscht und nur das originale Bild im Picture -Objekt angezeigt.

Die Optionen _WinPicSignSavePic, _WinPicSignSaveSign und _WinPicSignReset können miteinander und je einer der _WinPicSignSaveAs...-Optionen kombiniert werden.

Wird das Bild extern als Datei gespeichert und die Option _WinPicSignSaveAsExt ist nicht angegeben, wird die Dateiendung des ausgewählten Formats dem Dateinamen hinzugefügt.

Ist keine der Optionen _WinPicSignSavePic und _WinPicSignSaveSign angegeben, wird auch kein Bild erzeugt. Wird hingegen das Argument (int3) nicht angegeben oder 0 übergeben, werden die Optionen _WinPicSignSaveAsJpg, _WinPicSignSavePic und _WinPicSignSaveSign kombiniert.

Im Argument (int4) kann ein Farbwert (siehe _WinCol... übergeben werden, mit dem der Hintergrund der Zeichnung gefüllt wird, wenn die Option _WinPicSignSavePic nicht angegeben ist. Wird _WinColUndefined angegeben, oder das Argument weggelassen, wird die Hintergrundfarbe vom Picture -Objekt verwendet. Für PNG- und TIFF-Dateien kann auch _WinColTransparent angegeben werden.

Das Argument (int5) definiert die Qualität des Bildes, wenn die Option _WinPicSignSaveAsJpg oder die Option _WinPicSignSaveAsExt in Kombination mit dem Dateityp '.jpg' angegeben ist. Es können Werte zwischen 1 und 100 verwendet werden. Standardmäßig wird eine Qualitätsstufe von 90 Prozent angewendet.

Resultat

Die Funktion gibt _ErrOk zurück, wenn die Zeichnung erfolgreich gespeichert wurde. Zusätzlich können folgende Fehlercodes zurückgegeben werden:

• _ErrGeneric: Allgemeiner Fehler aufgetreten.
• _ErrFsiOpenFailed: Externe Datei kann nicht geöffnet werden.
• _ErrFsiWriteFault: Externe Datei kann nicht geschrieben werden.
• _ErrUnavailable: Der Zeichnungsmodus ist nicht aktiv, die Dateiendung ist unbekannt oder es ist keine _WinPicSignSaveAs... -Konstante angegeben.
• _ErrMemExhausted: Speicher nicht ausreichend.

Beispiel:

  // Zeichnung inklusive Hintergrundbild als Datei Sign.jpg im temporären Verzeichnis speichern
  $picSign->WinPicSaveImage(_Sys->spPathTemp + '\Sign');

  // Zeichnung ohne Hintergrundbild als Datei Sign_Pure.png im temporären Verzeichnis speichern
  $picSign->WinPicSaveImage(_Sys->spPathTemp + '\Sign_Pure', 0, _WinPicSignSaveAsPng | _WinPicSignSaveSign);

  // Zeichnung im Memory-Objekt speichern und anschließend zurücksetzen
  $picSign->WinPicSaveImage('', tMemObj, _WinPicSignSaveAsPng | _WinPicSignSaveSign | _WinPicSignReset);

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Deskriptor des Picture -Objektes (obj) oder des Memory -Objektes (handle2) ist ungültig.