Cette section présente les informations générales à propos de Ayam et de ce document.
Traduction en français : Alain Siksik 2020 (alain.siksik@bbox.fr)
La présentation suit fidèlement la version en anglais qui reste la seule référence.
Veuillez noter que les renvois et les menus ne sont pas traduits volontairement pour le moment au vu du volume initial à traduire.
Certains terme techniques ne sont volontairement pas traduits exemples :
- plugin : module d'extension
- NURBS (Non-Uniform Rational Basis Splines) : B-splines rationnelles non uniformes.
- ...
Ceci n'est donc qu'une première version non exempte d'erreurs et/ou contres-sens multiples et variés.
De même, il y a parfois un mélange entre les termes français et anglais, dus essentiellement au fait que les menus, options, caractéristiques, propriétés, objets, ... portent le même nom que ce qui est définit dans Ayam. Par exemple View et view -> View pour l'objet et vue pour le texte !
Mais parfois il y a confusion.
N'hésitez pas à m'en faire part afin d'améliorer le résultat final.
Ce document étant un manuel de référence, il est probablement inutile de le lire du début à la fin (sauf peut-être pour la section suivante, expliquant les bases de l'interface utilisateur). Au lieu de cela, recherchez simplement la documentation des choses qui vous intéressent via la table des matières ou l'index. Les renvois vous guideront alors vers d'autres parties importantes de la documentation. Encore une fois : ce manuel a un index assez gros, veuillez l'utiliser (voir section Index) !
Ce document est organisé de la manière suivante :
Après cette première section d'introduction, l'interface utilisateur de Ayam est expliquée et les instructions de manipulation de base sont fournies dans la deuxième section.
Dans la troisième section toutes les actions interactives de modélisation sont documentées.
La quatrième section détaille tous les types et propriétés des objets, suivie par la documentation de tous les objets de modélisation NURBS dans la cinquième section.
Dans la sixième section l'interface de script Tcl est expliquée et la septième section contient toutes les informations à propos des plugins d'importation et d'exportation.
La huitième section est la section diverse tant redoutée et qui contient toute la documentation qu'on n'a pas pu mettre ailleurs.
Dans ce manuel, les conventions typographiques suivantes sont utilisées :
<Ctrl+c> (appuyez sur la touche contrôle et la touche c "en même temps"), pour un raccourcis du genre <Ctrl+Shift+t> la version abrégée est la suivante : <Ctrl+T>;"A Nom";
set riopt(runtime) { a b }
+-Objet parent(Type)
| Premier objet enfant(Type)
| Deuxième objet enfant(Type)
| [Troisième objet enfant peut être présent ou non(Type)]
| Niveau vide(Level)
+-Sous niveau(Level)
|| Premier enfant du sous niveau(Type)
|\ Dernier enfant du sous niveau(Type)
\ Dernier enfant de l'objet parent(Type)
+-Objet parent suivant(Type)
Ayam est un environnement de modélisation 3D open source pour l'interface RenderMan, distribué sous la licence BSD (Berkeley Software Distribution License), modifiée sans clause de publicité.
Ayam est en développement depuis 1997 et était connu sous le nom de "The Mops".
Ayam est la base du travail de la thèse de l'auteur.
Une nouvelle version de Ayam est mise à jour tous les six mois environ.
Voici un bref résumé de l'ensemble des fonctionnalités de Ayam :
Depuis la version 1.12 de Ayam, le chargement dynamique d'objets personnalisés et de certains plugin sont aussi faisables sur la plateforme Windows 32 bits (ce n'était pas le cas avant)
Ayam est principalement destiné aux plates-formes Linux, IRIX et Win32. Sur ces plates-formes, le moteur graphique BMRT (Blue Moon Rendering Tools, compatible avec RenderMan de Larry Gritz) est disponible. Même si la distribution de BMRT est arrêtée, c'est toujours le moteur de rendu recommandé pour Ayam. Malgré cela, Ayam peut être utilisé sur de nombreuses autres plates-formes avec n'importe quel moteur de rendu compatible RenderMan.
Pour les plates-formes où BMRT n'est pas disponible (par exemple FreeBSD ou NetBSD), Ayam peut être compilé avec le code du toolkit Affine, mais avec des fonctionnalités limitées (voir aussi le fichier INSTALL). Dans ce cas, aucune analyse des ombres compilées par slc ne sera possible.
Depuis Ayam version 1.6, il est également possible de remplacer complètement l'analyse des ombres BMRT et le code d'écriture RIB par du code du projet Aqsis, éliminant ainsi complètement le besoin de BMRT. De plus, des plugins d'analyse des ombres sont disponibles pour tous les principaux moteurs de rendu compatibles RenderMan, permettant une intégration étroite de Ayam avec l'un de ces moteurs de rendu.
Ayam utilise un système de coordonnées dit "main droite" tel qu'utilisé par OpenGL mais en opposition avec RenderMan (ce dernier utilise un système de coordonnées dit "main gauche").
Dans la vue de modélisation par défaut "Front", l'axe X positif pointe vers la droite, l'axe Y positif pointe vers le haut et l'axe Z pointe vers l'extérieur de l'écran, vers l'utilisateur.
Voir aussi l'image suivante.
Toutes les coordonnées dans Ayam sont sans dimension. C'est à l'utilisateur de définir si la valeur 1 représente par exemple un centimètre ou un mètre.
En raison de la précision limitée de l'arithmétique à virgule flottante utilisée dans Ayam, les valeurs de coordonnées doivent être définies dans la plage comprise entre -10,0 et 10,0 pour des résultats plus précis.
Ayam stocke les coordonnées rationnelles dans le style euclidien rationnel, c'est-à-dire que le poids d'un point de contrôle n'est pas pré-multiplié avec les coordonnées (cela sera fait en interne lors de la remise des coordonnées à des fins de dessin ou d'exportation).
Dans les versions Ayam antérieures à 1.19, les poids étaient toujours multipliés par les valeurs de coordonnées (c'est-à-dire coordonnées homogènes rationnelles) pour permettre un dessin plus rapide avec OpenGL / GLU, qui s'attend à ce que les valeurs de coordonnées rationnelles lui soient fournies de cette façon.
Mais un effet secondaire négatif de cette approche était que la modification, des coordonnées ou des poids à des fins de modélisation, était inutilement compliquée.
Ayam peut toujours afficher les coordonnées dans les deux styles, contrôlés par l'option de préférence "RationalPoints" (voir aussi la section
Préférences de modélisation), mais en interne les coordonnées sont conservées en style rationnel euclidien.
Les fichiers de scène des anciennes versions de Ayam sont automatiquement convertis au nouveau style rationnel lorsqu'ils sont lus par Ayam 1.19 et supérieur, mais le chargement des fichiers de scène écrits par Ayam 1.19 et supérieur dans les anciennes versions de Ayam nécessitent une intervention manuelle (par exemple au moyen d'un script).