	IKO3A  (C) Jacques GAUDIN 1995-1996
	LIBIKO (C) Jacques GAUDIN 1995-1996

	Jacques GAUDIN
	e-mails:
	100745.1005@compuserve.com	
	jgaudin@ellis.fdn.org
	p-mail:
	11 rue Lacretelle
    77340 PONTAULT-COMBAULT (FRANCE)	


						
							+---------------+
							               
							   I K O 3 A   
							               
							  M A N U E L  
							               
							+---------------+


GENERALITES
	Iko3a est un diteur d'icnes trs pratique 
	tout  fait adapt  la gestion des icnes du S3a ou 3c
	Iko3a est maintenant diffus en shareware. 
	Voyez plus bas cette rubrique qui vous permettra 
	de vous enregistrer et de supprimer les messages de rappel.

INSTALLATION
	Copiez IKO3A.OPA et LIBIKO.OPA dans un rpertoire \APP 
	sur n'importe quel disque. 
	Crez un sous rpertoire \APP\IKO3A sur le mme disque 
	et copiez y IKO3A.HLP et LIBIKO.HLP (option).
	Installez les icnes dans l'cran systme (Psion+i).
	Copiez les exemples *.IKO et *.IKL dans un rpertoire \IKO.

INTERFACE
	L'cran d'accueil affiche  gauche l'image agrandie, en haut la trame noire, 
	la grise, et l'image finale. 
	Au milieu se trouvent la position en x et y du curseur, 
	la taille du trait, et la slection des trames, noire, grises ou les deux, 
	commande par la touche diamant.
	A droite se trouve une barre de boutons. 
	Le libell des boutons et leur fonction dpendent des fonctions utilises.
	Si vous pressez sur la touche <Tab> pour scroller, 
	les touches <Entre> (Tracer) et <Eff> (Effacer), sont, ainsi, dsactives. 
	Il en est de mme en mode <Amener>.
	Lorsque qu'une trame (ou les deux) est slectionne, 
	le programme n'agit que sur elle (ou les deux  la fois). 
	Vous pouvez ainsi ne scroller qu'une trame pour raliser des effets de relief, 
	inverser une seule trame ou les deux, crire en gris ou en noir. 
	Exception: l'option "Retourner" agit sur les deux trames  la fois.
	IKO3a est une application graphique et est, de ce fait, 
	relativement gourmande en mmoire. 
	Utilisant un nombre important de fentres graphiques et un cache mmoire, 
	40 k au moins sont ncessaires pour son utilisation. 
	Fermer donc toutes les applications inutiles dans l'instant,  
	en particulier le tableur. 
	Pour librer le plus posible le disque interne, stockez vos programmes 
	sur SSD Flash et vos donnes sur SSD Ram.
	Attention : la sortie par <Psion+Esc> est active  tout instant. 
	Ce n'est qu'une sortie de secours. 
	Si vous l'utilisez par erreur vous perdrez 
	toutes les modifications non enregistres !

OPTIONS AVANCEES
	Iko3a est une application graphique avance et  dispose, de ce fait, 
	de  plusieurs options pour annuler une action:
		- l'option <annuler> avec <Ctrl>+Z. 
		Iko3a stocke dans un tampon l'image avant utilisation d'un outil 
		ou d'une fonction. 
		Il ne sert plus   rien d'annuler si on appuie deux fois de suite, 
		par exemple, sur la touche <Entre>, ou <Eff>, 
		crasant ainsi inutilement le tampon.
		- l'option <Revenir> revient  la dernire version sauvegarde 
		si elle existe. 
		Dans le cas d'un fichier nouveau cette image est vide 
		et cette option efface donc le travail en cours !
		-l'option <Copier><Coller>, avec <Ctrl>+C et <Ctrl>+V 
		permet de sauvegarder une trame ou les deux et de la recoller. 
		Servez-vous de cette option pour additionner deux trames importes 
		d'une image sur PC et dont vous sauvegarderez dans deux fichiers diffrents,
		noir et blanc uniquement, les noirs et les gris. 
		Utilisez un convertisseur PCX > PIC pour importer vos fichiers (comme WSPCX).

AMENER
	L'option amener permet de dcouper une icne dans une image aussi grande 
	que la mmoire peut supporter. 
	Si vous voulez rcuprer une icne d'une application existante, 
	utilisez la fonction SCREENPIC, non documente, des S3 et S3a. 
	Cette fonction permet de raliser des copies d'cran 
	de n'importe quelle application, et donc de l'cran systme, 
	en appuyant simultanment sur les touches <Ctrl>+<Maj>+<Psion>+S. 
	L'image est rcupre dans un fichier SCREEN.PIC 
	dans la racine du disque interne. 
	Dans la bote de dialogue <Amener image> utilisez la touche <Tab> 
	pour vous dplacer dans le slecteur de fichier.  
	S'il existe le fichier SCREEN.PIC se trouve en bas de la liste des rpertoires. 
	Ce fichier image tant d'une taille importante (19 Ko) il vaut mieux le dtruire  aprs utilisation. 


UTILISATION D'ANCIENNES ICONES DU S3
	Les icnes du S3 standard sont au format 24x24 pixels. 
	Mais elles apparaissent d'une taille double dans l'cran systme. 
	Pour une application existante il suffit de les rcuprer 
	par l'intermdiaire de la fonction SCREENPIC (voir plus haut).
	Si aucune application ne possde cette icne, 
	utiliser l'diteur OPL pour crer une application temporaire 
	utilisant cette icne.
	
	Par exemple :

	APP toto
	type 0
	icon "M:\OPD\VIELLICO.PIC" REM ou la votre
	ENDA

	PROC toto:
	ENDP

	Transcodez (par PSION+J) et installez la ensuite dans l'cran systme,
	faites une copie d'cran, puis dtruisez les fichiers inutiles.

FICHIERS D'AIDE
	Les fichiers d'aide optionnels sont personnalisables. 
	Vous pouvez les ditez comme fichier .DBF avec FICHE, DATAVIAW ou JBDATA.
	Attention  ne pas crer de trop longues lignes !

NOUVEAUTES  DE LA VERSION 2.0
	La version 2.0 rectifie un bug qui rendait inoprant le choix des styles du lettrage. 
	Dans un but d'allgement le fichier d'aide a t spar du programme : 
	placez le dans le rpertoire OPD sur n'importe quel disque (A, B ou M). 
	La rponse aux appels sytmes a t amliore. 
	Lors de la dcoupe d'une icne dans un fichier import le scroll passe 
	 une vitesse suprieure (48 pixels) avec PSION+flches. 
	Cela permet de balayer trs rapidement une librairie d'icne. 
	CF fichiers d'exemple. 
	Enfin pour l'option "Amener", le fichier SCREEN.PIC est propos s'il existe 
	(voir plus haut).

NOUVEAUTES VERSION 2.1 et 3.0
	La version 2.1 se diffrencie par une gestion plus conome du cache 
	et par une normalisation du scroll dans la pocdure "Amener".
	Le cache est ainsi rduit des deux tiers, dans un soucis d'conomie mmoire. 
	En mme temps il est utilis  l'octet prs.
	Le scroll dans la procdure "Amener" s'inverse de sens par rapport 
	aux anciennes versions, ce qui semble moins droutant.  
	Il n'est plus possible de scroller en dehors de l'image. 
	La combinaison "Psion"+"Flches", n'amne plus ncessairement au bord de l'image 
	mais provoque un dplacement de 48 pixels. 
	Le but est de pouvoir exploiter plus facilement des librairies d'icnes 
	au pas de 48 pixels.
	La version 3.0 se caractrise par un zoom 3 fois plus rapide de l'image 
	et par d'autres optimisations du code.

NOUVEAUTES VERSION 4.0 et 4.4
	La version 4.0 amliore la gestion de l'interface multitche du Series 3a.
	Iko3a ne ralentit plus d'autres applications tournant en tche de fond.
	Les fichiers d'aide sont plac dans un sous rpertoire du rpertoire 
	o se trouve l'application (APP\IKO3A)
	La version 4.1 dtecte l'attribut du fichier de l'icne 
	et affiche un message adquate
	si l'attribut "Lecture seule","Cach" ou "Systme" est actif.
    La version 4.1 contenait un bug manifeste qui interdisait 
    la cration de nouveaux fichiers depuis l'cran systme.
    Cette version rsoud le problme.
    La version 4.4 contient ma nouvelle adresse.

LIBIKO
	"LIBIKO" est un utilitaire,  joint  cette nouvelle version, 
	permettant  de crer ou de modifier des librairies de 9*3=27 icnes. 
	Ces librairies sont ainsi toujours centres par la procdure "Amener".  
	L'intrt de ces librairies est de pouvoir visualiser dans Iko3a, 
	par la procdure "Amener", un grand nombre d'icnes. 
	Le gestionnaire de fichier y gagne aussi en clarification.
	"LIBIKO" fonctionne comme une application indpendante d'Iko3a 
	mais utilise, par dfaut, son rpertoire et ses extensions pour amener les icnes. 
	Les fichiers Libiko sont des bitmaps de 15584 octets, avec 2 trames, 
	et de dimensions 9*48=432 par 3*48=144. 
	Le rpertoire par dfaut des bitmaps crs est IKO et l'extension IKL,
	ce qui correspond  ceux de la procdure "Amener" d'Iko3a.
	La nouvelle version de LIBIKO permet de d'importer 
	mais aussi d'extraire les icnes.
	VERSION 2.0 Cette version permet galement d'extraire les icnes.
	VERSION 2.1 Cette version ne sauvegarde la librairie  la fermeture
	que si une icne au moins a t colle.
	(ceci pour conomiser l'espace des SSD flash)
	Elle dtecte les fichiers mis en lecture seule.
	VERSION 2.2 La version 2.2 contenait un bug manifeste qui interdisait 
    la cration de nouveaux fichiers depuis l'cran systme.
    Cette version rsoud le problme.
    VERSION 2.4 Quelques remaniements et ma nouvelle adresse...

QUELQUES CHIFFRES
	Iko3a et Libiko c'est plus de... 
	2200 lignes de fichier source, 
	prs de 100 procdures 
	et pas mal de  nuits de travail...

SHAREWARE
	Les droits d'utilisation d'Iko3a ne sont plus laisss  votre discrtion...
	Iko3a et Libiko sont des sharewares, 
	c'est  dire que si vous les utilisez au-del
	d'une priode d'essai raisonnable (un mois) vous devez vous enregistrer!
	Vous contribuerez ainsi au dveloppement sur votre machine prfre...
	Pour cela vous pouvez utiliser l'une de cesdeux mthodes:

	a: envoyer par chque en Francs Franais ou en monaie en Ff ou US$,
      110 F ou 22 $,  l'adresse suivante :

	Jacques GAUDIN
	11 rue Lacretelle
    77340 PONTAULT-COMBAULT (FRANCE)

    b: utiliser le service d'enregistrement de CompuServe

        GO SWREG, le numro d'enregistrement de ce shareware est 13385.

	Vous recevrez alors la dernire version Iko3a et de Libiko,  votre nom,
	sur disquette PC ou sous forme de fichier joint  un e-mail, 
	dpourvus des messages de rappels de shareware !
	Le port est inclus pour l'Union Europenne.
	Pour le reste du monde le plus simple est 
	de recevoir votre fichier joint  un e-mail.

DIFFUSION
	La diffusion d'IKO3a est libre  condition 
	qu'elle soit non-commerciale et d'y joindre TOUS LES FICHIERS
	fournis dans l'archive sans aucune altration d'aucune sorte !

	IKO3A.OPA 
	LIBIKO.OPA
	IKO3A.HLP
	IKO3A.TXT
	et les fichiers d'exemple *.IKO et *.IKL

	===========================================================================

	Jacques GAUDIN
	e-mails:
	100745.1005@compuserve.com	
	jgaudin@ellis.fdn.org
	p-mail:
	11 rue Lacretelle
    77340 PONTAULT-COMBAULT (FRANCE)	

	===========================================================================
	Veuillez me faire parvenir la dernire version d'Iko3a et de Libiko

	Nom 	:____________________________
	Prnom 	:____________________________
	Adresse :____________________________
			 ____________________________
	Ville		:________________________
	Code Postal :______________
	Pays		:______________

	e-mail		:______________

	Ci-joint 110 F Franais ou $22

	Je prfre recevoir une disquette PC			[ ]
	Je prfre recevoir mon logiciel sur mon e-mail	[ ]
		Par fichier joint ( Compuserve ou Ellis )	[ ]
		Par fichier UUENCODE						[ ]

	Remarques :







	
	===========================================================================



