DynamicTrend¶

class abjad.indicators.DynamicTrend.DynamicTrend(shape='<', *, left_broken=None, tweaks=None)¶

Dynamic trend.

>>> staff = abjad.Staff("c'4 d' e' f'")
>>> abjad.attach(abjad.Dynamic('p'), staff[0])
>>> abjad.attach(abjad.DynamicTrend('<'), staff[0])
>>> abjad.attach(abjad.Dynamic('f'), staff[-1])
>>> abjad.override(staff).dynamic_line_spanner.staff_padding = 4.5
>>> abjad.show(staff) 

Attributes Summary

`context`	Returns (historically conventional) context `'Voice'`.
`known_shapes`	Gets known shapes.
`left_broken`	Is true when dynamic trend formats with left broken tag.
`shape`	Gets shape.
`spanner_start`	Is true.
`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.

(AbjadObject).__format__(format_specification='')¶

Formats Abjad object.

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

Returns string.

(AbjadValueObject).__hash__()¶

Hashes Abjad value object.

Returns integer.

(AbjadObject).__repr__()¶

Gets interpreter representation of Abjad object.

Returns string.

Read-only properties

context¶

Returns (historically conventional) context 'Voice'.

>>> abjad.DynamicTrend('<').context
'Voice'

>>> voice = abjad.Voice("c'4 d' e' f'")
>>> abjad.attach(abjad.Dynamic('p'), voice[0])
>>> abjad.attach(abjad.DynamicTrend('<'), voice[0])
>>> abjad.attach(abjad.Dynamic('f'), voice[-1])
>>> abjad.show(voice) 

>>> for leaf in voice:
...     print(leaf, abjad.inspect(leaf).effective(abjad.DynamicTrend))
... 
c'4 DynamicTrend(shape='<')
d'4 DynamicTrend(shape='<')
e'4 DynamicTrend(shape='<')
f'4 DynamicTrend(shape='<')

Class constant.

Override with abjad.attach(..., context='...').

Return type:	`str`

known_shapes¶

Gets known shapes.

>>> for shape in abjad.DynamicTrend().known_shapes:
...     shape
... 
'<'
'o<'
'<|'
'o<|'
'>'
'>o'
'|>'
'|>o'
'--'

Return type:	`Tuple`[`str`, …]

left_broken¶

Is true when dynamic trend formats with left broken tag.

>>> staff = abjad.Staff("c'4 d' e' f'")
>>> trend = abjad.DynamicTrend('<', left_broken=True)
>>> stop = abjad.Dynamic('f')
>>> abjad.attach(trend, staff[0])
>>> abjad.attach(stop, staff[-1])
>>> abjad.override(staff).dynamic_line_spanner.staff_padding = 4.5
>>> abjad.show(staff) 

>>> abjad.f(staff)
\new Staff
\with
{
    \override DynamicLineSpanner.staff-padding = #4.5
}
{
    c'4
    \< %! HIDE_TO_JOIN_BROKEN_SPANNERS
    d'4
    e'4
    f'4
    \f
}

Return type:	`Optional`[`bool`]

shape¶

Gets shape.

Crescendo:

>>> staff = abjad.Staff("c'4 d' e' f'")
>>> abjad.attach(abjad.Dynamic('p'), staff[0])
>>> abjad.attach(abjad.DynamicTrend('<'), staff[0])
>>> abjad.attach(abjad.Dynamic('f'), staff[-1])
>>> abjad.override(staff).dynamic_line_spanner.staff_padding = 4.5
>>> abjad.show(staff) 

Crescendo dal niente:

>>> staff = abjad.Staff("c'4 d' e' f'")
>>> abjad.attach(abjad.Dynamic('niente', hide=True), staff[0])
>>> abjad.attach(abjad.DynamicTrend('o<'), staff[0])
>>> abjad.attach(abjad.Dynamic('f'), staff[-1])
>>> abjad.override(staff).dynamic_line_spanner.staff_padding = 4.5
>>> abjad.show(staff) 

Subito crescendo:

>>> staff = abjad.Staff("c'4 d' e' f'")
>>> abjad.attach(abjad.Dynamic('p'), staff[0])
>>> abjad.attach(abjad.DynamicTrend('<|'), staff[0])
>>> abjad.attach(abjad.Dynamic('f'), staff[-1])
>>> abjad.override(staff).dynamic_line_spanner.staff_padding = 4.5
>>> abjad.show(staff) 

Subito crescendo dal niente:

>>> staff = abjad.Staff("c'4 d' e' f'")
>>> abjad.attach(abjad.Dynamic('niente', hide=True), staff[0])
>>> abjad.attach(abjad.DynamicTrend('o<|'), staff[0])
>>> abjad.attach(abjad.Dynamic('f'), staff[-1])
>>> abjad.override(staff).dynamic_line_spanner.staff_padding = 4.5
>>> abjad.show(staff) 

Decrescendo:

>>> staff = abjad.Staff("c'4 d' e' f'")
>>> abjad.attach(abjad.Dynamic('f'), staff[0])
>>> abjad.attach(abjad.DynamicTrend('>'), staff[0])
>>> abjad.attach(abjad.Dynamic('p'), staff[-1])
>>> abjad.override(staff).dynamic_line_spanner.staff_padding = 4.5
>>> abjad.show(staff) 

Decrescendo al niente:

>>> staff = abjad.Staff("c'4 d' e' f'")
>>> abjad.attach(abjad.Dynamic('f'), staff[0])
>>> abjad.attach(abjad.DynamicTrend('>o'), staff[0])
>>> abjad.attach(abjad.Dynamic('niente', command=r'\!'), staff[-1])
>>> abjad.override(staff).dynamic_line_spanner.staff_padding = 4.5
>>> abjad.show(staff) 

Subito decrescendo:

>>> staff = abjad.Staff("c'4 d' e' f'")
>>> abjad.attach(abjad.Dynamic('f'), staff[0])
>>> abjad.attach(abjad.DynamicTrend('|>'), staff[0])
>>> abjad.attach(abjad.Dynamic('p'), staff[-1])
>>> abjad.override(staff).dynamic_line_spanner.staff_padding = 4.5
>>> abjad.show(staff) 

Subito decrescendo al niente:

>>> staff = abjad.Staff("c'4 d' e' f'")
>>> abjad.attach(abjad.Dynamic('f'), staff[0])
>>> abjad.attach(abjad.DynamicTrend('|>o'), staff[0])
>>> abjad.attach(abjad.Dynamic('niente', command=r'\!'), staff[-1])
>>> abjad.override(staff).dynamic_line_spanner.staff_padding = 4.5
>>> abjad.show(staff) 

Constante:

>>> staff = abjad.Staff("c'4 d' e' f'")
>>> abjad.attach(abjad.Dynamic('p'), staff[0])
>>> abjad.attach(abjad.DynamicTrend('--'), staff[0])
>>> abjad.attach(abjad.Dynamic('f'), staff[-1])
>>> abjad.override(staff).dynamic_line_spanner.staff_padding = 4.5
>>> abjad.show(staff) 

Return type:	`str`

spanner_start¶

Is true.

>>> abjad.DynamicTrend('<').spanner_start
True

Return type:	`bool`

tweaks¶

Gets tweaks

>>> staff = abjad.Staff("c'4 d' e' f'")
>>> abjad.attach(abjad.Dynamic('p'), staff[0])
>>> start = abjad.DynamicTrend('<')
>>> abjad.tweak(start).color = 'blue'
>>> abjad.attach(start, staff[0])
>>> abjad.attach(abjad.Dynamic('f'), staff[-1])
>>> abjad.override(staff).dynamic_line_spanner.staff_padding = 4.5
>>> abjad.show(staff) 

>>> staff = abjad.Staff("c'4 d' e' f'")
>>> abjad.attach(abjad.Dynamic('p'), staff[0])
>>> start = abjad.DynamicTrend(tweaks=[('color', 'blue')])
>>> abjad.tweak(start).color = 'blue'
>>> abjad.attach(start, staff[0])
>>> abjad.attach(abjad.Dynamic('f'), staff[-1])
>>> abjad.override(staff).dynamic_line_spanner.staff_padding = 4.5
>>> abjad.show(staff) 

Return type:	`Optional`[`LilyPondTweakManager`]