XF Import


XF file (*.mid), which is used some application such as KARAKU, and XKM file (*.xkm) can be used as the lyric data.

Outline of XF Import
When importing XF file, a Graphics Track is generated newly, and Blocks and Events are also generated according to the following description.

Title of Contents
Title Block is generated at the top of the contents, and an Text Event which displays music title and artist name is generated. Music title and artist name refers the music title and the artist name defined in the XF information header of XFIH chunk.

Generate Block / Event
When line-feed is defined in lyric data, a new Text Event will be created in the other Block for the subsequent.
In addition, a part of Vocal Part Cue in XFKM chunk generates a Text Event in one Block. Even in the same Vocal Part Cue, when line-feed is defined in lyric data, a new Block is generated for the subsequent.
Text Events generated in the same Block will be set up to display at the same time.

String in Lyric data until line-feed generates one Text Event.
Text Events in a Block is arranged its layout automatically when importing. X-coordinates are arranged from the top corner by aligning [Align Left] and [Align Right] in order. At this time, when line number is odd number, the last line is centering. Y-coordinates are arranged [Align Bottom].
When one line of lyric data is longer than the width of display area, change the line by setting Event of XF data as a line-feed. At this time, the Text Event after line-feed is aligned to the right.

In addition, Wipe information of Text Event is automatically set up according to the wipe timing of XF lyric Event.(In this description, wipe timing means the wipe process timing of lyric display during XF play which has been calculated from XF lyric Event timing information, lyric display offset value of XF lyric header, or the start time measuring point defined in cue data "START".)

XF data definition except above is treated as below.
- space designation " '^'" will be converted into half-size space.
- sub-line-feed " '% " is treated as the same as line-feed.
- Tab designation "'^' " aligns the Text Event after the designation to the right.


EventParameter WipeEffect
Music title, Player,
except Lyric
40h Not setup
Solo 41h Setup
Male voice 42h
Female voice 43h
Mixed voice 44h
Chorus 45h
Lyric (words) 46h Not setup

Setup of Color Attribute and Coordinate System

When importing XF file, Event Parameter can be automatically set up to each Text Event.
SCAS sets up Event Parameter like the table above, according to Vocal Part Cue definition of XFKM chunk.
Event setup after importing can be omitted if setting up color attribute (color of text, background, and transparent before and after wipe) or coordinate system before importing XF.
In addition, display plane of all Text Event is set to Plane2.

Import Contents Information

If selecting [Import contents information also] when importing XF, SCAS refers XF information header of XFIH chunk, then loads it as contents information.
Importable items are Music title, Artist, Lyricist, Composer, and Arranger.
In addition, category will be initialized when designating [Import contents information also].

Designation of Lyric Indication Offset Value

When importing XF, offset value of lyric indication can be designated into the arbitrary point by checking [Lyrics offset value]. Offset value can be designate with either msec or tick.

Designation of Clearing Information at the time of Import

When importing XF, graphic track information can be maintained by removing a check from [Clear play tracks before import]. With the initial setting, all information will be cleared.

Limitation
SCAS stops importing operation of XF file for the following forms.
- SMF format is not 0. (file format is not XF form).
- Tempo information is not defined in SMF Track Chunk.
- Music Title is not defined in XF information header of XFIH Chunk.
- XFKM Chunk does not exist. Or an error occurs when loading XFKM Chunk.
- Lyric data is not defined in XFKM Chunk.