geometry create curve polyline
Allows you to create a polyline.
Format:
geometry create curve polyline |
|---|
polyline_name = | a new polyline |
comments = | string |
location = | location |
path_curve = | an existing gwire |
relative_to = | an existing model, part or marker |
close = | boolean |
Example:
geometry create curve polyline & |
|---|
polyline_name = | polyline__1 & |
location = | 1,5,3 & |
image_file_name = | "c:\users\ashish\image" |
Description:
Parameter | Value Type | Description |
|---|
polyline_name | A New Polyline | Specifies the name of the new POLYLINE |
comments | String | Specifies comments for the object being created or modified. |
location | Location | Specifies the locations to be used to define the polyline. |
path_curve | An Existing Gwire | Specifies the locations to be used to define the polyline from an existing graphical object. |
relative_to | An Existing Model, Part Or Marker | Specifies the coordinate system that location coordinates are with respect to. |
close | Boolean | Specifies if the polyline is to be open or closed |
Extended Definition:
1. The POLYLINE command provides a means to create a segmented curve that may be open or closed. If closed, the POLYLINE becomes a polygon that can be filled (i.e. shaded). The end points of the POLYLINE do not need to be coincident for you to close it. By setting the CLOSED parameter to "YES" the two end points will be connected with a straight line segment.
The POLYLINE is displayed by connecting any number of LOCATIONS together, in the order in which the LOCATIONS are input, using straight line segments.
The POLYLINE differs from the OUTLINE Adams View geometric element in that the outline requires that you provide a series of markers to define the locations to be connected. The OUTLINE can span multiple parts and the POLYLINE cannot. POLYLINEs are more space efficient than OUTLINEs, taking approximately 40% of the memory required when compared to storing OUTLINEs. Finally, POLYLINEs are not written to the Adams data set, and therefore, do not appear in the Adams graphics file. POLYLINE definitions can be stored in a command file, written to a WaveFront file, and, of course, the binary Adams View file.
In light of being more memory efficient, POLYLINEs are the most efficient means of storing geometry translated from IGES files.
2. Specifies the name of the new POLYLINE. You may use this name later to refer to this POLYLINE. Adams View will not allow you to have two POLYLINE 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 (for example, 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. 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.
4. By default, you supply Cartesian (x, y, z) coordinates. You may use the 'defaults units coordinate_system_type =' command to change this convention. For example, selecting 'cylindrical' means you will subsequently be supplying r, theta, and z coordinates.
Adams View applies your location coordinates in the coordinate system you identify with the RELATIVE_TO parameter. The default for the RELATIVE_TO parameter is the default coordinate system. (See the RELATIVE_TO parameter for this command).
5. The PATH_CURVE is any member of the WIRE_GEOMETRY class (which includes arcs, circles, spline curves, polylines and outlines). When you specify a PATH_CURVE, the values of the vertices are extracted from the specified object and used to compose the polyline.
6. If relative_to parameter is not specified, the default coordinate system is used. The default coordinate system is initially your model, that is, the global coordinate system. You may change the default coordinate system using the 'defaults coordinate_system' command.
7. If closed, the polyline can be filled (that is, shaded). The end points of the polyline do not need to be coincident for you to close it. By setting the CLOSED parameter to "YES" the two end points will be connected with a line segment. If the CLOSE parameter is set to "NO" the polyline will appear as a segmented curve.