________________________________________________________________________________ ! ! ! I H A R D S P R I T E S D E S I G N E R I ! ! N N ! ! F Version Beta 3 F ! ! O O ! ! S OffseT from Futurs' 1994-2001 S ! !______________________________________________________________________________! DESCRIPTION GENERALE : ---------------------- Ce programme est la version beta d'un éditeur de sprites hard pour Amstrad 6128 plus. Cette version est en freeware, aussi, je compte sur vous pour la diffuser un peu partout... Toutefois, cette version beta est également la version définitive en ce qui me concerne car le projet est à présent abadonné. Néanmoins, si certains codeurs sont pret à reprendre le projet en main je peux leur donner les sources : ils sont entièrement en assembleur et largement commentés, donc assez facilement abordables. Cette doc est succinte et ne contient que les informations nécéssaires à une bonne exploration du programme. LANCEMENT DU PROGRAMME : ------------------------ Tapez simplement RUN"HSD" et attendez de voir apparaitre l'écran principal du logiciel. En principe vous devriez avoir sur la droite de l'écran les 16 sprites hard (non initialisés pour cette version), et sur la gauche les icones d'options et le zoom du sprite courant (ici le 0). LE FONCTIONNEMENT DU PROGRAMME : -------------------------------- Ce programme vous permet d'éditer les sprites hard de votre 6128 plus. Vous pouvez en modifier la palette, les zooms, et le contenu. L'édition de la palette se fait grace aux trois potentiomètres présents en haut de l'écran qui représentent (tout comme dans Kit 4096) les quantités de rouge, vert et bleu de chaque couleur. L'édition des sprites se fait grace au zoom. Vous disposez également d'un jeu d'icones vous permettant de modifier différents paramètres. Pour intervenir sur cet environnement vous avez 2 outils à votre disposition : le pointeur, qui vous permet de cliquer directement sur ce que vous voulez activer ou le clavier qui vous permet d'accéder aux options par différentes combinaisons. De plus, vous disposez de deux possibilités pour éditer les sprites ; soit en cliquant sur leur zoom avec le pointeur, soit en utilisant les curseurs présents sur les flancs gauche et bas du zoom. Les nouveaux types de fichiers : .SPR : Données d'un sprite hard (256 octets) .HSD : Ensemble des données de 16 sprites hard (4096 octets) .COL : Palette RVB des 15 couleurs des sprites hard (30 octets) (à ne pas confondre avec les .KIT introduits par Kit4096) .POS : Liste des positions des 16 sprites hard (64 octets) .ZOM : Liste des zooms des 16 sprites hard (16 octets) LES TOUCHES DE CONTROLE : ------------------------- Déplacement du pointeur graphique : Touches flechées ou Joystick/Souris/Paddle Déplacement des curseurs de retouche : Joystick/Souris/Paddle ou Touches flechées Validation pour le pointeur graphique : Espace ou Feu 1 Invalidation pour le pointeur graphique : Enter ou Feu 2 (non actif en démo) Validation pour les curseurs de retouche : Feu 1 ou Espace Invalidation pour les curseurs de retouche : Feu 2 ou Enter (non actif en démo) Inversion des controles curseur/pointeur : F Déplacement des sprites hard : Shift+Touches flechées Déplacement pas à pas des sprites hard : Ctrl+Shift+Touches flechées Sélection du zoom Asic du sprite courant : Crtl+Touches flechées Sauvegarde RAM de la position du sprite courant : Crtl+Return Chargement RAM de la position du sprite courant : Crtl+Esc Sauvegarde RAM de la position de tous les sprites : Ctrl+Shift+Return Chargement RAM de la position de tous les sprites : Ctrl+Shift+Esc Sélection du sprite courant : f1 & f3 Mise on/off du clignotement de sprite courant : f2 Sélection de l'encre courante : f0 & f. Controle de la quantité de bleu : f7 & f4 Controle de la quantité de rouge : f8 & f5 Controle de la quantité de vert : f9 & f6 Remplissage du sprite courant avec l'encre courante : Crtl+Clr Sauvegarde de la page courante dans la page brouillon : Crtl+Shift+Espace Echange du contenu du brouillon et de la page courante : Ctrl+Shift+Enter Sauvegarde du sprite courant dans la page brouillon : Crtl+Espace Echange du sprite de la page brouillon et du sprite courant : Crtl+Enter Sauvegarde de la palette dans la palette brouillon : Crtl+Shift+Copy Echange de la palette brouillon et de la palette active : Ctrl+Shift+Tab Sauvegarde de la couleur courante dans la palette brouillon : Crtl+Copy Echange de la couleur de la palette brouillon avec la couleur active : Ctrl+Tab Accès au menu d'options supplémentaires : Copy (non actif en version démo) Accès au Basic : B Réglage des paramètres du pointeur graphique dynamique : A+Z & 1+2 (non actif) Mise on/off du port analogique : P (non actif en version démo) Sélection de la page de sprites hard courantes : < & > LES ICONES : ------------ La plupart des icones donnent accès aux meme fonctions que celle atteintes grace au clavier mais d'autres sont le seul moyen d'accéder aux fonctions qu'ils représentent. - Haut et en bas des différents potentiomètres --> Controle des couleurs - CLS --> Remplissage du sprite courant avec l'encre active - SAVE --> Sauvegarde du sprite courant dans la page brouillon - SWAP --> Echange sprite courant / sprite de la page brouillon - Icone de la couleur courante --> Menu d'options supplémentaires - Icones de la palette --> Choix de la couleur courante - Icone avec la flèche en arc de cercle --> Rotation de 90 degrès à droite - Icone avec double flèche horizontale --> Inversion droite/gauche - Icone avec double flèche verticale --> Inversion haut/bas - CUT SPR --> Copie du sprite courant dans le tampon - GLU SPR --> Copie du tampon dans le sprite courant - CUT COL --> Copie de la couleur courante dans le tampon - GLU COL --> Copie du tampon dans la couleur courante - SWP COL --> Echange de la couleur courante et de celle de la palette brouillon - < PGE > --> Sélection de la page de sprites courantes - < SPR > --> Sélection du sprite courant - Premier icone en croix --> Sélection du zoom Asic du sprite courant - Deuxième icone en croix --> Décalage du sprite courant - Point central du second icone en croix --> Clignotement on/off Viennent ensuite les icones du menu supplémentaire qui vient se superposer au zoom d'édition ; celui-ci n'étant pas incorporé à la version beta il ne sera pas détaillé ici. Voici néanmoins les options que vous pourrez y découvrir : Load/Save/Merge/Erase/Rename/Drive A/Drive B sprites, pages, palettes, zooms, position, objets ; Edit/Cut/Glu objets ; Réglage des paramètres du pointeur dynamique ; Swap encre ; Clr page, palette, positions, zooms, objets, all ; Infos zooms, positions, objets ; Capture écran, window, pattern. NOTE : Un objet est un ensemble de sprites liés en zoom et en position. INFORMATION COMPLEMENTAIRES : ----------------------------- Une fois que vous etes retourné au Basic par la touche B différents choix s'offrent à vous pour retourner dans le programme en jouant sur la variable option dans votre CALL &2000,option : - "option" omis ou nul reset global (sauf contenu des sprites) - bit 1 de "option" (+1) : Reset palette (0=reset) - bit 2 de "option" (+2) : Reset zooms (0=reset) - bit 3 de "option" (+4) : Reset positions (0=reset) - bit 4 de "option" (+8) : Choix du controle curseur/pointeur - bit 5 de "option" (+16) : Activation du bit 4 (0=bit 4 inactif) Si vous faites simplement un CALL &2000 sans spécifier d'option, alors le logiciel se lancera en remttant tous les paramètres par défaut. Une dernière solution consiste à lancer H.S.D. par un CALL &2000,option,àadrposit%,àadrzooms%. adrposit et adrzooms doivent etre des variables déclarées et initialisées. En retour elles pointeront sur les tables de position et de zoom de la page de sprites en cours d'édition. Cette option a été rajouté dans l'optique de vous permettre de sauver/charger ces paramètres malgré l'absence du menu principal dans le logiciel. Il est à noter également que, dans tous les cas, au lancement du programme les sprites de la page I/O Asic sont copiés dans la page courante. Il en est de meme pour les positions lorsque bit2=1. De meme, lorsque bit1=1, c'est la palette les sprites de la page I/O Asic qui est utilisée. La gestion des zooms est différente et sera détaillée dans la version définitive. Lorsque vous changez de page courante sous l'éditeur, la page précédente est recopiée dans la page brouillon ; de ce fait, pas un simple SWAP vous pouvez copier les sprites d'une page à la suivante très facilement. Pour des opérations de copie plus complexe servez-vous de CUT SPR et GLU SPR. Seules les zones mémoire situées entre &0 et &1FFF, &4000 et &7FFF, et &9000 et &A600 ne sont pas écrasées par le programme. Toutes les banks et les autres zones de RAM centrale sont utilisées pour cette version beta. Dans la version définitive seule la zone entre &0 et &1FFF dévait etre laissée libre aux applications de l'utilisateur. EVOLUTIONS PREVUES : -------------------- - Implémentation du menu de controle général (activé par COPY), celui est prévu pour gérer : - le chargement et la sauvegarde des sprites, tables de positions, tables de zooms et palette sur disque, - l'importation de fichiers .SCR, .WIN ou .PAL d'OCP, - la gestion des objets (amalgame de plusieurs sprites), - le réglage des paramètres du logiciel (choix du périphérique d'entrée (joypad ou souris) et réglage de la sensibilité. La plupart des routines nécessaires sont déjà incluses dans le logiciel mais ne sont pas accessibles du fait de l'absence de ce menu. - Réécriture du code de gestion du pointeur en mode "souris" pour avoir une meilleure sensibilité (utilisation d'une interruption DMA plutot que des interruptions raster) ________________________________________________________________________________ Cette doc n'est en aucune façon une notice de H.S.D. mais simplement un récapitulatif des options pour vous permettre d'utiliser cette version démo. Si vous constatez des bugs ou que des options importantes manquent n'hésitez pas à m'écrire car la version finale n'est pas encore tout à fait bouclée : RIMAURO Philippe 1, avenue Saint Donatien 06600 ANTIBES ________________________________________________________________________________