
Quick tutorial

This programs are the part of my B.Sc degree project. They are entirely in my native language 
so thats why I have prepared this short introduction on how to use them. Also I have to 
add that Region is rather experimental program, and was tested mainly on Win2K and WinXP
systems. TAppDlg  should run fine starting from Win98. I also can't take any responsibility for
any damages this programs can make so use them on your own risk. If something hangs up
then the best solution is to just kill process ;)

More information con be found in pdf file  (in Polish) on : http://www.pjwstk.edu.pl/~s1525 

REGION and TAppDlg programs

This program creates region files that can be later used with TAppDlg aplication to
show flash animation in windows of various sizes. If you have created .rgn file for your .swf
movie clip than just substitute frameview.swf and frameview.rgn ( you can also alter config.ini)

Running TAppDlg will show shockwave movie in clipped window, that will be using 
data from GUI folder.  There are two files there

 .swf - file with the flash movie
 .rgn - file that defines window region

first file can be used to create region file with program Region. Other way of createing
.rgn file is to use .bmp file also in program Region. 

Program Region can be used to create .rgn files and test flash movies within it. 

Short tutorial: (program is entirely in Polish but its not very complicated - IMO)

to create simple rgn file from .swf file :  

(Both frameview.rgn and frameview.swf should be in Region folder.)

 1) run Region program and klik on 'Plik' menu then choose 'Z swf'a'
 2)  choose your swf file (ie. frameview.swf ) by clicking 'Przegladaj', 

      in textbox 'Skala' you can choose how much to scale your movie 
           (higher values can increase region accuracy),

      in 'Klatka' textbox you can choose which frame of the movie holds region that will be used
      as a clip region.

      Radio buttons 'Wymiary filmu swf' allows you to choose between automatic movie 
         dimmension recognition or manual. 

      After that click 'Akceptuj'.

  3) Now you should see your swf movie, to make a quick test (if you opened frameview.swf)
       click on 'Region' menu and choose 'Testuj' and  then choose region file -> 'frameview.rgn'.
      
  4) To create your own file choose 'Region' -> 'Kolory' to show color picker dialog. 
       This dialog allows you to choose which color will be treated as a color of the region that
       should not be shown. To choose black region of "frameview.swf" movie as a region that should
       not be shown chose second radion box ('koloru na zewnatrz regionu') and then :

                     hold your mouse pressed on button 'Pobierz kolor' and move mouse pointer 
                     (with pressed button) on the black region of "frameview.swf" view, the color choosen
                     should be : 051,051,051. 

       Now click 'Plik' -> 'Zapisz jako' and choose your rgn file name. Later use 'Region' -> 'Testuj'
       to test swf movie with new region.

Some hints :
- remember to create your swf file such that cliped region is in one color for example, black.
- if after choosing 'Region' -> 'Testuj' nothing shows on the screen then probably wrong colors
  where used for region creation, the best way to close such window is to press immediately 'Enter' - this
  will close such dialog. 
- resizing requires some CPU power and on some platform its better when its turned off, also quality of some
  regions during resizing can be low
- a lot of program options can be modified inside config.ini -> for example main window dimmensions, or
  scalling

---
Marci Jdrzejewski, 2003-09-30
s1525@pjwstk.edu.pl