> ## 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.

# Objeto CoordinatesConverter (interfaz ICoordinatesConverter)

> Objeto CoordinatesConverter (interfaz ICoordinatesConverter) en la API de ABBYY FineReader Engine: contiene información sobre las coordenadas de píxeles de la imagen en el momento en que se obtuvo de un ImageDocument; permite convertir coordenadas de píxeles entre estados de modificación de la imagen o planos de imagen.

Este objeto contiene información sobre las coordenadas de píxeles en la imagen en el momento en que se obtuvo del objeto [ImageDocument](/es/fine-reader/engine/api-reference/image-related-objects/imagedocument) (la propiedad [CoordinatesConverter](/es/fine-reader/engine/api-reference/image-related-objects/imagedocument#coordinatesconverter)). Permite convertir las coordenadas de píxeles de un estado de Modification de imagen a otro.

Puede usar este objeto para convertir las coordenadas de píxeles entre dos etapas cualesquiera del procesamiento de imágenes. Por ejemplo:

1. Obtenga este objeto directamente después de abrir la imagen, momento en el que se habrá corregido la inclinación de la misma.
2. Aplique otras modificaciones y obtenga otra instancia de este objeto desde el ImageDocument.
3. Ahora puede convertir las coordenadas de píxeles entre el plano de la imagen con inclinación corregida inicialmente y el plano de la imagen modificada aplicando el método ConvertCoordinates dos veces:
   * convierta desde el plano de la imagen con inclinación corregida al original usando la primera instancia del CoordinatesConverter;
   * convierta el resultado desde el plano de la imagen original al plano de la imagen modificada usando la segunda instancia del CoordinatesConverter.

El objeto CoordinatesConverter es un objeto persistente. Esto significa que el estado actual del objeto puede escribirse en un almacenamiento persistente y, posteriormente, el objeto puede recrearse leyendo dicho estado desde ese almacenamiento. Los siguientes métodos proporcionan la persistencia del objeto:

Linux: [SaveToFile](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method) y [LoadFromFile](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)

Windows: [SaveToFile](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method), [LoadFromFile](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method), [SaveToMemory](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) y [LoadFromMemory](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method).

<div id="properties">
  ## Propiedades
</div>

| Nombre      | Tipo                                                                                                                                                                                                                      | Descripción                |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
| Application | [Engine](/es/fine-reader/engine/api-reference/engine-object-iengine-interface), [de solo lectura](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | Devuelve el objeto Engine. |

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

| Nombre                                                                                                                          | Descripción                                                                                                                                                                                      |
| ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [ConvertCoordinates](/es/fine-reader/engine/api-reference/image-related-objects/coordinatesconverter/convertcoordinates-method) | Convierte las coordenadas de un píxel entre diferentes estados de Modification o planos de imagen del [ImageDocument](/es/fine-reader/engine/api-reference/image-related-objects/imagedocument). |
| [LoadFromFile](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)                      | Restaura el contenido del objeto desde un archivo en disco.                                                                                                                                      |
| [LoadFromMemory](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method)                  | Restaura el contenido del objeto desde la memoria global. <Note> *Disponible para Windows.*</Note>                                                                                               |
| [SaveToFile](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)                          | Guarda el contenido del objeto en un archivo en disco.                                                                                                                                           |
| [SaveToMemory](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method)                      | Guarda el contenido del objeto en la memoria global. <Note> *Disponible para Windows.*</Note>                                                                                                    |

<div id="related-objects">
  ## Objetos relacionados
</div>

<img src="https://mintcdn.com/abbyy/6udH-pkk8zkVafYH/images/fine-reader/engine/coordinatesconverter.gif?s=569f3a2af2749c842aa6594c093cc407" alt="CoordinatesConverter" width="141" height="57" data-path="images/fine-reader/engine/coordinatesconverter.gif" />[](/es/fine-reader/engine/api-reference/image-related-objects/imagedocument#coordinatesconverter)[](/es/fine-reader/engine/api-reference/image-related-objects/imagedocument)

[Diagrama de objetos](/es/fine-reader/engine/api-reference/object-diagram)

<div id="samples">
  ## Ejemplos
</div>

A continuación se muestra un ejemplo para Windows en el que este objeto se utiliza para convertir coordenadas entre dos estados de modificación diferentes:

<div id="c">
  ### C\#
</div>

```csharp theme={null}
FREngine.IEngine engine;
FREngine.IFRDocument frDoc;
// La corrección de inclinación se realiza de forma predeterminada al agregar las imágenes al documento
frDoc.AddImageFile ("D:\\Sample.tif", null, null);
// Abra ImageDocument de la primera página
FREngine.IImageDocument imageDoc = frDoc.Pages[0].ImageDocument; 
// Cree una instantánea de las coordenadas después de abrirlo
FREngine.ICoordinatesConverter convAfterOpening = imageDoc.CoordinatesConverter;
// Transforme un poco más la imagen
imageDoc.Transform(FREngine.RotationTypeEnum.RT_Counterclockwise, false, false);
// Cree una instantánea de las coordenadas después de la transformación
FREngine.ICoordinatesConverter convAfterModification = imageDoc.CoordinatesConverter;
...
// Tras cierto procesamiento, encontrará un píxel en el plano de la imagen modificada cuyas coordenadas deberá convertir
int x, y;
convAfterModification.ConvertCoordinates(FREngine.ImageTypeEnum.IT_Base, FREngine.ImageTypeEnum.IT_Modified, ref x, ref y);
convAfterOpening.ConvertCoordinates(FREngine.ImageTypeEnum.IT_Modified, FREngine.ImageTypeEnum.IT_Base, ref x, ref y);
// ahora x, y contienen las coordenadas del punto necesario en el plano de la imagen con la inclinación corregida
```

Este objeto también se utiliza en el ejemplo de código de [Reconocimiento de tarjetas de visita](/es/fine-reader/engine/guided-tour/samples#bcr_mac) para macOS.

<div id="see-also">
  ## Consulte también
</div>

[ImageDocument](/es/fine-reader/engine/api-reference/image-related-objects/imagedocument)

[Trabajar con imágenes](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-images)

[Trabajar con propiedades](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)