* Ghoul's Writer 1.0 * Tom et Jerry of GPA (c) 1994 * Ce programme est un shareware !! * I Presentation Ghoul's Writer est un ensemble de programmes qui permettent de genener SANS PROGRAMMATION des presentations sous forme de fichiers executables. Vous pou- vez grace a G.W. envoyer des 'lettres informatiques' a vos amis, rediger des articles pour des fanzines, etc... Par rapport aux programmes existants plus ou moins similaires (Ghost writer de MTI, Kangaroo's letter creator), G.W pro- pose des options qui permettent de personnaliser presque a l'infini une pre- sentation en integrant vos propres graphismes, musiques, effets d'animation ! Chaque fichier executable cree avec G.W. est un assemblage de plusieurs fi- chiers de donnees : * Une musique au format Soundtrakker * Une fonte de caracteres au format TAOCP Art Studio * Un texte * un logo * une table d'effacement de l'ecran * une routine d'animation (pour les presentations en mode 1) Il est possible de parametrer d'autres fonctions, au niveau du programme de liaison des fichiers (le Linker). * mode graphique du texte (mode 1 ou 2) * mode graphique du logo (mode 0 ou 1) * couleurs des differents elements de la presentation * affichage d'un curseur * vitesse d'affichage du texte si le curseur est selectionne * affichage du message 'Press space to continue' a la fin d'une page Ghoul's writer se compose de plusieurs utilitaires : * un editeur de texte tres simple, permettant de creer des fichiers texte au format Ghoul's Writer. * un generateur de fichier executable * un relogeur de musiques Soundtrakker * un createur de logos * un createur de fichiers .FNT a partir de fontes Basic Chacun de ces programmes fait l'objet d'un paragraphe dans cette documentation. Les adeptes de l'assembleur trouveront en fin de notice le format de tous les fichiers parametres de Ghoul's Writer. Ils pourront ainsi creer leurs propres animations ou tables d'effacement. Les utilisateurs presses de voir ce que peut faire Ghoul's Writer peuvent lancer le fichier -GWDEMO.BIN. II GWEDIT, l'editeur de texte Lors de la programmation de G.W s'est pose le probleme de la structure du tex- te. Apres avoir etudie les formats generes par certains traitements de texte ou editeurs existants, j'ai decide de creer un editeur pour G.W, GWedit. Pro- gramme rapidement, il ne peut pretendre egaler les meilleures productions sur CPC. 1) Les commandes de GWEDIT Commandes du menu general : (N)ew text : saisie d'un nouveau texte. Si un ancien texte est present en memoire, il est efface. La selection du mode de travail du texte (mode 1 ou 2) se fai t uniquement sur cette com- mande. (E)dit : edition du texte existant. (H)elp : liste des commandes de l'editeur. (T)ab : choix de l'espacement entre deux tabulations (O)pen : chargement d'un fichier Texte au format G.W. (S)ave : sauvegarde d'un fichier Texte au format G.W. (C)onvert : conversion puis sauvegarde d'un fichier Compresse au format G.W. C'est ce format qui est utilise par le Linker de G.W. Attention ! La conversion d'un texte efface le fichier Texte present en memoire. (F)ilename : saisie du nom du fichier de travail. Un fichier doit obli- gatoirement etre nomme avant sa sauvegarde ou sa conversion en fichier Texte Compresse. (D)ir : catalogue d'une disquette (seuls les fichiers Texte G.W. sont affiches). (A): : selection du lecteur A: comme lecteur de travail. (B): : selection du lecteur B: comme lecteur de travail. Commandes de l'editeur : (ESC) : retour au menu general (RETURN) : passage a la ligne suivante (COPY) : Insertion d'un caractere sur une ligne (DEL) & (CLR) : Effacement d'un caractere sur une ligne (TAB) : deplacement du curseur de X caracteres (SHIFT) + (RIGHT) : Insertion d'un caractere sur tout le texte (SHIFT) + (LEFT) : Effacement d'un caractere sur tout le texte (SHIFT) + (UP) : Effacement d'une ligne (SHIFT) + (DOWN) : Insertion d'une ligne (CTRL) + (LEFT) : Page precedente (CTRL) + (RIGHT) : Page suivante (CURSOR KEYS) : deplacement du curseur (F0) a (F9) : affiche un caractere special 2) Remarques generales : Gwedit permet de gerer des texte de 19 pages en mode 2 ou 38 pages en mode 1. Deux 'formats' de texte sont utilises par GWedit : * le format Texte (extension .GWT) : Ce format ne comporte aucun caractere de controle, mis a part le 1er octet du texte, qui sert a determiner son mode d'affichage (mode 1, 37 colonnes ou mode 2, 78 colonnes). Cette extreme simplicite permet de se servir de ce format pour taper un texte destine a un scrolling. * le format Texte Compresse (extension .GWC) Obtenu a partir d'un fichier au format Texte, ce format gere plusieurs caracteres de controle. C'est ce format qui est utilise par le linker de G.W. Attention ! GWEDIT ne peut relire des textes compresses. Sauvegardez donc votre texte avant de faire une conversion. Pour egayer un peu les textes de G.W, il est possible d'utiliser des carac- teres speciaux. Ceux-ci sont au nombre de 10. Ils peuvent eventuellement e- tre redefinis en utilisant un fichier personnel a la place du fichier MORE-CHR.DAT dans le loader -GWEDIT.BAS. Le fichier ACCENTS.DAT vous per- met par exemple d'utiliser dans vos textes des accents circonflexes et des tremas. Ces fichiers ne definissant que dix caracteres sont en fait des fichiers .FNT tronques (longueur = 80 octets). Il est egalement possible de changer la fonte de travail au niveau de GWEDIT en modifiant le loader -GWEDIT.BAS. Par defaut, la fonte systeme anglaise est utilise (fichier SYS-UK.FNT). Les utilisateurs francais pour- ront retrouver leurs chers accents en mettant a la place le fichier SYS-FR.FNT. II GWlink, le generateur de fichier executable. Ce programme a l'esthetique austere est le point central de G.W. Il permet de charger les differents fichiers composant une presentation, de personnaliser son aspect graphique, et de sauvegarder un fichier executable. 1) les commandes de GWlink. A) choix des fichiers de travail Les commandes ci-dessous permettent de definir quel type de fichier on souhaite charger en memoire. Les commandes (D)ir et (O)pen sont direc- tement conditionnees par la selection en cours. (T)ext file : fichier Texte Compresse sous GWedit (F)ont file : ... (L)ogo file : ... (M)usic file : ... (1)st Fx file : fichier d'effacement de l'ecran (2)nd fx file : fichier d'animation B) commandes diverses (D)ir : catalogue de la disquette (seuls les fichiers du type de fichiers en cours sont affiches). (O)pen file : chargement d'un fichier parametre. Pour chaque type de fichier, un controle de validite est effectue (adresse de depart du fichier, longueur, etc.. ). (S)ave intro : sauvegarde de la presentation. Elle n'est possible que quand tout les fichiers parametres composant une pre- sentation sont charges en memoire. (C)onfig : configuration de la presentation. les touches (haut) et (bas) permettent de se deplacer dans la liste des para- metres, (droite) et (gauche) modifient leurs valeurs, (ESC) permet de revenir au menu. (V)iew intro : visualisation de la presentation . La touche (ESC) per- met de revenir au menu. Cette option ne fonctionne que quand tous les elements d'une presentation sont charges en memoire. A noter que pour une presentation en mode 2, la presence d'un fichier d'animation (.GWX) n'est pas necessaire. Les noms des fichiers charges en memoire sont affiches avant le lancement de l'introduction. (A): : lecteur A: actif (B): : lecteur B: actif 2) Remarques generales. Dans l'ecran de configuration, la fonction 'Text speed' n'est active que lorsque l'affichage du curseur n'est pas selectionne. Cette option per- met de multiplier par deux la vitesse d'affichage du texte, ce qui peut etre tres utile quand vous utilisez le mode 2 pour ecrire vos messages. Lorsque GWLINK fait la sauvegarde d'une presentation, celle-ci prend sur la disquette entre 17 et 36ko, en fonction de la longueur de son texte. Pour faire chuter fortement sa taille, utiliser un compacteur. Je me sers personnellement de deux compacteurs : * Cheese de Antoine Pitrou : rapide, efficace. Attention ! La version 1.0 de cet utilitaire empiete sur une zone de la RAM reservee au systeme (= plantage avec loader Basic). Les options de parametrage de la version 1.1 permettent d'oublier ce desagrement. * Cruncher de Crown of Beng! : compacteur tres lent mais efficace. Lui permet de creer des intros fonctionnant a partir d'un chargeur Basic et lui 'rendant la main'. Suivant la taille des differents elements composant votre presentation, vous obtiendrez un fichier dont la longueur varie entre 8ko et 12ko. Lorsque vous sauvegardez une presentation Ghoul's Writer, le programme genere aura les caracteristiques suivantes : * Adresse d'implantation : variable * Adresse d'execution : &9000 * Lonugueur : variable Cette presentation peut parfaitement etre chargee et executee a partir d'un loader Basic, ce qui permet de l'utiliser facilement dans un fan- zine. Vous pouvez limiter la taille d'une presentation en ne chargeant pas de musique, de logo ou d'animation. Pour ceci, il existe trois fichiers sur la disquette de G.W : NO-MUSIC.MUS NO-LOGO .GWL NO-FX2 .GWX Leurs noms sont assez explicites ! IV GWLOGO, programme de creation de logo Ce programme, ecrit en majorite en Basic, est tres simple d'utilisation. Il permet de creer un fichier Logo utilisable par GWLINK a partir d'un fichier ecran standard 17ko. GWlogo vous demande juste le nom du fichier cran a char- ger, puis le nom du fichier Logo. Le dessin sur le fichier ecran doit se trouver en haut a gauche de l'ecran, et etre centre sur la hauteur et la lar- geur suivantes : - Hauteur : 6 caracteres ( = 48 lignes video) - Largeur : 37 caracteres ( = 74 octets) Afin de vous eviter une crise de nerfs lors du centrage de vos superbes logos, lancez le fichier -GWFRAME.BAS. Ce programme va creer un fichier ecran 17ko a- vec un cadre. La zone a l'interieur de ce cadre correspond a la surface d'un logo. Pour que les utilisateurs non ferus de graphisme puissent quand meme egayer leurs presentations, G.W contient une petite 'bibliotheque' de dessins en mode 1, contenue dans le fichier ecran GW-CLIP.SCR. V GWFONT, programme de recuperation de fontes Basic. Ce tout petit programme Basic permet de convertir une fonte de caracteres de la memoire du CPC en un fichier .FNT compatible OCP Art Studio. L'on peut ainsi utiliser des fontes redefinies par des commandes SYMBOL dans Ghoul's Writer. UI GW-ST, relogeur de musiques Soundtrakker. Un des utilitaires les plus pratique de G.W. Il s'agit tout simplement d'un programme permettant de modifier les adresse d'implantation et d'execution d'une musique Soundtrakker. L'on peut ainsi utiliser les musiques composees avec ce remarquable utilitaire dans Ghoul's Writer. A noter que GW-ST ne reloge pas les musiques utilisant le module ST-128. Ce format de fichier different du format S.T, ne se retrouve que dans les musi- ques les plus recentes de Kangaroo, celebre 'compositeur' sur CPC. Attention ! Ce programme ayant ete realise sans que je connaisse toutes les subtilites du format Soundtrakker, certaines musiques pourront ne pas etre bien relogees. J'ai fait des essais sur une bonne quinzaine de titres pro- venant de demos sans probleme. VII Le format des fichiers parametres de Ghoul's Writer Cette section est reservee aux utilisateurs ne souhaitant pas se contenter des fichiers parametres livres avec Ghoul's Writer, et utiliser leurs propres oeu- vres. Fichier .MUS : musique Ce fichier doit avoir ete cree avec le Soundtrakker de BSC ou un autre logiciel ayant un 'player' suffisamment rapide. Il doit de plus se conformer aux criteres suivants : * Adresse d'implantation : &6000 * Adresse d'initialisation : &6000 * Adresse d'execution : &6003 * Longueur maximale : &1D00 Fichier .FNT : fonte compatible TAOCP art Studio Dans ce format de fonte , un caractere est code sur 8 octets, organises du 'haut' vers le 'bas' (comme une fonte en mode 2). Chaque fichier .FNT contient les redefinitions des caracteres ASCII 32 a 127. * Longueur d'un fichier .FNT : &300 Fichier .GWL : logo Fichier cree avec le programme -GWLOGO.BAS. Il s'agit d'un simple sprite. * Adresse de chargement : &7E00 * Longueur : &0DE0 Fichier .GWE : table d'effacement de l'ecran texte. Ce fichier se compose de 145 octets. Chaque octet represente une des 144 lignes de l'ecran texte. Le dernier octet est un code de fin. Sa valeur est 255. Ce format permet de generer tres simplement des effets varies d'effacement. * Longueur d'un fichier .GWE : &91 Fichier .GWX : animation Ce fichier est en fait une routine qui realise un effet gra- phique en arriere-plan du texte (uniquement pour un texte en mode 1). Cette routine doit repondre a plusieurs criteres : * adresse d'implantation : &9600 * adresse d'inialisation : &9600 * adresse d'execution : &9603 * adresse d'arret : &9606 * longueur maximale : &0A00 La routine ne doit pas prendre trop de temps machine (maximum 1 HALT). Une seule encre est disponible afin de ne pas polluer le texte, l'encre numero 2 (bits &F0,&40,&20,&10). La zone video de travail delimitant l'ecran ou est affiche le texte se situe entre &C206 et &FC9F, fait 76 octets de large et comporte 144 lignes. L'adresse d'initialisation permet de lancer une routine lors du demarrage de la presentation. Cela permet par exemple de creer une table de coordonnees utilisee par un starfield. L'adresse d'arret n'est utile que pour des animations utilisant les sprites hard du cpc +. Pour des raisons de compatibilite, il est OBLIGATOIRE de l'utiliser. VII Commentaires sur Ghoul's Writer L'idee de la creation de ce programme m'est venue lorsque j'ai recu le Letter's creator de Kangaroo. Je me servais depuis pas mal de temps de fichiers textes pour correspondre avec mes amis possesseurs de CPC. J'ai apprecie le travail de Kangaroo mais me suis dit qu'il etait possible de faire mieux. Les idees venant avec la programmation, le concept de G.W. s'est considerablement enrichi, au point de devenir un veritable kit de creation de presentation de textes. On pourra me reprocher la programmation relativement timide du corps de G.W, ( pas d'overscan, de ruptures ni de scrolling hard), mais j'ai voulu faire un programme compatible avec tous les cpc, tournant sur les cpc 464 (64ko de RAM), utilisable a partir du Basic et ne touchant pas aux zone de RAM reservees au systeme. Cela a forcement conduit a quelques limitations. Les utilitaires de Ghoul's Writer ont tous des textes en anglais. Comme ce pro- gramme est destine a etre diffuse dans toute l'Europe (si ce n'est la planete entiere !), il est normal d'utiliser ce langage, meme si cela chagrine les adeptes de la langue de Moliere (Hello Robert !). Tous les fichiers parametres (musiques, animations, clip-art) sont des crea- tions personnelles. Vous pouvez evidemment les utiliser librement, mais cela serait sympa d'indiquer leur provenance quand vous les reprenez dans vos pro- pres programmes (je pense notamment aux musiques). A noter que les themes SILVERMA.MUS et YESOD.MUS sont des adaptations tres li- bres de deux musiques de jeux : - Ken's labyrinth 3d (PC) de Ken Silverman ! - Nodes of Yesod (CPC) de Odin software. Ghoul's Writer est un programme SHAREWARE. Vous pouvez donc le copier et le diffuser aupres de vos amis sous sa forme originale (ne rajoutez pas ou l'en- levez pas de fichiers sur la face de disquette que prend le logiciel). Si vous utilisez regulierement Ghoul's Writer, vous avec le devoir moral d'ac- quitter une petite contribution volontaire. Ce droit d'utilisation est modeste. * 30 Francs francais (timbres, billet, cheque, pieces) * 6 U.S dollars * 10 Deutschmarks * 3 Livres anglaises Je me me fais pas trop d'illusion sur les retombees financieres de G.W. Sept personnes seulement m'ont repondu pour Multi Mark ! Mais ce n'est pas une raison pour ne pas payer, n'est ce pas ! Par rapport a Multi Mark, les tarifs ont augmente. Cela correspond a la charge de travail que m'a impose G.W (il est assez difficile de remplir une face de disquette avec des fichiers de parametres n'excedant pas quelques Ko !). Vous avez des problemes, des questions ? Vous voulez me faire parvenir vos fi- chiers parametres pour une eventuelle compilation de routines et graphismes ? Vous voulez regler votre contribution volontaire ? Ecrivez moi ! Monchatre Herve College, 1 rue des ormes 45320 Courtenay France Une petite anecdote pour terminer. A votre avis, d'ou vient le nom de ce pro- gramme ? C'est un clin d'oeil au Ghost Writer de MTI et a un jeu CPC sorti chez U.S.Gold vers 1989, Ghoul's'n'Ghost ! Soundtrakker (c) New Age Software The Advanced OCP art Studio (c) Rainbird

* Ghoul's Writer 1.0 * Tom et Jerry of GPA (c) 1994 * This program is SHAREWARE !! * I Introducing Ghoul's Writer Ghoul's Writer is a utility compilation which allows you to create little self-executable introductions without ANT PROGRAMMING. With G.W. , you can send 'computer letters' to your friends, make articles for disk fanzines, etc... Compared to other writers (Ghost writer de MTI, Kangaroo's letter creator), G.W includes many options to give a personal touch to your intros (you can use your own musics, graphics, etc.. ). Each intro file built with G.W. is a assembling of data files : * a Soundtrakker music * an OCP art studio format charset * a Text typed with GWEDIT * a Logo * a clearscreen method * an animation (only for Mode 1 text) When intro files are loaded in the Link program, you can also change other parameters. * logo mode (1 ou 2) * colors of logo, of charset, etc.. * cursor printing * text printing speed * message 'Press space to continue' in the back of the screen Let's see what the utilities of G.W are ! * an easy to use text editor, which makes Ghoul's Writer text files * a linker which creates the intro file * a Soundtrakker's music relocator * a logo file maker * a .FNT charset file maker with Basic fonts All these utilities will be described in this user's manual. Z80 coders will find some words about datafiles structures at the end of the text. They could make their own libraries of musics, logos, etc... Run the file -GWDEMO.BIN just to see what we can do in two minutes with G.W ! II GWEDIT, the text editor When I was coding Ghoul's Writer, I faced a problem : Should G.W. use texts typed with word processors or with a special editor ? As there are many word processors on CPC (Protext, Semword, Amsword, etc... ), I finally decided to write my own text editor. It is not a great piece of software, but it has the usual basic functions to type a text easily. 1) GWEDIT commands Main menu commands : (N)ew text : Create a new text. If an old one is in memory, it will be erased. When you start a new text, you must choose its display mode (mode 1 or 2). (E)dit : edit text in memory. (H)elp : list of editor's commands. (T)ab : Select number of blanks between two tabulations. (O)pen : Load a text typed with GWEDIT (only .GWT format). (S)ave : save a .GWT format text. (C)onvert : convert and save a Compressed file (.GWC format). Only this kind of file can be used with the linker. Warning ! Convert command deletes text in memory. (F)ilename : Give a name to the default text (new text or text loaded from disk). You must name a text before saving or conver- ting it. (D)ir : diskette directory (only .GWT files are printed on screen). (A): : select A: drive as working drive. (B): : select B: drive as working drive. Editor's commands : (ESC) : go to main menu. (RETURN) : cursor goes to the beginning of next line. (COPY) : Insert a char on a line. (DEL) & (CLR) : Delete a char on a line. (TAB) : move cursor from X chars. (SHIFT) + (LEFT) : Insert a char in the text. (SHIFT) + (RIGHT) : Delete a char in the text. (SHIFT) + (UP) : Erase a line. (SHIFT) + (DOWN) : Insert a blank line. (CTRL) + (LEFT) : Previous page. (CTRL) + (RIGHT) : Next page. (CURSOR KEYS) : move cursor. (F0) a (F9) : print a special char (129 to 139). 2) GWEDIT informations : Gwedit can produce texts of 19 pages in mode 2 or 38 pages in mode 1. Two text structures are used in GWEDIT : * Text format (.GWT extension) : This text structure doesn't use any control char. Only the first byte of the text has a special meaning : its mode (mode 1, 37 columns or mode 2, 78 columns). Each blank is coded with the ASCII char 32. You may now understand why .GWT text are so long. Why such a simple struc- ture ? To use GWEDIT as a scrolltext writer (great for typing text of demos !). * Compressed format (.GWC extension) : Based on a .GWT text format, this structure contains some control chars to shorten it. Warning ! GWEDIT can't read this kind of text. So, make a Text format copy of your text before converting it ! To brighten up a text, it is possible to given out special chars, with the keys F0 to F9. Eventualy, you can design your own chars, changing the file MORE-CHAR.DAT by another one in the Editor's and Linker's Basic loaders. File 'MORE-CHAR.DAT' is just a cut .FNT file, which contains ten chars (length = 80 bytes). You can also modify working charset file of GWEDIT, changing the default file 'SYS-UK.FNT'. French users could find their beloved accents with the file SYS-FR.FNT. III GWLINK, the intro compiler This program is used to load and verify datafiles to compose an introduction, define its colors and save a self-executable intro. 1) GWLINK commands A) How to choose a datafile pattern By pressing one of the following keys, you select a pattern of datafile. Thus, commands (D)ir and (O)pen consider this kind of file as default file type. (T)ext file : Compressed text (F)ont file : ... (L)ogo file : ... (M)usic file : ... (1)st Fx file : clearscreen method (2)nd fx file : animation file B) main commands (D)ir : diskette directory. (O)pen file : load a datafile. Before putting it in memory, some tests are done to control file structure (loading address, length, Entry) (S)ave intro : save introduction (all datafile must have been put in memory). (C)onfig : configure introduction. (UP) and (DOWN) arrows to choo- se a parameter line, (LEFT) and (RIGHT) arrows to change its value. To come back to the main menu, press (ESC). (V)iew intro : display loaded datafile names and run the introduction. If a parameter file is missing, the intro will not start. Note that for an intro with text in mode two, you you don't have to load an animation datafile. (A): : drive A: is active (B): : drive B: is active 2) GWLINK tips & tricks In the configuration screen, 'Text speed' function is disabled when the cursor is selected. When active, this option doubles the speed of char display. This is really interesting when you write messages in mode 2. When you save an intro, the file created will have these characters : * loading address : changeable * Entry : &9000 * Length : changeable This intro can be loaded in memory and launched with a Basic loader, so it is really easy to use it in a disk fanzine. GWLINK needs 18 to 36 ko to save an introduction on a disk. To shorten the length of an intro, you can crunch it with one of these excellent utilities : * Cheese of Antoine Pitrou (COD!) : fast and good cruncher. Unfortu- nately, Cheese 1.0 needs some memory space used by Basic. So, you you can't start an intro crunched with this utility under Basic. Try to find the 1.1 release which is perfect for G.W ! * Cruncher of Crown (BENG!) : SLOW but great program ! Intros crun- ched with Cruncher can be loaded under Basic without any problem. You will obtain a new file whose length will be between 8 and 12 ko. If you really want to save space on disk, you can shorten an intro length. Just don't use a music, a logo or an animation in your intro ! To do such a thing, put one of the following files in memory. NO-MUSIC.MUS NO-LOGO .GWL NO-FX2 .GWX IV GWLOGO, the Logo maker This program, written in Basic, is really easy to use. With a 17ko standard screen, it allows you to create a logo file (.GWL extension). You just have to give the name of the picture and the name of the logo file ! Of course, your future logo must be on a particular place : in the left hand top cor- of the standard screen, and centered on the following height and width : - Height : 6 chars ( = 48 video lines) - Width : 37 chars ( = 74 bytes) Don't panic ! I have made another little program which draws a frame in a picture and saves it as a standard screen file. The area inside the frame is the size of a logo. This magical program is named -GWFRAME.BAS ! If you are not a great graphist, you can however make funny logos. G.W. includes a little clipart library. Load the file GW-CLIP.SCR with your best painting program and make your choice ! V GWFONT, Basic charset to .FNT file maker This program concerns only people who design charsets under Basic with the SYMBOL command. Owing to GWFONT, we can convert these charsets in .FNT datafiles ! Another friendly program : just put your charset in memory and start -GWFONT.BAS ! UI GW-ST, Soundtrakker's compiled musics relocator GW-ST is one of the more practical program of G.W. Thanks to it, you can change the loading and entry addresses of a Soundtrakker's compiled music. So, in Ghoul's Writer, you can use musics coming from many demos or music compilations. Please note that GW-ST doens't work with ST-128 music player. I have found this new (?) Soundtrakker's music structure in the last musics composed by the famous Kangaroo of TGS! only. Warning ! As I have coded this program without any documentation about S.T. music structure, some tunes might not work with GW-ST. I have made tests on some music from demos, it's ok. Wait and see... VII Informations about Ghoul's Writer datafiles In this part, you will find informations about each kind of parameters files used by Ghoul's Writer. .MUS file : music This file had to be created with the BSC's Soundtrakker, or ano- ther music program with a fast music player... * loading address : &6000 * init address : &6000 * entry : &6003 * maximum length : &1D00 .FNT file : TAOCP art Studio charset In this charset structure, a char is coded on 8 bytes (like a mode 2 char, up to down). A '.FNT' file contains datas for the ASCII chars 32 to 127. * .FNT file length : &0300 .GWL file : logo File created with -GWLOGO.BAS. It is just a big sprite ! * .GWL file Length : &0DE0 .GWE file : clearscreen method That file is made of 145 bytes. Each byte represents one of the 145 lines of the text screen to delete. Last byte is an end control code. Its value is always 255 (&FF in hexa). * .GWE file length : &0091 .GWX file : animation A .GWX file is just a little routine doing a graphical effect behind the text (only for a mode 1 message). * loading address : &9600 * init address : &9600 * exec address : &9603 * end address : &9606 * maximum length : &0A00 The routine must not be too slow (maximum, 1 HALT). Only one ink is available, to preserve text chars (ink 2, bits 7,6,5,4). The textscreen is located between &C206 and &FC9F. There are 144 lines of 76 bytes. The init adress is useful when, for example, you want to create a co-ordinates table for a starfield in memory. The end adress is only interesting when you want to display hard sprites on your cpc plus to make an animation. For compatibility reasons, you must declare it in every routine. Why a .GWE maximum length is &A00 ? Just to save space in RAM for a crunch routine and for Basic datas. VII Author's words about Ghoul's Writer I had the idea to code G.W. when I received the Kangaroo's Letter creator. For a long time, I used text files to correspond with cpc users. I liked Kangaroo's work, but I said to myself 'We can do better.' . So I have decided to make a more powerful writer, Ghoul's Writer ! Some people may say that the intro coding is not great (no overscan, no hard scroll, etc... ). Well, in fact, I wanted to make a software which was fully compatible with all kind of cpc and crtc, which we could run under Basic. It limited the way of programming the introduction basic routines. All datafiles (musics, animations, clip-arts) are personal creations. You are authorized to use them freely. It would be nice to tell where they come from if you take them for your own pieces of software. Themis SILVERMA.MUS and YESOD.MUS are based on two game musics (but are pure Soundtrakker's tunes !) : - Ken's labyrinth 3d (PC) from Ken Silverman ! - Nodes of Yesod (CPC) from Odin software. Ghoul's Writer is a SHAREWARE PROGRAM. You can copy it freely to your friends, dispatch it in fanzines or in Public Domain compilation. But, you do not modify programs or datafiles. If you are a regular user of Ghoul's Writer, you have to pay a little bill and become a registered user : * 30 french francs (timbres, billet, cheque, pieces) * 6 U.S dollars (banknote only) * 10 Deutschmarks (banknote only !) * 3 pounds (banknote or coins) I still don't make empty dreams about the financal incomes of G.W. Only seven cpc users have registered for Multi Mark 1.0. That's not a reson for not doing it, ok ? Registration tariffs are higher than Multi Mark ones. Why ? Only be- cause G.W takes a very long time to realize it. Making a lot of datafiles is really difficult, you know ! You want to contact me to register, to talk about problems or bugs (I hope not) or just to send your musics or clip-arts for a Ghoul's Writer data disk ? Write to : Monchatre Herve College, 1 rue des ormes 45320 Courtenay France One little anecdote to finish. Do you know where the name of this writer co- mes from ? It's a play on words based on two cpc programs names : the Ghost Writer of MTI and an old CPC game published by U.S.Gold, Ghoul's'n'ghosts. Soundtrakker (c) New age Software The Advanced OCP Art Studio (c) Rainbird