+ Magical 8bit Plug 2 Operation Manual+ by Yokemura(YMCK) http://www.ymck.net/
+
+ +
What is Magical 8bit Plug?
+Magical 8bit Plug is a software-synthesizer developed by Yokemura@YMCK which generates primitive electronic + sounds like the old 8bit game consoles. It can be used as a plug-in for the host applications that support Audio + Units or VST.
+ + +Features
+-
+
- Basic 8bit-style waveforms +
- As the new waveforms, 1bit noise is introduced, which can emulate the sound of original 8bit console more + accurately +
- Envelope forming with so-called ADSR. +
- Pitch bend capability with depth control +
- Auto Bending(a.k.a Frequency Sweep) which is suitable for making sound effects and drum sound etc. +
- Vibrato to enrich your musical expression +
- Custom envelopes, which gives you more precise control over volume, pitch and pulse duty values. +
Open source
+Magical 8bit Plug 2 is an open source software, so you can modify or enhance the functionality as you want and + contribute it to share your improvement. The GitHub repository is here.
+If you want to support the development but are not familiar to coding you can contribute through a donation.
+ +Differences from the previous version
+ +In this version (Magical 8bit Plug 2) includes all the waveforms that the previous version(Magical 8bit Plug) + has, namely, square, pulse, 8bit-specific pseudo triangle and low resolution noise. And on top of those more + precisely emulated noise waveforms and more detailed controls over the sound are newly implemented.
+This version is technically distinct from the previous one. You can't replace with the new version with your + parameters remaining as it is, but you can install both and keep using them separately.
+ + + + +Installation
+Basically put the plugin file to appropriate folder to start using. As the actual installation method will vary + according to your system and host application, please refer to the instructions from them for the detail. If you + have any questions please don't ask me but ask Google. I'm not going be your kindly technical assistant.
+Here's the standard installation paths. The actual installation method may vary according to your environment. + And again, please don't ask me about the installation because I don't know about your system.
+| Mac | +AudioUnits | +.component | +/Library/Audio/Plug-ins/Components | +
| VST2 | +.vst | +/Library/Audio/Plug-ins/VST | +|
| VST3 | +.vst3 | +/Library/Audio/Plug-ins/VST3 | +|
| Windows | +VST2 | +.dll | + C:¥Program Files¥VSTPlugins + C:¥Program Files¥Steinberg¥VSTPlugins + C:¥Program Files¥Common Files¥VST2 + C:¥Program Files¥Common Files¥Steinberg¥VST2 |
+
| VST3 | +.vst3 | +C:¥Program Files¥Common Files¥VST3 | +
About VST2 and VST3 : Steinberg, which defines the VST specifcation, now supports only their new format, VST3. + But there might be some host applications which still don't fully comply to VST3 and don't work as expected. + In that case try using VST2.
+ + +Usage
+ +Magical 8bit Plug 2 has several sections in its UI. + The sections may switch its contents or its visibility according to the parameter settings. + If you don't see the parameter you want to touch check the parameters to make sure they are properly set. +
+ +
+
+ -
+
- (1)General Section +
- General settings, literally. +
- (2)Monophonic Section +
- Only appears in Monophonic Mode. You can set portamento and arpeggio in this section. +
- (3)Oscillator Specific Section +
- You can set the parameters for the oscillator which you have chosen. The contents vary according to the OSC + Type value. +
- (4)Amp And Pitch Section +
- Parameters about amplitude and pitch. +
- (5)Custom Envelopes Section +
- Only appears when Advanced Options checkbox is on. You can set complex time variances of pitch, volume and + duty with simple text commands. +
General Section
+ +
+
+ | Pulse | +Rectangular waveforms. The duty can be selected in Oscillator Specific Section below. | +
| Triangle | +Pseudo triangle wave. | +
| Noise | +Noise. v2 has 3 different noise algorithms. You can choose one of them in Oscillator Specific Section. + | + +
-
+
Monophonic Section
+ +-
+
- Behavior +
- Monophonic Mode has several different Behaviors.
+ By setting it you'll see some additional parameters.
+
+
++ +Legato ++ +
+ This behavior changes the pitch without restarting the envelope when the already sounding note is followed + by a new note with an overlap. While selecting this option Portamento parameter appears, with which you + can get a smooth transition of pitch. +-
+
- Portamento +
- The time it takes to reach the pitch of new note. If you don't want a portamento set it to 0. +
+ +Arpeggio Up / Arpeggio Down ++ + + + +
+ This behavior plays fast arpeggio when multiple notes pressed at the same time. You'll see Interval + parameter while selecting this option. +-
+
- Interval +
- Specify the interval of arpeggio notes.
+
+
++ +1frame / 2frames / 3frames +Set the interval to 1/60, 1/30, 1/20 seconds respectively. The name "frame" and the 1/60 + second interval are derived from NES's control frame. ++ +96th / 48th / 32nd / 24th +Set the interval according to your song tempo. The length is set literally to 96th / 48th / + 32nd / 24th note length. Song tempo is retrieved from your DAW each time a new note starts + playing. + + +Slider +Set to arbitrary length by a slider which appears only while selectiong this option. + +-
+
+
+
+ +Non-legato +The notes are always newly played without keeping current envelope even they have overlaps. +-
+
+
+
+
+
Oscillator Specific Section
+Pulse case
+
+ By setting OSC Type to "Pulse", Duty parameter will be displayed.
+-
+
- Duty +
- The high/low ratio of the waveform. At 50%, the high and low voltage alternate at the same time duration. + Smaller value gives you a sharper impression. +
Noise case
+
+
+ By setting OSC Type to "Noise", Noise Type parameter will be displayed.
+-
+
- Noise Type +
- Magical 8bit Plug 2 has 3 different noise generating algorithms.
+
+
++ +4bit Pure random ++ Randomly generates 16 level(4bit) voltage, which is exactly same to v1's noise. + ++ +1bit Long Cycle ++ The emulation of NES's long cycle noise. Generates high or low voltage according to pseudo random values. + As it's "pseudo", the values have a cycle, in other words it just repeats the fixed sequence of random-ish + numbers. But the cycle length is long enough to make the sound "noisy" enough. + ++ +1bit Short Cycle +The emulation of NES's short cycle noise. Generates high or low voltage according to a pseudo + randomization, but as the randomization cycle is pretty short (only 93 steps) the sound is rather tonal. + + +-
+
+
Triangle case
+When you chose "Triangle" as OSC Type this section will be empty.
+ + + +Amp And Pitch Section
+
+ Parameters that control time variance of amplitude and pitch. There are several subsections.
+ +Envelope Subsection
+You can specify time variance of the volume with 4 parameters below.
+-
+
- Attack +
- The duration until the volume reaches to the maximum. Once it reaches to max it goes to decay phase. +
- Decay +
- The duration until the volume goes down to Sustain level in decay phase. +
- Sustain +
- The volume it keeps until you release the keyboard. +
- Release +
- The duration until the volume reaches to zero after you released the key. +
Bend Range Subsection
+This subsection only has the pitch bend range parameter.
+-
+
- Range +
- The range. The actual pitch diviation when you twist the pitch bend wheel will vary according to this value. + The unit is half tone and the value corresponds to the pitch diviation at the wheel's maximum position. +
Auto Bend Subsection
+Unlike Pitch Bend above Auto Bend automatically bends the pitch right after the note on regardless if you touch + the wheel or not.
+-
+
- Ini.Pitch +
- Initial Pitch. At key on the pitch starts from higher(lower if the value is minus) than the note you played. + This value specifies the amount of it. +
- Time +
- The pitch automatically approach to the note you played in the time you specified with this value. +
Vibrato Subsection
+You can apply a vibrato with the parameters below.
+-
+
- Rate +
- Frequency to modulate the pitch. The unit is in seconds +
- Depth +
- Pitch amount to modulate. Value 1 corresponds to half tone. +
- Delay +
- Time before vibrato starts. the unit is in seconds. +
- Ignores Wheel +
- When checked it literally ignores the modulation wheel. This is useful if you want always apply the vibrato. + +
Custom Envelopes Section
+
+ This section appears only when you checked "Show Advanced Options". + You can specify the time variation of Volume, Pitch and Pulse Duty by typing the values by text. + The detail is explained in the next chapter.
+ +Custom Envelopes
+Custom Envelope is a new functionality introduced in Magical 8bit Plug 2 to achieve the functionality of + frame-wise control often seen in chiptunes with real consoles. It allows you to set a non linear time variance of + volume, pitch and pulse duty, which can extend your musical expression. The time variance of Pulse Duty can be + assigned only with this option.
+Value range and semantics
+Numeric values are used to set the volume, pitch and pulse duty in Custom Envelopes, and the meaning of the + number differs according to the parameter you are setting.
+| Parameter | +Range | +Meaning | +
| Volume | +0`15 | +0 is silence, 15 is max. | +
| Pitch | +-64`63 | +The result changes according to Resolution combo box to the right.
+
|
+
| Duty | +0`2 | +0: 12.5% , 1: 25%, 2: 50%. | +
Grammar
+As Custom Envelope is like a tiny programming language so you have to follow the grammar to specify what you'd + like the plugin to perform. Basically it's just placing the numbers in row but it also has some specific notations + to save your efforts.
+Basic Sequence
+You can specify the time variance by comma separated values. The time unit is 1/60 sec without depending to your + song tempo. + Spaces are ignored.
+ex) 15, 13, 12, 5, 0+
Slope
+To specify 1 second sequence only with Basic Sequence youfll have to write a row of 60 numbers, which is + cumbersome. If the sequence you want is a simple slope this Slope grammar will help. The format is:
+startValue to EndValue in NumberOfFrames f
+ex) 15 to 0 in 15f+
Again, spaces are ignored.
+Another example used with Basic Sequence
+ex) 15, 14, 13, 12to3in30f, 2, 2, 1, 1, 0+
The last f can be omitted.
+ex) 15 to 0 in 15+
Hold
+You can hold the same value for specified frames. The format is:
+value x NumberOfFrames f
+The last f can also be omitted.
+ex) 15 x 10+
Another example used with Basic Sequence
+ex) 15x10f, 9, 7, 5, 3, 1, 0
+Repeat
+Enclose the sequence you want to repeat with [ ]
+ex) [0,1,2]+
You can place the repeated sequence after basic sequence. Only infinite loop is supported. This means it's + meaningless to put a sequence after [ ] unless you have a Release Sequence(see below)
+ex) 15, 13, 12, 11 [10, 7, 4]+
Release Sequence
+To specify the value change after the key off place the sequence after |
+ex) 15, 14, 12, 10 | 5, 3, 1, 0+
If you use both Repeat and Release Sequence the repeat sequence is repeated until the key off and is switched to + Release sequence after key off.
+ex) 15, 13, 12, 11 [10, 7, 4] | 3, 2, 1, 0+ +
About Demo song
+The sound of the attatched demo song(m8p2demo.mp3) can be reproduced by using MIDI file(m8p2demo.mid) and setting + the plugin parameters according to this Parameter + List
+ . +License
+This plugin is released under GPL v3 License. The source + code is open on GitHub, you can duplicate, distribute or modify it under the condition of GPL.
+Donation
+You can support developing Magical 8bit Plug not only by contribing source code but by a donation as + well. We really appreciate your support.
+ +You can make donation from this page.
+ + + \ No newline at end of file diff --git a/docs/readme-ja.html b/docs/readme-ja.html new file mode 100644 index 0000000..e32b860 --- /dev/null +++ b/docs/readme-ja.html @@ -0,0 +1,542 @@ + + + + + +
+ Magical 8bit Plug 2 Operation Manual+ by Yokemura(YMCK) http://www.ymck.net/
+
+ +
Magical 8bit Plugとは
+Magical 8bit Plug は8bitゲーム機風の素朴な音色を生成するソフトウェア・シンセサイザーです。AudioUnitsおよびVSTをサポートするホストアプリケーションでプラグインとして利用することができます。 +
+ +特徴
+-
+
- 8bit基本音色をサポート +
- より実機に近いノイズ音色を生成する1bitノイズを実装 +
- ADSRによるエンベロープ指定 +
- ピッチベンドおよびベンドレンジ指定 +
- 効果音やドラム音色に必須なオートベンド(周波数スウィープ) +
- 音に表情を与えるビブラート +
- ボリューム・ピッチ・デューティー比を詳細にコントロールできるカスタムエンベロープ +
開発について
+Magical 8bit Plug 2 + はオープンソースですので、欲しい機能や修正があれば、ご自身で改良することが可能です。もちろん、それをフィードバックしていただければ今後のバージョンに生かさせていただきます。GitHubレポジトリはこちらです。
+また、ドネーションも受け付けておりますので、コーディング以外でサポートしていただける方はぜひこちらをよろしくお願いします。
+ +前バージョンとの差異について
+ +本バージョン(Magical 8bit Plug 2)では、前バージョン(Magical 8bit + Plug)で実装されている疑似三角波・ロービットノイズを含むすべての音色が実装されているほか、さらに実機に近いノイズ音色やより詳細な音色制御が新たに追加されています。
+ +本バージョンは、技術的には前バージョンとは別のプラグインです。したがって、前バージョンの設定をそのまま引き継ぐことはできませんが、 + 両方をインストールして別々に使うことは可能です。
+ + + + + +インストール方法
+プラグイン本体を、OSまたはホストアプリケーションで指定されたフォルダへとコピーします。一般的なインストール先は以下の通りです。実際のインストール場所は環境によって異なりますので、お使いのOSやDAWの説明をご参照ください。 +
++ 特に最近ではDAW含むアプリは多様化していますので、それぞれについてプラグイン使用方法について把握しきれておりませんし、実質不可能です。ですのでご質問は私ではなく、Google先生か、またはお使いのソフトのユーザコミュニティなどにお問い合わせいただければと思います。基本的なインストール方法の問題については、お問い合わせいただいてもお答えいたしませんのであらかじめご了承ください。 +
+| Mac | +AudioUnits | +.component | +/Library/Audio/Plug-ins/Components | +
| VST2 | +.vst | +/Library/Audio/Plug-ins/VST | +|
| VST3 | +.vst3 | +/Library/Audio/Plug-ins/VST3 | +|
| Windows | +VST2 | +.dll | + C:\Program Files\VSTPlugins + C:\Program Files\Steinberg\VSTPlugins + C:\Program Files\Common Files\VST2 + C:\Program Files\Common Files\Steinberg\VST2 |
+
| VST3 | +.vst3 | +C:\Program Files\Common Files\VST3 | +
※VST2とVST3について : + VST規格を制定しているSteinberg社は、現在新しい規格であるVST3のみをサポートしています。 + しかし、VST3に完全に対応できていおらず期待通りに動作しないホストアプリケーションもあるかもしれません。 + そのような場合はVST2版の方をお試しください。 +
+ + +使い方
+ +Magical 8bit PlugのUIは、いくつかのセクションに分かれています。 + パラメータの選択状態によって、セクションの内容が変わったり、セクションそのものの有無が変化します。 + セクションやパラメータが見つからない場合は、各種選択状態を確認してみてください。
+ +
+
+ -
+
- ①Generalセクション +
- 全体的な設定を行うセクションです。 +
- ②Monophonicセクション +
- モノフォニックモードの場合にのみ出現します。ポルタメントやアルペジオの設定ができます。 +
- ③オシレータ別セクション +
- オシレータ固有の設定です。OSC Typeの設定によって内容が変化します。 +
- ④音量・ピッチセクション +
- 音量・ピッチに関わる各種パラメータです。 +
- ⑤Custom Envelopesセクション +
- Advanced Optionsチェックボックスをオンにした場合だけ出現します。ピッチ・音量・デューティーの複雑な時間変化をテキストで設定できます。 +
Generalセクション
+ +
+
+ | Pulse | +方形波またはパルス波です。デューティー比は オシレータ別セクションで変更します。 | +
| Triangle | +疑似三角波です。 | +
| Noise | +ノイズです。オシレータ別セクションで３種類のノイズを切り替えることができます。 | + +
-
+
Monophonicセクション
+ +-
+
- Behavior +
- 動作を指定します。指定した動作によって追加のパラメータが出現します。
+
+
++ +Legato ++ +
+ ひとつのノートが鳴っているとき別のノートを押さえると、エンベロープを中断せずに新しいノートの音程へと移行します。これを選択するとPortamentoパラメータが出現します。Portamentを設定すると音程がなめらかに変化します。 +-
+
- Portamento +
- 次の音程へと移るのにかかる時間を指定します。不要な場合は 0 に設定します。 +
+ +Arpeggio Up / Arpeggio Down ++ + + + +
+ 同時に押されている複数のノートを高速アルペジオとして扱います。これを選択すると、Intervalパラメータが追加で出現します。 +-
+
- Interval +
- アルペジオの間隔を指定します。
+
+
++ +1frame / 2frames / 3frames +それぞれ、1/60秒, 1/30秒, 1/20秒に設定します。「フレーム」という呼称と1/60秒という時間は、ファミコンの制御フレームに由来します。 ++ +96th / 48th / 32nd / 24th +曲のテンポに同期した間隔を設定します。それぞれ、96分音符, 48分音符, 32分音符, 24分音符相当の長さとなります。曲のテンポはノートオン時にDAWから取得します。 + + +Slider +スライダーによって任意の長さに設定します。この場合だけ追加でスライダーが出現します。 + +-
+
+
+
+ +Non-legato +ひとつのノートが鳴っているとき別のノートを押さえると、エンベロープを引き継がずに新しいノートへと移行します。つまり、鍵盤を離して新たに押さえたのと同じ動作になります。 +-
+
+
+
+
+
オシレータ別セクション
+Pulse選択時
+
+ OSC Typeで "Pulse" を選んだ場合には、"Duty" パラメータが表示されます。
+-
+
- Duty +
- 出力の高低の時間比（デューティー比）で、50%では高と低を同じ時間比で繰り返します。25%、12.5%の順に鋭い音色となります。 +
Noise選択時
+
+
+ OSC Typeで "Noise" を選んだ場合には "Noise Type" パラメータが表示されます。
+-
+
- Noise Type +
- ノイズの種類です。３種類から切り替え可能です。
+
+
++ +4bit Pure random ++ 前バージョンのノイズと同じノイズで、毎フレームごとにランダムな16段階(=4bit)のレベルを出力する方式です。単なるホワイトノイズに比べると荒々しく、実機のノイズと比べると整っている、中間的なノイズ音色です。 + ++ +1bit Long Cycle ++ 実機の「長周期ノイズ」のエミュレーションです。毎フレームごとに高または低の２段階(=1bit)のレベルを出力する方式です。特に低音域でのトーンが混ざったように聞こえる独特な音色が特徴です。純粋な乱雑さを持つ乱数ではなく周期性を持つ擬似乱数を使用していますが、周期が十分に長いので十分ノイズっぽく聞こえます。 + ++ +1bit Short Cycle +実機の「短周期ノイズ」のエミュレーションです。1bit Long + Cycleと同様、毎フレームごとに高または低の２段階のレベルを出力する方式ですが、疑似乱数の周期が93ステップと短いため、特に高音域で音程が顕著に現れてノイズ感が少なくなります。 + +-
+
+
Triangle選択時
+OSC Typeで "Triangle" を選んだ場合には、このセクションは空になります。
+ + + +音量・ピッチセクション
+
+ 音量・音色の変化の各種パラメータです。いくつかのサブセクションに分かれています。
+ +Envelopeサブセクション
+音量の時間変化を４つのパラメータで指定します。
+-
+
- Attack +
- 鍵盤を押してから音量が100%に達するまでの時間。100%に達するとDecayフェーズに移行します +
- Decay +
- 音量が100%に達してからSusLevelにまで減衰する時間。 +
- Sustain +
- Decay後、鍵盤を離すまでの間維持される音量。 +
- Release +
- 鍵盤を離した後音量が 0 になるまでの時間。 +
Bend Rangeサブセクション
+ピッチベンドの設定です。Rangeパラメータのみがあります。
+-
+
- Range +
- ピッチベンドの振れ幅を、ベンドホイールを最大まで振った時の値で設定します。2.0 で１音、12.0で１オクターブの振れ幅になります。 +
Auto Bendサブセクション
+ピッチホイールとは関係なく、キーオンから自動的に音程を変化させます。
+-
+
- Ini.Pitch +
- 初期ピッチです。押下したキーの本来のピッチよりこの値だけ上（マイナス値を設定した場合下）からスタートします。 +
- Time +
- キー本来のピッチに到達するまでの時間です。 +
Vibratoサブセクション
+音程を周期的に揺らすビブラート効果です。
+-
+
- Rate +
- ピッチを揺らす周期。単位は秒です。 +
- Depth +
- ピッチの変化幅です。1が半音(100cent)に対応します。 +
- Delay +
- キーオンからビブラートが始まるまでの時間を指定できます。単位は秒です。 +
- Ignores Wheel +
- これをチェックするとモジュレーションホイールの値に関係なくビブラートがかかります。すべてのノートにビブラートをかけたい場合に有用です。 +
Custom Envelopesセクション
+
+ "Show Advanced Options" をチェックした場合に表示されます。ボリューム・ピッチ・パルス波デューティーの時間変化をテキストで指定できます。詳細は次章で説明します。
+ + +カスタムエンベロープ
+Custom + Envelopes（カスタムエンベロープ）は、実機でのチップチューンでよく用いられるフレームごとのコントロールをエミュレートしたものです。単なる直線的な変化にとどまらない自由な変化を記述できるので、よりインパクトのある音色を作ることが可能になります。また、パルス波デューティーの時間変化を指定できるのはカスタムエンベロープだけです。 +
+ +値の範囲と意味
+カスタムエンベロープでは、ボリュームやピッチを数値で指定します。数値の意味は、操作するパラメータがボリューム・ピッチ・デューティー比のいずれなのかによって異なります。
+| パラメータ | +範囲 | +意味 | +
| Volume | +0～15 | +0 が無音、15が最大音量です | +
| Pitch | +-64～63 | +右方にあるResolutionの選択によって意味が変わります
+
|
+
| Duty | +0～2 | +デューティー比です。0: 12.5% , 1: 25%, 2: 50%. | +
文法
+数値を簡単なルール＝文法に則って入力することで時間変化を記述します。基本的には値を順番に並べていくだけですが、記述を省力化するための記法も用意されています。
+基本シーケンス
+数値をカンマ区切りで並べていくことで時間変化を記述します。時間の単位は曲のテンポなどによらず 1/60秒固定です。スペースは無視されます。
+ex) 15, 13, 12, 5, 0+ +
スロープ
+直線的な時間変化を記述したい場合、スロープを利用するとひとつひとつ値を指定する手間が省けて便利です。記法は以下です。
+開始値 to 終了値 in フレーム数 f
+ex) 15 to 0 in 15f+ 値が、15フレーム(0.25秒)かけて15から0へ減衰します +
ここでもスペースは省略可能です
+基本シーケンスと組み合わせるとこのようになります。
+ex) 15, 14, 13, 12to3in30f, 2, 2, 1, 1, 0 + 1フレームごとに15, 14, 13と変化したあと30フレームかけて12から3に変化、 + そのあと2フレームごとに2, 1と変化、最後は 0 になります+
最後の f は省略できます。
+ex) 15 to 0 in 15+
ホールド
+同じ値を繰り返す場合、次の記法が便利です。
+値 x フレーム数 f
+これも最後のfは省略できます。
+ex) 15 x 10+
基本シーケンスと組み合わせるとこのようになります。
+ex) 15x10f, 9, 7, 5, 3, 1, 0 + 15を10フレーム維持したあと、9, 5, 3, 1 そして 0 へと推移します+
リピート
+繰り返したいシーケンスを [ ] で囲みます。
+ex) [0,1,2]+
繰り返し回数の指定はなく、必ずキーオフまで無限ループを繰り返します。したがって [ ] の後に配置したシーケンスは、下述のリリースシーケンス以外は無効です。
+ex) 15, 13, 12, 11 [10, 7, 4]+
リリースシーケンス
+| の後にシーケンスを記述することで、キーオフ後の値の変化を指定できます。
+ex) 15, 14, 12, 10 | 5, 3, 1, 0+
リピートとリリースシーケンスは併用できます。この場合、キーオフまでの間リピート部分が繰り返され、キーオフ後はリリースシーケンスに移行します。
+ex) 15, 13, 12, 11 [10, 7, 4] | 3, 2, 1, 0+
デモソングについて
+添付のデモソング(m8p2demo.mp3)のサウンドは、同じく添付のMIDIファイル(m8p2demo.mid)に、こちらの パラメータリスト + の設定を適用すると再現することができます。
+ライセンス
+本プラグインは GPL + v3ライセンスにて配布しています。ソースコードを開示しておりますので、GPLに従い複製、頒布および改変することができます。
+ドネーション
+開発へのご支援は、ソースコードの共有を通じた直接のご支援のほか、ドネーションを受け付けております。ご協力いただける方はぜひよろしくお願いします。
+ドネーションはこちらのページからお申込みいただけます。
+