Skip to content

ComicBookTitleCard

Collin Heist edited this page Aug 20, 2023 · 3 revisions

Background

Title Cards stylized after classic Comic Book pages. These cards feature two prominent "banners" at the top and bottom of the card, one for the season / episode (index) text, the other for the title text. Practically all aspects of these banners can be customized.

This card type is used whenever card_type is specified as comic book.

Example

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
episode_text_color black Color of the season and episode text
index_text_position left Where (on the top of the image) to place the index text
text_box_fill_color white Fill color of the text boxes
text_box_edge_color Font color Color of the edges of the text boxes
title_text_rotation_angle -4.0 Angle of the (bottom) title text and banner
index_text_rotation_angle -4.0 Angle of the (top) index text and banner
banner_fill_color rgba(235,73,69,0.6) Fill color of both banners
title_banner_shift 0 Additional vertical shift to apply to the (bottom) title banner
index_banner_shift 0 Additional vertical shift to apply to the (top) index banner
hide_title_banner false Whether to hide the (bottom) title banner
hide_index_banner false Whether to hide the (top) index banner

Customization

Episode Text Color

Color of the episode text (the text that appears at the _top_ of the Card).

Index Text Position

The position of the index / episode text (at the top of the card). This defaults to `left`, but can be set to either `left`, `middle`, or `right`. See below for an example of each.

NOTE: It is important to note that the angle of the index text banner does not change when this is adjusted to something other than the default - it is recommended to change the rotation via the index_text_rotation_angle extra.

Examples
index_text_position left middle right
Example

The effects of not changing the banner rotation angle are clearly evident in the middle/right images.

Text Box Colors

There are two colors for the text boxes - the fill color (controlled by `text_box_fill_color`) and the edge color (controlled by `text_box_edge_color`).

The edge color also changes the color that appears at the edges of the banners - for example:

Text Rotation Angles

The angles of the title and index text are controlled separately by the title_text_rotation_angle and the index_text_rotation_angle extras. These values are the angle of the rotation in degrees. The default value is -4.0 (4 degrees).

If you'd like to add variety to the banners (so not all title cards appear the same), these values can be specified like random[lower, upper] - e.g. random[-4, 4] - and TCM will randomly select an angle between lower and upper (inclusively). See the example below.

Example
series:
  Marvel's Daredevil (2015):
    card_type: comic book
    extras:
      banner_fill_color: rgba(250, 59, 19, 0.6)
      title_text_rotation_angle: random[-4, 4]
      index_text_rotation_angle: random[-4, -3]

The above YAML can generate the following Title Cards:

image

Banner Fill Color

The color of the banners is adjustable with the `banner_fill_color` extra. It is recommended to specify a semi-transparent color as `rgba(r, g, b, alpha)` - e.g. `rgba(250, 59, 16, 0.6)` - so that the banner is partially transparent.

Banner Shifting

The vertical positioning of the banner can be adjusted up/down with the `title_banner_shift` and `index_banner_shift` extras. These values are in pixels.

Banner Toggling

Each banner can be individually hidden with the `hide_title_banner` and `hide_index_banner` extras. This _only_ affects the banners themselves, _not_ the text or text boxes.
Clone this wiki locally