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

Dibujo de formas

Dibujo de formas

Aplica a: BarcoderX Basic y Ultimate

Estado: Construido, aún sin publicar. El motor de dibujo existe y está probado. Es una biblioteca dentro del motor, que todavía se está construyendo. No hay ningún paquete publicado, no hay una interfaz pública que usted pueda llamar para dibujar directamente, y el motor con licencia será la única vía pública para producir salida. El motor puede rellenar formas, dibujar contornos, mezclar colores, recortar y ejecutar una lista de pasos de dibujo sobre tres tipos de superficie. Todavía no puede dibujar líneas discontinuas ni colocar imágenes. Esta página dice qué hace hoy y qué viene después.

BarcoderX dibuja las etiquetas con su propio motor de dibujo. No usa las funciones de dibujo del sistema operativo, por lo que una etiqueta se ve igual en Windows x64, Linux x64 y Linux arm64. Todo lo que hay en una etiqueta, como el texto, los códigos de barras y los cuadros, se dibuja con las partes que se describen aquí. Esta página las describe hasta donde necesita saberlo un desarrollador. Para una etiqueta, el motor calcula el dibujo a partir de la plantilla, de modo que usted no llamará directamente a estas partes.

Formas

Una forma es un trazado: una serie de movimientos, líneas rectas y curvas. Un trazado puede tener varias piezas separadas, y cada pieza puede estar abierta o cerrada. Un trazado se construye con estos pasos:

  • Un movimiento a un punto, y una línea recta hasta un punto.
  • Una curva suave con un punto de control, y una curva suave con dos puntos de control.
  • Cerrar la pieza actual.

Cuatro formas ya hechas ahorran los pasos: un rectángulo, un rectángulo con esquinas redondeadas (cada esquina tiene su propio radio horizontal y vertical), una elipse y un arco de elipse.

Mover, escalar y girar

Una transformación coloca una forma en la página. Una forma se puede desplazar, escalar en cantidades distintas a lo ancho y a lo alto, y girar en cualquier ángulo, alrededor del origen o alrededor de un punto que usted elija. Las transformaciones se combinan en el orden que usted indique, y una transformación que se puede deshacer tiene una inversa. Un giro en un ángulo que no es múltiplo de 90 grados se dibuja directamente, y el resultado es suave.

Rellenar una forma

Rellenar calcula qué píxeles cubre el interior de una forma, y en qué medida. Dos reglas deciden qué es el interior cuando un trazado se cruza a sí mismo o tiene una pieza dentro de otra:

  • Distinto de cero. Un punto está dentro si el trazado da alguna vuelta a su alrededor. Una pieza dibujada dentro de otra en el mismo sentido sigue rellena.
  • Par-impar. Un punto está dentro si una línea desde él hacia el exterior cruza el trazado un número impar de veces. Una pieza dibujada dentro de otra forma un agujero.

Los bordes son suaves. Para cada píxel, el motor calcula qué parte del píxel cubre la forma, como un número de 0 (nada) a 255 (todo). Poner un color sobre una superficie en esa proporción es mezclar (vea más abajo). Un píxel que la forma cubre por completo vale exactamente 255, y uno que no toca vale exactamente 0. Por eso, un rectángulo cuyos bordes coinciden con los límites de los píxeles se rellena sin ningún borde suave.

Contornos

El contorno de un trazado se dibuja trazándolo. Un trazo tiene:

  • El ancho de la línea.
  • Las esquinas: en punta, redondeadas o cortadas.
  • Los extremos de la línea: planos, redondeados o cuadrados.
  • Un límite para las esquinas muy agudas. Una esquina muy aguda haría una punta larga, así que al pasar el límite se corta.

Las líneas y los contornos de los cuadros y las elipses se dibujan así. Las curvas se cortan primero en piezas rectas cortas, igual que en un relleno. Las líneas discontinuas todavía no están construidas.

Mezcla

Dibujar con transparencia parcial pone el color nuevo sobre lo que ya está, en proporción a su opacidad y a cuánto del píxel cubre. Las superficies de gris usan una ponderación fija de rojo, verde y azul para convertir un color en un valor de gris.

Recorte

Un área de recorte limita hasta dónde puede llegar el dibujo. Puede ser un rectángulo o un trazado. Las áreas de recorte se pueden anidar, hasta 64 al mismo tiempo. Un dibujo que anida más, o cuyas formas de recorte necesitarían demasiada memoria, se detiene en ese punto con el código BX3006. Donde una forma de recorte y el borde de otra forma cruzan el mismo píxel, el resultado es aproximado. Un rectángulo dibujado dentro de un recorte rectangular es exacto.

Superficies

Una superficie es la cuadrícula de píxeles sobre la que usted dibuja. Existen tres tipos:

SuperficieQué contiene
Color con transparenciaRojo, verde, azul y opacidad de cada píxel, de 8 bits cada uno.
GrisUn valor de 8 bits por píxel.
Blanco y negroUn bit por píxel, ocho por byte.

Una superficie nueva empieza vacía: transparente en color y negra en gris.

En una superficie de blanco y negro nunca hay grises ni suavizado. Una forma vuelve negro un punto donde cubre al menos la mitad del punto. La pintura blanca borra puntos. Las barras dibujadas como rectángulos sobre puntos enteros son exactas. Una línea fina centrada en un punto entero puede salir un punto más ancha de lo que usted espera, porque una cobertura de exactamente la mitad cuenta como negro. Una línea centrada en medio punto, o dibujada como un rectángulo, conserva su ancho.

Una lista de pasos de dibujo

En lugar de dibujar de inmediato, el motor registra los pasos en una lista: rellenar un trazado, rellenar rectángulos, trazar el contorno de un trazado, iniciar un área de recorte (un rectángulo o un trazado) y terminarla. La lista se puede escribir como texto sencillo en una sola forma fija, de modo que dos listas se puedan comparar con exactitud. Ejecutar una lista la dibuja sobre una superficie. Si un paso falla, la ejecución se detiene en ese paso, dice cuál fue y conserva lo que se dibujó antes.

Precisión

  • Los puntos se llevan a una cuadrícula de 1/4096 de píxel antes del relleno, y el relleno usa después solo aritmética de números enteros. Por eso el resultado no depende del procesador.
  • Las curvas se cortan en piezas rectas cortas que quedan a menos de 0.1 de píxel de la curva real.
  • En las pruebas automáticas de BarcoderX, las etiquetas de prueba, dibujadas con rellenos y contornos, tienen la misma huella digital en Windows x64, Linux x64 y Linux arm64.
  • Un rectángulo cuyos bordes coinciden con los límites de los píxeles es exacto. Una forma con bordes inclinados queda a menos de 0.6 de un paso (de 255) de la cobertura exacta.
  • Donde varias piezas de un trazado que se superponen cruzan el mismo píxel, su cobertura se suma en lugar de combinarse, así que el resultado puede alejarse mucho del área cubierta real. En las partes de un contorno que se superponen o que vuelven sobre sí mismas, un píxel del borde puede quedar mucho más oscuro de lo debido: como se midió en la revisión de seguridad, una línea dibujada de ida y vuelta sobre sí misma dio 255 en un píxel del borde cubierto a la mitad, donde lo exacto es 128. Una pieza sola, y las piezas que apenas se tocan, son exactas dentro del redondeo de la cuadrícula.

Límites

BarcoderX comprueba cada límite antes de reservar la memoria que protege. Un dibujo demasiado grande o demasiado complejo se rechaza con un código de diagnóstico de 3001 a 3006. Consulte Códigos de diagnóstico.

LímiteValor
Píxeles en una superficie, ventana o área de cobertura64,000,000 (64 millones)
Lado más largo de una superficie, ventana o área de cobertura262,144 píxeles. Es una propiedad fija del diseño y no se puede aumentar.
Pasos en un trazado1,000,000
Piezas rectas en que se cortan las curvas de un relleno4,000,000
Trabajo de un relleno, de un contorno o de una ejecución de una lista100,000,000 de unidades. Según el trabajo, son entre unos 2 y unos 8 segundos en un procesador de escritorio reciente.
Tamaño de una coordenada después de la transformaciónUnos mil millones de píxeles (2 elevado a la 30)
Áreas de recorte abiertas al mismo tiempo64. La memoria que se guarda para las formas de recorte nunca supera el límite de píxeles de una superficie.
Pasos en el contorno de un trazo500,000
Pasos en los contornos de todos los trazos de una lista2,000,000

Los límites de piezas rectas y de trabajo, y los tres últimos límites, son primeras elecciones de quienes construyen BarcoderX. Todavía no se han confirmado y pueden cambiar antes de la primera versión. Un anfitrión puede reducir los límites.

El código de dibujo comprueba si se canceló en cada fila y cada 1,024 piezas, de modo que el programa que lo llama puede imponer su propio límite de tiempo, como 2 segundos para una etiqueta. Una coordenada que no es un número, o que es demasiado grande, se rechaza.

Qué todavía no está construido

  • Las líneas discontinuas.
  • Imágenes. Colocar una imagen sobre una superficie, con escala.
  • Volver a leer una lista desde su forma de texto.
  • Una etiqueta de una plantilla a una impresora. La disposición, el texto, las formas y los códigos de barras se reúnen en el motor de etiquetas, que hace la lista de pasos de dibujo de una etiqueta. Consulte El motor de etiquetas. El generador de PNG dibuja esa lista y guarda un archivo PNG, y el servicio de etiquetas ejecuta ambos: consulte Salida PNG y El servicio de etiquetas. El motor está unido al escritor de ZPL, que envía toda la etiqueta como una sola imagen: consulte Salida ZPL. La lista de pasos de dibujo queda dentro de BarcoderX, y un programa no puede dibujarla por su cuenta. El texto se compone como se describe en Texto en una etiqueta, y llega a la superficie como formas rellenas.

BarcoderX es un producto de P4 Software.

¿Te resultó útil esta página?