SetDrawYDataLabelLines

SetDrawYDataLabelLines — Draw data label lines for horizontal plots

Synopsis

$plot->SetDrawYDataLabelLines($dydl)

Description

SetDrawYDataLabelLines enables drawing of data label lines for horizontal plot types that support them. Data label lines are horizontal lines drawn from the data points to the edge or edges of the plot with the axis data labels. In the usual case, with the Y axis data labels on the left side of the plot, the data label lines would be drawn from the data points to the left side of the plot area. Depending on the data label locations set with SetYDataLabelPos, the lines would be drawn left, right, or in both directions from the data points to the sides of the plot area.

To use data label lines, you generally want to turn off Y ticks, Y tick labels, and the Y grid lines. Your data array needs to provide data labels, which will be drawn by default on the left side of the plot area.

Parameters

$dydl

True to draw the data label lines, False to not draw the lines.

Notes

Y data label lines only work with these plot types: lines, points, and linepoints, and only when using a data type that indicates a horizontal plot. Data label lines can only be drawn if Y axis data labels are on.

If a graph contains multiple data sets, data label lines drawn from the left edge will end at the maximum X value for each Y value. Data label lines drawn from the right edge will end at the minimum Y value for each X value. (Remember that the X and Y axes are in the same position for vertical and horizontal plots, but the roles of X and Y are reversed for horizontal plots.)

By default, data label lines are not drawn.

For an example of Y data label lines, see Section 5.48, “Example - Horizontal Linepoints Plot with Data Value Labels and Lines”.

This function is for horizontal plot types. For the usual vertical plot types, see SetDrawXDataLabelLines.

History

This function was added in PHPlot-6.0.0. In earlier releases, there was no support for data label lines in any horizontal plot type.

SourceForge.net Logo

This version of the manual was produced for the PHPlot Sourceforge project web service site, which requires the logo on each page.

To download a logo-free copy of the manual, see the PHPlot project downloads area.