> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Objet TrainingImage (interface ITrainingImage)

> Objet TrainingImage (interface ITrainingImage) dans l’API ABBYY FineReader Engine — représente une image d’entraînement unique contenant l’image d’un caractère pour l’entraînement des motifs utilisateur ; peut être défini via SetImageData ou SetBitmapBits (Windows).

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.

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

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.

<Accordion title="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é.

  <img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/smallcharsheight_and_baseline.png?fit=max&auto=format&n=i-EfCQVmseNiPQcp&q=85&s=b0dfc61d0b64d6761418b8292b13fdf6" alt="SmallCharsHeight_and_BaseLine" width="478" height="307" data-path="images/fine-reader/engine/smallcharsheight_and_baseline.png" />
</Accordion>

<div id="properties">
  ## Propriétés
</div>

| Nom              | Type                                                                                                                                                                                                                    | Description                                                                                                                                                                                                                                                                                                                                                                         |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Application      | [Engine](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface), [lecture seule](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | Renvoie l’objet [Engine](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface).                                                                                                                                                                                                                                                                                     |
| BaseLine         | [int](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)                                                                                                               | 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](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)                                                                                                               | 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é.                                                                                                                                                                              |

<div id="methods">
  ## Méthodes
</div>

| Nom                                                                                                            | Description                                                                                                                                                                                                                                                                                 |
| -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [SetBitmapBits](/fr/fine-reader/engine/api-reference/image-related-objects/trainingimage/setbitmapbits-method) | 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. <Note> *Windows uniquement.* </Note> |
| [SetImageData](/fr/fine-reader/engine/api-reference/image-related-objects/trainingimage/setimagedata-method)   | Définit les données de l'image d'entraînement à partir d'une région d'une image de document.                                                                                                                                                                                                |

<div id="related-objects">
  ## Objets associés
</div>

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/trainingimage.gif?s=5bbdf09ebfa745651f795b42b0c196d5" alt="TrainingImage" width="152" height="60" data-path="images/fine-reader/engine/trainingimage.gif" />[](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/element-property)[](/fr/fine-reader/engine/api-reference/image-related-objects/trainingimagescollection)

[Diagramme d'objets](/fr/fine-reader/engine/api-reference/object-diagram)

<div id="output-parameter">
  ## Paramètre de sortie
</div>

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

* méthode [CreateTrainingImage](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) de l’objet [Engine](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface)
* méthode [Item](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/item-method) de l’objet [TrainingImagesCollection](/fr/fine-reader/engine/api-reference/image-related-objects/trainingimagescollection)

<div id="input-parameter">
  ## Paramètre d’entrée
</div>

Cet objet est passé en tant que paramètre d’entrée aux méthodes [InsertAt](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/insertat-method) et [Add](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/add-method) de l’objet [TrainingImagesCollection](/fr/fine-reader/engine/api-reference/image-related-objects/trainingimagescollection).

<div id="see-also">
  ## Voir aussi
</div>

[TrainingImagesCollection](/fr/fine-reader/engine/api-reference/image-related-objects/trainingimagescollection)

[Reconnaissance avec entraînement](/fr/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/recognizing-with-training) (Win)

[Entraînement des motifs utilisateur](/fr/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/training-user-patterns) (Win)

[Utilisation des propriétés](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)