lvgl/README_pt_BR.md

LVGL - Biblioteca gráfica leve e versátil

O LVGL fornece tudo o que você precisa para criar uma GUI incorporada com elementos gráficos fáceis de usar, belos efeitos visuais e um baixo consumo de memória.

Site · Documentação · Fórum · Serviços · Exemplos interativos

English | 中文 | Português do Brasil

---

Tabela de conteúdo

• Visão Geral
• Iniciando
• Exemplos
• Serviços
• Contribuindo

Visão Geral

Recursos

• Poderosos widgets: botões, gráficos, listas, controles deslizantes (sliders), imagens, etc.
• Mecanismo gráfico avançado: animações, anti-aliasing, opacidade, rolagem suave, modos de mesclagem (blending modes), etc.
• Suporte à vários dispositivos de entrada: tela sensível ao toque, mouse, teclado, codificador, botões, etc.
• Suporte à vários monitores
• Pode ser usado com qualquer microcontrolador e display, independente do hardware
• Escalável para operar com pouca memória (64 kB Flash, 16 kB RAM)
• Suporte multilíngue com manipulação UTF-8, suporte ao alfabeto bidirecional, árabe e CJK (Chinês, Japonês e Coreano)
• Elementos gráficos totalmente personalizáveis por meio de CSS
• Layouts poderosos inspirados em CSS: Flexbox e Grid
• SO, memória externa e GPU são suportados, mas não obrigatórios. (suporte integrado para STM32 DMA2D, SWM341 DMA2D e NXP PXP e VGLite)
• Renderização suave mesmo com um buffer de quadro único (single frame buffer)
• Escrito em C e compatível com C++
• Uso do LittlevGL com Micropython simplificado com LVGL API in Micropython
• Simulador para desenvolver no PC sem hardware embutido
• Mais de 100 exemplos simples
• Documentação e referências de API online e em PDF

Requerimentos

Basicamente, todo controlador moderno (que é capaz de acionar um display) é adequado para executar LVGL. Os requisitos mínimos são:

Nome	Minímo	Recomendado
Arquitetura	Microcontrolador ou processador de 16, 32 ou 64 bits
Clock	> 16 MHz	> 48 MHz
Flash/ROM	> 64 kB	> 180 kB
RAM estática	> 16 kB	> 48 kB
Draw buffer	> 1 × hor. res. pixels	> tamanho da tela de 1/10
Compilador	Padrão C99 ou mais recente

Observe que o uso de memória pode variar dependendo da arquitetura, do compilador e das opções de compilação.

Plataformas suportadas

O LVGL é completamente independente de plataforma e pode ser usado com qualquer MCU que atenda aos requisitos. Apenas para citar algumas plataformas:

• NXP: Kinetis, LPC, iMX, iMX RT
• STM32F1, STM32F3, STM32F4, STM32F7, STM32L4, STM32L5, STM32H7
• Microchip dsPIC33, PIC24, PIC32MX, PIC32MZ
• Linux frame buffer (/dev/fb)
• Raspberry Pi
• Espressif ESP32
• Infineon Aurix
• Nordic NRF52 Bluetooth modules
• Quectel modems
• SYNWIT SWM341

LVGL também está disponível para:

• Arduino library
• PlatformIO package
• Zephyr library
• ESP32 component
• NXP MCUXpresso component
• NuttX library
• RT-Thread RTOS

Iniciando

Esta lista mostra a maneira recomendada de aprender sobre a biblioteca:

1. Confira as demos on-line para ver o LVGL em ação (3 minutos)
2. Leia a introdução da documentação (5 minutos)
3. Familiarize-se com o básico da Visão geral rápida (15 minutos)
4. Configure um simulador (10 minutos)
5. Experimente alguns Exemplos
6. Placa para porta LVGL. Veja o guia porting ou verifique o pronto para usar Projects
7. Leia a visão geral para entender melhor a biblioteca (2-3 horas)
8. Verifique a documentação dos widgets para ver seus recursos e como utilizá-los
9. Se você tiver dúvidas, acesse o fórum
10. Leia o guia de contribuição para ver como você pode ajudar a melhorar o LVGL (15 minutos)

Exemplos

Para mais exemplos, veja a pasta examples.

C

lv_obj_t * button = lv_btn_create(lv_scr_act());                             /* Adiciona um botão à tela atual */
lv_obj_set_pos(button, 10, 10);                                              /* Define uma posição ao botão na tela */
lv_obj_set_size(button, 100, 50);                                            /* Define o tamanho */
lv_obj_add_event_cb(button, button_event_callback, LV_EVENT_CLICKED, NULL);  /* Atribui um retorno de chamada (callback) */

lv_obj_t * label = lv_label_create(button);                                  /* Adiciona um rótulo (label) */
lv_label_set_text(label, "Clique aqui");                                     /* Define o texto do rótulo (label) */
lv_obj_center(label);                                                        /* Alinha o texto ao centro */
...

void button_event_callback(lv_event_t * e)
{
  printf("Clicado\n");
}

Micropython

Saiba mais em Micropython

def button_event_callback(event):
  print("Clicado")

# Cria um botão e um rótulo (label)
button = lv.btn(lv.scr_act())
button.set_pos(10, 10)
button.set_size(100, 50)
button.add_event_cb(button_event_callback, lv.EVENT.CLICKED, None)

label = lv.label(button)
label.set_text("Cliquq aqui")
label.center()

Serviços

O LVGL Kft foi estabelecido para fornecer uma base sólida para a biblioteca LVGL. Oferecemos vários tipos de serviços para ajudá-lo no desenvolvimento da interface do usuário:

• Design gráfico
• Implementação de IU
• Consultoria/Suporte

Para mais informações, consulte LVGL Serviços. Sinta-se à vontade para entrar em contato conosco se tiver alguma dúvida.

Contribuindo

O LVGL é um projeto aberto e sua contribuição é muito bem-vinda. Há muitas maneiras de contribuir, desde simplesmente falando sobre seu projeto, escrevendo exemplos, melhorando a documentação, corrigindo bugs até hospedar seu próprio projeto sob a organização LVGL.

Para obter uma descrição detalhada das oportunidades de contribuição, visite a seção de contribuição da documentação.