Retour Page MagicaVoxel VF
|
Magicavoxel-shaders by Lachlanmcdonald (VO)
|
Shaders pour MagicaVoxel pour simplifier les tâches courantes et répétitives.
Testé avec MagicaVoxel 0.98.2 (Beta) pour Windows et Mac
Réalisé sous Licence du MIT
Note v0.99.1 : Les Shaders fonctionnent avec v0.99.1, mais l'info-bulle qui affiche l'index des couleurs dans la vidéo ci-dessous n'est pas présente. Elle devrait être présente dans une version ultérieure.
Réalisé sous Licence du MIT
Note v0.99.1 : Les Shaders fonctionnent avec v0.99.1, mais l'info-bulle qui affiche l'index des couleurs dans la vidéo ci-dessous n'est pas présente. Elle devrait être présente dans une version ultérieure.
|
|
Installation
Installez ces shaders en copiant les fichiers du répertoire shader de ce projet dans le répertoire shader de votre installation MagicaVoxel.
Les noms en anglais renvoient à la section anglaise originale
Les noms en français aux sections de cette page(wip)
Installez ces shaders en copiant les fichiers du répertoire shader de ce projet dans le répertoire shader de votre installation MagicaVoxel.
Les noms en anglais renvoient à la section anglaise originale
Les noms en français aux sections de cette page(wip)
|
Les SHADERS
|
Originaux
|
Slice - Découpage
xs sx [c] [count]
xs sy [c] [count]
xs sz [c] [count]
xs sy [c] [count]
xs sz [c] [count]
|
|
|
Les Shaders de découpe suppriment un ou plusieurs segments de l'axe x, y ou z. Toutes les autres lignes sont mélangées afin de remplir l'espace disponible. Le premier argument "c" est la coordonnée du segment que vous souhaitez supprimer et "count" est le nombre de lignes. Notez que le comptage est facultatif et par défaut à 1.
Par exemple, dans la première image, les segments sont supprimés avec ces commandes :
xs sx 19 1
xs sy 15 1
Par exemple, dans la première image, les segments sont supprimés avec ces commandes :
xs sx 19 1
xs sy 15 1
Pyramid - Pyramide
xs py [index]
xs py2 [index]
|
|
|
|
|
|
Les shaders py et py2 ajoutent une couche de voxel sur les voxels correspondant à la couleur choisie.
Un voxel n'est ajouté que lorsque le voxel en dessous a des voxels adjacents, créant l'effet d'une pyramide.
py n'ajoutera des voxels que lorsque les voxels adjacents correspondent à la couleur sélectionnée.
Alors que py2 ajoutera des voxels s'il y a des voxels adjacents de n'importe quelle couleur.
S'il est fourni, l'index sera l'index de couleur des voxels ajoutés. Cet argument est facultatif.
Si omis (ou mis à 0), l'indice de couleur sélectionné est utilisé à la place.
Chaque fois que le shader est exécuté, une seule couche est ajoutée.
Pour ajouter plusieurs couches à la fois, vous pouvez exécuter la commande en boucle comme indiqué ci-dessous :
xs -n 50 py
xs -n 50 py2
Un voxel n'est ajouté que lorsque le voxel en dessous a des voxels adjacents, créant l'effet d'une pyramide.
py n'ajoutera des voxels que lorsque les voxels adjacents correspondent à la couleur sélectionnée.
Alors que py2 ajoutera des voxels s'il y a des voxels adjacents de n'importe quelle couleur.
S'il est fourni, l'index sera l'index de couleur des voxels ajoutés. Cet argument est facultatif.
Si omis (ou mis à 0), l'indice de couleur sélectionné est utilisé à la place.
Chaque fois que le shader est exécuté, une seule couche est ajoutée.
Pour ajouter plusieurs couches à la fois, vous pouvez exécuter la commande en boucle comme indiqué ci-dessous :
xs -n 50 py
xs -n 50 py2
|
|
Si aucun des deux modes d'axes (ou X et Y) n'est défini, le Shader formera une pyramide carrée. Si les modes X ou Y sont réglés, le Shader formera plutôt une pyramide triangulaire, la pente étant orientée vers les axes X ou Y respectivement.
Sand - Tas de Sable
xs sand [index] [add]
xs sand2 [index] [add]
xs sand2 [index] [add]
|
|
|
Les Shaders sand et sand 2 ajoutent une couche de voxels sur les voxels correspondant à la couleur choisie. Les voxels sont ajoutés au hasard et seulement lorsque le voxel en dessous a des voxels adjacents, créant l'effet d'un tas de sable rugueux. Le nombre de voisins adjacents affecte le caractère aléatoire, un nombre plus élevé de voisins augmentant les chances qu'un voxel soit ajouté.
S'il est fourni, l'index sera l'index de couleur des voxels ajoutés. Cet argument est facultatif. Si omis (ou mis à 0), l'indice de couleur sélectionné est utilisé à la place.
add peut être utilisé pour augmenter les chances d'ajouter des voxels. Les nombres compris entre 0,01 et 0,4 ont le meilleur effet. Parce que add est le deuxième argument, vous pouvez mettre l'index à 0 si vous utilisez add dans une loop. (boucle)
Chaque fois que le Shader est exécuté, une seule couche est ajoutée. Pour ajouter plusieurs couches à la fois, vous pouvez exécuter la commande en boucle comme indiqué ci-dessous :
xs -n 50 sand
xs -n 50 sand2
S'il est fourni, l'index sera l'index de couleur des voxels ajoutés. Cet argument est facultatif. Si omis (ou mis à 0), l'indice de couleur sélectionné est utilisé à la place.
add peut être utilisé pour augmenter les chances d'ajouter des voxels. Les nombres compris entre 0,01 et 0,4 ont le meilleur effet. Parce que add est le deuxième argument, vous pouvez mettre l'index à 0 si vous utilisez add dans une loop. (boucle)
Chaque fois que le Shader est exécuté, une seule couche est ajoutée. Pour ajouter plusieurs couches à la fois, vous pouvez exécuter la commande en boucle comme indiqué ci-dessous :
xs -n 50 sand
xs -n 50 sand2
Lines - Lignes
xs lnx [index] [spacing] [offset]
xs lny [index] [spacing] [offset]
xs lnz [index] [spacing] [offset]
Remplace tous les voxels qui correspondent à la couleur sélectionnée par des lignes définies sur la couleur passée comme index. Mettre l'index à 0 supprimera les voxels. Les lignes sont espacées en fonction de l'argument d'espacement, qui est 2 par défaut.
Les lignes peuvent être décalées avec le paramètre offset. Vous devez utiliser les modes d'axes pour limiter les lignes à un axe particulier.
(Ce shader combine les shaders lnx, lny et lnz des versions précédentes.
|
|
Soil - Salissure
xs soil [index] [n]
xs soil2 [index] [n]
xs soil2 [index] [n]
|
|
Les Shaders soil et soil2 ajoutent des voxels, réglés à la couleur passée en indice, sur les voxels correspondant à la couleur que vous avez choisie. Les voxels ne sont ajoutés que s'il y a de l'espace vide. Par défaut, les voxels sont ajoutés s'il y a au moins un espace vide au-dessus, cependant vous pouvez ajuster le nombre de voxels qui sont cochés avec n.
soil2 est semblable à soil, sauf que les voxels sont remplacés au lieu d'être ajoutés sur le dessus.
soil2 est semblable à soil, sauf que les voxels sont remplacés au lieu d'être ajoutés sur le dessus.
|
|
|
Case
xs case [index]
|
|
|
|
|
|
Entoure tous les voxels qui correspondent à la couleur que vous avez sélectionnée.
Les modes Axes peuvent être utilisés uniquement pour ajouter des voxels sur certains axes.
La couleur du contour sera l'index fourni.
Les modes Axes peuvent être utilisés uniquement pour ajouter des voxels sur certains axes.
La couleur du contour sera l'index fourni.
Outline - Contour
xs outline [index]
xs outline2 [index]
|
|
|
Remplace tous les voxels qui correspondent à votre couleur sélectionnée et qui sont adjacents à un autre voxel d'une couleur différente. La couleur du contour sera l'index fourni. Mettre l'index à 0 supprimera les voxels.
outline2 est similaire à outline, sauf que moins de voxels adjacents sont cochés, ce qui produit des lignes légèrement plus fines.
outline2 est similaire à outline, sauf que moins de voxels adjacents sont cochés, ce qui produit des lignes légèrement plus fines.
Grid - Grille
xs grid [index] [x] [y] [xoffset] [yoffset]
|
|
|
Remplace tous les voxels qui correspondent à la couleur sélectionnée par une grille avec une taille de cellule déterminée par x et y. Les cellules de la grille sont colorées selon l'index fourni. Mettre l'index à 0 supprimera les voxels. Les grilles peuvent être carrées ou rectangulaires. Vous pouvez décaler la position de la grille avec les arguments xoffset et yoffset, qui sont par défaut à 0.
Noise - Bruit
xs noise [a] [b]
|
|
Remplace tous les voxels qui correspondent à votre couleur sélectionnée par une couleur choisie au hasard dans une gamme de couleurs (a et b, inclus).
|
|
Les voxels sont remplacés sur tous les axes. Vous pouvez randomiser l'axe X, Y ou Z (ou une combinaison des trois) avec le mode axe.
Random - Aléa
xs rand [f] [index]
|
|
|
Remplace tous les voxels qui correspondent à votre couleur sélectionnée par un index choisi au hasard. Si l'index est 0, les voxels sont enlevés au hasard à la place. Vous pouvez contrôler le seuil en ajustant la valeur f. Des valeurs plus proches de 0,0 remplaceront plus de voxels. Des valeurs plus proches de 1,0 remplaceront moins.
|
|
|
Les voxels sont remplacés sur tous les axes. Vous pouvez randomiser l'axe X, Y ou Z (ou une combinaison des trois) avec le mode axe.
Flood - Innondation
xs flood [n]
xs flood2 [n]
xs flood2 [n]
|
|
|
|
|
|
|
Ajoute n couches de voxels avec la couleur de votre choix à partir du bas de votre modèle. Les voxels ne sont ajoutés qu'aux espaces vides et ne remplaceront pas les voxels existants. La valeur par défaut est un calque unique.
flood2 est similaire à flood, sauf que l'inondation s'arrête lorsqu'on rencontre un voxel de sorte que les espaces clos ne sont pas remplis.
flood2 est similaire à flood, sauf que l'inondation s'arrête lorsqu'on rencontre un voxel de sorte que les espaces clos ne sont pas remplis.
Générateur de Terrain
- Nom de fichier : tergen.txt
- Utilisation de la ligne de commande : xs tergen[seed][altitude][noise-scale][noise-scale][voxel-color] <void-voxel-color> <vertical-shifting> <x-shifting> <y-shifting>
- Ligne de commande par ex. : xs tergen 19260817 50 20 20 1 0 -10 10 10 10
- Edition minimale : xs tergen 19260817 50 20 1
- Il est recommandé de régler la taille de la scène sur 126x126x126x126 pour obtenir la meilleure vue.
- Réglez la couleur void-voxel sur -1 pour ne pas supprimer la scène originale.
- En utilisant le xyz-shifting du shader et le nouveau système global de MagicaVoxel 0.99.x, vous pourrez créer une grande carte du terrain. (fig. 3)
Flow - Cascades
Ce shader imite la mécanique de l'écoulement de l'eau dans la nature.
- Nom de fichier : flow.txt
- Utilisation de la ligne de commande : xs flow[color-index][index couleur]
- Ligne de commande, par exemple : xs flow 1
- Les voxels avec un index donné sont source d'eau, le shader ne les créerait pas automatiquement, vous devez les attacher en premier.
Flow 2 - Cascades 2
- Nom de fichier : flow2.txt
- Utilisation de la ligne de commande : xs flow2[color-index][index couleur
- Ligne de commande, par exemple : xs flow2 1
- Les voxels avec un index donné sont source d'eau, le shader ne les créerait pas automatiquement, vous devez les attacher en premier.
Hyper Flood - Super Flots
UNSTABLE. NE PAS UTILISER.
ALLEZ DANS FLOW2 À LA PLACE.
Contrairement au shader classique, ce shader offre une solution pour les zones d'eau fermées.
- LE SHADER NE SUPPORTE QUE LES SCÈNES AVEC MOINS DE 40 UNITÉS DE XYZ-VOLUMESIZE. (Vous pouvez modifier la ligne 17 pour supprimer la limite, mais réfléchissez d'abord).
- LIMITÉ PAR L'EXPLICATIF INTÉRIEUR DE MAGICAVOXEL, LE SHADER N'EST PAS STABLE. SI L'ESPACE DE REMPLISSAGE EST TROP GRAND, MAGICAVOXEL PEUT S'ÉCRASER.
ALLEZ DANS FLOW2 À LA PLACE.
Contrairement au shader classique, ce shader offre une solution pour les zones d'eau fermées.
- Nom de fichier : hyperflood.txt
- Utilisation de la ligne de commande : xs hyperflood[x][y][z] (Les paramètres représentent les coordonnées de la source d'eau.)
- Ligne de commande par exemple : xs hyperflood 3 5 3 3
- La couleur de l'eau est contrôlée par la couleur sélectionnée dans la palette.
- LE SHADER NE SUPPORTE QUE LES SCÈNES AVEC MOINS DE 40 UNITÉS DE XYZ-VOLUMESIZE. (Vous pouvez modifier la ligne 17 pour supprimer la limite, mais réfléchissez d'abord).
- LIMITÉ PAR L'EXPLICATIF INTÉRIEUR DE MAGICAVOXEL, LE SHADER N'EST PAS STABLE. SI L'ESPACE DE REMPLISSAGE EST TROP GRAND, MAGICAVOXEL PEUT S'ÉCRASER.
Life Game - Jeu de La Vie de Conway
- Nom de fichier : lifegame.txt
- Utilisation de la ligne de commande : xs lifegame[color-index].
- Ligne de commande par exemple : xs lifegame 1
- Conçu pour le plan X-Y. Utilisez une seule couleur dans votre scène, ou le shader la détruira.
Blanket - Manteau
- Nom de fichier : blanket.txt
- Utilisations de la ligne de commande : xs blanket[voxel-color] <noise-seed> <noise-scale> <noise-scale> <threshold (0~2 recommandé)> >
- Ligne de commande par ex. : xs blanket 1 1248343 20 1.4
- Edition minimale par ex. : xs blanket 1
2. Esp. si le générateur de terrain et l'ombrage de couverture ont les mêmes graines de bruit et la même échelle, et que le xyz-shifting du générateur de terrain est nul, le résultat des deux ombres mélangées ensemble sera comme la couverture de neige réaliste des hautes montagnes. (fig. 3)
Cube Filling - Remplissage de Cubes
- Nom de fichier : cubefill.txt
- Utilisations en ligne de commande :
xs cubefill[mode[mode[0 pour le remplissage, 1 pour l'image]][pointX][pointY][pointY][pointZ][longueur d'un côté][couleur voxel][couleur voxel
- Ligne de commande par ex : xs cubefill 1 1 1 1 1 1 7 2 2 216 - Dessine le cadre du bord d'un cuboïde rouge entre les coordonnées (1,1,1) et (7,2,2).
Flood - Nappes
- Nom de fichier : flood.txt
- Utilisation de la ligne de commande : xs flood[hauteur][couleur]
- Ligne de commande par exemple : xs flood 60 169
- Ce shader n'est pas conçu pour des zones sélectionnées. (Ceci pourrait être amélioré dans les prochaines versions)
Darker - Assombrir
- Nom de fichier : darker.txt
- Utilisation de la ligne de commande : xs darker
Ce shader n'est pas conçu pour des zones sélectionnées. (Ceci pourrait être amélioré dans les prochaines versions)
|
Project - Projection
- Nom de fichier : project.txt
- Utilisation de la ligne de commande : xs project[altitude du plan xy]
- Ligne de commande d'exemple : xs project 64 (64 étant l'altitude Z d'un plan XY de voxels couleurs dans la matrice active)
Toutes les couleurs d'une altitude donnée vont être projettées sur les volumes existants de la matrice active!
|
|
Drop - Goute d'eau
Nom de fichier : drop.txt
Ce shader simule le processus des gouttes d'eau.
- Utilisation de la ligne de commande : xs drop[color-index][index couleur]
- Ligne de commande par exemple : xs drop 1
Ce shader simule le processus des gouttes d'eau.
Extrude By Carandiru Original
Le shader Extrude va "dupliquer" les voxels de la couleur de la palette choisie sur l'axe choisi (ex, ey, ez), dans le sens (-1,1) de cet axe. En option, l'argument "decay" peut être fourni pour supprimer un anneau ou une bordure de voxels autour du périmètre de l'axe opposé. La répétition répétée extrudera dans la direction, et avec la décrépitude, il s'effondrera / créera un effet d'escalier suivant le comptage des voxels sélectionnés par couleur de palette. (Semblable à une pyramide, mais sur n'importe quel axe).
xs ex [direction] (optional)[decay]
xs ey [direction] (optional)[decay]
xs ez [direction] (optional)[decay]
xs ey [direction] (optional)[decay]
xs ez [direction] (optional)[decay]
Pseudofractals-voxel-shader by Kchapelier Original
Copiez les fichiers dans les shaders / vers le dossier shader/ dans votre installation de MagicaVoxel.
Utilisation
Dans MagicaVoxel, exécutez "xs pseudofractal 1.0 1.0 1.0 1.01 26. 0.4 0" dans sa console sans les "".
Paramètres (7)
xs pseudofractal xscale yscale zscale distOrder seed(graine) thresold(seuil) cleaning (nettoyage)
xscale : L'échelle sur l'axe X. Un petit nombre étire l'axe, un grand nombre le condense.
yscale : L'échelle sur l'axe Y. Un petit nombre étire l'axe, un grand nombre le condense.
zscale : L'échelle sur l'axe Z. Un petit nombre étire l'axe, un grand nombre le condense.
distOrder : L'algorithme utilise la distance de Minkowski qui est une généralisation de la distance euclidienne et de Manhattan. Ce paramètre contrôle l'"ordre" de la distance. Les valeurs supérieures à 2 ont tendance à donner une structure carrée avec des surfaces planes. Des valeurs très proches de 1 (i.e. 1.001) ont tendance à donner des octaèdres réguliers. Les valeurs recommandées se situent entre 0,5 et 2,5.
seed : La valeur "magique" utilisée pour générer le pseudofractal. Pour être précis, il est utilisé comme module. Une valeur de 0 donnera toujours un volume vide.
threshold : Contrôle le rapport des voxels vivants (solides). Une valeur de 0 signifie que tous les voxels sont considérés comme morts. Une valeur de 1 signifie que tous les voxels sont considérés comme vivants.
nettoyage : Si réglé et supérieur à 0, les voxels simples / isolés seront retirés du volume résultant.
Flux de travail recommandé
Commencez par régler l'échelle * sur 1, distOrder sur 2 ou 1.001, seed set sur un nombre différent de 1 et 0 et threshold sur 0.5.
Ajustez l'échelle *, distOrder et seed jusqu'à ce que vous ayez un volume intéressant.
Ajuster finement le seuil et éventuellement permettre le nettoyage s'il y a trop de voxels isolés.
Pour un meilleur résultat, le rendu dans MagicaVoxel avec des cubes de marche (nécessite la 0.98.2 ou moins car la version actuelle ne supporte pas les formes voxel).
Utilisation
Dans MagicaVoxel, exécutez "xs pseudofractal 1.0 1.0 1.0 1.01 26. 0.4 0" dans sa console sans les "".
Paramètres (7)
xs pseudofractal xscale yscale zscale distOrder seed(graine) thresold(seuil) cleaning (nettoyage)
xscale : L'échelle sur l'axe X. Un petit nombre étire l'axe, un grand nombre le condense.
yscale : L'échelle sur l'axe Y. Un petit nombre étire l'axe, un grand nombre le condense.
zscale : L'échelle sur l'axe Z. Un petit nombre étire l'axe, un grand nombre le condense.
distOrder : L'algorithme utilise la distance de Minkowski qui est une généralisation de la distance euclidienne et de Manhattan. Ce paramètre contrôle l'"ordre" de la distance. Les valeurs supérieures à 2 ont tendance à donner une structure carrée avec des surfaces planes. Des valeurs très proches de 1 (i.e. 1.001) ont tendance à donner des octaèdres réguliers. Les valeurs recommandées se situent entre 0,5 et 2,5.
seed : La valeur "magique" utilisée pour générer le pseudofractal. Pour être précis, il est utilisé comme module. Une valeur de 0 donnera toujours un volume vide.
threshold : Contrôle le rapport des voxels vivants (solides). Une valeur de 0 signifie que tous les voxels sont considérés comme morts. Une valeur de 1 signifie que tous les voxels sont considérés comme vivants.
nettoyage : Si réglé et supérieur à 0, les voxels simples / isolés seront retirés du volume résultant.
Flux de travail recommandé
Commencez par régler l'échelle * sur 1, distOrder sur 2 ou 1.001, seed set sur un nombre différent de 1 et 0 et threshold sur 0.5.
Ajustez l'échelle *, distOrder et seed jusqu'à ce que vous ayez un volume intéressant.
Ajuster finement le seuil et éventuellement permettre le nettoyage s'il y a trop de voxels isolés.
Pour un meilleur résultat, le rendu dans MagicaVoxel avec des cubes de marche (nécessite la 0.98.2 ou moins car la version actuelle ne supporte pas les formes voxel).
|
Variantes
Deux variantes du shader sont incluses. pseudofractal-sub permet de sculpter un volume existant avec l'espace négatif du pseudofractal. pseudofractal-add permet d'ajouter le pseudofractal à un volume existant sans affecter aucun de ses propres voxels. Les deux variantes utilisent les mêmes paramètres que le shader principal. |
|
Notes complémentaires
Merci à Alien qui m'a initié aux pseudofractals ;)
Consultez l'exposé de Jes Wolfe sur le sujet (youtube) si vous voulez en savoir plus sur les pseudofractals.
Si vous êtes intéressé par ce genre de génération de structure mais que vous voulez quelque chose de plus prévisible et de moins aléatoire, vérifiez svp cellular-automata-voxel-shader.
Merci à Alien qui m'a initié aux pseudofractals ;)
Consultez l'exposé de Jes Wolfe sur le sujet (youtube) si vous voulez en savoir plus sur les pseudofractals.
Si vous êtes intéressé par ce genre de génération de structure mais que vous voulez quelque chose de plus prévisible et de moins aléatoire, vérifiez svp cellular-automata-voxel-shader.
