                          SNAPSHOT FALCON030
                          ------------------
                          (c) 1993-94 E CELLARD

   Les programmes que vous devez avoir:
   -SNAPFAL.PRG :le snapshot
   -VISUPIZ.PRG :un visualiseur des images .PIZ sauves avec le snapshot
   -DOCSNAP.TXT :ce fichier
   -CPIZ104.PRG:le nouveau convertisseur .PIZ EN .TGA 24 bits
                avec ses fichiers ressources CPIZC.RSC et CPIZM.RSC

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

Ces programmes sont en Shareware, si vous les utilisez rgulirement,
veuillez me faire parvenir une carte postale, 50FF ou un programme que
vous avez ralis sur FALCON)
 l'adresse suivante:
                     CELLARD Eric
                     9 rue Racine
                     69780 Mions
Si vous m'envoyer 50FF ou un programme que vous avez ralis,
je vous enverrais alors la dernire version du logiciel ainsi que
mes autres ralisations pour FALCON et qq DP intressants.
Je vous enverrai la version du logiciel qui permet de sauver l'cran dans
les rsolutions obtenues grace aux cartes tels que BLOWUP ou SCREENBLASTER
ou aux logiciels comme Falcon Screen.
Vous aurez galement la possibilit de recevoir gratuitement toutes les
nouvelles version du logiciel (en ne payant que les frais de port et la
disquette).

Si vous dsirez les sources faites moi parvenir 70 FF.Je vous les
enverrais ainsi que mes dernires ralisations.

Versions futures:
Convertisseur CPIZ et CRIC plus rapides car recrit en C et compils en
68030.
SNAPSHOTs qui sauvegarderont directement en TGA si il y a assez de place
en memoire sinon ils sauvegarderont en PIZ ou RIC comme actuellement.

Signalez moi les eventuels pbs,bugs, notament avec les ecrans VGA.

                           ------------------
   SNAPFAL.PRG:

   Ce programme est un snapshot(copieur d'ecran) qui fonctionne dans toutes
les rsolutions standards du FALCON(pas celles obtenues grace  une carte
(screenblaster) ni avec un logiciel du type FS, cela sera fait dans la
prochaine version je pense, mais par contre il marche en overscan).
Il n'a t test qu'avec un cran de type RVB mais il devrait fonctionner
en VGA (sauf bug).
Pour l'installer, il faut donc lancer SNAPFAL.PRG .
Lorsque vous dsirez faire une copie d'cran, pressez Alt+Help, un fichier
.PIZ est alors cre dans le repertoire courant.
Ce fichier cran est organis de la facon suivante:

         -2 octets qui contiennent la valeur de XBIOS(88) au moment de la
sauvegarde.Cela permet de dterminer la rsolution ainsi que le nombre de
couleurs.

         -taille variable:la palette.Si le falcon se trouvait en mode
graphique compatible ST, la taille de la palette sera de nbre couleurs*2
octets. Sinon, en mode graphique Falcon, la palette aura une taille de
nbre couleurs*4 octets. Si mode True Color, alors il n'y a pas de palette.

         -taille variable:l'cran

L'interet de sauver dans ce format (qui est proche dans sa conception du
format DEGAS) plutot que dans un format standard TGA, XIMG,GIF... est
qu'il n'y a pas besoin de rserver de la place en memoire pour stocker
l'image dans le format standard (TGA...) car ce format est celui du FALCON
et ne ncessite pas de conversion avant sauvegarde.
                        -------------------
   VISUPIZ.PRG:

Pour visualiser ces images, vous pouvez utiliser le programme VISUPIZ.PRG
qui charge et affiche toutes les images ayant pour extension .PIZ qui se
trouvent dans le repertoire courant.Il affiche la premire image et attend
que vous appuyez sur la souris.Si vous pressez sur la touche de gauche il
va charger la prochaine image .PIZ, si vous appuyez sur le bouton droit
vous pouvez quitter le visualiseur.
Ce programme n'a pas la prtention d'etre parfait, mais il a simplement
pour but de permettre de vrifier que la capture d'cran s'est bien
ralise mais il permet nanmoins d' afficher toutes les images quelque
soit leur rsolution.

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

    CPIZ104.PRG
(C) Janvier 1994
Un nouveau convertisseur en remplacement de PIZ_TGA qui etait limit au
true color et qui etait peu convivial(on ne pouvait pas faire pire).

Il transforme en TGA 24 bits mais pas trop rapidement pour l'instant (
cette version  t ecrite en GFA 3.6 TT)... je vais l'amliorer.
Par ailleur, il ne traite pas non plus les images sauves dans les
modes compatibles ST, cela sera fait d'ici peu.
                        ----------------
UTILISATION DES IMAGES PIZ.

Pour utiliser ces images dans vos programmes, il faut analyser la valeur
des 2 premiers octets pour dterminer la rsolution,le nbre de couleur et
donc la taille de la palette.Il faut ensuite utiliser cette valeur avec
XBIOS 88 puis charger la palette et l'initialiser en utilisant la fonction
XBIOS 93 et enfin charger l'image ecran.

XBIOS(88,resol ):resol est un mot (2 octets).si resol=-1 alors xbios(88)
renvoie la resolution actuelle.
resol:FEDCBA9876543210

bit 0  2: nbre de bit par pixel donc nbre de couleurs:
           0 : 1 bit,2 couleurs
           1 : 2 bits, 4 couleurs
           2 : 4 bits, 16 coul
           3 : 8 bits, 256 coul
           4 : 16 bits,65536 couleurs ->pas de palette

bit 3: 40 ou 80 colonnes

bit 4: RVB ou VGA

bit 5: PAL ou NTSC (50 ou 60 Hz en fait)

bit 6: NORMAL ou OVERSCAN

bit 7: mode compatible st

bit A: environ 200 ou environ 400 lignes

les autres bits sont inutiliss.

XBIOS (93,premc,dernc,*adpalette):
premc=1ere couleur qui va etre modifie
dernc=derniere couleur qui va etre modifie
*adpalette=adresse de la palette code sur 3 octets.
                   --------------

                   --------------
Avril 1993 :
ide du snapshot pour pouvoir utiliser la version de dmo de STUDIO PHOTO.
1ere version de snapfal.

29 mai 1993:
modif du programme de snap car bug avec le mode true colors, des bombes
apparaissaient lors de l'appui sur alt Help.

juin 1993:
modif du programme piz_tga car il ne voulait pas s'executer en mode
true color.

novembre 1993:
qq modifs sur SNAPFAL car il semble qu'il y ait des pbs avec
les modes VGA.

janvier 1994:
cration du programme CPIZ101.PRG qui permet de convertir les images
.PIZ en TGA 24 bits.
modifs dans le programme CPIZ ce qui fait que l'on est maintenant
 la version 1.03(cration de ressources, 1 pour les modes graphiques
avec plus de 4 couleurs, et 1 pour les modes < 4 couleurs).

fevrier 1994:
Modif de Visupiz car pb avec les images VGA.
version 1.04 du programme CPIZ qui comporte un formulaire en plus o on
voit o en est le droulement de la conversion. En effet dans les versions
prcdentes, on ne savait pas ce qui ce passait (a part moi) et on pouvait
croire qu'il y avait un bug. Je reconnait que c'tait un peu nul...
Cration de SNAP2.PRG et de CRIC.PRG(fait  partir de CPIZ) qui permet de
sauver l'cran dans les rsolutions obtenues grace  SCREENBLASTER, BLOWUP
,FALCON SCREEN...

divers:
-------
-big smacks for Yasmine my love...

-Un bonjour  Christophe Bray

                        ENGLISH DOC
                        -----------

SNAPFAL:

This program is a snapshot for ATARI FALCON that snap all standard
resolutions of the falcon.
install it by clicking in the .PRG program, then when you press
Alt-Help, the current screen will be save on the current directory
with the name n.piz .
n is a number.
The structure of the piz format is this follow:

byte 1-2: value of xbios(88)
various size: the color palet: if true color this size=0, else this
size=number of color*4 bytes (if falcon resolution mode)
size=number of color*2       (if st resolution compatible mode)

various size: the screen

You can convert true color .PIZ image with CPIZ104.PRG program that is
include.

SNAP2:
It's a new version of snapfalc that permits to save the screen in all
resolutions of the FALCON.

                           --------
THIS PROGRAM IS SHAREWARE, IF YOU USE IT, PLEASE SEND ME 50FF OR 10$ OR
6 L OR 15DM (IN STAMPS or BILLS FOR $ and L and DM) OR YOU CAN ALSO
SEND ME A PROGRAM THAT YOU HAVE MADE.
THEN YOU LL RECEIVE MY LATEST CREATIONS FOR ATARI ST AND FALCON.
YOU LL RECEIVE ALSO SNAP2 THAT SNAPS IN EXTENDED RESOLUTIONS OF THE FALCON
(THAT ARE OBTAIN WITH SCREENBLASTER...)
IF YOU WANT THE SOURCE,SEND ME 70FF (15$,9L,20DM). I SEND YOU ALSO MY LATEST
CREATION.
I'll be also happy if only you 'll send me a postcard.

report me the bugs and problems.
I search all programs for Falcon, if you have writing one, please send it
to me, back i send you mine.



Long live the Atari Falcon !!!


                           --------

Vous pouvez galement m'crire pour me demander ma liste de logiciels
du domaine public pour ST et FALCON.
Joignez 3FF en timbres pour les frais de port.
Le prix de la disquette est de 13FF la disquette DD frais de port inclus
et de 16 FF pour une disquette HD.