Una vez que un motor OCR ha extraído el texto de una página escaneada, la tipografía desaparece. Sabes qué dice el documento, pero no si un encabezado estaba en negrita de 18 puntos o si un campo de formulario usaba la misma fuente que el resto de la página. Reconstruir el diseño de un documento, verificar que un formulario impreso sigue las directrices de la marca o clasificar documentos por su estilo visual, todo ello requiere esa información que falta.
Aspose.OCR for .NET cierra esa brecha con la detección de fuentes. Cuando lo habilitas, cada línea reconocida vuelve con su familia de fuentes, estilo, tamaño y una puntuación de confianza, junto con el texto y su cuadro delimitador.
Este artículo muestra cómo activar la detección de fuentes, recorre las propiedades del resultado una por una, amplía el ejemplo a una carpeta de imágenes con exportación a CSV y describe lo que la función puede y no puede hacer.
Puntos clave
- Aspose.OCR for .NET devuelve la familia de fuentes, el estilo, la altura en píxeles, el tamaño de punto estimado y los puntajes de confianza para cada línea reconocida.
- Lo habilitas estableciendo una única bandera en la configuración de reconocimiento; los datos de fuente se adjuntan a cada resultado de línea.
- La detección de fuentes está diseñada para texto impreso. La escritura a mano y los tipos decorativos devuelven baja confianza y pueden revertir a una familia genérica.
- Los valores de confianza son puntuaciones del motor, no probabilidades calibradas. Elige un umbral de revisión que se ajuste a la calidad de tu entrada y flujo de trabajo.
- El tamaño de punto es una estimación y puede ser nulo; la altura en píxeles siempre está presente.
¿Nuevo en la biblioteca? La página del producto de la biblioteca C# OCR cubre formatos, idiomas y compatibilidad de plataforma antes de que escribas código.
¿Qué detalles de fuente puede devolver Aspose.OCR de los resultados de OCR?
Para cada línea que no esté vacía, Aspose.OCR devuelve un objeto FontLineResult con seis piezas de datos tipográficos más un índice de línea. Describe la línea en su totalidad, no palabras o caracteres individuales.
| Propiedad | Tipo | Qué contiene |
|---|---|---|
Font | string | Nombre de familia de fuente detectado, por ejemplo Arial. |
FontConfidence | double | Puntuación de confianza para la familia, 0–1. |
Style | string | Estilo detectado: regular, italic o bold_italic. |
StyleConfidence | double | Puntuación de confianza para el estilo, 0–1. |
SizePx | double | Altura de línea en píxeles, medida a partir de la imagen. |
SizePtEstimate | double? | Tamaño de fuente estimado en puntos. Puede ser nulo. |
LineIndex | int | Índice basado en cero de la línea en el lote procesado. |
Comportamiento de la API: los nombres de propiedades, tipos y los valores de estilo documentados arriba provienen de la referencia de la API de Aspose.OCR for .NET para FontLineResult y de la guía de detección de fuentes.
¿Qué se necesita para detectar fuentes con Aspose.OCR for .NET?
Necesitas el paquete 26.7, una imagen raster de texto impreso y unas pocas líneas de configuración. La detección de fuentes se introdujo en Aspose.OCR for .NET 26.7, por lo que un paquete anterior no compilará con este código.
- Aspose.OCR for .NET 26.7 or later, agregado a su proyecto desde NuGet.
- Un proyecto .NET. Aspose.OCR está disponible tanto para .NET Framework como para .NET moderno; use el que ya esté dirigido por su solución. Los ejemplos aquí se ejecutaron en .NET 10.
- Espacio para el modelo de fuentes. La primera llamada de reconocimiento con
DetectFontshabilitado descarga un modelo de análisis de fuentes (aproximadamente 686 MB en la compilación 26.7) en el directorio de trabajo. Se descarga una sola vez y se reutiliza; las ejecuciones posteriores comienzan en segundos. - Una imagen de entrada como PNG, JPEG o TIFF que contenga texto impreso. Las páginas fotografiadas funcionan; cuanto más limpia sea la escaneada, mayor será la confianza.
- Una licencia. Sin ella, el motor se ejecuta en modo de evaluación, lo que trunca la salida del reconocimiento — en pruebas devolvía solo la primera línea de una imagen de varias líneas y recortaba el primer carácter. Utilice la licencia temporal gratuita (descrita a continuación) para obtener resultados representativos.
Install-Package Aspose.OCR
Confirme que el paquete instalado sea la versión 26.7.0 o posterior, ya que esa es la versión que añadió la detección de fuentes.
¿Cómo extraer los detalles de la fuente de los resultados de OCR en .NET?
Establezca DetectFonts en true en RecognitionSettings, ejecute el reconocimiento y lea la propiedad Font de cada línea en RecognitionLinesResult. Los datos de la fuente se rellenan solo cuando DetectFonts está habilitado.
Input: source.png (raster image with printed text)
Output: font family, style, size and confidence per recognized line
Library: Aspose.OCR for .NET 26.7
Language: C#
El ejemplo a continuación es el ejemplo de referencia de las notas de la versión 26.7 de Aspose.OCR for .NET. Fue compilado y ejecutado contra Aspose.OCR for .NET 26.7.0 en .NET 10: produjo regular para el estilo, un tamaño de píxel double y una estimación de tamaño de punto poblada, con los dos valores de confianza en el rango 0–1.
using Aspose.OCR;
using System;
using System.Linq;
// Initialize the OCR engine.
AsposeOcr recognitionEngine = new AsposeOcr();
// Prepare the input image. Replace "source.png" with your file path.
OcrInput input = new OcrInput(InputType.SingleImage);
input.Add("source.png");
// Turn on font detection.
RecognitionSettings settings = new RecognitionSettings
{
DetectFonts = true, // Populates FontLineResult on each recognized line
ThreadsCount = 1 // 0 (default) uses one thread per processor
};
// Recognize returns an OcrOutput, which is a List<RecognitionResult>.
RecognitionResult result = recognitionEngine.Recognize(input, settings)[0];
// Read the font details for every line that actually contains text.
foreach (RecognitionResult.LinesResult line in result.RecognitionLinesResult
.Where(line => !string.IsNullOrWhiteSpace(line.TextInLine)))
{
FontLineResult font = line.Font;
Console.WriteLine(line.TextInLine);
Console.WriteLine($"Font: {font.Font} ({font.FontConfidence:P0})");
Console.WriteLine($"Style: {font.Style} ({font.StyleConfidence:P0})");
Console.WriteLine($"Size: {font.SizePx}px / {font.SizePtEstimate}pt");
}
Para cada línea reconocida, la consola muestra el texto seguido de tres líneas de fuente. Esta es la salida real para una línea de una imagen de prueba renderizada en una tipografía sans-serif:
Invoice Number 10428
Font: Segoe UI (98%)
Style: regular (97%)
Size: 26px / 6.24pt
El nombre de familia refleja la cara más cercana que el motor coincidió, por lo que sigue la fuente renderizada en lugar de cualquier etiqueta en la fuente. {font.SizePtEstimate} no imprime nada cuando la estimación es nula, por lo que una línea sin estimación se muestra como Size: 26px / pt. En modo de evaluación el motor devuelve solo una parte del texto — típicamente la primera línea — así que ejecute con una licencia para ver cada línea.
¿Qué hace cada parte del código?
Cada llamada acerca la imagen un paso más a los datos de fuente estructurados.
new AsposeOcr()crea el motor de reconocimiento. La clase se encuentra en el espacio de nombresAspose.OCR. Una licencia desbloquea la funcionalidad completa; sin ella el motor se ejecuta en modo de evaluación.new OcrInput(InputType.SingleImage)crea el contenedor de entrada y le indica al motor que la fuente es una imagen raster independiente.input.Add("source.png")agrega el archivo; puedes agregar más de uno para procesar un lote en una sola llamada.new RecognitionSettings { DetectFonts = true, ThreadsCount = 1 }configura el reconocimiento.DetectFonts = truees lo que hace que el motor analice los glifos y relleneFontLineResult.ThreadsCountcontrola el paralelismo:0, el valor predeterminado, usa un hilo por procesador;1fuerza la ejecución en un solo hilo, lo que mantiene la salida más fácil de seguir durante la depuración.recognitionEngine.Recognize(input, settings)ejecuta OCR y devuelve unOcrOutput.OcrOutputderiva deList<RecognitionResult>, por lo que[0]es el resultado de la primera imagen.result.RecognitionLinesResultes la lista de objetosRecognitionResult.LinesResult, uno por cada línea detectada. El filtroWhereelimina las líneas cuyoTextInLineestá vacío o contiene solo espacios en blanco, lo que puede ocurrir por ruido en la imagen.line.Fontdevuelve elFontLineResultpara esa línea. Se rellena solo porqueDetectFontsestaba habilitado; con la bandera desactivada no se rellena.
La guía de detección de fuentes y las notas de la versión 26.7 son las referencias principales para esta característica si necesita comprobar el comportamiento con su versión.
¿Qué significa cada propiedad de FontLineResult?
FontLineResult mezcla valores medidos con estimaciones y puntuaciones, por lo que es útil saber cuál es cuál antes de construir lógica sobre ello.
Font— Comportamiento de la API. El nombre de la familia tipográfica detectada, comoArialoTimes New Roman. Aspose.OCR reconoce fuentes impresas comunes; una fuente no reconocida se resuelve a la coincidencia más cercana que conoce el motor.FontConfidence— Comportamiento de la API. Una puntuación de confianza de 0–1 para la familia. La documentación no la define como una probabilidad calibrada, así que interprétala como una señal relativa: un valor más alto indica que el motor está más seguro.Style— Comportamiento de la API. Uno deregular,italicobold_italic.StyleConfidence— Comportamiento de la API. Una puntuación de confianza de 0–1 para el estilo, leída de la misma manera queFontConfidence.SizePx— Comportamiento de la API. La altura de la línea en píxeles, medida a partir de la imagen. Siempre presente.SizePtEstimate— Comportamiento de la API. Un tamaño de punto estimado, tipado comodouble?. Puede ser nulo, así que verifica antes de formatearlo o convertirlo.LineIndex— Comportamiento de la API. La posición basada en cero de la línea en el lote procesado, útil para correlacionar los datos de fuente con otros resultados por línea.
¿Cómo manejas resultados de fuentes de baja confianza o desconocidas?
Ramifica según las puntuaciones de confianza y trata cualquier cosa por debajo del umbral que elijas como “necesita revisión” en lugar de un hecho. No hay un límite oficial; el valor adecuado depende de tus escaneos y de lo costosa que sea una clasificación incorrecta.
- Establezca un umbral de aplicación. Ejemplo de heurística: una herramienta interna podría marcar cualquier línea donde
FontConfidenceoStyleConfidenceestén por debajo de0.5para que un humano la revise. Una canalización por lotes sobre escaneos limpios y de alta resolución podría usar de forma segura un umbral más bajo; fotos de teléfono con ruido pueden necesitar uno más alto. Mídalo contra su propio conjunto de documentos. - Mejore la entrada. Una baja confianza a menudo significa que las métricas de los glifos no estaban claras. Un escaneo de mayor resolución, o un preprocesamiento para enderezar y reducir el ruido de la imagen antes del reconocimiento, suele aumentar las puntuaciones.
- Espere resultados débiles con escritura a mano. Comportamiento de la API: la detección de fuentes está ajustada para tipografía impresa. Las notas manuscritas, los logotipos estilizados y la tipografía de pantalla suelen devolver baja confianza y una familia genérica. Verifique
FontConfidenceantes de mostrar o almacenar la familia para estos documentos. - Proteja contra un tamaño de punto nulo.
SizePtEstimatepuede ser nulo. Recurra aSizePxo omita el campo cuando sea nulo. - Conozca el comportamiento de la licencia temporal. Comportamiento de la API: el
Confidencea nivel de línea enRecognitionResult.LinesResultdevuelve0bajo una licencia temporal y solo se calcula para ciertos grupos de idiomas. Esta es la confianza del texto de la línea, separada de las puntuaciones de confianza de la fuente, pero sorprende a los usuarios durante la evaluación.
¿Cómo extraer los detalles de la fuente de muchas imágenes a la vez?
Recorra los archivos en una carpeta, ejecute el reconocimiento por archivo dentro de un try/catch, y escriba una fila CSV por línea con los valores correctamente escapados. Aislar cada archivo significa que una imagen ilegible no detiene el lote.
using Aspose.OCR;
using System;
using System.Collections.Generic;
using System.Globalization;
using System.IO;
using System.Linq;
class FontBatch
{
static void Main()
{
string folder = @"C:\ScannedDocs";
string reportPath = Path.Combine(folder, "font_report.csv");
AsposeOcr recognitionEngine = new AsposeOcr();
RecognitionSettings settings = new RecognitionSettings { DetectFonts = true };
var csv = new List<string>
{
"File,LineIndex,Text,Font,FontConfidence,Style,StyleConfidence,SizePx,SizePtEstimate"
};
foreach (string file in Directory.GetFiles(folder, "*.png"))
{
try
{
OcrInput input = new OcrInput(InputType.SingleImage);
input.Add(file);
RecognitionResult result = recognitionEngine.Recognize(input, settings)[0];
foreach (RecognitionResult.LinesResult line in result.RecognitionLinesResult
.Where(l => !string.IsNullOrWhiteSpace(l.TextInLine)))
{
FontLineResult font = line.Font;
if (font == null)
{
continue;
}
string pt = font.SizePtEstimate.HasValue
? font.SizePtEstimate.Value.ToString("F1", CultureInfo.InvariantCulture)
: string.Empty;
csv.Add(string.Join(",",
Csv(Path.GetFileName(file)),
font.LineIndex.ToString(CultureInfo.InvariantCulture),
Csv(line.TextInLine),
Csv(font.Font),
font.FontConfidence.ToString("F3", CultureInfo.InvariantCulture),
Csv(font.Style),
font.StyleConfidence.ToString("F3", CultureInfo.InvariantCulture),
font.SizePx.ToString("F1", CultureInfo.InvariantCulture),
pt));
}
}
catch (Exception ex)
{
Console.WriteLine($"Skipped {Path.GetFileName(file)}: {ex.Message}");
}
}
File.WriteAllLines(reportPath, csv);
Console.WriteLine($"Wrote {csv.Count - 1} rows to {reportPath}");
}
// Wrap a field in quotes and double any embedded quotes if it contains
// a comma, quote, or line break, per RFC 4180.
static string Csv(string value)
{
if (string.IsNullOrEmpty(value))
{
return string.Empty;
}
if (value.IndexOfAny(new[] { ',', '"', '\n', '\r' }) >= 0)
{
return "\"" + value.Replace("\"", "\"\"") + "\"";
}
return value;
}
}
Esto se ejecuta en Aspose.OCR 26.7.0: escribe font_report.csv con una fila por cada línea reconocida, y el texto reconocido que contiene comas o comillas se escapa para que el archivo se abra correctamente en Excel o Power BI.
¿Cuáles son las limitaciones de la detección de fuentes OCR?
La detección de fuentes es una estimación práctica de la tipografía, no una herramienta forense de fuentes. Ten en cuenta estos límites al diseñar alrededor de ella.
- Es a nivel de línea. Comportamiento de la API: un
FontLineResultdescribe una línea reconocida completa. Una línea que mezcla dos fuentes o tamaños se resume como un solo resultado. - La familia es la mejor coincidencia. Aspose.OCR reconoce tipografías impresas comunes. Una tipografía que no conoce se informa como la más cercana que sí reconoce.
- El conjunto de estilos es pequeño. Sólo se informan
regular,italicybold_italic. No hay un “negrita” separado ni una escala de peso en el resultado. - El tamaño en puntos se estima.
SizePtEstimatees derivado por el motor y puede ser nulo.SizePxes el único valor de tamaño que siempre se mide. - Las puntuaciones de confianza no son probabilidades. Clasifican la certeza relativa entre sí; no están documentadas como calibradas.
- Solo texto impreso. La escritura a mano y los scripts decorativos están fuera del alcance y devuelven baja confianza.
- Las páginas PDF siguen el mismo proceso. Crea el
OcrInputconInputType.PDF; cada página produce su propioRecognitionResulty su propio conjunto de datos de fuentes a nivel de línea. - La primera ejecución es lenta. Habilitar
DetectFontsdescarga un modelo grande (aproximadamente 686 MB en 26.7) antes de que se complete el primer reconocimiento. Calienta el modelo una vez durante la implementación en lugar de hacerlo en la primera solicitud del usuario; después de eso, la sobrecarga adicional por imagen es pequeña.
¿Cómo obtener una licencia gratuita de Aspose.OCR?
Aspose emite una licencia temporal gratuita de 30 días que le permite evaluar la API sin limitaciones del modo de evaluación. Solicite una en la página de licencia temporal y cárguela antes de crear el motor.
Detectar detalles de fuentes en línea - Aspose Font Detector
¿Quieres identificar la fuente utilizada en una imagen sin escribir código? Prueba la herramienta en línea gratuita Aspose Font Detector. Sube una imagen que contenga texto impreso y la herramienta podrá analizar el texto para identificar detalles relacionados con la fuente, como la familia, el estilo y el tamaño.

Esto es útil para verificar documentos escaneados, comparar tipografía en diseños, validar las directrices de marca o identificar fuentes antes de recrear un documento. La herramienta en línea también es una forma conveniente de explorar la detección de fuentes antes de integrar la misma capacidad en una aplicación con Aspose.OCR for .NET.
Conclusión
La detección de fuentes en Aspose.OCR for .NET 26.7 activa una bandera y le proporciona la familia de fuentes, el estilo, el tamaño y la confianza para cada línea reconocida. Lea SizePx como medido y SizePtEstimate como una estimación, trate los puntajes de confianza como señales relativas con un umbral que usted elija, y mantenga la función enfocada en texto impreso. A partir de ahí, el patrón por lotes anterior aplica la misma lógica a todo un archivo.
Comience con la guía de detección de fuentes de Aspose.OCR for .NET y la referencia de RecognitionSettings para el conjunto completo de opciones de reconocimiento.
Preguntas frecuentes
¿Qué versión de Aspose.OCR for .NET se requiere para la detección de fuentes? La detección de fuentes se añadió en Aspose.OCR for .NET 26.7 (julio de 2026). Las versiones anteriores no exponen la configuración
DetectFontsni el tipoFontLineResult, por lo que debe actualizar a la 26.7 o posterior.¿Puedo extraer información de fuentes de PDFs de varias páginas? Sí. Cree el
OcrInputconInputType.PDFy añada el archivo PDF; cada página se reconoce por separado y devuelve su propioRecognitionResult. También puede rasterizar las páginas a imágenes primero y ejecutar el flujo de una sola imagen.¿Qué representa el valor FontConfidence?
FontConfidencees la puntuación de confianza del motor para la familia de fuentes detectada, en el rango 0–1. La documentación no lo define como una probabilidad calibrada, por lo que debe tratarlo como un indicador relativo y elegir su propio umbral para la revisión.¿El tamaño de fuente detectado es exacto?
SizePx(la altura de línea en píxeles) se mide directamente.SizePtEstimatees una estimación en puntos y puede ser nulo, por lo que siempre debe protegerse contra un valor ausente antes de formatearlo.¿La detección de fuentes funciona con texto manuscrito? Está diseñada para texto impreso con métricas de glifos consistentes. Los manuscritos y las fuentes decorativas suelen devolver baja confianza y pueden resolverse en una familia genérica, por lo que debe ramificar en
FontConfidenceantes de confiar en el resultado.
