Il existe quelques librairies 3d pour flash, quelles sont les fonctionnalités qui m'ont poussées vers Minko ?

• Minko possède son propre format de fichier de modèle 3d (extension .mk) environ 8 à 10 fois moins lourd que le très usité Collada par exemple (extension .dae).
• Les shaders sont simples à écrire et à maintenir ou faire évoluer. On les écrit entièrement en as3 et non en AGAL.
• Minko studio et shader lab semblent prometteurs (le premier pour la gestion des matériaux, la compression en mk et l'assemblage de modèles 3d, le second pour la création de shader).
• Minko a été créé par des français (Aerys), ce qui peut faciliter le support.

Tout d'abord, il convient de télécharger la dernière version de FlashDevelop. Ce qui est bien avec ce logiciel, contrairement à Flash builder, c'est que l'on a bien plus de facilité à créer un projet as3 orienté 3d. En effet, flashDevelop met à disposition un bon nombre de versions de flash déjà installées. Il n'y a plus qu'à choisir la version qu'il nous faut dans les propriétés du projet. Le paramètre de compilation -swf-version est quant à lui géré automatiquement. Pour rappel, voici une petite sélection des nouveautés apportées par les différentes version de flash qui permettent l'utilisation de la 3d. Il est toutefois possible de trouver plus d'informations sur le site d'Adobe.

Ensuite, il nous faut télécharger les sources de la librairie. Minko étant constitué de plusieurs parties :

• Minko constitue le coeur de la librairie (scene graph, rendu, shaders as3, lumières, géométries...).
• Minko-Collada pour charger les fichiers DAE.
• Minko-Picking pour gérer les intéractions de souris "pixel-perfect"
• Minko-Effects contient quelques shaders et post-process.
• Minko-max3ds pour charger les fichiers 3DS.
• Minko-Mk pour utiliser les fichiers d'extension mk (via Aerys).

Pour la suite de cette article, nous ne chargerons que le coeur de la librairie. Pour cela, nous avons le choix entre télécharger directement l'archive ZIP(1), utiliser GITHUB(2), utiliser tortoiseGit via l'url du dépôt(3).

L'idéal étant de garder la dernière version de Minko à portée, nous allons utiliser le logiciel GITHUB en cliquant sur le bouton Clone in Windows. Si vous ne possédez pas le logiciel, vous serez invité à le télécharger et il faudra cliquer de nouveau pour récupérer Minko. Voilà ce que ça donne en image :

Une fois les sources téléchargées, il faut paramétrer son projet as3 dans flashDevelop. Il y a deux choses à faire. D'abord choisir la bonne version de flash, ce sera donc 11.2 minimum.

Ensuite, il faut ajouter Minko dans son classpath...

...en récupérant le chemin vers notre dépôt local de GITHUB (via les options).

Voilà un script commenté pour afficher un cube vert avec Minko. Je rédigerai une série d'articles plus complet sur le fonctionnement de Minko plus tard dont je posterai les sources sur github.

  	/**
  	 * Premiers pas avec Minko.
  	 * Tutoriel 1 : Création et affichage d'un cube.
  	 * éléments survolés : Scene, Viewport, Camera, Mesh, Material, CubeGeometry
  	 * @author Ludovic Bas
  	 */
  	public class Tutoriel1 extends Sprite 
  	{
  		private var _viewport : Viewport;
  		private var _scene : Scene;

    		public function Tutoriel1():void 
  		{
  			if (stage) init();
  			else addEventListener(Event.ADDED_TO_STAGE, init);
  		}

    		private function init(e:Event = null):void 
  		{
  			removeEventListener(Event.ADDED_TO_STAGE, init);
  			//la scène est un graphe de scène contenant tous les éléments 3d
  			//sous forme de noeuds.
  			_scene = new Scene();
  			//le viewport recevra le rendu 3d
  			_viewport = new Viewport();
  			//le viewport est un sprite, c'est pourquoi on l'ajoute à
  			//la displayList flash
  			addChild(_viewport);
  			addEventListener(Event.ENTER_FRAME, enterFrameHandler);
  			createCamera();
  			createCube();
  		}
  		protected function enterFrameHandler(event : Event) : void
  		{
  			//A chaque frame la scène (=scene graph) est rendue dans le 
  			//viewport (=Sprite flash ~= Stage3d)
  			_scene.render(_viewport);
  		}
  		protected function createCamera():void {
  			var camera : Camera = new Camera();
  			//la caméra est un noeud de la scène, c'est pourquoi on l'ajoute
  			//dans la scène
  			_scene.addChild(camera);
  		}
  		protected function createCube():void {
  			//le mesh est un noeud de la scène qui nécessite
  			//une géométrie et un matériau.
  			var cube:Mesh = new Mesh(CubeGeometry.cubeGeometry, 
  					new BasicMaterial( { diffuseColor:0x00ff00ff } ));
  			//on déplace le cube pour l'éloigner de la caméra et ainsi
  			//le rendre visible dans notre application
  			cube.transform.translationZ = 5.;
  			_scene.addChild(cube);
  		}
  	}  

Voici quelques liens utiles pour approfondir vos connaissances sur Minko :

• Forum anglais de Minko
• Forum français de Minko
• Hub développeur d'Aerys (tutoriels, documentation, exemples...)
• Forum français généraliste sur Stage3d
• GITHUB d'Aerys
• En savoir plus sur AGAL (permet également d'en savoir plus sur les shaders)
• 3d cheatsheet de Nicoptere
• mes articles sur Minko
• mes tutoriels sur Minko