notes create
Allows you to create a note, with an optional leader line.
Notes are general purpose text strings that can be used to add annotations to views, plots, or analyses. Notes contain one or more lines of text. You place them by selecting the location for the upper left corner of the text string(s). You should place the text far enough away from the border of the window to ensure that the note will not run off the screen. If you make a mistake, use the 'NOTES MODIFY' command to move the note.
Notes have an optional leader line that can point to a specific spot on the display. This leader line can have 1 to n points, where the last point specified is the location of an arrow head. You may specify a color for the text and leader line.
Format:
notes create |
|---|
note_name = | new note |
text = | string |
location = | location |
pick = | location indicated by a pick in the view |
screen_coords = | real |
size = | length |
unitless_size = | real |
point_size = | integer |
bitmapped_text = | on/off |
leader_line = | location |
arrow_visibility = | on/off |
arrow_size = | real |
user_text = | on/of |
Example:
notes create & |
|---|
note_name = | notes create & |
note_name = | note__1 & |
text = | "this is a new part that i have added" & |
location = | 10.0,10.0,10.0 |
Description:
Parameter | Value Type | Description |
|---|
note_name | New Note | Specifies the name of the new note.You may use this name later to refer to this note. |
text | String | Specifies the text string(s) that will comprise the note text. |
location | Location | Specifies the location to be used to define the note. The location coordinates for plot notes in Adams PostProcessor do not relate to the plot coordinates themselves. They are unfortunately difficult to predict since they depend strongly upon a number of factors including plot aspect ratio, visibility of the title, sub-title and axis labels, Viewport orientation and so on. This is why the direct interactive placement is preferred. Users who really want to script the creation of plot notes are advised to, from the command navigator dialog, use the interactive pick option to fill the location fields. This allows one to see the location coordinates used behind the scenes. |
pick | Pick Location | Specifies a position in a view by picking with the mouse or pen. |
screen_coords | Real | Specifies an x,y location in a view on the Adams View screen. SCREEN_COORDS refers to a coordinate reference tied to the terminal screen. |
size | Integer | Specifies the size, in modeling units, that the note height will appear in. The width of each character in the note is approximately 60%of the height. |
unitless_size | Real | Specifies a real number |
point_size | Integer | Specifies an integer to define the point size |
bitmapped_text | On, Off | Specifies whether or not a note is to be drawn using bitmapped text. |
leader_line | Location | Specifies the screen locations which define a leader line for a note. |
arrow_visibility | On, Off | Specifies whether there should be an arrow head at the last point on the leader line of the note. |
arrow_size | Real | Specifies the size, in modeling units, that the arrow head of the leader line on the note will appear. If arrow_size has not been set, or it is set to zero, the arrowhead will be roughly the size of the text in the note. |
user_text | On, Off | Specifies on or off. |
Extended Definition:
1. Adams View will not allow you to have two notes with the same 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 of 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, of 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.
2. You may enter the text string(s) for this parameter without double quote marks, if the string contains no "blanks" or special characters such as *&^%$#@!-/><.
If the text string(s) do have any of these special characters the string must be quoted.
To enter a multiline note, each line must be entered as a separate string, separated by a comma. An Example:
note create note=.front.n1 screen_coords=0,0 & TEXT="This is a","multi line note" size = .12
This example command would produce a two line note located at the center of the view named 'front', and at a height of .12 units.
Notes are left-justified.
3. The “pick” parameter is used in the context of various commands. The response from a pick of the screen is usually the view name and the screen coordinates of the pick. Some of the ways a pick is used is to select the position to split a view to create a new view, to select the box corners of a view to zoom in on, etc.
To enter a pick move the cursor to the location in the desired view using the mouse or pen. Once in the desired position depress one of the mouse buttons.
4. Bitmapped text provides better looking text and can make use of the fonts available on your system. Bitmapped text will not transform in the same manner as geometry. Only the placement point will move.
The text will always face the screen. Non-bitmapped text (stroked text) will transform in the same manner as geometry.
5. The screen locations are entered by using the mouse cursor. Move the mouse cursor to the desired locations and "click" any mouse button to record the position. Adams View will create a leader line from the first point through successive points, ending with an arrow head at the last point.
6. There is no limit to the number of points in the leader line.