
CKBD Deluxe v1.5
Gnrateur de caractres composs et acclrateur de souris flexible.



L'extension ultimative pour tout ordinateur  systme d'exploitation
TOS, MTOS, MagiC, MagicMac, MagicPC
 de
Pascal Fellerich.

Ce programme est 'freeware'



Prface
Le problme est bien connu: vous voulez taper un texte allemand sur 
un clavier franais. Ca va bien jusqu'au premier 'umlaut' - alors 
vous remarquerez que vous, ou plutt votre ordinateur, manque de 
caractres.
	Suggestion numro 1: installez une table de caractres pour 
	clavier allemand. Mais dans ce cas votre clavier AZERTY sera 
	transform en clavier QWERTZ - si a vous plat, tant mieux.
	Suggestion numro 2: Vous mettez les caractres 
	supplmentaires sur le clavier numrique. Cette solution 
	donne des rsultats satisfaisants mais n'est pas trs 
	pratique - il faut s'habituer  dplacer la main droite sur 
	le clavier numrique pour tout caractre spcial.
	Suggestion du chef: CKBD Deluxe! Avec ce programme il est 
	possible d'accder tous les caractres contenus dans la 
	police de caractres avec des systmes logiques et simples  
	la fois. En plus CKBD Deluxe peut tre configur de faon 
	qu'il est mme possible d'avoir des polices de caractres 
	totalement diffrentes - par exemple ISO ou VISCII.

Comme vous vous servez d'un environnement graphique sur votre 
ordinateur vous utilisez galement une souris. Mais l'interface pour 
la souris qui est dans TOS est trs simple, donc beaucoup de gens 
utilisent un acclerateur de souris. En gnral ces acclerateurs 
sont des utilitaires simples et rudimentaires, ils n'offrent qu'une 
position d'acclration, l'acclration est trop vite ou trop lente, 
l'angle de mouvement de la souris est chang et les souris a 
rsolution lev deviennent incontrlables. Avec CKBD Deluxe, cette 
histoire est finie. Il vous offre une acclration parfaite, 
modifiable et beaucoup d'autres options:
	Acclration douce et parfaite base sur un polynme du 
	troisime degr, avec une rsolution interne de 0.004 pixel.
	L'angle de mouvement de la souris est prserv.
	Les boutons de la souris peuvent tre interchangs, parfait 
	pour les gauchers.
	L'angle de mouvement de la souris peut tre chang d'un 
	facteur constant.
	Indpendant de la rsolution d'cran avec adaptation 
	automatique.
	Adaptable  des souris allant de 50  400 dpi.
	Editeur de courbe d'acclration comfortable


En general...
CKBD Deluxe est du 'freeware'. a veut dire que le programme peut 
tre:
	utilis sans obligation de payement
	distribu dans des collections DP et dans des BBS (Bulletin 
	Board Services).
	Il est par contre dfendu de:
	vendre ce programme
	modifier ce programme de quelque forme ce soit. Donc 
	seulement l'archive autodcomprimant CKBD_15.TOS peut tre 
	distribu.
CKBD Deluxe peut tre distribu avec du soft commerciel seulement 
avec permission de l'auteur. A prsent ceci est seulement vrai pour 
Papyrus de R.O.M. Software. Si vous considrez  distribuer CKBD avec 
votre programme contactez moi. Mon adresse:
	Pascal Fellerich
	45, rue des Gents
	L-3482 Dudelange
	Luxembourg
ou via E-mail:
	Pascal_Fellerich@aia.com
	Pascal Fellerich on 2:270/16.3 (FidoNet)

Si vous trouvez des erreurs dans CKBD ou si vous avez d'autres ides 
ou suggestions, n'hesitez pas  me contacter.


Installation
Ce logiciel consiste de 3 pices.
	Le programme TSR (Terminate and Stay Resident) appel 
	CKBD.PRG.
	Le module CPX COMPOSE.CPX qui sert  configurer le clavier.
	Le module CPX MOUSE.CPX qui sert  configurer la souris.
Le programme resident CKBD.PRG doit tre copi das le rpertoire AUTO 
sur votre disque dur. Si vous utilisez un programme d'interfaage 
pour clavier MF/2 faites attention  ce que CKBD.PRG est lanc aprs. 
Les modules CPX ne peuvent tre utiliss qu'avec XCONTROL (** Si 
vous n'avez pas encore ce nouveau panneau de contrle essayez de 
l'obtenir chez un revendeur Atari. Xcontrol fonctionne comme ACC et 
PRG  partir de TOS 1.4. **) d'Atari. Si vous avez install XCONTROL 
il vous ne reste que de copier les deux modules CPX dans le 
rpertoire CPX. Relancez alors l'ordinateur pour que CKBD soit 
activ. C'est dj tout!

Avant de continuer:
	Avec l'option Langue il est possible de changer le langange 
	dans le CPX!
	Si vous avez configur  mort l'acclerateur de souris 
	pressez la touche ALT pour dsactiver l'acclrateur 
	temporairement.


Manuel d'utilisation pour COMPOSE.CPX
Le programme rsident CKBD.PRG est install dans le systme et peut 
tre configur comme vous voulez par des deux modules CPX. Commencons 
par COMPOSE.CPX:
L'ide fondamentale est de construire les caractres spciaux a 
partir de deux caractres normaux, a savoir caractre de 
base (** normalement des caractres de l'alphabet latin. **) et 
caractre auxiliaire (** normalement des accents et autres signes de 
'dcoration' autour du caractre principal. **). Un '' par exemple 
est pas plus qu'un 'a' avec des guillemets en-dessus. CKBD Deluxe 
offre en total cinq mthodes diffrentes de gnration de caractres:
	Compose (Mode DEC, Multichar et Multichar automatique)
	Deadkey
	Extkey
	ALT-<nnn>
	changement du layout du clavier


Compose
Cette mthode s'appelle Compose Character d'aprs le concept de 
DEC (** Digital Equipment Corporation, fabricant des ordinateurs 
VAX **). Ici vous tapez d'abord la touche 'Compose Character', 
ensuite vous entrez les deux caractres. Alors vous obtenez le 
nouveau caractre. Donc: Compose, [a], [e]  donne []. Pour l'Atari 
ceci se prsente un peu diffremment: tapez ALTERNATE (** Sur les 
terminaux du type VT200 il y a au ct gauche de la barre d'espace, 
l o l'Atari a la touche ALT, la touche 'Compose Character'. **) 
comme s'il s'agissait d'une touche de caractre quelconque, [a], 
ensuite [e]  donne alors []. Si vous pressez ALT trop long ou avec 
une autre touche CKBD ne la reconnat pas comme 'Compose'. Ceci vite 
que la fonction Alternate soit drange - point trs important pour 
les programmes qui utilisent des combinations avec alternate.
Si une squence  t initie avec succs ceci vous sera signal avec 
un clic - le mme que le clic du clavier. Ce clic s'entend toujours, 
mme si vous avez inactiv le clic normal.
Si une squence tait invalide ('z' et 'x' ne donne pas de caractre 
compos) vous entendez le fameux 'system bell'.
Une squence lance peut tre termine seulement avec ESC ou 
BackSpace ou toute autre touche qui ne gnre pas de code ASCII - 
comme par exemple les touches curseur, les touches de fonction etc. 
L'ordre des deux caractres  combiner ne joue pas de rle, mais 
cette proprit peut tre change  votre gr.

CPX: L'option 'Compose' met en marche ou arrte la fonction. Le 
bouton 'Modifier' apelle un autre dialogue qui vous donne l'occasion 
de modifier d'autres paramtres:

mode de compose:
Change entre le mode DEC VT200 et MultiChar. Dans le mode DEC toute 
squence de composition est finie aprs deux charactres. En mode 
MultiChar par contre une squence de composition n'est arrte que si 
une combination est reconnue invalide. De cette faon il est possible 
d'avoir des combinations en srie, donc: Compose, [o], ['] donne [], 
et alors [`] donne []. Mais avant que vous essayez cette 
combination: elle n'existe pas dans cette forme das les tables 
standard. Vous devez crer uner table spciale.

ordre de composition:
En gnral l'ordre des deux caractres  combiner n'est pas important 
parce que l'utilisateur a lanc le mode compose volontairement, et 
alors il veut avoir le mme rsultat s'il tape [o], ["] ou bien ["], 
[o]. Pour le cas o vous avez dfini des caractres diffrents pour 
ces deux cas il est important de fixer l'ordre des caractres.


Deadkey
Lorsque vous entrez un texte plus long vous remarquerez que Compose 
Character fonctionne assez bien mais qu'il est pas pratique de taper 
toujours sur la touche ALT. C'est pourquoi j'ai implment la 
fonction Deadkey. Alors quelque touches sont dfinies comme 
caractres morts - il s'agit des touches qui gnrent les 'caractres 
auxiliaires' comma par exemple ['], [`], [^] et ["]. Si vous tapez 
une de ces touches rien ne se passe. Mais CKBD essaie de combiner ce 
caractre avec celui que vous tapez le suivant. Si cette combination 
est valide, comme par exemple [^] et [o] vous obtenez  "". Si la 
combination est invalide les deux caractres sont retourns, par 
exemple [^] et [x] donnent "^x". Pour avoir le caractre mort 
lui-mme, il suffit de taper deux fois sur cette touche ou bien de 
taper un espace aprs une telle touche. En tout cas, essayez de jour 
un peu avec cette fonction, parce qu'il faut se familiariser avec ce 
systeme comme il est toujours actif, contrairement  Compose qui doit 
tre lanc volontairement.
CPX: Le bouton 'Deadkey' met en marche ou arrte la fonction. Avec le 
bouton 'Modifier' vous arrivez dans un deuxime dialogue qui vous 
donne la possibilit de dterminer vous-mme les caractres qui 
seront interprts comme caractres morts. Mais attention - tous les 
caractres sont accepts, donc le systme est totalement  vous.



ExtKey
Le procd connu du programme 'EXTKEY' par Alex Esser et de 
'JAMES.ACC'. L'ide est toujours la mme: un caractre spcial se 
compose d'un caractre de base et un caractre auxiliaire. Avec 
Extkey vous entrez d'abord le caractre de base et ensuite le 
caractre auxiliaire avec le touche Control enfonce. Alors le 
caractre de base disparat et est remplac par le caractre compos. 
Donc: [o] et CONTROL-[^] donne []. Avec Extkey il faut toujours 
respecter l'ordre caractre de base, caractre auxiliaire. Il n'est 
donc pas possible de produire un [] avec la squence [^], 
control-[u]. Comme a il est parfaitement possible d'utiliser des 
commandes come control-U (** ^U = fermer une fentre dans des 
applications GEM. **) tout en gardant la fonctionnalit ExtKey. Mais 
il faut aussi remarquer que la fonction ExtKey est la plus 
incompatible car GEM ne sait pas dtecter l'tat des touches 
Shift/Control/Alt avec la prcision requise. Essayez!


ALT-<nnn>: DOS-Matic...
Pour les amis de MS-DOS: avec la touche ALT enfonce tapez le code 
ASCII que vous dsirez sur le clavier numrique. Comme cette fonction 
est aussi intgre dans le TOS 2.06/3.06 il est parfaitement normal 
qu'elle ne se laisse pas dactiver dans le CPX parce que TOS reprend 
si CKBD ne ragit pas.


Changement du layout du clavier
Mme si cette mthode prsente des inconvnients elle peut eatre 
utile de temps en temps. Avec le module CPX il est possible de 
charger des fichiers du type '*.KBD' ainsi que '*.CKB'. Les fichiers 
du type KBD ont exactement 384 octets et contiennent les tables de 
dfinition pour le clavier en mode normal, shift et capslock. Il 
existent des programmes en domaine public qui sont  mme de crer et 
d'diter ces fichiers.
** NOUVEAU **
Les fichiers du type CKB sont des fichiers ASCII qui contiennent les 
trois tables mentionnes ci-dessus ainsi qu'une table avec les 
combinations possibles, et en plus quelques informations auxiliaires 
comme par exemple le nom de la table et des donnes de configuration. 
Ces tables peuvent tres dits avec un diteur de texte normal. J'ai 
inclus trois fichiers CKB qui peuvent servir comme exemple si vous 
dsirez crer une autre table pour CKBD Deluxe.
Si une table a t charge il faut dterminer la validit pour cette 
table. Pourquoi a? Imaginez qu'on vous avez un fichier CKB qui 
contient des combinations intressantes, mais la table pour le 
clavier a t faite pour un clavier allemand. Alors vous mettez la 
validit sur 'Compose' seul. Ainsi le layout de votre clavier reste 
inchang. Mais normalement vous avez la validit sur  'Clavier & 
Compose'.


Le reste du module CPX...
La plupart des fonctions du module CPX ont t expliqus. Ici encore 
quelques dtails:
	Dans la ligne d'informations en bleu l'identification du 
	programme rsident apparat. Donc "CKBD Deluxe v1.5". Un clic 
	sur cette ligne fait apparatre un message avec le numro de 
	version du CPX.
	Avec le pop-up sous le titre 'Langue' vous pouvez changer la 
	nationalit des textes dans le CPX. Ceci n'affecte que le CPX 
	lui-mme. Aprs avoir fait votre choix n'oubliez pas de 
	sauver vos prfrences!
	'Sauver' ne sauvegarde les informations actuelles que dans le 
	CPX. Si vous dsirez avoir un setup modifi permanent vous 
	devez garder Xcontrol avec le CPX correspondant comme 
	accessoire.


Manuel d'utilisation de MOUSE.CPX
Il y a un tas d'acclrateurs de souris mais jusqu' prsent il n'y 
avait pas d'acclrateur simple  utiliser mais quand mme 
super-flexible pour l'Atari (** Un tel acclrateur n'existe mme pas 
pour MacIntosh ou PC!... **). Mais mainenant il y a CKBD Deluxe!
Si vous invoquez MOUSE.CPX vous arrivez dans le menu principal, page 
numro 1. Ici vous trouvez un pop-up qui permet d'activer 
l'acclrateur ou bien de le dsactiver.  En-dessous de cette option 
vous trouvez un autre menu pop-up avec qui vous pouvez changer les 
boutons de la souris - ce qui est idal pour les gauchers. Ce 
changement est actif mme si l'acclrateur est dsactiv!
Le champ rotation: 0 dtermine la rotation du repre de la souris. 
Si vous avez tendance  tenir la souris un peu tourn contre le sens 
des aiguilles d'une montre vous pouvez compenser cette tendance 
simplement en donnant une valeur ngative pour la rotation. 
Personellement j'ai les meilleurs rsultats si je travaille avec un 
angle ngatif de -6  -7 degrs.
Le champ rsolution: 100 dpi dtermine la rsolution de la souris. La 
souris standard de l'Atari a une rsolution d'environ 100 dpi. Si 
vous utilisez une souris avec une rsolution leve vous devez 
changer cette valeur, sinon la courbe d'acclration change 
totalement. Si vous voulez dterminer la rsolution de votre souris 
procdez comme suit:
	Desactivez l'acclrateur.
	Positionnez le pointeur graphique au bord gauche de l'cran.
	Guidez la souris  l'aide d'un lineal jusqu'au bord droit de 
	l'cran.
	Multipliez le nombre de pixel en direction horizontale (pour 
	ST-high et TT-mid 640) avec 2.54 et divisez ce nombre par la 
	distance parcourue par la souris en cm. Le resultat est alors 
	la rsolution de la souris en dpi.
Le bouton diteur de polynme active la page d'dition du polynme 
d'acclration. Ici vous trouvez la reprsentation graphique du 
polynme y=ax+bx+cx ainsi que les trois facteurs correspondants. 
Vous pouvez entrer les facteurs directement et les essayer en 
cliquant sur le champ d'dition graphique. Mais vous pouvez aussi 
dplacer les quatre points de repre sur la courbe. Alors le CPX 
calcule le polynme qui passe par les quatre points et vous donne les 
facteurs ncessaires. Comme cette mthode produit des facteurs un peu 
spciales la courbe rsultante n'est pas install directement. Vous 
devez d'abord cliquer dans le champ d'dition pour pouvoir tester la 
nouvelle caractristique. Ou bien vous quittez le dialogue avec OK ou 
vous fermez la fentre de Xcontrol. Si la souris est devenue 
incontrlable il est possible de dsactiver l'acclrateur en 
enfonant la touche ALT.
Ensuite le pop-up presets vous offre cinq diffrentes courbes 
d'acclration prdfinies.
Retournons au menu principal: Il y a encore plus de trucs  
configurer! Avec un clic sur le symbole de souris  gauche de la 
fentre vous entrez dans la page numero deux du menu principal. L 
vous trouvez le champ Pixel w/h = 256:256. Ce rapport reprsente le 
rapport largeur sur hauteur d'un pixel de l'cran. Pour ST-High, 
ST-Low, TT-High et TT-Mid les pixel sont carrs, donc le rapport est 
gal  1:1 ce qui correspond  256:256. En ST-Mid vous avez un 
rapport 2:1, donc 256:128!
Ensuite vous avez le champ rsolution: 71 dpi. Comme il y a un 
symbole d'cran  gauche  il devrait tre clair qu'ici la rsolution 
de l'cran est donne. Pour ST-Low elle est d'environ 25 dpi tandis 
que dans les autres rsolutions elle est d'environ 70 dpi, la valeur 
exacte dpendant bien sr du moniteur utilis. Quand ces deux valeurs 
sont exactes, CKBD Deluxe peut raliser une caractristique 
d'acclration indpendante de la rsolution. Mais comme il est 
fastidieux de modifier ces valeurs aprs tout changement de 
rsolution vous avez l'option auto-dtection. Avec cette option le 
CPX demande au systme d'exploitation les valeurs exactes et les 
passe  CKBD Deluxe.
En dernier lieu il ne me reste qu' vous indiquer le pop-up Langue 
avec lequel vous pouvez dterminer la langue utilise dans le CPX. 
Les autres boutons sont standard et ne ncessitent aucune explication.


Remarques...
Avant de fermer ce manuel lisez encore les remarques suivantes:
	Il est recommand d'liminer ou au moins de dsactiver des 
	utilitaires qui ont la mme fonctionnalit que CKBD Deluxe. 
	Ainsi vous vitez des effets secondaires comme par exemple 
	une surcharge de l'interruption ikbdsys. Eliminez donc MACCEL 
	& Co!
	Pour que vous puissiez utiliser la fonction Compose, Extkey 
	et Deadkey plus effectivement il est recommand de regarder 
	un peu les tables en annexe. Ils montrent toutes les 
	combinations possibles.
	Il y a toujours des programmes qui n'acceptent pas des 
	caractres gnres par CKBD Deluxe. Ceci est alors un 
	problme du programme en question, et non pas de CKBD Deluxe.
	Le panneau de contrle modulaire XCONTROL ncessite au moins 
	un TOS 1.4.
	CKBD.PRG tourne sur toutes les versions de TOS. Comme 
	l'interface entre les CPX et CKBD est bien defini et 
	document il devrait tre facile d'crire un accessoire de 
	configuration pour CKBD...
	Si ce programme vous plat, n'hesitez pas de m'informer! (par 
	une carte postale par exemple....)


Cas speciaux...
Il n'existe pas de programme sans problmens ou incompatibilits! Par 
exemple la fonction auto-dtection du MOUSE.CPX ne fonctionne pas 
correctement avec des TOS plus anciens - simplement parce que le VDI 
de ces versions TOS ne donne pas d'informations exactes!! Considerons 
par exemple les trois rsolutions standard du ST:







On voit que le TOS du TT - et peut-tre aussi le TOS 2.06 - donne des 
valeurs correctes, au moins pour le rapport largeur sur hauteur des 
pixel. Il est clair que le systme d'exploitation est incapable de 
donner des valeurs exactes pour la rsolution de l'cran comme il ne 
sait pas la grandeur de l'cran utilis.


Histoire:
Compose-CPX:
v1.10:	New (ASCII!) format for CKB tables.
v1.01:	(1.1.1996) 3D-look, cosmetics...
v1.00:	(26.3.1994) nouvelle surface d'utilisation, nouveau code!
v0.8:	version sans erreurs v0.7:	ne trouve pas les pathnames
v0.1:	test, Motto: my first CPX.

Mouse-CPX:
v1.01:	(1.1.1996) 3D-look, cosmetics...
v1.00:	(26.3.1994) nouveau CPX, premire version

TSR:
v1.5:	(avril 1996)
	 New mode for compose character; improved handling.
	 Support for VIQR/VISCII (Vietnamese ASCII; suggestion by 
	Oliver Skelton)
v1.4:	(janvier 1996)
	 NVDI 3 jumping mouse fix
	 nouvelles tables de compose pour NVDI 3
	 flag spcial 'order-sensitiveness' pour les tables
	 modifications dans Deadkey
	 Autoload limin (rendant le TSR plus petit)
v1.3:	Modification dans Deadkey (suggestion de M. Papyrus)
v1.2:	(mars 1994) Version officielle avec acclrateur de souris
v1.1:	test, tout  fait autre chose....
v1.0:	version sans erreurs de janvier 1992
v0.9:	sous TOS 1.0..1.4 le systme se plante de temps en temps si 
on touchait ALT. Cause: une erreur (code malprogramm) dans les 
function-dispatcher de TOS. Avec KAOS 1.4.x et TOS 1.6 pas de 
problmes.
v0.8:	Pointeurs mal initialiss.
v0.7:	premire version officielle.

_____________________________________

1992-1996 by Pascal Fellerich
