Cuando no tenía una impresora térmica y quería hacer pruebas siempre me preguntaba si existe algún simulador o emulador de impresora térmica, algo así como una impresora térmica virtual.

Hace unos días encontré una herramienta llamada escpos-tools que, a partir de un archivo binario (montón de bytes en formato esc pos) puede extraer imágenes y texto, así como convertir a HTML.

No es una impresora térmica virtual como tal, pero sirve para probar ciertas cosas. A mí me viene muy bien para su extracción de imágenes, ya que mi impresora física no soporta el algoritmo NV Graphics, pero el emulador de impresora térmica sí que lo soporta, así que puedo probar mi algoritmo de una manera sencilla.

En este post te enseñaré a instalar las herramientas ESC POS que básicamente serían como lo contrario a mi plugin para impresoras térmicas, ya que estas leen comandos ESC POS escritos en un archivo y tratan de extraer la información, mientras que mi plugin genera un diseño de ticket y lo imprime.

Instalando escpos-tools

Todo comienza en el repositorio oficial: https://github.com/receipt-print-hq/escpos-tools/

Ahí se indican las instrucciones: básicamente es clonar el repositorio, instalar las dependencias con composer (composer install) e invocar al script necesario. Si quieres extraer las imágenes usa escimages.php

Para extraer el texto, utiliza esc2text.php y para convertir comandos ESC POS a HTML utiliza esc2html.php

Una nota sobre ImageMagick para PHP en Windows

Para extraer imágenes de un archivo ESC POS es necesario contar con la extensión ImageMagick. Al menos en Windows es un poco complejo instalarla ya que debemos descargar una DLL dependiendo de nuestra versión de PHP, agregar la extensión al php.ini y reiniciar el servidor Apache.

Afortunadamente un programador ya hizo una herramienta que te permite filtrar y descargar Image magick mostrando un tutorial interactivo, yo lo he seguido y ha funcionado sin problemas: https://mlocati.github.io/articles/php-windows-imagick.html

Por cierto, al usar Image Magick con este método hay que especificar la ruta absoluta al momento de trabajar con imágenes. Yo probé con rutas relativas y no funcionaba.

Extraer imagen de impresora térmica

Ahora que ya tenemos instaladas las escpos-tools podemos usar los scripts de PHP según la necesidad. Yo quiero extraer las imágenes de un archivo binario.

Para extraer la imagen hay que abrir una terminal en donde se encuentran las escpos-tools y ejecutar:

php escimages.php archivo_binario

Nota: en este caso el binario de PHP debe estar en la PATH de Windows, la ubicación puede cambiar pero puedes seguir este tutorial con XAMPP.

Ejemplo

Tengo  un archivo binario que he creado a partir del algoritmo NV Graphics (se llama swamp.bin). Quiero revisar si mi algoritmo es correcto, así que ejecuto lo siguiente:

php escimages.php -f swamp.bin

El script va a leer el archivo binario y extraer las imágenes que existen. En mi caso solo había una imagen así que se me ha informado que había una imagen de 320×480 y se ha creado en el lugar de ejecución del script:

Por si no queda claro, la imagen de la izquierda es la imagen original.

La he transformado a bytes ESC POS usando el algoritmo NV Graphics, he colocado dichos bytes en un archivo binario llamado swamp.bin y después he extraído la imagen que se imprimiría en una impresora térmica a partir de escimages.php, resultando la imagen de la derecha.

Entonces estos scripts sirven como un emulador de impresora térmica para probar comandos ESC POS. Podemos usar el script para extraer imágenes, para extraer texto o para convertir el ticket a HTML.

Te repito que a mí me funcionó de maravilla y fue como una impresora térmica virtual, pues pude probar si mi algoritmo era correcto.

Diseñador para impresoras térmicas

Lo mostrado aquí sirve para ejemplificar cómo tener una vista previa de los comandos ESC POS antes de enviarlos a una impresora.

Si tú solo quieres diseñar e imprimir tickets puedes probar mi diseñador web para impresoras térmicas, mismo que ya tiene todas sus operaciones probadas.