obja/README.md

OBJ augmenté

WaveFront OBJ est un format permettant d'encoder des modèles 3D de manière simple. Cependant, il n'est pas adapté aux représentations progressives. Pour cela, nous avons augmenté OBJ de nouvelles commandes qui permettent de modifier le contenu préalablement déclaré.

Commandes

Ajout d'un sommet

Comme dans le OBJ standard, pour ajouter un sommet, il suffit d'utiliser le caractère v suivi des coordonnées du sommet. Par exemple :

v 1.0 2.0 3.0

Ajout d'une face

Comme dans le OBJ standard, pour ajouter une face, il suffit d'utiliser le caractère f suivi des indices des sommets de la face. Par exemple :

v 0.0 0.0 0.0
v 1.0 0.0 0.0
v 1.0 1.0 0.0
f 1 2 3

Attention : en OBJ, les indices commencent à partir de 1

Attention : dans notre logiciel, seule les faces triangulaires sont supportées.

Edition d'un sommet

Notre format OBJ permet la modification d'un ancien sommet. Pour modifier un sommet, il suffit d'utiliser les caractères ev suivis de l'indice du sommet à modifier puis de ses nouvelles coordonées. Par exemple :

v 0.0 0.0 0.0
ev 1 1.0 1.0 1.0

Edition d'une face

Notre format OBJ permet la modification d'une ancienne face. Pour modifier une face, il suffit d'utiliser les caractères ef suivis de l'indice de la face à modifier puis des indices de ses nouveaux sommets. Par exemple :

v 0.0 0.0 0.0
v 1.0 0.0 0.0
v 1.0 1.0 0.0
v 1.0 1.0 1.0
f 1 2 3
ef 1 1 2 4

Suppression d'une face

Notre format OBJ permet la suppression d'une ancienne face. Pour supprimer une face, il suffit d'utiliser les caracètres df suivis de l'indice de la face à supprimer. Par exemple :

v 0.0 0.0 0.0
v 1.0 0.0 0.0
v 1.0 1.0 0.0
v 1.0 1.0 1.0
f 1 2 3
df 1

Attention : les indices des faces ne sont pas changés après la suppression d'une ancienne face.

Triangle strips et triangle fans

Pour la compression de contenu 3D, on utilise souvent des Triangle Strips et des Triangle Fans.

Notre format OBJ augmenté permet la déclaration de strips et de fans en utilisant respectivement les caractères ts et tf suivis des indices des sommets. Par exemple :

v -1.0 0.0 0.0
v -0.5 1.0 0.0
v 0.0 0.0 0.0
v 0.5 1.0 0.0
v 1.0 0.0 0.0
ts 1 2 3 4 5

ou bien

v 0.0 0.0 0.0
v -1.0 0.0 0.0
v -0.707 0.707 0.0
v 0.0 1.0 0.0
v 0.707 0.707 0.0
v 1.0 0.0 0.0
tf 1 2 3 4 5 6

Utilisation

Vous pouvez récupérer les sources de cette application en lançant la commande

git clone https://gitea.tforgione.fr/tforgione/obja

À la racine de ce projet, le script server.py vous permet de démarrer un server de streaming. Vous pouvez l'exécuter en lançant ./server.py. Une fois cela fait, vous pouvez allez sur localhost:8000 pour lancer le streaming. Le navigateur télécharge progressivement les données et les affiche.

Les modèles doivent être sauvegardés dans le dossiers assets, et peuvent être visualisés en ajouter ?nom_du_modele.obj à la fin de l'url. Par exemple, localhost:8000/?bunny.obj chargera le modèle bunny.obj du dossier assets. Ce modèle est un modèle d'exemple, il commence par encoder la version basse résolution du Stanford bunny, translate tous ses sommets, les retranslate vers leurs positions d'origines puis supprime toutes les faces.