> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IPictureObject

> IPictureObject stellt in FlexiCapture-Skripten das Bild einer Seite oder Region dar und bietet Methoden zur Analyse von Objekten, zur Prüfung der OCR-Eignung und zur Erkennung der Orientierung.

<div id="what-it-does">
  ## Beschreibung
</div>

Stellt das Bild einer Seite oder einer Region dar.

Das Objekt implementiert die IPicture-Schnittstelle und ermöglicht über die IDispatch-Schnittstelle den Zugriff auf einige ihrer Eigenschaften. Weitere Informationen zur IPicture-Schnittstelle finden Sie unter [IPicture (ocidl.h)](https://learn.microsoft.com/en-us/windows/win32/api/ocidl/nn-ocidl-ipicture) auf Microsoft Learn.

<Info>
  Dieses Objekt ist in der Web-Verifizierungsstation nicht verfügbar, um Regeln lokal zu überprüfen.
</Info>

<div id="methods">
  ## Methoden
</div>

| Methode                                                                       | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AnalyzePageObjects( [optional] reserved : Object ) : IPictureObjectsInfo`    | Ermittelt die Objekte auf der Seite und gibt die vom Erkennungsmodul erkannten Seitenparameter zurück. Die Ausführung kann einige Zeit dauern.                                                                                                                                                                                                                                                                                        |
| `CalcSuitabilityForOCR() : float`                                             | Zeigt, wie gut ein Bild für OCR geeignet ist. Mögliche Werte liegen zwischen `0.0` und `1.0`. Ein Beispiel finden Sie unter [OCR-Eignung in einem Seitenkommentar erfassen](#record-ocr-suitability-in-a-page-comment).                                                                                                                                                                                                               |
| `CreateEditableCopy() : IEditablePictureObject`                               | Erstellt eine bearbeitbare Kopie des Bildes.                                                                                                                                                                                                                                                                                                                                                                                          |
| `DetectPageOrientation( [optional] language : string ) : int`                 | Erkennt die Orientierung der Seite anhand des darauf befindlichen Textes. Der [interne Name](/de/flexi-capture/appendix/scripts/internal-lang) der Sprache wird als Eingabeparameter übergeben. Wenn keine Sprache angegeben ist, wird die Sprache des aktuellen Gebietsschemas verwendet. Gibt den Winkel in Grad zurück, um den die Seite gedreht werden muss. Folgende Werte können zurückgegeben werden: `0`, `90`, `180`, `270`. |
| `IsPhoto() : bool`                                                            | Zeigt an, ob ein Bild ein Foto ist.                                                                                                                                                                                                                                                                                                                                                                                                   |
| `IsSuitableForOcr() : bool`                                                   | Zeigt an, ob ein Bild für OCR geeignet ist.                                                                                                                                                                                                                                                                                                                                                                                           |
| `SaveAs( filename : string, [optional] options : IExportImageSavingOptions )` | Speichert das Bild. Wenn keine Optionen angegeben sind, wird das Bild als `*.tif` gespeichert.                                                                                                                                                                                                                                                                                                                                        |

<div id="properties">
  ## Eigenschaften
</div>

| Name         | Typ         | Zugriff                                                                                                    | Beschreibung                                                                                                                                                      |
| ------------ | ----------- | ---------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Handle       | OLE\_HANDLE | Schreibgeschützt                                                                                           | Das Windows-GDI-Handle des Bildes. In .NET kann diese Eigenschaft mit der Methode System.Drawing.Image.FromHbitmap verwendet werden, um das Bildobjekt abzurufen. |
| Height       | int         | Schreibgeschützt                                                                                           | Die Höhe des Bildes in Punkten.                                                                                                                                   |
| hPal         | OLE\_HANDLE | Lesen/Schreiben, veränderbar (kann auch in Skripten mit schreibgeschützten Berechtigungen geändert werden) | Das Windows-Handle der vom Bild verwendeten Palette. Diese Eigenschaft kann als zweiter Parameter in System.Drawing.Image.FromHbitmap verwendet werden.           |
| IsBlackWhite | bool        | Schreibgeschützt                                                                                           | Gibt an, ob das Bild schwarz-weiß ist.                                                                                                                            |
| IsColor      | bool        | Schreibgeschützt                                                                                           | Gibt an, ob das Bild farbig ist.                                                                                                                                  |
| IsGrayscale  | bool        | Schreibgeschützt                                                                                           | Gibt an, ob das Bild Graustufen aufweist.                                                                                                                         |
| Type         | SHORT       | Schreibgeschützt                                                                                           | Der Typ des Bildes.                                                                                                                                               |
| Width        | int         | Schreibgeschützt                                                                                           | Die Breite des Bildes in Punkten.                                                                                                                                 |
| XResolution  | int         | Schreibgeschützt                                                                                           | Die horizontale Bildauflösung.                                                                                                                                    |
| YResolution  | int         | Schreibgeschützt                                                                                           | Die vertikale Bildauflösung.                                                                                                                                      |

<div id="record-ocr-suitability-in-a-page-comment">
  ## Bildeignung für OCR in einem Seitenkommentar erfassen
</div>

Dieses Skript schreibt die Ergebnisse der Methodenausführung für die ausgewählten Dokumente beim Klicken auf eine Benutzerschaltfläche in einen Seitenkommentar:

```csharp theme={null}
foreach( IDocument doc in MainWindow.Selection.Documents )
{
    MainWindow.TaskWindow.OpenDocument( doc );
    foreach( IPage page in doc.Pages )
    {
        IPictureObject picture = page.Picture;
        double score = (double)picture.CalcSuitabilityForOCR();
        bool verdict = (bool)picture.IsSuitableForOcr();
        page.Comment = score.ToString( "0.0000" ) + " / " + verdict.ToString();
    }
}
```