CommunityImagengithub.com

mesh-painting

Pinta paisajes realistas o pictóricos, escenas marinas y edificios con solo código, utilizando mallas de triángulos 3D, materiales procedurales, iluminación, sombras y millones de pinceladas.

¿Qué es mesh-painting?

La habilidad 'mesh-painting' permite a un agente de IA (como Claude Code) crear escenas 3D realistas o pictóricas mediante código, utilizando un motor de renderizado empaquetado con Python, NumPy, SciPy y Pillow. No requiere fotografías ni modelos de generación de imágenes. El flujo de trabajo consta de seis etapas: composición (definir escena, luz y hora del día), modelado (usar mallas 3D y materiales procedurales con una API de escena), previsualización (generar una imagen en baja resolución para revisar composición, escala e iluminación), renderizado (generar la imagen completa en mosaicos para inspeccionar detalles), pintado (agregar pinceladas procedurales para textura y acabado) y entrega (proporcionar la escena editable y las imágenes finales). Soporta escenas de ejemplo como 'lighthouse.py' para costas y 'moor.py' para terreno cubierto. Es ideal para solicitudes que exigen escenas realistas sin usar fotografías ni modelos de IA generativa de imágenes. El agente debe seguir estrictamente el flujo de trabajo, inspeccionar cada mosaico renderizado y pintado, y reportar el uso de recursos.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dansasser/skills/tree/HEAD/skills/mesh-painting

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Mesh Painting (Pintura de Mallas)

Construye la escena solicitada con el renderizador empaquetado y mantén su fuente Python editable. Inspecciona la vista previa, cada mosaico de renderizado y cada mosaico pintado. Utiliza geometría procedural y color en todo momento. Si la visualización de PNG o el runtime Linux requerido no están disponibles, explícalo antes de comenzar.

Runtime y rutas

Usa Linux, Python 3.10+, NumPy, SciPy, Pillow y findmnt de util-linux. Procfs debe describir el espacio de nombres de PID actual; el fork, las señales, el bloqueo de archivos y los límites de espacio de direcciones deben funcionar. Un compilador C permite un núcleo más rápido. Revisa la configuración, instalación y comandos antes de crear el entorno del proyecto. Usa un intérprete seleccionado para pip, comprobaciones y cada etapa.

Localiza el directorio de esta habilidad desde el SKILL.md cargado, luego resuelve scripts/run.py, requirements.txt y los assets relativos a ese directorio. No asumas que el directorio de trabajo del solicitante es la habilidad instalada. Mantén el entorno, la escena editable y las salidas en el proyecto del usuario. Copia la escena empaquetada adecuada en ese espacio de trabajo antes de editarla. Pon entre comillas las rutas con espacios.

Para una comprobación desde terminal, el README proporciona comandos relativos ejecutables. Para una habilidad instalada, invoca el lanzador resuelto con el intérprete de proyecto seleccionado, pasando rutas de escena y salida relativas al espacio de trabajo. No copies rutas específicas de la máquina en el código de la escena o en instrucciones compartidas.

Los módulos de escena ejecutan Python confiable con los permisos del usuario actual. El supervisor de recursos no es un entorno aislado de archivos/red o código malicioso. Revisa el código de la escena proporcionado; usa solo interfaces del motor declaradas, NumPy y la biblioteca estándar en las escenas creadas. Instala dependencias dentro de la autorización existente del usuario y la política de entorno.

Flujo de trabajo

  1. Componer. Usa el tema, el punto de vista y la hora del día del encargo. Elige sunset para un sol en el encuadre y contraluz, o golden_hour para iluminación lateral y sombras proyectadas. --sun OFFSET ELEV especifica una dirección personalizada.
  2. Modelar. Lee la API de escena. Copia lighthouse.py para costa, estructuras y faros, o moor.py para cubierta vegetal y piedras. Trabaja en metros, con Z hacia arriba. Usa scene_rng(name) y mantén los ID de regiones densas del 2 al 127. Modela características no compatibles a partir de mallas disponibles y revela las limitaciones visibles.
  3. Previsualizar. Ejecuta --stage preview, abre _preview.png y comprueba composición, escala, luz y exposición. Revisa y previsualiza hasta que la escena coincida con el encargo. La previsualización usa escala 1 y aún construye toda la geometría.
  4. Renderizar. Ejecuta --stage render. Abre _render.png y cada mosaico a resolución original, cubriendo primer plano y fondo. La cuadrícula predeterminada de 3 × 2 va desde _render_tile_r1c1.png hasta _render_tile_r2c3.png. Comprueba costuras, triángulos estirados, objetos flotantes/enterrados, moteado, desenfoque y detalle de material. Cambia la cuadrícula de mosaicos si los cortes dividen el sujeto, luego inspecciona la nueva cuadrícula completa.
  5. Pintar. Después de aprobar el renderizado final, ejecuta --stage paint con exactamente la misma escena, semilla, aspecto, sol, nivel y escala. Esta etapa vuelve a renderizar internamente. Abre el PNG de entrega, _full.png y cada mosaico pintado. Si un defecto proviene del renderizado subyacente, corrige la escena y repite la inspección del renderizado antes de pintar de nuevo.
  6. Entregar. Proporciona la escena editable, el PNG de entrega y el lienzo completo. Identifica la etapa completada, el número real de trazos, el tiempo transcurrido, la configuración, el intérprete/entorno de ejecución y cualquier debilidad visible. Cita el informe de uso para los resultados y las cifras de recursos. Indica que la imagen se creó a partir de código sin fotografías ni un modelo de imagen.

Para revisiones, conserva la fuente anterior y las salidas con nombres versionados. Mantén la cámara, la semilla y otras configuraciones sin cambios a menos que la edición solicitada necesite cambiarlas. Compara etapas coincidentes y revisa el diff de la fuente para detectar cambios no deseados. Registra los hashes de escena y los comandos por separado cuando la procedencia sea importante: el informe de uso no captura todas las configuraciones de renderizado.

Indicaciones de modelado

  • Modela siluetas de formas antes de añadir detalles de piel. Da a los acantilados bahías, contrafuertes y muescas; usa terrace y ridged para repisas y fisuras.
  • Superpón variaciones amplias de color, grano, manchas y bandas húmedas. Ajusta el paso de la malla al relieve visible y desvanece el detalle del material subpíxel con g.fade.
  • La luz lateral alrededor de 60 a 110 grados desde la vista resalta las crestas. El contraluz enfatiza la silueta.
  • Usa puertas, ventanas y barandillas familiares para establecer la escala. Una puerta mide unos 2 m de alto y una cámara a la altura de los ojos unos 1.7 m.
  • Asienta los objetos usando la función de altura del terreno. Coloca parches gruesos debajo de parches finos para evitar intersecciones.

Límites e interrupción

Mantén standard a menos que el trabajo requiera un perfil de recursos explícitamente elegido. No aumentes automáticamente los límites ni reintenteces un trabajo detenido. Para el código de salida 3, informa la etapa, el recurso limitante, el uso solicitado/observado y el límite máximo; propón una reducción concreta o pregunta si se debe usar un nivel superior. El páramo necesita capacidad de geometría estándar incluso a baja escala de imagen. Límites, informes y recuperación

Ejecuta en primer plano cuando el tiempo de espera de la herramienta lo permita. Detén el trabajo en segundo plano con el mismo lanzador, intérprete y prefijo --out más --stop; Ctrl+C también solicita cancelación. Se rechazan ejecuciones concurrentes con el mismo prefijo. Mantén el archivo .lock persistente en su lugar.

Lee _usage.json después de cada etapa. Distingue las nuevas salidas de las imágenes anteriores conservadas; etiqueta _partial.png como inacabado. Un informe puede estar ausente después de errores de inicio o permisos de salida. Informa honestamente sobre ejecuciones fallidas o interrumpidas y conserva sus evidencias. El núcleo Python es más lento; usa el fallback de baja escala acotado del README para verificarlo y divulga su detalle reducido.

Informes

Explica el trabajo de pincel cuando sea útil: siete pasadas construyen el lienzo, el relieve varía el brillo hasta en un 7 por ciento, el grano añade textura y el submuestreo crea la imagen de entrega. Describe la salida visible y el comportamiento medido en lugar de prometer fotorrealismo o afirmar que se inspeccionaron mosaicos no vistos.

Skills relacionados