-
Notifications
You must be signed in to change notification settings - Fork 0
/
help_en.html
36 lines (36 loc) · 16 KB
/
help_en.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
<html><head><meta name="qrichtext" content="1" /><style type="text/css">
p, li { white-space: pre-wrap; }
</style></head><body style=" font-family:'FreeSans'; font-size:11pt; font-weight:400; font-style:normal;">
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-weight:600;">• Importing MIDI file</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-size:9pt;">First of all, you should import a MIDI (Musical Instrument Digital Interface) file if you want to make an animation from it. </span><span style=" font-family:'Sans Serif'; font-size:9pt; color:#808080;">If you don't want any animations, close the program, it won't play audio at this current version :(.</span><span style=" font-family:'Sans Serif'; font-size:9pt;"> But considering you want to make an animation, you are going to need a music file to do it and this software is capable of recognizing MIDI files. To import them, you can </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">file -> import MIDI</span><span style=" font-family:'Sans Serif'; font-size:9pt;"> </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">file</span><span style=" font-family:'Sans Serif'; font-size:9pt;"> or, alternatively, </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">drag & drop</span><span style=" font-family:'Sans Serif'; font-size:9pt;"> your file to the main window (not to the text input area).</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-size:9pt;">MIDI files store notes, tempo changes and other information as messages, which consist of a set of bytes. These messages are ordered by their arising time given in ticks, the MIDI timing unit. As soon as the MIDI file is imported, its messages are printed out into the text input area in a quasi-arbitrary form suggested by the Craigsapp MIDI library. This text with the printed MIDI messages can be optionally saved by </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">file -> save</span><span style=" font-family:'Sans Serif'; font-size:9pt;"> or loaded by </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">file -> load</span><span style=" font-family:'Sans Serif'; font-size:9pt;">. Don't delete this text, it will be used for processing.</span></p>
<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Sans Serif'; font-size:9pt;"><br /></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-weight:600;">• Processing</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-size:9pt;">In order to create a list of notes and a list of tempo changes in the memory, you can click </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">process</span><span style=" font-family:'Sans Serif'; font-size:9pt;">. It takes the text as it currently is. After processed, the data is ready to be interpreted by the animating functions.</span></p>
<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Sans Serif'; font-size:9pt;"><br /></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-weight:600;">• Note Blocks</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-size:9pt;">To see the whole notes in the MIDI file in a single still picture, click </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">note blocks</span><span style=" font-family:'Sans Serif'; font-size:9pt;">. This is actually not so useful if you can use the </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">animation</span><span style=" font-family:'Sans Serif'; font-size:9pt;">, which is way more customizable, but can be helpful and quick to deal with some issues.</span></p>
<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Sans Serif'; font-size:9pt;"><br /></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-weight:600;">• Animation</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-size:9pt;">The most expected button can be clicked as soon as the imported MIDI file is processed. Two new windows are open: the </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-style:italic;">animation view</span><span style=" font-family:'Sans Serif'; font-size:9pt;"> and the </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-style:italic;">animation controllers</span><span style=" font-family:'Sans Serif'; font-size:9pt;">. The first one is your </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">visual music</span><span style=" font-family:'Sans Serif'; font-size:9pt;">, the animation. The second one is a set of controllers to zoom in/out, go backward/forward, to play and to record videos. If you wish to </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">record a video</span><span style=" font-family:'Sans Serif'; font-size:9pt;">, a valid file name has to be set on the video output input on the main window before you open the animation. If it is already open, you have to close it and re-open. At this version, you shall manually type .avi at the end of the file name. Some other extensions should also work, according to FFMPEG. After opening the animation windows with a video output file name, you can go and back, play and zoom like you want. When you press the button </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">video rec</span><span style=" font-family:'Sans Serif'; font-size:9pt;">, </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600; font-style:italic;">every rendered frame</span><span style=" font-family:'Sans Serif'; font-size:9pt;"> will be written to the video, even if you are going back and forth. So the most reasonable would be just hitting play ">" after pressing video rec.</span></p>
<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Sans Serif'; font-size:9pt;"><br /></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-weight:600;">• Resolution and frames per second</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-size:9pt;">You can choose the rendering resolution and fps of your animation, what will also be the size and fps of the output video. After an adjustment, you have to close and re-open the animation windows.</span></p>
<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Sans Serif'; font-size:9pt;"><br /></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-weight:600;">• Tracks properties</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-size:9pt;">MIDI Tracks: MIDI files can be either type 0 or type 1 or type 2. Almost all of them are either type 1 or type 2 nowadays. The type 0 files retain all information merged into a single track while the type 1 and 2 files can have separated tracks. In type 2 files, the tracks are independent from each other, what is actually not relevant here. This version of the software is able to deal well with type 1 and 2 MIDI files. Usually each track is an instrument or, in case of piano, for instance, there can be one track for the right hand and another for the left hand. Actually the tracks can be set up at will when writting music to MIDI files. A MIDI file can contain up to 128 tracks (= 2^7) but just 16 (= 2^4) channels. Each track can represent a different instrument, but in order to play the music with a synthesizer or to communicate with other MIDI devices, the unique dividers are the channels, waht means that you can have an output of at most 16 different instrument patches sounding at the same time. This software could operate with all the possible tracks, since it does not depend on the channels, but at this version, it only takes the 24 first tracks. So if you want to make animations with more than 24 different tracks, I suggest you to render separated videos and merge then later, using a video sequencer editor, like the one in Blender, for example. If there are empty tracks, you should remove them to get all the non-empty ones as the first positions. You can do it </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">before processing</span><span style=" font-family:'Sans Serif'; font-size:9pt;"> going to </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">tools -> remove empty tracks (squeeze)</span><span style=" font-family:'Sans Serif'; font-size:9pt;">.</span></p>
<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Sans Serif'; font-size:9pt;"><br /></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-size:9pt;">Tracks properties: if you go </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">edit -> tracks</span><span style=" font-family:'Sans Serif'; font-size:9pt;">, a dock widget (dockable window) will pop up. There you can change track colors, color schemes shapes, connections and blur. New visual and animations options shall be developed in the following versions, but untill now, these are the available features. Blur is only effective if the tracks are set to be separately rendered (</span><span style=" font-family:'Sans Serif'; font-size:9pt; font-style:italic;">see render properties</span><span style=" font-family:'Sans Serif'; font-size:9pt;">).</span></p>
<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Sans Serif'; font-size:9pt;"><br /></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-weight:600;">• Render properties</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-size:9pt;">There is a bunch of features to deal with rendering.</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-size:9pt;">- In the tab </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">vertical range</span><span style=" font-family:'Sans Serif'; font-size:9pt;">, you can adjust the vertical positon of the notes as you like. The default is vertically centered with a space both on the top and on the bottom. If you set vertical range to 50, this space is 0. For values greater than 50, notes are cut out.</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-size:9pt;">- In the tab </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">lines</span><span style=" font-family:'Sans Serif'; font-size:9pt;">, there are options to draw a vertical central line and vertical lines for rythmic measure.</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-size:9pt;">- In the tab </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">tracks rendering</span><span style=" font-family:'Sans Serif'; font-size:9pt;">, you can choose to render tracks separately (much slower according to the tracks count, but it allows the use of blur and the tracks get a transparency effect, not overlapping each other), to render playing notes separately (a little slower, allows the playing notes blurring) and to render moving notes separately, what is analogous to the previous one, but for moving notes like circles with moving notes (selectable on tracks properties).</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-size:9pt;">- In the tab </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">time</span><span style=" font-family:'Sans Serif'; font-size:9pt;">, you can add some blank space before and after the entire music. For this to work, you have to close and re-open the animation windows.</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-size:9pt;">- In the tab </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">video codec</span><span style=" font-family:'Sans Serif'; font-size:9pt;">, you can choose the 4 characters codec code for the FFMPEG video renderer. See the FFMPEG help about that for more information.</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-size:9pt;">That's all till now, hope you enjoy!</span></p>
<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-family:'Sans Serif'; font-size:9pt;"><br /></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-weight:600;">• Save/Load settings</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-family:'Sans Serif'; font-size:9pt;">If you want to save the current tracks and rendering set up, you can save them to a .dat file and load them again. </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">Edit -> save settings</span><span style=" font-family:'Sans Serif'; font-size:9pt;"> to save or </span><span style=" font-family:'Sans Serif'; font-size:9pt; font-weight:600;">edit -> load settings</span><span style=" font-family:'Sans Serif'; font-size:9pt;"> to load.</span></p></body></html>