Colorize

Animate a tint on a whole protein or a selected region.

from proteinmotion import Colorize

Constructor

Colorize(target, color, **kwargs)

Parameters

Parameter	Default	Description
`target`	Required	Protein or Region to style.
`color`	Required	Hex color or RGB values. For tint setters, None restores the representation’s base palette.
`**kwargs`	—	Additional keyword options described below or in the linked constructor.

Additional keyword arguments

Parameter	Default	Description
`residue_delay`keyword only	`0`	Delay in seconds between successive residue starts.
`reverse`keyword only	`False`	Reverse residue or glyph order.
`easing`keyword only	`'smooth'`	Per-residue interpolation: "smooth" or "linear".

Notes

Residues start in topology order from N to C. run_time must exceed (residue count − 1) × residue_delay. Use easing for each residue transition; the clip clock stays linear. Disjoint atom selections can animate together.

Example and output

This excerpt runs inside a scene’s construct() method. The full example file includes imports, structure loading, and camera setup. Run it from a repository checkout.

Code Scene excerpt

p = ubiquitin()
frame(self, p)
helix = p.select(residues=(23, 34))
strand = p.select(residues=(2, 7))
self.play(
    Colorize(helix, "#50e0d0", residue_delay=0.09),
    Colorize(strand, "#f2ba67", residue_delay=0.15),
    run_time=2.5,
)
self.wait(1)
self.play(Colorize(helix, None), run_time=1.5)
self.wait(0.5)

Output Preview · 5.5 s · 60 fps

Color animation

Residues change color in sequence from N to C.

Full source: ColorChange Download MP4

Methods and properties

Name	Description
bind()method · inherited from _AppearanceAnimation	Capture starting values when the scene schedules the animation.
apply()method · inherited from _AppearanceAnimation	Evaluate the animation at eased progress alpha. Called by the timeline.
targetsproperty · inherited from Animation	Objects whose state this animation changes.