Objet ColorObjectsProhibitingParams (interface IColorObjectsProhibitingParams)

Objet ColorObjectsProhibitingParams (interface IColorObjectsProhibitingParams) dans l’API ABBYY FineReader Engine — Règle le filtrage des objets colorés (tampons, signatures, etc.) avant le traitement ; sous-objet de PageProcessingParams.

Cet objet sert à régler les paramètres de filtrage des objets colorés dans l’image avant le traitement. Ce type de prétraitement peut être utile lorsque le document à reconnaître comporte des tampons colorés, des signatures, etc., susceptibles de réduire la qualité de la reconnaissance. À l’aide des propriétés de cet objet, vous pouvez définir l’ensemble des couleurs à filtrer et préciser si, après la reconnaissance, les objets colorés doivent être restaurés dans l’image.

Cet objet ne peut exister qu’en tant que sous-objet de l’objet PageProcessingParams. Il doit être créé ou enregistré dans un stockage persistant avec l’objet parent.

​

Propriétés

Nom	Type	Description
Application	Engine, lecture seule	Renvoie l’objet Engine.
BackgroundColor	int	Spécifie la couleur qui doit remplacer les objets colorés supprimés. La valeur int est calculée à partir du triplet RGB à l’aide de la formule : ( valeur rouge ) + (256 x valeur verte ) + (65536 x valeur bleue ), où la valeur rouge est le premier composant du triplet, la valeur verte est le deuxième composant du triplet et la valeur bleue est le troisième composant du triplet. Par exemple, la valeur int de la couleur blanche est égale à 16777215. La valeur par défaut de cette propriété est -1, ce qui signifie que la couleur sera sélectionnée automatiquement.
ColorHues	IntsCollection	Spécifie la collection des teintes des objets à filtrer, dans la représentation HSL. Le nombre qui spécifie une teinte doit être compris entre 0 et 255. La valeur 0 correspond au rouge, 43 — au jaune, 85 — au vert, 171 — au bleu, 213 — au violet. Par défaut, la collection est vide, ce qui signifie que tous les objets colorés seront filtrés et que seule l’image en niveaux de gris sera transmise pour le traitement.
RestoreColorObjectsAfterProcessing	VARIANT_BOOL	Indique si, une fois le traitement terminé, les objets colorés doivent être rétablis sur l’image. Définissez cette propriété sur TRUE lorsque vous devez obtenir à la fois un texte reconnu de bonne qualité et l’image couleur avec tous les tampons, signatures, etc. conservés à leur place. Cela peut être utile, par exemple, lors de l’exportation vers un PDF image sur texte. La valeur par défaut de cette propriété est TRUE.

​

Objets associés

Diagramme des objets

​

Remarques

Pensez également à utiliser la méthode RemoveColorObjectsEx de l’objet ImageDocument, qui effectue le même filtrage des objets colorés, tout en vous permettant d’enregistrer la couche couleur extraite dans une image distincte.

​

Voir aussi

Réglage des paramètres de prétraitement, d’analyse, de reconnaissance et de synthèse

Utilisation des propriétés