Reconocimiento de marcas de verificación

​

Detección de marcas de verificación en la imagen

FREngine.IEngine engine;
FREngine.IFRDocument frdoc;
// Suponemos que el documento ya se ha creado y que se han añadido imágenes al documento
// Cree DocumentProcessingParams y establezca los parámetros
FREngine.IDocumentProcessingParams dpp = engine.CreateDocumentProcessingParams();
FREngine.IPageProcessingParams ppp = dpp.PageProcessingParams;
ppp.PageAnalysisParams.DetectCheckmarks = true;
// Use los parámetros para el procesamiento
frDoc.Process( dpp );

• Reconocimiento de un grupo de marcas de verificación
• Reconocimiento de una sola marca de verificación
• Aprender a reconocer marcas de verificación de tipo personalizado

​

Reconocimiento de un grupo de marcas de verificación

• establecer correctamente el tipo de marca de verificación, porque las marcas de tipo CMT_Circle y CMT_Square tienen un contorno negro que debe tenerse en cuenta al calcular el porcentaje;
• especificar la región exacta de la marca de verificación, porque el porcentaje de píxeles negros se calculará en toda la región y, si la región incluye áreas irrelevantes, la estimación puede empeorar.

1. Cree un objeto FRDocument a partir de una imagen que contenga un grupo de marcas de verificación. Por ejemplo, puede usar el método CreateFRDocumentFromImage del objeto Engine.
2. Obtenga la página con la imagen de las marcas de verificación de la colección de páginas del documento (IFRDocument::Pages); para ello, use las propiedades y los métodos de la colección FRPages.
3. Obtenga el objeto Layout correspondiente a esta página mediante la propiedad IFRPage::Layout.
4. Para cada grupo de marcas de verificación:
5. Cree un objeto Region mediante el método IEngine::CreateRegion y agréguele rectángulos con el método IRegion::AddRect.
6. Cree un objeto Block del tipo grupo de marcas de verificación y agréguelo a la colección de bloques del layout (ILayout::Blocks) mediante el método ILayoutBlocks::AddNew (use la constante BT_CheckmarkGroup y el objeto Region creado como parámetros de entrada. El método también requiere como tercer parámetro de entrada el índice del bloque en el layout).
7. Obtenga el objeto CheckmarkGroup (use el método IBlock::GetAsCheckmarkGroup).

5. Para cada marca de verificación del grupo:
6. Cree el objeto Region con el método IEngine::CreateRegion y agréguele rectángulos con el método IRegion::AddRect.
7. Cree un nuevo bloque de marca de verificación en el grupo con el método ICheckmarkGroup::AddNew (use el objeto Region creado como parámetro de entrada).
8. Obtenga el objeto CheckmarkBlock (use el método IBlock::GetAsCheckmarkBlock) y establezca los parámetros necesarios (CheckmarkType, IsCorrectionEnabled).
9. Establezca los parámetros necesarios del grupo de marcas de verificación (MinimumCheckedInGroup, MaximumCheckedInGroup).
10. Para reconocer las marcas de verificación, use cualquiera de los métodos disponibles que permiten realizar el reconocimiento, como IFRPage::Recognize, IFRPage::RecognizeBlocks, IFRDocument::Recognize, IFRDocument::RecognizePages, etc.

...
// Obtener un objeto Layout
FREngine.IFRDocument document = Engine.CreateFRDocumentFromImage("D:\\Sample.tiff", null);
FREngine.ILayout layout = document.Pages[0].Layout;
// Establecer la región del bloque
FREngine.IRegion region = Engine.CreateRegion();
region.AddRect(0, 0, 100, 50);
// Crear un bloque del tipo grupo de marcas de verificación
// y agregarlo al final de la colección en el diseño
FREngine.IBlock block = layout.Blocks.AddNew(FREngine.BlockTypeEnum.BT_CheckmarkGroup, region, layout.Blocks.Count);
FREngine.ICheckmarkGroup checkmarkGroup = block.GetAsCheckmarkGroup();
// Crear bloques del tipo marca de verificación
// y agregarlos al grupo de marcas de verificación
for (int i = 0; i < 5; i++)
{
  FREngine.IRegion checkmarkRegion = Engine.CreateRegion();
  checkmarkRegion.AddRect(10, 10 + i * 20, 90, 10 + (i + 1) * 20);
  FREngine.ICheckmarkBlock checkmark = checkmarkGroup.AddNew(0, checkmarkRegion);
}
...

​

Reconocer una sola marca de verificación

1. Cree un objeto FRDocument a partir de una imagen con una marca de verificación. Por ejemplo, puede usar el método CreateFRDocumentFromImage del objeto Engine.
2. Obtenga la página con la imagen de la marca de verificación de la colección de páginas del documento (IFRDocument::Pages); use las propiedades y los métodos de la colección FRPages.
3. Obtenga el objeto Layout correspondiente a esta página mediante la propiedad IFRPage::Layout.
4. Cree el objeto Region con el método IEngine::CreateRegion y añádale rectángulos con el método IRegion::AddRect.
5. Cree un objeto Block de tipo marca de verificación y agréguelo a la colección de bloques del layout (ILayout::Blocks) con el método ILayoutBlocks::AddNew (use la constante BT_Checkmark y el objeto Region creado como parámetros de entrada).
6. Obtenga el objeto CheckmarkBlock (use el método IBlock::GetAsCheckmarkBlock) y establezca los parámetros necesarios (CheckmarkType, IsCorrectionEnabled).

7. Para reconocer la marca de verificación, use cualquiera de los métodos de reconocimiento disponibles, como IFRPage::Recognize, IFRPage::RecognizeBlocks, IFRDocument::Recognize, IFRDocument::RecognizePages, etc.

...
// Obtener un objeto Layout
FREngine.IFRDocument document = Engine.CreateFRDocumentFromImage("D:\\Sample.tiff", null);
FREngine.ILayout layout = document.Pages[0].Layout;
// Establecer la región del bloque
FREngine.IRegion region = Engine.CreateRegion();
region.AddRect(0, 0, 100, 50);
// Crear un bloque de tipo marca de verificación y agregarlo al final de la colección del layout
FREngine.IBlock block = layout.Blocks.AddNew(FREngine.BlockTypeEnum.BT_Checkmark, region, layout.Blocks.Count);
FREngine.ICheckmarkBlock checkmark = block.GetAsCheckmarkBlock();
...

​

Aprender a reconocer marcas de verificación personalizadas

1. Busque una imagen con algunas marcas de verificación sin marcar del tipo que desea reconocer. Puede ser una imagen de un formulario vacío que contenga esas marcas.
2. Cree un objeto FRDocument a partir de esta imagen. Por ejemplo, puede usar el método CreateFRDocumentFromImage del objeto Engine.
3. Obtenga la página con la imagen de las marcas de verificación de la colección de páginas del documento (IFRDocument::Pages); use las propiedades y los métodos de la colección FRPages.
4. Obtenga el objeto Layout correspondiente a esta página mediante la propiedad IFRPage::Layout.
5. Especifique la región y el tipo de cada bloque de marca de verificación de la página:
6. Cree el objeto Region mediante el método IEngine::CreateRegion y agréguele los rectángulos de una región de marca de verificación con el método IRegion::AddRect.
7. Cree un objeto Block de tipo marca de verificación y agréguelo a la colección de bloques del layout (ILayout::Blocks) mediante el método ILayoutBlocks::AddNew (use la constante BT_Checkmark y el objeto Region creado como parámetros de entrada).
8. Obtenga el objeto CheckmarkBlock (use el método IBlock::GetAsCheckmarkBlock) y establezca su propiedad CheckmarkType en CMT_Custom.

6. Entrene FineReader Engine para que reconozca este tipo de marcas de verificación: llame al método LearnCheckmarks del objeto FRPage.
7. Como resultado, la propiedad TrainingData del objeto CheckmarkBlock que creó antes del entrenamiento contendrá información sobre el tipo personalizado de marca de verificación. Esta información podrá utilizarse para reconocer otras marcas de verificación del mismo tipo. Puede guardarla en un archivo o en memoria mediante el método SaveToMemory (solo Windows) o el método SaveToFile del objeto CheckmarkTrainingData.
8. Cree objetos FRDocument a partir de las imágenes que contengan marcas de verificación de este tipo, especifique bloques de marcas de verificación en las páginas y establezca el tipo de marca de verificación en CMT_Custom. El procedimiento se describe en los pasos 2 a 5.
9. Inicialice la propiedad TrainingData de cada objeto CheckmarkBlock con el objeto CheckmarkTrainingData obtenido durante el entrenamiento. Por ejemplo, puede copiar el objeto mediante el método CopyFrom o cargarlo desde un archivo o desde la memoria mediante el método LoadFromMemory (solo Windows) o el método LoadFromFile del objeto CheckmarkTrainingData.
10. Llame a cualquiera de los métodos de reconocimiento del objeto FRDocument o FRPage; por ejemplo, al método IFRDocument::Recognize.
11. Las propiedades BlackThreshold y SuspiciousDistance del objeto CheckmarkBlock le permiten ajustar aún más la configuración si no está satisfecho con los resultados del reconocimiento. Después del entrenamiento, los valores predeterminados de estas propiedades se sustituyen por valores que deberían funcionar en la mayoría de los casos. Cuando carga el objeto CheckmarkTrainingData para un bloque de marcas de verificación, también se cargan los valores de estas propiedades. Puede probar a cambiar los valores de estas propiedades y volver a reconocer las marcas de verificación (repitiendo el paso 10) y, cuando haya encontrado la mejor configuración, volver a guardar el objeto CheckmarkTrainingData y usar el nuevo objeto para reconocer las marcas de verificación de su tipo personalizado.

​

Consulte también