UTFT

Biblioteca de pantallas TFT universal multiplataforma

Manual

http://www.RinkyDinkElectronics.com/ (C) 2016 Rinky-Dink Electronics, Henning Karlsen

Introducción:
Esta biblioteca fue originalmente la continuación de mis bibliotecas ITDB02_Graph, ITDB02_Graph16 y RGB_GLCD para Arduino y chipKit. A medida que la
cantidad de módulos de pantalla y controladores compatibles comenzó a aumentar, sentí que era hora de crear una biblioteca universal única, ya que será
mucho más fácil de mantener en el futuro.

La funcionalidad básica de esta biblioteca se basó originalmente en el código de demostración proporcionado por ITead studio (para los módulos ITDB02)
y NKC Electronics (para el módulo / escudo RGB GLCD).

Esta biblioteca admite una serie de pantallas gráficas de 8 bits, 16 bits y en serie, y funcionará con Arduino, placas chipKit y TI LaunchPads seleccionadas.
Para obtener una lista completa de pantallas probadas
módulos y controladores, consulte el documento UTFT_Supported_display_modules _ & _ controllers.pdf.

Siempre puede encontrar la última versión de la biblioteca en http://www.RinkyDinkElectronics.com/

Para obtener información sobre la versión, consulte version.txt.

IMPORTANTE:
Al utilizar módulos de pantalla de 8 y 16 bits, hay algunos requisitos que debe cumplir. Estos requisitos se pueden encontrar en el documento UTFT_Requirements.pdf.

No existen requisitos especiales cuando se utilizan pantallas en serie.

Dado que la mayoría de las personas tiene solo uno o posiblemente dos módulos de pantalla diferentes, se ha desperdiciado una gran cantidad de memoria para mantener la
compatibilidad con muchos chips de controlador innecesarios.
A partir de la v1.1, ahora tiene la opción de eliminar fácilmente este código innecesario de la biblioteca. Al deshabilitar los controladores que no necesita,
puede reducir la huella de memoria de la biblioteca en varios Kb. Para obtener más información, consulte memorysaver.h.

Los controladores TFT utilizados solo por módulos de pantalla y escudos que han sido retirados por sus proveedores están deshabilitados a partir de la versión
2.82 de forma predeterminada.

Si está utilizando el "AquaLEDSource All in One Super Screw Shield" en un chipKit Max32, lea el comentario en hardware / pic32 /
HW_PIC32_defines.h

Si está utilizando el "CTE TFT LCD / SD Shield para Arduino Due" o la “Protector de pantalla ElecHouse TFT LCD para Arduino DUE / Taijiuino”, por
favor lea el comentario en hardware / arm / HW_ARM_defines.h

Los protectores de pantalla de 8 bits diseñados para usar en Arduino Uno (y placas de tamaño similar) ahora se pueden usar en Arduino Megas. Por favor
lea el comentario en hardware / avr / HW_AVR_defines.h

Algunos de los módulos de pantalla más grandes (4,3 ”+) no se han probado en todas las placas de desarrollo compatibles debido al alto requisito de
corriente para la retroiluminación LED.

Esta biblioteca tiene una licencia CC BY-NC-SA 3.0 ( Licencia Creative Commons Reconocimiento-No comercial-Compartir igual 3.0
(no exportado).

Para más información, ver: http://creativecommons.org/licenses/by-nc-sa/3.0/

Manual de la biblioteca: UTFT Página 1

LITERALES DEFINIDOS:
Alineación

Para usar con print (), printNumI () y printNumF ()

IZQUIERDA: 0
DERECHA: 9999
CENTRO: 9998

Orientación

Para usar con InitLCD ()

RETRATO: 0
PAISAJE: 1

Colores VGA

Colores predefinidos para usar con setColor () y setBackColor ()

VGA_BLACK VGA_SILVER VGA_GRAY VGA_WHITE

VGA_MAROON VGA_RED VGA_PURPLE VGA_FUCSIA
VGA_GREEN VGA_LIME VGA_OLIVE VGA_YELLOW
VGA_NAVY VGA_BLUE VGA_TEAL VGA_AQUA
VGA_TRANSPARENT (solo válido para setBackColor ())

Modelo de pantalla

Para usar con UTFT ()

Por favor mira UTFT_Supported_display_modules _ & _ controllers.pdf

FUENTES INCLUIDAS:
Fuente pequeña

Tamaño del personaje: 8x12 píxeles

Número de caracteres: 95

BigFont

Tamaño del personaje: 16x16 píxeles

Número de caracteres: 95

SevenSegNumFont

Tamaño del personaje: 32x50 píxeles

Número de caracteres: 10

Se pueden encontrar más fuentes en el " Recursos " Sección de http://www.RinkyDinkElectronics.com/.

También hay una herramienta para crear sus propias fuentes si no puede encontrar ninguna que se adapte a sus necesidades. Para aquellos que quieran
conocer las especificaciones de las matrices de fuentes, también hay una explicación de eso.

Manual de la biblioteca: UTFT Página 2

FUNCIONES:
UTFT (Modelo, RS, WR, CS, RST [, ALE]);

El constructor de la clase principal cuando se utilizan módulos de visualización de 8 bits o 16 bits.

Parámetros: Modelo: Consulte el documento separado para conocer los módulos de pantalla compatibles Pin para la selección de
RS: registro
WR: Pin para escribir
CS: Pin para selección de chip Pin para
RST: reinicio
<opcional>
CERVEZA INGLESA: Solo se utiliza para escudos de 16 bits enclavados Pin para señal Latch

Uso: UTFT myGLCD (ITDB32S, 19, 18, 17, 16); // Iniciar una instancia de la clase UTFT

UTFT (modelo, SDA, SCL, CS, RST [, RS]);

El constructor de la clase principal cuando se utilizan módulos de visualización en serie.

Parámetros: Modelo: Consulte el documento separado para conocer los módulos de pantalla compatibles Pin para datos en serie
SDA:
SCL: Pin para reloj serial Pin para chip
CS: Seleccionar pin para reinicio
RST:
RS: <opcional> Solo se usa para módulos seriales de 5 pines Pin para selección de
registro

Uso: UTFT myGLCD (ITDB18SP, 11,10,9,12,8); // Iniciar una instancia de la clase UTFT

InitLCD ([orientación]);

Inicialice la pantalla LCD y configure la orientación de la pantalla.

Parámetros: Orientación: < opcional>

RETRATO
PAISAJE ( defecto)
Uso: myGLCD.initLCD (); // Inicializar la pantalla
Notas: Esto restablecerá el color a blanco con fondo negro. La fuente seleccionada se restablecerá a ninguna.

getDisplayXSize ();

Obtenga el ancho de la pantalla en la orientación actual.

Parámetros: Ninguna

Devoluciones: Ancho de la pantalla en la orientación actual en píxeles Xsize = myGLCD.getDisplayXSize (); //

Uso: Obtener el ancho

getDisplayYSize ();

Obtenga la altura de la pantalla en la orientación actual.

Parámetros: Ninguna

Devoluciones: Altura de la pantalla en la orientación actual en píxeles Ysize = myGLCD.getDisplayYSize (); // Obtener
Uso: la altura

Manual de la biblioteca: UTFT Página 3

 lcdOff ();

Apague la pantalla LCD. No se ejecutarán comandos hasta que lcdOn (); se ha enviado.

Parámetros: Ninguna

Uso: myGLCD.lcdOff (); // Apaga la pantalla lcd

Notas: Actualmente, esta función solo se admite en pantallas PCF8833 y basadas en CPLD.
Las pantallas basadas en CPLD solo apagarán la luz de fondo. Aceptará más comandos / escrituras.

lcdOn ();

Encienda la pantalla LCD después de emitir un comando lcdOff () -.

Parámetros: Ninguna

Uso: myGLCD.lcdOn (); // Enciende la pantalla lcd

Notas: Actualmente, esta función solo se admite en pantallas PCF8833 y basadas en CPLD. Las pantallas basadas en CPLD solo encenderán la luz
de fondo.

setContrast (c);

Establece el contraste de la pantalla.

Parámetros: c: nivel de contraste (0-64)

Uso: myGLCD.setContrast (64); // Establecer contraste en completo (predeterminado)
Notas: Actualmente, esta función solo se admite en pantallas basadas en PCF8833

setBrightness (br);

Configure el brillo de la luz de fondo de la pantalla.

Parámetros: br: Nivel de brillo (0-16)

Uso: myGLCD.setBrightness (16); // Establecer el brillo al máximo (predeterminado) Esta función actualmente solo es
Notas: compatible con pantallas basadas en CPLD

setDisplayPage (pg);

Establezca qué página de memoria mostrar.

Parámetros: pg: Página (0-7) (0 es el predeterminado)

Uso: myGLCD.setDisplayPage (4); // Mostrar la página 4
Notas: Actualmente, esta función solo se admite en pantallas basadas en CPLD

setWritePage (pg);

Establezca qué página de memoria se utilizará para las escrituras de pantalla posteriores.

Parámetros: pg: Página (0-7) (0 es el predeterminado)

Uso: myGLCD.setWritePage (2); // Utilice la página 2 para escrituras posteriores
Notas: Actualmente, esta función solo se admite en pantallas basadas en CPLD

Manual de la biblioteca: UTFT Página 4

 clrScr ();

Limpia la pantalla. El color de fondo se establecerá en negro.

Parámetros: Ninguna

Uso: myGLCD.clrScr (); // Limpia la pantalla

fillScr (r, g, b);

Llena la pantalla con un color específico.

Parámetros: r: componente rojo de un valor RGB (0-255) g: componente verde de un valor

RGB (0-255) b: componente azul de un valor RGB (0-255)

Uso: myGLCD.fillScr (255,127,0); // Llena la pantalla de naranja

fillScr (color);

Llene la pantalla con un color RGB565 precalculado especificado.

Parámetros: color: valor de color RGB565

Uso: myGLCD.fillScr (VGA_RED); // Llena la pantalla de rojo

setColor (r, g, b);

Establezca el color que se utilizará para todos los comandos de dibujo *, relleno * e impresión.

Parámetros: r: componente rojo de un valor RGB (0-255) g: componente verde de un valor

RGB (0-255) b: componente azul de un valor RGB (0-255)

Uso: myGLCD.setColor (0,255,255); // Establecer el color a cian

setColor (color);

Configure el color RGB565 precalculado especificado para usar en todos los comandos de dibujo *, relleno * e impresión.

Parámetros: color: valor de color RGB565

Uso: myGLCD.setColor (VGA_AQUA); // Establecer el color a aqua

getColor ();

Obtenga el color seleccionado actualmente.

Parámetros: Ninguna

Devoluciones: Color seleccionado actualmente como valor RGB565 (palabra) Color = myGLCD.getColor ();
Uso: // Obtener el color actual

setBackColor (r, g, b);

Establezca el color de fondo que se utilizará para todos los comandos de impresión.

Parámetros: r: componente rojo de un valor RGB (0-255) g: componente verde de un valor

RGB (0-255) b: componente azul de un valor RGB (0-255)

Uso: myGLCD.setBackColor (255,255,255); // Establecer el color de fondo en blanco

setBackColor (color);

Establezca el color de fondo RGB565 precalculado especificado para usar con todos los comandos de impresión.

Parámetros: color: valor de color RGB565

Uso: myGLCD.setBackColor (VGA_LIME); // Establecer el color de fondo en lima

getBackColor ();

Obtiene el color de fondo seleccionado actualmente.

Parámetros: Ninguna

Devoluciones: Color de fondo seleccionado actualmente como valor RGB565 (palabra)

Uso: BackColor = myGLCD.getBackColor (); // Obtiene el color de fondo actual

Manual de la biblioteca: UTFT Página 5

 drawPixel (x, y);

Dibuja un solo píxel.

Parámetros: x: coordenada x del píxel y: coordenada y del píxel

Uso: myGLCD.drawPixel (119,159); // Dibuja un solo píxel

drawLine (x1, y1, x2, y2);

Dibuja una línea entre dos puntos.

Parámetros: x1: coordenada x del punto inicial y1: coordenada y del punto
inicial x2: coordenada x del punto final y2: coordenada y del
punto final

Uso: myGLCD.drawLine (0,0,239,319); // Dibuja una línea diagonal

drawRect (x1, y1, x2, y2);

Dibuja un rectángulo entre dos puntos.

Parámetros: x1: coordenada x de la esquina inicial y1: coordenada y de la

esquina inicial x2: coordenada x de la esquina final y2:
coordenada y de la esquina final

Uso: myGLCD.drawRect (119,159,239,319); // Dibuja un rectángulo

drawRoundRect (x1, y1, x2, y2);

Dibuja un rectángulo con esquinas ligeramente redondeadas entre dos puntos. El tamaño mínimo es de 5 píxeles en ambas direcciones. Si se solicita un tamaño más pequeño, no se dibujará el
rectángulo.

Parámetros: x1: coordenada x de la esquina inicial y1: coordenada y de la

esquina inicial x2: coordenada x de la esquina final y2:
coordenada y de la esquina final

Uso: myGLCD.drawRoundRect (0,0,119,159); // Dibuja un rectángulo redondeado

fillRect (x1, y1, x2, y2);

Dibuja un rectángulo relleno entre dos puntos.

Parámetros: x1: coordenada x de la esquina inicial y1: coordenada y de la

esquina inicial x2: coordenada x de la esquina final y2:
coordenada y de la esquina final

Uso: myGLCD.fillRect (119,0,239,159); // Dibuja un rectángulo relleno

fillRoundRect (x1, y1, x2, y2);

Dibuja un rectángulo relleno con esquinas ligeramente redondeadas entre dos puntos. El tamaño mínimo es de 5 píxeles en ambas direcciones. Si se solicita un tamaño más pequeño, no se dibujará el
rectángulo.

Parámetros: x1: coordenada x de la esquina inicial y1: coordenada y de la

esquina inicial x2: coordenada x de la esquina final y2:
coordenada y de la esquina final

Uso: myGLCD.fillRoundRect (0,159,119,319); // Dibuja un rectángulo redondeado y relleno

drawCircle (x, y, radio);

Dibuja un círculo con un radio específico.

Parámetros: X: coordenada x del centro del círculo coordenada y del centro del círculo
y:
radio: radio del círculo en píxeles
Uso: myGLCD.drawCircle (119,159,20); // Dibuja un círculo con un radio de 20 píxeles

fillCircle (x, y, radio);

Dibuja un círculo relleno con un radio específico.

Parámetros: X: coordenada x del centro del círculo coordenada y del centro del círculo
y:
radio: radio del círculo en píxeles
Uso: myGLCD.fillCircle (119,159,10); // Dibuja un círculo relleno con un radio de 10 píxeles

Manual de la biblioteca: UTFT Página 6

 print (st, x, y [, deg]);

Imprime una cadena en las coordenadas especificadas.

Puede usar los literales IZQUIERDA, CENTRO y DERECHA como la coordenada x para alinear la cadena en la pantalla.

Parámetros: S t: la cadena para imprimir

X: coordenada x de la esquina superior izquierda del primer carácter coordenada y de la esquina superior
y: izquierda del primer carácter
grados: < opcional>
Grados para rotar texto (0-359). El texto se rotará alrededor de la esquina superior izquierda.
Uso: myGL CD.print (“¡Hola, mundo!”, CENTRO, 0); // Imprimir "¡Hola, mundo!"
Notas: CENTAVOER y RIGHT no calcularán las coordenadas correctamente al rotar el texto. la cadena puede ser una matriz de caracteres o un objeto String
los

printNumI (num, x, y [, longitud [, relleno]]);

Imprime un número entero en las coordenadas especificadas.

Puede usar los literales IZQUIERDA, CENTRO y DERECHA como la coordenada x para alinear la cadena en la pantalla.

Parámetros: num: el valor para imprimir (-2,147,483,648 a 2,147,483,647) ENTEROS SOLAMENTE

X: coordenada x de la esquina superior izquierda del primer dígito / signo coordenada y de la esquina superior
y: izquierda del primer dígito / signo
longitud: < opcional>
número mínimo de dígitos / caracteres (incluido el signo) para mostrar
relleno: < opcional>
carácter de relleno que se utilizará para obtener la longitud mínima. El carácter se insertará delante del número, pero después del signo. El valor predeterminado es ''
(espacio).
Uso: myGLCD.printNumI (num, CENTER, 0); // Imprime el valor de "num"

printNumF (num, dec, x, y [, divisor [, longitud [, relleno]]]);

Imprime un número de punto flotante en las coordenadas especificadas.

Puede usar los literales IZQUIERDA, CENTRO y DERECHA como la coordenada x para alinear la cadena en la pantalla.
ADVERTENCIA: Los números de coma flotante no son exactos y pueden producir resultados extraños cuando se comparan. Úselo a su propia discreción.

Parámetros: num: el valor para imprimir ( Ver nota)

dic: dígitos en la parte fraccionaria (1-5) 0 no es compatible. Use printNumI () en su lugar.
X: coordenada x de la esquina superior izquierda del primer dígito / signo coordenada y de la esquina superior
y: izquierda del primer dígito / signo
divisor: < Opcional>
Carácter único para usar como punto decimal. El valor predeterminado es '.' número mínimo de dígitos / caracteres
longitud: <opcional>
(incluido el signo) para mostrar
relleno: <opcional>
carácter de relleno que se utilizará para obtener la longitud mínima. El carácter se insertará delante del número, pero después del signo. El valor predeterminado es ''
(espacio).
Uso: myGLCD.printNumF (núm, 3, CENTRO, 0); // Imprime el valor de "num" con 3 dígitos fraccionarios
Notas: El rango admitido depende de la cantidad de dígitos fraccionarios utilizados. El rango aproximado es +/- 2 * (10̂
(9-dec))

setFont (nombre de fuente);

Seleccione la fuente para usar con print (), printNumI () y printNumF ().

Parámetros: fontname: Nombre de la matriz que contiene la fuente que desea usar myGLCD.setFont (BigFont); // Seleccione la
Uso: fuente llamada BigFont
Notas: Debe declarar la matriz de fuentes como externa o incluirla en su boceto.

getFont ();

Obtén la fuente seleccionada actualmente.

Parámetros: Ninguna

Devoluciones: Fuente seleccionada actualmente

Uso: CurrentFont = myGLCD.getFont (); // Obtener la fuente actual

getFontXsize ();

Obtén el ancho de la fuente seleccionada actualmente.

Parámetros: Ninguna

Devoluciones: Ancho de la fuente actualmente seleccionada en píxeles Xsize = myGLCD.getFontXsize

Uso: (); // Obtener ancho de fuente

getFontYsize ();

Obtiene la altura de la fuente seleccionada actualmente.

Parámetros: Ninguna

Devoluciones: Altura de la fuente actualmente seleccionada en píxeles Ysize = myGLCD.getFontYsize ();

Uso: // Obtener altura de fuente

Manual de la biblioteca: UTFT Página 7

 drawBitmap (x, y, sx, sy, datos [, escala]);

Dibuja un mapa de bits en la pantalla.

Parámetros: X: coordenada x de la esquina superior izquierda del mapa de bits coordenada y de la esquina
y: superior izquierda del mapa de bits ancho del mapa de bits en píxeles
sx:
sy: altura del mapa de bits en píxeles
datos: matriz que contiene los datos del mapa de bits
escala: < opcional>
Factor de escala. Cada píxel del mapa de bits se dibujará como <escala> x <escala> píxeles en la pantalla. myGLCD.drawBitmap (0, 0, 32, 32, mapa de bits); // Dibuja
Uso: un mapa de bits de 32x32 píxeles
Notas: Puede utilizar la herramienta en línea " ImageConverter 565 "O" ImageConverter565.exe ” en la carpeta Herramientas para convertir imágenes en matrices compatibles. La
herramienta en línea se puede encontrar en mi sitio web. Requiere que tu # incluir <avr / pgmspace.h> cuando se utiliza un Arduino que no sea Arduino Due.

drawBitmap (x, y, sx, sy, datos, deg, rox, roy);

Dibuja un mapa de bits en la pantalla con rotación.

Parámetros: X: coordenada x de la esquina superior izquierda del mapa de bits coordenada y de la esquina
y: superior izquierda del mapa de bits ancho del mapa de bits en píxeles
sx:
sy: altura del mapa de bits en píxeles
datos: matriz que contiene el mapa de bits-datos grados: grados para
rotar el mapa de bits (0-359)
rox: coordenada x del píxel para usar como centro de rotación en relación con los mapas de bits esquina superior izquierda roy: coordenada y del píxel para usar como centro de
rotación en relación con la esquina superior izquierda de mapas de bits
Uso: myGLCD.drawBitmap (50, 50, 32, 32, mapa de bits, 45, 16, 16); // Dibuja un mapa de bits girado 45 grados alrededor de su centro

Notas: Puede utilizar la herramienta en línea " ImageConverter 565 "O" ImageConverter565.exe ” en la carpeta Herramientas para convertir imágenes en matrices compatibles. La
herramienta en línea se puede encontrar en mi sitio web. Requiere que tu # incluir <avr / pgmspace.h> cuando se utiliza un Arduino que no sea Arduino Due.

Manual de la biblioteca: UTFT Página 8