Pipeline de Producción p5.js
Cuándo usar
Usar cuando los usuarios soliciten: bocetos p5.js, coding creativo, arte generativo, visualizaciones interactivas, animaciones en canvas, arte visual basado en navegador, visualización de datos, efectos de shaders, o cualquier proyecto p5.js.
Qué incluye
Pipeline de producción para arte visual interactivo y generativo usando p5.js. Crea bocetos basados en navegador, arte generativo, visualizaciones de datos, experiencias interactivas, escenas 3D, visuales reactivas al audio y gráficos en movimiento — exportados como HTML, PNG, GIF, MP4 o SVG. Cubre: renderizado 2D/3D, sistemas de ruido y partículas, campos de flujo, shaders (GLSL), manipulación de píxeles, tipografía cinética, escenas WebGL, análisis de audio, interacción con ratón/teclado y exportación de alta resolución sin interfaz gráfica.
Estándar Creativo
Esto es arte visual renderizado en el navegador. El canvas es el medio; el algoritmo es el pincel.
Antes de escribir una sola línea de código, articula el concepto creativo. ¿Qué comunica esta pieza? ¿Qué hace que el espectador deje de hacer scroll? ¿Qué la diferencia de un ejemplo de tutorial de código? El prompt del usuario es un punto de partida — interprétalo con ambición creativa.
La excelencia desde el primer render no es negociable. El resultado debe ser visualmente impactante en la primera carga. Si parece un ejercicio de tutorial de p5.js, una configuración por defecto, o "código creativo generado por IA", está mal. Vuelve a pensarlo antes de enviarlo.
Ve más allá del vocabulario de referencia. Las funciones de ruido, sistemas de partículas, paletas de color y efectos de shaders en las referencias son un vocabulario inicial. Para cada proyecto, combina, superpón e inventa. El catálogo es una paleta de pinturas — tú escribes la pintura.
Sé proactivamente creativo. Si el usuario pide "un sistema de partículas", entrega un sistema de partículas con comportamiento de flocking emergente, ecos fantasma con estela, niebla de profundidad con cambio de paleta y un campo de ruido de fondo que respira. Incluye al menos un detalle visual que el usuario no pidió pero apreciará.
Denso, en capas, meditado. Cada fotograma debe recompensar la visualización. Nunca fondos blancos planos. Siempre jerarquía compositiva. Siempre color intencional. Siempre microdetalles que solo aparecen al inspeccionar de cerca.
Estética cohesiva sobre cantidad de características. Todos los elementos deben servir a un lenguaje visual unificado — temperatura de color compartida, vocabulario de peso de trazo consistente, velocidades de movimiento armoniosas. Un boceto con diez efectos no relacionados es peor que uno con tres que pertenecen juntos.
Modos
| Modo | Entrada | Salida | Referencia |
|---|---|---|---|
| Arte generativo | Semilla / parámetros | Composición visual procedural (estática o animada) | references/visual-effects.md |
| Visualización de datos | Conjunto de datos / API | Tableros interactivos, gráficos, visualizaciones de datos personalizadas | references/interaction.md |
| Experiencia interactiva | Ninguna (el usuario impulsa) | Boceto impulsado por ratón/teclado/táctil | references/interaction.md |
| Animación / motion graphics | Línea de tiempo / storyboard | Secuencias temporizadas, tipografía cinética, transiciones | references/animation.md |
| Escena 3D | Descripción del concepto | Geometría WebGL, iluminación, cámara, materiales | references/webgl-and-3d.md |
| Procesamiento de imágenes | Archivo(s) de imagen | Manipulación de píxeles, filtros, mosaico, puntillismo | references/visual-effects.md § Manipulación de píxeles |
| Reactivo al audio | Archivo de audio / micrófono | Visuales generativos impulsados por sonido | references/interaction.md § Entrada de audio |
Stack
Un único archivo HTML autocontenido por proyecto. Sin paso de compilación.
| Capa | Herramienta | Propósito |
|---|---|---|
| Núcleo | p5.js 1.11.3 (CDN) | Renderizado de canvas, matemáticas, transformaciones, manejo de eventos |
| 3D | p5.js modo WebGL | Geometría 3D, cámara, iluminación, shaders GLSL |
| Audio | p5.sound.js (CDN) | Análisis FFT, amplitud, entrada de micrófono, osciladores |
| Exportación | saveCanvas() / saveGif() / saveFrames() incorporados | Salida PNG, GIF, secuencia de fotogramas |
| Captura | CCapture.js (opcional) | Captura de video con velocidad de fotogramas determinista (WebM, GIF) |
| Sin interfaz | Puppeteer + Node.js (opcional) | Renderizado automatizado de alta resolución, MP4 mediante ffmpeg |
| SVG | p5.js-svg 1.6.0 (opcional) | Salida vectorial para impresión — requiere p5.js 1.x |
| Medios naturales | p5.brush (opcional) | Acuarela, carboncillo, bolígrafo — requiere p5.js 2.x + WEBGL |
| Textura | p5.grain (opcional) | Granulado de película, superposiciones de textura |
| Fuentes | Google Fonts / loadFont() | Tipografía personalizada mediante OTF/TTF/WOFF2 |
Nota de Versión
p5.js 1.x (1.11.3) es el predeterminado — estable, bien documentado, la compatibilidad de librerías más amplia. Úsalo a menos que un proyecto requiera características de 2.x.
p5.js 2.x (2.2+) añade: async setup() reemplazando preload(), modos de color OKLCH/OKLAB, splineVertex(), API .modify() de shaders, fuentes variables, textToContours(), eventos de puntero. Requerido para p5.brush. Ver references/core-api.md § p5.js 2.0.
Pipeline
Cada proyecto sigue el mismo camino de 6 etapas:
CONCEPTO → DISEÑO → CÓDIGO → VISTA PREVIA → EXPORTACIÓN → VERIFICACIÓN
- CONCEPTO — Articula la visión creativa: estado de ánimo, mundo de color, vocabulario de movimiento, qué lo hace único
- DISEÑO — Elige modo, tamaño de canvas, modelo de interacción, sistema de color, formato de exportación. Mapea el concepto a decisiones técnicas
- CÓDIGO — Escribe un único archivo HTML con p5.js inline. Estructura: globales →
preload()→setup()→draw()→ helpers → clases → manejadores de eventos - VISTA PREVIA — Abre en el navegador, verifica la calidad visual. Prueba a la resolución objetivo. Comprueba el rendimiento
- EXPORTACIÓN — Captura la salida:
saveCanvas()para PNG,saveGif()para GIF,saveFrames()+ ffmpeg para MP4, Puppeteer para lotes sin interfaz - VERIFICACIÓN — ¿La salida coincide con el concepto? ¿Es visualmente impactante al tamaño de visualización previsto? ¿Lo enmarcarías?
Dirección Creativa
Dimensiones Estéticas
| Dimensión | Opciones | Referencia |
|---|---|---|
| Sistema de color | HSB/HSL, RGB, paletas con nombre, armonía procedural, interpolación de gradientes | references/color-systems.md |
| Vocabulario de ruido | Ruido Perlin, simplex, fractal (octavado), warping de dominio, ruido curl | references/visual-effects.md § Ruido |
| Sistemas de partículas | Basados en física, flocking, trazado de estelas, impulsados por atractores, siguiendo campos de flujo | references/visual-effects.md § Partículas |
| Lenguaje de formas | Primitivas geométricas, vértices personalizados, curvas bezier, rutas SVG | references/shapes-and-geometry.md |
| Estilo de movimiento | Suavizado, basado en resortes, impulsado por ruido, simulación física, interpolado, escalonado | references/animation.md |
| Tipografía | Fuentes del sistema, OTF cargada, textToPoints() partículas de texto, cinética | references/typography.md |
| Efectos de shaders | Fragment/vertex GLSL, shaders de filtro, postprocesado, bucles de retroalimentación | references/webgl-and-3d.md § Shaders |
| Composición | Cuadrícula, radial, proporción áurea, regla de los tercios, dispersión orgánica, mosaico | references/core-api.md § Composición |
| Modelo de interacción | Seguimiento del ratón, clic para generar, arrastrar, estado del teclado, impulsado por scroll, entrada de micrófono | references/interaction.md |
| Modos de mezcla | BLEND, ADD, MULTIPLY, SCREEN, DIFFERENCE, EXCLUSION, OVERLAY | references/color-systems.md § Modos de mezcla |
| Capas | createGraphics() buffers fuera de pantalla, composición alfa, enmascaramiento | references/core-api.md § Buffers fuera de pantalla |
| Textura | Superficie Perlin, punteado, rayado, medios tonos, ordenación de píxeles | references/visual-effects.md § Generación de texturas |
Reglas de Variación por Proyecto
Nunca uses configuraciones predeterminadas. Para cada proyecto:
- Paleta de color personalizada — nunca
fill(255, 0, 0)en bruto. Siempre una paleta diseñada con 3-7 colores - Vocabulario de peso de trazo personalizado — acentos finos (0.5), estructura media (1-2), énfasis en negrita (3-5)
- Tratamiento del fondo — nunca
background(0)obackground(255)simples. Siempre texturizado, degradado o en capas - Variedad de movimiento — diferentes velocidades para diferentes elementos. Principal a 1x, secundario a 0.3x, ambiente a 0.1x
- Al menos un elemento inventado — un comportamiento de partícula personalizado, una aplicación novedosa de ruido, una respuesta de interacción única
Invención Específica del Proyecto
Para cada proyecto, inventa al menos uno de:
- Una paleta de color personalizada que coincida con el estado de ánimo (no un preajuste)
- Una combinación novedosa de campos de ruido (por ejemplo, ruido curl + warping de dominio + retroalimentación)
- Un comportamiento de partícula único (fuerzas personalizadas, estelas personalizadas, generación personalizada)
- Un mecanismo de interacción que el usuario no solicitó pero que eleva la pieza
- Una técnica compositiva que cree jerarquía visual
Filosofía de Diseño de Parámetros
Los parámetros deben surgir del algoritmo, no de un menú genérico. Pregunta: "¿Qué propiedades de este sistema deberían ser ajustables?"
Buenos parámetros exponen el carácter del algoritmo:
- Cantidades — cuántas partículas, ramas, celdas (controla la densidad)
- Escalas — frecuencia de ruido, tamaño del elemento, espaciado (controla la textura)
- Ritmos — velocidad, tasa de crecimiento, decaimiento (controla la energía)
- Umbrales — ¿cuándo cambia el comportamiento? (controla el drama)
- Proporciones — proporciones, equilibrio entre fuerzas (controla la armonía)
Malos parámetros son controles genéricos no relacionados con el algoritmo:
- "color1", "color2", "tamaño" — sin sentido sin contexto
- Interruptores para efectos no relacionados
- Parámetros que solo cambian la estética, no el comportamiento
Cada parámetro debe cambiar cómo el algoritmo piensa, no solo cómo se ve. Un parámetro de "turbulencia" que cambia las octavas de ruido es bueno. Un deslizador de "tamaño de partícula" que solo cambia el radio de ellipse() es superficial.
Flujo de Trabajo
Paso 1: Visión Creativa
Antes de cualquier código, articula:
- Estado de ánimo / atmósfera: ¿Qué debería sentir el espectador? ¿Contemplativo? ¿Energizado? ¿Inquietante? ¿Juguetón?
- Historia visual: ¿Qué sucede con el tiempo (o con la interacción)? ¿Construcción? ¿Decaimiento? ¿Transformación? ¿Oscilación?
- Mundo de color: ¿Cálido/frío? ¿Monocromático? ¿Complementario? ¿Cuál es el tono dominante? ¿El acento?
- Lenguaje de formas: ¿Curvas orgánicas? ¿Geometría afilada? ¿Puntos? ¿Líneas? ¿Mixto?
- Vocabulario de movimiento: ¿Deriva lenta? ¿Estallido explosivo? ¿Pulso respiratorio? ¿Precisión mecánica?
- Qué hace que ESTO sea diferente: ¿Cuál es la única cosa que hace único a este boceto?
Mapea el prompt del usuario a elecciones estéticas. "Fondo generativo relajante" exige todo diferente de "visualización de datos glitch".
Paso 2: Diseño Técnico
- Modo — cuál de los 7 modos de la tabla anterior
- Tamaño del canvas — horizontal 1920x1080, vertical 1080x1920, cuadrado 1080x1080, o responsive
windowWidth/windowHeight - Renderizador —
P2D(predeterminado) oWEBGL(para 3D, shaders, modos de mezcla avanzados) - Velocidad de fotogramas — 60fps (interactivo), 30fps (animación ambiente), o
noLoop()(generativo estático) - Objetivo de exportación — visualización en navegador, PNG estático, bucle GIF, video MP4, vector SVG
- Modelo de interacción — pasivo (sin entrada), impulsado por ratón, impulsado por teclado, reactivo al audio, impulsado por scroll
- UI del espectador — para arte generativo interactivo, comienza desde
templates/viewer.htmlque proporciona navegación por semillas, deslizadores de parámetros y descarga. Para bocetos simples o exportación de video, usa HTML simple
Paso 3: Codificar el Boceto
Para arte generativo interactivo (exploración de semillas, ajuste de parámetros): comienza desde templates/viewer.html. Lee la plantilla primero, mantén las secciones fijas (navegación de semillas, acciones), reemplaza el algoritmo y los controles de parámetros. Esto le da al usuario navegación de semillas (anterior/siguiente/aleatorio/salto), deslizadores de parámetros con actualización en vivo y descarga PNG — todo conectado.
Para animaciones, exportación de video o bocetos simples: usa HTML simple:
Archivo HTML único. Estructura:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Nombre del Proyecto</title>
<script>p5.disableFriendlyErrors = true;</script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/p5.js/1.11.3/p5.min.js"></script>
<!-- <script src="https://cdnjs.cloudflare.com/ajax/libs/p5.js/1.11.3/addons/p5.sound.min.js"></script> -->
<!-- <script src="https://unpkg.com/[email protected]"></script> --> <!-- exportación SVG -->
<!-- <script src="https://cdn.jsdelivr.net/npm/ccapture.js-npmfixed/build/CCapture.all.min.js"></script> --> <!-- captura de video -->
<style>
html, body { margin: 0; padding: 0; overflow: hidden; }
canvas { display: block; }
</style>
</head>
<body>
<script>
// === Configuración ===
const CONFIG = {
seed: 42,
// ... parámetros específicos del proyecto
};
// === Paleta de Colores ===
const PALETTE = {
bg: '#0a0a0f',
primary: '#e8d5b7',
// ...
};
// === Estado Global ===
let particles = [];
// === Precarga (fuentes, imágenes, datos) ===
function preload() {
// font = loadFont('...');
}
// === Configuración ===
function setup() {
createCanvas(1920, 1080);
randomSeed(CONFIG.seed);
noiseSeed(CONFIG.seed);
colorMode(HSB, 360, 100, 100, 100);
// Inicializar estado...
}
// === Bucle de Dibujo ===
function draw() {
// Renderizar fotograma...
}
// === Funciones Auxiliares ===
// ...
// === Clases ===
class Particle {
// ...
}
// === Manejadores de Eventos ===
function mousePressed() { /* ... */ }
function keyPressed() { /* ... */ }
function windowResized() { resizeCanvas(windowWidth, windowHeight); }
</script>
</body>
</html>
Patrones de implementación clave:
- Aleatoriedad con semilla: Siempre
randomSeed()+noiseSeed()para reproducibilidad - Modo de color: Usa
colorMode(HSB, 360, 100, 100, 100)para un control de color intuitivo - Separación de estado: CONFIG para parámetros, PALETTE para colores, globales para estado mutable
- Entidades basadas en clases: Partículas, agentes, formas como clases con métodos
update()+display() - Buffers fuera de pantalla:
createGraphics()para composición en capas, estelas, máscaras
Paso 4: Vista Previa e Iteración
- Abre el archivo HTML directamente en el navegador — no se necesita servidor para bocetos básicos
- Para
loadImage()/loadFont()desde archivos locales: usascripts/serve.shopython3 -m http.server - Pestaña Rendimiento de Chrome DevTools para verificar 60fps
- Prueba a la resolución de exportación objetivo, no solo al tamaño de la ventana
- Ajusta parámetros hasta que lo visual coincida con el concepto del Paso 1
Paso 5: Exportación
- PNG:
saveCanvas('nombre-del-proyecto', 'png')— exportación instantánea - GIF:
saveGif('nombre-del-proyecto', duraciónEnFotogramas)— incluyesaveGif()en la CDN o p5.js 2.x - WebM / GIF: CCapture.js +
saveFrameCanvas()para captura determinista de velocidad de fotogramas - MP4: CCapture.js -> fotogramas PNG -> ffmpeg (ver
scripts/encode.sh) - SVG: Usa
p5.js-svgen lugar del p5.js regular para salida vectorial - Lotes sin interfaz: Puppeteer para renderizar cientos de variaciones desde la línea de comandos (ver
scripts/batch-render.js)
Paso 6: Entrega Final
Proporciona:
- Archivo HTML autocontenido (todos los bocetos)
- Configuraciones de semilla que producen los mejores resultados visuales
- Para exportación de video: archivo MP4 listo para compartir de 10-30 segundos, encuadrado, con audio si corresponde
- Para proyectos interactivos: URL de CodePen o CodeSandbox
- Opcional: imagen estática PNG de 1920x1080
Siempre verifica el resultado final. Ábrelo en una pantalla de tamaño completo. Míralo durante 60 segundos. ¿Sigue siendo interesante? Si no, itera.
Referencias
| Archivo | Contenido |
|---|---|
references/core-api.md | Funciones principales de p5.js, modos de color, buffers fuera de pantalla, diferencias entre 1.x y 2.x |
references/color-systems.md | Paletas de color, modos de mezcla, generación de gradientes, armonía de color |
references/visual-effects.md | Generación de ruido, sistemas de partículas, campos de flujo, manipulación de píxeles, generación de texturas |
references/shapes-and-geometry.md | Primitivas geométricas, curvas, vértices, rutas SVG |
references/animation.md | Suavizado, resortes, secuencias temporizadas, gráficos en movimiento |
references/typography.md | Carga de fuentes, textToPoints(), tipografía cinética |
references/webgl-and-3d.md | Geometría 3D, iluminación, cámara, shaders GLSL, renderizado de texturas |
references/interaction.md | Eventos de ratón/teclado, entrada de micrófono, toque, táctil, scroll |
templates/viewer.html | Plantilla para arte generativo interactivo con navegación de semillas y controles de parámetros |
templates/bare.html | Plantilla HTML simple para animaciones y exportación de video |
scripts/serve.sh | Servidor de desarrollo local |
scripts/batch-render.js | Renderizado sin interfaz con Puppeteer |
scripts/encode.sh | Codificación de video ffmpeg de fotogramas PNG |