Skip to content

RomanNumeralTitleCard

Collin Heist edited this page Nov 25, 2022 · 9 revisions

Background

This style of title card is based off the official Devilman Crybaby title cards (see here). It features large roman numerals indicating the episode number just behind the title.

If enabled, season titles are 'randomly' place around the roman numerals. The logic for this is very complicated, and described in greater detail here.

This card type is used whenever card_type is specified as roman or roman numeral.

Examples

Spoiler

Blurred

How to Use

Specification

This card uses extras data within a series YAML file. It is optional to adjust the color of the roman numerals to something other than the default red (#AE2317), or to change the background color. The title font color can be set via the typical font color specification. An example of this is shown below.

Example

The following example showcases how to specify a custom background and roman numeral color.

Tower of God (2021):
  card_type: roman
  font:
    color: black
  extras:
    background: white
    roman_numeral_color: "#4489C2"

This results in a card like:

Changing the Roman Numerals

By default, the roman numerals are generated by using the episode text with an episode_text_format of {episode_number}, but if you'd like the roman numerals to reflect the absolute numbering of an episode, specify the episode text format like so:

episode_text_format: "{abs_number}"

Roman numerals above 3,999 cannot be created (as these utilize overline characters), so the numerals will cap out at 3,999.

NOTE: For particularly long-running series, the roman numeral text can become quite long (such as CCCLXXXIII), and so some wrapping/font size modification is used. See here for details.

Roman Numeral Fitting

Because of how spacey roman numerals can become for some numbers (like 843 = DCCCXLIII), the Maker wraps very long numerals and adjusts their size to fit the screen. This is done automatically, and is not adjustable via the font size (or any) specification.

An example of scaling the size and spacing of the roman numerals is shown below:

Season Titles

This card's implementation of season titles is quite a bit different than other cards, as the season titles are randomly placed for each card. This means that if you created the "same" title card twice, odds are the season text would be placed differently between them.

Each time the card is created, TCM randomly selects a roman numeral, and then randomly selects a position around that roman numeral. These positions are hard-coded relative to each letter, and examples of all possible positions are shown below. This random position is then checked to make sure it does not overlap the title text, or extend beyond the bounds of the image - if it does, a new position is chosen (this is repeated up to 10 times).

Possible Season Title Positions

I V X L C D M

This algorithm works even for very long roman numerals that span multiple lines - for example:

long roman numeral

Title Characteristics

Maximum Line Width

This card begins splitting titles at 26 characters. This was selected using the default font, and leaves a small side margin.

Maximum Line Count

This card will split titles into at most 6 lines (unless manually specified). With the standard font, this takes up over three quarters of the image.

Title Style

This card will split titles top heavy, meaning titles will be split such that they're longer at the bottom than the top. For example:

The One Where Rachel's
Sister Babysits

Default Font

Font

The default font used for titles is Flanker Griffo, seen below:

Case

The default font case is upper.

Color

The default font color is white.

Replacements

The default font does not use any font replacements.


Clone this wiki locally