Documentación del Editor πxelStudioCode:

¡Bienvenido a la guía esencial de πxelWallE! Aquí encontrarás todo lo que necesitas para dominar nuestro innovador editor y dar vida a tus visiones de pixel art. Hemos diseñado esta documentación para que sea tan intuitiva como nuestro editor, permitiéndote sumergirte de lleno en la creación sin complicaciones.

Desde cargar tus proyectos hasta exportar tus obras maestras y convertir imágenes en código, prepárate para una experiencia de creación de pixel art como ninguna otra.

Gestión de Archivos:

Tu progreso es invaluable. πxelWallE te ofrece herramientas claras y sencillas para cargar, guardar y organizar todos tus proyectos de pixel art.

Abrir Archivos Existentes: Retoma donde lo dejaste

Para continuar tu aventura creativa:

  • Dirígete al menú Files en la barra superior.
  • Selecciona Load.
  • Busca tu archivo .pw (el formato nativo de πxelWallE) y haz clic para abrirlo.

¡Tu proyecto estará listo para seguir siendo transformado!

Crear Nuevos Archivos:

Para empezar de cero y dar rienda suelta a nuevas ideas:

  • En la consola de comandos escribe new file.

Un editor fresco y vacío te espera, listo para tus primeras líneas de código pixel.

Guardar Archivos:

Guarda tu obra con frecuencia para asegurar cada avance:

  • Guardar (Ctrl + S / Cmd + S): Actualiza tu archivo existente con los últimos cambios.
  • En Files, Load Guarda tu proyecto con un nuevo nombre o en una ubicación diferente, ideal para versiones o copias de seguridad.

Formatos de Archivo Soportados: .pw

πxelWallE utiliza el formato .pw para almacenar el código de tu pixel art. ¡Asegúrate de usarlo para guardar y cargar tus creaciones!

Importar Fotos a Código: Transforma Imágenes en Creación Programable

¡Una de las características más mágicas de πxelWallE! Convierte cualquier imagen (PNG, JPG) en código pixelWallE. Es la forma perfecta de explorar la representación del pixel art programable o de empezar un nuevo proyecto a partir de una base visual existente. Aunque su integración esta en desarrollo podrás utilizarla a través del script transformIMG.py que se encuentra junto al ejecutable

Cómo Funciona:

Esta herramienta analiza los píxeles de tu imagen, interpretando sus colores y posiciones para generar líneas de código que, al ejecutarse, recrearán esa imagen en el editor.

Pasos para la Conversión: De la Imagen al Código

  1. Ejecuta el script transformIMG.
  2. Copia la ruta de la imagen.
  3. Escribe el nombre de la carpeta donde guardarás el código.
  4. Presiona enter.

¡Observa cómo tu imagen se materializa en líneas de código listas para editar!

El Código Generado: Tu Nuevo Lienzo

Spawn(0,0)
Color("#FF0000")
DrawLine(0, 1,1);
DrawLine(1, 0,1);
# ... y así, pixel a pixel, tu imagen toma forma en código ...

Este código es tu punto de partida. Modifícalo, experimenta y hazlo tuyo.

Consideraciones para una Conversión Óptima

  • Las imágenes más simples o con menos colores suelen generar mejores resultados.
  • Imágenes muy grandes pueden generar mucho código; experimenta con el tamaño de salida.
  • El resultado es una base sólida, pero siempre puedes refinarlo manualmente.

Consejo Pro: Juega con los ajustes de tamaño y paleta para descubrir efectos visuales sorprendentes. ¡Imágenes con contornos definidos son tus mejores aliadas!

Exportar como Imagen:

Tu pixel art está listo para el mundo. Exporta tus creaciones a formatos de imagen estándar como PNG para compartirlas en redes, usarlas en tus proyectos o simplemente guardarlas como obras de arte digital.

Cómo Exportar tu Arte: De Código a Imagen Final

  1. Asegúrate de que la previsualización de tu pixel art es exactamente como la quieres.
  2. Dirígete al menú Files .
  3. Selecciona Save Picture.
  4. Configura las opciones de exportación:
    • **Formato de Imagen:** PNG es ideal para pixel art por su calidad sin pérdida y soporte de transparencia.
    • **Guardar en:** Elige la ubicación y el nombre de tu archivo.

¡Listo! Tu pixel art está ahora en formato de imagen, listo para brillar.

Consejo Pro: Para la máxima nitidez y detalle en pixel art, siempre exporta a PNG.

Consola Integrada:

La consola de πxelWallE es tu centro de mando. Úsala para ejecutar código, depurar errores al instante y ver la salida de tus programas, todo en un solo lugar.

Acceso a la Consola:

La consola siempre se encuentra a la vistra en la parte inferior del editor. Solo tienes que seleccionarla y empezar a escribir.

Ejecuta y Observa:

Presiona el botón "Ejecutar" o escribe en la consola run . Verás la salida de tu código y cualquier mensaje importante al instante, facilitando la depuración y el seguimiento.

Comandos Útiles:

  • run file tu_archivo.pxl: Ejecuta tu script de pixel art.
  • clear console: Limpia la consola para una vista fresca.
  • help: Muestra la información de todos los comandos de consola.
  • show commands: Muestra todos los comandos que puedes escribir en el código.

Recuerda: La sintaxis completa está en la propia Consola escribiendo el comando help.

Navegación Rápida:

Descubre los atajos visuales. La barra lateral de πxelWallE te da acceso instantáneo a las funciones más usadas, haciendo tu proceso creativo más ágil y sin interrupciones.

Conoce tus nuevos accesos directos:

  • Redimensionar el canvas: Treansforma el tamaño de tu canvas para más versatilidad.

  • Deshacer: Vuelve un paso atrás, ¡perfecto para experimentar sin miedo!

  • Rehacer: Recupera una acción deshecha.

  • Limpiar canvas: Limpia el canvas actual dándote un nuevo lienzo listo para experimentar.

  • Ejecutar Código: ¡El botón mágico! Ejecuta tu código y mira tu pixel art cobrar vida.

Consejo Pro: Familiarízate con estos botones. Son tus aliados para mantener un ritmo de trabajo fluido.

Depuración en Tiempo Real: Errores, Bajo Control

πxelWallE te asiste activamente en la corrección de errores. Detecta problemas mientras escribes, dándote retroalimentación inmediata para que tu código sea perfecto.

Cómo te Ayuda πxelWallE: Señales Claras

  • Subrayado Intuitivo: Partes del código con errores se resaltan (rojo para errores), guiándote al problema exacto.
  • Mensajes Detallados (Tooltips):Coloca el cursor sobre el subrayado para una explicación clara del problema.
  • Errores en consola: La consola muestra una lista de todos los errores y advertencias, permitiéndote navegar rápidamente a cada incidencia.

Tipos de Errores que Detectamos:

  • Errores de Lexer: Problemas de caracteres no válidos.
  • Errores de Sintaxis: Problemas con la estructura del lenguaje (ej. un paréntesis olvidado).
  • Errores Semánticos Básicos: Cuando el código no tiene sentido lógico (ej. un color no válido).

Interpretando los Mensajes: Tu Guía para Solucionar Problemas

Cada mensaje te dirá: el tipo de problema (Error o Advertencia), una descripción clara y la ubicación exacta (línea y columna).

Consejos para una Depuración Efectiva:

  • **Lee con Atención:** El mensaje de error es tu mejor pista.
  • **Empieza por el Principio:** Un error temprano puede causar muchos problemas posteriores.
  • **Revisa Alrededor:** A veces, el problema real está en una línea cercana.
  • **Consulta la Documentación:** Siempre ten a mano la Documentación del Lenguaje pixelWallE para verificar la sintaxis.

Consejo Pro: ¡Los errores son oportunidades de aprendizaje! πxelWallE los convierte en pasos para mejorar tu código.