And in this tutorial we're going to talk to you about the Juice audio processor class.

このチュートリアルでは、Juiceオーディオプロセッサーのクラスについて説明します。

The audio processor class is the way that you can write your plug-in code once but be able to turn your plug-in code into all the different formats that you're able to deploy for plugins such as VST3, AU, and AEX, and also be able to do those plug-ins on separate operating systems such as Windows and Mac OS.

オーディオ・プロセッサー・クラスは、プラグイン・コードを一度書くだけで、VST3、AU、AEXといったプラグイン用にデプロイできるすべての異なるフォーマットにプラグイン・コードを変換でき、WindowsやMac OSといった別々のオペレーティング・システムでプラグインを実行できるようにする方法です。

So we have two objectives for this tutorial.

このチュートリアルには2つの目的がある。

The first objective is that we're going to dissect the Juice audio processor class.

最初の目的は、Juiceオーディオプロセッサーのクラスを分解することだ。

I've been doing Juice tutorials since 2017 and I'm embarrassed to say that I never really took the time until recently to dig into the audio processor class and really truly look at what it does and what each function is doing.

私は2017年からJuiceのチュートリアルをやっていますが、恥ずかしながら、最近までオーディオプロセッサーのクラスを掘り下げて、それが何をしているのか、それぞれの機能が何をしているのか、本当に時間をかけて見たことがありませんでした。

So I'm going to do that with you today and show you some of the insights that I've gained along the way.

そこで今日は、私がその過程で得た洞察のいくつかをお見せしようと思う。

The second objective is that I'm going to show you the Juice audio processor class alongside the CMake file that we did in the last tutorial and show you how those two things relate to each other and how the configuration of your CMake file relates to the code that is actually generated for the Juice audio processor class.

つ目の目的は、前回のチュートリアルで行ったCMakeファイルと一緒にJuiceオーディオ・プロセッサ・クラスをお見せし、この2つがどのように関係し合っているのか、CMakeファイルの設定がJuiceオーディオ・プロセッサ・クラス用に実際に生成されるコードとどのように関係しているのかをお見せすることです。

When one of my mentors showed me how these two files relate, it really helped me expand my mind map on how build systems and generated code actually relate to each other and helped me level up my skill set in a major way and I hope it levels up your skill set as well.

私のメンターのひとりが、この2つのファイルがどのように関連しているかを教えてくれたとき、ビルド・システムと生成されたコードが実際にどのように関連しているのか、私のマインドマップを広げてくれた。

If you're ready to take that next step into audio plug-in development, I invite you to check out our latest book, The Complete Beginner's Guide to Audio Plug-in Development.

オーディオ・プラグイン開発への次のステップを踏み出す準備ができたら、ぜひ最新刊『オーディオ・プラグイン開発完全入門』をご覧ください。

This has everything that you need to know to build your first audio plug-in, over 450 pages, and you can get it both on physical copy via Amazon and via ebook on our website theaudioprogrammer.com.

この本には、初めてのオーディオ・プラグインを作るために必要な知識がすべて載っており、450ページ以上あります。アマゾンで物理的に購入することも、私たちのウェブサイトtheaudioprogrammer.comで電子書籍として購入することもできます。

This video is also brought to you today by our sponsor, JetBrains.

また、このビデオはスポンサーのジェットブレインズから提供されたものです。

So I've been using their Sealion IDE for quite a while now and along with their great cross-platform experience of being able to switch back and forth between Windows and Mac and being able to find everything easily because the experience is largely the same.

WindowsとMacの間を行ったり来たりできる素晴らしいクロスプラットフォーム体験とともに、体験はほとんど同じなので、すべてを簡単に見つけることができる。

I've also been enjoying their integrated CMake support.

統合されたCMakeのサポートも気に入っている。

It's been a lifesaver for me because I'm not an expert on build systems and being able to just double click on the CMake file and have it open up my project is a lifesaver.

私はビルドシステムの専門家ではないので、CMakeファイルをダブルクリックするだけでプロジェクトを開くことができるのは助かります。

It also has the ability to be able to debug CMake files, which is really awesome.

また、CMakeファイルをデバッグできる機能もあり、これは本当に素晴らしい。

I really love that feature.

あの機能は本当に気に入っている。

Be sure to check out JetBrains and Sealion on the link below.

以下のリンクからJetBrainsとSealionをぜひチェックしてほしい。

And without further delay, let's get started.

さっそく始めよう。

Okay, so here we are in our project and one thing that you'll notice is that I'm in my CMake file rather than having the ProJuicer.

ProJuicerを使うのではなく、CMakeファイルを使うということです。

And with that, I'm going to make a very small announcement, which is that moving forward, we're going to be doing our tutorials using CMake rather than the ProJuicer.

ということで、これからProJuicerではなくCMakeを使ってチュートリアルを行うことになりました。

Now, I think that the ProJuicer is great if you know barely anything about C++ and about Guice and you're just starting to get off the ground and write some code and write your first plugin.

ProJuicerは、C++やGuiceのことをほとんど知らなくて、これからコードを書いたり、最初のプラグインを書いたりしようと思っている人には最適だと思う。

But I think once you start really getting serious about C++ development that you're probably going to want to start switching towards using a build system like CMake.

しかし、C++開発に本格的に取り組み始めたら、おそらくCMakeのようなビルド・システムを使う方向に切り替えたくなると思う。

This is a challenging step and it's been challenging for me.

これは挑戦的なステップであり、私にとっても挑戦的だった。

However, one thing that I will say is having been around a couple major music tech companies that all of them use something like CMake or another build system for generating their projects.

ただ、ひとつだけ言えるのは、いくつかの主要な音楽技術会社にいたことがあるが、どの会社もCMakeやその他のビルド・システムを使ってプロジェクトを生成していた。

None of them use the ProJuicer.

誰もプロジューサーを使っていない。

Okay, so if you want to get into this and start doing this for a living, I would highly advise or recommend that you start learning build systems and learning at least the basics about them.

もし、あなたがこの仕事に就き、生活のためにこの仕事を始めたいのであれば、ビルド・システムを学び、少なくともその基本を学ぶことを強く勧める。

And that's what I'm trying to do as well.

そして、それは私がやろうとしていることでもある。

So that's why we're working with CMake right now.

だから今、CMakeを使っているんだ。

So I know that this transition from the ProJuicer to CMake will feel a little bit intimidating for some.

だから、ProJuicerからCMakeへの移行は、ある人たちにとっては少し気後れするものだと思う。

But don't worry, we're going to take it slow and I'm going to try to show you every step of the way how everything is happening.

でも心配しないで、ゆっくりやっていくつもりだし、すべての段階をお見せしようと思っている。

So first thing I would say is watch the last tutorial because that's how we actually created the CMake file that we're seeing here right now.

というのも、このチュートリアルで実際にCMakeファイルを作成したからです。

So the second thing I'm going to show you is something that I learned when I first started working with CMake that really helped me switch on the light in terms of what build systems do and what their intention is.

そこで2つ目に紹介するのは、私がCMakeを使い始めた頃に学んだことで、ビルド・システムが何をするのか、そしてその意図は何なのかという点で、私に光を与えてくれたものだ。

So if we scroll down here a little bit, what I'm going to show you is that in this juice add plugin function that we have a couple configuration options.

ここで少し下にスクロールすると、このjuice add plugin関数にいくつかの設定オプションがあることがわかります。

Okay, so the reason for this is let's just take the code and put it aside for a second.

さて、この理由は、コードをちょっと脇に置いておこう。

And let's just say that we were just having a conversation about creating a plugin.

そして、ちょうどプラグインを作ろうという会話をしていたとしよう。

So one of the first questions that we would probably ask is, well, what kind of plugin do we want it to be?

そこで私たちが最初にする質問のひとつは、どんなプラグインにしたいのか、ということだろう。

Do we want it to be an audio effect?

オーディオ効果にするのか？

Do we want it to be a synthesizer?

シンセサイザーにするのか？

Do we want it to be some type of midi effect?

ある種のミディ・エフェクトにしたいのだろうか？

These are some of the first questions that we would ask ourselves, right?

これらは、私たちが自問自答する最初の質問のいくつかだろう？

And so this is what I would call or what would technically be called global configuration.

そして、これがグローバル・コンフィギュレーションと呼ばれるものだ。

Okay, what do we want this project to be?

では、このプロジェクトをどうしたいのか？

So you can see that here with the CMake file that these global configurations are here on the front, meaning on the CMake file itself, that we can change these to true or false.

CMakeファイルでは、これらのグローバル設定が前面、つまりCMakeファイル自体にあり、これらをtrueまたはfalseに変更できることがわかります。

So think of these as options or buttons that we could switch as developers.

つまり、これらは開発者として切り替えられるオプションやボタンのようなものだと考えてほしい。

Now, what happens is that these actually affect what happens on the code in the project that's actually generated.

さて、何が起こるかというと、これらは実際に生成されるプロジェクトのコード上で起こることに影響する。

So if we go to skipping ahead a little bit into some of the functions into the plugin processor.cpp, we have this function here that says accepts midi, right?

プラグイン・プロセッサー.cppのいくつかの関数を少し先に読み飛ばすと、ここにaccepts midiという関数がありますね？

And we can see that this is currently set to return false, okay?

そして、これは現在falseを返すように設定されていることがわかる。

Because we see that this return true is kind of shaded and that it's currently returning false.

というのも、このtrueを返す部分が陰になっており、現在はfalseを返していることがわかるからだ。

So it's saying that we do not want midi input.

つまり、MIDI入力はいらないということだ。

That correlates directly with what we have here.

それは、ここにあるものと直接的に関連している。

This option needs midi input.

このオプションにはMIDI入力が必要です。

Now, if I set this to true, and then if I regenerate the CMake file, rerun the CMake file, for people who are not using CLion, you would need to use the CMake command, which I believe is CMake-B, builds-G, and then whatever IDE that you're using.

CLionを使っていない人は、CMakeコマンド（CMake-B、builds-G、そして使っているIDE）を使う必要がある。

Okay, so now we come in here into access midi, and we see that that has now returned true.

さて、ここでアクセス・ミディに入り、trueが返されたことを確認しよう。

So we've just kind of hit a button or hit a switch there, and that has actually switched things.

だから、あるボタンを押したり、あるスイッチを押したりして、実際に状況を切り替えたんだ。

So this is a great way for us to be able to create a convenient interface for the developer to be able to change their configuration of their plugin or of their project in a way that before they actually even generate the project.

だからこれは、開発者が実際にプロジェクトを生成する前に、プラグインやプロジェクトの設定を変更できる便利なインターフェイスを作ることができる素晴らしい方法なんだ。

So that is what the intention of using CMake really is, okay?

これがCMakeを使う本当の意図なんだ。

So if I take this and I turn this back to false, and then if I come here over back over here into this, and then I hit this refresh my CMake file, you'll see that this will change back to false.

そこで、この部分をfalseに戻し、この部分に戻ってCMakeファイルを更新すると、falseに戻ることがわかります。

Okay, and see how that switched?

それで、どう切り替わったかわかる？

Okay, so that was something that was very simple, but also a very big revelation for me.

なるほど、それはとてもシンプルなことだったが、僕にとってはとても大きな発見でもあった。

Now, I know what some of you are thinking.

さて、皆さんの中には何を考えている人もいるだろう。

Josh, why can't you just put this option directly in the header file or in the CPP file?

ジョシュ、なぜこのオプションをヘッダーファイルかCPPファイルに直接書けないんだ？

Why can't you just have some sort of option or some sort of bull that you put in here?

なぜ、ここに何らかのオプションや強気で入れることができないんだ？

And the reason is going back to that architectural question of, okay, these are what we would call global configurations, configurations of the project just as a whole, okay?

そして、その理由はアーキテクチャー的な質問に戻るのだが、これらはグローバル・コンフィギュレーションと呼ばれるもので、プロジェクト全体のコンフィギュレーションなのだ。

And that from an architectural standpoint, it would make more sense to have these options within the CMake file, which is kind of the front interface for the entry point for the developer of what they want this project to be, rather than having it hidden in an individual header file or CPP file, okay?

アーキテクチャー的な観点からは、これらのオプションを個々のヘッダーファイルやCPPファイルに隠すよりも、開発者がこのプロジェクトをどうしたいかというエントリーポイントのフロントインターフェースのようなものであるCMakeファイル内に持つ方が理にかなっていると思うのですが、いかがでしょうか？

So that's the reason that it's done that way and why developers choose to do it.

だから、そのようなやり方をしているのであり、開発者がそれを選択する理由なのだ。

So that, I hope, helps reveal some of the light or shed a little bit of light on why we use build systems like CMake and why we use these global configurations rather than putting them into the code themselves.

なぜCMakeのようなビルドシステムを使うのか、なぜコードそのものに設定を入れるのではなく、このようなグローバルな設定を使うのか、その理由の一端が明らかになったり、少しは光が差したりすることを願っている。

So I hope that was helpful for you.

というわけで、お役に立てたなら幸いです。

Okay, moving along, here we are in our header file, which is the audio plugin audio processor, and this is inheriting from a juice audio processor.

オーディオ・プラグイン・オーディオ・プロセッサのヘッダーファイルで、juiceオーディオ・プロセッサを継承しています。

Now, we have a few pure virtual functions that we've been implementing here, and we can tell that they're pure virtual functions because they have this override keyword, okay?

さて、ここで実装してきた純粋仮想関数がいくつかあるが、純粋仮想関数であることがわかるのは、このoverrideキーワードがあるからだ。

That's how you know that it's pure virtual function.

それが純粋な仮想機能であることを知る方法だ。

If we go over to the juice documentation, the way that you know that it's a virtual function is if the function has this equals zero after the function name, okay?

ジュースのドキュメントを見ると、その関数が仮想関数であることを知るには、関数名の後にイコール・ゼロがあればいい。

So that's how you know that this is a function that if you're inheriting from an audio processor class, you need to provide implementations of each one of those functions, okay?

だから、オーディオ・プロセッサー・クラスを継承する場合は、これらの関数の実装を提供する必要があるんだ。

I know that that's a general C++ thing, but I want to try to make this digestible for people who are just getting started, okay?

それはC++の一般的なことだとわかっているが、これから始めようとしている人たちのために消化しやすいようにしたいんだ。

So be sure to check out pure virtual functions if you're not familiar with that concept.

そのため、その概念に馴染みがない場合は、純粋仮想関数を必ずチェックしてほしい。

Okay, so what we're going to do is give you a whistle stop tour of what the juice audio processor is and what each function does.

さて、ではこれから、ジュース・オーディオ・プロセッサーがどんなもので、それぞれの機能がどんな働きをするのか、順を追って説明しましょう。

This is not going to be really comprehensive.

これは本当に包括的なものではない。

This is going to be very general, but hopefully this should give you some insight into some things that you may not have known about before.

非常に一般的な話になってしまうが、これまで知らなかったことを知るきっかけになれば幸いだ。

I know that I've learned a lot in creating this tutorial, so hopefully it's helpful for you.

このチュートリアルを作るにあたって、私は多くのことを学んだ。

Okay, so let's get started.

よし、では始めよう。

So the first thing that we have here is the constructor.

まずコンストラクターだ。

So this is what's called when the plugin is first created.

つまり、これはプラグインが最初に作成されたときに呼び出されるものだ。

And what happens is that it creates this juice audio processor.

そして何が起こるかというと、このジュース・オーディオ・プロセッサーができるのだ。

And then in here is this piece of code with some macros that look intimidating at first, but if you break it down, you can see that it's not very intimidating at all, okay?

そして、このコードにはいくつかのマクロがあり、最初は威圧的に見えるが、分解してみると、まったく威圧的でないことがわかるだろう？

So here we have these variables that we created with the CMakeLists.

CMakeListsで作成した変数がここにある。

Let me go back to CMakeLists here very quickly.

ここでCMakeListsの話に戻ろう。

So remember, we have these global configurations like needsMIDI input, needsMIDI output, and so on.

needsMIDIインプット、needsMIDIアウトプットといったグローバルなコンフィギュレーションがあることを思い出してほしい。

So that's all these are here, okay?

ここにあるのはこれだけだよ。

So it's just using those configurations to see if it's a MIDI effect or if it's a synth.

つまり、MIDIエフェクトかシンセかを確認するために、これらの設定を使用しているだけなんだ。

And depending on what these choices are, then it's going to create some inputs and outputs and give those to our audio processor to create our audio output and input, right?

そして、これらの選択肢に応じて、いくつかの入力と出力を作り、それらをオーディオ・プロセッサーに渡して、オーディオ出力と入力を作るんだ。

So if it's not a MIDI effect, right?

つまり、MIDIエフェクトでなければいいんだね？

So MIDI effect would take MIDI input and do something with it.

つまり、MIDIエフェクトはMIDI入力を受けて何かをする。

So if it's not a MIDI effect, and if it's not a synth, then it's saying that we want an audio input that would create stereo input, okay?

つまり、MIDIエフェクトでもなければ、シンセでもないのなら、ステレオ入力を作るオーディオ入力が欲しいということなんだ。

And that if we wanted a stereo output, that that's what would happen.

ステレオ出力が欲しければ、そうなるだろうと。

So if it's a MIDI effect, obviously you would want it to have a MIDI output.

MIDIエフェクトなら、当然MIDI出力が欲しいですよね。

But if it's not a MIDI effect, then you would want it to have an audio output.

しかし、MIDIエフェクトでないなら、オーディオ出力が欲しいだろう。

So that's what's happening there is just creating your inputs and outputs for your plugin.

そこで起こっているのは、プラグインの入力と出力の作成だ。

And then of course, here in this function, this constructor function, you would have any type of initialization code that you would need to start up other classes, to start up other things that need to be initialized with some variables.

そしてもちろん、この関数（コンストラクタ関数）には、他のクラスを立ち上げたり、変数を初期化する必要のある他のものを立ち上げたりするために必要な、あらゆる種類の初期化コードがある。

Next, we have our destructor.

次はデストラクタだ。

So this is typically what we would use that on destruction of this audio processor, which would typically be when somebody deletes your plugin, then this destructor would clear out any, you would use that to clear out any memory, any resources, any processes that need to be done before your plugin can be destroyed.

誰かがプラグインを削除したときが典型的な例だが、このデストラクタは、プラグインを破棄する前に必要なメモリやリソース、処理をすべて消去するために使う。

Things like that would typically happen here.

そういうことは普通、ここで起こることだ。

These next ones, get name, accepts MIDI, produces MIDI, is MIDI effect.

次のものは、名前を取得し、MIDIを受け入れ、MIDIを生成し、MIDIエフェクトです。

All of those are direct correlations to those global configurations that we created here in the CMake file.

これらはすべて、CMakeファイルで作成したグローバル・コンフィギュレーションに直接関係している。

Needs MIDI input, needs MIDI output, and is MIDI effect and so on.

MIDI入力が必要、MIDI出力が必要、MIDIエフェクトが必要、などなど。

Okay, so going down a little bit further, we have this get tail length seconds.

では、もう少し下に降りて、尾の長さを秒単位で測ってみよう。

So sometimes when you're using a plugin in a DAW, when you stop processing audio through the plugin, when you stop the DAW, then typically sometimes if it's like a reverb or it's the delay, maybe you want that delay or that reverb to continue ringing out until it's finished, until it reaches silence.

DAWでプラグインを使っているとき、プラグインを通したオーディオ処理を止めたとき、DAWを止めたとき、通常、リバーブやディレイのようなものであれば、ディレイやリバーブが終わるまで、あるいは無音になるまで鳴り続けさせたいことがあります。

Sometimes you want the audio to stop right away when your plugin is stopped.

プラグインを停止したときに、オーディオをすぐに停止させたいことがあります。

Okay, so if you want it to stop right away, then you would just leave that at 0.0 seconds.

すぐに停止させたいのであれば、0.0秒のままでいい。

That means that even if it's a delay plugin or a reverb plugin, that when you hit stop, that the delay or the reverb stops.

つまり、ディレイ・プラグインやリバーブ・プラグインであっても、stopを押すとディレイやリバーブが止まるということです。

If you want it to continue playing after audio is done processing through the effect, after you've stopped the DAW, then you would change this to a different number.

DAWを停止した後、オーディオがエフェクトで処理された後も再生を続けたい場合は、この数値を別の数値に変更します。

These next few functions like get num programs, get current program, set current program, get current program name, change program name, all of these are referring to presets.

次のいくつかの関数、例えば、ナンバー・プログラムの取得、カレント・プログラムの取得、カレント・プログラムの設定、カレント・プログラム名の取得、プログラム名の変更、これらはすべてプリセットを参照している。

So this is referring to a preset if it's loaded or if you want to get what the preset name is.

つまり、これはプリセットがロードされている場合、またはプリセット名を知りたい場合に参照する。

So typically your presets will be stored in some type of a vector with what you want each parameter to be set at, and that's how that would be stored.

だから通常、プリセットは、各パラメーターを設定したい値をある種のベクターに保存しておく。

And so all of these are just referring to loading them, getting them, changing the name of your plugin, of your preset rather, and so on.

これらはすべて、プラグインをロードしたり、取得したり、プラグインの名前を変更したり、プリセットの名前を変更したりすることを指している。

Going down a little bit further, we have this function called prepare to play.

もう少し下ると、プレーの準備という機能がある。

So this is one of the more important functions that you have here in the audio processor.

これはオーディオプロセッサーでより重要な機能のひとつです。

It's probably one of the top two or three most important functions.

最も重要な機能のトップ2、3には入るだろう。

So anytime that you're processing a, you're doing some type of digital signal processing, so let's say that you have a reverb or you have a delay and you've created an algorithm or you're sourcing an algorithm from somewhere, typically you'll have some type of function that's called either prepare or reset or prepare to play.

例えば、リバーブやディレイを使ってアルゴリズムを作成したり、どこかからアルゴリズムを調達したりする場合、通常、prepare（準備）、reset（リセット）、prepare to play（再生準備）と呼ばれる関数があります。