doc: add api

Author: leonardocavagnis

libraries/Arduino_H7_Video/docs/README.md

@@ -2,7 +2,7 @@
 
 [![License](https://img.shields.io/badge/License-LGPLv3-blue.svg)]()
 
-The Arduino H7 Video library is a C++ library designed to handle the video output of Arduino boards based on the STM32H7 microcontroller with DSI (Display Serial Interface) video interface. DSI stands for Display Serial Interface, which is a serial interface used to connect a display to the microcontroller.
+The Arduino H7 Video library is a C++ library designed to handle the video output of Arduino boards based on the STM32H7 microcontroller with DSI video interface. DSI stands for Display Serial Interface, which is a serial interface used to connect a display to the microcontroller.
 
 This library is based on the graphics primitives of the [ArduinoGraphics](https://github.com/arduino-libraries/ArduinoGraphics) library and currently supports the Arduino Portenta H7 and Arduino Giga R1 WiFi boards. The library offers two modes of operation for the Portenta H7 board: you can connect the display to the video output via a USB Type-C connection or use the Giga Display Shield. For the Giga R1 board, only the Giga Display Shield is supported.
 

libraries/Arduino_H7_Video/docs/api.md

@@ -0,0 +1,108 @@
+# Summary
+
+ Members                        | Descriptions                                
+--------------------------------|---------------------------------------------
+`class` [`Arduino_H7_Video`](#class-arduino_h7_video) | The main class for managing the video controller and the display.
+
+# class [`Arduino_H7_Video`](#class-arduino_h7_video)
+The main class for managing the video controller and the display.
+
+## Summary
+
+| Members                                                     | Descriptions                                |
+|-------------------------------------------------------------|---------------------------------------------|
+| `public ` [`Arduino_H7_Video`](#public-arduino_h7_videoint-width-int-height-h7displayshield-shield) | Construct a new Arduino_H7_Video object with the specified width, height, and display shield. |
+| `public int` [`begin`](#public-int-begin) | Initialize the video controller and display. |
+| `public void` [`end`](#public-void-end) | De-initialize the video controller and display. |
+| `public int` [`width`](#public-int-width) | Get the width of the display. |
+| `public int` [`height`](#public-int-height) | Get the height of the display. |
+| `public void` [`clear`](#public-void-clear) | Clear the display. |
+| `public void` [`beginDraw`](#public-void-begindraw) | Begin drawing operations on the display. |
+| `public void` [`endDraw`](#public-void-enddraw) | End drawing operations on the display. |
+| `public void` [`set`](#public-void-setint-x-int-y-uint8_t-r-uint8_t-g-uint8_t-b) | Set the color of the pixel at the specified coordinates. |
+
+
+> *Note: For all drawing functions, refer to the documentation of the [`ArduinoGraphics`](https://reference.arduino.cc/reference/en/libraries/arduinographics/) library.*
+
+## Members
+
+### `public ` [`Arduino_H7_Video`](#)`(int width, int height, H7DisplayShield &shield)`
+
+Construct a new Arduino_H7_Video object with the specified width, height, and display shield.
+
+#### Parameters
+- `width`: The width of the display.
+- `height`: The height of the display.
+- `shield`: The display shield used.
+    - *GigaDisplayShield*: Giga Display Shield
+    - *USBCVideo*: Display attach to the USB-C port
+
+---
+
+### `public int` [`begin`](#)`()`
+
+Initialize the video controller and display.
+
+#### Returns
+`int`: 0 if initialization is successful, otherwise an error code.
+
+---
+
+### `public void` [`end`](#)`()`
+
+De-initialize the video controller and display.
+
+---
+
+### `public int` [`width`](#)`()`
+
+Get the width of the display.
+
+#### Returns
+`int`: The width of the display.
+
+---
+
+### `public int` [`height`](#)`()`
+
+Get the height of the display.
+
+#### Returns
+`int`: The height of the display.
+
+---
+
+### `public void` [`clear`](#)`()`
+
+Clear the display.
+
+---
+
+### `public void` [`beginDraw`](#)`()`
+
+Begin drawing operations on the display.
+
+---
+
+### `public void` [`endDraw`](#)`()`
+
+End drawing operations on the display.
+
+---
+
+### `public void` [`set`](#)`(int x, int y, uint8_t r, uint8_t g, uint8_t b)`
+
+Set the color of the pixel at the specified coordinates.
+
+#### Parameters
+- `x`: The x-coordinate of the pixel.
+- `y`: The y-coordinate of the pixel.
+- `r`: The red component of the color.
+- `g`: The green component of the color.
+- `b`: The blue component of the color.
+
+---
+
+> *Note: For detailed information on drawing functions, please refer to the documentation of the [`ArduinoGraphics`](https://reference.arduino.cc/reference/en/libraries/arduinographics/) library.*
+
+

libraries/Arduino_H7_Video/examples/LVGLDemo/LVGLDemo.ino

@@ -14,15 +14,6 @@
 Arduino_H7_Video          Display(800, 480, GigaDisplayShield); /* Arduino_H7_Video Display(1024, 768, USBCVideo); */
 Arduino_GigaDisplayTouch  TouchDetector;
 
-void gigaTouchHandler(uint8_t contacts, GDTpoint_t* points) {
-  if (contacts > 0) {
-    Serial.print("Touch detected: ");
-    Serial.print(points[0].x);
-    Serial.print(",");
-    Serial.println(points[0].y);
-  }
-}
-
 /* Button click event callback */
 static void btn_event_cb(lv_event_t * e) {
   static uint32_t cnt = 1;
@@ -42,7 +33,6 @@ void setup() {
 
   Display.begin();
   TouchDetector.begin();
-  TouchDetector.onDetect(gigaTouchHandler);
 
   /* Create a container with grid 2x2 */
   static lv_coord_t col_dsc[] = {370, 370, LV_GRID_TEMPLATE_LAST};