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.

​

Beschreibung

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) auf Microsoft Learn.

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

​

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