plotSetLineSymbol

Purpose

Sets the symbols displayed on the plotted points of a graph.

Format

plotSetLineSymbol(&myPlot, newSymbol[, symbolWidth])
Parameters
  • &myPlot (struct pointer) – A plotControl structure pointer.

  • newSymbol (matrix) –

    new line symbol settings. Options include:

    -1

    None.

    0

    Ellipse.

    1

    Rectangle.

    2

    Diamond.

    3

    Upward pointing triangle.

    4

    Downward pointing triangle.

    5

    Triangle.

    6

    Leftward pointing triangle.

    7

    Rightward pointing triangle.

    8

    Cross.

    9

    Diagonal cross.

    10

    Horizontal line.

    11

    Vertical line.

    12

    Star 1.

    13

    Star 2.

    14

    Hexagon.

  • symbolWidth (scalar) – Optional argument, width to draw line symbols.

Examples

// Declare plotControl structure
struct plotControl myPlot;

// Initialize plotControl structure
myPlot = plotGetDefaults("xy");

// Set line 1 to have no symbol
// Set line 2 to display an ellipse at each plotted point.
newSymbol = { -1, 0 };
symbolWidth = 5;
plotSetLineSymbol(&myPlot, newSymbol, symbolWidth);

// Create data
x = seqa(0.1, 0.1, 50);
y = sin(x)~cos(x);

// Plot the data with the new line symbols
plotXY(myPlot, x, y);

Remarks

This function sets an attribute in a plotControl structure. It does not affect an existing graph, or a new graph drawn using the default settings that are accessible from the Tools > Preferences > Graphics menu.