SetPointShapes

SetPointShapes — Select a point shape for each data set

Synopsis

$plot->SetPointShapes($pt)

Description

SetPointShapes assigns a point shape to each data set in a plot. 'Point' here refers to the marker drawn at each data point in 'points' and 'linepoints' type plots. For example, if each data row contains 4 Y values, the first point shape will be used for the first Y value, the second point shape for the second Y value, etc. There are 20 point shapes to chose from.

Parameters

$pt

An array of point shape names, or a string naming a single point shape. If a string, that shape name is used for all data sets. If an array, the array values name the point shapes for each subsequent data set in a plot. The following shapes are available:

ShapeShape NameDescription
bowtie shape bowtieTwo filled triangles pointing right and left towards the point.
box shape boxA square outline centered on the point.
circle shape circleA hollow circle centered on the point.
cross shape crossAn X centered on the point.
delta shape deltaA filled triangle pointing up, centered on the point.
diamond shape diamondA filled diamond (square rotated 45 degrees), centered on the point.
dot shape dotA filled circle centered on the point.
down shape downAn unfilled triangle pointing down, centered on the point.
halfline shape halflineA short line from the point going left.
home shape homeA filled 5-sided shape, centered on the point.
hourglass shape hourglassTwo filled triangles pointing up and down towards the point.
line shape lineA horizontal line centered on the point.
plus shape plusA plus sign centered on the point.
rect shape rectA filled square centered on the point.
star shape starFour lines crossing at the point.
target shape targetA square outline with two filled squares and two open squares, centered on the point.
triangle shape triangleA filled triangle pointing down from the point.
trianglemid shape trianglemidA filled triangle pointing down to the point.
up shape upAn unfilled triangle pointing up, centered on the point.
yield shape yieldA filled triangle pointing down, centered on the point.
noneNo marker (see notes).

Example 5.7, “Line/Point Plot, Point Shapes” also shows all of the point shapes.

Notes

If an array is used for $pt, it must use zero-based sequential integer indexes.

This applies only to 'points' and 'linepoints' plot types.

By default, ten shapes are used in order: diamond, dot, delta, home, yield, box, circle, up, down, and cross.

A point shape can be set to 'none' to suppress the point markers for that data set. This is only useful with 'linepoints' plot types, and results in a 'lines' plot type for that data set: a line only, but no markers.

PHPlot duplicates the entries in the shorter of the two arrays, point sizes (set by SetPointSizes) and point shapes, to make both arrays the same size. Then it uses the entries in order, restarting at the beginning, for each data set at each X value. For example, if point sizes is (6, 10), and point shapes is ('diamond', 'dot', 'rect'), then PHPlot first extends point sizes to (6, 10, 6) to match the point shapes. If there are 4 data sets to plot, PHPlot draws the point markers at each X value as: diamond (size 6), dot (size 10), rect (size 6), diamond (size 6).

History

Through PHPlot-5.0.7, these ten shapes were available: halfline, line, plus, cross, rect, circle, dot, diamond, triangle, trianglemid, and none. The default shape for all data sets was 'diamond'. Starting with PHPlot-5.1.0, ten new point shapes were added, and different shape defaults were assigned for ten data sets. To restore the behavior in PHPlot-5.0.7 and earlier, call SetPointShapes('diamond').

Using 'none' as a point shape was added in PHPlot-5.0rc3.

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.