Command Line Options
HyperCam can be started from a batch file, command prompt or another application with a number of command line options (switches) that override the default settings saved in the system registry and can also cause it to start recording immediately. Here is the list of command line switches:
| -rec | HyperCam starts recording immediately at its startup. The HyperCam window is minimized to the taskbar. |
| -recx | Same as -rec, but when recording is stopped (e.g. the user presses the hot key to stop recording), HyperCam will be closed. |
| -hwNN | Selects the recording area to be the same as the area of the window (including its frames and titlebar) with the handle NN, where NN is a number in decimal notation. This option is mainly useful when HyperCam is called from other applications. |
| -xNN -yNN -wNN -hNN |
Selects the recording area (x - left, y - top, w - width, h - height) in pixel coordinates. The upper left corner of the screen is (0, 0). If any value is omitted from the command line, the default value saved in the registry is used. |
| -fNN | Selects the frame rate (in frames per second). NN is a number, decimal fractions are accepted. |
| -a | This option is for specifying the output screen movie filename. The next argument should be the filename itself, for example, HyperCam -a test.avi. Use double quotes to surround the filename, if it contains any spaces. |
| -i+ or -i- | Turns on (+) or off (-) adding an incremental number to the filename. |
| -s+ or -s- | Turns on (+) or off (-) recording sound. |
| -kNN | Sets the key frame value for compressed AVI, WMV or ASF files. NN is an integer number. |
| -hidden | Runs the program with the HyperCam window hidden. |
Example:
SMM_HyperCam.exe -rec -x100 -y100 -w300 -h200 -i- -a test.avi
will start HyperCam in the recording mode. The recorded area will start at (100,100), the width will be 300 pixels and the height will be 200 pixels. The screen movie filename is "test.avi" and no numbers will be appended to the filename.
Controlling another HyperCam window from the command line
The following command line options can be used to control another HyperCam window started earlier. If no other HyperCam window is started, these options do nothing.
| -start | Starts recording, same as if you click the Start Rec. button or press the start hot key. If HyperCam is in the paused mode, it will resume recording. |
| -stop | Stops recording. |
| -pause | Pauses recording or starts paused if HyperCam is not recording at all. |
| -resume | Resumes recording, if it is paused. |
| -hide | Hides the HyperCam window. |
| -show | Shows the HyperCam window in its previous state (if it was minimized when hidden, it will be still minimized after this command). |
| -minimize | Minimizes the HyperCam window. |
| -restore | Restores the HyperCam window. |
| -exit | Exits HyperCam completely. |
Additional options
1. Ensuring that only one instance of HyperCam is started
Only one instance of the HyperCam window is started by default. If you try to run a second isntance, you will only activate and bring to front the already open window. If for some reason you do need two HyperCam windows (e.g. to record the HyperCam program usage tutorial), run
SMM_HyperCam -newwin
2. Finding out the current program status
Run
SMM_HyperCam -getstat
This will only query the running instance for its status and exit immediately without doing anything else, showing any windows, etc. You can read the value from the program exit status or if that is not possible, read it from the registry:
Key: HKEY_CURRENT_USER\Software\Solveig Multimedia\HyperCam 3\State
Value: Status (type REG_DWORD)
The values are: 0 - HyperCam is not running at all, 1 - stopped, 2 - recording, 3 - paused