Translate manual/particles/tutorials/custom-particles.md into ja_JP.

jp/manual/particles/tutorials/custom-particles.md

@@ -1,27 +1,65 @@
+# チュートリアル: カスタムパーティクル
+<!--
 # Tutorial: Custom particles
+-->
 
+<span class="label label-doc-level">中級</span>
+<span class="label label-doc-audience">アーティスト</span>
+<span class="label label-doc-audience">プログラマー</span>
+<!--
 <span class="label label-doc-level">Intermediate</span>
 <span class="label label-doc-audience">Artist</span>
 <span class="label label-doc-audience">Programmer</span>
+-->
 
+このチュートリアルでは、パーティクルシステムのカスタム拡張を作成し、コアエンジンにはない機能を実装する方法を紹介します。
+<!--
 This walkthrough shows how you can create custom extensions for the particle system, providing functionality not available in the core engine.
+-->
 
+パーティクルの編集に慣れていない方は、[パーティクルの作成](../create-particles.md)をご覧ください。
+<!--
 If you're not familiar with editing particles, see [Create particles](../create-particles.md).
+-->
 
+新しい **Sample: Particles** プロジェクトを作成することから始めます。
+<!--
 Start by creating a new **Sample: Particles** project.
+-->
 
 ![Particles sample project](media/select-particles-sample-project.png)
 
+このプロジェクトには、パーティクルのさまざまな使用法を示すさまざまなシーンが含まれています。**CustomParticles** シーンを開きます。
+<!--
 This project contains different scenes that demonstrate different ways to use particles. Open the **CustomParticles** scene.
+-->
 
+シーンには 3 つのパーティクル エンティティがあります。**ConeEmitter15**, **ConeEmitter30**, **ConeEmitter45** です。
+<!--
 There are three particle entities in the scene: **ConeEmitter15**, **ConeEmitter30**, and **ConeEmitter45**.
+-->
 
+パーティクル エンティティの 1 つを選択します。プロパティグリッドで **Source** に移動し、**Emitters**（エミッタ－）を展開します。
+<!--
 Select one of the particle entities. In the Property Grid, navigate to its source particle system and expand the emitter.
+-->
 
 ![media/particles-samples-custom-1.png](media/particles-samples-custom-1.png)
 
+このエミッターには、4 つのカスタム済み要素があります。
+<!--
 There are four custom elements in this emitter:
+-->
 
+* カスタムされた[スポナー](../spawners.md)は、Per-second 型のスポナーに似ていますが、ループするたびにパーティクルのバーストを放出します。
+
+* カスタムされた[イニシャライザー](../initializers.md)は、パーティクルの初期位置をコーン（円錐）形に並べ、それに応じた速度を設定します。
+
+* カスタムされた[アップデーター](../updaters.md)は、**RactangleXY** という名前の新しいパーティクルフィールドで動作し、シェイプビルダーがビルボードを構築する際に不均等なサイズを使用できるようになりました。
+
+* カスタムされた[シェイプビルダー](../shapes.md)は、ビルボードに似ていますが、2 つの追加機能があります。標準の正方形ではなく長方形を作成することができ、長方形の Y 軸を、カメラ空間ではなくワールド空間の Y 軸に合わせる（固定する）ことができます。
+
+<!--
 * The custom [spawner](../spawners.md) is similar to the spawn-per-second spawner, but also emits a burst of particles every time it loops.
 
 * The custom [initializer](../initializers.md) initially positions the particles in a cone shape and sets their velocity accordingly.
@@ -29,10 +67,17 @@ There are four custom elements in this emitter:
 * The custom [updater](../updaters.md) operates on a new particle field named **RactangleXY**, allowing the shape builder to use non-uniform sizes when building the billboards.
 
 * The custom [shape builder](../shapes.md) is similar to the billboard with two additions. It can create non-uniform rectangles, rather than the standard squares, and it can align (fix) the rectangle's Y axis to the world's Y axis rather than the camera space.
+-->
 
+## スポナー（Spawner）
+<!--
 ## Spawner
+-->
 
+1 秒ごとにパーティクルを放出し、**数秒ごとにバーストする**スポナーを作ります。個別のスポナーを 2 つ追加することもできますが、今回のサンプルではこれらを組み合わせてみます。
+<!--
 We'll create a spawner which emits particles per second **and** in bursts every few seconds. We could do this by adding two different spawners, but for this sample we'll combine them.
+-->
 
   ```cs
     [DataContract("CustomParticleSpawner")] // Used for serialization, a good practice is to have the data contract have the same name as the class
@@ -86,20 +131,43 @@ We'll create a spawner which emits particles per second **and** in bursts every
     }
 ```
 
+このクラスは、@'Stride.Particles.Spawners.ParticleSpawner' を継承し、`BurstCount`と`burstTimer`を追加して、パーティクルがバーストで放出される頻度と数をコントロールしています。
+<!--
 This class mimics the @'Stride.Particles.Spawners.ParticleSpawner', with the addition of a `BurstCount` and a `burstTimer` to control how often and how many particles are spawned in bursts.
+-->
 
+`SpawnNew` メソッドは毎フレーム呼び出され、経過時間に基づいて、エミッターのスポナーがいくつの新しいパーティクルを放出すべきかを計算します。
+<!--
 The `SpawnNew` method is called every frame to allow the spawner to calculate how many new particles should be emitted in the emitter based on the elapsed time.
+-->
 
+演習として、以下の変更を行ってみてください。
+<!--
 As an exercise, try implementing the following changes:
+-->
+
+- 1 秒ごとではなく、プロパティを作成して、ユーザーがバーストのタイミングをコントロールする。
+- spawn-per-second フィールドを削除し、純粋なバーストスポナーにする。
 
+<!--
 - Rather than one-second bursts, create a property and have the user control the timing.
 - Remove the spawn-per-second fields and make it a pure burst spawner.
+-->
 
+スポナーはパーティクルを放出するだけで、それらのフィールドの設定は行いません。これはイニシャライザーで行われます。
+<!--
 Our spawner only emits particles, but doesn't set any fields. This is done by the initializer.
+-->
 
+## イニシャライザー（Initializer）
+<!--
 ## Initializer
+-->
 
+パーティクルを円錐形に配置して、外側に向けて放出するようにしてみましょう。
+<!--
 We want to place the particles in a cone and shoot them outwards when they spawn.
+-->
 
   ```cs
     [DataContract("CustomParticleInitializer")]
@@ -129,11 +197,18 @@ We want to place the particles in a cone and shoot them outwards when they spawn
     }
 ```
 
+このイニシャライザーでは、シンプルに、円錐の角度と速度の強さを定義しています。円錐のスケーリングや回転は、（すべてのイニシャライザーとアップデーターに共通の）位置とオフセットの継承から得られ、すぐに使用することができます。詳細については、@'Stride.Particles.Initializers.ParticleInitializer' を参照してください。
+<!--
 Our initializer simply defines an angle for the cone and strength for the velocity. Any scaling and rotation of the cone come from the location inheritance and offset, which are common for all initializers and updaters and are ready to use. For more information, see the @'Stride.Particles.Initializers.ParticleInitializer'.
+-->
 
+イニシャライザーのコンストラクタは重要で、使用したいフィールドのリストを作成しています。イニシャライザーはパーティクルの位置（Position）と速度（Velocity）を設定するのでそれらをリストに追加し、さらに、ランダムに生成する必要があるので、これから使用するランダムシード（RandomSeed）もリストに追加しています。すべてのパーティクルは、生成時に `Life` と `RandomSeed` フィールドを持ちます。
+<!--
 The constructor for the initializer is important, as it sets the list of required fields we'll use. The initializer sets the particle's position and velocity, so we add those, and needs to generate some randomness, so we also add the random seed which we are going to use. All particles have `Life` and `RandomSeed` fields when they spawn.
+-->
 
   ```cs
+// このメソッドは、すべての新しいパーティクルに対して、エミッターに追加されたイニシャライザーを呼び出します。開始と終了のインデックスが与えられており、すべてのパーティクルを更新するのではなく、指定された範囲のパーティクルのみを使用しなければなりません。
 // This method is called for all new particles once the initializer is added to an emitter. Rather than updating all of them, we are given a starting and end indices and must only use particles in the defined range.
 public unsafe override void Initialize(ParticlePool pool, int startIdx, int endIdx, int maxCapacity)
 {
@@ -176,11 +251,21 @@ public unsafe override void Initialize(ParticlePool pool, int startIdx, int endI
 }
 ```
 
+## アップデーター（Updater）
+<!--
 ## Updater
+-->
 
+パーティクルの幅と高さを、パーティクルの寿命とシンプルな sin 関数に基づいて、フレームごとに変更するアップデータを作成してみましょう。
+<!--
 We want our updater to change a particle's width and height every frame based on a simple sine function over the particle's life.
+-->
 
+まず、まだ存在していない新しいパーティクルフィールドを作成しましょう。
+名前は `RactangleXY` とします。
+<!--
 Because there's no such field yet, start by creating a new particle field. Let's name it `RactangleXY`:
+-->
 
   ```cs
     public static class CustomParticleFields
@@ -189,9 +274,15 @@ Because there's no such field yet, start by creating a new particle field. Let's
     }
 ```
 
+フィールドの型は @'Stride.Core.Mathematics.Vector2' です。幅と高さという 2 つの値だけが必要だからです。パーティクルに自動的に追加されるフィールドはないので、たくさん宣言してもパーティクルの大きさは変わりません。フィールドは、後述のカスタムアップデーターのように、フィールドを必要とするモジュールをプラグインしたときにのみ追加されます。
+<!--
 The field has type @'Stride.Core.Mathematics.Vector2', since we only need two values for the width and the height. No fields are added automatically to the particles, so even if you have many declarations, the particle size won't change. Fields are only added when we plug a module which requires them, such as the custom updater below.
+-->
 
+APIリファレンスについては、@'Stride.Particles.Modules.ParticleUpdater' を参照してください。
+<!--
 For API reference, see @'Stride.Particles.Modules.ParticleUpdater'.
+-->
 
   ```cs
     [DataContract("CustomParticleUpdater")] // Used for serialization so that our custom object can be saved. A good practice is to have the data contract have the same name as the class name.
@@ -226,9 +317,12 @@ For API reference, see @'Stride.Particles.Modules.ParticleUpdater'.
     }
 ```
 
+それでは、`Update`メソッドを見てみましょう。サンプルコードは長いのですが、ここではシンプルにするためにトリミングしています。
+<!--
 Let's take a look at the `Update` method. The sample code is longer, but here we've trimmed it for the sake of simplicity.
+-->
 
-  ```cs
+```cs
 public override void Update(float dt, ParticlePool pool)
 {
     // Make sure the fields exist and avoid illegal memory access
@@ -250,29 +344,52 @@ public override void Update(float dt, ParticlePool pool)
 }
 ```
 
+このアップデーターは、すべてのパーティクルの RectangleXY フィールドを、単純な sin 関数 と cos 関数を使って、その寿命が尽きるまでアニメーションさせます。
+<!--
 The updater will animate all particles' RectangleXY fields with a simple sine and cosine functions over their life.
+-->
 
+次のステップでは、作成した値を表示する方法を紹介します。
+<!--
 In the next step we'll demonstrate how to display the created values.
+-->
 
+## シェイプビルダー（Shape builder）
+<!--
 ## Shape builder
+-->
 
+シェイプビルダー（shape builder）は、すべてのパーティクルフィールドを受け取り、実際にレンダリングする形状を作成するクラスです。ちょっと長いので、分解してみましょう。
+<!--
 The `shape builder` is the class which takes all particle fields and creates the actual shape we are going to render. It's a little long, so let's break it down.
+-->
 
   ```cs
 	public override int QuadsPerParticle { get; protected set; } = 1;
 ```
 
+エンジンは、1 クワッド（quad; 四角形） = 4 頂点 = 6 インデックスを使ってクワッドを描画します。必要な数だけクワッドを指定することができます。矩形の場合は 1 つだけです。
+<!--
 The engine draws quads using 1 quad = 4 vertices = 6 indices, but we can only specify the number of quads we need. For a rectangle we need only one.
+-->
+
+>[!Note]
+> このクアッドの数は重要です。頂点データを書き出すために割り当てとマッピングが行われる頂点バッファに対して、これより小さいバッファを割り当てると、不正なメモリアクセスや破壊が発生する可能性があります。
 
+<!--
 >[!Note]
 > The number of quads is important because the vertex buffer is allocated and mapped prior to writing out the vertex data. If we allocate smaller buffer it might result in illegal memory access and corruption.
+-->
 
   ```cs
 public unsafe override int BuildVertexBuffer(ParticleVertexBuilder vtxBuilder, Vector3 inverseViewX, Vector3 inverseViewY,
     ref Vector3 spaceTranslation, ref Quaternion spaceRotation, float spaceScale, ParticleSorter sorter)
 ```
 
+このメソッドは、シェイプビルダーがすべてのパーティクルを反復処理してシェイプを構築する必要があるときに呼び出されます。@'Stride.Particles.VertexLayouts.ParticleVertexBuilder' は、頂点ストリームのラッパーです。これを使ってパーティクルの頂点データを書き出します。
+<!--
 This method is called when it needs our shape builder to iterate over all particles and build the shape. The @'Stride.Particles.VertexLayouts.ParticleVertexBuilder' is the wrapper around our vertex stream. We'll use it to write out the vertex data for the particles.
+-->
 
 `inverseViewX` and `inverseViewY` are unit vectors in camera space passed down to the shape builder if we need to generate camera-facing shapes.
 
@@ -322,23 +439,53 @@ This method is called when it needs our shape builder to iterate over all partic
     }
 ```
 
+パーティクルの幅と高さは、均等なサイズである `Size` フィールドと、このチュートリアルの前半で作成した `RectangleXY` フィールドの両方に依存します。そこから、クワッドの 4 つの頂点の位置とテクスチャー座標を設定する必要があります。設定しなければならない頂点の数は、パーティクルごとに、要求されたクワッドの数の 4 倍です。
+<!--
 Our particles' width and height depend both on the uniform size field `Size` and the field we created earlier in this walkthrough, `RectangleXY`. From there, we need to set the positions and texture coordinates for the four corner vertices of our quad. The number of vertices we have to set is per particle four times the number of quads we requested.
+-->
 
+ゲームに必要であれば、より複雑なシェイプや属性をここに追加することができます。
+<!--
 You can add more complicated shapes or attributes here if your game requires them.
+-->
 
+## おわりに
+<!--
 ## Conclusion
+-->
 
+この 4 つのカスタムモジュールを使えば、パーティクルエンジンに多くの機能を追加したり、ニーズに合わせて動作を調整することができます。これらのモジュールはすべて Game Studio でシリアル化されて読み込まるので、一度作成すれば、コアモジュールとともに、Game Studio から直接使用することができます。
+<!--
 With these 4 custom modules you can add a lot of functionality to the particle engine and tailor behavior to your needs. Because they're all serialized and loaded in Game Studio, once you create them, you can use them directly from Game Studio, together with the core modules.
+-->
 
+モジュールを試してみたい場合は、新しい `.cs` ファイルを `CustomParticles.Game` プロジェクトに追加してみてください。既存のクラスをコピーすることもできますが、衝突を避けるために、クラス名とデータコントラクトを変更することを忘れないでください。
+<!--
 If you want to experiment with the modules, try adding a new `.cs` file to the `CustomParticles.Game` project. You can duplicate one of the existing classes, but don't forget to change the class name and the data contract to avoid collisions.
+-->
 
+その後、Game Studio でスクリプトを再読み込みすることができます。再読み込みを行えない場合は、プロジェクトを再起動してください。コードにコンパイルエラーがなければ、Spawners、Initializer、Updaters、Shape builders のリストに、新しいモジュールが表示されるでしょう。
+<!--
 You can then reload the scripts in Game Studio. If they don't load, relaunch your project. If there are no compilation errors in your code you should see the new modules in the spawners, initializers, updaters and shape builders lists.
+-->
 
+## 関連項目
+<!--
 ## See also
+-->
+
+* [チュートリアル: 軌跡の作成](create-a-trail.md)
+* [チュートリアル: パーティクル マテリアル](particle-materials.md)
+* [チュートリアル: 継承](inheritance.md)
+* [チュートリアル: レーザーとライティング](lasers-and-lightning.md)
+* [パーティクル](../index.md)
+* [パーティクルの作成](../create-particles.md)
 
+<!--
 * [Tutorial: Create a trail](create-a-trail.md)
 * [Tutorial: Particle materials](particle-materials.md)
 * [Tutorial: Inheritance](inheritance.md)
 * [Tutorial: Lasers and lightning](lasers-and-lightning.md)
 * [Particles](../index.md)
-* [Create particles](../create-particles.md)
+* [Create particles](../create-particles.md)
+-->

jp/manual/particles/tutorials/index.md

@@ -2,6 +2,6 @@
 
 * [継承](inheritance.md)
 * [レーザーと稲光](lasers-and-lightning.md)
-* [残影を作成する](create-a-trail.md)
+* [軌跡の作成](create-a-trail.md)
 * [カスタム パーティクル](custom-particles.md)
 * [パーティクル マテリアル](particle-materials.md)