Skip to content
This repository has been archived by the owner on Apr 29, 2024. It is now read-only.

Commit

Permalink
add screenshots for blender export to glTF
Browse files Browse the repository at this point in the history
  • Loading branch information
sdumetz committed Jan 16, 2024
1 parent e8ea87a commit 35ec5a0
Show file tree
Hide file tree
Showing 4 changed files with 81 additions and 2 deletions.
3 changes: 3 additions & 0 deletions assets/img/doc/blender_export_gltf.webp
Git LFS file not shown
3 changes: 3 additions & 0 deletions assets/img/doc/blender_export_gltf_options.webp
Git LFS file not shown
38 changes: 38 additions & 0 deletions en/doc/references/models/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,44 @@ Compression (using [Draco](https://google.github.io/draco/)) is supported and wi

The Blender [GLTF export](https://github.com/KhronosGroup/glTF-Blender-IO) is a good reference implementation and should generally be trusted.

## Export for eCorpus

[Blender](https://www.blender.org/) is the best solution to convert files from pretty much anything to glTF because it embeds the official plugin from the Khronos group, the consortium behind the glTF format.

<div class="row">
<div class="col-12 col-lg-6">
<h3>Export menu</h3>
<p>The glTF plugin is installed by default with Blender. Make sure you are using a recent version of Blender, preferably 4.0 or higher.</p>
<p> Click on <b>File > Export > glTF 2.0</b> to open the export window</p>
<p>You can choose to export only selected items or the whole scene.</p>
</div>
<div class="col-12 col-lg-6 d-flex flex-column">
<figure>
<img class="img-fluid" src="/assets/img/doc/blender_export_gltf.webp"/>
<figcaption class="px-4">Blender's export menu</figcaption>
</figure>
</div>
</div>

<h3>Export Options</h3>
<div class="row">
<div class="col-12 col-sm-6 col-xl-4">
<figure>
<img class="img-fluid" src="/assets/img/doc/blender_export_gltf_options.webp"/>
<figcaption class="px-4">glTF export popup</figcaption>
</figure>
</div>
<div class="col-12 col-sm-6 col-xl-8">
<p>For advanced use cases, check out the official documentation at <a href="https://docs.blender.org/manual/en/4.0/addons/import_export/scene_gltf2.html">doc.blender.org</a>.</p>
<ul>
<li>The <b>Binary</b> format (<code>.glb</code>) is recommended.</li>
<li>It is also possible to choose between <b>Z up</b> and <b>Y up</b> in the <b>Transform</b> menu for the scene's axis orientation.</li>
<li>Draco compression is supported and will generally speed up loading : faster network transfer and faster object parsing.</li>
<li>It is generally not useful to modify the compression settings.</li>
</ul>
</div>
</div>

## Size

Recommended sizes (faces and map size):
Expand Down
39 changes: 37 additions & 2 deletions fr/doc/references/models/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,13 +8,48 @@ L'éditeur fonctionne principalement avec le format [gltf](https://registry.khro

Des modèles au format [USD](https://openusd.org/release/intro.html) (`.usdz`) peuvent être fournis pour activer la réalité augmentée sur les appareils iOS mais ils ne peuvent pas être intégrés à la scène web3D pour le moment.

## Exporter pour eCorpus

[Blender](https://www.blender.org/) est le logiciel idéal pour convertir des fichiers de la plupart des formats 3D (**OBJ**, ***FBX**, etc...) vers glTF car il dispose d'un plugin officiel maintenu par le consortium Khronos, responsable du format glTF.

<div class="row">
<div class="col-12 col-lg-6">
<h3>Menu d'export</h3>
<p>Le plugin glTF est installé par défaut avec blender. Assurez-vous d'utiliser une version récente de Blender, de préférence 4.0 ou supérieure.</p>
<p> Cliquez sur <b>File > Export > glTF 2.0</b> pour ouvrir la fenêtre d'export</p>
<p>Vous pouvez choisir de n'exporter que la sélection courante ou toute la scène.</p>
</div>
<div class="col-12 col-lg-6 d-flex flex-column">
<figure>
<img class="img-fluid" src="/assets/img/doc/blender_export_gltf.webp"/>
<figcaption class="px-4">le menu d'export de Blender</figcaption>
</figure>
</div>
</div>

<h3>Options d'export</h3>
<div class="row">
<div class="col-12 col-sm-6 col-xl-4">
<figure>
<img class="img-fluid" src="/assets/img/doc/blender_export_gltf_options.webp"/>
<figcaption class="px-4">les options d'export</figcaption>
</figure>
</div>
<div class="col-12 col-sm-6 col-xl-8">
<p>Retrouvez la documentation complète du plugin sur <a href="https://docs.blender.org/manual/en/4.0/addons/import_export/scene_gltf2.html">doc.blender.org</a>.</p>
<ul>
<li>Le format <b>Binary</b> (<code>.glb</code>) est à privilégier.</li>
<li>Il est aussi possible de choisir entre <b>Z up</b> et <b>Y up</b> dans le menu <b>Transform</b> pour l'orientation des axes de la scène.</li>
<li>Pensez à activer la compression, qui permet de réduire la taille du fichier de sortie: cela accélèrera les temps de chargement : Sur certains modèles, la taille compressée peut être jusqu'à deux fois plus petite que la taille originale.</li>
<li>Il n'est généralement pas utile de modifier les paramètres de compression.</li>
</ul>
</div>
</div>

## Aller plus loin

### Niveaux de détail



L'application peut enregistrer plusieurs niveaux de détail pour un objet et tenter d'en afficher le plus pertinent. Les niveaux supportés sont :

Thumb
Expand Down

0 comments on commit 35ec5a0

Please sign in to comment.