***************************************************************************** A l i a - M a p V1.01, 28 Mai 1993 Un outils puissant pour les développeurs de jeux vidéos Documentation par Yves Schmid ***************************************************************************** Table des matières: I) Avant-propos II) Remerciements III) Un bref descriptif IV) Tutorial IV) Définitions utiles V) Structure d'un projet VI) Création d'un projet VII) Création d'une carte globale. VIII) Création d'une carte gfx. IX) Création de nouvelles pièces. X) Edition des cartes globales. XI) Gestions des palettes. XII) Couper, coller, etc... XIII) Autres fonctions XIV) Aide de dernière minute XV) Développements futurs ***************************************************************************** I) Avant-propos Alia-Map est un programme "shareware". Cela signifie que si vous utilisez ce logiciel vous devez le payer. Cette version est distribuable, mais elle ne permet pas la sauvegarde des données. La première bonne nouvelle de cette version, c'est le prix: Il est désormais fixé à 60 Fr.- Suisse; plusieurs utilisateurs m'ayant fait remarquer que l'ancien prix réservait ce logiciel aux développeurs professionels. Ceux qui auront payé l'ancien prix recevront gratuitement AliaAnim (un programme d'animation dans la même lignée qu'AliaMap). Vous devrez me verser cette somme (ou éventuellement l'équivalent dans une autre monnaie) en échange de quoi vous recevrez: la version complète, des routines pour importer les fichiers dans vos programmes, et un descriptif du format des fichiers. Pour me contactez: Courrier : Yves Schmid, Rue de la Faucille 2, 1201 Genève, Suisse. Téléphone: ++ 41 22 733 31 15 E-mail : ADSP, schmidy@alfalog.adsp.sub.org Bix : yschmid * NOTE: Stipulez dans votre commande si vous désirez une version 68020,30, etc... Si vous désirez une version française ou anglaise. Pour éviter tout piratage, le nom du commanditaire sera codé dans le logiciel. *********************** **** Version 1.01 ***** *********************** Bugs corrigées: * S'il n'y avait pas assez de mémoire pour créer une nouvelle carte globale le programme se bloquait. * Le programme avait quelques problèmes avec le choix du mode graphique lors du chargement d'un projet. * La palette par défaut faisait planter le système lorsque l'on avait un écran de plus de huit plans (>256 couleurs). * L'éditeur d'image plantait en cas de manque de mémoire. * La mise à jour des palettes ne se faisait pas dans certaines circonstances. * L'éditeur d'image n'affichait pas toujours la palette par défaut lorsque l'on créait une nouvelle image. * Le programme perdait 1 byte de la mémoire lorsque l'on cliquait sur "annuler" dans le requester "Nouvelle carte Gfx" * Le requester de fichier pouvait provoquer des "enforcer hit". Améliorations: * Les tailles des cartes globales et des cartes gfxs étaient limitées à 999 x 999. Maintenant les limites sont 99'999 x 99'999. * La vitesse de l'affichage des cartes GFXs est deux à trois fois plus rapide. * La vitesse de l'affichage des pièces lors de l'édition des cartes GFXs est deux à trois fois plus rapide. * L'affichage des cartes globales module la palette de l'écran pour rapprocher l'image réduite de l'image originale. ***************************************************************************** II) Remerciements Merci à Pascale pour avoir contribué à la traduction anglaise de la documentation. Merci à David Bianchi, pour être le premier à m'avoir acheter AliaMap et pour ses tests qui m'ont permi de découvrir quelques bugs. Merci à Mark Somogyi qui a découvert quelques bugs. Merci à Chris Green pour ces suggestions. ***************************************************************************** III) Un bref descriptif Alia-Map est un éditeur de décors utilisant les techniques de pointe des jeux vidéos actuels et de la nouvelle génération d'Amiga. A l'heure où la plupart des développeurs commencent à entrevoir les possibilités des nouvelles machines, Alia-Map offre une solution et un gain de temps considérable en matière de développement de jeux vidéos. * Oui, mais encore? La plupart des jeux vidéos utilisent des combinaisons de petites images graphiques pour créer de vastes décors. Cette technique s'applique pratiquement à tous les jeux vidéos 2D, allant du "Shoot'em up" au jeu d'aventure-action. Alia-Map intervient exactement durant la phase de construction des décors du jeu. Facile d'emploi et très flexible, cet éditeur permet de créer des décors rapidement et de manière intuitive. Il peut être utilisé par un graphiste ou un scénariste, et sans qu'une seule ligne n'aie été tapée par un programmeur, des tableaux entiers peuvent être créés et visionnés. * Alia-Map est flexible. Alia-Map fonctionne dans toutes les résolutions graphiques. Ce dernier s'adapte automatiquement au système sur lequel vous travaillez et suit les standards de l'OS 3.0. Il vous permet de créer des décors de n'importe quelle taille, utilisant des parties graphiques elles-mêmes de taille variable. * Alia-Map est puissant. Avec Alia-Map vous chargez vos images IFF et l'éditeur les décompose automatiquement suivant vos préferences. Un éditeur de dessin intégré vous permet ensuite de retravailler vos images sans quitter le programme. Une fois vos image intégrées, le programme se comporte comme un logiciel de dessin, vous cliquez sur la partie graphique qui vous intéresse et avec la souris vous placez vos images dans les cartes graphiques. Les cartes graphiques ont deux niveaux de combinaisons différents: il est possible de créer deux décors en combinant des images, puis d'utiliser ces deux décors pour créer de nouvelles combinaisons. Cette facilité permet de créer des tableaux immenses ne prenant que très peu de mémoire. * Alia-Map fonctionne sur n'importe quel Amiga. Malgrés le fait qu'Alia-Map soit avant tout orienté vers la nouvelle génération Amiga, il est capable de tourner sur n'importe quel Amiga ayant au moins l'OS 3.0 installé et peut très bien être utilisé pour créer des jeux destinés à l'Amiga 500. ***************************************************************************** IV) Tutorial Une petite démo se trouve dans cette archive, elle vous permettra de voir rapidement comment fonctionne Alia-Map. Lancer Alia-Map. Allez dans le menu "projet" puis sélectionnez "ouvrir". Cliquez sur le fichier qui s'appelle "map-demo". Bien, maintenant votre démo est chargée. La barre de titre porte le nom du projet actuel. Alia-Map est capable de gérer plusieurs projets à la fois, si vous chargez un autre projet, celui-ci s'ajoutera dans la mémoire sans pour autant que l'autre soit fermé. Pour fermer un projet sélectionnez "fermer" dans le menu projet. Pour passer d'un projet à un autre sélectionnez "affichez" dans le menu projet. Maintenant allez dans le menu "global" et sélectionnez "afficher". Vous allez voir un "requester" s'ouvrir, se dernier comporte une entrée appelée "demoglob". Cliquez dessus deux fois. La barre de titre a changé, cette dernière montre votre position dans le projet. Vous êtes sur la carte globale "demoglob" du projet "map-demo". Une image va lentement s'afficher. Cette image représente une carte faite de diverses combinaisons graphiques. Ceci n'est qu'une réduction de plusieurs cartes assemblées. L'affichage n'est pas très rapide, mais vous pouvez continuer à travailler pendant que l'image se construit. Sans attendre allez dans le menu "gfx" et sélectionnez "afficher". Un nouveau "requester" va s'ouvrir, choisissez "gfxmap1". Nous voici au coeur de l'action. L'écran est divisé en deux zones: celle de gauche représente la carte graphique que j'appelle carte GFX, et qui est une combinaison de petites images. A droite se trouve les images qui ont servit à construire la carte GFX. Ces images sont appelées "pièces" dans le logiciel. La carte GFX étant plus grande que l'écran, des gadgets proportionnels vous permettent de vous déplacez à l'intérieur de cette dernière. Cliquez sur une des pièces dans la zone de droite. Vous venez de la sélectionner. Maintenant allez sur la carte GFX, puis tout en cliquant dessus déplacez la souris. Vous venez de placer une pièce dans la carte GFX. En sélectionnant d'autres pièces vous pouvez modifiez la carte GFX à votre guise. ***************************************************************************** IV) Définitions utiles Avant d'aller plus loin voici quelques définitions utiles: * Pièces: Ce sont de petites images (bitmap), qui combinées entre elles créent les cartes GFX. Ces images peuvent êtres dessinées directement à l'intérieur du logiciel ou importée d'un fichier IFF. * Carte GFX: La carte GFX est le résultat de la combinaison des pièces. C'est la carte qui représente ce que les gens verront, lorsque le tableau sera construit. * Carte globale: La carte globale est une combinaison de carte GFX. Dans la plupart des cas cette dernière est inutile. Mais dans certains cas de grandes cartes peuvent être créées, en combinant des cartes GFX. ***************************************************************************** V) Structure d'un projet Un projet est constitué de: _ Pièces graphiques _ Cartes globales qui elles mêmes sont faites de cartes GFX. _ Palettes qui sont attachées aux pièces graphiques. Ce qui donne: ------------------------------------------- | Projet | ------------------------------------------- | | | | | | --------------------- --------------------- | Pièces graphiques | | Cartes globales | --------------------- --------------------- | | --------------------- --------------------- | Palettes | | Cartes GFX | --------------------- --------------------- Chaque projet peut possèder plusieurs cartes globales qui elles-mêmes possèdent plusieurs cartes GFX. ***************************************************************************** VI) Création d'un projet Pour créer un projet, sélectionnez "nouveau" dans le menu "projet". Un requester s'ouvre. Vous pouvez donner un nom à votre projet. Ce nom sera utilisé de manière interne et vous permettra de reconnaître vos projets lorsque plusieurs seront chargés. Pour choisir un autre mode graphiques que celui de l'écran actuel cliquez sur "mode graphique". Vous pouvez choisir un mode graphique et le nombre de couleurs désirées. Ensuite, vous pouvez choisir la taille des pièces en pixels. Cette taille est toujours calculée en multiple de 16. Si vous mettez deux fois deux, vous aurez des pièces de 32x32 pixels. Dans la version actuelle la taille des pièces est limitée à 9 (9x16 = 144x144 pixels). Cliquez sur ok. Ensuite vous pouvez soit importez ou dessinez des pièces graphiques soit définir les cartes globales. ***************************************************************************** VII) Création d'une carte globale. Sélectionnez "nouveau" dans le menu "global". Donnez un nom à votre carte globale. Vous pouvez définir la largeur et la hauteur de la carte globale. Ces deux valeurs pourront être modifiées n'importe quand par la suite grâce aux deux gadgets se trouvant au bas de l'écran lorsque la carte globale est affichée. Reste à définir la taille qu'auront les cartes GFXs de cette carte globale. Ces chiffres une fois définis ne pourront plus être modifiés par la suite. Ils s'appliqueront à toutes les cartes GFXs qui seront créées dans cette carte globale. ***************************************************************************** VIII) Création d'une carte gfx. Pour créer une carte GFX vous devez avoir au moins une carte globale définie et affichée. Lorsque ces deux conditions sont réunies sélectionnez "nouveau" dans le menu "GFX". La carte GFX sera attachée à la carte globale affichée. ***************************************************************************** IX) Création de nouvelles pièces. Il y a deux possibilités: * Soit importer les pièces: Sélectionnez "charger" dans le menu pièce. Puis sélectionnez une image au format IFF. * Soit les dessiner: Sélectionnez "dessiner" dans le menu pièce. Le logiciel ayant un éditeur de dessin integré, vous pouvez dessinez de nouvelles images sans sortir de Alia-Map. Cet éditeur de dessin est un peu lent lorsque vous l'utilisez dans de hautes résolutions et avec de nombreuses couleurs. Il n'avait été développé au départ que pour être utilisé en 32 couleurs basse résolution, mais il fonctionne tout de même. Une fois que votre image est là, il s'agit de la décomposer en plusieurs pièces. Alia-Map s'en charge automatiquement pour vous. Un écran va être ouvert et vous pourrez observez le découpage qu'a réalisé AliaMap. Cette écran peut être plus grand que l'affichage, si cela arrive vous pouvez le faire scroller en allant sur les bords avec le pointeur de la souris. Si le scrolling laisse des traces noires au bord de l'écran à gauche, ce n'est pas une bug, mais un problème des moniteurs qui ne fonctionne qu'avec "VGAOnly". Retirez VGAOnly de "devs:monitor" et relancez, ou contentez-vous de travailler avec les bords noirs. Il se peut que le découpage ne soit pas bien centré relativement à votre image. Pour changer le décalage, utilisez les gadgets proportionnels qui se trouvent en bas et à droite. Si vous ne désirez pas certaines pièces vous pouvez les désélectionnez en cliquant dessus. Au départ Alia-Map désélectionne automatiquement toutes les pièces qui ne sont faites que d'une seule couleur. Lorsque toutes les pièces désirées sont sélectionnées, cliquez sur "ok". ***************************************************************************** X) Edition des cartes globales. Pour éditer les cartes globales, cliquez simplement sur la position qui vous intéresse, un "requester" s'ouvrira et vous permettra de choisir quelle carte GFX vous désirez placer à cet endroit. Vous ne pouvez pas commencer l'édition tant que la carte globale n'est pas complétement affichée. A part ça, le logiciel reste complétement utilisable pendant l'affichage d'une carte globale. Vous n'avez jamais à attendre que la carte globale soit complétement affichée pour faire une action. La réduction de la carte globale peut être modifiée, pour changer de réduction allez sous "réduction" dans le menu "global". Une réduction de un correspond à la taille réelle. L'affichage des carte globales est lent, et demande à être optimisé. Cela sera certainement fait dans une prochaine version. ***************************************************************************** XI) Gestions des palettes. La gestion des palettes se fait de manière interne. L'utilisateur n'a pas à s'en soucier. AliaMap tient une banque de palettes pour chaque projet. Chaque fois que vous ajoutez de nouvelles pièces à un projet, AliaMap regarde dans sa banque s'il n'a pas déjà la palette qui correspond à ces pièces. Si ce n'est pas le cas, la palette est ajoutée. AliaMap se rappelle quelle pièce correspond à quelle palette. Lorsque vous éditez les cartes GFX, l'éditeur affiche automatiquement la palette qui correspond aux pièces affichées ou à la pièce sélectionnée. Pour que l'éditeur reste utilisable, les quatres premières couleurs de ce dernier ne sont jamais modifiées. Si vous désirez que ces quatres couleurs soient également affectées par le changement de palettes, servez-vous de l'entrée "affiche palette partielle" qui se trouve dans le menu "pièce" sous "palette". AliaMap peut dans une même carte GFX utiliser plusieurs palettes, ceci est très utile pour construire des tableaux qui changent leurs palettes au-fur-et-à-mesure que l'on se déplace dedans. ***************************************************************************** XII) Couper, coller, etc... Alia-Map possède un menu édition standard. L'édition pour l'instant ne fonctionne que sur les cartes GFXs. Vous pouvez copier, coller, couper, dans une même carte, d'une carte à une autre, et même d'un projet à un autre. Cependant méfiez-vous des copies d'un projet à un autre, si les projets ne possèdent pas les mêmes pièces, c'est la position des pièces dans la table qui va permettre à Alia-Map de choisir la correspondance des pièces entre deux projets. Pour couper, copier ou effacer, choisissez la fonction dans le menu "édition", cliquez à l'endroit du début du bloque, puis placez vous n'importe où dans la carte GFX, et recliquez. Pour coller, choisissez la fonction dans le menu "édition", puis cliquez à l'endroit où le début du bloque devra être copié. ***************************************************************************** XIII) Autres fonctions Pour chaque type de données il existe une fonction "détruire". C'est de cette manière que vous pouvez supprimer des pièces ou des cartes. Il existe également une fonction "renommer" pour la plupart des types de données. Cette fonction permet de changer le nom associé au type. ***************************************************************************** XIV) Aide de dernière minute Pour ceux qui se sentent dépassé, ne soyez pas inquiets. Ce logiciel peut sembler un peu complexe au départ, mais avec un peu de pratique tout devient plus simple. L'interface utilisateur est très intuitive, et le mieux est de se balader dans le logiciel, d'essayer la démo qui est décrite dans le tutorial. Avec un petit peu d'entrainement on a vite compris les différentes facettes du programme. Relisez les définitions des différents types de données jusqu'à ce que vous ayez bien saisit leur usage. Bonne chance! ***************************************************************************** XIV) Développements futurs Ce logiciel n'avait été développé au départ que pour mon propre usage. Mais devant la puissance de ce dernier j'ai pensé qu'il ne pouvait que s'imposer comme un des meilleurs outil dans son genre. Les développements futurs dépendent en grandes parties de la manière dont sera reçu ce logiciel par le public. Dans les grandes lignes: _ Un port ARexx. _ Une technique permettant à l'éditeur de se souvenir de combinaisons de pièces définies par l'utilisateur. _ Des animations dans les cartes GFX. _ Des outils pour gérer les palettes de l'intérieur du logiciel. _ Rendre le programme plus extensible. Permettre à l'utilisateur d'attacher des informations extérieurs aux différents types de données. _ Un format IFF pour les données. _ Une data-class permettant d'afficher les cartes et de scroller à l'intérieur. _ Permettre à l'utilisateur de modifier toutes les données (taille des cartes GFX, etc...)sans avoir à créer un nouveau projet.