IPictureObject - ABBYY Documentation

Représente l’image d’une page ou d’une région. L’objet implémente l’interface IPicture et donne accès à certaines de ses propriétés via l’interface IDispatch. Pour plus de détails sur l’interface IPicture, consultez IPicture (ocidl.h) sur Microsoft Learn.

Cet objet n’est pas disponible sur la Web Verification Station pour la vérification locale des rules.

Méthodes

Méthode	Description
`AnalyzePageObjects( [optional] reserved : Object ) : IPictureObjectsInfo`	Définit les objets présents sur la page et renvoie les paramètres de la page tels qu’ils sont perçus par le module de reconnaissance. L’opération peut prendre un certain temps.
`CalcSuitabilityForOCR() : float`	Indique dans quelle mesure une image est adaptée à l’OCR. Les valeurs possibles vont de `0.0` à `1.0`. Pour obtenir un exemple, consultez Enregistrer l’adéquation à l’OCR dans un commentaire de page.
`CreateEditableCopy() : IEditablePictureObject`	Crée une copie modifiable de l’image.
`DetectPageOrientation( [optional] language : string ) : int`	Détecte l’orientation de la page à partir du texte qu’elle contient. Le nom interne de la langue est transmis en tant que paramètre d’entrée. Si aucune langue n’est spécifiée, celle des paramètres régionaux actuels est utilisée. Renvoie l’angle (en degrés) selon lequel la page doit être pivotée. Les valeurs suivantes peuvent être renvoyées : `0`, `90`, `180`, `270`.
`IsPhoto() : bool`	Indique si une image est une photo.
`IsSuitableForOcr() : bool`	Indique si une image est adaptée à l’OCR.
`SaveAs( filename : string, [optional] options : IExportImageSavingOptions )`	Enregistre l’image. Si aucune option n’est spécifiée, l’image est enregistrée au format `*.tif`.

Propriétés

Nom	Type	Accès	Description
Handle	OLE_HANDLE	Lecture seule	Le handle GDI Windows de l’image. Dans .NET, cette propriété peut être utilisée avec la méthode System.Drawing.Image.FromHbitmap pour récupérer l’objet image.
Height	int	Lecture seule	La hauteur de l’image en points.
hPal	OLE_HANDLE	Lecture/écriture, modifiable (peut être modifiée même dans les scripts disposant d’autorisations en lecture seule)	Le handle Windows de la palette utilisée par l’image. Cette propriété peut être utilisée comme second paramètre de System.Drawing.Image.FromHbitmap.
IsBlackWhite	bool	Lecture seule	Indique si l’image est en noir et blanc.
IsColor	bool	Lecture seule	Indique si l’image est en couleur.
IsGrayscale	bool	Lecture seule	Indique si l’image est en niveaux de gris.
Type	SHORT	Lecture seule	Le type d’image.
Width	int	Lecture seule	La largeur de l’image en points.
XResolution	int	Lecture seule	La résolution horizontale de l’image.
YResolution	int	Lecture seule	La résolution verticale de l’image.

Enregistrer l’adéquation à l’OCR dans un commentaire de page

Ce script enregistre les résultats de la méthode dans un commentaire de page pour les documents sélectionnés lorsqu’un utilisateur clique sur un bouton :

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