ChartElements

is an option to charting functions such as BarChart that specifies the graphics to use as the basis for bars or other chart elements.

Details

Elements in charts can be based on any Graphics, Graphics3D, or Image object.
The final rendered form of each chart element is obtained by replicating or stretching copies of the base object so as to fill the necessary shape or region.
The following settings for ChartElements can be used:

	None	leave chart elements blank
	Automatic	use a preset default graphic
	g	fill chart elements with copies of g
	{g,All}	stretch a single g to fill each chart element
	{g,{w,h}}	use copies of g with width w and height h
	{g₁,g₂,…}	use g_i for the i element in each dataset
	{spec₁,spec₂,…}	use different specifications for different data dimensions

With a chart element specification of the form {g,{w,h}}, the following width and height specifications can be given:

	s	explicit size in ordinary plot coordinates
	Scaled[s]	size given as a fraction of the chart element region
	Automatic	size determined by the original aspect ratio of g
	All	size that fills the chart element region

Settings for ImageSize and AspectRatio in g are ignored when rendering chart elements, except when w or h is Automatic.
When objects g are rendered for chart elements, their base styles are inherited from the styles defined for each chart element.
Settings for BarOrigin and similar options do not affect either the orientation in which objects g are rendered or the identification of w and h as width and height.
With ChartElements->{g₁,g₂,…}, the g_i are used cyclically to render the chart elements for successive elements in each dataset.
With ChartElements->{spec₁,spec₂,…}, the spec_i are used as chart element specifications for successive dimensions in nested lists of datasets.
ChartElements->{g₁,g₂,…} is effectively taken to give a specification for the innermost dimension of nested lists of datasets.

Examples

Create a pictorial chart based on any Graphics object:

Create 3D pictorial bars:

Top