USING XPHOTO

Whenever you want to save all or part of your current TransGen ViewGen (or 2PhaseGen) Viewer window display to a graphics file, click on the Xphoto icon in the TransGen Control Menu.

The first time you access Xphoto in the current session, you will be prompted to select the screen on which to display it.  Click on the screen and the Xphoto window will appear:

The options in the Xphoto window allow you to create a PNG, JPEG or Binary RGB format file from all or part the current window display to a specified output file.

Xphoto (hardcopy) options

Capture type

Click on the default option, i.e. Window and select from Region, Window or Whole screen to define the area to be captured to a hardcopy file.

Pre-selection delay (secs)

Default setting 0 secs. This optional setting can be used to set a pre-selection delay, i.e. select and drag the slider control to set an appropriate time interval between selecting the Capture option and selecting the area to be captured.

Post-selection delay (secs)

Default setting 0 secs. This optional setting can be used to set a post-selection delay, i.e. select and drag the slider control to set an appropriate time interval after you have captured an area but before the hardcopy file is created, to give you time to display a pop-down menu for example.

Output format

Click on the default output option, i.e. PNG and select from PNG, JPEG or Binary RGB formats. If JPEG format is selected there is an option to increase/decrease the JPEG quality using a slider control.

Output file

To define the destination and name of the hardcopy output file. Either type in the full path and an appropriate output file name or click on the `...' button to open a chooseFileShell window to navigate to the required directory and then type in the appropriate output file name.

An appropriate path and output file MUST be defined before you can capture an image.

Other options

An optional extra allowing for potential future enhancements and other miscellaneous options.
At present, the following options are available and will be applied if the relevant arguments are typed in the Other options box:-

  -e <err-file>   Any run-time errors and verbose mode diagnostics will be written to <err-file>. If this option is not specified the output is written to standard error. If this option is not specified and -verbose option is used the -nograb option is enabled automatically (to avoid server hangup).

  -noblend     Ignore transparent overlay windows. These are included and blended by default.

-qlength <m>    Max. size in bytes of the XColor array that can be used with the XQueryColors function. (default = X-max-request-size*4). This argument need not normally be supplied but some servers are a little non-standard!

  -verbose    Output verbose diagnostics to the Project Messages Window.

  -nograb   By default Xphoto will grab the X-server while an image is being captured. Use this option to disable the server grab. This option is enabled automatically if any output is being written to stderr or stdout.

Hide window during capture

Default setting "off". Click "on" to hide the Xphoto window while capturing an image.

Control buttons

To Capture the area for hardcopy, Preview the result and Exit from the Xphoto window and/or to view information on the Xphoto features in a Netscape window via the Help button.  

Capture

To capture the relevant region, window or whole screen using the current Xphoto settings.

Preview

To preview the created hardcopy file.

Exit

To close the Xphoto window.

Help

To open a Netscape session displaying details of the Xphoto features as shown below.