.. _ejemplo-hola-mundo:

Ejemplo: "Hola Mundo!"
======================

Este ejemplo, tomado directamente del archivo :mod:`main`, muestra
cómo dibujar dos renglones de texto y una línea decorativa.

Código
------

.. literalinclude:: ../../../documentar/main.py
   :language: python
   :linenos:
   :caption: main.py

Explicación
-----------

1. Se importa :class:`pantalla.Pantalla` y las constantes
   :data:`pantalla.NEGRO` y :data:`pantalla.BLANCO`.
2. Se instancia la pantalla en orientación apaisado
   (``orientacion=90`` → 250×128 lógicos).
3. Se limpia el framebuffer con :meth:`pantalla.Pantalla.limpiar`.
4. Se dibuja el texto con :meth:`pantalla.Pantalla.texto`, usando la
   fuente 12×16 para ``Hola`` y la 8×8 para ``Mundo!``.
5. Se traza una línea horizontal decorativa con
   :meth:`pantalla.Pantalla.linea_h`.
6. Se vuelca todo al panel con :meth:`pantalla.Pantalla.actualizar`.

Resultado esperado
------------------

.. code-block:: text

   ┌───────────────────────────────┐
   │  Hola                         │
   │  ───────────                  │
   │  Mundo!                       │
   └───────────────────────────────┘

.. note::
   El refresco completo puede tardar varios segundos. Es normal que el
   REPL quede bloqueado durante :meth:`pantalla.Pantalla.actualizar`.