group objects add
Allows you to add objects to an Adams View group.
Format:
group objects add |
|---|
group_name = | existing group |
objects_in_group = | existing entities |
expand_groups = | yes/no |
type_filter = | entity type |
Example:
group objects add & |
|---|
group_name = | pendulum_parts & |
objects_in_group = | .model_1.part_2, .model_1.part_3 & |
type_filter = | part |
Description:
Parameter | Value Type | Description |
|---|
Group_name | Existing Group Name | Specifies the group to be modified. You use this parameter to identify the existing group to be affected with this command. |
Objects_in_group | Existing Entity/entities | Specifies the objects to be added or removed from the group. |
Expand_groups | Yes, No | Specifies a Boolean value. |
Type_filter | Entity Type | Specifies the type of objects allowed. |
Extended Definition:
1. The “objects_in_group” parameter takes one or more of any existing Adams View objects.
If a wildcard is used to specify the objects, the TYPE_FILTER parameter can be used to accept only objects of a particular type.
2. When specifying the objects for the “type_filter” operation a wild cards can be used, which may result in too many objects being found. For example, if all the parts for model MOD1 are desired, specifying .MOD1.* will get not only the parts, but all children of the model, like joints, forces and so on. Using the parameter TYPE_FILTER=part will result in only the parts being processed by this command.
group objects attributes
Allows the specification of attributes on all objects in a group which can take attributes.
Format:
group objects attributes |
|---|
group_name = | an existing group |
scale_of_icons = | real |
size_of_icons = | real |
visibility = | on_off_with_toggle |
name_visibility = | on_off_with_toggle |
color = | an existing color |
line_thickness = | real |
line_type = | line_style |
entity_scope = | color_scope |
active = | on_off_no_opinion |
dependents_active = | on_off_no_opinion |
type_filter = | ent |
Example:
group objects attributes & |
|---|
group_name = | group_1 & |
scale_of_icons = | 0.90 & |
visibility = | on & |
name_visibility = | on & |
color = | blue & |
line_thickness = | 0.19 & |
line_type = | dash & |
entity_scope = | fill_color & |
active = | on d & |
dependents_active = | on & |
type_filter = | color |
Description:
Parameter | Value Type | Description |
|---|
group_name | An Existing Group | Specifies the group to be modified. You use this parameter to identify the existing group to be affected with this command. |
scale_of_icons | Real | Specifies a unit-less scale factor to apply to the current icon size. |
size_of_icons | Real | Specifies the size, in modeling units, the Adams View icons will appear in. |
visibility | On_off_with_toggle | Specifies the visibility of graphic entities |
name_visibility | On_off_with_toggle | The NAME_VISIBILITY parameter provides control over the visibility of the view name displayed at the top center position of a given view. |
color | An Existing Color | Specifies the color the modeling entity should be drawn in. |
line_thickness | Real | Specifies the thickness of the line for a curve |
line_type | Line_style | This parameter allows the selection of the line type for a curve. |
entity_scope | Color_scope | The ENTITY_SCOPE parameter is used to control how a color modification is to affect a particular graphic entity. |
active | On_off_no_opinion | When you set ACTIVE=NO, that element is written to the data set as a comment. |
dependents_active | On_off_no_opinion | Specifies whether children of the objects are to be acted upon in the same way as the active parameter does. |
type_filter | Ent | Specifies the type of objects allowed. |
transperency | Integer | Sets the transparency |
Extended Definition:
1. You may identify a group by typing its name.
If a group is available by default, you may identify it by entering only its name. If it is not, you must enter its full name. If you type a "?", Adams View will list the group available by default.
You must separate multiple group names by commas.
2. If no initial size is specified for Adams View icons, the default size will be one modeling LENGTH unit. For example, if the modeling units are K/M/S, a part axes icon will have triad legs of one meter in length.
When you specify SCALE_OF_ICONS, a new size is calculated by multiplying the current size, by the scale, and storing the product as the new ICON_SIZE.
3. If no initial size is specified for Adams View icons, the default size will be one modeling LENGTH unit. For example, if the modeling units are K/M/S, a part axes icon will have triad legs of one meter in length.
When you set SIZE_OF_ICONS at the model level, all Adams View icons used in creating a model will use the size specified.
If the model has an SIZE_OF_ICONS set, and a part under that model has a different SIZE_OF_ICONS, the model's ICONS_SIZE will take precedence.
For Example:
.model ---------------------- SIZE_OF_ICONS =15 meters
.part-------------------- SIZE_OF_ICONS =.125 meters
The part's icon will be 1.5 meters is size.
If the model has SIZE_OF_ICONS of set to 0.0 , and a part under that model has a SIZE_OF_ICONS set to .125, the part's icon size will be used.
For Example:
.model ---------------------- SIZE_OF_ICONS = 0.0 meters
.part -------------------- SIZE_OF_ICONS = .125 meters
The part's icon will be .125 meters is size.
4. Specifies the visibility of graphic entities. The visibility parameter is used to control whether graphic entities, such as markers, joints, and parts, are to be drawn in an Adams View viewport.The legal values for this parameter are: ON, OFF, and TOGGLE. ON will make the desired entity visible. OFF will make the desired entity invisible. TOGGLE will take the current state of an entity’s visibility and reverse it.
5. 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.
6. Adams View allows you to specify the following colors for modeling entities: BLACK, WHITE, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, and NO_COLOR
Specifying 'NO_COLOR' for a modeling entity, instructs Adams View to use the default color for this entity, if there is no color present in its parent modeling entity.
Example 1:
.model -------------------------NO_COLOR
.part---------------------- RED
.geometry(circle) ------- NO_COLOR
The circle will be RED.
Example 2:
.model -------------------------NO_COLOR
.part---------------------- RED
.geometry(circle) ------- BLUE
If a parent modeling entity has a color previously specified, that color takes precedence. Adams View will issue a warning message about color precedence. The circle will be RED.
Example 3:
.model -------------------------NO_COLOR
.part---------------------- NO_COLOR
.geometry(circle) ------- BLUE
The circle will be BLUE.
7. The line type describes how the line will look when displayed on a plot. Adams View supports solid, dash, dotdash, and dot.
Line Type Appearance
solid _______________
dash _ _ _ _ _ _ _ _
dotdash . _ . _ . _ . _
dot . . . . . . . .
8. The legal values for the entity_scope parameter are FILL_COLOR, EDGE_COLOR, OUTLINE_COLOR, and ALL. FILL_COLOR is the color of those areas of a graphic that can be shaded (they include sides of a cylinders, frustums, boxes, etc.) The EDGE_COLOR is the color of the lines making up the edges of the facets (or areas filled by the FILL_COLOR) of a graphic that can be shaded.
The OUTLINE_COLOR represents the color of the lines that make up those graphics that cannot be shaded or filled, like an outline graphic statement consisting of two points or the coil of a springdamper.
Finally, the ALL value indicates that all three entity types, FILL_COLOR, EDGE_COLOR, and OUTLINE_COLOR will be affected by the color change.
The ENTITY_SCOPE parameter is optional and if not entered, will be set to FILL_COLOR.
9. When you set the ACTIVE attribute on an object, you are also setting it on the children of the object. If you set ACTIVE=NO on a part, but wish for a marker on that part to be on, then you must explicitly set ACTIVE=YES on the marker, after setting activation on the part.
The DEPENDENTS_ACTIVE parameter acts in the same fashion, but sets the ACTIVE attribute for the dependents, all the way down the dependency chain. For example, if you execute the following command:
PART ATTRIBUTES PART=PAR1 DEPENDENTS_ACTIVE=NO
Where PAR1 has a marker MAR1 which is the I marker of a joint JOI1 (which has a J marker MAR2), then JOI1 will be deactivated.
Also, if the joint JOI1 is referenced in a request function, or if the I marker is referenced by a request, then the request will be deactivated.
Propagation of activation status through groups is as if each element were to have its activation status changed indvidually.
Elements affected are:
■Group
■Part
■Differential Equation
■Marker
■Geometry
■Constraints
■Forces
■Data Elements
■Output Control
10. When specifying the objects for this operation a wild cards can be used, which may result in too many objects being found. For example, if all the parts for model MOD1 are desired, specifying .MOD1.* will get not only the parts, but all children of the model, like joints, forces, etc. Using the parameter TYPE_FILTER=part will result in only the parts being processed by this command.
group objects copy
Allows you to create replicas of all objects in the group.
Format:
group objects copy |
|---|
group_name = | an existing group |
new_group_name = | a new or existing group |
type_filter = | ent |
search_for_string = | string |
replace_string = | string |
Example:
group objects copy & |
|---|
group_name = | group_1 & |
new_group_name = | group_2 & |
type_filter = | color & |
search_for_string = | "ab" & |
replace_string = | "ba" |
Description:
Parameter | Value Type | Description |
|---|
group_name | An Existing Group | Specifies the group to be modified. You use this parameter to identify the existing group to be affected with this command. |
new_group_name | A New Or Existing Group | Specifies the group the copied objects are to be added to. |
type_filter | Ent | Specifies the type of objects allowed. |
search_for_string | String |
replace_string | String |
Extended Definition:
1. When objects in a group are copied, they are copied in the same manner as other copy operations in Adams View. That is, a replica of the original objects are created, reference markers for the new object are created as needed and a new name is automatically generated.
The newly created objects can be placed into a new or an existing group as they are being copied with the NEW_GROUP_NAME parameter.
2. You may identify a group by typing its name. If a group is available by default, you may identify it by entering its name only. If it is not, you must enter its full name. If you type a "?", Adams View will list the group available by default.