Tasmota/lib/libesp32_lvgl/lvgl/README_pt_BR.md

8.9 KiB
Raw Blame History

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

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:

LVGL também está disponível para:

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.

Exemplo de botão LVGL com rótulo (label)

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.