spannertools.CrescendoSpanner

class abjad.tools.spannertools.CrescendoSpanner.CrescendoSpanner.CrescendoSpanner(components=None, include_rests=True, direction=None)

Abjad crescendo spanner that includes rests:

abjad> staff = Staff("r4 c'8 d'8 e'8 f'8 r4")

abjad> f(staff)
\new Staff {
    r4
    c'8
    d'8
    e'8
    f'8
    r4
}

abjad> spannertools.CrescendoSpanner(staff[:], include_rests = True)
CrescendoSpanner(r4, c'8, d'8, e'8, f'8, r4)

abjad> f(staff)
\new Staff {
    r4 \<
    c'8
    d'8
    e'8
    f'8
    r4 \!
}

Abjad crescendo spanner that does not include rests:

abjad> staff = Staff("r4 c'8 d'8 e'8 f'8 r4")

abjad> f(staff)
\new Staff {
    r4
    c'8
    d'8
    e'8
    f'8
    r4
}

abjad> spannertools.CrescendoSpanner(staff[:], include_rests = False)
CrescendoSpanner(r4, c'8, d'8, e'8, f'8, r4)

abjad> f(staff)
\new Staff {
    r4
    c'8 \<
    d'8
    e'8
    f'8 \!
    r4
}

Return crescendo spanner.

Read-only Properties

CrescendoSpanner.components

Return read-only tuple of components in spanner.

abjad> voice = Voice("c'8 d'8 e'8 f'8")
abjad> spanner = spannertools.Spanner(voice[:2])
abjad> spanner.components
(Note("c'8"), Note("d'8"))

Changed in version 1.1: Now returns an (immutable) tuple instead of a (mutable) list.

Note

Inherited from spannertools.Spanner

CrescendoSpanner.duration_in_seconds

Sum of duration of all leaves in spanner, in seconds.

Note

Inherited from spannertools.Spanner

CrescendoSpanner.leaves

Return read-only tuple of leaves in spanner.

abjad> voice = Voice("c'8 d'8 e'8 f'8")
abjad> spanner = spannertools.Spanner(voice[:2])
abjad> spanner.leaves
(Note("c'8"), Note("d'8"))

Changed in version 1.1: Now returns an (immutable) tuple instead of a (mutable) list.

Note

When dealing with large, complex scores accessing this attribute can take some time. Best to make a local copy with leaves = spanner.leaves first. Or use spanner- specific iteration tools.

Note

Inherited from spannertools.Spanner

CrescendoSpanner.offset

New in version 1.1.

Return read-only reference to spanner offset interface.

Spanner offset interface implements start and stop attributes.

abjad> voice = Voice("c'8 d'8 e'8 f'8")
abjad> spanner = spannertools.Spanner(voice[2:])
abjad> spanner
Spanner(e'8, f'8)

abjad> spanner._offset.start
Offset(1, 4)

abjad> spanner._offset.stop
Offset(1, 2)

Return duration.

Note

Inherited from spannertools.Spanner

CrescendoSpanner.override

LilyPond grob override component plug-in.

Note

Inherited from spannertools.Spanner

CrescendoSpanner.preprolated_duration

Sum of preprolated duration of all components in spanner.

Note

Inherited from spannertools.Spanner

CrescendoSpanner.prolated_duration

Sum of prolated duration of all components in spanner.

Note

Inherited from spannertools.Spanner

CrescendoSpanner.set

LilyPond context setting component plug-in.

Note

Inherited from spannertools.Spanner

CrescendoSpanner.written_duration

Sum of written duration of all components in spanner.

Note

Inherited from spannertools.Spanner

Read/write Properties

CrescendoSpanner.direction

Note

Inherited from spannertools._DirectedSpanner

CrescendoSpanner.include_rests

Get boolean hairpin rests setting:

abjad> staff = Staff("c'8 d'8 e'8 f'8")
abjad> hairpin = spannertools.HairpinSpanner(staff[:], 'p < f', include_rests = True)
abjad> hairpin.include_rests
True

Set boolean hairpin rests setting:

abjad> staff = Staff("c'8 d'8 e'8 f'8")
abjad> hairpin = spannertools.HairpinSpanner(staff[:], 'p < f', include_rests = True)
abjad> hairpin.include_rests = False
abjad> hairpin.include_rests
False

Set boolean.

Note

Inherited from spannertools.HairpinSpanner

CrescendoSpanner.shape_string

Get hairpin shape string:

abjad> staff = Staff("c'8 d'8 e'8 f'8")
abjad> hairpin = spannertools.HairpinSpanner(staff[:], 'p < f')
abjad> hairpin.shape_string
'<'

Set hairpin shape string:

abjad> staff = Staff("c'8 d'8 e'8 f'8")
abjad> hairpin = spannertools.HairpinSpanner(staff[:], 'p < f')
abjad> hairpin.shape_string = '>'
abjad> hairpin.shape_string
'>'

Set string.

Note

Inherited from spannertools.HairpinSpanner

CrescendoSpanner.start_dynamic_string

Get hairpin start dynamic string:

abjad> staff = Staff("c'8 d'8 e'8 f'8")
abjad> hairpin = spannertools.HairpinSpanner(staff[:], 'p < f')
abjad> hairpin.start_dynamic_string
'p'

Set hairpin start dynamic string:

abjad> staff = Staff("c'8 d'8 e'8 f'8")
abjad> hairpin = spannertools.HairpinSpanner(staff[:], 'p < f')
abjad> hairpin.start_dynamic_string = 'mf'
abjad> hairpin.start_dynamic_string
'mf'

Set string.

Note

Inherited from spannertools.HairpinSpanner

CrescendoSpanner.stop_dynamic_string

Get hairpin stop dynamic string:

abjad> staff = Staff("c'8 d'8 e'8 f'8")
abjad> hairpin = spannertools.HairpinSpanner(staff[:], 'p < f')
abjad> hairpin.stop_dynamic_string
'f'

Set hairpin stop dynamic string:

abjad> staff = Staff("c'8 d'8 e'8 f'8")
abjad> hairpin = spannertools.HairpinSpanner(staff[:], 'p < f')
abjad> hairpin.stop_dynamic_string = 'mf'
abjad> hairpin.stop_dynamic_string
'mf'

Set string.

Note

Inherited from spannertools.HairpinSpanner

Methods

CrescendoSpanner.append(component)

Add component to right of spanner.

abjad> voice = Voice("c'8 d'8 e'8 f'8")
abjad> spanner = spannertools.Spanner(voice[:2])
abjad> spanner
Spanner(c'8, d'8)

abjad> spanner.append(voice[2])
abjad> spanner
Spanner(c'8, d'8, e'8)

Return none.

Note

Inherited from spannertools.Spanner

CrescendoSpanner.append_left(component)

Add component to left of spanner.

abjad> voice = Voice("c'8 d'8 e'8 f'8")
abjad> spanner = spannertools.Spanner(voice[2:])
abjad> spanner
Spanner(e'8, f'8)

abjad> spanner.append_left(voice[1])
abjad> spanner
Spanner(d'8, e'8, f'8)

Return none.

Note

Inherited from spannertools.Spanner

CrescendoSpanner.clear()

Remove all components from spanner:

abjad> voice = Voice("c'8 d'8 e'8 f'8")
abjad> spanner = spannertools.Spanner(voice[:])
abjad> spanner
Spanner(c'8, d'8, e'8, f'8)

abjad> spanner.clear()
abjad> spanner
Spanner()

Return none.

Note

Inherited from spannertools.Spanner

CrescendoSpanner.extend(components)

Add iterable components to right of spanner:

abjad> voice = Voice("c'8 d'8 e'8 f'8")
abjad> spanner = spannertools.Spanner(voice[:2])
abjad> spanner
Spanner(c'8, d'8)

abjad> spanner.extend(voice[2:])
abjad> spanner
Spanner(c'8, d'8, e'8, f'8)

Return none.

Note

Inherited from spannertools.Spanner

CrescendoSpanner.extend_left(components)

Add iterable components to left of spanner:

abjad> voice = Voice("c'8 d'8 e'8 f'8")
abjad> spanner = spannertools.Spanner(voice[2:])
abjad> spanner
Spanner(e'8, f'8)

abjad> spanner.extend_left(voice[:2])
abjad> spanner
Spanner(c'8, d'8, e'8, f'8)

Return none.

Note

Inherited from spannertools.Spanner

CrescendoSpanner.fracture(i, direction='both')

Fracture spanner at direction of component at index i.

Valid values for direction are 'left', 'right' and 'both'.

Return original, left and right spanners.

abjad> voice = Voice("c'8 d'8 e'8 f'8")
abjad> beam = spannertools.BeamSpanner(voice[:])
abjad> beam
BeamSpanner(c'8, d'8, e'8, f'8)

abjad> beam.fracture(1, direction = 'left')
(BeamSpanner(c'8, d'8, e'8, f'8), BeamSpanner(c'8), BeamSpanner(d'8, e'8, f'8))

abjad> print voice.format
\new Voice {
    c'8 [ ]
    d'8 [
    e'8
    f'8 ]
}

Return tuple.

Note

Inherited from spannertools.Spanner

CrescendoSpanner.fuse(spanner)

Fuse contiguous spanners.

Return new spanner.

abjad> voice = Voice("c'8 d'8 e'8 f'8")
abjad> left_beam = spannertools.BeamSpanner(voice[:2])
abjad> right_beam = spannertools.BeamSpanner(voice[2:])

abjad> print voice.format
\new Voice {
    c'8 [
    d'8 ]
    e'8 [
    f'8 ]
}

abjad> left_beam.fuse(right_beam)
[(BeamSpanner(c'8, d'8), BeamSpanner(e'8, f'8), BeamSpanner(c'8, d'8, e'8, f'8))]

abjad> print voice.format
\new Voice {
    c'8 [
    d'8
    e'8
    f'8 ]
}

Todo

Return (immutable) tuple instead of (mutable) list.

Note

Inherited from spannertools.Spanner

CrescendoSpanner.index(component)

Return nonnegative integer index of component in spanner.

abjad> voice = Voice("c'8 d'8 e'8 f'8")
abjad> spanner = spannertools.Spanner(voice[2:])
abjad> spanner
Spanner(e'8, f'8)

abjad> spanner.index(voice[-2])
0

Return nonnegative integer.

Note

Inherited from spannertools.Spanner

CrescendoSpanner.pop()

Remove and return rightmost component in spanner.

abjad> voice = Voice("c'8 d'8 e'8 f'8")
abjad> spanner = spannertools.Spanner(voice[:])
abjad> spanner
Spanner(c'8, d'8, e'8, f'8)

abjad> spanner.pop()
Note("f'8")

abjad> spanner
Spanner(c'8, d'8, e'8)

Return component.

Note

Inherited from spannertools.Spanner

CrescendoSpanner.pop_left()

Remove and return leftmost component in spanner.

abjad> voice = Voice("c'8 d'8 e'8 f'8")
abjad> spanner = spannertools.Spanner(voice[:])
abjad> spanner
Spanner(c'8, d'8, e'8, f'8)

abjad> spanner.pop_left()
Note("c'8")

abjad> spanner
Spanner(d'8, e'8, f'8)

Return component.

Note

Inherited from spannertools.Spanner

Special Methods

CrescendoSpanner.__contains__(expr)

Note

Inherited from spannertools.Spanner

CrescendoSpanner.__delattr__()

x.__delattr__(‘name’) <==> del x.name

Note

Inherited from __builtin__.object

CrescendoSpanner.__eq__(arg)

True when id(self) equals id(arg).

Return boolean.

Note

Inherited from abctools.AbjadObject

CrescendoSpanner.__ge__(arg)

Abjad objects by default do not implement this method.

Raise exception.

Note

Inherited from abctools.AbjadObject

CrescendoSpanner.__getitem__(expr)

Note

Inherited from spannertools.Spanner

CrescendoSpanner.__gt__(arg)

Abjad objects by default do not implement this method.

Raise exception

Note

Inherited from abctools.AbjadObject

CrescendoSpanner.__hash__() <==> hash(x)

Note

Inherited from __builtin__.object

CrescendoSpanner.__le__(arg)

Abjad objects by default do not implement this method.

Raise exception.

Note

Inherited from abctools.AbjadObject

CrescendoSpanner.__len__()

Note

Inherited from spannertools.Spanner

CrescendoSpanner.__lt__(other)

Trivial comparison to allow doctests to work.

Note

Inherited from spannertools.Spanner

CrescendoSpanner.__ne__(arg)

True when id(self) does not equal id(arg).

Return boolean.

Note

Inherited from abctools.AbjadObject

CrescendoSpanner.__repr__()

Note

Inherited from spannertools.Spanner

CrescendoSpanner.__setattr__()

x.__setattr__(‘name’, value) <==> x.name = value

Note

Inherited from __builtin__.object

CrescendoSpanner.__str__() <==> str(x)

Note

Inherited from __builtin__.object