SVGGraph options: marker_type

« Return to SVGGraph options page

Option name:
marker_type
Default value:
"circle"
Added in version:
1.0
Data type:
string [?]

The datatypes used in this documentation for specifying SVGGraph options are described below. All options can be a literal value of the data type described, a variable containing the data type, or an expression that will produce the data type when evaluated (and they must always be valid PHP expressions).

array
An array(), the number and data types of its members will depend on the option for which is it used.
boolean
A boolean TRUE or FALSE value, or any values that convert easily such as 1, "1", 0 and "".
callback
A callable function, which can be either the name of a function or an anonymous function itself.
colour
Any of the colour values supported by SVG inside a single or double quoted string. These include three and six digit hex codes, RGB and RGBA colours, and colour names. SVG uses "none" for no colour, which generally leaves things transparent.
fill
A colour value or one of the gradients and patterns supported by SVGGraph. See the SVGGraph colours page for details.
integer
A negative or positive whole number or 0.
number
Any number supported by PHP, for example 1 or -3.2 or 1.63e5 or M_PI.
string
Single or double quoted strings. Remember to double-quote your strings if you are inserting a line break: "Line 1\nLine 2".
Per-dataset:
yes [?]

Per-dataset options allow specifying one option for all datasets or an array of options to be used for each dataset in turn. If there are more datasets than entries in the option array, the sequence will be repeated.

Example:

$settings['widget_taste'] = 'banana';
$settings['widget_colour'] = array('red', 'green', 'blue');

For this example, the widgets for all datasets will taste of banana. The graph will use red widgets for dataset 0, green widgets for dataset 1 and blue widgets for dataset 2. Dataset 3 repeats the sequence so its widgets will be red, dataset 4 will have green widgets and dataset 5 will have blue widgets.

Supported by:
BarAndLineGraph BoxAndWhiskerGraph LineGraph MultiLineGraph MultiRadarGraph MultiScatterGraph RadarGraph ScatterGraph StackedLineGraph
Tags:
marker line scatter radar

Shape of markers.

This option specifies the type of marker to display for line, radar and scatter graphs. The standard types of marker available are:

"circle", "square", "triangle", "cross", "x", "pentagon", "diamond", "hexagon", "octagon", "asterisk", "star", "threestar", "fourstar" and "eightstar"

Example:

$settings['marker_type'] = array('diamond', 'x', 'square');

This will draw diamond-shaped markers for dataset 0, "x"-shaped markers for dataset 1 and square markers for dataset 2.

Image markers

The marker_type option also supports image-based markers. The value of the option should be a string containing "image:" followed by the path to the image to be used as a marker:

$settings['marker_type'] = 'image:/images/marker1.png';

This example will use an image called "marker1.png" as the marker. If the image does not exist, the browser will either display a broken image icon or nothing at in place of the marker - check the error console for clues when this happens, as you may have the path to the image incorrect.

Image markers can be used along with standard markers in a per-dataset array:

$settings['marker_type'] = array(
  'square',
  'image:/images/marker1.png',
  'cross',
  'image:/images/marker2.png',
  'circle'
);

Custom markers

From version 2.24 SVGGraph also supports user-defined markers drawn using your own SVG content - just start the marker_type string with a "<" less-than angle bracket:

$settings['marker_type'] = '<rect x="-3.5" y="-1.5" width="7" height="3"/>';

This will use a 7 pixel by 3 pixel rectangle as the marker. Note that the position of the marker hotspot is at (0,0), so the X and Y coordinates of the rectangle are negative to centre the rectangle at the origin.

A marker shape is stored as a <symbol> in the <defs> section of the document and replicated multiple times on the graph with <use> elements. This means that the SVG code of the marker can be quite complex without drastically affecting the size of the SVG document.

Custom markers can be used anywhere that standard or image markers are supported.

See also:
marker_size marker_colour marker_angle marker_opacity

« Back to top of page Main SVGGraph page »