EB DUMP Version 0.9.7				   (c) BARANGER Emmanuel
							       Juin 2006
EB Dump mais qu'est ce donc ?

Et bien soyons clair et pr‚cis. Un petit acc‚ssoire pour faire des captures
d'‚cran. Un de plus et oui !

Mais celui l… il est particulier. Tout d'abord, il offre une pr‚visualisation
de la capture ce qui n'est pas courant.

Et puis il est cens‚ fonctionner partout et tout le temps et dans toutes les
r‚solutions possibles.

de 320x200 jusqu'au limites du GEM.

Monochrome, 4, 16, 256 couleurs, Near True Color 15 et 16 bits et True Color
24 et 32 bits.

Les modes 4 et 16 couleurs non entrelac‚s ne sont pas encore g‚r‚s. Mais qui
les utilisent ?

Bref de quoi voir venir.

Le truc inhabituel, le format de sauvegarde, quelque soit la r‚solution, est
le TGA type 2 True Color 24 bit. Et oui, mˆme en 320x200 16 couleurs sur un
bon vieux et fidŠle ST, la sauvegarde se fera en 320x200x24 bit.

J'ai choisi de faire cela pour plusieurs raisons. 

La premiŠre c'est que c'est un format facile … g‚rer et je ne suis pas toujours 
trŠs courageux. Ensuite, et bien le TGA type 2 et un format reconnu par tous. 
Quelque soit la plateforme les images seront lisibles. C'est tout de mˆme bien
pratique non ?

Voil…. Lorsque quelques retour d'utilisateurs m'auront fait avancer jusqu'…
la version 1.0.0 alors je mettrais les sources en libre t‚l‚chargement. En 
attendant faite de belles captures d'‚cran.

Si vous avez le moindre problŠme avec EB Dump ne soyez pas timides. Je suis
accessible ici : embaranger@free.fr ou via mon site http://helijah.free.fr

Petite nouveaut‚ de la 0.9.3 sp‚cialement pour Fran‡ois LE COAT :

Grƒce … 7 messages systŠme vous pouvez appellez les captures de EB_Dump … partir
de n'importe quelle application rexpectant le GEM et l'AES.

Voici les messages :

eb_dump_capture_fullscreen& = &H4511
eb_dump_capture_window&     = &H4512
eb_dump_capture_mouse&      = &H4513
eb_dump_disable_selector&   = &H4514
eb_dump_enable_selector&    = &H4515
eb_dump_disable_windframe&  = &H4516
eb_dump_enable_windframe&   = &H4517

Un petit exemple c'est plus simple (en GFA c'est plus facile pour moi) :

Tout d'abord, en d‚but d'application, v‚rifier que EB_Dump est pr‚sent en m‚moire
par un simple APPL_FIND. Si c'est bon, on place un flag … TRUE.


id_eb_dump&=APPL_FIND("EB_DUMP ")
IF id_eb_dump&>0
  eb_dump!=TRUE
ENDIF


Puis dans la gestion de votre application, j'ai pris pour exemple le clavier, vous
assignez les ‚venements … envoyer par APPL_WRITE.

' Touche Alternate+F1 Capture plein ‚cran via EB_Dump
IF eb_dump!
  INT{buf%}=eb_dump_capture_fullscreen&		! Num‚ro du message
  INT{ADD{buf%,2}=ap_id&			! Identifiant de l'exp‚diteur
  INT{ADD{buf%,4}=0				! Pas d'‚xc‚dents message
  APPL_WRITE(id_eb_dump&,16,buf%)		! On envoie … EB_Dump
ENDIF

' Touche Alternate+F1 Capture sur fenˆtre via EB_Dump
IF eb_dump!
  INT{buf%}=eb_dump_capture_window&		! Num‚ro du message
  INT{ADD{buf%,2}=ap_id&			! Identifiant de l'exp‚diteur
  INT{ADD{buf%,4}=-1				! Num‚ro de la fenˆtre … prendre (-1 pour utiliser la souris)
  APPL_WRITE(id_eb_dump&,16,buf%)		! On envoie … EB_Dump
ENDIF

' Touche Alternate+F3 Capture zone souris via EB_Dump
IF eb_dump!
  INT{buf%}=eb_dump_capture_mouse& 		! Num‚ro du message
  INT{ADD{buf%,2}=ap_id&			! Identifiant de l'exp‚diteur
  INT{ADD{buf%,4}=zx&				! Coordonn‚e gauche de la zone (-1 pour utiliser la souris)
  INT{ADD{buf%,6}=zy&				! Coordonn‚e haute de la zone
  INT{ADD{buf%,8}=zw& 				! Largeur de la zone
  INT{ADD{buf%,10}=zh&  			! Hauteur de la zone
  APPL_WRITE(id_eb_dump&,16,buf%)		! On envoie … EB_Dump
ENDIF

Et voil…, si appuyez sur Alternate+F1, par exemple, c'est magique, vous sauvez une jolie photo d'‚cran. Si auparavant vous avez envoyer
le message "eb_dump_enable_selector&" l'image sera sauv‚e via le s‚lecteur de fichier, sinon, par d‚faut, elle est directement sauv‚e dans 
le chemin par d‚faut de EB_Dump avec en plus une incr‚mentation automatique de son nom de fichier. De SNAP0000.TGA jusqu'a SNAP9999.TGA.

Si vous demandez une capture par fenˆtre s‚lectionn‚e, vous pouvez activez ou pas la prise en compte du windframe avec les messages
"eb_dump_disable_windframe&" et "eb_dump_enable_windframe&".

A vous de jouer.

Voil…. Merci et … bient“t

BARANGER Emmanuel
