Saltar al contenido
P4 Software P4 Software / BarcoderX Español

Agrega esta documentación a Claude

Hazle preguntas a Claude sobre esta documentación. Claude lee las páginas publicadas y te enlaza a ellas. Copia esta dirección:

https://p4-software.opendocs.page/mcp

En claude.ai o Claude Desktop: abre Configuración, luego Conectores, elige Agregar conector personalizado y pega la dirección.

En Claude Code, ejecuta:

claude mcp add --transport http docs https://p4-software.opendocs.page/mcp

El motor de etiquetas

El motor de etiquetas

Aplica a: BarcoderX Basic y Ultimate

Estado: Construido, aún sin publicar. La primera parte del motor de etiquetas existe y está probada, pero todavía no se ha publicado nada y no hay nada que descargar. Es la parte de BarcoderX por la que pasa toda etiqueta, y todavía se está construyendo. No hay ningún paquete publicado, y el motor con licencia será la única vía pública para producir salida. El motor hace el dibujo de una etiqueta. La parte que lo dibuja y guarda un archivo PNG está unida al motor, y el servicio de etiquetas usa las dos. La parte que convierte una imagen en comandos ZPL está unida al motor, de modo que una plantilla se convierte en los comandos de una etiqueta completa, enviada a la impresora como una sola imagen (consulte Salida ZPL). Todo lo que está marcado como "planificado" todavía no se puede usar.

El motor de etiquetas toma una plantilla y hace el dibujo de una etiqueta. Es la parte de BarcoderX que decide dónde va cada cosa: convierte las longitudes en puntos de impresora, compone el texto, los cuadros y los códigos de barras, y anota el dibujo como una lista de pasos. Esta página dice qué recibe el motor, qué devuelve, qué dibuja hoy y qué deja fuera, y qué debe hacer un programa que lo aloja para mantenerse seguro.

Qué hace el motor

Para una plantilla, el motor hace estas cosas en este orden:

  1. Revisa la plantilla. Una plantilla que no es válida da mensajes y ningún dibujo.
  2. Calcula el tamaño de la etiqueta en puntos de impresora a la resolución que usted pide.
  3. Compone cada elemento en el orden de la plantilla. El primer elemento queda al fondo.
  4. Escribe el dibujo: primero una página blanca del tamaño de la etiqueta y luego cada elemento encima.

El motor no genera píxeles, ni un archivo, ni comandos de impresora. Lo que hace es una lista de pasos de dibujo, en puntos. Consulte Dibujo de formas para la lista de pasos de dibujo y las superficies. La lista queda dentro de BarcoderX: un programa que llama al motor no puede leerla, dibujarla por su cuenta ni guardarla. La única vía pública del motor a una imagen es el generador de PNG, que toma el resultado completo del motor y devuelve un archivo PNG o el motivo por el que no hay ninguno. Se describe en Salida PNG, y el servicio de etiquetas lo ejecuta por usted. La parte que escribe comandos ZPL a partir de una imagen en blanco y negro se describe en Salida ZPL. Es a propósito: nada puede dibujar una etiqueta sin pasar por el motor.

La plantilla más pequeña de la página El formato de plantilla de etiqueta, con un texto, un cuadro y un código de barras EAN-13, da una etiqueta de 799 por 400 puntos a 203 puntos por pulgada. Son 100 mm por 50 mm, redondeados a puntos enteros.

Qué recibe

EntradaQué es
La plantillaEl diseño de la etiqueta. El motor la revisa por sí mismo, de modo que el programa que lo llama no tiene que hacerlo. Una plantilla no válida da mensajes y ningún dibujo. El motor nunca lanza un error por una plantilla.
La resoluciónLa resolución de impresora a la que se dibuja, en puntos por pulgada, de 96 a 1,200. Si no indica ninguna, el motor usa la resolución de la plantilla.
Los límitesLo máximo que puede usar una etiqueta. Si no indica ninguno, el motor usa los valores predeterminados de la tabla de abajo.

Una longitud escrita en milímetros, pulgadas o puntos tipográficos conserva su tamaño físico cuando se dibuja a otra resolución. Una longitud escrita en puntos de impresora se escala en proporción a las dos resoluciones. Cada borde se redondea a un punto entero, de modo que una barra o un borde nunca tiene un contorno borroso. La sección siguiente da la regla.

De una longitud a puntos de impresora

No hay un número fijo de puntos en un milímetro. Un milímetro es exactamente 1/25.4 de pulgada, de modo que a 203 puntos por pulgada son 203/25.4 puntos, unos 7.99 y no 8. Por ejemplo, 10 mm a 203 puntos por pulgada son 79.92 puntos, y el motor los redondea a 80.

  • La conversión es exacta. Una pulgada son 25.4 mm, un punto tipográfico es 1/72 de pulgada, un mil es 1/1000 de pulgada, un twip es 1/1440 de pulgada y un micrómetro es 1/25400 de pulgada. El motor convierte una longitud con una razón exacta y redondea solo al final.
  • El redondeo va al punto más cercano, y una mitad se aleja del cero. Nunca es un truncamiento ni un redondeo hacia arriba. La misma regla se usa en todo lugar donde una longitud debe volverse puntos enteros.
  • Posición y tamaño. Los cuatro bordes de un elemento, izquierdo, superior, derecho e inferior, se redondean cada uno a un punto entero, y el tamaño es la diferencia de los bordes redondeados. Dos cuadros que se tocan antes de redondear se tocan también después. Un tamaño puede diferir en un punto del ancho redondeado.
  • La página. El ancho y el alto de la etiqueta se redondean.
  • Bordes y trazos. Se redondean, pero un ancho mayor que cero nunca es menor que un punto.
  • La altura de las barras de un código de barras. Se redondea, y es de al menos un punto.
  • El ancho de módulo de un código de barras. Se redondea a un punto entero, con un mínimo de un punto. Un módulo más angosto que un punto se sube a un punto con una advertencia (BX4013). Para un módulo de un punto o más, BX3906 indica el ancho que se usó siempre que difiere del pedido. La compensación del ancho de barra se redondea de la misma forma.
  • El tamaño de la fuente no se redondea. La biblioteca de texto usa el tamaño en puntos tipográficos tal cual y redondea solo el punto de partida de cada letra a un punto entero.
  • Una longitud escrita en puntos de impresora se escala por la nueva resolución dividida entre la resolución de la plantilla. La conversión misma no redondea el valor escalado.
  • Pasar una plantilla a otra resolución convierte de nuevo a partir de los valores que usted escribió, y redondea de nuevo. No redondea dos veces.

Qué devuelve

SalidaQué es
Éxito o noSi se hizo un dibujo de toda la etiqueta. No significa que todos los elementos estén en él: un elemento que no se puede dibujar se omite con un mensaje.
El dibujoLa lista de pasos de dibujo, con el origen en la esquina superior izquierda, guardada dentro de BarcoderX. Un programa no puede leerla, pero sí puede pasar el resultado completo al generador de PNG. Cuando una etiqueta falla no hay ningún dibujo, nunca una parte de la etiqueta, porque una etiqueta a medias en una impresora es peor que ninguna.
El tamañoEl ancho y el alto de la etiqueta en puntos, para la superficie sobre la que se dibuja.
La resoluciónLa resolución a la que se compuso la etiqueta.
Los conteosCuántos elementos se dibujaron y cuántos se omitieron.
Los mensajesLo que el motor y las partes que usa tienen que informar, en el orden en que se encontró. Son los códigos de diagnóstico de Códigos de diagnóstico.
Los límites de dibujoLos límites con los que se hizo el dibujo. Quedan dentro de BarcoderX junto con el dibujo.

El motor da el mismo dibujo para la misma plantilla y la misma resolución. En las pruebas automáticas de BarcoderX, la huella digital del dibujo de la plantilla más pequeña a 203 y a 300 puntos por pulgada es la misma en Windows x64, Linux x64 y Linux arm64. Se pueden hacer muchas etiquetas a la vez desde distintos hilos.

Qué dibuja hoy

  • Texto. Texto fijo, como se describe en Texto en una etiqueta: alineación, espaciado, alineación vertical y reducción automática del texto, con la tipografía integrada BX Core.
  • Cuadros. Un cuadro tiene un relleno, un borde con su propio ancho en cada lado y un radio de esquina. Se usa un solo radio para las cuatro esquinas, el mayor que da la plantilla, y un cuadro redondeado con bordes de distinto ancho usa el más ancho. El motor informa de ambas cosas.
  • Códigos de barras. El contenido está escrito en la plantilla. Se dibujan quince tipos de código de barras: EAN-13, EAN-8, UPC-A, UPC-E, ITF-14, GS1-128 y SSCC-18, los dos complementos solos, y EAN-13, UPC-A y UPC-E, cada uno con un complemento de dos dígitos y uno de cinco. Las barras se dibujan sobre puntos enteros de la impresora. Si usted indica un ancho de módulo (xDimension), BarcoderX lo redondea a puntos enteros e informa del ancho que usó (BX3906). Si no indica ninguno, el código de barras llena su cuadro con el módulo de puntos enteros más grande que quepa. Los dígitos debajo de las barras se dibujan cuando el código de barras tiene un ajuste humanReadable con below o above, y no en otro caso. Consulte Códigos de barras.
  • Giro. Un elemento se puede girar alrededor de su punto de anclaje. Los giros de 90, 180 y 270 grados mantienen los bordes de las barras y de los cuadros sobre la cuadrícula de puntos de la impresora. Los demás ángulos se dibujan como formas y no son una buena opción para una impresora.

Los dígitos de un complemento se dibujan encima de las barras del complemento. Consulte UPC-E y complementos.

Dígitos que no caben debajo de un código de barras

Cuando los dígitos debajo de un código de barras son más anchos que el espacio que les da el código, por ejemplo en un EAN-13 a 2 puntos de impresora por módulo y una fuente de 10 puntos, el motor los hace más pequeños. Todos los grupos de dígitos reciben el mismo tamaño, el mayor con el que los grupos caben, y nunca menos del 70 por ciento del tamaño que usted pidió. El 70 por ciento es una primera elección de quienes construyen BarcoderX (elección del constructor, pendiente de la confirmación del propietario). El motor informa el cambio una sola vez para el elemento (BX3412). Si los dígitos todavía no caben con ese tamaño, el motor no los corta ni los mueve. Pueden superponerse a la zona de silencio o al grupo siguiente, y el motor lo informa una sola vez para el elemento (BX3915). Para que quepan, use a propósito un módulo más ancho o un tamaño de fuente menor.

Qué deja fuera, y lo dice

Una plantilla puede pedir cosas que el motor todavía no dibuja. El motor dibuja el resto de la etiqueta, y cada omisión viene con un mensaje, de modo que nada desaparece sin avisar:

  • Elementos de los tipos línea y elipse (BX3903). Las imágenes y los demás tipos tampoco se leen todavía de una plantilla. Consulte El formato de plantilla de etiqueta.
  • Contenido que viene de datos o de una expresión (BX3904). Por ahora escriba el contenido como texto fijo.
  • Contenido escrito como bytes o con secuencias de escape en un código de barras (BX3914).
  • Ajustes que todavía no se aplican (BX3902): las opciones de un código de barras y los modos del dígito verificador distintos del automático, el marcado del texto, el texto de derecha a izquierda, el texto sobre un arco, los formatos de número y de fecha, las máscaras de entrada, los valores de tamaño stretch y scale, el subrayado, el tachado y las fuentes residentes en la impresora, las reglas de cuándo imprimir un elemento, las propiedades calculadas, el reverso de una página, el radio de cada esquina, las esquinas redondeadas del cuadro de un texto, un ancho de borde distinto en cada lado de un cuadro redondeado, y los ajustes de página para la orientación y para varias etiquetas en una página.
  • Un tipo de código de barras sin codificador (BX3905).

Otras cosas están planificadas y no están construidas: las imágenes, las cuadrículas, los repetidores, varias etiquetas en una página, y los comandos propios de texto y de códigos de barras de la impresora (el compositor de ZPL ya envía toda la etiqueta como una sola imagen: consulte Salida ZPL). El motor comprueba la licencia antes de dibujar nada. Un problema de licencia nunca detiene una etiqueta: en el peor caso la salida lleva la marca de evaluación. Consulte Marca de evaluación y claves de licencia.

Límites

BarcoderX comprueba cada límite antes de gastar el recurso que protege. Una etiqueta que necesita más de lo que permiten los límites se rechaza completa, y no se dibuja nada (BX3909). Una etiqueta que tarda más que el límite de tiempo también se rechaza (BX3910). Los límites de abajo son los que usa el motor cuando usted no indica ninguno. Un programa que llama al motor puede fijar límites más bajos, y debería hacerlo en una página pública.

Cada número de esta tabla, salvo donde se indique otra cosa, es una primera elección de quienes construyen BarcoderX (elección del constructor, pendiente de la confirmación del propietario). Todavía no se ha confirmado y puede cambiar antes de la primera versión.

LímiteValor predeterminado
Elementos en una plantilla2,000 (fijado por el plan; el límite de la revisión de la plantilla)
Píxeles de la etiqueta64,000,000 (64 megapíxeles; fijado por el plan)
Lado más largo de la etiqueta65,536 puntos
Segmentos de trazado en un relleno1,000,000 (fijado por el plan)
Tiempo para componer y escribir una etiqueta2 segundos (fijado por el plan)
Caracteres de texto en un elemento10,000
Líneas de texto en un elemento500
Caracteres de texto en todos los elementos de una etiqueta, incluidos los dígitos debajo de los códigos de barras50,000
Segmentos de trazado que conservan todos los elementos de una etiqueta (letras, cuadros redondeados, formas giradas)500,000, unos 12.5 MB
Rectángulos que conservan todos los elementos de una etiqueta (barras, bordes, rellenos)100,000
Unidades de trabajo del dibujo25,000,000
Recortes abiertos a la vez16 (el motor todavía no dibuja ningún recorte)
Mensajes en un resultado500; los demás se cuentan y se reemplazan por una advertencia, y siempre se muestran el primer error y el último
Distancia de un elemento a la etiqueta100,000,000 puntos

Los límites de un elemento de texto son de una cuarta a una quinta parte de los valores predeterminados de la biblioteca de texto, y los totales de la etiqueta se eligieron de modo que una etiqueta conserve como máximo unos 12.5 MB de segmentos de trazado.

Valores propuestos para una página de demostración pública

Las revisiones de seguridad proponen valores más bajos para una página que cualquiera puede usar en internet. También son primeras elecciones (elección del constructor, pendiente de la confirmación del propietario), y decide el propietario.

LímiteValor propuesto
Elementos en una plantilla200
Caracteres de texto en un elemento2,000
Líneas de texto en un elemento200
Unidades de trabajo de la composición de un texto2,000,000
Caracteres de texto en todos los elementos de una etiqueta5,000
Segmentos de trazado que conservan todos los elementos de una etiqueta200,000
Rectángulos que conservan todos los elementos de una etiqueta20,000
Mensajes en un resultado100
Tiempo para componer y escribir una etiqueta1 segundo
Segmentos de trazado en un relleno100,000
Píxeles de una superficie9,000,000 para una imagen de impresora en blanco y negro, 2,500,000 para una vista previa en color o en gris
Lado más largo8,192
Bordes aplanados400,000 (200,000 para una vista previa)
Unidades de trabajo del dibujo25,000,000 (10,000,000 para una vista previa)
Recortes abiertos a la vez16
Tiempo de un dibujo2 segundos como máximo
Tamaño de un archivo PNG2,000,000 bytes
ResoluciónDe 72 a 600 puntos por pulgada

Una página pública tampoco debería ofrecer subir fuentes.

Si usted aloja el motor

El motor está hecho para ser seguro en un programa que lo aloja. Un anfitrión tiene sus propias obligaciones.

  • Dibuje el resultado solo con el generador de PNG. El motor calcula el trabajo máximo que el generador puede necesitar para la etiqueta, y rechaza una etiqueta cuyo trabajo máximo supera el límite de trabajo del dibujo (BX3909, recurso renderWork), de modo que una etiqueta aceptada es una que el generador puede terminar. Si el generador se detiene por cualquier otro motivo, sigue sin devolver ninguna imagen, nunca una dibujada a medias, porque un código de barras dibujado a medias nunca debe llegar a una impresora. Un programa que usa el generador no tiene nada que descartar, y nada más puede dibujar el resultado del motor. El límite de trabajo es un techo para la etiqueta en sí. Una etiqueta que lleva la marca de evaluación recibe además un margen para la marca, encima del techo, en los límites que se devuelven con el resultado, de modo que la marca siempre se dibuja completa y la etiqueta se acepta o se rechaza igual con la marca que sin ella. En la página más grande, ese margen llega a unos 7.9 millones de unidades, cerca de un tercio de las 25,000,000 predeterminadas, así que un operador puede contar con ese margen al fijar el límite.
  • Pase un límite de tiempo a cada dibujo. Los 2 segundos del motor cubren la composición y la escritura de la etiqueta. El dibujo es tiempo del anfitrión. Pase un límite de tiempo de cancelación a cada dibujo del generador de PNG. Para una página pública se proponen 2 segundos.
  • Llame a LabelEngine.WarmUp() una vez al iniciar. La primera solicitud de un proceso paga un trabajo que se hace una sola vez: la primera compilación del código, la fuente integrada y las tablas de los códigos de barras. Eso lleva cerca de medio segundo en la máquina de desarrollo, y más en una máquina pequeña u ocupada. El motor hace ese trabajo por sí mismo antes de que empiece el límite de tiempo de la primera solicitud, así que esa solicitud no se rechaza por eso; llamar a WarmUp al iniciar solo mueve la espera a un momento que usted elige. El límite de tiempo es tiempo de reloj, así que una máquina ocupada todavía puede hacer que una etiqueta tarde lo bastante para fallar. Para un límite que no dependa de la velocidad de la máquina, use los límites contados (BX3909). El trabajo que una solicitud elige para sí misma, como una fuente subida, se sigue contando en el tiempo de esa solicitud.
  • Limite cuántas etiquetas se leen y se dibujan a la vez. Leer una plantilla grande usa mucha memoria, y dibujar también. Con los límites de demostración propuestos, se estima que un dibujo en color usa unos 135 MB. El generador de PNG se crea con el número de dibujos que puede ejecutar a la vez, y rechaza de inmediato el siguiente (BX3707) en lugar de ponerlo en cola. Calcule ese número a partir de la memoria del anfitrión.
  • Dibuje una etiqueta de prueba al arrancar. En una revisión de seguridad se midió que el primer dibujo en un proceso nuevo tarda hasta unas 18 veces más que uno posterior (3.9 segundos frente a 0.21 segundos en un caso de prueba). Dibuje una etiqueta cuando arranque el anfitrión.
  • Muestre los mensajes como texto. Un mensaje trae el id de un elemento y nombres que se escribieron en la plantilla. Insértelos en una página como texto, nunca como marcado, y muéstrelos en un contexto de dirección aislado. Reemplace los saltos de línea, los demás caracteres de control y los caracteres de dirección antes de escribirlos en un registro. Consulte Códigos de diagnóstico.
  • Codifique la plantilla antes de mostrarla. El texto canónico de una plantilla no está escapado para HTML. Codifíquelo antes de incrustarlo en una página, y póngalo en un bloque de script solo con cada < escrito como \u003C. Consulte El formato de plantilla de etiqueta.

Lo que todavía no está construido

  • Una etiqueta de una plantilla a una impresora. Construido para ZPL como una sola imagen: consulte Salida ZPL. Los comandos propios de texto y de códigos de barras no están construidos. La unión con la salida PNG existe en el servicio de etiquetas.
  • Datos y expresiones. Etiquetas con campos, variables y contadores.
  • Los demás tipos de elemento. Líneas, elipses, imágenes, cuadrículas y repetidores.
  • Varias etiquetas en una página, y la orientación de la página.

BarcoderX es un producto de P4 Software.

¿Te resultó útil esta página?