U /e4,@sdZddlmZddlZeeZddlmZm Z m Z m Z m Z m Z mZddlmZddlmZmZmZmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+dZ,d Z-d Z.d Z/d Z0d Z1dZ2dZ3dZ4dZ5dZ6dZ7dd8e d8dde DfZ9dZ:GdddeZ;GdddeZGd!d"d"eZ?Gd#d$d$eZ@Gd%d&d&eZAGd'd(d(eZBdS))an Mix-in classes that bulk add groups of properties to Bokeh models. Some groups of properties often show up in Bokeh models together. For instance, any model that exposes a fill color property for use when rendering will almost always want to expose a fill alpha as well. To reduce boilerplate code and simplify defining models with these sets of properties, use the mix-in classes in this module: * |FillProps| --- properties for fill color and alpha * |HatchProps| --- properties for hatching pattern, color, alpha, etc. * |LineProps| --- properties for line color, dashing, width, etc. * |TextProps| --- properties for text color, font, etc. To include these properties in a Bokeh model, use the |Include| property as shown here: .. code-block:: python class SomeGlyph(Glyph): fill_props = Include(FillProps, help=""" The {prop} values for the annular wedges. """) This adds all the fill properties ``fill_color`` and ``fill_alpha`` to this model. The help string contains a placeholder `{prop}`. When docs for this class are rendered by the, the placeholder will be replaced with more information specific to each property. .. |Include| replace:: :class:`~bokeh.core.properties.Include` .. |FillProps| replace:: :class:`~bokeh.core.property_mixins.FillProps` .. |HatchProps| replace:: :class:`~bokeh.core.property_mixins.HatchProps` .. |LineProps| replace:: :class:`~bokeh.core.property_mixins.LineProps` .. |TextProps| replace:: :class:`~bokeh.core.property_mixins.TextProps` .. |miter_join| image:: /_images/miter_join.png :height: 15 .. |round_join| image:: /_images/round_join.png :height: 15 .. |bevel_join| image:: /_images/bevel_join.png :height: 15 .. |butt_cap| image:: /_images/butt_cap.png :height: 12 .. |round_cap| image:: /_images/round_cap.png :height: 12 .. |square_cap| image:: /_images/square_cap.png :height: 12 ) annotationsN) FontStyle HatchPatternHatchPatternAbbreviationLineCapLineJoin TextAlign TextBaseline)HasProps)Alpha AlphaSpecColor ColorSpec DashPatternDashPatternSpecDictEnumFloatFontSize FontSizeSpec FontStyleSpecHatchPatternSpecInstanceIntIntSpec LineCapSpec LineJoinSpecNullable NumberSpecSizeString StringSpec TextAlignSpecTextBaselineSpecvalue) FillProps HatchProps LineProps TextPropsScalarFillPropsScalarHatchPropsScalarLinePropsScalarTextPropsz A color to use to %s with. z# An alpha value to use to %s with. z" Stroke width in units of pixels. z How path segments should be joined together. Acceptable values are: - ``'miter'`` |miter_join| - ``'round'`` |round_join| - ``'bevel'`` |bevel_join| z How path segments should be terminated. Acceptable values are: - ``'butt'`` |butt_cap| - ``'round'`` |round_cap| - ``'square'`` |square_cap| zP Name of a font to use for rendering text, e.g., ``'times'``, ``'helvetica'``. z A style to use for rendering text. Acceptable values are: - ``'normal'`` normal text - ``'italic'`` *italic text* - ``'bold'`` **bold text** - ``"bold italic"`` ***bold italic text*** zy Horizontal anchor point to use when rendering text. Acceptable values are: - ``'left'`` - ``'right'`` - ``'center'`` z Vertical anchor point to use when rendering text. Acceptable values are: - ``'top'`` - ``'middle'`` - ``'bottom'`` - ``'alphabetic'`` - ``'hanging'`` - ``'ideographic'`` a In multi-line text, how much additional space should be allocated for each line. The value is provided as a number, but should be treated as a percentage of font size. The default is 120%. Setting it to 1.0, so 100%, means no additional space will be used. z A rough measure of the 'size' of the hatching pattern. Generally speaking, the higher the number, the more spread out the pattern will be. zg Built-in patterns are can either be specified as long names: %s or as one-letter abbreviations: %s z, ccs|]}t|VqdS)N)repr).0xr1>/tmp/pip-unpacked-wheel-f5fndrjf/bokeh/core/property_mixins.py sr3z2 A width value for line-strokes used in hatching. c@s.eZdZdZededdZeeddZ dS)r&zo Properties relevant to rendering fill regions. Mirrors the BokehJS ``properties.FillVector`` class. gray fill pathsdefaulthelpr8N) __name__ __module__ __qualname____doc__r _color_help fill_colorr _alpha_help fill_alphar1r1r1r2r&sr&c@s,eZdZdZeededdZee dZ dS)r*zi Properties relevant to rendering fill regions. Mirrors the BokehJS ``properties.Fill`` class. r4r5r6r9N) r:r;r<r=rrr>r?r r@rAr1r1r1r2r*sr*c@sheZdZdZededdZeeddZ e ddde dZ e d edZe d ddedZeeed Zd S) r'zp Properties relevant to rendering fill regions. Mirrors the BokehJS ``properties.HatchVector`` class. blackhatchingr6r9(@Fr7Zaccept_datetimeZaccept_timedeltar8N?bokeh.models.textures.Texture)r:r;r<r=rr> hatch_colorr r@ hatch_alphar_hatch_scale_help hatch_scaler_hatch_pattern_help hatch_pattern_hatch_weight_help hatch_weightrr!r hatch_extrar1r1r1r2r's r'c@sbeZdZdZeededdZee ddZ e de dZ eeedZe dedZeeedZd S) r+zj Properties relevant to rendering fill regions. Mirrors the BokehJS ``properties.Hatch`` class. rBrCr6r9rDrFrGN)r:r;r<r=rrr>rHr r@rIr rJrKr!rLrMrNrOrrrPr1r1r1r2r+s   r+c@sneZdZdZededdZeeddZ e ddde dZ e d edZed edZegd dZed d dZdS)r(zr Properties relevant to rendering path operations. Mirrors the BokehJS ``properties.LineVector`` class. rB stroke pathsr6r9rFrEbevelbuttHow should the line be dashed.rSThe distance into the ``line_dash`` (in pixels) that the pattern should start from.N)r:r;r<r=rr> line_colorr r@ line_alphar_line_width_help line_widthr_line_join_help line_joinr_line_cap_helpline_capr line_dashrline_dash_offsetr1r1r1r2r(s   r(c@speZdZdZeededdZee ddZ e de dZ eededZeededZegd dZed d dZd S) r,zl Properties relevant to rendering path operations. Mirrors the BokehJS ``properties.Line`` class. rBrQr6r9rrRrSrTrrUN)r:r;r<r=rrr>rVr r@rWrrXrYrrrZr[rr\r]rr^rr_r1r1r1r2r,.s  r,c@s|eZdZdZededdZeeddZ e e de dZ ee ddZed edZed edZed edZed edZd S)r)z Properties relevant to rendering text. Mirrors the BokehJS ``properties.TextVector`` class. .. note:: There is currently only support for filling text. An interface to stroke the outlines of text has not yet been exposed. #444444 fill textr6r9 helvetica16px)r7normalleftbottom333333?N)r:r;r<r=rr> text_colorr r@ text_alphar"r%_text_font_help text_fontrtext_font_sizer_text_font_style_helptext_font_styler#_text_align_help text_alignr$_text_baseline_help text_baseliner_text_line_height_helptext_line_heightr1r1r1r2r)>s    r)c@szeZdZdZeededdZee ddZ e de dZ edZeededZeed edZeed edZed edZd S) r-z Properties relevant to rendering text. Mirrors the BokehJS ``properties.Text`` class. .. note:: There is currently only support for filling text. An interface to stroke the outlines of text has not yet been exposed. r`rar6r9rbrcrdrerfrgN)r:r;r<r=rrr>rhr r@rir!rjrkrrlrrrmrnr rorpr rqrrrrsrtr1r1r1r2r-Rs  r-)Cr= __future__rlogging getLoggerr:logenumsrrrrrr r Z has_propsr Z propertiesr r rrrrrrrrrrrrrrrrrrr r!r"r#r$r%__all__r>r@rXrZr\rjrmrorqrsrJjoinrLrNr&r*r'r+r(r,r)r-r1r1r1r2s<9  $ p!