constraint attributes
Allows the specification of attributes to be set on an individual constraint or a group of constraints.
Format:
constraint attributes |
|---|
constraint_name = | existing constraint |
scale_of_icons = | real |
size_of_icons = | length |
visibility = | on/off/no_opinion/toggle |
name_visibility = | on/off/no_opinion/toggle |
color = | existing color |
active = | on/off/no_opinion |
dependents_active = | on/off/no_opinion |
Example:
constraint attributes & |
|---|
constraint_name = | joint_1 & |
scale_of_icons = | 1.2 & |
visibility = | on & |
name_visibility = | off & |
active = | on & |
dependents_active = | off |
The above statement will set the new size of the icons by multiplying the current icon size by 1.2. The Joint_1 will be visible since its visibility parameter is turned ON. The visibility of the view name displayed at the top center position of a given view will be turned OFF since the name_visibility parameter is turned OFF.
If JOINT_1 has a marker MAR1 which is the I marker of a joint JOI1 (which has a J marker MAR2), then JOI1 will be deactivated as well because the dependants_active parameter being turned OFF.
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.
Description:
Parameter | Value Type | Description |
|---|
constraint_name | Existing constraint name | Specifies the constraint to modify. |
scale_of_icons | Real | Specifies a unit-less scale factor to apply to the current icon size. |
size_of_icons | Length | Specifies the size, in modeling units, the Adams View icons will appear. |
visibility | On/Off/No_optinion/Toggle | Specifies the visibility of graphic entities. |
name_visibility | On/Off/No_optinion/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 | Existing color | Specifies the color the modeling entity should be drawn in. |
active | On/Off/No_opinion | When you set Active=No, that element is written to the data set as a comment. When you set the Active attribute on an object, you are also setting it on the children of the object. |
dependents_active | On/Off/No_opinion | Sets the active parameters for all the dependants of the constraint. |
Extended Definition:
1. You may identify a constraint by typing its name or by picking it from the screen.
■If the constraint is not visible on the screen, you must type the name. You may also find it convenient to type the name even if the constraint is displayed.
■If you created the constraint by reading an Adams data set, the constraint name is the first three letters of the Adams statement type followed by the Adams data set constraint ID number. The name of ADAMS JOINT/101 is JOI101, for example. If you created the constraint during preprocessing, you gave it a name at that time.
■If a constraint is available by default, you may identify it by entering its name only. If it is not, you must enter its full name. To identify a constraint under a different model, for instance, you may need to enter the model name as well. For example, you may specify constraint 'servo_motor' from model 'test' by entering ".test.servo_motor". If you type a "?", Adams View will list the constraints available by default.
■You must separate multiple constraint names by commas.
■If the constraint is visible in one of your views, you may identify it by picking on any of the graphics associated with it.
■You need not separate multiple constraint picks 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 multipling 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.
An Example:
.model ---------------------- SIZE_OF_ICONS = .15 meters
.constraint -------------------- SIZE_OF_ICONS = .125 meters
The constraint's icon will be 1.5 meters is size.
If the model has SIZE_OF_ICONS of set to 0.0 , and a constraint under that model has a SIZE_OF_ICONS set to .125, the constraint's icon size will be used.
An Example:
.model ---------------------- SIZE_OF_ICONS = 0.0 meters
.constraint -------------------- SIZE_OF_ICONS = .125 meters
The constraint's icon will be .125 meters is size.
4. 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 entities visibility and reverse it.
5. The legal values of the 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).
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. 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
8. You can set the following attributes on a constraint.
■SIZE_OF_ICONS / SCALE_OF_ICONS: These two parameters are mutually exclusive. You may set a size of the icon used for the constraint representation in modeling units, or you may scale the size of the icon by a non-unit scale factor.
■VISIBILITY. You may set a constraint's visibility ON, OFF or TOGGLE the current setting. When you set a constraint's visibility OFF, the constraint will not be drawn. When you set a constraint's visibility ON, you allow that constraint to be drawn.
■NAME_VISIBILITY: You may set a constraint's name label visibility ON, OFF or TOGGLE the current setting with this parameter.
■COLOR: You may set the color of a constraint with this parameter.
If an entity does not have a GRAPHICS ATTRIBUTE setting, the value for that GRAPHIC ATTRIBUTE may be inherited from another entity. INHERITANCE may be either TOP_DOWN or BOTTOM_UP.
BOTTOM_UP and TOP_DOWN refer to the natural hierarchy of the Adams model. The hierarchy is a tree structure with the model at the apex. Parts exist beneath the model, and markers exist beneath the parts. If the icon size of the model is set to 0.1, and the default INHERITANCE is set to TOP_DOWN, then all icons displayed within the model will be displayed at this size. However, if the icon size of a model is set to 0.1, and then the default INHERITANCE is set to BOTTOM_UP, then any icons set to a size other than the model's icon size will be displayed at their own size.
Caution: | 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. |
Tip: | Use the constraint_name parameter to identify the existing constraint to affect with this command. |