            ******************************************************
            * VIDEL INSIDE (c)oderight 1994 Trisomic Development *
            ******************************************************

Fonction: Rsolutions tendues, cran virtuel
Matriel requis: Atari Falcon030, moniteur (?)
Distribution: Freeware
Auteur: Franois GALEA (Zerkman)
Version actuelle: 1.2

Documentation franaise:

AVERTISSEMENT:
   L'auteur de ce logiciel ne pourrait tre tenu pour responsable de  dommages 
ventuels subis le matriel. L'utilisation du logiciel implique l' approbation 
de cet avertissement par l'utilisateur.
   Il est fortement recommand de lire intgralement ce texte de documentation 
avant toute utilisation du logiciel.

   Le pack Videl Inside est constitu des fichiers suivants:
- VI.PRG       (le fichier excutable)
- VI.DAT       (le fichier ASCII contenant les divers modes vido)
- VI_FRA.TXT   (la doc en Franais (que vous lisez actuellement))
- VI_ENG.TXT   (la doc en anglais)
   Ces  fichiers pourront tre copis et diffuss librement,  aussi  longtemps 
qu'ils ne sont pas copis sparment.  De plus,  toute traduction ou modifica-
tion  que ce soit des fichiers excutables et de documentation  sans  l'accord 
crit de l'auteur est interdite.


   Entrons sans plus attendre dans le vif du sujet...

1. QU'EST-CE QUE VIDEL INSIDE ?
   Videl  Inside (VI pour les intimes) est un utilitaire  conu  exclusivement 
pour  l'Atari Falcon030,  qui vous permettra d'accder  des rsolutions  plus 
importantes que les rsolutions standard du Falcon,  sur votre moniteur,  sans 
aucune modification matrielle que ce soit.  Vous allez pouvoir dcouvrir  les 
tonnantes possibilits graphiques du processeur vido du Falcon (le Videl)!
   VI comporte galement un mode cran virtuel, qui vous permet de dfinir une 
taille  cran  uniquement limite par la taille de la mmoire  vive  de  votre 
Falcon.  L'image  affiche  sur votre moniteur n'est alors  qu'une  partie  de 
l'cran total,  et suit les dplacements du curseur de la souris, afin de vous 
permettre de visualiser entirement l'espace cran.


2. INSTALLATION:
   Copiez le fichier excutable VI.PRG et le fichier de donnes VI.DAT dans le 
dossier  AUTO  de  votre  disquette  ou  de  votre  partition  de   dmarrage. 
ATTENTION:  L'excutable  devra  tre  situ parmi les  derniers  fichiers  du 
dossier  AUTO,  mais  devra se placer devant les programmes comme  OUTSIDE  ou 
MiNT.  Le  non-respect  de cette condition peut provoquer  des  plantages  des 
autres programmes rsidents.


3. UTILISATION
   A  partir  du  bureau GEM,  lancez VI.PRG du  dossier  AUTO.  La  boite  de 
configuration apparatra alors. Celle-ci est compose de trois parties:
   - Slection du type de moniteur;
   - Slection du mode vido relatif au moniteur correspondant;
   - Options pour l'cran virtuel.


 a. Slection du type de moniteur
   Trois choix vous sont proposs: cran monochrome, du type Atari SM 124/125; 
cran RGB,  ce qui correspond a tous les moniteurs de type PAL/NTSC,  ou  plus 
simplement  un tlviseur;  et enfin moniteur VGA, qui regroupe les moniteurs 
rpondant aux normes VGA et SVGA, et les moniteurs multisynchrones.
    A chaque type de moniteur est associ un mode vido et  une  configuration 
d'cran virtuel,  ce qui vous permettra,  si vous changez souvent de  moniteur 
(ce qui est mon cas), d'accder directement au mode vido adapt  vos besoins 
et  votre moniteur.

 b. Slection du mode vido relatif au moniteur correspondant
   Six  lignes de dfinition de modes vido peuvent tre affiches  simultan-
ment. Cliquez sur l'une d'elles si le mode qu'elle dfinit vous convient. A la 
droite  de  la  fentre d'affichage de ces  modes,  se  trouvent  les  boutons 
classiques  d'une  fentre  GEM:  Une  barre d'ascenseur  et  des  flches  de 
dfilement.  Ceux-ci vous permettront de faire apparatre aisment les  lignes 
de dfinition de modes non visibles.
   Le mode slectionn est affich en vido inverse.

 c. Paramtrage et validation de l'cran virtuel
   Pour  valider l'option cran virtuel,  cliquez sur le bouton  indiqu  'Big 
Screen',  qui devra alors se trouver affich en vido inverse. Les deux champs 
ditables  intituls  'screen size' X et Y sont alors  utilisables,  ils  vous 
permettront  de  dfinir   votre guise la taille cran  que  vous  souhaitez. 
Attention   ne pas dfinir une taille cran trop importante par rapport   la 
mmoire disponible dans votre ordinateur:  un plantage risquerait de  subvenir 
lors de l'initialisation.
   Note:  Pour assurer une meilleure compatibilit,  autant physique de  logi-
cielle,  la  largeur  que vous aurez dfinie sera arrondie au multiple  de  32 
directement infrieur, et la hauteur au multiple de 16 directement infrieur.

 d. Autres paramtres
   Cliquez  sur  'Options' pour accder au mode de configuration  des  options 
diverses.  Vous pourrez alors slectionner ou non celles qui vous  intressent 
en cliquant sur les cases correspondant  chacune d'entre elles.  Un clic  sur 
'Set'  permet de valider votre slection et de revenir  l'cran principal  du 
mode de configuration.
   Les  deux  champs ditables intituls 'Scroll threshold' X et Y  servent   
dfinir  la  distance en pixels entre le pointeur de la souris et le  bord  de 
l'cran au de de laquelle le dcalage de l'cran se produit.  Cette fonction 
ne sert videmment que lorsque l'cran virtuel est activ.
   L'option  'correct threshold' permet d'adapter automatiquement le seuil  de 
dclenchement du scrolling vertical du mode Ecran Virtuel par rapport au seuil 
horizontal,  et au rapport largeur/hauteur de la taille des points cran.  Par 
exemple,  si vous tes en mode 80 colonnes non entrelac ou double  ligne,  le 
seuil  vertical sera automatiquement fix  la moiti de  l'horizontal.  Cette 
option  est  un petit 'plus' ajout au confort visuel,  mais qui  se  rvlera 
rapidement indispensable.
   L'option 'Configuration mode on boot' vous permet,  si elle est valide, de 
lancer  directement  le  mode  de configuration (voir  chapitre  4)    chaque 
redmarrage  de la machine,  sans que vous n'ayez  maintenir la touche  Shift 
droite enfonce au cours de cette phase.
   Une  option supplmentaire intitule 'Update NEWDESK.INF' vous  permet,  si 
elle est active,  de modifier au boot la configuation du Bureau GEM,  afin de 
se trouver directement dans la rsolution choisie une fois sur le  Bureau.  Si 
elle n'est pas active, vous devrez pour utiliser le mode vido que vous aurez 
pralablement  choisi,  changer la rsolution  l'aide de la  fonction  'Modes 
Vido' du Bureau,  de faon  ce que celle que vous aurez choisie soit la plus 
proche possible du mode Videl Inside.  (par exemple,  sur un moniteur RGB,  si 
vous  avez configur VI en 832x592 entrelac True Color,  pour  obtenir  cette 
rsolution vous devrez passer en mode True Color, 80 colonnes, entrelac)

 e. Sortir du mode de configuration
   Une  fois tous ces paramtres dfinis,  vous pouvez cliquer sur 'Use'  pour 
confirmer votre slection, et quitter l'cran de configuration. Un double clic 
sur  le  mode vido de votre choix produira le mme effet.  Pour  sortir  sans 
sauvegarder les paramtres, vous pouvez cliquer sur 'Cancel'.
   Pour  utiliser  la  configuration  slectionne,   faites  un   reset,   VI 
s'installera  automatiquement  en mmoire,  et une fois sur  le  bureau,  vous 
pourrez tirer pleinement profit de la puissance de votre Falcon.

   ATTENTION:  Pour les moniteurs monochromes et VGA, soyez trs prudents: Les 
modes vido proposs peuvent ne pas tre supports par votre moniteur. Si vous 
ne  savez pas si tel ou tel mode vido fonctionne,  utilisez d'abord  un  mode 
suprieur  en rsolution  un autre dont vous tes sr du  bon  fonctionnement 
(par exemple, le 640x480 fonctionne sur la plupart des moniteurs monochromes). 
   Si le mode slectionn s'avre tre bien accept par votre  moniteur,  vous 
pouvez renouveler l'opration avec un mode suprieur  celui-ci.
   Si,  par contre, l'image cran parat brouille, ou s'il n'y a plus du tout 
d'image  l'cran, n'insistez pas, vous risqueriez de dtruire votre moniteur. 
Effectuez  immdiatement  un reset,  et pendant la phase  de  boot,  maintenez 
enfonce   la   touche  Shift  gauche,   ce  qui  vous   permettra   d'inhiber 
l'installation de VI en mmoire,  et ainsi d'accder librement au bureau  GEM, 
afin de pouvoir slectionner un mode vido qui, lui, fonctionne.


4. LES NOUVEAUX MODES DE CONFIGURATION DE VI:
   La  version 1.1 de Videl Inside comporte deux nouveaux modes de  configura-
tion  de  la  rsolution:  le  mode par ligne  de  commande,  et  le  mode  de 
configuration au dmarrage de la machine.

 a. La configuration de VI par la ligne de commande:
   VI peut tre lanc  partir d'un shell ou d'un programme quelconque,  et de 
cette faon tre configur de faon automatise.  Cela peut tre pratique pour 
certains gestionnaires de boot,  tel Xboot, pour assigner un mode VI diffrent 
pour  chaque configuration systme.  Le format de la ligne de commande est  le 
suivant:
   VI.PRG mon,larg,haut,coul
   (remarque:  les  paramtres peuvent tre spars soit de virgules  (',')  , 
soit d'espaces (' '),  soit de points ('.'). Cette possibilit est due au fait 
que  certains  gestionnaires  de boot filtrent les virgules  ou  les  espaces. 
Vous pouvez donc configurer VI grce  cette option)
   - mon  est  le type de moniteur que l'on veut  configurer  (1=mono,  2=RGB, 
3=VGA)
   - larg  et  haut sont les dimensions de l'cran correspondant au  mode  que 
l'on veut slectionner.
   - coul correspond au nombre de couleurs dsires:
          coul nombre de couleurs
          0    2
          1    4
          2    16
          3    256
          4    True Color
   Si aucun mode interne au fichier VI.DAT ne correspond  tous ces paramtres 
  la fois,  VI rendra la main au programme excutant en affichant un  message 
d'erreur, et votre configuration ne sera pas prise en compte.
   Si  l'on dsire activer l'cran virtuel,  il faut ajouter deux  paramtres, 
correspondant  respectivement  la largeur et  la hauteur de l'cran  virtuel 
dsir.

 b. La configuration de VI par le mode de config au boot
   Ce mode est activ si l'on maintient enfonce la touche Shift droit lors de 
la  phase  de  dmarrage  du Falcon.  La liste  des  modes  vido  disponibles 
correspondant  votre moniteur apparat alors.  Le mode actif est prcd d'un 
symbole  indicateur  (tick).  Le  mode slectionnable  est  affich  en  vido 
inverse.  Vous  pouvez  slectionner un autre mode en vous dplaant  dans  la 
liste    l'aide des touches flches haut et bas,  et en pressant  la  touche 
Return une fois arriv sur le mode dsir.
   Vous  pouvez  galement dfinir une rsolution virtuelle  tout  d'abord  en 
activant  le mode cran virtuel,  grce  la touche 'V',  puis en  rglant  la 
hauteur  avec  Shift+Flches  Verticales  et  la  largeur  avec  Shift+Flches 
horizontales.

5. COMMENT DFINIR SES PROPRES MODES VIDO
   Les modes vido de Videl Inside son entirement reconfigurables.  Ils  sont 
stocks dans le fichier VI.DAT.  Vous pouvez crer vos propres modes: VI a t 
prvu pour. Il faut cependant avoir une bonne connaissance du Videl.
   La  structure de VI.DAT est la suivante:  Chaque mode vido  est  constitu 
d'une  ligne ASCII de 35 caractres maximum,  qui apparatra dans la bote  de 
configuration.  Sur  la  ligne  suivante,  se trouvent un  certain  nombre  de 
paramtres numriques,  spars entre eux par des virgules,  et tant soit  en 
notation dcimale (par dfaut),  soit en hexadcimal (ils sont alors  prcds 
du  prfixe  '$'),  selon l'humeur de leur crateur.  Voici la  liste  de  ces 
paramtres:
   - Type de moniteur auquel correspond le mode (1:monochrome, 2:RGB, 3:VGA)
   - Taille horizontale et verticale en pixels de l'cran correspondant
   - Nombre de plans de bits de l'image (2^nb= nombre de couleurs affichables)
   - Mode vido (format Xbios)  initialiser avant l'installation du mode  VI. 
     Il devra correspondre au mode Xbios le plus proche du mode VI (au  niveau 
     Compatibilit  ST,  nombre de  couleurs,  80/40  colonnes,  entrelacement 
     (RGB),  mode  double  ligne (monochrome/VGA)).  Note:  Les flags  PAL  et 
     overscan (bits 5 et 6) devront tre systmatiquement fixs  zro.
   - Suivent les vecteurs Videl suivants:
     HHT,HBB,HBE,HDB,HDE,HSS,VFT,VBB,VBE,VDB,VDE,VSS,Vwrap,Vmode,VCO.
     Leurs adresses correspondantes sont:
     $FF8282,$FF8284,$FF8286,$FF8288,$FF828A,$FF828C,
     $FF82A2,$FF82A4,$FF82A6,$FF82A8,$FF82AA,$FF82AC,
     $FF8210,$FF82C2,$FF82C0.
     Toutes ces adresses sont  accder au format mot (2 octets).

   Vous pouvez ajouter des lignes de commentaires dans VI.DAT.  Elles  devront 
tre prcdes par le prfixe ';'.  Vous ne pouvez pas insrer de commentaires 
entre les deux lignes dfinissant un mode vido.


6. NOTE AUX PROGRAMMEURS
   VI installe dans le Cookie-Jar un cookie dont l'identifiateur est TDVI.  Le 
long-mot  suivant  contient  en octet de poids fort le numro  de  version  en 
dcimal  multipli  par  10.  (par exemple,  la version  1.1  sera  code  par 
$11000000.  La  version 1.0 est code $02000000,  ce qui tait un oubli de  ma 
part,  mais  ce genre d'oublis de mise  jour ne devrait plus se  reproduire.) 
Les  trois  octets restants n'ont pas d'utilit pour l'instant,  mais  il  est 
possible qu'ils soient utiliss dans une future version.


     Voil, vous savez tout sur l'utilisation de Videl Inside...


                              ------------------


     Videl Inside est une production du groupe Trisomic Development. Ce groupe 
a  la particularit de ne dvelopper que  des  applications,  utilitaires,  et 
logiciels utiles,  sur Falcon030.  Ses membres sont actuellement Alriad,  Kor, 
Melkor, Pozzi, Sonix, Soyuz et Zerkman.

   Vous  pouvez  nous  contacter sur le 36.15 RTEL   nos  bals  respectives.

   Vous pouvez galement nous crire  mon adresse:

Franois GALEA (Zerkman)
19, rue du Moulinet
78610 Le Perray-en-Yvelines
- FRANCE -

   Vous pouvez nous envoyer une disquette avec vos propres modes  vido,  ceux 
qui  seront  slectionns  (si  nous  ne  les  avons  pas  dcouverts  avant!) 
permettront    leurs  auteurs de voir leur nom  mentionn  dans  les  futures 
versions de VI...
   A  cette  adresse vous pourrez aussi obtenir la dernire version de  VI  en 
date,  si vous joignez  votre envoi une disquette et une enveloppe timbre   
votre adresse.

   Au passage,  un petit bonjour  HCl,  Hexocet (argh,  j'ai toujours ton  CD 
Gemini  :-(  ),  Zanak,  Nullos,  STS,  Hello,  et tous ceux du  Power  Falcon 
Magazine!...

   Voil,  il  ne  me reste qu' vous souhaiter un bon  amusement  avec  Videl 
Inside...

                                                          Zerkman, le 7/11/94.
                                                          --------------------



