<commit_before><HEAD>
<TITLE>EOF Vocal Tutorial</TITLE>
<STYLE TYPE="text/css">
p {text-indent: 1cm}
</STYLE>
</head></STYLE>
</HEAD>
<BODY BGCOLOR="313131" TEXT="FFFFFF" LINK="FFFFFF" VLINK="FFFFFF" ALINK="FFFFFF" >

<center><IMG SRC="logo.png" ALT="Logo" BORDER=0 HSPACE=0 VSPACE=3><bR><br></center>
<center>A song editor for "Frets On Fire"</center><br>

<h1><a name="tutorial">Vocal Tutorial</a></h1>
[ <a href="index.htm#intro">Introduction</a> ] [ <a href="index.htm#addinglyrics">Manipulating lyrics</a> ] [ <a href="index.htm#testing1">Testing and editing lyric pitches</a> ] [ <a href="index.htm#refocus">Using the full range of pitches</a> ] [ <a href="index.htm#intermediate">Intermediate vocal charting topics</a> ] [ <a href="index.htm#import">Lyric import</a> ] [ <a href="index.htm#testing2">Testing</a> ] [ <a href="index.htm#advanced">Advanced topics</a> ]<br><br>

<h1><a name="intro">Introduction</a></h1>
Charting vocals in EOF begins like any other chart work, you can create a new chart or open an existing chart.  Change to PART VOCALS:<br>
<center><IMG SRC="voximage1.png" ALT="screen" BORDER=0 HSPACE=0 VSPACE=3><bR><br></center>

You will notice that not only is the piano roll different, but the 3D Preview panel (at the lower right quadrant of the EOF window) has been replaced by a 49-key piano that spans four full octaves from C2 through C6.  As per Harmonix's documentation, this is range of pitches that Rock Band charts can use.  This 49-key piano may be referred to as the Full Piano, as there is also a smaller piano to the left of the piano roll that only has 13 keys, referred to as the "Mini Piano".  EOF comes with piano samples of each of the 49 usable pitches, allowing you to test vocal pitches during charting.  Move the mouse over any of the keys in the Full or Mini Piano to see a small pop-up displaying the note name, such as C#2.  Left click on any of the keys to hear the corresponding tone.  You can also click and hold the left mouse button and drag the mouse across keys on either piano to sound the tone of each of the keys, which could be useful for finding the right pitch to use if you are having trouble.  As you move the mouse up and down within the piano roll area, you will see a green rectangle move along with the mouse, and the note name displayed to the far left (next to the Mini Piano) will change to reflect the pitch that would be assigned to the lyric if you place a note at the mouse's position.  You can test what the pitch would sound like without having to move the mouse to either of the pianos by pressing the P key.  P will only sound the piano tone if the mouse is within the piano roll area.<br><br>




<h1><a name="addinglyrics">Manipulating lyrics</a></h1>
Vocal notes are placed similarly to instrument notes:  You move the mouse's vertical position to match the corresponding pitch you want and then place the note by right clicking or pressing the Insert key.  The exception to this is if you are using the RexMundi input method, right click/insert brings up the context menu.  If using the RexMundi input method, use the number keys 1, 2, 3, 4 or 5 (not on the numpad) to place the note at the mouse's position.  When a lyric is placed, EOF will ask you to type the lyric text:<br>
<center><IMG SRC="voximage2.png" ALT="screen" BORDER=0 HSPACE=0 VSPACE=3><bR><br></center>

You can either type the lyric in now or just click OK (or hit Enter) to leave it blank, but if you forget to enter it later, that particular pitch might not work correctly in FoF when you play the chart.  Just as with notes in instrument tracks, the Grid Snap feature allows you to place your lyrics on partial measure intervals.  As always, beat syncing the chart (See <a href="../tutorial/index.htm#tempomap">"Creating a Tempo Map"</a> in the original tutorial) before placing lyrics is strongly recommended, as the Grid Snap feature can then be used with a great deal of accuracy.  If you haven't beat synced the chart, you should not use Grid Snap for lyric placement.<br><br>

A word of caution:  If you move beat markers while placing lyrics, be aware that the "Auto Adjust" feature will move the positions of lyrics for the affected beats, which is EOF's behavior by design.  This is another reason to beat sync your chart before placing lyrics and notes, but if you have "Auto Adjust" enabled and want to prevent the notes and lyrics that fall within the beats from being affected when clicking and dragging a beat marker, hold the SHIFT key before clicking and dragging it.  If you do NOT have "Auto Adjust" enabled, holding SHIFT when clicking and dragging a beat marker will cause the notes to adjust, so make sure you know whether "Auto Adjust" is enabled by checking File>Preferences.<br><br>

A lyric can be created without defining its pitch by positioning the mouse above the top-most key of the Mini Piano, such as in the lyric display area at the top of the piano roll area, when you place the lyric.  If you place a lyric here, EOF will skip saving a pitch for the lyric and just ask you to specify the lyric text.  The resulting lyric will have the text but no pitch, and during save, the MIDI will be created to reflect the pitchless lyric as a freestyle lyric.
<center><IMG SRC="voximage5.png" ALT="screen" BORDER=0 HSPACE=0 VSPACE=3><br></center>
If you define a lyric without a pitch, EOF will display the lyric's position in gray instead of green or red, and you can set the pitch later (See the <a href="index.htm#testing1">"Testing and editing lyric pitches"</a> section below).  When a lyric without a pitch is placed, the lyric must contain text and cannot be entirely whitespace, otherwise the lyric is removed.  When the chart is saved, EOF will assign a pitch to the lyric and will append the freestyle marker so that the lyric will work in-game.  If you want to change a lyric's text after it has been defined, you can select the lyric and either press the L key or use the "Edit Lyric" function in the Note menu.  If you edit the text for a pitchless lyric to be blank or just whitespace, the lyric will be removed.  As more lyrics are placed, you may find that it becomes difficult to work in the default zoom level of 1/10, as some lyrics are feasibly going to be long enough to appear to overlap, especially if you are using EOF's default window size of 640x480:<br>
<center><IMG SRC="voximage3.png" ALT="screen" BORDER=0 HSPACE=0 VSPACE=3><bR><br></center>

To remedy this, simply increase EOF's window size by opening the File menu, selecting Display, selecting a larger window size and clicking OK.  Or if you prefer, you can zoom in on the chart by either pressing the + key on the numpad, or by opening the Edit menu, selecting Zoom and selecting a zoom level.  The - key on the numpad can be used to zoom back out:<br><commit_msg>Updated the vocal tutorial to reflect EOF's prompting to save pitchless lyrics as freestyle (from r357), indicating that pitchless lyrics are not singable in-game.<commit_after><HEAD>
<TITLE>EOF Vocal Tutorial</TITLE>
<STYLE TYPE="text/css">
p {text-indent: 1cm}
</STYLE>
</head></STYLE>
</HEAD>
<BODY BGCOLOR="313131" TEXT="FFFFFF" LINK="FFFFFF" VLINK="FFFFFF" ALINK="FFFFFF" >

<center><IMG SRC="logo.png" ALT="Logo" BORDER=0 HSPACE=0 VSPACE=3><bR><br></center>
<center>A song editor for "Frets On Fire"</center><br>

<h1><a name="tutorial">Vocal Tutorial</a></h1>
[ <a href="index.htm#intro">Introduction</a> ] [ <a href="index.htm#addinglyrics">Manipulating lyrics</a> ] [ <a href="index.htm#testing1">Testing and editing lyric pitches</a> ] [ <a href="index.htm#refocus">Using the full range of pitches</a> ] [ <a href="index.htm#intermediate">Intermediate vocal charting topics</a> ] [ <a href="index.htm#import">Lyric import</a> ] [ <a href="index.htm#testing2">Testing</a> ] [ <a href="index.htm#advanced">Advanced topics</a> ]<br><br>

<h1><a name="intro">Introduction</a></h1>
Charting vocals in EOF begins like any other chart work, you can create a new chart or open an existing chart.  Change to PART VOCALS:<br>
<center><IMG SRC="voximage1.png" ALT="screen" BORDER=0 HSPACE=0 VSPACE=3><bR><br></center>

You will notice that not only is the piano roll different, but the 3D Preview panel (at the lower right quadrant of the EOF window) has been replaced by a 49-key piano that spans four full octaves from C2 through C6.  As per Harmonix's documentation, this is range of pitches that Rock Band charts can use.  This 49-key piano may be referred to as the Full Piano, as there is also a smaller piano to the left of the piano roll that only has 13 keys, referred to as the "Mini Piano".  EOF comes with piano samples of each of the 49 usable pitches, allowing you to test vocal pitches during charting.  Move the mouse over any of the keys in the Full or Mini Piano to see a small pop-up displaying the note name, such as C#2.  Left click on any of the keys to hear the corresponding tone.  You can also click and hold the left mouse button and drag the mouse across keys on either piano to sound the tone of each of the keys, which could be useful for finding the right pitch to use if you are having trouble.  As you move the mouse up and down within the piano roll area, you will see a green rectangle move along with the mouse, and the note name displayed to the far left (next to the Mini Piano) will change to reflect the pitch that would be assigned to the lyric if you place a note at the mouse's position.  You can test what the pitch would sound like without having to move the mouse to either of the pianos by pressing the P key.  P will only sound the piano tone if the mouse is within the piano roll area.<br><br>




<h1><a name="addinglyrics">Manipulating lyrics</a></h1>
Vocal notes are placed similarly to instrument notes:  You move the mouse's vertical position to match the corresponding pitch you want and then place the note by right clicking or pressing the Insert key.  The exception to this is if you are using the RexMundi input method, right click/insert brings up the context menu.  If using the RexMundi input method, use the number keys 1, 2, 3, 4 or 5 (not on the numpad) to place the note at the mouse's position.  When a lyric is placed, EOF will ask you to type the lyric text:<br>
<center><IMG SRC="voximage2.png" ALT="screen" BORDER=0 HSPACE=0 VSPACE=3><bR><br></center>

You can either type the lyric in now or just click OK (or hit Enter) to leave it blank, but if you forget to enter it later, that particular pitch might not work correctly in FoF when you play the chart.  Just as with notes in instrument tracks, the Grid Snap feature allows you to place your lyrics on partial measure intervals.  As always, beat syncing the chart (See <a href="../tutorial/index.htm#tempomap">"Creating a Tempo Map"</a> in the original tutorial) before placing lyrics is strongly recommended, as the Grid Snap feature can then be used with a great deal of accuracy.  If you haven't beat synced the chart, you should not use Grid Snap for lyric placement.<br><br>

A word of caution:  If you move beat markers while placing lyrics, be aware that the "Auto Adjust" feature will move the positions of lyrics for the affected beats, which is EOF's behavior by design.  This is another reason to beat sync your chart before placing lyrics and notes, but if you have "Auto Adjust" enabled and want to prevent the notes and lyrics that fall within the beats from being affected when clicking and dragging a beat marker, hold the SHIFT key before clicking and dragging it.  If you do NOT have "Auto Adjust" enabled, holding SHIFT when clicking and dragging a beat marker will cause the notes to adjust, so make sure you know whether "Auto Adjust" is enabled by checking File>Preferences.<br><br>

A lyric can be created without defining its pitch by positioning the mouse above the top-most key of the Mini Piano, such as in the lyric display area at the top of the piano roll area, when you place the lyric.  If you place a lyric here, EOF will skip saving a pitch for the lyric and just ask you to specify the lyric text.  The resulting lyric will have the text but no pitch.  During save, if the chart has any pitchless lyrics, it will ask if you want them to be written to the MIDI as playable freestyle lyrics.  If all of your lyrics are pitchless and you save the chart opting to not have them written as freestyle, it has been reported that the lyrics will display when playing insrument tracks, but PART VOCALS will not be a playable track.
<center><IMG SRC="voximage5.png" ALT="screen" BORDER=0 HSPACE=0 VSPACE=3><br></center>
If you define a lyric without a pitch, EOF will display the lyric's position in gray instead of green or red, and you can set the pitch later (See the <a href="index.htm#testing1">"Testing and editing lyric pitches"</a> section below).  When a lyric without a pitch is placed, the lyric must contain text and cannot be entirely whitespace, otherwise the lyric is removed.  When the chart is saved, EOF will assign a pitch to the lyric and will append the freestyle marker so that the lyric will work in-game.  If you want to change a lyric's text after it has been defined, you can select the lyric and either press the L key or use the "Edit Lyric" function in the Note menu.  If you edit the text for a pitchless lyric to be blank or just whitespace, the lyric will be removed.  As more lyrics are placed, you may find that it becomes difficult to work in the default zoom level of 1/10, as some lyrics are feasibly going to be long enough to appear to overlap, especially if you are using EOF's default window size of 640x480:<br>
<center><IMG SRC="voximage3.png" ALT="screen" BORDER=0 HSPACE=0 VSPACE=3><bR><br></center>

To remedy this, simply increase EOF's window size by opening the File menu, selecting Display, selecting a larger window size and clicking OK.  Or if you prefer, you can zoom in on the chart by either pressing the + key on the numpad, or by opening the Edit menu, selecting Zoom and selecting a zoom level.  The - key on the numpad can be used to zoom back out:<br>
{'fraction_non_alphanumeric': 0.06869145614533069, 'fraction_numerical': 0.008870281010502412, 'mean_word_length': 4.498634412797503, 'pattern_counts': {'":': 0, '<': 163, '<?xml version=': 0, '>': 165, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6510020', 'n_tokens_mistral': 4013, 'n_tokens_neox': 3801, 'n_words': 2267}