hardcopy
Allows you to send screen output to hard copy file. The user may specify the view_name to be sent to the desired hard copy file name. The FILE_NAME parameter provides a means to specify the name of the hard copy file the screen image(s) selected by the user will be written to. The FILE_NAME is an optional parameter, and if not entered, a default name will be constructed. If entered, the file name must be enclosed in quotes.
The ORIENTATION parameter is used to specify how to orient the image sent to a hard copy file. There are two legal values for this parameter: LANDSCAPE and PORTRAIT.
The LANGUAGE parameter is used to specify that plotting language is to be used for the image sent to a hardcopy file. The legal values for this parameter are: BMP, XPM, JPG, TIFF and PNG.
Note: | This command will only function in Adams View sessions launched in interactive mode. It will not function in batch mode Adams View. See “Running Adams Products – On Windows” and “ On Linux” for more detail about the difference between interactive and batch modes. |
Format:
hardcopy |
|---|
window_name = | existing gi_window |
view_name = | existing view |
page_name = | existing page |
file_name = | string |
orientation = | landscape, portrait |
paper_type = | default, eight_by_eleven, a0, a1, a2, a3, a4, b5, b, c, d, e, f |
send_to_printer = | boolean |
language = | BMP, XPM, JPG, TIFF and PNG |
image_width_height = | real,real |
force_black_and_white = | on/off |
setup_only = | boolean |
include_toolbars = | boolean |
Example:
hardcopy & |
|---|
view_name = | view_1 & |
file_name = | “c:\my_files\my_view” & |
orientation = | portrait & |
paper_type = | default & |
image_width_height = | 0.5,0.25 |
Description:
Parameter | Value Type | Description |
|---|
window_name | Existing Gi_window | Specifies an existing window name whose screen output is required |
view_name | Existing View_name | Specifies existing view name |
page_name | Existing Page_name | Specifies existing page name |
file_name | String | Specifies the name of the hard copy file the screen image(s) selected by the user will be written to |
orientation | Portrait/landscape | Specifies how the image sent to a hardcopy file is to be oriented |
paper_type | Default, Eight_by_eleven, A0, A1, A2, A3, A4, B5, B, C, D, E, F | Specifies the size of paper that needs to be used |
send_to_printer | Boolean | Specifies if a printout of the screen output is required |
language | BMP, XPM, JPG, TIFF and PNG | Specifies the plotting language to be used for the image sent to a hardcopy file |
image_width_height | Real,real | Specifies the size of the hardcopy output in the format ( x, y ) |
print_control_panel | On/off | Allows the user to print the control panel graphics when screen output is sent to a hard copy file. |
force_black_and_white | Boolean | Specifies whether or not to override all color specifications in a scene and produce a hardcopy image which is solely black and white. |
Include_toolbar | Boolean | Specifies whether the toolbar is to be included in the screen output |
Extended Definition:
1. Each view created has a name associated with it. The view_name parameter is used to identify a view for a particular operation. In most cases, view_name=all is also a valid entry. The all option indicates "all displayed views". There are eight standard views available when the Adams View is started. These views are: front, top, right, iso, bottom, left, and back. The first four of these standard views are displayed by default when Adams View is started. The user may create new views using the 'VIEW MANAGEMENT CREATE' command, and save/restore their attributes.
If the VIEW_NAME parameter is used, the desired view can be identified by picking in the window or entering the name from the keyboard. Typing the name is the only way to identify a stored view that is not displayed.
2. The FILE_NAME is an optional parameter and if not entered, a default name will be constructed. The file name constructed will be of the form fig_000x.bmp (where x is 1 - 9) if the BMP language is chosen or fig_000x.jpg if the JPG language is chosen. The integer value x will be automatically incremented each time a new default hard copy name is requested. The value x will expand and take the place of the zeros in every order of magnitude increase. Therefore, the tenth file would be named fig_0010.bmp, the 100th file would be named fig_0100.bmp and so on. In this manner, 9999 default hardcopy files can be created, named: fig_0001.bmp up to fig_9999.bmp (or other format’s file extensions).
If entered, the file name must be enclosed in quotes.
3. There are two legal values for the orientation parameter: LANDSCAPE and PORTRAIT. The LANDSCAPE value will cause the image to be oriented such that the top of the image (as seen on the terminal screen) will be along the "long" edge of the paper. The PORTRAIT value will cause the image to be oriented such that the top of the image (as seen on the terminal screen) will be along the "short" edge of the paper.
The ORIENTATION parameter is optional and if not entered, will be set to LANDSCAPE.
4. The legal values for the language parameter are: BMP, XPM, JPG, TIFF and PNG. The resulting file should be printable on any device supporting those languages.
The LANGUAGE parameter is optional, and if not entered, will be set to BMP.
5. The largest possible dimensions for hardcopy output are 1 x 1 ( IMAGE_WIDTH_HEIGHT= 1,1).
These hardcopy dimensions specify a "window" for the image to be fit into. If 1x1 is the maximum, then .5 x .5 will result in an image half as big. Dimensions that are not symmetrical will result in the image being "stretched" or "compressed" to fit the dimensions.
All hard copy output, regardless of its dimensions, is centered on the page.
6. Normally, when a hard copy operation is performed, only the views and their associated graphics are set to the hard copy file. This command allows the control panel graphics to be printed in addition to the view graphics. This way the user gets a hardcopy file which looks exactly the way he sees it on the screen.
7. If the “force_black_and_white” parameter is set to "ON", all of the text and geometry in the hard copy will be black and white. All text, polylines and edges will be black. Polygon faces will be white if the polygon edges are visible, otherwise, they will be black. If this is set to OFF, the colors that you have specified for geometry and text will be present in the hard copy file. Black and white hard copy devices may use shades of gray to represent various colors. If the shades of gray are undesirable, you may set the FORCE_BLACK_AND_WHITE parameter to ON to ensure that the output will consist of solely black and white colors.
Cautions:
■Care should be taken when attempting to get a hard copy. The choice of draw modes in the view (wireframe, solid, shaded, set in the view manage modify command or from the control panel) will have impact on the image sent to the hard copy file. If solid or shaded mode is "On" in the desired view, some graphics may "seem" to disappear. This happens if the image of an entity is such that the edges of the shaded entity obscured the shaded or filled area. To avoid this, use wireframe draw mode or ensure "facet" interiors are visible before the hardcopy is attempted. The choice of background colors can have a similar effect.