Plot.DrawLine

Prototypes

void DrawLine( Matrix mX, Matrix mY )

void DrawLine( double[] adX, double[] adY )

void DrawLine( double dX1, double dY1, double dX2, double dY2 )

void DrawLine( Matrix mX1, Matrix mY1, Matrix mX2, Matrix mY2 )

void DrawLine( double[] adX1, double[] adY1, double[] adX2, double[] adY2 )

Parameters

Matrix mX, mY
Numeric vectors that define ordered pairs to be connected with lines. These coordinates are assumed to be in the current coordinate system.

double[] adX, adY
Arrays that define ordered pairs to be connected with lines. These coordinates are assumed to be in the current coordinate system.

double dX1, dY1, dX2, dY2
The endpoints of a line as two ordered pairs: (dX1, dY1) and (dX2, dY2). These coordinates are assumed to be in the current coordinate system.

Matrix mX1, mY1, mX2, mY2
Numeric vectors that define ordered pairs for a series of unconnected line segments. These coordinates are assumed to be in the current coordinate system.

double[] adX1, adY1, adX2, adY2
Arrays that define ordered pairs for a series of unconnected line segments. These coordinates are assumed to be in the current coordinate system.

Remarks

This collection of methods draws either a series of connected line segments or a series of unconnected line segments. The lines are drawn using the current pen characteristics.

The methods with two parameters draw a set of line segments connecting the ordered pairs (mX[1], mY[1]), … (mX[n], mY[n]) where n is the number of elements in the vectors mX and mY (and similarly for the Java arrays).

The method with four scalar parameters draws a line segment from (dX1, dY1) to (dX2, dY2).

The methods with four vector parameters draw n line segments. The ith line segment is drawn from (mX1[i], mY1[i]) to (mX2[i], mY2[i]), and similarly for the Java arrays.

Example
x = { 1 2 3 4 5 6 7 8 };
y = { 2 1 4 5 6 5 6 9 };
declare ScatterPlot plot;
plot = ScatterPlot.Create( "Sample Data", x, y );
mX = { 1 2 6 8 };
mY = { 3 3 7 7 };
plot.DrawUseDataCoordinates();
plot.DrawLine( mX, mY ); /* connected line segments */
mX1 = { 3 1 };
mY1 = { 2 6 };
mX2 = { 5 7 };
mY2 = { 6 4 };
plot.DrawLine( mX1, mY1, mX2, mY2 ); /* 2 line segments */
See Also

Plot.DrawPath