CutoutTitleCard

Background

This style of title card is based off Reddit user /u/Phendrena's style of cards for Willow (2023). These cards feature a solid color overlay with the episode text (spelled out, e.g. ONE, TWO) cutout to reveal the episode backdrop.

This card type is used whenever card_type is specified as cutout, or phendrena.

Examples

Spoiler

Blurred

Valid extras

Below is a table of all valid series extras parsed by this card. These are described in greater detail below.

Label	Default Value	Description
overlay_color	black	Color to use for the overlay which the episode text it cutout of
blur_edges	false	Whether to blur the edges of the episode text for a softer cutout (see example)
blur_profile	0x10	How to blur the edges of the episode text
overlay_transparency	0.0	How transparent to make the solid color overlay

Customization

Changing the Overlay Color

By default, the episode text it cut out from a solid black overlay. This can be modified via the series extras overlay_color. This color cannot contain any transparency - use the overlay_transparency extra for that.

Example

Breaking Bad (2008):
  card_type: cutout
  extras:
    overlay_color: DarkSlateGray

The above YAML will produce cards that look like the following:

Overlay Transparency

How transparent the solid overlay should appear, as a float (percentage). The default value - 0.0 - means fully opaque (no transparency); while 1.0 would be fully transparent.

Example

For example, the following specification produces a 35% transparent overlay.

series:
  Primal (2019):
    card_type: cutout
    extras:
      overlay_transparency: 0.35

Producing cards like:

Cutout Edge Blurring

Enabling

The edges of the episode text (that cut out of the overlay) can be blurred to give a softer cutout. This is done via the series extras blur_edges.

Example

Breaking Bad (2008):
  card_type: cutout
  extras:
    blur_edges: true

The above YAML will produce cards with blurred edges - a side-by-side comparison with and without blurring is shown below:

Customizing the Blur Profile

How blurred the edges of the text appears can be controlled by the blur_profile series extras. This should be a valid ImageMagick blur command - i.e. {radius}x{sigma}, such as 0x10, 1x12, etc. This must be used with blur_edges as true.

Softer edges can be set by increasing the Blur sigma. A side by side is shown in the following example.

Example

Breaking Bad (2008):
  card_type: cutout
  extras:
    blur_edges: true
    blur_profile: 0x20

The above YAML will produce cards with blurred edges - a side-by-side comparison with and without blurring is shown below: