dos e0003 wordData - cwtickle/danoniplus-docs GitHub Wiki

English | Japanese

^ Return to Screen effects specification

| < Color change | Lyrics display | Background and mask motion > |

Lyrics display (word_data)

Overview

  • Set the text (lyrics, etc.) to be displayed above and below the step zone.

Usage

|word_data=
1436,0,[fadein]
1436,0,Twinkle*comma* twinkle*comma* little star
1638,0,How I wonder what you are!
1852,0,Up above the world so high*comma*
2028,0,Like a diamond in the sky.
2242,0,[fadeout]
9000,0,[center]
9000,0,Thank You For Playing!
9120,0,[fadeout],120
|
  • One set of three or four. Line breaks are required at the end of each line.
    If you use commas in your lyrics, please write *comma*.

1. Usual notation

No Logical name Example Description
1 Frame 1436 Specifies the number of frames at which to display the lyrics.
2 Position 0 Position at which lyrics are to be displayed." 0", "2", ... (even numbers) are in the upper row, and "1", "3", ...(odd numbers) are in the lower row. (odd numbers) are in the lower row.
3 Lyrics Twinkle*comma* twinkle*comma* little star Lyrics display. Tags such as text color are available. If you use commas in your lyrics, please write *comma*.
  • Commas in the lyrics display section are not treated as delimiters unless there is an exception "comma + half-width space" and there is a single digit between commas during lyrics display since ver 34.1.0.
8945,0,They search my face in a silky voice, <br>but they*squo*re scared of me at the bottom of their heart.
9097,0,It makes me annoyed tremendously...<br>Their behavior disgusts me !

2. Fade in/out, change display position

No Logical name Example Description
1 Frame 1436 Specifies the number of timing frames to be changed.
2 Position 0 Position at which lyrics are to be displayed." 0", "2", ... (even numbers) are in the upper row, and "1", "3", ...(odd numbers) are in the lower row. (odd numbers) are in the lower row.
3 Fadein/Out [fadein] Keyword Designation.
[fadein] Lyrics fade-in (gradual display)
[fadeout] Lyrics fade out (gradually hidden)
[left] Left-align lyrics display
[center] Center the lyrics display
[right] Right-align lyrics display
[fontSize=XX] Change font size to XXpx
4 FadeFrame 60 Specifies the number of frames to fade in and out of lyrics. Effective only when "[fadein]" or "[fadeout]" is specified as a keyword. Default is 30 frames.

3. Comments

No Logical name Example Description
1 Frame 200 Specify the number of frames. Specification is optional.
2 Position - Hyphen fixed.
3 Comment Comment text can be freely entered.

4. Redirection of other preferences

|wordCross_data=wordRev_data|  // The lyrics displayed when the Scroll is "Cross" are the same as those displayed when the Scroll is "Reverse".
No Logical name Example Description
1 Data Name wordRev2_data Specify the name of the lyrics display setting from which to copy.

Data Name Type

  • The usage is the same, just in different situations. Reverse is for Reverse only. If not specified, the normal one is used. Cross, Split, etc. are for when Scroll is specified other than --- (usually when the step zone is both up and down).
  • Those with A like "wordA_data", "wordRevA_data" are for Another Keys Mode.
Type Lyrics display
(language not specified)
Lyrics display
(En)
Lyrics display
(Ja)
Normal word_data,
word2_data,
wordA_data,
wordA2_data,
...
wordEn_data,
wordEn2_data,
wordAEn_data,
wordAEn2_data,
...
wordJa_data,
wordJa2_data,
wordAJa_data,
wordAJa2_data,
...
Reverse wordRev_data,
wordRev2_data,
...
wordRevEn_data,
wordRevEn2_data,
...
wordRevJa_data,
wordRevJa2_data,
...
Cross, Split etc. wordAlt_data,
wordAlt2_data,
...
wordCross_data,
wordFlat_data,
...
wordAltJa_data,
wordAltJa2_data,
...
wordCrossJa_data,
wordFlatJa_data,
...
wordAltEn_data,
wordAltEn2_data,
...
wordCrossEn_data,
wordFlatEn_data,
...

For instance, the following order is applied for the second chart and reverse.

Priority Applicable data Meaning
1 wordRevEn2_data / wordRevJa2_data Second chart of lyrics display (in reverse, language specified)
2 wordRevEn_data / wordRevJa_data First chart of lyrics display (in reverse, language specified)
3 wordRev2_data Second chart of lyrics display (in reverse, language not specified)
4 wordRev_data First chart of lyrics display (in reverse, language not specified)
5 wordEn2_data / wordJa2_data Second chart of lyrics display (in normal, language specified)
6 wordEn_data / wordJa_data First chart of lyrics display (in normal, language specified)
7 word2_data Second chart of lyrics display (in normal, language not specified)
8 word_data First chart of lyrics display (in normal, language not specified)

Additional information

  • Starting from ver15.3.0, the lyrics display is reversed up and down only when all of the following conditions are met.
    This control setting can be configured in chart settings or danoni_setting.js.
    • Limited to key types that do not interrupt up/down scrolling (5key, 7key, 7ikey, 9A/9Bkey, etc.)
    • Works for which the lyric display (wordRev_data / wordAlt_data) for reverse scroll extension is not set
    • When playback is started with Reverse: ON and Scroll: --- (not specified) on the SETTINGS screen
    • When all lyrics are displayed in a single-level display (because the letters may overlap when reversed in a two-level display)

Additional information 2

  • Starting from ver34.0.0, it is possible to specify by key types and by key patterns.
|transKey9A=$$9B$9C|

|word_data=...|         // Overall Common
|word2_data=...|        // Common to the 2nd chart
|wordEn2_data=...|      // Applicable to the 2nd chart, English mode only.
|wordAEn2_data=...|     // Applies only to the 2nd chart, English mode, and another key mode (9B, 9C)
|word<9C>En2_data=...|  // Applies only to the 2nd chart, English mode, and another key mode (9C)
|word<9A>En2_data=...|  // Applies only to the 2nd chart, English mode, and not another key mode (9A)
|word[2]En2_data=...|   // Applies only to the 2nd chart, English mode, and key pattern: 2

Related pages

Changelog

Version Change details
v36.0.0 - Changed to automatically remove tabs, and half-width spaces before and after commas.
v34.1.0 - Changed so that only lyrics displayed with the combination of comma + half-width space can use a normal comma instead of a comma as a separator.
v34.0.0 - Added the ability to combine individual lyrics display settings while referencing data from other charts.
- Implemented lyrics display settings by key types and key patterns.
v31.2.0 - Added a function to refer to data of other chart by specifying word_data name of other chart.
v30.2.0 - Support for lyrics display by scroll setting
v30.0.1 - Supports for description of lyrics display for another key modes
v24.2.1 - Multi-language support for lyrics display
v15.5.0 - Support for changing the font size of lyrics display
v15.3.0 - Changed to conditionally display lyrics in upside-down position when reverse
v15.1.0 - Supports mathematical notation in terms of number of frames and depth
v11.1.2 - Added setting for the bottom lyrics display position to follow the step zone position.
v10.2.1 - Implementation of lyrics display for scroll extension setting (wordAlt_data)
v9.3.0 - Implementation of lyrics display for reverse (wordRev_data)
v7.9.0 - Implemented comment line
v7.7.0 - Support for multiple simultaneous drawing of the same frame.
v5.6.0 - Changed so that the number of frames to fade in and out of lyrics can be specified only for each set of line breaks (added a fourth item for lyric changes).
v5.4.0 - Supports multiple levels of hierarchy.
v3.10.0 - Supports line break separations for each set, and arbitrarily changes the comma at the end of lines when line breaks are used.
v1.9.0 - Supports left-align, center-align, and right-align settings.
Expanded lyrics display types from 2 to 4.
v1.0.0
(v0.46.0)
- Initial implementation

| < Color change | Lyrics display | Background and mask motion > |

⚠️ **GitHub.com Fallback** ⚠️