geometry modify curve outline
Allows for modification of an existing outline object.
Format:
geometry modify curve outline |
|---|
outline_name = | an existing outline |
new_outline_name = | a new outline |
adams_id = | adams_id |
comments = | string |
marker_name = | an existing marker |
visibility_between_markers = | on_off |
image_file_name = | string |
horizontal = | clamp_repeat |
vertical = | clamp_repeat |
close = | boolean |
Example:
geometry modify curve outline & |
|---|
outline_name = | OUTLINE__1 & |
new_outline_name = | OUTLINE__2 & |
adams_id = | 1 & |
comments = | "modifying an existing outline" & |
marker_name = | Origin , CM & |
visibility_between_markers = | on & |
close = | yes |
Description:
Parameter | Value Type | Description |
|---|
outline_name | An Existing Outline | Specifies the name of an existing outline |
new_outline_name | A New Outline | Specifies the name of a new outline |
adams_id | Adams_id | Specifies an integer used to identify this element in the Adams data file. |
comments | String | Specifies comments for the object being created or modified. |
marker_name | An Existing Marker | Specifies the marker associated with this entity. |
visibility_between_markers | On_off | Specifies whether the outline is visible between two markers. |
image_file_name | String | Specifies the name of an image file on disk. File types supported include .bmp, .jpg, .gif, and .png. |
horizontal | Clamp_repeat | Controls how the desired polygon is horizontally filled with the image |
vertical | Clamp_repeat | Controls how the desired polygon is vertically filled with the image |
close | Boolean | Specifies the whether or not Adams View should close the outline when it is created. |
Extended Definition:
1. Outlines are line segments (open or closed) that are define by a series of markers.
An outline is composed of at least two and not more than 2500 markers. These markers are connected by line segments to form the outline.
If all of the markers of an outline lie on the same part, the parent of the outline is this part, and the outline moves with this part.
If some of the markers lie on different parts, the parent of the outline is the model. As the parts move, the outline is stretched or "rubber-banded" to fit the new marker locations.
2. You may use the name specified by the new_outline_name later, to refer to this graphic. Adams View will not allow you to have two outlines with the same full name, so you must provide a unique name.
Normally, entity names are composed of alphabetic, numeric, or '_' (underscore) characters, and start with an alphabetic or '_' character. They may be any length. For more information, see
Using Extended Names.
By enclosing the name in double quotes, you may use other printable characters, or start the name with a numeral. If a name contains characters, or starts with a numeral, you must always quote the name when entering it.
Note that you can specify the parentage of an entity (e.g. what part "owns" a marker or a geometry element) when you CREATE it by changing the name. If you enter just the entity name, then the default parent will be assigned by Adams View. If you type in the full name, then you may over ride the default parent. In most cases, when creating an entity, Adams View will provide a default name. The default name that Adams View provides will specify the parentage that it has assumed. You may, or course, delete this name and use your own. The form of a full name is:
"...._NAME.GRAND_PARENT_NAME.PARENT_NAME.ENTITY_NAME"
The number of levels used varies from case to case and the parentage must exist before an entity can be assigned to it.
3. Specifies the outline to modify. You use this parameter to identify the existing outline to affect with this command.
You may identify an outline by typing its name or by picking it from the screen.
If the outline is not visible on the screen, you must type the name. You may also find it convenient to type the name even if the outline is displayed.
If you created the outline by reading an Adams data set or graphics file, the outline name is the letters OUT followed by the Adams data set outline ID number. The name of Adams GRAPHIC/101, OUTLINE is OUT101, for example. If you created the outline during preprocessing, you gave it a name at that time.
If an outline 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 outline under another part, for instance, you may need to enter the model and part names as well. For example, you may specify outline 'profile' on part 'cam' from model 'gizmo' by entering ".gizmo.cam.profile". If you type a "?", Adams View will list the outlines available by default.
Note that outlines may be children of models or parts, depending on whether all the markers are on the same part.
You must separate multiple outline names by commas.
If the outline 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 outline picks by commas.
4. When you use the FILE ADAMS_DATA_SET WRITE command, Adams View writes an Adams data file for your model. Adams requires that each modeling element be identified by a unique integer identifier. If you use this parameter to specify a non-zero identifier, Adams View will use it in the corresponding statement in the Adams data file.
You may also enter zero as an identifier, either explicitly or by default. The next time you write an Adams file, Adams View will replace the zero with a unique, internally-generated identifier. Adams View will permanently store this identifier with the element just as if you had entered it yourself.
Normally, you would let all identifiers default to zero, and Adams View would generate the identifiers for you. You are never required to enter a non-zero identifier. You only need to specify it if, for some reason, you wish to control the Adams file output.
5. When an Adams Solver data file (.adm) is read into Adams View, all comments associated with a statement (from the end of the previous statement through the end of the current statement) are stored with the object. Comments in the data file can be associated with model. These comments must follow the title statement and be followed by the comment 'END OF MODEL COMMENTS'. This string must be uppercase.
When an Adams Solver data file is written, the comments for an object are written before the statement corresponding to the object.
6. Many entities are attached to, or otherwise associated with, a specific marker. You use this parameter to identify that marker.
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. The name of Adams MARKER/101 is MAR101, for example. If you created the marker during preprocessing, you gave it a name at that time.
If a marker 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 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.
7. When you create an outline, by default a line will be drawn between each of the markers specified. Using the VISIBILITY_BETWEEN_MARKERS parameter, you can turn turn off the visibility between desired markers. For example, the following commands:
model create model_name=MOD1 marker create marker=MAR1 location=1,1,0
marker create marker=MAR2 location=2,1,0 marker create marker=MAR3
location=2,2,0 marker create marker=MAR4 location=1,2,0 geometry
create curve outline outline_name=.MOD1.ground.OUT1 &
marker_name=MAR1,MAR2,MAR3,MAR4 &
visibility_between_markers=ON,ON,OFF,ON
will draw lines from MAR1 to MAR2, and from MAR3 to MAR4 there will be no line segment from MAR2 to MAR3.
If you specify the VISIBILITY_BETWEEN_MARKERS parameter with less values than the number of markers, the rest of the visibilities will default to ON. If for example you have an outline with some of the visibilities turned off and you want to turn them all on, you can specify a single ON value.
When you render the outline in solid or shaded mode, each of the contiguously visible segments will be rendered as objets. In the above example, the outline would not be draw as a solid object, but as two lines.
Setting the visibility to OFF for a marker is equivalent to using a negative marker id on the OUTLINE statement in the Adams DATA SET.
8. When you specify 'NO' for the ‘close’ parameter, Adams View will create a outline through the markers specified, and will not attempt to close the start and end points with an additional line segment. 'NO' is the default value.
When you specify 'YES' for this parameter, Adams View will create the outline, through the markers specified, and add an additional line segment from the end marker to the starting marker.