CharParams-Objekt (ICharParams-Schnittstelle)

Dieses Objekt ermöglicht den Zugriff auf verschiedene Parameter eines einzelnen Zeichens im erkannten Text: seine Formatierung, sein Rectangle auf dem Image, die Erkennungssprache und die Erkennungshypothesen. Alle booleschen Eigenschaften eines neu erstellten Objekts dieses Typs sind auf FALSE gesetzt.

Wenn Sie mit den Parametern eines bestimmten Zeichens im erkannten Text arbeiten möchten, müssen Sie zunächst eine der Funktionen aufrufen, die die Synthesis durchführen (z. B. die Methode Process oder Synthesize des Objekts FRDocument), da diese Parameter erst nach der Synthesis aussagekräftig werden.

Wenn das Zeichen aus dem Text einer Visitenkarte stammt, sind nur die folgenden Eigenschaften des Objekts gesetzt:

BaseLine
Bottom
Left
Right
Top
IsSuspicious
ErrorProbability
CharacterRegion
CharacterRecognitionVariantIndex
CharacterRecognitionVariants
SelectedCharacterRecognitionVariant
WordRecognitionVariants
IsFromSourceContent
IsWordFirst
IsWordLeftmost

Eigenschaften


	,read-only	Gibt das Engine-Objekt zurück.

		Gibt die ID der Sprache des Zeichens an. Um sie in eine Win32-LCID umzuwandeln, verwenden Sie dieMethode. Standardmäßig wird diese Eigenschaft mit der systemseitigen Standard-Sprach-ID initialisiert.
		Speichert den internen Namen der Sprache für ein Zeichen und ermöglicht dessen Festlegung. Wenn eineBasiserkennungsspracheeinem erkannten Wort entspricht, wird die Eigenschaft LanguageName für jedes Zeichen in diesem Wort nach der Erkennung auf den internen Namen der Basissprache gesetzt. Wenn mehrere Basiserkennungssprachen einem Wort entsprechen (z. B. bei zweisprachigen Komposita), ist die Eigenschaft LanguageName für die Zeichen in diesem Wort leer. Die Eigenschaft LanguageId hingegen enthält stets den Bezeichner der Basissprache, unabhängig vom erkannten Wort. Standardmäßig ist der Wert dieser Eigenschaft eine leere Zeichenfolge.

		Gibt die genaue Region des Zeichens an. Die Region muss nicht rechteckig sein und ist anfänglich in dem durch die Eigenschaften Left, Top, Right und Bottom definierten Rechteck enthalten. Wenn Sie die genaue Region des Zeichens ändern, werden die Eigenschaften Left, Top, Right und Bottom nicht geändert. Die Eigenschaft ist nur nach der Erkennung verfügbar, wenn die Eigenschaftauf TRUE gesetzt ist. Die Eigenschaft gibt ein konstantes Objekt zurück. Um die genaue Region des Zeichens zu ändern, müssen Sie zunächst ein intermediäres Region-Objekt mithilfe derIEngine::CreateRegionMethode abrufen, die erforderlichen Parameter ändern und das erhaltene Objekt anschließend der Eigenschaft zuweisen.
	, nur lesbar	Speichert die Koordinate des unteren Rands des Zeichenrechtecks. Dieses Rechteck ist auf dem Bild definiert, ohne die Textausrichtung zu berücksichtigen. Es kann undefiniert sein; in diesem Fall sind alle vier Koordinaten null. Diese Eigenschaft kann nicht direkt, sondern nur über die SetRect-Methode geändert werden. Der Standardwert dieser Eigenschaft ist 0.
	, nur lesbar	Speichert die Koordinate des linken Rands des Zeichenrechtecks. Dieses Rechteck ist auf dem Bild definiert, ohne die Textausrichtung zu berücksichtigen. Es kann undefiniert sein; in diesem Fall sind alle vier Koordinaten null. Diese Eigenschaft kann nicht direkt, sondern nur über die SetRect-Methode geändert werden. Der Standardwert dieser Eigenschaft ist 0.
	, nur lesbar	Speichert die Koordinate des rechten Rands des Zeichenrechtecks. Dieses Rechteck ist auf dem Bild definiert, ohne die Textausrichtung zu berücksichtigen. Es kann undefiniert sein; in diesem Fall sind alle vier Koordinaten null. Diese Eigenschaft kann nicht direkt, sondern nur über die SetRect-Methode geändert werden. Der Standardwert dieser Eigenschaft ist 0.
	, read-only	Speichert die Koordinate des oberen Rands des Zeichenrechtecks. Dieses Rechteck ist auf dem Bild definiert, ohne die Textorientierung zu berücksichtigen. Es kann undefiniert sein; in diesem Fall sind alle vier Koordinaten null. Diese Eigenschaft kann nicht direkt geändert werden, sondern nur über die SetRect-Methode. Der Standardwert dieser Eigenschaft ist 0.

		Gibt an, ob das Zeichen das am weitesten links stehende Zeichen in einem Wort ist. In komplexen Situationen (z. B. zwei Wörter ohne Leerzeichen dazwischen oder ein Wort mit einem Satzzeichen ohne Leerzeichen) funktioniert diese Eigenschaft möglicherweise nicht korrekt. Der Recognizer kann die Hypothese über die Anzahl der Wörter ändern, nachdem die Flags für Zeichen gesetzt wurden. Diese Eigenschaft wird während der Synthese gesetzt. Wird die Eigenschaft aufgerufen, bevor die Synthese abgeschlossen ist, ist sie standardmäßig FALSE. FürChinesisch, Japanisch oder Koreanischist diese Eigenschaft unzuverlässig, da Wörter nicht erkannt werden.
		Gibt an, ob das Zeichen das erste Zeichen in einem Wort ist. Diese Eigenschaft wird während der Synthese gesetzt. Wird die Eigenschaft aufgerufen, bevor die Synthese abgeschlossen ist, ist sie standardmäßig FALSE. Hinweise: Bei Sprachen mit Schreibrichtung von rechts nach links (z. B. Hebräisch) gibt diese Eigenschaft das am weitesten rechts stehende Zeichen im Wort an. FürChinesisch, Japanisch oder Koreanischist diese Eigenschaft unzuverlässig, da Wörter nicht erkannt werden.
		Legt die Verschiebung eines Zeichens von der Grundlinie der Zeichenkette in Pixeln fest. Die Grundlinie der Zeichenkette wird durch dieEigenschaft definiert. Diese Eigenschaft wird hauptsächlich für in Text eingebettete Bilder verwendet. Der Standardwert dieser Eigenschaft ist 0.
		Gibt den zusätzlichen Abstand zwischen Zeichen in Twips an. Ein Twip entspricht 1/20 eines Punkts, und ein Punkt entspricht 1/72”. Der Standardwert dieser Eigenschaft ist 0.
		Speichert die horizontale Skalierung eines Zeichens in 1/1000. Wenn das Zeichen aus dem Text einer Visitenkarte stammt, hat diese Eigenschaft den Standardwert. Der Standardwert dieser Eigenschaft ist 1000, was keiner Skalierung entspricht.

		Legt den RGB-Wert der Farbe für das Symbol fest. Die Hintergrundfarbe wird für den gesamten Absatz durch dieEigenschaft definiert. Der Wert dieser Eigenschaft kann -1 sein, was bedeutet, dass die Farbe transparent ist. Der int-Wert wird aus dem RGB-Triplett nach folgender Formel berechnet: ( Rotwert ) + (256 x Grünwert ) + (65536 x Blauwert ), wobei der Rotwert die erste Triplettkomponente, der Grünwert die zweite und der Blauwert die dritte Triplettkomponente ist. Der int-Wert der Farbe Weiß beträgt beispielsweise 16777215. Standardmäßig ist die Textfarbe Schwarz bzw. RGB(0,0,0).
		Gibt an, ob das Zeichen fett formatiert ist. Wenn das Zeichen aus dem Text einer Visitenkarte stammt, hat diese Eigenschaft den Standardwert. Diese Eigenschaft ist standardmäßig FALSE.
		Gibt an, ob das Zeichen kursiv formatiert ist. Wenn das Zeichen aus dem Text einer Visitenkarte stammt, hat diese Eigenschaft den Standardwert. Diese Eigenschaft ist standardmäßig FALSE.
		Gibt an, ob das Zeichen unterstrichen ist. Diese Eigenschaft ist standardmäßig FALSE.
		Gibt an, ob das Zeichen durchgestrichen ist. Wenn das Zeichen aus dem Text einer Visitenkarte stammt, hat diese Eigenschaft den Standardwert. Diese Eigenschaft ist standardmäßig FALSE.
		Gibt an, ob das Zeichen tiefgestellt ist. Diese Eigenschaft kann nicht gleichzeitig mit der Eigenschaft IsSuperscript auf TRUE gesetzt werden, da dies beim Export von erkanntem Text zu Fehlern führt. Wenn das Zeichen aus dem Text einer Visitenkarte stammt, hat diese Eigenschaft den Standardwert. Diese Eigenschaft ist standardmäßig FALSE.
		Gibt an, ob das Zeichen hochgestellt ist. Diese Eigenschaft kann nicht gleichzeitig mit der Eigenschaft IsSubscript auf TRUE gesetzt werden, da dies beim Export von erkanntem Text zu Fehlern führt. Wenn das Zeichen aus dem Text einer Visitenkarte stammt, hat diese Eigenschaft den Standardwert. Diese Eigenschaft ist standardmäßig FALSE.
		Gibt an, ob das Zeichen den Stil „Kapitälchen” aufweist. Das bedeutet, dass Kleinbuchstaben als kleine Großbuchstaben dargestellt werden. Diese Eigenschaft ist standardmäßig FALSE.

	, nur lesbar	Speichert den Namen der Schriftart für ein Zeichen. Diese Eigenschaft kann nicht direkt geändert werden, sondern nur über die Methode SetFont. Der Standardwert ist „Times New Roman”.
		Gibt die Schriftgröße des Zeichens in Twips an. Ein Twip entspricht 1/20 eines Punktes, ein Punkt entspricht 1/72 Zoll. Der Standardwert dieser Eigenschaft entspricht 10 Punkten bzw. 200 Twips.
		Ermöglicht den Zugriff auf den Schriftstil des Zeichens.
	, nur lesbar	Speichert den Schrifttyp für ein Zeichen. Diese Eigenschaft kann nicht direkt geändert, sondern über die SetFont-Methode. Standardmäßig ist dieser Wert FT_Unknown.

		Gibt TRUE zurück, wenn das Zeichen unzuverlässig erkannt wurde. Verwenden Sie diese Eigenschaft, um zu bestimmen, ob eine Verifizierung erforderlich ist. Diese Eigenschaft wird auf Basis des ErrorProbability-Werts und der Erkennungseinstellungen berechnet. Wenn Sie eine differenziertere Unterscheidung für die Verifizierung benötigen, verwenden Sie stattdessen ErrorProbability. Diese Eigenschaft ist standardmäßig FALSE.
	, nur lesbar	Gibt die geschätzte Wahrscheinlichkeit (im Bereich von 0 bis 100) zurück, dass das Zeichen falsch erkannt wurde. Die Fehlerwahrscheinlichkeit berücksichtigt den gesamten Kontext und ist daher nur für das Erkennungsergebnis verfügbar, nicht für jede einzelne Zeichenerkennungsvariante. Um Erkennungsvarianten miteinander zu vergleichen, verwenden Sie. Die Fehlerwahrscheinlichkeit wird nicht für Zeichen berechnet, die ohne Erkennung gewonnen wurden, beispielsweise solche, die direkt aus der Quell-PDF-Datei entnommen wurden.
	,read-only	Gibt eine Sammlung von Zeichenerkennungsvarianten zurück. Die Eigenschaft enthält null für nicht druckbare Zeichen (Leerzeichen, Zeilenumbrüche usw.) sowie für Zeichen, die nicht erkannt, sondern beim expliziten Bearbeiten zum Text hinzugefügt wurden. Null wird auch zurückgegeben, wenn der Text mit einer früheren Version von ABBYY FineReader Engine erkannt wurde. Wenn die-Eigenschaft auf FALSE gesetzt ist, enthält die zurückgegebene Sammlung ein Element; andernfalls enthält die Sammlung mindestens ein Element, und die Varianten sind von der besten zur schlechtesten geordnet.
	, nur lesbar	Speichert den Index der ausgewählten Zeichenerkennungsvariante in der CharacterRecognitionVariants-Sammlung.
	,read-only	Speichert die ausgewählte Zeichenerkennungsvariante. Es handelt sich um das Element mit dem Index CharacterRecognitionVariantIndex in der Sammlung der Zeichenerkennungsvarianten (die Eigenschaft CharacterRecognitionVariants).
	,read-only	Gibt eine Sammlung von Erkennungsvarianten für das Wort zurück, zu dem das Zeichen gehört. Die Eigenschaft enthält null für nicht druckbare Zeichen (Leerzeichen, Zeilenumbrüche usw.) sowie für Zeichen, die nicht erkannt, sondern beim expliziten Bearbeiten zum Text hinzugefügt wurden. Null wird auch zurückgegeben, wenn der Text mit einer früheren Version von ABBYY FineReader Engine erkannt wurde. Wenn die-Eigenschaft auf FALSE gesetzt ist, enthält die zurückgegebene Sammlung ein Element; andernfalls enthält die Sammlung mindestens ein Element, und die Varianten sind vom besten zum schlechtesten geordnet, bestimmt durch den internen Schätzmechanismus.
	, nur lesbar	Gibt an, ob das Zeichen ohne Erkennung aus dem Textinhalt der Eingabedatei extrahiert wurde. Dies kann beispielsweise bei einer PDF-Datei mit einer Textebene der Fall sein.
		Gibt an, ob für dieses Zeichen eine Rechtschreibprüfung durchgeführt wurde. Dieser Wert wird von ABBYY FineReader Engine intern weder verwendet noch gesetzt und bietet lediglich einen Rahmen für die Rechtschreibprüfung.

Methoden

Name	Beschreibung
CopyFrom	Initialisiert die Eigenschaften des aktuellen Objekts mit den Werten entsprechender Eigenschaften eines anderen Objekts.
SetFont	Legt die neue Schriftart für das Symbol fest.
SetRect	Legt das neue Rectangle für das Symbol fest.

Objektdiagramm

Ausgabeparameter

Dieses Objekt ist der Ausgabeparameter der folgenden Methoden:

CreateCharParams-Methode des Objekts Engine
GetDropCapCharParams-Methode des Objekts Paragraph
GetCharParams-Methode des Objekts BusinessCardField
GetCharParams-Methode des Objekts BusinessCardFieldComponent
GetCharParams-Methode des Objekts MrzField

Eingabeparameter

Dieses Objekt wird als Eingabeparameter an die folgenden Methoden übergeben:

GetCharParams, SetCharParams, Insert und InsertParagraphBreak des Objekts Paragraph
GetCharParams-Methode des Objekts WordRecognitionVariant
Insert-Methode des Objekts MrzField

Beispiele

C# code

int suspiciousCharsCount = 0;
// Berechnet die Anzahl verdächtiger Zeichen in einem Textblock
void computeStatisticsForBlock(FREngine.IBlock block)
{
 if (block.Type == FREngine.BlockTypeEnum.BT_Text)
 {
  FREngine.ITextBlock textBlock = block.GetAsTextBlock();
  int paragraphsCount = textBlock.Text.Paragraphs.Count;
  for (int iPar = 0; iPar < paragraphsCount; iPar++)
  {
   FREngine.IParagraph par = textBlock.Text.Paragraphs[iPar];
   string text = par.Text;
   FREngine.ICharParams charParams = engine.CreateCharParams();
   for (int iChar = 0; iChar < text.Length; iChar++)
   {
    par.GetCharParams(iChar, charParams);
    if (charParams.IsSuspicious)
    {
     suspiciousCharsCount++;
    }
   }
  }
 }
}

Das Objekt wird in folgenden Codebeispielen verwendet: RecognizedTextProcessing (Win) sowie in den Windows-Demo-Tools: Engine Predefined Processing Profiles.

Siehe auch

Paragraph Was ist der Unterschied zwischen CharConfidence, ErrorProbability und IsSuspicious? Arbeiten mit Text Arbeiten mit Eigenschaften

Übersicht

Funktionen

Engine-Objekt (IEngine-Schnittstelle)

Engine-Loader

Bildbezogene Objekte

Layoutbezogene Objekte

Sprachbezogene Objekte

Textbezogene Objekte

Dokumentbezogene Objekte

Batch-Prozessor

Mechanismusobjekte

Parameterobjekte

Klassifizierungsbezogene Objekte

Lizenzbezogene Objekte

Objekte für den Dokumentvergleich

Ergänzende Objekte und Methoden

Enumerationen

CharParams-Objekt (ICharParams-Schnittstelle)

Eigenschaften

Methoden

Ausgabeparameter

Eingabeparameter

Beispiele

Siehe auch

Übersicht

Funktionen

Engine-Objekt (IEngine-Schnittstelle)

Engine-Loader

Bildbezogene Objekte

Layoutbezogene Objekte

Sprachbezogene Objekte

Textbezogene Objekte

Dokumentbezogene Objekte

Batch-Prozessor

Mechanismusobjekte

Parameterobjekte

Klassifizierungsbezogene Objekte

Lizenzbezogene Objekte

Objekte für den Dokumentvergleich

Ergänzende Objekte und Methoden

Enumerationen

​Eigenschaften

​Methoden

​Zugehörige Objekte

​Ausgabeparameter

​Eingabeparameter

​Beispiele

​Siehe auch

Eigenschaften

Methoden

Zugehörige Objekte

Ausgabeparameter

Eingabeparameter

Beispiele

Siehe auch