IPictureObject - ABBYY Documentation

Stellt das Bild einer Seite oder einer Region dar. Das Objekt implementiert das interface IPicture und ermöglicht über das interface IDispatch den Zugriff auf einige seiner Eigenschaften. Weitere Einzelheiten zum interface IPicture finden Sie unter IPicture (ocidl.h) auf Microsoft Learn.

Dieses Objekt steht auf der Web-Verifizierungsstation für die lokale Prüfung von Regeln nicht zur Verfügung.

Methoden

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

Eigenschaften

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.

Bildeignung für OCR in einem Seitenkommentar erfassen

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

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();
    }
}