highlight
The HIGHLIGHT command changes the appearance of an object, so that you can see its position in the model. Optionally, you can also see the other entities it depends upon or which depend on it.
You can change the color or the line style of the object to highlight it. Adams View will change the appearance of the objects being high- lighted, then wait for you to enter input from the mouse or keyboard before continuing, or wait for a given time period, if specified.
You can specify which entities, related to the selected object, are to be highlighted. This must be one of SELF, DEPENDENTS, REFERENTS, PARTS, or ALL.
SELF indicates that only the selected object is to be highlighted.
DEPENDENTS indicates that the entities that are dependent on the selected object are to be highlighted. If a marker is selected, this would show any constraints, forces, geometry, or parts (if the marker is the center of mass or inertia marker) that depend on it. If a joint is selected, this would show any motions or couplers that depend on it.
REFERENTS indicates that the entities on which the selected object is dependent, are to be highlighted. For constraints, forces, and geometry, this will show any markers that they depend on. For motions and couplers, this will show the joints they depend on.
PARTS indicates that any part on which the selected object are dependent, usually indirectly through one of the part's markers, are to be highlighted. For constraints and forces, this will show the parts that the object affects directly. For dynamic (part-connecting) graphics, this will show the parts that will affect their appearance.
ALL indicates that the selected object plus entities, that would be highlighted by the DEPENDENTS, REFERENTS, and PARTS arguments, are to be highlighted.
Format:
highlight |
|---|
marker_name = | existing marker name |
geometry_name = | existing geometry name |
part_name = | existing part name |
constraint_name = | existing constraint name |
force_name = | existing force name |
color = | existing color |
line_type = | solid, dash, dotdash, dot, none |
time_delay = | real |
entity = | self, dependents, referents, parts, all |
Example:
highlight & |
|---|
marker_name = | marker_28 & |
color = | green & |
line_type = | dotdash & |
time_delay = | 5 & |
entity = | self |
This command will highlight only the MARKER_28. It will display it in green color in the dotdash format. This will be highlighted for 5 seconds
This command will highlight the MARKER_28, as well as all the entities that are dependant it, and all parts on which it is dependant. It will display it in green color in the dotdash format. This will be highlighted for 5 seconds.
Description:
Parameter | Value Type | Description |
|---|
marker_name | Existing Marker | Specifies the name of the marker to be highlighted |
geometry_name | Existing Geometric Entity | Specifies the name of the geometric object to be highlighted. The geometric element may be one of OUTLINE, ARC, CIRCLE, BSPLINE, BLOCK, CYLINDER, FRUSTUM, SPRING_DAMPER, or FORCE. |
part_name | Existing Body | Specifies the name of the part to be highlighted. |
constraint_name | Existing Constraint | Specifies the name of the constraint object to be highlighted. The constraint element may be one of JOINT, JOINT_PRIMITIVE, HIGHER_PAIR_CONTACT, MOTION_GENERATOR, or USER_DEFINED. |
force_name | Existing Force | Specifies the name of the force object to be highlighted. The force element may be one of BEAM, BUSHING, FIELD, TRANSLATIONAL_SPRING_DAMPER, ROTATIONAL_SPRING_DAMPER, TIRE, SINGLE_COMPONENT_FORCE, FORCE_VECTOR, TORQUE_VECTOR, GENERAL_FORCE, or MULTI_POINT_FORCE. |
color | Existing Color | Specifies what COLOR an object should be changed to, when it is highlighted. |
line_type | Solid, Dash, Dotdash, Dot, None | Specifies the selection for the LINE_TYPE for the object or objects being highlighted. |
time_delay | Real | The TIME_DELAY parameter is used to specify the number of seconds to temporarily halt command processing. Command processing will resume after the specified number of seconds has elapsed or when the user types any character on the keyboard or makes a pick with the mouse in the Adams View window. |
entity | Self, Dependents, Referents, Parts, All | Specifies which entities related to the selected object are to be highlighted. |
Extended Definition:
1. You may identify a marker by typing its name or by picking it from the screen.
If the marker is not visible on the screen, you must type the name. You may also find it convenient to type the name even if the marker is displayed.
If you created the marker by reading an Adams data set or graphics file, the marker name is the letters MAR followed by the Adams data set marker ID number. For example, the name of Adams MARKER/101 is MAR101. If you created the marker during preprocessing, you will have given it a name at that time.
If a marker is available by default, you may identify it by entering only its name. If it is not, you must enter its full name. To identify a marker under a different part, for instance, you may need to enter the model and part names, as well. For example, you may specify marker 'pivot' from model 'links', part 'lower_arm' by entering ".links.lower_arm.pivot". If you type a "?", Adams View will list the markers available by default.
You must separate multiple marker names by commas.
If the marker is visible in one of your views, you may identify it by picking on it.
You need not separate multiple marker picks by commas.
2. You may identify geometry by typing its name or by picking it from the screen.
If the geometry is not visible on the screen, you must type the name. You may also find it convenient to type the name even if the geometry is displayed.
If geometry is available by default, you may identify it by entering only its name. If it is not, you must enter its full name. To identify geometry under another model, for instance, you may need to enter the model and part names, as well. For example, you may specify arc 'end' on part 'arm' in model 'susp' by entering ".susp.arm.end". If you type a "?", Adams View will list the geometrys available by default.
You must separate multiple geometry names by commas.
If the geometry 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 geometry picks by commas.
3. You may identify a part by typing its name or by picking it from the screen.
If the part is not visible on the screen, you must type the name. You may also find it convenient to type the name even if the part is displayed.
If you created the part by reading an Adams data set or graphics file, the part name is the letters PAR followed by the Adams data set part ID number. For example, the name of Adams PART/101 is PAR101. If you created the part during preprocessing, you will have given it a name at that time.
If a part is available by default, you may identify it by entering only its name. If it is not, you must enter its full name. To identify a part under another model, for instance, you may need to enter the model name as well. For example, you may specify part 'arm' from model 'robot' by entering ".robot.arm". If you type a "?", Adams View will list the parts available by default.
You must separate multiple part names by commas.
If the part 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 part picks by commas.
4. 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. For example, the name of Adams JOINT/101 is JOI101. If you created the constraint during preprocessing, you will have given it a name at that time.
If a constraint is available by default, you may identify it by entering only its name. 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.
5. You may identify a force by typing its name or by picking it from the screen.
If the force is not visible on the screen, you must type the name. You may also find it convenient to type the name even if the force is displayed.
If you created the force by reading an Adams data set or graphics file, the force name is the first three letters of the Adams statement followed by the Adams data set force ID number. For example, the name of Adams SFORCE/101 is SFO101. If you created the force during preprocessing, you will have given it a name at that time.
If a force is available by default, you may identify it by entering only its name. If it is not, you must enter its full name. To identify a force under a preprocessing model, for instance, you may need to enter the model name as well. For example, you may specify the force named 'bumper' from the model named 'test' by entering ".test.bumper". If you type a "?", Adams View will list the forces available by default.
You must separate multiple force names by commas.
If the force 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 force picks by commas.
6. The object is defined by what you have selected to highlight and the associated objects that are specified in the ENTITY parameter. Therefore, when the COLOR of an object is specified, all objects specified in the entity parameter associated to that object are drawn with the specified COLOR. Adams View supports the following COLOR: black, white, red, green, blue, cyan, magenta, and yellow.
NOTE: If you choose the COLOR of an entity to be drawn in the view background color (typically white or black ), it may not show up. See help for hardcopy.
7. The LINE_TYPE describes how the lines drawn for the wireframe representation of the highlighted objects will look during highlighting. Adams View supports solid, dash, dotdash, and dot. Note that objects highlighted with non-solid line types may look more indistinct as you zoom away from them.
Line Type Appearance
---------------------------------------
solid -----------
dash - - - - - -
dotdash . _ . _ . _
dot . . . . . .
8. The “entity” parameter must be one of SELF, DEPENDENTS, REFERENTS, PARTS, or ALL.
SELF indicates that only the selected object is to be highlighted.
DEPENDENTS indicates that the entities that are dependent on the selected object are to be highlighted. If a marker is selected, this would show any constraints, forces, geometry, or parts (if the marker is the center of mass or inertia marker) that depend on it. If a joint is selected, this would show any motions or couplers that depend on it.
REFERENTS indicates that the entities, on which the selected object is dependent, are to be highlighted. For constraints, forces, and geometry, this will show any markers that they depend on. For motions and couplers, this will show the joints they depend on.
PARTS indicates that any parts on which the selected object is dependent, usually indirectly through one of the part's markers, are to be highlighted. For constraints and forces, this will show the parts that the object affects directly. For dynamic (part-connecting) graphics, this will show the parts that will affect their appearance.
ALL indicates that the selected object plus entities, that would be highlighted by the DEPENDENTS, REFERENTS, and PARTS arguments, are to be highlighted.