Modifies the attributes of an existing point.
-
id - an optional ChipsId structure containing values to
modify the currency state for the command or a string id to
modify a point within the current frame.
-
values - a list containing attribute value pairs or a
ChipsPoint object.
The set_point command sets the specified attributes to the
provided values. The modified point becomes current. Multiple
points may be modified with a single command by setting the
currency to "all".
There are several attributes that control the characteristics
of points. The set_point command may be used to modify
the attribute values of an existing point at any time during a
ChIPS session. See
"ahelp attributes"
and
"ahelp setget"
for more general information.
If multiple attributes are being set simultaneously and one of
them fails, the entire command will fail and the point will
not be modified.
The attributes associated with points are:
| angle |
Angle at which the point is drawn |
-360.0:360.0 |
0.0 |
| color |
Color of the point |
name or hex; see the Color section of
"ahelp chipsopt"
|
default |
| depth |
Integer value indicating point depth |
see the Depth section of
"ahelp chipsopt"
|
100 |
| fill |
Controls whether the point is displayed as an outline or solid |
see the Boolean section of
"ahelp chipsopt"
|
true |
| size |
size of the point |
1:100 |
12 |
| style |
Symbol style of the point |
see the Symbol Style section of
"ahelp chipsopt"
|
chips_cross |
The module of advanced ChIPS functions contains other commands
for setting attribute values (refer to "ahelp chips" for
information on loading the module):
set_point_angle
set_point_color
set_point_depth
set_point_fill
set_point_size
set_point_style
chips> set_point({"color","coral", "style", "downtriangle"});
Using attribute/value pairs, set the point color to coral
and symbol style to downtriangles.
chips> settings = ChipsPoint;
chips> settings.color = "blue";
chips> settings.size = 16;
chips> set_point("pnt1",settings);
Populate the "settings" structure with attribute
values, then use it to set pnt1 to be blue with a
size of 16.
chips>a =struct {color, depth};
chips>a.color="cyan",a.depth=50;
chips>set_point(a);
Create a user-defined structure with color and depth
fields. Use the structure to modify the values of the
current point.
A failure would occur if an invalid value was supplied to
set_point_style. The command now errors out correctly.
|
![[ChIPS Logo]](../imgs/chips_logo_navbar.gif){kind=logo}