matplotlib.markers.MarkerStyle — Matplotlib 3.10.3 documentation (original) (raw)
class matplotlib.markers.MarkerStyle(marker, fillstyle=None, transform=None, capstyle=None, joinstyle=None)[source]#
Bases: object
A class representing marker types.
Instances are immutable. If you need to change anything, create a new instance.
Attributes:
markersdict
All known markers.
filled_markerstuple
All known filled markers. This is a subset of markers.
fillstylestuple
The supported fillstyles.
Parameters:
markerstr, array-like, Path, MarkerStyle
- Another instance of MarkerStyle copies the details of that marker.
- For other possible marker values, see the module docstringmatplotlib.markers.
fillstylestr, default: [rcParams["markers.fillstyle"]](../../users/explain/customizing.html?highlight=markers.fillstyle#matplotlibrc-sample) (default: 'full')
One of 'full', 'left', 'right', 'bottom', 'top', 'none'.
transformTransform, optional
Transform that will be combined with the native transform of the marker.
capstyleCapStyle or %(CapStyle)s, optional
Cap style that will override the default cap style of the marker.
joinstyleJoinStyle or %(JoinStyle)s, optional
Join style that will override the default join style of the marker.
filled_markers = ('.', 'o', 'v', '^', '<', '>', '8', 's', 'p', '*', 'h', 'H', 'D', 'd', 'P', 'X')#
fillstyles = ('full', 'left', 'right', 'bottom', 'top', 'none')#
Return a Path for the alternate part of the marker.
For unfilled markers, this is None; for filled markers, this is the area to be drawn with markerfacecoloralt.
Return the transform to be applied to the Path fromMarkerStyle.get_alt_path().
Return a Path for the primary part of the marker.
For unfilled markers this is the whole marker, for filled markers, this is the area to be drawn with markerfacecolor.
Return the transform to be applied to the Path fromMarkerStyle.get_path().
Return user supplied part of marker transform.
markers = {' ': 'nothing', '': 'nothing', '*': 'star', '+': 'plus', ',': 'pixel', '.': 'point', '1': 'tri_down', '2': 'tri_up', '3': 'tri_left', '4': 'tri_right', '8': 'octagon', '<': 'triangle_left', '>': 'triangle_right', 'D': 'diamond', 'H': 'hexagon2', 'None': 'nothing', 'P': 'plus_filled', 'X': 'x_filled', '^': 'triangle_up', '_': 'hline', 'd': 'thin_diamond', 'h': 'hexagon1', 'none': 'nothing', 'o': 'circle', 'p': 'pentagon', 's': 'square', 'v': 'triangle_down', 'x': 'x', '|': 'vline', 0: 'tickleft', 1: 'tickright', 10: 'caretupbase', 11: 'caretdownbase', 2: 'tickup', 3: 'tickdown', 4: 'caretleft', 5: 'caretright', 6: 'caretup', 7: 'caretdown', 8: 'caretleftbase', 9: 'caretrightbase'}#
rotated(*, deg=None, rad=None)[source]#
Return a new version of this marker rotated by specified angle.
Parameters:
degfloat, optional
Rotation angle in degrees.
radfloat, optional
Rotation angle in radians.
.. note:: You must specify exactly one of deg or rad.
Return new marker scaled by specified scale factors.
If sy is not given, the same scale is applied in both the _x_- and_y_-directions.
Parameters:
sxfloat
_X_-direction scaling factor.
syfloat, optional
_Y_-direction scaling factor.
transformed(transform)[source]#
Return a new version of this marker with the transform applied.
Parameters:
transformAffine2D
Transform will be combined with current user supplied transform.