====== png23d ======
{{autolink>png23d}}
Petit logiciel libre en ligne de commande permettant de convertir une image, le plus souvant en noir et blanc, en modèle 3D, en convertissant les niveau de gris de l'image en "épaisseur" de l'objet sur l'axe Z. Cela peut être un moyen simple de générer rapidement un objet 3D simple.

===== Installation =====
Sur Debian ou dérivées (Ubuntu, linux mint, ...) il suffit d'un simple 
<code bash>
sudo apt-get install png23d
</code>
===== Utilisation =====
La [[http://kyllikki.github.io/png23d/usage.html|documentation]] et des [[http://kyllikki.github.io/png23d/examples.html|exemples]] sont disponibles sur le site de png23d. In simple ''man png23d'' vous permettra aussi d'afficher les différentes options de la commande.


===== Exemple =====
Réalisation d'une carte 3D:

==== Fichier PNG de base, en niveaux de gris ====

{{ :logiciels:png23d:map.png?direct&500 |}}

==== Commande ====
<code bash>
png23d -t 0 -w 120 -d 40 -o stl -f surface -l 256 map.png map.stl
</code>

Explications de la commande  sur [[http://explainshell.com/explain?cmd=png23d+-t+0+-w+120+-d+40+-o+stl+-f+surface+-l+256+map.png+map.stl|explainshell.com]]

  * **-t 0** : Indique que la couleur à utiliser pour la transparence (zone XY ou il n'y aura pas du tout de matière) est 0, c'est à dire le noir absolu.
  * **-w 120** : Inique que l'objet fera 120 de large.
  * **-d 40** : Indique un le nombre de niveau en Z de 40.
  * **-o stl ** : Indique que l'on souhaite un fichier ''stl'' en sortie
  * ** -f surface ** : Indique que l'on veux en sortie un fichier de type 3D surfacique (nous voulons ici générer un fichier 3D avec différent niveau de Z).
  * ** -l 256 ** : Indique le nombre de niveau de couleur à utiliser dans le fichier d'origine. Nous indiquons 256 puisque nous voulons pouvoir utiliser tout les niveaux de gris de notre fichier PNG.
  * **map.png** : Nom de l'image à utiliser en entrée. 
  * **map.stl** : Nom du fichier 3D à générer.


==== Résultat ====
{{ :logiciels:png23d:3d-map.png?direct&500 |}}