# Simulador de Maniobra Náutica y Ciaboga (PER)

Es un simulador náutico 2D interactivo desarrollado en **HTML5, CSS3 y JavaScript puro (Canvas API)**, diseñado como herramienta didáctica para comprender la física de gobierno de una embarcación de recreo con motor de eje y **hélice dextrógira**, de acuerdo con el temario oficial del **PER (Patrón de Embarcaciones Recreativas)**.


![](./simulador-per.png)

---

## Características Principales

* **Física Realista de Gobierno (Hélice Dextrógira):**
  * **Efecto de Ciaboga y Prop Walk:** Simula la caída natural de la popa a babor al dar marcha atrás a bajas velocidades (presión lateral de las palas).
  * **Efectividad del Timón según Arrancada:** La respuesta del giro depende de la velocidad del agua sobre la pala y del flujo de expulsión de la hélice.
  * **Inercia y Rozamiento:** El barco mantiene la arrancada perdiendo velocidad paulatinamente por la resistencia del agua.

* **Escenario de Prácticas:**
  * **Pantalán de Amarre:** Incluye un pantalán en la zona inferior con listones de madera y norays.
  * **Barcos Amarrados:** Múltiples embarcaciones estáticas amarradas en punta mediante cabos.
  * **Hueco Libre de Atraque:** Zona despejada reservada para practicar la maniobra de atracar y desatracar en espacios reducidos.

* **Interfaz y Controles HUD:**
  * **Panel Informativo (HUD):** Muestra en tiempo real el estado del motor (*AVANTE*, *ATRÁS*, *PARADO*), la inclinación del timón en grados (*BABOR*, *ESTRIBOR*, *A LA VÍA*), la velocidad en nudos y el rumbo sexagesimal (`0º-359º`).
  * **Doble Control:** Compatible con **flechas del teclado** y **botones táctiles/clic** para dispositivos móviles o tablets.
  * **Luces de Navegación y Pala:** Representación gráfica visual de las luces de costado (rojo babor / verde estribor) y la deflexión real de la pala del timón.

---

## Controles de Navegación

| Tecla / Botón | Acción |
| :--- | :--- |
| **Flecha Arriba (▲)** | Dar avante (aceleración hacia adelante) |
| **Flecha Abajo (▼)** | Dar atrás (aceleración hacia atrás y efecto dextrógiro) |
| **Flecha Izquierda (◄)** | Mover caña/timón a **Babor** |
| **Flecha Derecha (►)** | Mover caña/timón a **Estribor** |
| **Reiniciar Posición** | Restablece el barco al centro en posición inicial |

---

## Instalación y Uso

Este proyecto está construido en un **único archivo ejecutable sin dependencias externas**.

1. Descarga o guarda el código en un archivo llamado `simulador_per.html`.
2. Haz doble clic sobre el archivo `simulador_per.html` para abrirlo en cualquier navegador web moderno (Firefox, Chrome, Chromium, Edge, Safari).
3. No requiere servidor web ni conexión a Internet.

---

## Licencia y Términos de Uso

* **Autor:** Luis Gutiérrez López (*SoloConLinux*)
* **Licencia:** Este proyecto se distribuye bajo la licencia **Creative Commons Atribución 4.0 Internacional (CC BY 4.0)**.

### Requisitos de uso en sitios web de terceros:
Si deseas utilizar, alojar, modificar o integrar este simulador en tu sitio web o plataforma educativa, **es requisito obligatorio incluir la atribución visible de autoría** mencionando expresamente a **SoloConLinux** y enlazando al proyecto original:

> *Simulador desarrollado por **SoloConLinux** (Luis Gutiérrez López).*

**Condiciones:**
* No está permitido eliminar el pie de página (`footer`) ni los créditos incluidos en el código fuente.
* En caso de redistribución o inserción mediante `<iframe>`, se deberá añadir una mención textual clara con enlace activo hacia **SoloConLinux**.