
CKBD Deluxe v1.3, 4/1994
Gnrateur de caractres composs et acclrateur de souris flexible.


L'extension ultimative pour tout ordinateur  systme d'exploitation TOS 
de
Pascal Fellerich.

Ce programme est 'freeware' (donc pas D.P.)



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 trop pratique.
	Suggestion du chef: CKBD Deluxe! Avec ce programme il est possible 
d'accder tous les caractres contenus dans la police de caractres avec 
un systme logique et simple  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.

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 n'est pas falsifi.
	Les boutons de la souris peuvent tre interchangs, parfait pour les 
gauchers.
	L'angle de mouvement de la souris peut tre chang grce  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:
	untilis sans avoir a payer quelque chose.
	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_12.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

Si vous trouvez des erreurs dans CKBD ou si vous avez d'autres ides, 
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 XCONTROL1 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 'Language' il est possible de changer le langange dans le 
CPX!
	Si vous avez configur ' mort' l'acclerateur de souris pressez la 
touche ALT, alors l'acclrateur est dactiv 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 base2 et caractre 
auxiliaire3. Un  par exemple est pas plu qu'un a avec des guillemets 
en-dessus. CKBD Deluxe offre en total cinq mthodes diffrentes de 
gneration de caractres:
 Compose
 Deadkey
 Extkey
 ALT-<nnn>
 changement du layout du clavier


Compose
Cette mthode s'appelle Compose Character d'aprs l'ide de DEC4. Ici vous 
tapez d'abord la touche 'Compose Character', ensuite vous tapez les deux 
caractres. Alors vous obtenez le nouvel caractre. Donc: Compose, [a], 
[e]  donne []. Pour l'Atari ceci se prsente un peu diffremment: tapez 
ALTERNATE5 comme s'il s'agissait 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 qui est important pour les programmes qui 
utilisent des commands avec alternate.
Si une squence  t initie avec succs ceci 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 beep'.
Une squence lance peut tre termine avec ESC, BackSpace ou toute autre 
touche qui ne gnre pas de code ASCII - comme par exemple les touches de 
fonction.
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. Avec le 
bouton 'Setup' vous arrivez dans 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 foissur 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 'Setup' 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-U6 tout en gardand la fonctionnalit 
ExtKey. Mais il faut aussi remarquer que la mthode ExtKey estcelle qui 
pose la majorit des problmes, 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 tre utile de 
temps en temps. Avec le module CPX il esrt 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.
Les fichiers du type CKB sont plus flexibles et 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. Comme il n'existe pas 
d'diteur pour ce type de tables  prsent j'ai inclus les sources en 
assembleur de la table 'ISO'.
Si une table a t charge il faut dterminer la validit pour cette 
table. Pourquoi a? Imaginez qu'on vous donne 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.2". Un clic sur cette ligne fait 
apparatre un message avec le numro de version du CPX.
	Avec le pop-up sous le titre 'Langage' 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 correspondat comme accessoire. L'autre possibilit est de 
crer un fichier appel AUTOLOAD.CKB quicontient votre setup prfr. Mais 
comme il n'y a pas encore d'diteur pour ces fichiers ceci sera rserv 
plutt aux spcialistes.


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'Atari7. Mais mainenant il y a CKBD Deluxe!
Si vous invoquez le 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 eun peu tourn contre le sens des 
aiguilles d'une montre vous pouverz 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 deXcontrol. 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 Langage 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'limier 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 puissez 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!



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 standrad du ST - ici 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.

Mais aussi la partie Compose-Character de CKBD pose des problmes  
quelques applications. Essayez!



Histoire:

Compose-CPX:
v1.00:	(26.3.94) 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.00:	(26.3.94) nouveau CPX, premire version

TSR:
v1.2:	Version officielle avec acclrateur de souris.
v1.1:	test, tout  fait autre chose....
v1.0:    version sans erreurs de 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.



NOTES:
1	Si vous n'avez pas encore ce nouveau panneau de contrle essayez de 
l'obtenir. Xcontrol fonctionne comme ACC et PRG a partir de TOS 1.4.
2	normalement des caractres de l'alphabet latin.
3	normalement des accents et autres signes de 'dcoration' autour du 
caractre principal.
4	Digital Equipment Corporation, fabricant des ordinateurs VAX
5	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'.
6	^U = fermer une fentre dans des applications GEM.
7	Un tel acclrateur n'existe mme pas pour Mac ou PC!...


