Le format de fichers G³

Avertissement

Cette documentation est en cours d'élaboration. Le format G³ est sur le point de subir des modifications de fond, qui ne permettront pas de maintenir la compatibilité entre les différentes versions. Pour cette raison, la rédaction de la documentation est retardée jusqu'à ce que le format de fichiers soit stabilisé.

Introduction

Les fichiers G³ sont des fichiers XML encodés en UTF-8. L'enregistrement en UTF-8 est nécessaire pour que les lettres accentuées et les symboles mathématiques soient lus et affichés correctement. Les fichiers portent l'extention .g³ ou .g3 (cette dernière est préférable pour les fichiers à diffuser sur le web, pour éviter les incompatibilités).

L'esprit et la syntaxe sont fortement inspirés du format ouvert X3D, et beaucoup de balises X3D sont reprises telles quelles dans le format G³.

Exemple minimal de fichier g³


<?xml version="1.0" encoding="utf-8"?>
<geocube version="3.0.7"> Version minimale de jmath3d avec laquelle ce fichier peut être lu.
<Scene> Cette balise, unique, est la racine de la scène. Toutes les balises géométriques doivent être à l'intérieur.
... Les éléments géométriques de la scène viennent ici.
</Scene> Fin de la description de la scène
</geocube>

Généralités

  • Les noms des balises commencent par une majuscule (sauf geocube, head et meta).
  • Les noms de leurs attributs commencent par une minuscule (sauf DEF).
  • Tous les indices commencent à 0.
  • Les nombres dans les listes (d'indices, de coordonnées) sont séparés par des espaces, tabulations, retours à la ligne, virgules, ou des combinaisons de tout ça.
  • Le séparateur décimal est le point. La virgule est utilisée pour séparer des données distinctes.