Cómo generar un código de barras PNG con datos y dimensiones personalizadas

Qué puedes hacer con el generador

Este generador crea datos de imagen PNG de códigos de barras a partir de un texto o número introducido. Puedes usarlo cuando necesites convertir un identificador de pedido, una referencia interna u otro dato en una imagen de código de barras. Si no eliges otro formato, se utiliza Code 128. El campo de datos es opcional, aunque dejarlo vacío no produce una imagen válida.

Pasos para generar el código de barras

1. Introduce el dato que quieres representar en el campo correspondiente. Puede ser una referencia alfanumérica para Code 128. Comprueba que no esté vacío antes de generar el código.

2. Selecciona el formato si necesitas uno distinto de Code 128. Los nombres se normalizan al procesarlos, por lo que los espacios, guiones y determinadas variantes con guion bajo se ajustan a la denominación reconocida. No des por hecho que cualquier formato está disponible.

3. Configura el ancho y el alto si quieres modificar los valores iniciales. El ancho parte de 400 y se ajusta al intervalo de 100 a 2000; el alto parte de 100 y se ajusta al intervalo de 40 a 600. Introduce valores numéricos para evitar que se sustituyan por los valores predeterminados.

4. Decide si quieres mostrar el texto asociado al código. Esta opción está activada inicialmente y puede desactivarse.

5. Ejecuta la generación y revisa el resultado. Cuando se completa correctamente, el resultado incluye datos de imagen PNG codificados en base64. Puedes usar esos datos en el flujo que necesite una imagen, siempre que la generación haya sido válida.

En los formatos numéricos, el sistema elimina los caracteres que no son dígitos y limita el dato a la cantidad de cifras exigida por el formato. En los casos aplicables, la biblioteca de códigos de barras añade la cifra de control. Por eso conviene revisar el dato y confirmar que contiene suficientes cifras antes de generar.

Cómo interpretar el resultado

Un resultado correcto incluye una imagen PNG representada como datos codificados en base64. La presencia de un resultado correcto no significa que el PNG tenga exactamente el ancho y el alto solicitados: esos ajustes se convierten y se limitan a rangos válidos, pero las dimensiones en píxeles de la imagen resultante no están garantizadas.

Si el campo de datos está vacío, el proceso puede devolver un resultado correcto a nivel de operación con una indicación de error, pero sin imagen. En un formato numérico reconocido, una cantidad insuficiente de cifras produce el mismo tipo de límite: se indica el error y no se genera la imagen. También puede ocurrir si el formato elegido no está disponible para la biblioteca de códigos de barras. Si la dependencia necesaria no está disponible o la generación provoca una excepción, el resultado puede ser fallido y contener una indicación de error.

Por tanto, interpreta la imagen codificada como la señal de que la generación se ha completado; interpreta una indicación de error como una señal para revisar el dato, el formato o la configuración antes de reutilizar el resultado.

Ejemplo práctico

Una tienda necesita convertir la referencia alfanumérica «Pedido-ES-1048» en un código de barras para identificar un pedido.

Introduce «Pedido-ES-1048», conserva Code 128, establece un ancho de 800 y un alto de 120, deja activada la opción de mostrar el texto y ejecuta la generación.

Un resultado correcto que contiene datos de imagen PNG codificados en base64; si la generación no es válida, contiene una indicación de error en lugar de la imagen.

Limitaciones

• El ancho y el alto se normalizan a rangos válidos, pero no se garantiza que coincidan exactamente con las dimensiones en píxeles del PNG resultante.

Errores frecuentes

• Causa: el campo está vacío o un formato numérico contiene menos cifras de las necesarias. Corrección: introduce el dato completo y revisa que tenga suficientes dígitos antes de volver a generar el código.

Preguntas frecuentes

¿Puedo generar un código de barras sin introducir datos?

Sí, el campo de datos es opcional, pero cuando se deja vacío el resultado incluye una indicación de error y no devuelve una imagen. Introduce un valor antes de generar el código.

¿El PNG tendrá exactamente el ancho y el alto que indique?

No necesariamente. Para datos no vacíos, el ancho se limita a 100-2000 y el alto a 40-600, pero las dimensiones en píxeles del PNG resultante no están garantizadas como idénticas a las solicitadas.

¿Qué ocurre si introduzco pocos dígitos en un formato numérico?

Depende del formato y de la cantidad de cifras. En formatos numéricos reconocidos se eliminan los caracteres no numéricos y se comprueba que queden suficientes dígitos; si faltan, se indica un error y no se genera la imagen.