ColorFingering

digraph InheritanceGraph { graph [bgcolor=transparent, color=lightsteelblue2, fontname=Arial, fontsize=10, outputorder=edgesfirst, overlap=prism, penwidth=2, rankdir=LR, splines=spline, style="dashed, rounded", truecolor=true]; node [colorscheme=pastel19, fontname=Arial, fontsize=10, height=0, penwidth=2, shape=box, style="filled, rounded", width=0]; edge [color=lightslategrey, penwidth=1]; subgraph "cluster_abjad.indicators" { graph [label="abjad.indicators"]; node [color=1]; "abjad.indicators.ColorFingering.ColorFingering" [URL="../api/abjad/indicators/ColorFingering.html#abjad.indicators.ColorFingering.ColorFingering", color=black, fontcolor=white, label="Color\nFingering", target=_top]; } subgraph "cluster_abjad.system" { graph [label="abjad.system"]; node [color=2]; "abjad.system.AbjadObject.AbjadObject" [URL="../api/abjad/indicators/../system/AbjadObject.html#abjad.system.AbjadObject.AbjadObject", label="Abjad\nObject", target=_top]; "abjad.system.AbjadValueObject.AbjadValueObject" [URL="../api/abjad/indicators/../system/AbjadValueObject.html#abjad.system.AbjadValueObject.AbjadValueObject", label="Abjad\nValue\nObject", target=_top]; "abjad.system.AbjadObject.AbjadObject" -> "abjad.system.AbjadValueObject.AbjadValueObject"; } subgraph cluster_builtins { graph [label=builtins]; node [color=3]; "builtins.object" [URL="https://docs.python.org/3.6/library/functions.html#object", label=object, target=_top]; } "abjad.system.AbjadValueObject.AbjadValueObject" -> "abjad.indicators.ColorFingering.ColorFingering"; "builtins.object" -> "abjad.system.AbjadObject.AbjadObject"; }

class abjad.indicators.ColorFingering.ColorFingering(number=None, *, tweaks=None)

Color fingering.

First color fingering:

>>> fingering = abjad.ColorFingering(1)
>>> note = abjad.Note("c'4")
>>> abjad.attach(fingering, note)
>>> abjad.show(note) 

Second color fingering:

>>> fingering = abjad.ColorFingering(2)
>>> note = abjad.Note("c'4")
>>> abjad.attach(fingering, note)
>>> abjad.show(note) 

Color fingerings indicate alternate woodwind fingerings by amount of pitch of timbre deviation.


Attributes Summary

__format__ Formats color fingering.
__ge__ Return a >= b.
__gt__ Return a > b.
__le__ Return a <= b.
__lt__ Is true if argument is a color fingering and the number of this color fingering is less than that of argument.
markup Gets markup of color fingering.
number Gets number of color fingering.
tweaks Gets tweaks.

Special methods

(AbjadValueObject).__copy__(*arguments)

Copies Abjad value object.

Returns new Abjad value object.

(AbjadValueObject).__eq__(argument)

Is true when all initialization values of Abjad value object equal the initialization values of argument.

Returns true or false.

__format__(format_specification='')

Formats color fingering.

Set format_specification to '', 'lilypond' or 'storage'. Interprets '' equal to 'storage'.

>>> fingering = abjad.ColorFingering(1)
>>> abjad.f(fingering)
abjad.ColorFingering(
    number=1,
    )
Return type:str
__ge__(other, NotImplemented=NotImplemented)

Return a >= b. Computed by @total_ordering from (not a < b).

__gt__(other, NotImplemented=NotImplemented)

Return a > b. Computed by @total_ordering from (not a < b) and (a != b).

(AbjadValueObject).__hash__()

Hashes Abjad value object.

Returns integer.

__le__(other, NotImplemented=NotImplemented)

Return a <= b. Computed by @total_ordering from (a < b) or (a == b).

__lt__(argument)

Is true if argument is a color fingering and the number of this color fingering is less than that of argument.

>>> fingering_1 = abjad.ColorFingering(1)
>>> fingering_2 = abjad.ColorFingering(1)
>>> fingering_3 = abjad.ColorFingering(2)
>>> fingering_1 < fingering_1
False
>>> fingering_1 < fingering_2
False
>>> fingering_1 < fingering_3
True
>>> fingering_2 < fingering_1
False
>>> fingering_2 < fingering_2
False
>>> fingering_2 < fingering_3
True
>>> fingering_3 < fingering_1
False
>>> fingering_3 < fingering_2
False
>>> fingering_3 < fingering_3
False
Return type:bool
(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Read-only properties

markup

Gets markup of color fingering.

First color fingering:

>>> fingering = abjad.ColorFingering(1)
>>> print(format(fingering.markup, 'lilypond'))
\markup {
    \override
        #'(circle-padding . 0.25)
        \circle
            \finger
                1
    }
>>> abjad.show(fingering.markup) 

Second color fingering:

>>> fingering = abjad.ColorFingering(2)
>>> print(format(fingering.markup, 'lilypond'))
\markup {
    \override
        #'(circle-padding . 0.25)
        \circle
            \finger
                2
    }
>>> abjad.show(fingering.markup) 
Return type:Optional[Markup]
number

Gets number of color fingering.

First color fingering:

>>> fingering = abjad.ColorFingering(1)
>>> fingering.number
1

Second color fingering:

>>> fingering = abjad.ColorFingering(2)
>>> fingering.number
2
Return type:Optional[int]
tweaks

Gets tweaks.

>>> staff = abjad.Staff("c'4 d' e' f'")
>>> fingering = abjad.ColorFingering(1)
>>> abjad.tweak(fingering).color = 'blue'
>>> abjad.attach(fingering, staff[0])
>>> abjad.show(staff) 
>>> staff = abjad.Staff("c'4 d' e' f'")
>>> fingering = abjad.ColorFingering(1, tweaks=[('color', 'blue')])
>>> abjad.attach(fingering, staff[0])
>>> abjad.show(staff) 
Return type:Optional[LilyPondTweakManager]