ColorFingering

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]