DetectOrientation-Methode des FRPage-Objekts

Diese Methode erkennt die Textorientierung im Bild. Die Methode gibt das Objekt TextOrientation zurück, wenn die Orientierung erfolgreich erkannt wurde, andernfalls NULL, wenn das Programm die Orientierung nicht erkennen konnte.

Syntax

C++

HRESULT DetectOrientation(
  IObjectsExtractionParams*    ExtractionParams,
  IRecognizerParams*           RecognizerParams,
  ITextOrientation**           Result
);

C#

ITextOrientation DetectOrientation(
  IObjectsExtractionParams    ExtractionParams,
  IRecognizerParams           RecognizerParams
);

Visual Basic .NET

Function DetectOrientation( _
  [ExtractionParams As IObjectsExtractionParams = Nothing], _
  [RecognizerParams As IRecognizerParams = Nothing] _
) As ITextOrientation

Parameters

ExtractionParams [in] Diese Variable verweist auf das Objekt ObjectsExtractionParams, das die Parameter für die Objektextraktion speichert. Dieser Parameter kann 0 sein. In diesem Fall werden die Objekte mit den Standardparametern extrahiert, oder – falls ein Profil geladen wurde – es werden die in diesem Profil festgelegten Parameter verwendet. RecognizerParams [in] Diese Variable verweist auf das Objekt RecognizerParams, das die Parameter der Seitenerkennung speichert. Dieser Parameter kann 0 sein. In diesem Fall werden die Standardparameter verwendet, oder – falls ein Profil geladen wurde – es werden die in diesem Profil festgelegten Parameter verwendet. Result [out, retval] Ein Zeiger auf eine Zeigervariable vom Typ ITextOrientation*, die den Schnittstellenzeiger des Ausgabeobjekts TextOrientation empfängt. Dieses Objekt ermöglicht den Zugriff auf die Textorientierung auf der Seite. Falls die Orientierungserkennung fehlschlägt, wird NULL zurückgegeben.

Rückgabewerte

Diese Methode hat keine spezifischen Rückgabewerte. Sie gibt die Standardrückgabewerte von ABBYY FineReader Engine-Funktionen zurück.

Beispiele

C#-Code

FREngine.IFRDocument frdoc;
// Wir setzen voraus, dass das Dokument erstellt und ihm Bilder hinzugefügt wurden
// Die Orientierung jeder Seite im Dokument abrufen
int pagesCount = frDoc.Pages.Count;
FREngine.RotationTypeEnum[] rotations = new FREngine.RotationTypeEnum[pagesCount];
for (int i = 0; i < pagesCount; i++)
{
 FREngine.IFRPage page = frDoc.Pages[i];
 FREngine.ITextOrientation ori = page.DetectOrientation(null, null);
 rotations[i] = FREngine.RotationTypeEnum.RT_UnknownRotation;
 if( ori != null ) {
  rotations[i] = ori.RotationType;
 }
}