Ignore:
Timestamp:
Mar 21, 2019, 11:00:38 PM (7 years ago)
Author:
Gregg Young
Message:

Update and cleanup of English documentation

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/english/gotcha_en.ipf

    r58 r60  
    1212:link refid=GBM reftype=fn.GBM.dll:elink. is now required to generate these images.
    1313
    14 :p.&progname. comes in 2 versions the original on screen &progname. and
     14:p.&progname. comes in 2 versions the original on screen
     15:link refid=mainwin reftype=hd.&progname.:elink. and
    1516:link refid=gotquiet reftype=hd.&quiet.:elink. a version that runs in
    16 the background that captures the print screen key combinations and does
     17the background, captures the print screen key combinations and does
    1718a capture based on your preferences.
    1819
    19 :p.&progname. also has features for automatically making a capture every n
    20 seconds or making a capture of the whole screen and then exiting (for
     20:p.&progname. also has features for automatic capture every "n"
     21seconds and for capture of the whole screen and then exiting (for
    2122commandline scripts e.g.).
    2223
    2324:p.&progname. was originally written mainly because all other screen capture
    24 programs for OS/2 that he found were either really old, not free, buggy
    25 and/or part of a larger program.
     25programs for OS/2 found by the original author were either really old, not free,
     26buggy and/or part of a larger program.
    2627
    2728:p.:hp2.What's new?:ehp2.
     
    3031history:elink. to see what features have been added in the various releases.
    3132
    32 :p.If there are more things that would in the program, send your
    33 comments about what you would like to have. Send your comment to the user
    34 mail list or submit a ticket. You will find the contact details
     33:p.If there are more things that you would like to see in the program,
     34send your comments about what you would like to have. Send your comment
     35to the user mail list or submit a ticket. You will find the contact details
    3536:link refid=author reftype=hd.here:elink..
    3637
     
    4647:p.This section shows you the functionality of the various windows
    4748and how to use them.
     49:ul compact.
     50:li.:link refid=mainwin reftype=hd.Main window:elink.
     51:li.:link refid=settings reftype=hd.Settings window:elink.
     52:li.:link refid=snapshot reftype=hd.Snapshot window:elink.
     53:eul.
    4854
    4955:h2 id=mainwin res=2.The main window
     
    5258
    5359:dl break=all tsize=5.
    54 :dt.:hp2.Save image to ...:ehp2.
     60:dt.:hp2.Save image to:ehp2.
    5561:dd.Here you can select, where you want to store the captured image. To
    56 copy the image to the clipboard for pasting into other apllications'
    57 .* FIXME removed "BMP" from "...to a BMP file to..."
     62copy the image to the clipboard for pasting into other applications'
    5863documents select "Clipboard". If you want to write the image to a file
    5964to disk, select "File". Easy, isn't it? &colon.-)
    6065
    6166:p.If you selected "Prompt for filename" in the :link refid=settings1
    62 reftype=hd.settings window:elink., a file dialog will appear after the
    63 capture happened where you can select or enter the filename of the file
    64 the image should be saved to. If you activated "Autosave to numbered
    65 files ...", the filename will be determined automatically. If you selected
    66 "Force saving to file ...", the image will be always written to exactly
    67 the file you specified there (even if you selected "Clipboard" here).
     67reftype=hd.settings notebook:elink., a file dialog will appear after the
     68capture occurs where you can select or enter the filename the image
     69should be saved as. If you activated "Autosave to numbered files",
     70the filename will be determined automatically. It will try to
     71include some information about what was captured as part of the name.
     72If you selected "Force saving to file (&progname. only)", the image will
     73always be written to exactly the file you specified there (even if you selected
     74"Clipboard" here).
    6875
    6976:dt.:hp2.Options:ehp2.
    70 :dd.Check "Hide &progname." if you want the &progname. window to
    71 mysteriously disappear from the screen (using an ancient tibetian
    72 meditation technique) before the capturing starts. Useful if you want to
    73 make a capture of a maximised window e.g. or if you just can't bear the
    74 look.
    75 
    76 :p.Check "Delayed capt." (where "capt." is a neat and striking abreviation
    77 for "capture" as you doubtlessly found out) if you want &progname. to wait
    78 some seconds (configurable in the :link refid=settings3
    79 reftype=hd.settings window:elink.) after you pushed the button/selected
    80 the window/whatever, before the thing is captured. Useful, if you want to
    81 open menus e.g. that should be captured too. If you also selected "Use
    82 serial capture" in the :link refid=settings3 reftype=hd.settings
    83 window:elink., the "serial delay" will be used instead.
    84 
    85 :dt.:hp2.Capture ...:ehp2.
     77:dd.Check "Hide &progname." (&progname. only) if you want the &progname.
     78window to disappear from the screen before the capture starts. Useful if
     79you want to capture a maximized window the full screen without &progname.
     80or something under &progname..
     81:p. Check "Don't reshow" (&quiet. only) if you don't want &quiet.&apos.s
     82settings notebook to reopen after the capture.
     83
     84:p.Check "Delayed capture" if you want &progname./&quiet. to wait "n" seconds
     85(configurable in the :link refid=settings3 reftype=hd.settings notebook:elink.)
     86after you start the capture. Useful, if you want to open menus e.g. that
     87should be captured too. If you also selected "Use serial capture" in the
     88:link refid=settings3 reftype=hd.settings notebook:elink., the "serial delay"
     89will be used instead.
     90
     91:dt.:hp2.Capture:ehp2.
    8692:dd.Select one of the buttons (preferably the one that matches with your
    87 intended capturing target). "Screen" will automatically capture the whole
    88 desktop. "Screen region" allows you to select a part of the screen with the
    89 mouse (or the cursor keys); move the lower left corner of the rectangle that
    90 moves with the mousepointer to the lower left corner of the region you want
    91 to capture, press the mousebutton or enter/return key. Size the rectangle by
    92 moving the mouse or using the cursor keys. Press the mousebutton or enter
    93 again to capture the selected region. "Window" will capture a whole window.
    94 Select the window with the mouse. It will rise to the surface and be captured.
    95 "Window interior" works similar, except that it captures only the inner region
     93intended capture target).
     94:p."Screen" will automatically capture the whole desktop.
     95:p."Screen region" allows you to select an area of the screen with the
     96mouse or the cursor keys; move to the lower left corner of the rectangle that
     97moves with the mouse pointer to the lower left corner of the region you want
     98to capture, press the mouse button or enter/return key. Size the rectangle by
     99moving the mouse or using the cursor keys. Press the mouse button or enter
     100again to capture the selected region. A dialog will open for you to confirm
     101the capture.
     102:p."Window" will capture a whole window. Select the window with the mouse.
     103It will rise to the surface and be captured.
     104:p."Window interior" works similar, except that it captures only the inner region
    96105of the window (not titlebar, etc.).
    97 
    98 :p.To cancel a capture (before it has started, e.g. during the "delayed
    99 capture" delay), just press the escape key (the &progname. main window
    100 must be the active one!) or click the :link refid=snapshot
    101 reftype=hd.snapshot window:elink. with the mouse.
     106:p.To cancel a capture (&progname. only) (before it has started, e.g. during
     107the "delayed capture" delay), just press the escape key (the main window must
     108have focus) or click the :link refid=snapshot reftype=hd.snapshot window:elink.
     109with the mouse.
     110:dt.:hp2.Terminate  &progname. (&quiet. only):ehp2.
     111:dd. "Exit" This exits &quiet. The close button/menu item only close
     112the notebook leaving &quiet. still running.
    102113
    103114:edl.
    104 :p.By selecting "Product information" from the window's system menu (or
    105 pressing "ALT+A") you get a nice about box where you can get
    106 various info about the program.
    107 
    108 :p.By selecting "Settings..." from the window's system menu you will get
    109 the ... yes, exactly, the :link refid=settings reftype=hd.settings
    110 window:elink.! ;-)
    111 
    112 :h2 id=settings res=4.The settings window
    113 :p.The settings window allows you to modify and adjust various things
    114 that modify the behavior of &progname..
    115 
    116 :p.Selecting the "Ok" pushbutton at the bottom of the window will close the
     115
     116:p.Selecting the "About" button (or pressing "ALT+A") opens a nice dialog
     117containing information about the program.
     118
     119:p.Selecting the "Settings" button opens the
     120:link refid=settings reftype=hd.settings notebook:elink..
     121
     122:p.Selecting the "Help" button opens this file.
     123
     124:h2 id=settings res=4.The settings notebook
     125:p.The settings notebook allows you to modify and adjust various things
     126that modify the behavior of &progname./&quiet..
     127
     128:p.Selecting the "OK" pushbutton at the bottom of the window will close the
    117129settings and activate them. Selecting "Undo" will revert all your changes for
    118130the currently selected page of the notebook.
     
    121133:ul compact.
    122134:li.:link refid=settings1 reftype=hd.Saving:elink.
    123 :li.:link refid=settings2 reftype=hd.Snapshot window:elink.
    124 :li.:link refid=settings3 reftype=hd.Misc:elink.
     135:li.:link refid=settings2 reftype=hd.Snapshot window (&progname. only):elink.
     136:li.:link refid=settings3 reftype=hd.Misc (&progname. only):elink.
     137:li.:link refid=settings4 reftype=hd.Capture (&quiet. only):elink.
    125138:li.:link refid=language reftype=hd.Language:elink.
    126139:eul.
    127140
    128 :h3 id=settings1 res=2210.The Saving page
    129 :p.On this page you can select, how the filename for the file, the
    130 captured image should be saved to, will be determined and in what file
    131 format the image should be saved.
     141:h3 id=settings1 res=2210.The "Saving" page
     142:p.On this page you can set how the filename for the image capture save file
     143will be determined and in what image format it should be saved.
    132144
    133145:dl break=all tsize=5.
    134146
    135147:dt.:hp2.Save type:ehp2.
    136 :dd.Here you may select how the filename for the file, the captured image
    137 should be saved to will be chosen&colon.
     148:dd.Here you may select how the filename for the captured image will be
     149chosen&colon.
    138150
    139151:ul.
    140 :li."Prompt for filename" will pop up a file dialog after the capturing,
    141 where you can select or enter the name of the file. Note&colon. Several of
    142 the :link refid=cmdlineargs reftype=hd.command line arguments:elink. will
    143 need to change this settings without further notice!
    144 
    145 :li."Autosave to numbered files in directory ..." will not prompt you for
    146 a filename, but &progname. will create one automatically (of the form
    147 "got?????.ext" where the "?????" will be replaced by a unique number, that
    148 will increase with every saved file
    149 .* FIXME added
    150 and the "ext" by the appropriate extension for the selected image format
    151 .* FIXME
    152 ). You must give a valid directory in
    153 the entryfield underneath to tell &progname. to what location the files
    154 should be saved to.
    155 
    156 :li."Force saving to file ..." will :hp1.always:ehp1. write the image to
     152:li.:hp2.Prompt for filename:ehp2.
     153:p.Opens the save file dialog after the capture, so you can select or enter
     154the name of the file.
     155:p.Note&colon. Several of the :link refid=cmdlineargs reftype=hd.command line
     156arguments:elink. automatically change this settings.
     157
     158:li.:hp2.Autosave to numbered files in directory:ehp2. 
     159:p.This does not prompt you for a filename, but &progname./&quiet. will create
     160one automatically (of the form "tpxxxxxxxx??.ext" where "tp" is the capture
     161type (SC = screen, SR = screen region, WD = Window, WI = Window interior),
     162"xxxxxxxx" is the first 8 characters of the title of the window that has
     163focus (or all the characters if it has less than 8) and "??" will be
     164replaced by a unique number, that will increase with every saved file with
     165the same prefix. The "ext" is replaced by the appropriate extension for
     166the selected image format.
     167:p.You must provide a valid directory in the entry field underneath to
     168tell &progname./&quiet. where the files should be saved. It defaults to
     169the &progname. install directory.
     170
     171:li.:hp2.Force saving to file (&progname. only):ehp2.
     172:p. This will :hp1.always:ehp1. write the image to
    157173the file you give in the entry field underneath, even if you selected
    158174"Clipboard" in the "Save image to ..."  group in the :link refid=mainwin
    159175reftype=hd.main window:elink.. If a file with that name already exists, it
    160176will be overwritten without further warning!
    161 
    162177:eul.
    163178
    164179:dt.:hp2.File format:ehp2.
    165 :dd.Here you may select what format the saved file should have.
     180:dd.Here you may select the save file format.
     181
     182:dt.:hp2.Use sound when capture finished (&quiet. only):ehp2.
     183:dd.Selecting this checkbox will cause &quiet. to beep when the capture
     184is done.
    166185
    167186:edl.
    168187
    169 :h3 id=settings2 res=3.The Snapshot window page
     188:h3 id=settings2 res=3.The Snapshot page (&progname. only)
    170189:p.On this page you can adjust various settings for the :link
    171190refid=snapshot reftype=hd.snapshot window:elink..
     
    179198:dt.:hp2.Capture type:ehp2.
    180199:dd.Here you may select, what kind of capture should be done, when you
    181 click the snapshot window. This types are the same as for the buttons in
     200click the snapshot window. These types are the same as the buttons in
    182201the :link refid=mainwin reftype=hd.main window:elink..
    183202
    184203:dt.:hp2.Options:ehp2.
    185 :dd.Some miscellanious options&colon.
     204:dd.Some miscellaneous options&colon.
    186205
    187206:ul.
    188 :li."Always on top of all windows" - If you select this checkbox, the
    189 snapshot window will never be hidden by other windows, but always float on
    190 top of them.
    191 
    192 :li."Hide when doing a capture" - This is similar to the "Hide &progname."
    193 checkbox in the :link refid=mainwin reftype=hd.main window:elink.. When
     207:li.:hp2.Always on top of all windows:ehp2.
     208:p.If you select this checkbox, the snapshot window will never be hidden
     209behind other windows. It will always float above of them.
     210
     211:li.:hp2.Hide when doing a capture:ehp2.
     212:p.This is similar to the "Hide &progname." checkbox in the
     213:link refid=mainwin reftype=hd.main window:elink.. When
    194214you select this checkbox, the snapshot window will be hidden before a
    195 capture is taken and show up again afterwards.
     215capture and reappear afterwards.
    196216
    197217:eul.
    198218:edl.
    199219
    200 :h3 id=settings3 res=2230.The Misc page
    201 :p.This page features miscellanious other options.
     220:h3 id=settings3 res=2230.The Misc page (&progname. only)
     221:p.This page features "miscellaneous" options.
    202222
    203223:dl break=all tsize=5.
     
    211231
    212232:dt.:hp2.Serial capture:ehp2.
    213 :dd.Using this option, you can &progname. have automatically take a
     233:dd.Using this option, you can have &progname. automatically take a
     234capture every n seconds/20. Just select the checkbox and when you take a
     235capture the next time, &progname. will not stop after the first capture is
     236done. It will wait a number of seconds/20 (that you can adjust with the
     237spinbutton below it) and then capture the screen/screen region/window again
     238and again and again until you press the escape key (the main window must
     239have focus) or click the :link refid=snapshot reftype=hd.snapshot
     240window:elink. (or, in case of a window [interior] capture, until the window
     241to be captured has been closed).
     242:p.:hp1.Note&colon.:ehp1. The amount of time it takes to make the
     243actual capture and to write the image to disk is not included in this
     244delay, as it depends heavily on your system and personal configuration.
     245So if e.g. you want to make a capture every 10 seconds, but it takes 4
     246seconds to capture the screen and write the file, you must set the
     247delay to 120 seconds/20 (6 seconds).
     248:p.The timer used is not really very accurate, especially on slow systems;
     249You will need to experiment to find the settings that work best.
     250
     251:dt.:hp2.Use sound when capture finished:ehp2.
     252:dd.Selecting this checkbox will cause &progname. to beep a few times
     253when the capture is done.
     254
     255:dt.:hp2.Run &progname. at idle priority:ehp2.
     256:dd.Selecting this checkbox will cause &progname. to be run at idle process
     257priority.
     258
     259:edl.
     260
     261:h3 id=settings4 res=2235.The Capture page (&quiet. only)
     262:p.This page features capture options.
     263
     264:dl break=all tsize=5.
     265
     266:dt.:hp2.Capture type:ehp2.
     267:dd.Here you may select, what kind of capture should be done, when you
     268click the snapshot window. These types are the same as the buttons in
     269the :link refid=mainwin reftype=hd.main window:elink..
     270
     271:dt.:hp2.Delayed capture:ehp2.
     272:dd.When you select the "Countdown timer with beeps" checkbox,
     273&progname. will output a beep for every second of the :link refid=mainwin
     274reftype=hd.delayed capture:elink. delay time. With the spinbutton below
     275you can set, how many seconds &progname. should wait when you use
     276"Delayed capture", before actually taking the capture. This is useful if
     277you wish to capture a window with a menu open (start the capture then open
     278the menu during the delay).
     279
     280:dt.:hp2.Serial capture:ehp2.
     281:dd.Using this option, you can have &progname. automatically take a
    214282capture every n seconds/20. Just select the checkbox and when you take a
    215283capture the next time, &progname. will not stop after the first capture is
    216284done, but wait a number of seconds/20 (that you can adjust with the
    217 spinbutton below) and then capture the screen/screen region/window again.
    218 And again. And again. Until you press the escape key (The main window must
    219 be the active one!) or click the :link refid=snapshot reftype=hd.snapshot
    220 window:elink. (or, in case of a window capture, until the window to be
    221 captured has been closed).
     285spinbutton below it) and then capture the screen/screen region/window over
     286and over again until you press the escape key (the main window must
     287have focus) or click the :link refid=snapshot reftype=hd.snapshot
     288window:elink. (or, in case of a window [interior] capture, until the
     289window to be captured has been closed).
    222290:p.:hp1.Note&colon.:ehp1. The amount of time it takes to make the
    223 actual capture and to write the
    224 .* FIXME bitmap -> image
    225 image to disk is not included in this
     291actual capture and to write the image to disk is not included in this
    226292delay, as it depends heavily on your system and personal configuration.
    227293So if e.g. you want to make a capture every 10 seconds, but it takes 4
    228294seconds to capture the screen and write the file, you must set the
    229 delay to 120 seconds/20.
    230 :p.The timer used is not really that accurate, especially on slow systems;
    231 please test yourself what settings work best for you!
    232 
    233 :dt.:hp2.Use sound when capture finished:ehp2.
    234 :dd.Selecting this checkbox will cause &progname. to beep a few times
    235 when the capture is done.
    236 
    237 :dt.:hp2.Run &progname. at idle priority:ehp2.
    238 :dd.Selecting this checkbox will cause &progname. to be run at idle process
    239 priority, which basically means that it will run much slower ;-) But it will
    240 only very little "disturb" other programs that need more CPU time.
     295delay to 120 seconds/20 (6 seconds).
     296:p.The timer used is not really very accurate, especially on slow systems;
     297You will need to experiment to find the settings that work best.
    241298
    242299:edl.
    243300
    244301:h3 id=language res=2240.The Language page
    245 :p.On this page you can select, what language &progname. shall use. You may
    246 select any of the languages that are shown in the list.
     302:p.On this page you can select, what language &progname./&quiet. shall use.
     303You may select any of the languages that are shown in the list. You may
     304also select the help file language (which can be different from the interface
     305language)
    247306
    248307:p.:hp1.Note&colon.:ehp1. If you select another language here, it will not
    249308change until you restart the program.
     309
     310:p.:hp1.Note&colon.:ehp1. Only English has been updated to be consistent
     311with version 2.0 or higher. The other languages work with the updated
     312interface but are partly in English.
    250313
    251314:p.:hp1.Note&colon.:ehp1. If you want to translate &progname. to another
     
    253316reftype=hd."Help wanted!":elink. for more info.
    254317
    255 :h2 id=snapshot res=2300.The Snapshot window
     318:h2 id=snapshot res=2300.The Snapshot window (&progname. only)
    256319:p.This window provides a quick and easy way to take a capture, without
    257320the need to have the :link refid=mainwin reftype=hd.main window:elink.
     
    259322mouse (button 1) and &progname. will take a capture of the type you can
    260323select on the appropriate page in the :link refid=settings2
    261 reftype=hd.settings window:elink. (or from the context menu that pops up
    262 when you click this window with mousebutton 2).
    263 
    264 :p.You may size and position (click with mousebutton 2 and drag it
     324reftype=hd.settings notebook:elink. (or from the context menu that pops up
     325when you click this window with mouse button 2).
     326
     327:p.You may size and position (click with mouse button 2 and drag it
    265328around) the window as you like, the size and position will be saved and
    266329restored when you start &progname. again.
     
    278341such as CAD or Top.
    279342
    280 :p.You may use the "PrintScreen" key combinations to make a capture of the
     343:p.You may use the "Print Screen" key combinations to make a capture of the
    281344screen, a region of the screen, a window or window interior.
    282345:parml compact tsize=3.
    283346:pt.:hp2.Print screen:ehp2.
    284 :pd.Captures to file/Optional command line switch (-p) to print to printer
    285 based on the PM print screen setting.
     347:pd.Captures to file (Optional command line switch (-p) to print to printer
     348based on the PM print screen setting.)
    286349:pt.:hp2.Shift+Print screen :ehp2.
    287350:pd.Also captures to file
    288351:pt.:hp2.Alt+Print screen:ehp2.
    289352:pd.Opens &quiet.&apos.s settings which are very similar to &progname.&apos.s
     353The differences are indicated on the :link refid=mainwin reftype=hd.Main
     354window page:elink. and in the :link refid=settings reftype=hd.settings
     355notebook section:elink..
    290356:pt.:hp2.Ctrl+Print screen :ehp2.
    291357:pd.Captures to clipboard
     
    296362the notebook leaving &quiet. still running.
    297363
    298 :p.:hp1.Example:ehp1.&colon. If you type "gotcha -q c&colon.\bmps" on the
    299 command line, &progname. will save all the files to the directory
    300 "c&colon.\bmps".
    301 
    302364:h1 id=cmdlineargs res=3000.Commandline arguments
    303 :p.In the "Properties" notebook of &progname.'s WPS object or when
    304 starting &progname. from the command line, you may give the following
    305 parameters&colon.
     365:p.In the "Properties" notebook of &progname.'s/&quiet.&apos.s WPS object
     366or when starting &progname./&quiet. from the command line, you may give
     367the following parameters&colon.
    306368
    307369:dl break=all tsize=5.
    308370
    309 :dt.:hp2.-a:ehp2.
     371:dt.:hp2.-a (&progname. only):ehp2.
    310372:dd.Kind of a "batch mode" switch.
    311373
     
    319381
    320382:li.If "Prompt for filename" was selected on the :link refid=settings1
    321 reftype=hd.Saving page:elink. in the settings window, it will be changed
     383reftype=hd.Saving page:elink. in the settings notebook, it will be changed
    322384to "Autosave to numbered files ...".
    323385
     
    329391command line, &progname. will save the captured image to the directory
    330392"c&colon.\". If you do not give a path here, the one you entered on the
    331 Saving page in the settings window will be used.
    332 
    333 :dt.:hp2.-f:ehp2.
     393:link refid=settings1 reftype=hd.Saving page:elink. in the settings notebook
     394will be used.
     395
     396:dt.:hp2.-f (&progname. only):ehp2.
    334397:dd.With this switch you can set the :link refid=settings1
    335398reftype=hd."Force saving to file ..." option:elink. from the command line.
    336399You may give a valid filename after this switch to tell &progname. to what
    337400file the captured image should be written to. If you do not give a
    338 filename here, the one you entered on the Saving page in the settings
    339 window will be used.
     401filename here, the one you entered on the
     402:link refid=settings1 reftype=hd.Saving page:elink. in the settings
     403notebook will be used.
     404
     405:dt.:hp2.-i (&progname. only):ehp2.
     406:dd. Sets &progname. to idle priority. 
     407
     408:dt.:hp2.-p (&quiet. only):ehp2.
     409:dd. Allows the default WPS behavior for "Print Screen". If enabled in
     410the screen settings it will print to the printer. If disabled it will do
     411nothing.
     412
     413:dt.:hp2.-q (&progname. only):ehp2.
     414:dd. This switch is no longer available. Use &quiet..
    340415
    341416:edl.
    342417
    343 :h1 id=pastpresentfuture res=5000.Past, present &amp. future
    344 :p.This section provides info about the history of &progname., some info
    345 about (bugs in) the current release and things that may be added or changed
    346 in the future.
    347 
    348 :h2 id=history res=5001.Version history
     418:h1 id=history res=5001.Version history
    349419
    350420:p.Here you can see what was added or changed
     
    352422
    353423:dl break=all tsize=5.
     424:dt.:hp2.Version 2.0:ehp2.
     425:dd.This version is the first from the Netlabs Gotcha! team and the first
     426built with Open Watcom. The following is a list of changes in this version:
     427:ul compact.
     428:li.Created &quiet. as a replacement for PM's "Print Screen"
     429:li.&quiet. works when VIO windows have focus.
     430:li.Added capture type and part of focus window title to generated file names
     431:li.Add a confirmation dialog for screen region capture
     432:li.Use GBM.DLL to create the image files
     433:li.JPG works consistently now
     434:li.Added png, tiff, tga, pcx, pnm, ppm, db and Jpeg 2000 image types
     435:li.Fixed EA generation
     436:li.Added exceptq support
     437:li.Using the command line settings no longer changes the settings in &inifile..
     438:li.Installer changes/updates
     439:li.Reorganized the settings notebook layout
     440:li.New program icons from David Graser
     441:li.Fixed capture failures and hangs when another program is set to be on top.
     442:li.Fixed hangs when capturing a window with an open menu.
     443:li.Improved code that surfaces other windows for capture.
     444:li.Fixed a failure to update the file extension following an image file format
     445change.
     446:li.Updated the English documentation.
     447:eul.
    354448
    355449:dt.:hp2.Version 1.78:ehp2.
     
    366460:ul compact.
    367461:li.Fixed one bug in savebmp.cpp, while building the file comment in
    368 SetEAs() the value given to ctime was just a time_t, not a &amp.time_t as
     462SetEAs() the value given to ctime was just a time_t, not an &amp.time_t as
    369463required. Might this have been responsible for some of the SYS3175 errors
    370 that occured?
     464that occurred?
    371465:li.Added missing list end tag in portbras.ipf
    372466:li.Got rid of two compiler warnings.
     
    423517images should be saved. The code for saving has totally been re-written and
    424518the images should now load correctly everywhere.
    425 :li.&progname. now sets the correct filetype extended attribute for all
     519:li.&progname. now sets the correct file type extended attribute for all
    426520saved bitmaps.
    427521:li.You may now turn off the sound, that tells you that the capture is done.
    428 :li.A nice :link refid=settings reftype=hd.settings window:elink. for all
     522:li.A nice :link refid=settings reftype=hd.settings notebook:elink. for all
    429523these options.
    430524:li.The :link refid=snapshot reftype=hd.snapshot window:elink. allows
     
    457551:edl.
    458552
    459 :h2 id=bugs res=5013.Known issues
    460 :ul.
    461 
    462 :li.The code for bringing the window to the top (when taking a capture of
    463 a window or window interior) is not very good and may not work correct
    464 from time to time.
    465 
    466 :p.I wanted to start the capture only when the window is fully painted
    467 (i.e. all parts that were hidden by other windows are redrawn) but as
    468 there is no way (at least I know of none) to check when the "bringing on
    469 top" is finished other than checking repeatly if it is the topmost window
    470 by now, this routine will not work if there is a floating window on the
    471 screen, as the to be captured window will never be the topmost window
    472 then.
    473 
    474 :p.The routine currently tries to wait for the window to come on top, but
    475 if this has not happened for 1.5 seconds, the capture will start anyway.
    476 Yukky, I know, but what can I do?
    477 
    478 :eul.
    479 
    480 :h2 id=future res=5002.Future enhancements
    481 :p.Well, there's still a few things that users requested and that will be
    482 added a long time ago in a galaxy far away ... aarg, a future version I
    483 mean ;-)
    484 
    485 :ul.
    486 :li.Remote control feature, that allows you to control &progname.
    487 from other processes using a named pipe.
    488 :li.Allow to specify the window to capture by its name.
    489 :eul.
    490 
    491 :h1 id=disclaimer res=5003.Disclaimer &amp. legal stuff
    492 :p.Following are the usual disclaimers. For those of you, who have read them
    493 far too many times, here is just the short version&colon.
    494 
    495 :p."I didn't do it! I didn't do it! Butthead did it!" ;-)
    496 
    497 :p.Everyone else, please read this and keep in mind&colon.
    498 
    499 :p.Though this program has been tested quite a lot, there may still be lots
    500 of bugs in it (even serious ones - though I do not think so). Do not blame
    501 me, if this program screws up your files or whatever.
    502 
    503 :p.:hp2.YOU ARE USING THIS PROGRAM AT YOUR OWN RISK!:ehp2. I don't take any
    504 responsibillity for damages, problems, custodies, marital disputes,
    505 etc. resulting from use, inability to use, misuse, possession or
    506 non-possession of this program directly or indirectly.
    507 I also don't give any warranty for bug-free operation, fitness
    508 for
    509 a particular purpose or the appropriate behaviour of the program
    510 concerning animals, programers and little children.
    511 
    512 :p.THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
    513 IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
    514 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
    515 PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
    516 PROGRAM IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU
    517 ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
    518 
    519 :p.Or, in a few words&colon.
    520 If its good, I am responsible.
    521 If its bad, its all your fault. ;-)
    522 
    523 :p.Permission is granted to redistribute this program free of charge,
    524 provided it is distributed in the full archive with unmodified
    525 contents and no profit beyond the price of the media on which it
    526 is distributed is made. Exception to the last rule&colon. It may be
    527 included on freeware/shareware collections on CD-ROM, as well as
    528 on magazine cover CD-ROMs.
    529 
    530 :p.All trademarks mentioned anywhere around her are property of their
     553:h1 id=disclaimer res=5003.Disclaimer &amp. license
     554
     555:p.This program is distributed in the hope that it will be useful,
     556but WITHOUT ANY WARRANTY; WITHOUT EVEN THE IMPLIED WARRANTY OF
     557MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE
     558
     559:p.This program is free software; you can redistribute it and/or modify
     560it under the terms of the GNU General Public License as contained in
     561this file.
     562
     563:p.The full source code is available at svn.netlabs.org/repos/gotcha.
     564See http&colon.//trac.netlabs.org/gotcha for details.
     565
     566:p.All trademarks mentioned anywhere around here are property of their
    531567owners and the like ...
    532 
    533 :p.(Strange, this sections is getting longer and longer with every
    534 program ... &colon.-)
    535568
    536569:h2 id=gpl res=5004.GNU GENERAL PUBLIC LICENSE
     
    882915:h1 id=author res=5005.Author &amp. &progname. homepage
    883916:p.:hp7.Author:ehp7.
     917:p.Gregg Young
    884918
    885919:dl break=all tsize=5 compact.
    886920
    887921:dt.:hp2.e-Mail:ehp2.
     922.br
    888923:dd.&email1.
    889 
    890 :dt.:hp2.WWW:ehp2.
    891 :dd.&www.
    892924
    893925:edl.
     
    897929
    898930:p.:hp7.&progname. homepage:ehp7.
    899 :p.Visit the &progname. homepage for info and new versions&colon.
    900 &www.
     931:p.Visit the &progname. homepage for info and new versions&colon. &www.
     932
     933:p.To subscribe to the user list&colon.
     934:p.Send email to&colon. gotcha-user-on@2rosenthals.com and reply to
     935the confirmation email.
     936
     937:p.:hp7.Original author:ehp7.
     938:p.Thorsten Thielen
     939:p.:hp7.&progname. original homepage:ehp7.
     940:p.For older versions of Gotcha!
     941:p.http&colon.//www.c2226.de/programs/gotcha/index.phtml
    901942
    902943:h1 id=helpwanted res=5006.Help wanted!
    903 :p.Now that &progname. supports other languages, I of course want to include
    904 as many as possible. The problem is that I only speak english and german well
    905 enough to do a translation &colon.-) So if anybody out there wants to
    906 translate &progname. to a new language you are gladly welcome to do so!
    907 
    908 :p.I have included the source for the helpfile and program ressources in a
    909 seperate ZIP archive ('language.zip'). Just take the *.rc and *.hlp file of
    910 your choice and go to work! &colon.-) If you have any questions, feel free to
    911 :link refid=author reftype=hd.ask me:elink.!
     944:p.Now that &progname. supports other languages, We of course want to include
     945as many as possible. The problem is that I only speak English. So if anybody
     946out there wants to translate &progname. to a new language or update an existing
     947language you are gladly welcome to do so!
     948
     949:p.The sources for the help file and program resources are in the SVN. For
     950existing languages just take the *.rc and *.hlp file and sync them with the
     951English versions. For new languages simply start with the English versions.
     952If you have any questions or want me to send the files directly to you, feel
     953free to :link refid=author reftype=hd.contact me:elink.!
    912954
    913955:p.If you haven't got the time to do (or just don't feel like doing ;-) a
    914 "full" translation (i.e. program and online help) you may only translate
    915 the program ressources (dialogs, menus, some messages) as well of course!
    916 That would be of much help already ...
     956"full" translation (i.e. program and online help) please consider translating
     957the program resources (dialogs, menus, some messages). That alone would be a
     958great help.
     959
     960:p.To subscribe to the developer list&colon.
     961:p.Send email to&colon. gotcha-dev-on@2rosenthals.com and reply to the
     962confirmation email.
    917963
    918964:h1 id=credits res=5007.Credits
     965:p.The Netlabs Gotcha Team
     966:ul.
     967:li.Gregg Young
     968:li.Andy Willis
     969:li.Rich Walsh
     970:li.Lewis Rosenthal
     971:li.David Graser
     972:eul.
     973
     974:p.Special thanks to the original author of &progname. Thorsten Thielen.
     975
     976:h2 id=credits2 res=5008.Thorsten Thielen's credits
    919977:p.I wish to thank the following people, for their help and support with
    920978&progname.&colon.
     
    926984:li.As many of my programs, &progname. also uses a few lines of code (for
    927985inserting items in the system menu) from :hp1.Richard Papo's:ehp1. excellent
    928 "MemSize" systemressources monitor. (You can find out more about MemSize at
     986"MemSize" system resource monitor. (You can find out more about MemSize at
    929987http&colon.//www.msen.com/~rpapo).
    930988:li.Many thanks for the translation to (Brazilian) Portuguese go to
     
    936994:eul.
    937995
    938 :h1 id=dedication res=5009.Dedication
     996:h1 id=dedication res=5009.Thorsten Thielen's Dedication
    939997:p.:artwork name='..\data\rosaleen.bmp' align=center.
    940998:hp2.
Note: See TracChangeset for help on using the changeset viewer.