.. _guia-primeros-pasos:

Primeros pasos
==============

Este capítulo muestra el flujo mínimo para dibujar algo en el panel.

1. **Crear la pantalla.** Se elige la orientación:

   .. code-block:: python

      from pantalla import Pantalla, NEGRO, BLANCO

      pan = Pantalla(orientacion=90)   # 250x128 apaisado
      # pan = Pantalla(orientacion=0)  # 128x250 retrato

2. **Limpiar el framebuffer.** Se recomienda empezar en blanco:

   .. code-block:: python

      pan.limpiar(BLANCO)

3. **Dibujar.** Hay cuatro primitivas básicas:

   .. code-block:: python

      pan.pixel(10, 10, NEGRO)
      pan.linea_h(10, 20, 50, NEGRO)
      pan.linea_v(30, 10, 60, NEGRO)
      pan.texto("Hola", x=10, y=40, color=NEGRO, tamaño=16)

4. **Volcar al panel.** Este paso es bloqueante y puede tardar
   varios segundos:

   .. code-block:: python

      pan.actualizar()

5. **(Opcional) Dormir el panel** para ahorrar energía:

   .. code-block:: python

      pan.dormir()

.. note::
   El framebuffer se mantiene en RAM entre refrescos. Podés seguir
   dibujando encima y volver a llamar a :meth:`pantalla.Pantalla.actualizar`
   cuando quieras, sin reinicializar el panel.