view management modify
The MODIFY command allows you to MODIFY the definition of a viewport and its attributes. This includes changing the size by altering the original splitting by which a view is created. Any of the view attribute parameters available can be modified, as well as the OBJECT_ORIENTATION in the view, and the NEW_VIEW_NAME. The parameters available include the status of the RENDER, PROJECTION, TRIAD_VISIBILITY, and NAME_VISIBILITY parameters.
Note: | The parameters are stored as attributes of the viewport, however, the contents of the viewport (for example, model or analysis) is not. Therefore, if a set of view attributes are RESTORED from the database, the analysis displayed in the view when the attributes were stored is NOT automatically restored by default. To restore the model to the target viewport as well, use the GRAPHIC_RESULTS SINGLE_FRAME_DISPLAY command. |
Format:
view management modify |
|---|
view_name = | existing view |
new_view_name = | new view |
object_orientation = | angle |
eye = | location |
screen_coords = | real,real |
pick = | location |
render = | render_type |
projection = | projection_type |
triad_visibility = | on/off |
name_visibility = | on/off |
grid_visibility = | on/off/toggle |
spacing_for_grid = | length |
offset_for_grid = | length |
distance_to_origin = | length |
background_color = | existing color |
title_text = | string |
Description:
Parameter | Value Type | Description |
|---|
view_name | Existing View | Each view created has a name associated with it. The view_name parameter is used to identify a view for a particular operation. |
new_view_name | New View | A view name is a string of characters that identifies a viewport or set of viewport attributes stored in the database. |
object_orientation | Angle | The OBJECT_ORIENTATION parameter provides control over the model (analysis_name) angular orientation in the viewport. |
eye | Location | The EYE parameter provides control over the model (analysis_name) angular orientation in the viewport. |
screen_coords | Real,real | Specifies an x,y location in a view on the Adams View screen. SCREEN_COORDS refers to a coordinate reference tied to the terminal screen. |
pick | Location | Specifies a position in a view by picking with the mouse or pen. |
Render | Shaded, Wireframe, Solids, Pshaded, Psolids, Sshaded, Plot | The RENDER parameter controls how the graphics in a viewport should be drawn. |
projection | Perspective, Orthographic | The PROJECTION parameter is used during the creation and modification of a view. |
triad_visibility | On/off | The TRIAD_VISIBILITY parameter provides control over the visibility of the coordinate triad displayed at the lower left corner of a given view. The legal values of this parameter are ON and OFF. This is an optional parameter and if not entered, the triad visibility will be ON. |
name_visibility | On/off | The NAME_VISIBILITY parameter provides control over the visibility of the view name displayed at the top center position of a given view. |
Grid_visibility | On/off/toggle | The GRID_VISIBILITY parameter provides control over the visibility of the grid of a given view. The legal values of this parameter are ON and OFF. |
Spacing_for_grid | Length | The SPACING_FOR_GRID parameter provides control over the spacing between the individual grid points for a given view. |
Offset_for_grid | Length | The OFFSET_FOR_GRID parameter provides control over the offset for the grid points for a given view. The offset is the distance that the grid is moved up and to the right from the center of the view. |
Distance_to_origin | Length | The DISTANCE_TO_ORIGIN parameter provides control over the location of the work plane for a given view. |
Background_color | Existing Color | Specifies the BACKGROUND_COLOR of a view. |
title_text | String | Specifies the text that is to be used as a title for a panel GROUP. When a mutually EXCLUSIVE_GROUP is defined, this text serves as a name for the GROUPs as you cycle through them. |
Extended Definition:
1. 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. View_names are assigned by the user when a view is created. After a view has been created, it may be referenced by its name until it is deleted. A view may not have the same name as another view.
A view_name may be arbitrarily long and a combination of letters of the alphabet and numbers may be used. The leading character must be a letter.
3. The orientation is specified as rotations about the screen fixed coordinate system. This coordinate system has the x axis to the right, the y axis up, and the z axis out of the screen. The orientation starts where the model global axis is aligned with this screen fixed axis. The rotations are done in succession about the screen x first, the screen y second, and the screen z axis third.
If the OBJECT_ORIENTATION parameter is entered it must be three real numbers. This parameter is optional and if not entered the orientation will be the same as the parent window at the time of creation for the VIEW CREATE command and unchanged for the VIEW MODIFY command.
The value of the parameter is transient during the operation of Adams View. This means the OBJECT_ORIENTATION is updated with any rotation of the viewport. So if a particular orientation will be recalled in the future it must be saved using the VIEW MANAGEMENT SAVE command. Then an orientation may be recalled using the VIEW MANAGEMENT RESTORE command.
4. The orientation specified by the “Eye” parameter is determined by drawing a vector from the X, Y, Z EYE point in a global coordinate system to the center of the viewport. This coordinate system has the x axis to the right, the y axis up, and the z axis out of the screen.
If the EYE parameter is entered it can be three real numbers which define the X, Y, Z EYE POINT. The EYE point can also be specified by picking on a currently defined reference frame in the model (either a PART or a MARKER). This parameter is optional and if not entered the orientation will be the same as the parent window at the time of creation for the VIEW CREATE command and unchanged for the VIEW MODIFY command.
The value of the parameter is transient during the operation of Adams View. This means the EYE is updated with any rotation of the viewport. So if a particular orientation will be recalled in the future it must be saved using the VIEW MANAGEMENT SAVE command. Then an orientation may be recalled using the VIEW MANAGEMENT RESTORE command.
5. The “pick” parameter is used in the context of various commands. The response from a pick of the screen is usually the view name and the screen coordinates of the pick. Some of the ways a pick is used is to select the position to split a view to create a new view, to select the box corners of a view to zoom in on, etc.
To enter a pick move the cursor to the location in the desired view using the mouse or pen. Once in the desired position depress one of the mouse buttons.
6. The options for draw modes for each view corresponds to the legal values of the “render” parameter: WIRE_FRAME, SOLID, and SHADED. The wire frame mode only draw lines and arcs of various colors to represent the graphic objects. The SOLID mode draws those graphic objects that have "facets" and therefore, can be shaded (cylinders, frustum, box, etc.) with a solid "flat" color and no highlighting. The SHADED mode draws those graphic objects that can be shaded with highlights that consider light sources and performs dithering, etc.
The draw speed of each mode depends on the hardware Adams View is running on, the complexity of the graphics being displayed, and the draw mode of the graphics being displayed where WIRE_FRAME is the fastest. The draw speed of a SOLID filled or SHADED view is also affected by the way the systemhandles hidden surface removal. Therefore there is a speed and precision mode accessible to the user.
See also the DISPLAY_ATTRIBUTES RENDER_MODE command for additional ways to effect the rendering of specific graphic objects.
7. Any viewport can bet set up to display graphics is an ORTHOGRAPHIC or a PERSPECTIVE mode. The ORTHOGRAPHIC mode displays the graphics as as drawn on a flat piece of paper. However, in the PERSPECTIVE mode, the "screen z translation" of the view will cause a vanishing point effect. This is because by changing the screen z translation, the effective focal length of the imaginary lens through which the graphics are being view, is changed.
The legal values for the PROJECTION parameter are ORTHOGRAPHIC and PERSPECTIVE. The default being ORTHOGRAPHIC. The user should be warned that if PERSPECTIVE mode is used, the effect on view rotations can be confusing. This is because the model is effectively translated off of the plane of the terminal screen to get the vanishing point effect. Therefore, control panel rotations can easily rotate the object off of the screen unexpectedly. On the other hand, use of the PERSPECTIVE mode is all but required if the CAMERA_REF_MARKER parameter is used with the GRAPHIC_RESULTS ANIMATE command.
8. The legal values of the name_visibility parameter are ON and OFF. This is an optional parameter and if not entered the name will be visible (i.e. will be ON).
Note that if the visibility of the view name is turned off the only indication that a view is "active" will be the color of the viewport border. This would be a problem on a black and white monitor.
9. The “distance_to_origin” parameter is the perpendicular distance between the global origin and the work plane. Positive values will place the work plane towards to the eye point of the view (coming out of the screen). Negative values will place the work plane further into the view.
10. Adams View supports the following BACKGROUND_COLORs: black, white, red, green, blue, cyan, magenta, yellow, sky_blue, midnight_blue, blue_gray, and dark_gray.
Cautions:
1. Some geometry may not show up if it is the same color as the BACKGROUND_COLOR of the view in which it is displayed.