CommunityImagegithub.com

mesh-painting

Peignez des paysages, marines et bâtiments réalistes ou picturaux avec du code seul, en utilisant des maillages triangulaires 3D, des matériaux procéduraux, l'éclairage, les ombres et des millions de coups de pinceau.

Qu'est-ce que mesh-painting ?

Le skill mesh-painting permet de générer des scènes visuelles complexes (paysages, marines, bâtiments) entièrement par code, sans recourir à des photographies ou à des modèles de génération d'images. Il s'appuie sur un moteur de rendu intégré qui utilise des maillages de triangles 3D, des matériaux procéduraux, des ombres et un éclairage simulé (coucher de soleil, heure dorée, direction personnalisée). L'utilisateur peut composer, modéliser, prévisualiser, rendre et finaliser l'image avec des millions de coups de pinceau procéduraux. Le skill est conçu pour fonctionner sous Linux avec Python 3.10+, NumPy, SciPy, Pillow et les outils système standard. Il offre un contrôle précis à chaque étape (comme l'inspection des tuiles de rendu et des tuiles peintes) et produit une image finale livrable accompagnée d'un rapport d'utilisation. Il ne doit pas être utilisé pour des logos, icônes, graphiques, diagrammes, textes, montages photo, vidéos ou requêtes d'un service de génération d'images.

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

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Mesh Painting

Construisez la scène demandée avec le moteur de rendu fourni et conservez son code source Python modifiable. Inspectez l'aperçu, chaque tuile de rendu et chaque tuile peinte. Utilisez la géométrie et la couleur procédurale partout. Si l'affichage PNG ou l'environnement d'exécution Linux requis est indisponible, expliquez-le avant de commencer.

Environnement d'exécution et chemins

Utilisez Linux, Python 3.10+, NumPy, SciPy, Pillow et findmnt de util-linux. Procfs doit décrire l'espace de noms PID actuel ; le fork, les signaux, le verrouillage de fichiers et les limites d'espace d'adressage imposées doivent fonctionner. Un compilateur C permet d'utiliser le noyau plus rapide. Consultez configuration, installation et commandes avant de créer l'environnement du projet. Utilisez un interpréteur sélectionné pour pip, les vérifications et chaque étape.

Localisez le répertoire de ce skill à partir du SKILL.md chargé, puis résolvez scripts/run.py, requirements.txt et les ressources par rapport à ce répertoire. Ne partez pas du principe que le répertoire de travail de l'appelant est le skill installé. Conservez l'environnement, la scène modifiable et les sorties dans le projet de l'utilisateur. Copiez la scène fournie appropriée dans cet espace de travail avant de la modifier. Mettez les chemins contenant des espaces entre guillemets.

Pour une vérification en terminal, le README fournit des commandes relatives exécutables. Pour un skill installé, invoquez le lanceur résolu avec l'interpréteur de projet sélectionné, en passant les chemins de la scène et de la sortie relatifs à l'espace de travail. Ne copiez pas de chemins spécifiques à la machine dans le code de la scène ou dans des instructions partagées.

Les modules de scène exécutent du Python de confiance avec les autorisations de l'utilisateur actuel. Le superviseur de ressources n'est pas un bac à sable pour fichiers/réseau ou code malveillant. Examinez le code de la scène fourni ; utilisez uniquement les interfaces déclarées du moteur, NumPy et la bibliothèque standard dans les scènes créées. Installez les dépendances dans le cadre de l'autorisation et de la politique d'environnement existantes de l'utilisateur.

Flux de travail

  1. Composer. Utilisez le sujet, le point de vue et l'heure de la journée du brief. Choisissez sunset pour un soleil dans le cadre et un contre-jour, ou golden_hour pour un éclairage latéral et des ombres portées. --sun OFFSET ELEV spécifie une direction personnalisée.
  2. Modéliser. Lisez l'API de scène. Copiez lighthouse.py pour la côte, les structures et les lampes, ou moor.py pour le couvre-sol et les pierres. Travaillez en mètres, Z vers le haut. Utilisez scene_rng(nom) et conservez les ID de régions denses de 2 à 127. Modélisez les fonctionnalités non prises en charge à partir des maillages disponibles et divulguez les limitations visibles.
  3. Aperçu. Exécutez --stage preview, ouvrez _preview.png, et vérifiez la composition, l'échelle, la lumière et l'exposition. Révisez et prévisualisez jusqu'à ce que la scène corresponde au brief. L'aperçu utilise l'échelle 1 et construit toute la géométrie.
  4. Rendu. Exécutez --stage render. Ouvrez _render.png et chaque tuile à la résolution d'origine, couvrant le premier plan et l'arrière-plan. La grille 3 × 2 par défaut va de _render_tile_r1c1.png à _render_tile_r2c3.png. Vérifiez les coutures, les triangles étirés, les objets flottants/enfouis, le bruit, le flou et les détails des matériaux. Modifiez la grille de tuiles si les découpes divisent le sujet, puis inspectez la nouvelle grille complète.
  5. Peindre. Après avoir approuvé le rendu final, exécutez --stage paint avec exactement la même scène, la même graine, le même look, le même soleil, le même niveau et la même échelle. Cette étape effectue un nouveau rendu en interne. Ouvrez le PNG de livraison, _full.png et chaque tuile peinte. Si un défaut provient du rendu sous-jacent, corrigez la scène et répétez l'inspection du rendu avant de peindre à nouveau.
  6. Livrer. Fournissez la scène modifiable, le PNG de livraison et le canevas complet. Identifiez l'étape terminée, le nombre réel de coups de pinceau, le temps écoulé, les paramètres, l'interpréteur/environnement d'exécution et toute faiblesse visible. Citez le rapport d'utilisation pour les résultats et les chiffres de ressources. Indiquez que l'image a été créée à partir de code sans photographies ni modèle d'image.

Pour les révisions, conservez la source précédente et les sorties avec des noms versionnés. Gardez la caméra, la graine et les autres paramètres inchangés sauf si l'édition demandée nécessite leur modification. Comparez les étapes correspondantes et examinez le diff source pour les modifications non intentionnelles. Enregistrez séparément les hachages de scène et les commandes lorsque la provenance est importante : le rapport d'utilisation ne capture pas tous les paramètres de rendu.

Indices de modélisation

  • Profilez les silhouettes avant d'ajouter les détails de surface. Donnez aux falaises des baies, des contreforts et des encoches ; utilisez terrace et ridged pour les corniches et les fissures.
  • Superposez de larges variations de couleur, du grain, des taches et des bandes d'humidité. Adaptez le pas du maillage au relief visible et estompez les détails de matériau sous-pixels avec g.fade.
  • La lumière latérale entre environ 60 et 110 degrés par rapport à la vue capte les crêtes. Le contre-jour met l'accent sur la silhouette.
  • Utilisez des portes, fenêtres et rampes familières pour établir l'échelle. Une porte mesure environ 2 m de haut et une caméra à hauteur des yeux environ 1,7 m.
  • Placez les objets à l'aide de la fonction de hauteur du terrain. Abaissez les plaques grossières sous les plaques fines pour éviter les intersections.

Limites et interruption

Conservez standard sauf si le travail nécessite un profil de ressources explicitement choisi. N'augmentez pas automatiquement les limites et ne relancez pas un travail arrêté. Pour le code de sortie 3, signalez l'étape, la ressource limitante, l'utilisation demandée/observée et le plafond ; proposez une réduction concrète ou demandez s'il faut utiliser un niveau supérieur. La lande nécessite une capacité géométrique standard même à faible échelle d'image. Limites, rapports et reprise

Exécutez en premier plan lorsque le délai d'attente de l'outil le permet. Arrêtez le travail en arrière-plan avec le même lanceur, interpréteur et préfixe --out plus --stop ; Ctrl+C demande également l'annulation. Les exécutions simultanées avec le même préfixe sont refusées. Conservez le fichier persistant .lock en place.

Lisez _usage.json après chaque étape. Distinguez les nouvelles sorties des images antérieures conservées ; étiquetez _partial.png comme non terminé. Un rapport peut être absent après des erreurs de démarrage ou d'autorisation de sortie. Signalez honnêtement les exécutions ayant échoué ou interrompues et conservez leurs preuves. Le noyau Python est plus lent ; utilisez le repli à faible échelle borné du README pour le vérifier et divulguez ses détails réduits.

Rapports

Expliquez le travail du pinceau lorsque cela est utile : sept passes construisent le canevas, le relief fait varier la luminosité jusqu'à 7 pour cent, le grain ajoute de la texture et le sous-échantillonnage crée l'image de livraison. Décrivez la sortie visible et le comportement mesuré plutôt que de promettre un photoréalisme ou de prétendre que des tuiles non visibles ont été inspectées.

Skills associés