SetPointShapes — Select a point shape for each data set
$plot->SetPointShapes($pt
)
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 10 point shapes to chose from.
$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:
Shape Name | Description |
---|---|
circle | A hollow circle centered on the point. |
cross | An X centered on the point. |
diamond | A filled diamond (square rotated 45 degrees). |
dot | A filled circle centered on the point. |
halfline | A short line from the point going left. |
line | A horizontal line centered on the point. |
plus | A plus sign centered on the point. |
rect | A filled square centered on the point. |
triangle | A filled triangle pointing down from the point. |
trianglemid | A filled triangle pointing down to the point. |
none | No marker (see notes). |
See Example 5.7, “Line/Point Plot, Point Shapes” for a picture of the shapes.
If an array is used for $pt
, it
must use zero based sequential integer indexes. This is what the PHP manual
calls 'the usual integer indices (starting from zero, increasing by one)'.
This applies only to 'points' and 'linepoints' plot types.
By default, all data sets use the diamond shape.
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. (This is available with PHPlot-5.0rc3 and higher.)