view management create
The create command allows you to create a new view by splitting an existing view either vertically or horizontally. Any of the view attribute parameters available can be set at the time of view creation. Also, the position of the view split (PICK or SCREEN_COORDS), the orientation of the model in the view (OBJECT_ORIENTATION), and the NEW_VIEW_NAME can be set at creation time. The parameters available include the status of the RENDER, PROJECTION, TRIAD_VISIBILITY, and NAME_VISIBILITY parameters. If not entered, these parameters will default to the same as in the viewport being split.
Notes: | ■The parameters are stored as attributes of the viewport, however, the contents of the viewport (e.g. model or analysis) is not. Therefore, if a set of view attributes are RESTORED from the database, the analysis 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. ■If used, this command has one required parameter, NEW_VIEW_NAME. If the view to be split is not entered using the VIEW_NAME parameter, it will default to the active view. The view names can be entered by the keyboard or picked from the screen. |
Format:
view management create |
|---|
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 |
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. |
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 draws 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 and so on) 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 system handles 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 be set up to display graphics in an ORTHOGRAPHIC or a PERSPECTIVE mode. The ORTHOGRAPHIC mode displays the graphics 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 (that is, 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.