Objet TrainingImage (interface ITrainingImage)

Cet objet représente une image d’entraînement unique. Il contient une image de caractère pouvant être utilisée lors de l’entraînement des motifs utilisateur.

L’image d’entraînement peut être définie en chargeant comme image d’entraînement une région d’une image de document à l’aide de la méthode SetImageData. Sous Windows, l’image d’entraînement peut également être définie en chargeant une image depuis la mémoire à l’aide de la méthode SetBitmapBits.

Vous devez définir les propriétés SmallCharsHeight et BaseLine sur des valeurs correctes ; sinon, le motif entraîné ne fonctionnera pas correctement.

Le bord inférieur de la plupart des caractères (à l’exception de ceux qui ont une jambage descendante, comme p, g, Q) correspond à la ligne de base.

La propriété SmallCharsHeight doit être égale à la hauteur des lettres minuscules de la ligne sans hampe ni jambage (comme c, a, o), même lorsque vous entraînez le motif pour une lettre majuscule ou une lettre comportant une hampe, un jambage, ou des signes diacritiques (comme A, b, y ou é).

La propriété BaseLine doit être égale à la distance entre le bord supérieur du rectangle englobant et la ligne de base. Par conséquent, SmallCharsHeight = BaseLine pour les lettres minuscules sans hampe ni signe diacritique (comme m, e, u). Pour les lettres sans jambage, BaseLine est égale à la hauteur de la lettre.

Afficher une illustration

Sur cette image, pour la lettre o, définissez SmallCharsHeight et BaseLine sur la même valeur, égale à la hauteur de la lettre. Pour la lettre ý, SmallCharsHeight sera identique à celle de o, et BaseLine correspond à la distance entre le haut du rectangle de la lettre et la ligne de base, comme indiqué.

​

Propriétés

Nom	Type	Description
Application	Engine, lecture seule	Renvoie l’objet Engine.
BaseLine	int	Contient la distance, en pixels, entre la ligne de base et le bord supérieur de l’image recadrée du caractère. La ligne de base est la ligne sur laquelle se trouvent les caractères. Le bord supérieur de l’image est déterminé par l’orientation du caractère. Par défaut, la valeur de cette propriété est 0, mais vous devez spécifier la valeur correcte pour cette propriété.
SmallCharsHeight	int	Spécifie la hauteur, en pixels, des caractères de petite taille sur l’image source. Par défaut, la valeur de cette propriété est 0, mais vous devez spécifier la valeur correcte pour cette propriété.

​

Méthodes

Nom	Description
SetBitmapBits	Définit les données de l’image d’entraînement à partir d’un tampon en mémoire. L’image doit être isotrope (c’est-à-dire que sa résolution horizontale doit être égale à sa résolution verticale), en noir et blanc, avec un codage de 1 bit par pixel. Windows uniquement.
SetImageData	Définit les données de l’image d’entraînement à partir d’une région d’une image de document.

​

Objets associés

Diagramme d’objets

​

Paramètre de sortie

Cet objet constitue le paramètre de sortie des méthodes suivantes :

• méthode CreateTrainingImage de l’objet Engine
• méthode Item de l’objet TrainingImagesCollection

​

Paramètre d’entrée

Cet objet est passé en tant que paramètre d’entrée aux méthodes InsertAt et Add de l’objet TrainingImagesCollection.

​

Voir aussi

TrainingImagesCollection

Reconnaissance avec entraînement (Win)

Entraînement des motifs utilisateur (Win)

Utilisation des propriétés