mirror of https://git.mirrors.martin98.com/https://github.com/luc-github/ESP3D.git synced 2025-08-05 09:00:46 +08:00

Luc 39e06975f2 Update from refactoring branch

### Maintenance page
* Add add tab color for mobile view
* Add spellcheck off / autocorect off in input
* Add disconnect button when authenticate enabled
* Add Invalid user or password message when authentication failed

### Board support
* Add ESP32 S2 support
* Add ESP32 S3 support
* Add ESP32 C3 support

### ESP commands
* Add command 701 to control GCODE streaming
* Remove command 901 as duplicate
* Update command 420 to add more details
* Use text as default output
* All json on all commands for formated output

### Core
* Add benchmak function to check transfer speed (for test only-not production)
* Merge code for ESP3DLib support
* Add better printer display support (M117 / Serial TFT)
* Use ESP32 analogWrite instead of emulated one

### Modules
* Display
	* Refactor code
	* Remove SPI ILI 9341 / 9488 support as not suitable
      * Add ST7789 support (135x240 / 240x240)
* Filesystem
	* Bug fixes due to esp core updates
	* Better SD sharing mecanism
      * Better global FS management
* FTP
	* Add SD sharing support
	* Better global FS management
* GCODE Host
	* Add basic support for macro files
      * Add ESP command support
      * Use not blocking method to stream commands / handle response
* Notifications
	* Add IFTTT notification service
	* Add WebUI notification
	* Add ESP3D display notification
* WebDav
	* Add SD sharing support
	* Add bug fix from https://github.com/d-a-v/ESPWebDAV
	* Better global FS management
* Websocket
	* Add function to handle zombies connections
* WiFi
	* Fix connection to AP sometime fail
	* Fix low signal not diplayed in ESP420 even connected
	* Add AP Setup mode

### Libraries
* Update SDFat-2.0.6 to 2.1.2
* Update ESP32SSDP 1.1.1 to 1.2.0
* Update TFT_eSPI-1.4.11 to 2.4.61
* Update arduinoWebSockets-2.3.5 to 2.3.6
* Update esp8266-oled-ssd1306-4.0.0 to 4.3.0
* Remove lvgl support

### Tools
* Add I2C scanner script
* Add python script to simulate/stress printer serial communication

### PlatformIO
 * Use latest 4.4.0 Espressif32 release (ESP32-arduino core 2.0.3)
 * Add fix for Flash more than 4MB
 * Add Esp32 S2/S3/C3 env
 * Add ESP32-ST7789 / esp32-TTGO_T_Display env

2022-06-01 14:56:57 +08:00

3.4 KiB

Raw Blame History

.. include:: /header.rst 
:github_url: |github_link_base|/widgets/extra/calendar.md

Calendar (lv_calendar)

Overview

The Calendar object is a classic calendar which can:

show the days of any month in a 7x7 matrix
Show the name of the days
highlight the current day (today)
highlight any user-defined dates

The Calendar is added to the default group (if it is set). Calendar is an editable object which allow selecting and clicking the dates with encoder navigation too.

To make the Calendar flexible, by default it doesn't show the current year or month. Instead, there are optional "headers" that can be attached to the calendar.

Parts and Styles

The calendar object uses the Button matrix object under the hood to arrange the days into a matrix.

LV_PART_MAIN The background of the calendar. Uses all the background related style properties.
LV_PART_ITEMS Refers to the dates and day names. Button matrix control flags are set to differentiate the buttons and a custom drawer event is added modify the properties of the buttons as follows:
- day names have no border, no background and drawn with a gray color
- days of the previous and next month have LV_BTNMATRIX_CTRL_DISABLED flag
- today has a thicker border with the theme's primary color
- highlighted days have some opacity with the theme's primary color.

Usage

Some functions use the lv_calendar_date_t type which is a structure with year, month and day fields.

Current date

To set the current date (today), use the lv_calendar_set_today_date(calendar, year, month, day) function. month needs to be in 1..12 range and day in 1..31 range.

Shown date

To set the shown date, use lv_calendar_set_shown_date(calendar, year, month);

Highlighted days

The list of highlighted dates should be stored in a lv_calendar_date_t array loaded by lv_calendar_set_highlighted_dates(calendar, highlighted_dates, date_num). Only the array's pointer will be saved so the array should be a static or global variable.

Name of the days

The name of the days can be adjusted with lv_calendar_set_day_names(calendar, day_names) where day_names looks like const char * day_names[7] = {"Su", "Mo", ...}; Only the pointer of the day names is saved so the elements should be static, global or constant variables.

Events

LV_EVENT_VALUE_CHANGED Sent if a date is clicked. lv_calendar_get_pressed_date(calendar, &date) set date to the date currently being pressed. Returns LV_RES_OK if there is a valid pressed date, else LV_RES_INV.

Learn more about Events.

Keys

LV_KEY_RIGHT/UP/LEFT/RIGHT To navigate among the buttons to dates
LV_KEY_ENTER To press/release the selected date

Learn more about Keys.

Headers

From v8.1 the header is added directly into the Calendar widget and the API of the headers has been changed.

Arrow buttons

lv_calendar_header_arrow_create(calendar) creates a header that contains a left and right arrow on the sides and a text with the current year and month between them.

Drop-down

lv_calendar_header_dropdown_create(calendar) creates a header that contains 2 drop-drown lists: one for the year and another for the month.

Example


.. include:: ../../../examples/widgets/calendar/index.rst

API


.. doxygenfile:: lv_calendar.h
  :project: lvgl

3.4 KiB Raw Blame History