Les composants Asphyre

Comme je le disais plus haut, c'est le composant central à tout projet utilisant Asphyre.
Un tel projet nécessite systématiquement la présence de ce composant. Il permet de paramétrer :

• plein écran ou non ;
• la taille (hauteur et largeur) de la zone d'affichage ;
• l'activation ou non des fonctions Transform and Lightning de votre carte vidéo (prise en charge des fonctions de calculs 3D plus poussés normalement dédiés au microprocesseur) ;
• la zone d'affichage (propriété WindowHandle : laisser 0 si la zone d'affichage est la Tform) ;
• etc.

Les composants qui affichent des images, des textes ou des objets sont directement liés à ce composant. Et c'est par son intermédiaire que se fait l'affichage.

Voilà donc le canvas sur lequel on va pouvoir dessiner.
Même si ce composant n'est pas un dérivé de TCanvas, la plupart des fonctions qui s'y trouvent ressemblent beaucoup aux fonctions de ce dernier. On retrouve ainsi les fonctions Rectangle, LineTo, FillRect, etc.
Toutefois, il faut noter que la plupart de ces fonctions ont des paramètres supplémentaires. Par exemple, il est possible (et très facile) de dessiner un rectangle avec un liseré noir opaque et une couleur blanche transparente en son centre. On trouve de même des effets d'antialiasing (effet anti escaliers : sorte de flou cachant les contrastes trop forts entre pixels) pour dessiner des ellipses.
Il faut noter également le principe assez particulier du TAsphyreCanvas: lorsque l'on dessine une forme, on enregistre en fait la forme et ses paramètres dans une sorte de base de données. Lorsque le canvas est dessiné, la base de données est parcourue et chaque entrée est dessinée.

Les utilisateurs reconnaîtront ce fameux Timer si particulier. Pour les autres, il s'agit d'un Timer plus précis que le TTimer de la VCL. Ce Timer est utilisé pour les traitements des entrées de l'utilisateur (clavier, souris et joystick(s)), pour le calcul des positions des différents objets de la scène à un moment t et d'afficher le résultat. Il s'utilise presque de la même façon que le TDXTimer de DelphiX. À une différence notable près, on y trouve deux événements:

• OnTimer ;
• OnRender (OnProcess sur la version Extreme).

L'événement OnTimer permet de procéder à tous les changements de la scène. Incrémentation de compteur, changement d'état, etc. L'événement OnRender, quant à lui, sert à afficher le rendu. Cette différenciation permet d'éclaircir son code et de séparer les traitements. À l'utilisation, cela se révèle fort pratique, car à l'époque de DelphiX, l'événement OnTimer du TDXTimer devenait très vite encombré et difficilement déchiffrable.

Ce composant est d'une simplicité et d'une efficacité redoutables.
C'est un conteneur de ressources. À ceci près qu'elles sont chargées depuis un fichier de type .vtdb.
Des utilitaires très bien faits sont fournis dans le pack Asphyre Pro pour créer un tel fichier.
On peut enregistrer deux types de données : des images et des polices.

• Les images : les formats PNG, JPEG, TGA, BMP, DIB sont reconnus. À l'aide de l'outil d'import d'images, on peut paramétrer la taille du pattern, la taille de la texture, les channels utilisés, etc.
• Les polices : En utilisant l'utilitaire Font Tool, on peut créer une ressource à partir d'une police existante avec les mêmes paramètres que les images

À noter un gros avantage pour les polices : vous pouvez créer une ressource à partir de n'importe quelle police sans vous soucier du déploiement de votre programme : les polices choisies sont « intégrées » dans le fichier vtdb.
La seule contrainte est de fournir le fichier vtdb qui contient toutes les données…
Remarque : la version Extreme prévoit de protéger les données contenues dans un TVTDb par un mot de passe ce qui interdira toute copie de vos ressources.

Ce composant sert à utiliser des images chargées depuis un TVTDb ou depuis un fichier.
Il contient des TAsphyreImage qui ont chacune des propriétés pratiques pour l'affichage en texture ou directement sur le TAsphyreCanvas.

De la même façon que le TAsphyreImages, le TAsphyreFonts est un composant créé pour récupérer et utiliser les polices définies dans le TVTDb.

Ces trois composants permettent de gérer les entrées du clavier, de la souris et des joysticks en utilisant DirectInput.

Ce composant sert à contenir les lumières d'une scène 3D.
Lors de la création de la scène, il suffit alors de les ajouter une par une (TAsphyreLight) et de les paramétrer.
Leur nombre maximum est autant que la mémoire vive peut en contenir, mais en réalité, ce nombre est limité par la carte vidéo. Dans la plupart des cas, on peut donc en mettre 8.
Chaque lumière peut entièrement être paramétrée. On peut définir son type (omni, directionnelle, etc.), sa couleur diffuse, spéculaire, etc. Ainsi que sa position et, éventuellement, sa cible si la lumière est du type directionnelle.

Comme son nom l'indique, ce composant représente la caméra de la scène.
Évidemment, on peut ajouter autant de caméras que l'on veut. Mais à la différence des TAsphyreLights, TAsphyreMaterials, etc., ce composant n'est pas un conteneur : il représente directement la caméra.
Pour afficher un objet vu d'une caméra, il suffit de faire :

AsphyreModels[0].Draw(CubeMtx, AsphyreCamera);

Sachant que AsphyreModels est un TAsphyreModels, que son index 0 contient un modèle 3D, que AsphyreCamera est un TAsphyreCamera et que CubeMtx est la matrice de transformation (translation et rotation) du modèle 3D dans l'index 0.

Ce composant sert à contenir les modèles 3D utilisés dans la scène…
Remarque : il est possible d'importer des fichiers de type .3ds (3D Studio MAX et G-Max) et Ascii (.ase). Ce qui permet donc d'utiliser les modeleurs 3D les plus courants sur le marché… Pour cela, il est fourni un outil: ModelConv.exe qui remplit cette fonction.

Ce composant contient tous les matériaux utilisés dans la scène.
Les matériaux sont utilisés sur les modèles 3D que l'on affiche.

Ce composant contient toutes les textures utilisées dans la scène. Ces textures peuvent être aussi bien utilisées en 3D (en les associant avec des matériaux d'un TAsphyreMaterials) ou en 2D (en les dessinant directement sur un TAsphyreCanvas).

Ce composant permet d'afficher du brouillard volumétrique.

Ce composant permet d'afficher des systèmes de particules.