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

Salida PNG

Salida PNG

Aplica a: BarcoderX Basic y Ultimate

Estado: Construido, aún sin publicar. El escritor de PNG, y el generador de PNG que dibuja el resultado del motor de etiquetas y lo guarda como archivo PNG, existen y están probados, pero todavía no se ha publicado nada y no hay nada que descargar. Son bibliotecas dentro del motor, que 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 escritor de PNG no se puede llamar por sí solo. El generador de PNG toma únicamente el resultado del motor de etiquetas, y el servicio de etiquetas ejecuta juntos el motor y el generador: consulte El servicio de etiquetas. Esta página dice qué está construido y qué no.

PNG es el formato de imagen que BarcoderX usa para las vistas previas, las páginas web y cualquier otro uso en que usted necesite una imagen de una etiqueta. Consulte Formatos de salida para los demás formatos. Esta página describe dos partes. La primera es el generador de PNG, que dibuja una etiqueta y la guarda como archivo PNG. La segunda es el escritor de PNG en sí: la parte que toma los píxeles de una imagen y escribe un archivo PNG válido.

BarcoderX escribe el archivo PNG con su propio código. Lo único que toma de .NET es la compresión de los datos de la imagen.

Dibujar una etiqueta y guardarla como archivo PNG

Entre el motor de etiquetas y el escritor de PNG está el generador de PNG. Dibuja la lista de pasos de dibujo de una etiqueta sobre una superficie y guarda la superficie como archivo PNG. Consulte El motor de etiquetas para la lista de pasos de dibujo y Dibujo de formas para las superficies. Usted le da el resultado completo del motor de etiquetas, el tipo de imagen que quiere y un límite de tiempo. Los límites se fijan cuando se crea el generador. Le devuelve el archivo PNG, o mensajes que dicen por qué no hay ninguno. No acepta nada más: la lista de pasos de dibujo no es pública, y por eso ningún programa puede dibujar algo que el motor no hizo.

Tipo de imagenPara qué sirve
Blanco y negro, 1 bitLo que recibiría una impresora. No hay grises ni suavizado: un punto es negro o blanco.
GrisUna imagen de 256 grises.
ColorUna vista previa para una pantalla. La página es de un blanco opaco. Una página transparente está planificada.
  • El tamaño previsto del píxel queda registrado en el archivo. Usted indica una resolución en puntos por pulgada, y el archivo la guarda en píxeles por metro, la unidad del estándar PNG, de modo que un programa puede mostrar la imagen a su tamaño previsto.
  • Un dibujo que no se puede hacer se rechaza con un mensaje que dice qué cambiar. Los casos son una solicitud que no se puede usar, una etiqueta sin un tamaño válido, una etiqueta con demasiados puntos, un lado demasiado largo, una resolución que no es válida, un tipo de imagen que no existe, un archivo que sería demasiado grande, demasiadas etiquetas a la vez y un problema inesperado (BX3700 a BX3708). Consulte Códigos de diagnóstico.
  • Nunca se devuelve nada parcial. Un dibujo rechazado o fallido no da ninguna imagen, de modo que un código de barras dibujado a medias nunca puede llegar a una impresora.
  • La misma solicitud da el mismo archivo. En las pruebas automáticas de BarcoderX, el archivo PNG de una etiqueta de prueba en cada uno de los tres tipos de imagen tiene la misma huella digital en Windows x64, Linux x64 y Linux arm64. La advertencia de "El mismo archivo en cada plataforma, y qué comparar", más abajo, también se aplica a él.

Límites al dibujar una etiqueta

BarcoderX comprueba cada límite antes de gastar el recurso que protege. El programa que usa el generador fija todos los límites al crearlo. Ninguno tiene un valor predeterminado que el generador use a espaldas del programa, y un límite que no se puede usar se rechaza con BX3700 en el primer dibujo. Una etiqueta nunca fija sus propios límites.

LímiteLo fija el programaLo más alto que acepta el generador
Píxeles de una imagen en blanco y negro, de una en gris y de una en colorTres cifras256,000,000 cada una
Lado más largo de una superficieLos límites de dibujo de la etiqueta262,144 píxeles
Segmentos de trazado en un trazadoLos límites de dibujo de la etiqueta4,000,000
Tamaño de un archivo PNGUna cifra2,000,000,000 bytes
ResoluciónUna mínima y una máximaNada por encima de lo que dibuja el motor (de 96 a 1,200 puntos por pulgada)
Etiquetas que se dibujan a la vezUn número, de al menos 1Ninguno

Los demás límites del dibujo son los de Dibujo de formas. El servicio de etiquetas fija estas cifras a partir de su archivo de ajustes: consulte El servicio de etiquetas. Los valores más altos son las cifras que el plan fija para la salida de un trabajo completo, 256 MB y 2 GB, aplicadas a un solo archivo. Una sola etiqueta debería tener en la práctica un límite mucho más bajo, y todavía no hay una cifra para una etiqueta. La forma de aplicar las cifras del trabajo a un solo archivo 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.

Cuando un programa ya está dibujando el número de etiquetas que permite, la siguiente se rechaza de inmediato con BX3707 y no se pone en cola. Un programa puede calcular cuántas etiquetas puede dibujar a la vez a partir de su memoria y de los límites. Con los límites propuestos para una página de demostración pública (consulte El motor de etiquetas), se estima que una etiqueta en color necesita unos 135 MB. Se midieron unos 88 MB.

Lo que debe hacer un programa que aloja esto

  • Pase un límite de tiempo a cada dibujo. El dibujo y el guardado pueden tardar, y un límite de tamaño por sí solo no acota el tiempo. El generador se detiene cuando pasa el límite y no devuelve ninguna imagen. En una revisión de seguridad, guardar una etiqueta en color vacía de 9 megapíxeles tardó unos 1.5 segundos, y una de 64 megapíxeles unos 11 segundos. Una página pública debería usar límites más bajos, y necesita un límite de la frecuencia con que cada cliente puede pedir.
  • Limite cuántas etiquetas se dibujan a la vez, como arriba, y mantenga los límites fijos en el programa. No los lea de una plantilla ni de la solicitud de un visitante.
  • Use el resultado completo del motor. El generador acepta solo una etiqueta que el motor hizo sin fallar. Informe los mensajes del motor cuando el motor falló, y no llame al generador.

Qué entra en el escritor de PNG

Usted entrega al escritor los píxeles de una imagen, su ancho y su alto, y de qué tipo son los píxeles. Se aceptan estos tipos:

Tipo de imagenQué contiene cada píxel
Color con transparenciaRojo, verde, azul y opacidad, de 8 bits cada uno. La opacidad es "directa": el color no viene ya multiplicado por ella. Si sus píxeles vienen premultiplicados, conviértalos primero.
ColorRojo, verde y azul, de 8 bits cada uno.
GrisUn valor de 8 bits; 0 es negro.
Blanco y negro, 1 bitOcho píxeles por byte, con el píxel de la izquierda en el bit más alto y cada fila completada hasta un byte entero. Puede entregarlo en cualquiera de dos convenciones: aquella en que 1 significa negro (la convención de un mapa de bits de etiqueta) o aquella en que 1 significa blanco (la convención del propio PNG). El archivo siempre sigue la convención de PNG.
PaletaUn número de 8 bits por píxel que apunta a una paleta de 1 a 256 colores. Cada color de la paleta puede tener su propia opacidad. El escritor guarda los números en el tamaño más pequeño que alcanza para todos los colores de la paleta: 1, 2, 4 u 8 bits.

Qué sale

  • Un archivo PNG normal que cualquier visor abre.
  • El archivo puede registrar el tamaño previsto del píxel. Usted indica una resolución en puntos por pulgada, y el archivo la guarda en píxeles por metro, la unidad del estándar PNG (sección 11.3.5.3), de modo que un programa que lo imprima puede calcular su tamaño. Si usted no indica una resolución, el archivo no registra ninguna.
  • Usted puede elegir el nivel de compresión, de 0 (almacenado, sin comprimir) a 9 (el más pequeño). El valor predeterminado es 6.
  • Usted puede elegir cómo se preparan las filas de la imagen antes de comprimirlas, o dejar la elección automática. La elección automática sigue el método que recomienda el estándar PNG.
  • Los archivos no son entrelazados.

Límites del escritor de PNG

BarcoderX comprueba cada límite antes de reservar memoria, de modo que una imagen demasiado grande se rechaza de inmediato, y no después de que la computadora se haya quedado sin memoria.

LímiteValor
Píxeles en una imagen64,000,000 (64 millones) de forma predeterminada. El programa que llama al escritor puede fijar otro límite.
Ancho y altoComo mínimo 1 y como máximo 2,147,483,647 cada uno, como exige el estándar PNG. El límite de píxeles se alcanza mucho antes.
PaletaDe 1 a 256 colores. Una paleta se permite solo con imágenes de paleta, y cada píxel debe apuntar a un color que esté en ella.
ResoluciónUn número positivo y finito de puntos por pulgada.
Longitud de los datos de píxelesDebe coincidir exactamente con el ancho, el alto y el tipo de imagen.

Una imagen que incumple un límite no se escribe. El escritor informa una razón clara, con un código de diagnóstico de 3100 a 3106. Consulte Códigos de diagnóstico. Un trabajo en curso también se puede cancelar entre filas.

El mismo archivo en cada plataforma, y qué comparar

En las pruebas automáticas de BarcoderX, los archivos PNG de diez casos de prueba son idénticos, byte por byte, en Windows x64, Linux x64 y Linux arm64. Los casos usan seis imágenes: cinco pequeñas y una de unos 600 KB antes de comprimir, algunas de ellas con varios niveles de compresión.

Lea esto con cuidado:

  • Esto se midió con una sola versión de .NET; no es una promesa. La compresión la hace el propio .NET, y Microsoft no promete que dos versiones de .NET, o dos tipos de procesador, compriman la misma imagen en los mismos bytes.
  • Por eso, después de una actualización de .NET, los bytes de un archivo PNG pueden cambiar aunque la imagen no haya cambiado. El código de BarcoderX es el mismo, y los píxeles del archivo son los mismos.
  • Para comprobar que dos archivos muestran la misma imagen, compare sus píxeles, no sus bytes ni un hash del archivo. Abra ambos, compare los píxeles decodificados y considérelos iguales si los píxeles son iguales.

La parte que BarcoderX escribe por sí mismo, las filas preparadas antes de la compresión, se prueba en cada plataforma y no depende de .NET.

Qué todavía no está construido

  • Leer archivos PNG. El escritor solo escribe.
  • Un archivo PNG para una plantilla guardada, para varias etiquetas a la vez y para datos combinados con una plantilla. El servicio de etiquetas dibuja una etiqueta a partir de una plantilla. Consulte El servicio de etiquetas.
  • Una página transparente para las imágenes en color. La página es blanca.
  • Otros formatos de píxel desde una etiqueta, como una imagen con paleta. La parte que dibuja una etiqueta guarda blanco y negro, gris y color.
  • PNG entrelazado y otros bloques, como comentarios de texto o perfiles de color.

BarcoderX es un producto de P4 Software.

¿Te resultó útil esta página?