DynamicTrend

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.DynamicTrend.DynamicTrend" [URL="../api/abjad/indicators/DynamicTrend.html#abjad.indicators.DynamicTrend.DynamicTrend", color=black, fontcolor=white, label="Dynamic\nTrend", 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.DynamicTrend.DynamicTrend"; "builtins.object" -> "abjad.system.AbjadObject.AbjadObject"; }

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]