@DATABASE "MagicBoard"
@AUTHOR "Salah Daniël"
@(C) "1996"
@$VER: MagicBoard 1.0

@NODE MAIN "MagicBoard Manual"

                           @{b}MagicBoard@{ub}
  
                             Version 1.0 

                    Un simple programme pour créer des circuits imprimé .

                  © Copyright 1996-97 by Salah Daniël	@{" ADRESSE " LINK ADRESSE}


 @{" HELP ME " LINK HELP_ME}


 @{" Requirement          " LINK Materail}  Materiel
 @{" Instalation          " LINK Install}  Install

 @{" Introduction         " LINK Introduction}  Qu'est-ce qu'est MagicBoard ?
 @{" Command              " LINK Command}  Liste des diférentes commande

 @{" History              " LINK History} Programme Information
 @{" Bug report           " LINK Bug_report} Restriction et erreur connue




@ENDNODE




@NODE HELP_ME "HELP_ME"


                             @{b}MagicBoard@{ub}		 
                               Version 1.0

	- Pour moi , et pour vous , il est de votre DEVOIR de me faire parvenir vos critiques ,
	  vos suggestions , ainsi qu'un rapport sur un ou certainement plusieurs bug de ce 
	  programme.


	- TOUTES SUGESTION , CRITIQUE , SONT ATTENDUENT AVEC IMPATIENCE.


	- Developpeur: @{" ADRESSE " LINK ADRESSE}

@ENDNODE

@NODE Materail "Material"



                             @{b}MagicBoard@{ub}		 @{" HELP ME " LINK HELP_ME}
                               Version 1.0




	- Ce programme à été écrit , et tourne sur A4000-60 50 Mhz , cyber64 , 54 Meg OS 3.0.
	

	- Il faut obligatoirement avoir 8 Meg de Fast Memory


	- Au niveau sofware , @{b}MagicBoard@{ub} n'utilise pas de library personel en LIBS: ,
	  la seule obligation c'est l'assignation "MagicBoard:","MagicSchematic:","MagicNet:" ,
	  ainssi que la copie des fonts magicBNS.font dans le répertoire FONTS: .
	  Les programme MagicBoard,MagicNet,MagicSchematic utilise la reqtools.library ,ainsi que
	  amigaguide.library.

	-@{b}Si vous avez des plantages à l'ouverture des fenêtres@{ub} , détruisez le fichier
	 "MagicBoard:@{b}Préférence.MN (ou .MB .MS car valable pour les programmes MagicNet et MagicSchématic)@{ub}" ,
	   dès lors , un requestre apparaîtra au démarrage du programme.


@ENDNODE

@NODE Install "Procédure d'installation"



                             @{b}MagicBoard@{ub}		 @{" HELP ME " LINK HELP_ME}		 @{" HELP ME " LINK HELP_ME}
                               Version 1.0




	- Ce programme est archivé dans un directory contenant les programmes. Pour installer le
	  programme , il faut faire démarrer le programme "Install MagicBoard".






@ENDNODE


















@NODE Bug_report "Report Bug"



                             @{b}MagicBoard@{ub}		 @{" HELP ME " LINK HELP_ME}		 @{" HELP ME " LINK HELP_ME}
                               Version 1.0




	- ROUTE
		CREATION :-Lorsque vous avez crée une route ne comportant que deux points horizontaux,
			   il peut arriver que le programme s'imagine que cette droite est infinie.

	- LIBRARY
		-@{b}NE PAS SAUVER UN DEVICE AVEC UN NOM DEJA EXISTANT !!!!!!!!!!!!!@{ub}

		-Lorsque ont lit un ancien projet , les numéros des devices ne sont pas listés dans 
		la mémoire interne

20/04/97- Plantage quand: Mode lib/créer pad/save_lib/delete n'importe quoi/CANCEL/ puis QUIT

@ENDNODE




























@NODE Introduction "Introduction"




                             @{b}MagicBoard@{ub}				 @{" HELP ME " LINK HELP_ME}
                               Version 1.0



@{b}MagicBoard@{ub} est un simple programme pour la création de circuit imprimer.

	-Utilisation de library .
	-2 layers pour les pistes , v 1.0 (4 layers sont prévu ) .
	-différentes formes pour les pads.
	-dessine des lignes , box , textes , triangles .
	-imprime les boards 

	-Un autorouter est prévu , lorsque le programme MagicSchématic sera terminé.


De plus, vous trouverez dans le packtage deux autres programmes ,@{b}MagicSchematic@{ub} utilisés pour
la création de schéma électronique ,@{b}MagicNet@{ub} pour la création des devices à utiliser conjoinctement
avec @{b}MagicSchematic@{ub}. Ces deux programmes sont inclus à titre de démo , et aussi pour les démos
de @{b}MagicBoard@{ub} .
Ces deux programmes sont loin d'être sans bug@{b}N'utilisez ces deux programmes qu'avec beaucoup de
prudence@{ub}. La même remarque concernant l'ouverture des fenêtres
est applicable , à savoir , si vous avez des gurus , détruisez le fichier "preférence.BN (BS-BB).
Si j'ai le temps ,je finaliserez ces deux programmes comme @{b}MagicBoard@{ub} .   

@ENDNODE

@NODE Command "Command"



                             @{b}MagicBoard@{ub}				 @{" HELP ME " LINK HELP_ME}
                               Version 1.0
 @{b}Menu/Project@{ub}
	 @{b}Load@{ub}	-Nouveau projet.
	 @{b}SaveAs@{ub} -Sauver projet sous ...
	 @{b}Print@{ub}	-Imprime le projet en cours.
	 @{b}About@{ub}	-Info sur le programme.
	 @{b}Quit@{ub}	-Bye-Bye.


 @{b}Preference@{ub}
	 @{b}ModeVideo@{ub}- Vous pouvez sélectionner un autre screen mode via le menu preference/video .
		    Avec a version 1.0 , après avoir choisit le mode graphique , vous devez relancer
		    le programme (Bugs).
		    @{b}Seul les modes 256 couleurs fonctionnent @{ub}.
	 @{b}BakDirector@{ub}- Requester pour indiquer ou et sous quelle forme sont sauvé les backups des projets.
		    L'option "Overwrite", indique que vous écrasez l'ancien backup par le nouveau.
	 @{b}Library@{ub}- Place le programme en Mode Création de device pour les library.
		    (Aucun Project ne doit être ouvert).


 @{b}BUTTON@{ub}


 @{" Place     " LINK Place}  Place device
 @{" Route     " LINK Route}  Route
 @{" Library   " LINK Library}  Library
 @{" Draw      " LINK DRAW}  Drawing routine

@ENDNODE


@NODE Place "Place"



                             @{b}MagicBoard@{ub}				 @{" HELP ME " LINK HELP_ME}
                               Version 1.0



	- Le gadget @{b}PLACE@{ub} permet de placer les "pads" sélectionnés par le gadget @{b}S@{ub}

	- Le gadget @{b}S@{ub} permet de sélectionner un pad via la fenêtre "PAD WINDOW". Le flag "Copy"
		permet de sélectionné un type de pad de la LIST1 pour l'appliquer dans la LIST2. En effet ,
		vou pouvez juger que les dimensions standar des pins sont soit trop petites ou trops grandes .    

		Example:- Mettre Copy sur on
			- select LIST1 => RECT 1.65x2.90
			- select LIST2 => SINGLE in LINE 7
			- Si vous voulez attribuer un nom à ce device choisissez dans NAME le nom
			- OK

	- Une fois le type de device selectionné , vous pouvez le "placer".

	  Pendant que vous placer ce device à l'endroit désiré , vous pouvez actionner diverses touches:
		- "Space" : Le device pivotera à chaque fois de 90°.
		  "Q"	  : Place l'indicateur quart sur on/off.
		  "H"	  : Place l'indicateur huit sur on/off.
		  "S"	  : Place l'indicateur snap sur grid on/off.
		  "C"	  : Centre le project.
		  "+"	  : Zoom +.
		  "-"	  : Zoom -.
 		  "R"	  : Place l'indicateur ruller sur on/off.
 		  "U I O P L M R"	  : Mofifie les dimension du pad.
		  "ESC"	  : Quit la séquence et retourne au menu principal.
		  "RMB"	  : EFFACE UN DEVICE DEJA CREE.(La souris détermine le device)
		  "HELP"  : No Comment
		  "UP DOWN RIGHT LEFT" : Déplace la fenêtre.

	- A chaque fois que vous placez un device avec un nom , il y a apparition d'un requester
	  permetant de désigner manuellement le numéro de ce device.


	- @{b}GLOBAL{ub}
		- @{b}MOVE@{ub} pour déplacer un pad . Soit vous sélectionnez le pad via la souris,
			soit vous tapez la touche @{b}L@{ub} , dès lors , un listview apparaît , où vous
		  	pouvez directement via le nom et le numéro , s'électionner le device à déplacer.
		- @{b}EXCHANGE@{ub} permet d'échanger la forme et dimension le pad sélectionné par la
			position de la souris et celui sélectionné dans la list "PAD WINDOW".

 

@ENDNODE

@NODE Route "Route"



                             @{b}MagicBoard@{ub}				 @{" HELP ME " LINK HELP_ME}
                               Version 1.0



	- Le gadget "S" (SET) permet de sélectionner le layer ainsi que les dimensions.

	- lorsque vous sélectionner "S" (SET) , une fenêtre s'ouvre :

		- La listview "WIDTH" permet d'attibuer une épaisseur.
		- La listview "WIDTH_VIA" permet d'attibuer un pad au via.
		- Le gadget "Solder","Component" permet de sélectionner le layer de travail. 
		- Le gadget "Show Pin" permet de voir afficher dans la barre des coordonnées
		  le numéro de la pin du device situé au point de la souris.

	- Une fois le type de route selectionné , vous pouvez sélectionner "ROUTE".

	  mode	:Vous créer des routes en "attachant les device à ces route". (Sera utilisé
		 avec le programme MagicSchematic , netlist).Le "linkage" est actuellement
		 théorique. Si le programme ne trouve pas de pad ou de route à l'endroit où
		 vous cliquez , il y a création d'un beep .


		- "Space" : fonctionne mais ne sert à rien.
		  "Q"	  : Place l'indicateur quart sur on/off.
		  "S"	  : Place l'indicateur snap sur grid on/off.
 		  "R"	  : Place l'indicateur ruller sur on/off.
		  "H"	  : Place l'indicateur huit sur on/off.
		  "C"	  : Centre le project.
		  "+"	  : Zoom +.
		  "-"	  : Zoom -.
 		  "V"	  : Crée un pad via pendant la création d'une route , ou inverse le layer en cour.
 		  "N"	  : permet de voir afficher dans la barre des coorconné le numéro de la pin du device 
			    situé au coordonnée de la souris.Si le gadget "ShowPin_AUTO" dans le requester
			    "SET ROUTE" est crocheté , alors d'office apparaît le numéro du pin au coordonné
			    de la souris .( " 0 "s'il n'y a rien)
		  "ESC"	  : Quit la séquence et retourne au menu principal.
		  "RMB"	  : efface le dernier trait en cour.
		  "HELP"  : No Comment
		  "UP DOWN RIGHT LEFT" : Déplace la fenêtre.

	- @{b}GLOBAL@{ub}
		- MOVE ROUTE => Déplace une route en entier
		- MOVE POINT => Déplace un point d'une route (Key V change le layer)
		- ERASE ROUTE => Détruit une route en entier
		- ERASE POINT => Détruit un point d'une route @{b}PRUDENCE BUG@{ub}
		- CLONE ROUTE => Clone 
		- CREATE POINT => Crée un point sur une route
		- SET WIDHT => Force la route à prendre la dimension sélectionnée dans LINE WINDOW


@ENDNODE

@NODE Library "Library"


                             @{b}MagicBoard@{ub}		 
                               Version 1.0

	@{b} BUG BUG  ...  NE PAS SAUVER UN DEVICE AVEC UN NOM DEJA EXISTANT !!!!!!!!!!!!!@{ub}
	@{b} BUG BUG  ...  UN DIRECTORY LIBRARY DOIT TOUJOUR AVOIR UN OBJET DANS LE DIRECTOR ,CAR
			SINON LE PROGRAMME PLANTE (RAISON DU "NO DELET MY" DANS LES DIRECTORY)@{ub}



	@{b}Lire ce paragraphe attentivement !@{ub}

	-La création d'un objet en librairie demande de suivre la procédure attentivement.
	 Un objet créé et sauvé dans une librairie devient un DEVICE. Un device est sauvé de la 
	 même manière qu'un projet et vous pouvez lire un device comme un projet . Vous pouvez
	 aussi @{b}écraser un device existant ,  mais pas en créer un autre sous un autre nom
	 excepté en suivant la procédure , save_lib => accept @{ub}. 
	
	@{b}Par la procédure expliqué après , le programme mais à jour le fichier "files" qui ce
	 trouve dans chaque directory contenant les devices@{ub}. @{" STRUCTUR LIBRARY " LINK STRUC_LIB}

	@{b}Si vous désirez augmenter ou diminuer le nombre de directory contenant les devices ,
	 vous devez suivre la procédure ci-après:@{ub}
	-@{b}Creer un nouveau directory :@{ub}
		Par le Workbench , ouvir le directory MagicBoard:Library
		Dupliquer le directory "NEW PCB DRAWER"
		Renomer ce directory ( example : "Personal")

		@{b}CE NOM NE DOIT PAS COMPORTER PLUS DE 20 LETTRES !!!@{ub}


		Ouvrir le directory PCB
		Déplacez ce nouveau directory dans le directory "MagicBoard:Library/PCB"

		Lancez le programme MagicBoard



	- exemple pour ajouter un device dans une library:

	[New] => détruit le project existant (Si nécessaire).

	[MENU / LIBRARY ] => crocheté.Dès lors une partie des gadgets  sont désactivés.

	[SET (Place) ] => choisir une dimension de pad , ex: List1 [ROND=3.16 /H=0.80]
			[OK]

		Placez quatre pads les uns à côté des autres ex: O O O O
		(Le sens à de l'importance puisque le numéro de chaque pad est crée les uns à la suite
		des autres , ici , 1 2 3 4

	[SET (Draw) ] => choisir [BOX]

		entouré les quatre pads par un box ex:  -----------
							| O O O O |
							-----------

	[SAVE] => Choisir [SAVE_LIB]

		
		listview DIRECTORY : indique dans quel répertoire le device va étre sauvé

		listview DEVICE    : indique le nom de tous les device dans le directory sélectionné

		listview NAME      : indique le nom avec lequel le device va être sauvé
				     @{b}choisissez à chaque fois un nom !@{ub} ( pour les condensateurs "C",
				     pour les résistance "R" , pour les microprocesseurs (ex 68040,6502,80335 etc)
				     "CPU" , etc... 

		button NEWFILE	:Si il est checké , le device sera nouveau , et le nom sera celui écrit
				 dans le string gadget FILE

		string FILE	:Le nom du device s'il est sauvé comme nouveau device (NEWFILE crocheté


		button DELETE	:efface un device existant de la liste DEVICE dans le directory DIRECTORY

		button ACCEPT	:sauve un device existant ou non dans la liste DEVICE dans le directory DIRECTORY

		button CANCEL 	:no comment


	Continuons notre exemple.

@{b}CREATION D'UN NOUVEAU DEVICE@{ub}
	
	Dans DIRECTORY list sélectionnez CONNECTOR (MagicBorad:library/PCB/connector/list)

	[NEWFILE] pas crocheté 
		- Dès ce moment vous voyez que les lists DEVICE et NAME deviennent actives

	Dans NAME list choisissez "CN" , pour connecteur

	[NEWFILE] crocheté 
		- Dès ce moment vous voyez que les listes DEVICE et NAME deviennent inactives.

	Dans FILE string , tapez le nom du nouveau device ex: "Mickey  socket lamp train marklin v 2365"

	@{b}[ACCEPT]@{ub}
		Unrequester appparaît pour vous prévenir que vous allez devoir placez la position
		où apparaîtera le numero pour ce device . CLIQUEZ sur le requester

	CLIQUEZ l'emplacement désiré


@{b}REMPLACEMENT D'UN DEVICE EXISTANT@{ub}
	
	Dans DIRECTORY list sélectionnez CONNECTOR (MagicBorad:library/PCB/connector/list)

	[NEWFILE] pas crocheté 
		- Dès ce moment vous voyez que les listes DEVICE et NAME deviennent actives

	Dans NAME list choisissez "CN" , pour connecteur

	Dans DEVICE list choisissez le nom du device à remplacer

	@{b}[ACCEPT]@{ub}
		Unrequester apparaît pour confirmer la destruction de l'ancien device


		Un requester appparaît pour vous prévenir que vous allez devoir placer la position
		où apparaîtera le numero pour ce device . CLIQUEZ sur le requester

	CLIQUEZ l'emplacement désirez


		Le fichier est sauvé en écrasant l'ancien device.


@{b}DETRUIRE UN DEVICE EXISTANT@{ub} 

	@{b}IL FAUT AVOIR CREER AU MOINS UN OBJET DANS LE PROJET EN COURS POUR DETRUIRE UN DEVICE @{ub} 
	
	Dans DIRECTORY list sélectionnez CONNECTOR (MagicBorad:library/IC/connector/list)

	[NEWFILE] pas crocheté 
		- Dès ce moment vous voyez que les lists DEVICE et NAME deviennent actives

	Dans DEVICE list choisissez le nom du device à remplacer
		- Dès ce moment vous voyez que le gadget DELETE devient actif

	@{b}[DELETE]@{ub}
		Unrequester apparait pour confirmer la destruction de l'ancien device


		Le fichier est détruit.


@{b}PLACER UN DEVICE SELECTIONNE@{ub} 

	Dans la fenêtre principale selectionnez @{b} [ LIB-IC ]@{ub}
		Une fenetre apparaît avec des listes contenant les devices.
		@{b}Le nombre de listes dépend du nombre de directory contenu dans le répertoire
		Magicboard:library/PCB , avec UN MAXIMUN DE 10 DIRECTORY @{ub}

	CLICEZ UNE fois sur un device , ex: VLSI (80552) , @{b}Une copie du nom apparaît comme titre
		de la fenêtre @{ub}. si vous cliquez une deuxième fois , le device est selectionné , et vous
		quittez cette fenêtre pour PLACER  ce device dans la fenêtre projet


	Indiquez l'emplacement ou vous voulez placer ce device puis cliquez.

		- Vous avez la possibilité d'utiliser les touches suivantes
		- "Space" : tourne l'objet de 90 °.
		  "Q"	  : Place l'indicateur quart sur on/off.
		  "S"	  : Place l'indicateur snap sur grid on/off.
 		  "R"	  : Place l'indicateur ruller sur on/off.
		  "H"	  : Place l'indicateur huit sur on/off.
		  "C"	  : Centre le projet.
		  "+"	  : Zoom +.
		  "-"	  : Zoom -.
		  "ESC"	  : Quitte la séquence et retourne au menu principal.

@ENDNODE
	



@NODE DRAW "DRAWING MODE"


                             @{b}MagicBoard@{ub}				 @{" HELP ME " LINK HELP_ME}		 
                               Version 1.0



			@{" BOX CIRCLE TRIANGLE LINE " LINK DRAW_BOX_CIRCLE_TRIANGLE}

			@{" TEXT                     " LINK DRAW_TXT}


	



@ENDNODE

@NODE DRAW_TXT "DRAWING TEXTE"


                             @{b}MagicBoard@{ub}				 @{" HELP ME " LINK HELP_ME}		 
                               Version 1.0

	- @{b}B@{ub} 	: Set Bold texte

	- @{b}TEXT@{ub}	: GO

	- @{b}SIZE WITDH@{ub} : Dimension du texte 

	- @{b}TEXTE@{ub}	: Texte à écrire


	- Lorsque vous sélectionnez le gadget @{b}TEXT@{ub}, dans la fenêtre SET-DRAW , un
	  requester apparaît avec quatre possibilités:
  
		@{b}NEW AUTO@{ub}
			- Ce requester apparaîtra immédiatement après avoir placé le texte
			  précédemment .

		@{b}LAST@{ub}
			- Vous ne placez qu'un seul texte .


		@{b}AUTO COUNT@{ub}
			- Lorsque vous aurez placé le texte , le même texte apparaitra
			  @{b}DONT LA VALEUR DECIMAMLE SERA INCREMENTEE@{ub}.
			  @{b}LE FORMAT DU TEXTE DOIT ETRE "TEXTExxx" , AVEC POUR xxx UN
			  CHIFFRE DE 0 A 9998@{ub}.

		@{b}CANCEL@{ub} 


	- @{b}ERASE@{ub} Détruit les textes

	- @{b}ERASE_SEL@{ub} Détruit un texte

	- @{b}MOVE@{ub} Déplace tous les textes

	- @{b}MOVE_SEL@{ub} Déplace un texte

	- @{b}MODIFY_TXT@{ub} Change le texte (pas les noms des devices)

	- @{b}CHANGE_NUMBER@{ub} BUG


	- Pour sortir n'oubliez pas @{b}ESC@{ub}

@ENDNODE

@NODE DRAW_BOX_CIRCLE_TRIANGLE "DRAWING BOX"


                             @{b}MagicBoard@{ub}				 @{" HELP ME " LINK HELP_ME}		 
                               Version 1.0


	- Fonction Key

		  "Q"	  : Place l'indicateur quart sur on/off.
		  "S"	  : Place l'indicateur snap sur grid on/off.
 		  "R"	  : Place l'indicateur ruller sur on/off.
		  "H"	  : Place l'indicateur huit sur on/off.
		  "C"	  : Centre le projet.
		  "+"	  : Zoom +.
		  "-"	  : Zoom -.
		  "ESC"	  : Quitte la séquence et retourne au menu principal.
		  "RMB"	  : Efface un objet @{b}du même type@{ub} 
		  "HELP"  : No Comment
		  "UP DOWN RIGHT LEFT" : Déplace la fenêtre.



@ENDNODE

@NODE DEFINITION "DEFINITION"


                             @{b}MagicBoard@{ub}				 @{" HELP ME " LINK HELP_ME}		 
                               Version 1.0


	



@ENDNODE


@NODE ADRESSE "ADRESSE"



		SALAH Daniël

		rue des Bleuets n°6

		B 1300 LIMAL

		BELGIUM


		TEL: 010 41 88 95


	


@ENDNODE

@NODE History "Programme Information"



                             @{b}MagicBoard@{ub}		 @{" HELP ME " LINK HELP_ME}		 @{" HELP ME " LINK HELP_ME}
                               Version 1.0

	This programme is writen in assembler and compiled witch HiSoft 3.01




 @{b}V1.0 Beta 24/10/96@{ub}
	- première version public domaine

 @{b}V1.0 ?@{ub}
	-pour la version 1.0 définitive l'impression sera corriger .(N'hésitez-pas à me
	 contacter ou à me faire parvenir la doc de votre imprimante )
	 J'utilise KYOCERA F1010 (émulation LaserJet)

@ENDNODE



@NODE STRUC_LIB "Structure du fichier list"



                             @{b}MagicBoard@{ub}		 @{" HELP ME " LINK HELP_ME}		 @{" HELP ME " LINK HELP_ME}
                               Version 1.0 Beta



	- STRUCTURE fichier "list" , contenu dans chaque directory des librairies.


	LONG	: Fichier MagicBoard Library = "MBLI"
	LONG	: Nombre de fichiers contenus dans ce répertoire.
	NameFile: Nom des fichiers , terminés par 0. 
	........:

	END


@ENDNODE
