line

Create primitive line.

Syntax

• go = line()

• po = line(x, y)

• go = line(x, y, z)

• go = line(ax, x, y, z)

• go = line(ax, x, y, z, propertyName, propertyValue)

Input argument

• x, y , z - a scalar graphics object value: parent container, specified as a figure.

• ax - Target axes: axes object.

• propertyName - a scalar string or row vector character.

• propertyValue - a value.

Output argument

• go - a graphics object: line type.

Description

line(x, y) creates a line in the current axes with vectors x and y.

line(x, y, z) creates a line in three-dimensional coordinates.

Properties:

Children [] (currently not used).

Color Line color: RGB triplet, [0, 0, 0] or hexadecimal color code.

DisplayName Legend label: character vector or string scalar, '' (default).

LineStyle Line style: '--', ':', '-.', 'none' or '-' (default).

LineWidth Line width: scalar positive value.

MarkerMarker symbol: 'o' (circle), '+' (Plus sign), '*' (asterik), '.' (point), 'x' (cross), '_' (horizontal line) , '|' (vertical line), 'square', 'diamond', '^' (Upward-pointing triangle), 'v' (Downward-pointing triangle), '>' (Right-pointing triangle), '<' (Left-pointing triangle), 'pentagram', 'hexagram', 'none'(default).

MarkerEdgeColor Marker outline color: RGB triplet.

MarkerFaceColor Marker fill color: RGB triplet.

MarkerSize Marker size: scalar positive value.

Parent Parent: axes graphics object.

Tag Object identifier: string scalar, character vector, '' (default).

Type Type of graphics object: 'line'

UserData User data: array, [] (default).

Visible State of visibility: 'off' or 'on' (default).

XData x values: vector, [0 1] (default).

YData y values: vector, [0 1] (default).

ZData z values: vector, [] (default).

Examples

f = figure();
x = linspace(0,10)';
y1 = sin(x);
y2 = cos(x);
line(x, y1, 'Color', [0 1 0])
line(x, y2, 'Color', [1 0 0])

f = figure();
x = [1 9];
y = [2 12];
line(x,y,'Color','red','LineStyle','--')

f = figure();
t = linspace(0,10*pi,400);
x = sin(t);
y = cos(t);
z = t;
line(x,y,z)
view(3)

See also

plot, plot3.

History

Version	Description
1.0.0	initial version

Author

Allan CORNET