interface object_table create
Allows you to create of a new object_table.
The object_table is used to list one or more types of objects in a modeling environment. For example, a type of entities like link, center_marker or properties like mass, inertia can be selectively listed and displayed using this command. The objects listed can be edited, or copied as required.
Format:
interface object_table create |
|---|
object_table_name = | A New GI_otable |
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 |
commands = | String |
cell_select_commands = | String |
entity_type = | Ent |
fields_for_columns = | String |
column_widths = | Integer |
filter_function = | An Existing Expr_func |
displayed_entities = | An Existing Entity |
parent_entity = | An Existing Entity |
sorting_column_index = | Integer |
type_of_sort = | Sort_type |
ground_reference_frame = | Boolean |
editable = | Boolean |
Example:
interface object_table create & |
|---|
object_table_name = | .gui.obj.otb & |
enabled = | yes & |
help_text = | "text2help" & |
documentation_text = | "text4doc" & |
units = | relative & |
horiz_resizing = | attach_left & |
vert_resizing = | attach_top & |
location = | 0.0, 0.0 & |
height = | 0.6 & |
width = | 0.6 & |
commands = | "interface coord_window display=toggle" & |
cell_select_commands = | "int dialog dis dialog=.gui.moag" & |
entity_type = | link & |
fields_for_columns = | i_marker,j_marker,depth & |
column_widths = | 5 & |
displayed_entities = | LINK_1,LINK_2,BOX_3,BOX_6,LINK_4,LINK_5,BOX_3,LINK_4 & |
parent_entity = | .model_1 & |
sorting_column_index = | 1 & |
type_of_sort = | alphabetic & |
ground_reference_frame = | no & |
editable = | yes |
Description:
Parameter | Value Type | Description |
|---|
object_table _name | A New GI_data_table | Specifies the name for a new object_table to be created |
enabled | Boolean | Activates the object_table |
help_text | String | Specifies the help text |
documentation_text | String | Specifies the documentation text |
units | Int_units | Specifies the object_table size as pixel or relative to Adams window |
horiz_resizing | Int_h_resize | Specifies the attachment and scaling option for the object_table |
vert_resizing | Int_v_resize | Specifies the attachment and scaling option for the object_table |
location | Real | Specifies the location of the object_table on the dialog box |
height | Real | Specifies the height of the object_table in terms of relative units or pixel |
width | Real | Specifies the width of the object_table field in terms of relative units or pixel |
commands | String | Specifies the command to be executed |
cell select commands | String | Specifies the command to be executed whenever any cell is selected |
entity type | Ent | Specifies the entity types to be listed in the object_table |
fields_for_columns | String | Specifies the fields associated with the object to be entered in the columns |
column_widths | Integer | Specifies the column width for a object_table to be created |
filter_function | An Existing Expr Func | Specifies the type of filter to be applied for listing the object types |
displayed entities | An Existing Entity | Specifies the list of entities to be displayed |
parent entity | An Existing Entity | Specifies the parent entity to which the object belongs |
sorting column index | Integer | Specifies the index of the column to be sorted |
type of sort | Sort_type | Specifies the mode of sorting the table contents |
ground reference frame | Boolean | Specifies the ground reference frame |
editable | Boolean | Specifies whether the table contents can be edited or not |
Extended Definition:
1. The preliminary parameters of the object_table like size, associated commands and editing capability are set using this command. The object_table is then prepared by choosing the types of object, filtering function and the parent type. The object_table with specified name is created on the dialog box If parameter ‘Enabled’ is set to ON, the data table is be preactivated.
2. The pop-up help and documentation help can be specified in appropriate columns.
3. The size of the object_table can be specified either in terms of number of pixels. Alternatively, the size can also be stated as relative to the Adams window.
4. The vertical and horizontal resizing options are used to adjust the placement of the object_table menu on existing dialog box. For example, attach_left; attach_top options for Horiz_resizing and Vert_resizing will place the object_table on the top left corner of the dialog box. The location can also be specified from the top left corner by adjusting the parameter ‘location’.
5. The size of the object_table window can be specified with respect to the Adams window size. The 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 dialog window. Therefore, a value of 1.0 will set the object_table field window to be one half as high as the Adams View window.
6. The parameter ‘command’ specifies the name of the command to be executed.
7. ‘Cell select command’ gets executed whenever any cell is selected for editing.
8. The ‘entity_type’ is the type of object to be listed in the table. The object types can be link, box, joint, spline and so on. If the object type is ‘link’ and the ‘parent_type’ is ‘Part_1’, then the links associated with the Part_1 will be listed.
9. ‘Fields for columns’ are the parameters of a an object type to be selected for listing in the object_table. For example, the ‘field for columns’ has three parameters namely, 1) mass, 2) center_marker, and 3) inertia_marker as fields under a model ‘Model_1’ then mass, center_marker, and inertia_marker for all the parts under ‘Model_1’ will be enlisted in the object_table.
10. The column width for field of the object_table can be specified in terms of units like mm or inches. If not specified, it will take the default unit for the width values entered.
11. ‘Filter_function’ is used to limit the scope of the search, if you want, to include all objects beneath a particular object in the database hierarchy by entering the name of the object. For example, enter .model_1 to display all objects under your entire model or enter .model_1.PART_3 to display objects belonGIng only to PART_3.
12. ‘Displayed entities’ can be limited to a few by choosing the entities of interest. Otherwise all the entities for a particular filed will be listed in the object_table. By default the ‘displayed entities’ are ‘Existing all’.
13. The displayed object can further be limited a parent part by choosing ‘parent type’. For example, the ‘field for column’ has the STRING ‘joints’ with ‘parent type’ as PART_1, all the joint applied to the PART_1 will be listed in the object_table.
14. All the data listed in the object_table can be sorted either ‘alphabetically’ or ‘numerically’ as required by choosing the parameter ‘type_of_sort’. Moreover, the all the data will be sorted in accordance with cell contents of the column marked by ‘sorting column index’. The cell contents of the other affected columns will be repositioned according to the sorted cell contents of the column marked by ‘sorting column’. The ‘ground reference frame’ is marked if the BOOLEAN option for ‘ground reference frame’ is ‘yes’.
15. object_table can be edited after initializing it if the BOOLEAN option is ‘yes’ for the parameter ‘editable’