Hola impresora
Ahora es momento de probar si tu impresora está lista para ser utilizada con el plugin usando el Playground a continuación.
Si funciona, ya puedes ir a la descripción de la API para comenzar a imprimir de manera programática.
Guía de descarga
Selecciona una operación de abajo para comenzar
const cargaUtil = {
"serial": "",
"nombreImpresora": "",
"operaciones": [
{
"nombre": "EscribirTexto",
"argumentos": [
"Hola impresora\n"
]
}
]
};
const respuestaHttp = await fetch("http://localhost:8000/imprimir", {
method: "POST",
body: JSON.stringify(cargaUtil)
});
const respuesta = await respuestaHttp.json();
if (respuesta.ok) {
console.log("Impreso correctamente")
} else {
console.error("Petición ok pero error en el plugin: " + respuesta.message);
}
Iniciar: Inicializar impresora. Limpia los datos en el búfer y reinicia la impresora al modo que estaba en efecto cuando fue encendida. En algunas impresoras es recomendado invocar esta función antes y después de imprimir imágenes.
EscribirTexto: Escribe texto en la impresora. El texto no será impreso hasta que se encuentre un salto de línea (\n) o se invoque a Feed
Pulso: Genera un pulso eléctrico (sirve para abrir el cajón de dinero) tomando en cuenta el tiempo encendido que son los milisegundos para encender y los milisegundos para apagar según el tiempo de apagado. El pin puede ser 48 o 49. Lo recomendado es el pin 48, tiempo encendido de 60 y tiempoApagado de 120
CorteParcial: Corte parcial
Corte: Corte completo
Feed: Imprime los datos almacenados en el búfer de la impresora (almacenados al escribir texto) y avanza el papel una cantidad de lineas
TextoSegunPaginaDeCodigos: Permite escribir texto con acentos. Hay que especificar el número de página (según la impresora) y el character code page para iconv. Recomiendo probar con varias combinaciones. Esta función no tiene ningún efecto si la versión del plugin usada es la versión que no tiene iconv
EstablecerAlineacion: Establece la alineación del texto e imágenes (incluyendo códigos de barras y QR) según la alineacion. Izquierda es 0, Centro 1 y Derecha 2
EstablecerTamañoFuente: Establece el tamaño de la fuente según el multiplicador de ancho y el multiplicador del alto. Ambos valores pueden ir desde el 1 hasta el 8. También afecta a los caracteres personalizados
EstablecerSubrayado: Habilita o deshabilita el modo de texto subrayado
EstablecerEnfatizado: Habilita o deshabilita el modo de texto enfatizado
EstablecerImpresionAlReves: Habilita o deshabilita la impresión al revés
EstablecerRotacionDe90Grados: Habilita o deshabilita la rotación de 90 grados
EstablecerImpresionBlancoYNegroInversa: Habilita o deshabilita la impresión inversa. En modo inverso, el fondo es negro y el texto blanco
EstablecerFuente: Establece la fuente, que puede ser 0 o 1. En mi caso solo soporta una fuente que es la A. Tener cuidado al cambiar la fuente e intentar imprimir un carácter personalizado, pues por el momento solo funciona con la fuente A
HabilitarCaracteresPersonalizados: Habilita los caracteres personalizados. Si está habilitado entonces se va a imprimir el carácter personalizado en lugar del carácter que fue indicado para ser reemplazado
DeshabilitarCaracteresPersonalizados: Deshabilita los caracteres personalizados
DeshabilitarElModoDeCaracteresChinos: Deshabilitar el modo de caracteres chinos. Útil para imprimir tildes y texto en español en impresoras térmicas chinas. Combínalo con TextoSegunPaginaDeCodigos
HabilitarElModoDeCaracteresChinos: Habilitar el modo de caracteres chinos
DefinirCaracterPersonalizado: Define un carácter personalizado de 24x12. Es útil para imprimir caracteres no soportados por algunas impresoras, ya sea el euro, centavo o lo que puedas dibujar en un cuadro de 24x12. Esta función establece el carácter personalizado pero no lo imprime. Solo hace falta llamarla a una vez, y después cada que se imprima el carácter reemplazado se va a imprimir el personalizado La matrizComoCadena debe ser, como su nombre lo dice, una matriz como cadena. Debe tener exactamente 24 líneas (separadas por un salto de línea) y en cada línea debe haber exactamente 12 dígitos, cada dígito debe ser un 1 o un 0. No debe haber tabulaciones ni espacios extra Nota: la matriz es de 24x12 porque así es la fuente A. Si fuera la fuente B sería de 17x9, pero esa fuente no funciona en mi impresora así que no he probado. Es decir, no intentes esto si tienes seleccionada la fuente B. Para que esta operación funcione, debiste haber habilitado los caracteres personalizados previamente con HabilitarCaracteresPersonalizados
CargarImagenLocalEImprimir: Imprime una imagen existente en el sistema de archivos, suponiendo que el plugin tiene permisos de lectura en esa imagen. La imagen será convertida a blanco y negro. Si el ancho de la imagen es mayor que el máximo ancho especificado, la imagen será redimensionada para que coincida. El algoritmo se refiere al algoritmo utilizado al imprimir la imagen, que puede ser 0 para usar el método Raster Bit Image, 1 para Bit Image Column Format y 2 para NV Graphics. Las impresoras más recientes soportan NV Graphics, las antiguas soportan Raster Bit Image e Image Column Format. Lo recomendable es que el usuario pruebe con los 3 algoritmos para encontrar el más adecuado. Más información sobre los algoritmos: https://parzibyte.me/blog/2024/01/17/metodos-imprimir-imagenes-impresoras-termicas/ . El parámetro sobre el dithering indica si se debe aplicar el algoritmo Floyd-Steinberg-Dithering a la imagen antes de ser impresa. Es recomendado aplicarlo en fotografías, así se mantiene la iluminación y los detalles incluso al ser convertida a blanco y negro. Más información sobre dithering: https://parzibyte.me/blog/2024/07/28/algoritmo-floyd-steinberg-dithering-golang/
DescargarImagenDeInternetEImprimir: Descarga una imagen de internet y la imprime. La imagen debe ser accesible públicamente usando solo la URL. La imagen será convertida a blanco y negro. Si el ancho de la imagen es mayor que el máximo ancho especificado, la imagen será redimensionada para que coincida. El algoritmo se refiere al algoritmo utilizado al imprimir la imagen, que puede ser 0 para usar el método Raster Bit Image, 1 para Bit Image Column Format y 2 para NV Graphics. Las impresoras más recientes soportan NV Graphics, las antiguas soportan Raster Bit Image e Image Column Format. Lo recomendable es que el usuario pruebe con los 3 algoritmos para encontrar el más adecuado. Más información sobre los algoritmos: https://parzibyte.me/blog/2024/01/17/metodos-imprimir-imagenes-impresoras-termicas/ . El parámetro sobre el dithering indica si se debe aplicar el algoritmo Floyd-Steinberg-Dithering a la imagen antes de ser impresa. Es recomendado aplicarlo en fotografías, así se mantiene la iluminación y los detalles incluso al ser convertida a blanco y negro. Más información sobre dithering: https://parzibyte.me/blog/2024/07/28/algoritmo-floyd-steinberg-dithering-golang/
GenerarImagenAPartirDeHtmlEImprimir: Genera una imagen a partir del html usando el ancho de página como el ancho de la pantalla del navegador web para renderizar la imagen, y después imprime esa imagen generada. La imagen será convertida a blanco y negro. Si el ancho de la imagen es mayor que el máximo ancho especificado, la imagen será redimensionada para que coincida. El algoritmo se refiere al algoritmo utilizado al imprimir la imagen, que puede ser 0 para usar el método Raster Bit Image, 1 para Bit Image Column Format y 2 para NV Graphics. Las impresoras más recientes soportan NV Graphics, las antiguas soportan Raster Bit Image e Image Column Format. Lo recomendable es que el usuario pruebe con los 3 algoritmos para encontrar el más adecuado. Más información sobre los algoritmos: https://parzibyte.me/blog/2024/01/17/metodos-imprimir-imagenes-impresoras-termicas/ . El parámetro sobre el dithering indica si se debe aplicar el algoritmo Floyd-Steinberg-Dithering a la imagen antes de ser impresa. Es recomendado aplicarlo en fotografías, así se mantiene la iluminación y los detalles incluso al ser convertida a blanco y negro. Más información sobre dithering: https://parzibyte.me/blog/2024/07/28/algoritmo-floyd-steinberg-dithering-golang/
GenerarImagenAPartirDePaginaWebEImprimir: Genera una imagen a partir del html generado por la página web ubicada en la dirección indicada usando el ancho provisto como el ancho de la pantalla del navegador web para renderizar la imagen. Después, imprime esa imagen generada. Es necesario que wkhtmltoimage se encuentre en la PATH o en el mismo directorio que el plugin. La imagen será convertida a blanco y negro. Si el ancho de la imagen es mayor que el máximo ancho especificado, la imagen será redimensionada para que coincida. El algoritmo se refiere al algoritmo utilizado al imprimir la imagen, que puede ser 0 para usar el método Raster Bit Image, 1 para Bit Image Column Format y 2 para NV Graphics. Las impresoras más recientes soportan NV Graphics, las antiguas soportan Raster Bit Image e Image Column Format. Lo recomendable es que el usuario pruebe con los 3 algoritmos para encontrar el más adecuado. Más información sobre los algoritmos: https://parzibyte.me/blog/2024/01/17/metodos-imprimir-imagenes-impresoras-termicas/ . El parámetro sobre el dithering indica si se debe aplicar el algoritmo Floyd-Steinberg-Dithering a la imagen antes de ser impresa. Es recomendado aplicarlo en fotografías, así se mantiene la iluminación y los detalles incluso al ser convertida a blanco y negro. Más información sobre dithering: https://parzibyte.me/blog/2024/07/28/algoritmo-floyd-steinberg-dithering-golang/
ImprimirImagenEnBase64: Convierte el texto en base64 a una imagen. La imagen codificada en base64 puede ser JPG o PNG y puede tener o no tener el "base64,". La imagen será convertida a blanco y negro. Si el ancho de la imagen es mayor que el máximo ancho especificado, la imagen será redimensionada para que coincida. El algoritmo se refiere al algoritmo utilizado al imprimir la imagen, que puede ser 0 para usar el método Raster Bit Image, 1 para Bit Image Column Format y 2 para NV Graphics. Las impresoras más recientes soportan NV Graphics, las antiguas soportan Raster Bit Image e Image Column Format. Lo recomendable es que el usuario pruebe con los 3 algoritmos para encontrar el más adecuado. Más información sobre los algoritmos: https://parzibyte.me/blog/2024/01/17/metodos-imprimir-imagenes-impresoras-termicas/ . El parámetro sobre el dithering indica si se debe aplicar el algoritmo Floyd-Steinberg-Dithering a la imagen antes de ser impresa. Es recomendado aplicarlo en fotografías, así se mantiene la iluminación y los detalles incluso al ser convertida a blanco y negro. Más información sobre dithering: https://parzibyte.me/blog/2024/07/28/algoritmo-floyd-steinberg-dithering-golang/
ImprimirCodigoDeBarrasCode39: Imprime un código de barras en formato Code39. El algoritmo se refiere al algoritmo utilizado al imprimir la imagen, que puede ser 0 para usar el método Raster Bit Image, 1 para Bit Image Column Format y 2 para NV Graphics. Las impresoras más recientes soportan NV Graphics, las antiguas soportan Raster Bit Image e Image Column Format. Más información sobre los algoritmos: https://parzibyte.me/blog/2024/01/17/metodos-imprimir-imagenes-impresoras-termicas/ Los demás parámetros son propios del algoritmo de generación del código
ImprimirCodigoDeBarrasCode93: Imprime un código de barras en formato Code93. El algoritmo se refiere al algoritmo utilizado al imprimir la imagen, que puede ser 0 para usar el método Raster Bit Image, 1 para Bit Image Column Format y 2 para NV Graphics. Las impresoras más recientes soportan NV Graphics, las antiguas soportan Raster Bit Image e Image Column Format. Más información sobre los algoritmos: https://parzibyte.me/blog/2024/01/17/metodos-imprimir-imagenes-impresoras-termicas/ Los demás parámetros son propios del algoritmo de generación del código
ImprimirCodigoDeBarrasPdf417: Imprime un código de barras en formato PDF417. El algoritmo se refiere al algoritmo utilizado al imprimir la imagen, que puede ser 0 para usar el método Raster Bit Image, 1 para Bit Image Column Format y 2 para NV Graphics. Las impresoras más recientes soportan NV Graphics, las antiguas soportan Raster Bit Image e Image Column Format. Más información sobre los algoritmos: https://parzibyte.me/blog/2024/01/17/metodos-imprimir-imagenes-impresoras-termicas/ Los demás parámetros son propios del algoritmo de generación del código Nota: el nivel de seguridad tiene que ver con el propio algoritmo del código de barras, no con el plugin. Debe ser entre 0 y 8
ImprimirCodigoDeBarrasUpcA: Imprime un código de barras en formato UpcA. El algoritmo se refiere al algoritmo utilizado al imprimir la imagen, que puede ser 0 para usar el método Raster Bit Image, 1 para Bit Image Column Format y 2 para NV Graphics. Las impresoras más recientes soportan NV Graphics, las antiguas soportan Raster Bit Image e Image Column Format. Más información sobre los algoritmos: https://parzibyte.me/blog/2024/01/17/metodos-imprimir-imagenes-impresoras-termicas/ Los demás parámetros son propios del algoritmo de generación del código
ImprimirCodigoDeBarrasUpcE: Imprime un código de barras en formato UPC E. El algoritmo se refiere al algoritmo utilizado al imprimir la imagen, que puede ser 0 para usar el método Raster Bit Image, 1 para Bit Image Column Format y 2 para NV Graphics. Las impresoras más recientes soportan NV Graphics, las antiguas soportan Raster Bit Image e Image Column Format. Más información sobre los algoritmos: https://parzibyte.me/blog/2024/01/17/metodos-imprimir-imagenes-impresoras-termicas/ Los demás parámetros son propios del algoritmo de generación del código
ImprimirCodigoDeBarrasEan: Imprime un código de barras en formato Ean. El algoritmo se refiere al algoritmo utilizado al imprimir la imagen, que puede ser 0 para usar el método Raster Bit Image, 1 para Bit Image Column Format y 2 para NV Graphics. Las impresoras más recientes soportan NV Graphics, las antiguas soportan Raster Bit Image e Image Column Format. Más información sobre los algoritmos: https://parzibyte.me/blog/2024/01/17/metodos-imprimir-imagenes-impresoras-termicas/ Los demás parámetros son propios del algoritmo de generación del código
ImprimirCodigoDeBarrasEan8: Imprime un código de barras en formato Ean8. El algoritmo se refiere al algoritmo utilizado al imprimir la imagen, que puede ser 0 para usar el método Raster Bit Image, 1 para Bit Image Column Format y 2 para NV Graphics. Las impresoras más recientes soportan NV Graphics, las antiguas soportan Raster Bit Image e Image Column Format. Más información sobre los algoritmos: https://parzibyte.me/blog/2024/01/17/metodos-imprimir-imagenes-impresoras-termicas/ Los demás parámetros son propios del algoritmo de generación del código
ImprimirCodigoDeBarrasTwoOfFiveITF: Imprime un código de barras en formato Two of five ITF (Entrelazados 2 de 5). El algoritmo se refiere al algoritmo utilizado al imprimir la imagen, que puede ser 0 para usar el método Raster Bit Image, 1 para Bit Image Column Format y 2 para NV Graphics. Las impresoras más recientes soportan NV Graphics, las antiguas soportan Raster Bit Image e Image Column Format. Más información sobre los algoritmos: https://parzibyte.me/blog/2024/01/17/metodos-imprimir-imagenes-impresoras-termicas/ Los demás parámetros son propios del algoritmo de generación del código Nota: el parámetro "intercalado" es propio del algoritmo del código de barras, no del plugin
ImprimirCodigoDeBarrasCodabar: Imprime un código de barras en formato Codabar. El algoritmo se refiere al algoritmo utilizado al imprimir la imagen, que puede ser 0 para usar el método Raster Bit Image, 1 para Bit Image Column Format y 2 para NV Graphics. Las impresoras más recientes soportan NV Graphics, las antiguas soportan Raster Bit Image e Image Column Format. Más información sobre los algoritmos: https://parzibyte.me/blog/2024/01/17/metodos-imprimir-imagenes-impresoras-termicas/ Los demás parámetros son propios del algoritmo de generación del código
ImprimirCodigoDeBarrasCode128: Imprime un código de barras en formato Code128. El algoritmo se refiere al algoritmo utilizado al imprimir la imagen, que puede ser 0 para usar el método Raster Bit Image, 1 para Bit Image Column Format y 2 para NV Graphics. Las impresoras más recientes soportan NV Graphics, las antiguas soportan Raster Bit Image e Image Column Format. Más información sobre los algoritmos: https://parzibyte.me/blog/2024/01/17/metodos-imprimir-imagenes-impresoras-termicas/ Los demás parámetros son propios del algoritmo de generación del código
ImprimirCodigoQr: Imprime un código QR. El algoritmo se refiere al algoritmo utilizado al imprimir la imagen, que puede ser 0 para usar el método Raster Bit Image, 1 para Bit Image Column Format y 2 para NV Graphics. Las impresoras más recientes soportan NV Graphics, las antiguas soportan Raster Bit Image e Image Column Format. Más información sobre los algoritmos: https://parzibyte.me/blog/2024/01/17/metodos-imprimir-imagenes-impresoras-termicas/ Los demás parámetros son propios del algoritmo de generación del código Nota: el nivel de recuperación es propio del algoritmo generador del QR, no del plugin. Puede ser 0 (low), 1 (medium), 2(high) y 3 (highest). Se recomienda medium
Beep: Emite un sonido usando el buzzer (zumbador) de la impresora térmica. Hace un pitido. Mira también BeepAndSound
BeepAndAlarm: Emite un sonido usando el buzzer (zumbador) de la impresora térmica (hace un pitido) y también enciende el LED integrado (alarma). Sirve para emitir un sonido y notificar algo. En mi impresora, Beep no respeta la duración del sonido, pero BeepAndAlarm sí lo hace. Con esta operación puedes únicamente emitir un sonido, encender el LED silenciosamente, ambos o ninguno
Resolución de problemas
- Mi impresora no aparece en la lista: No la has instalado o compartido correctamente. Sigue la guía de nuevo.
- Mi impresora aparece en la lista, pero no imprime: Has instalado tu impresora pero no la has compartido. Sigue la guía de nuevo.
- Dice que el plugin no está corriendo: Asegúrate de darle al plugin los permisos de firewall y del sistema operativo para ejecutarse.