interface view create
Allows you to create a new view with user defined location and orientation
The Adams view has some preset views, viz., .gui.main.front, .gui.main.right. The user can create a custom view with predefined orientation and display specifications, which can be created on the main view window or a separate window. The view can be set-up by parameters like eye, target, and up_vector.
Format:
Interface view create |
|---|
view_name = | a new view |
enabled = | boolean |
help_text = | string |
documentation_text = | string |
units = | int_units |
horiz_resizing = | int_h_resize |
vert_resizing = | int_v_resize |
location = | real |
height = | real |
width = | real |
eye = | location |
target = | location |
up_vector = | location |
Example:
interface view create & |
|---|
view_name = | .gui.win.user_view & |
enabled = | yes & |
help_text = | "text2help" & |
documentation_text = | "text2doc" & |
units = | relative & |
horiz_resizing = | attach_left & |
vert_resizing = | attach_top & |
location = | 0.0, 0.0 & |
height = | .4 & |
width = | .4 & |
eye = | 0,0,1000 & |
target = | 500,0,0 & |
up_vector = | 0,1000,0 |
Description:
Parameter | Value Type | Description |
|---|
view_name | A New View | Specifies the name for a new view |
enabled | Boolean | Activates the view |
help_text | String | Specifies the help text |
documentation_text | String | Specifies the documentation text |
units | Int_units | Specifies the view size as pixel or relative to Adams or custom window |
horiz_resizing | Int_h_resize | Specifies the attachment and scaling option for the view |
vert_resizing | Int_v_resize | Specifies the attachment and scaling option for the view |
location | Real | Specifies the location of the view on the dialog box |
height | Real | Specifies the height of the view in terms of relative units or pixel |
width | Real | Specifies the width of the view field in terms of relative units or pixel |
eye | Location | Specifies the camera position and orientation |
target | Location | Specifies the target location which should be centered on the view window |
up_vector | Location | Specifies the upward vector for the view window to describe inclination |
Extended Definition:
1. A view name is string of characters that identifies a viewport or set of viewport attributes stored in the database. 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.
2. The pop-up help and documentation help can be specified initially.
3. The size of the view window can be specified either in terms of number of pixels. Alternatively, the size can also be stated as relative to the Adams or custom window.
4. The vertical and horizontal resizing options are used to adjust the placement of the view window on existing dialog box. For example, attach_left; attach_top options for Horiz_resizing and Vert_resizing will place the view window on the top left corner of the Adams or custom window. The location can also be specified from the top left corner by adjusting the parameter ‘location’
5. The size of the view window can be specified with respect to the custom of Adams window size value for parameter height and width should be a real number between 0.0 and 2.0, where 2.0 represents the height of the Adams or custom window. Therefore, a value of 1.0 will set the view field window to be one half as high as the Adams or custom window.
6. The ‘eye’ is similar to a camera position. The eye is specified by its x,y,z coordinates which specifies the location from where the object is being viewed.
7. The parameter ‘target’ is the location to which is camera is targeted. The ‘target’ is also specified by its x,y and z coordinates. This location will be positioned at the center of the view window to be created.
8. The ‘up_vector’ determines the inclination of the of the camera or the upward direction of the model. For example, setting the up_vector to 0,1000,0, the global y axis will be directed upwards showing the front view of the object, if the eye is set at 0,0,0. Note that, if the eye is set at 0,0,0 which implies that the camera is set at oriGIn, it will not capture the object targeted at unless the object is at sufficient distance in z direction.
9. The camera should be away from the object in the respective axis to view the object – specified by parameter ‘eye’. The target location appears at the center of the view, thus if you target at the center of a circular object, the object will be viewed with its center at the middle of the view window. The inclination of viewing, which is similar to rotating an object, is achieved by setting the up-vector in coordination with ‘eye’.