Click above to get retro games delivered to your door ever month!

GrabTGA

Capture a Targa image


Syntax

GRABTGA [<switches>] enable | disable


Switch

/k1
Select hotkey CTRL+LEFT SHIFT (default).

/k2
Select hotkey ALT+LEFT SHIFT.

/k3
Select hotkey LEFT SHIFT+RIGHT SHIFT.

/k4
Select hotkey CTRL+ALT.

/k5
Select hotkey CTRL+RIGHT SHIFT.

/k6
Select hotkey ALT+RIGHT SHIFT.

/s<n>
Set starting GRAB<nnnn> file number to <n> (default is 1)

/16
Saves as 16-bit RGB Targa image.

/24
Saves as 24-bit RGB Targa image.

/32
Saves as 32-bit RGB Targa image.

/bottom
Save with orgin at bottom left corner. Targa 8-bit images typically have a 
top left orgin (default). Targa 16, 24, and 32-bit images are written with 
a bottom left orgin. This switch enables images to be written from a bottom 
left starting orgin.

/clicks
Enable audible clicks at start and conclusion of capture.

/mouse
Use the mouse to select area to capture.


Arguments

enable
Turns on the TSR utility.

disable
Removes the TSR from memory.


Remarks

The default hotkey to grab an image is CTRL+LEFT SHIFT. For multiple 
capture sessions, the grabbed filename will be incremented by the internal 
counter from 1 to 9,999. After 9,999 it will wrap around to 1. The 
starting number, <n>, may be specified in order to organize your images. 
GrabTGA will attempt to save to a unique filename, incrementing by one 
from starting number <n> until it finds the first filename that does not 
exist. It will not overwrite an existing image. Default is not to use the 
mouse selection and audible clicks.

GrabTGA captures only 8-bits of image data. It will save to 8-bit Targa 
format by default, or optionally 16, 24, or 32-bit if the appropriate 
switch is passed. While these images have the correct structure and will be 
treated correctly as 8, 16, 24, or 32-bit images, they will contain only 8 
bits of image data.

In the event that you need to capture a non-standard image format for any 
purpose, if it can be displayed on the monitor, it can be captured by 
GrabTGA. Once your image is captured, it will be saved in the standard 
Targa format and can be processed further just as any standard Targa file.

See "Appendix G" in the Sunshow User Guide for a description of possible 
error messages.


Example

To load GRABTGA.EXE into memory with default hotkey CTRL+LEFT SHIFT, 
capturing 8-bit images,  starting at GRAB10.TGA:

GRABTGA /s10 enable