Tier#

Import

from scenet import Tier

Defined in

scenet.ir (source)

Install

pip install scenet

Since

0.10

Stability

Public: follows semantic versioning. Below 1.0, a minor release may change it, and the CHANGELOG says how.

class scenet.ir.Tier[source]#

Bases: Strict

A row of panels read in turn, or of columns each read top to bottom.

Columns are how a tall panel beside a stack of short ones is written. The stack is read down before the page is read across, which is what readers do when a panel spanning the tier blocks the way across (Cohn, Navigating Comics, 2013).

A tier of panels can lean the gutters between them by slant degrees, for a beat that should not sit square: each gutter tilts about its centre at the tier’s mid-height, neighbours share the cut, and the tier’s outer edges stay upright.

Example

>>> from scenet import Tier
>>> tier = Tier(panels=[{"use": "wide"}, {"use": "narrow", "width": 0.5}])
>>> [placement.width for placement in tier.panels]
[1.0, 0.5]

See also

Column, panels stacked within a tier. PageSpec, whose tiers holds them.

height: float#

The tier’s share of the page’s height, relative to the other tiers.

panels: tuple[PanelPlacement, ...]#

The panels in the tier, in reading order: left to right, or right to left for a comic read that way.

columns: tuple[Column, ...]#

In place of panels: columns side by side, each a stack of panels read top to bottom before the next.

slant: float#

How far the gutters between the tier’s panels lean, in degrees, from -30 to 30. Positive leans the top of each gutter to the right.

property placed: tuple[tuple[str, tuple[str | int, ...]], ...]#

Each panel’s name and path within the tier, insets included, in reading order.