以下のスクリプトは新しい `Part` インスタンスを生成し、パーツのいくつかのプロパティを設定します。

特に、このスクリプトは `Class.Part.Shape` プロパティを
`Enum.PartType.Ball` に設定します。また、このパーツに _JurassicPart_ という名前を付け、固定し、_Workspace_ の子にし、色を白に設定します。

Partオブジェクトは`Class.BasePart`の一種です。5つの異なる
基本的な形状があります: ボール、ブロック、シリンダー、ウェッジ、コーナーウェッジ。

Part

Shapeプロパティは、オブジェクトの全体的な形状を事前に定義されたビルトイン形状のリストのいずれかに設定します。

`Enum.PartType`列挙型は、形状の値を制御し、5つの可能な形状があります:

| 形状/値   | 説明                                     |
| ----------- | --------------------------------------- |
| ボール      | 球状の形状です。                            |
| ブロック    | ブロック状の形状です。                      |
| シリンダー  | シリンダー状の形状です。                   |
| ウェッジ    | 片側に傾斜のあるウェッジ形状です。           |
| コーナーウェッジ | 両側に傾斜のあるウェッジ形状です。       |

`Class.MeshPart`や[ソリッドモデリング](/parts/solid-modeling)を使用して、完全にカスタムの部品形状を取得できます。

ボール、ブロック、ウェッジ、およびコーナーウェッジの間の衝突は正確ですが、地形、シリンダー、TriangleMeshes、および他の幾何学的タイプの間の衝突は近似値です。これは、ボール形状が車輪のための安定したコライダーを作成するのに便利であることを意味します。

Part.Shape

オブジェクトの全体的な形状を設定します。

`Class.BasePart`の一般的なタイプで、異なる基本的な形状が存在します。

FormFactorPartクラスは抽象クラスです。これは`Class.BasePart`クラスから継承され、継承したクラスに`Class.FormFactorPart.FormFactor`プロパティを追加します。

FormFactorPart

これは部品のサイズのグリッド制約を指定するものでした。現在は何の効果もありません。

FormFactorPart.FormFactor

部品がサイズ変更されたときの動作と、そのサイズが取れる値を決定します。

FormFactorPart.formFactor

FormFactorPartクラスは抽象クラスです。これはBasePartクラスから継承され、継承したクラスにFormFactorプロパティを追加します。

青いパーツと赤いターゲットパーツを作成します。青いパーツは滑らかに
赤いターゲットパーツに到達しようとします。ターゲットを移動させたり回転させたりして、その動作を確認してください。
smoothTimeを変更すると、異なる滑らかさの速度が得られます。


`Class.BasePart` は、`Class.Workspace` にいる間に描画され、物理的にシミュレーションされるワールド内オブジェクトの抽象ベースクラスです。`Class.BasePart` の実装は数多くあり、最も一般的なものは `Class.Part` と `Class.MeshPart` です。他には `Class.WedgePart`、`Class.SpawnLocation`、およびシングルトンの `Class.Terrain` オブジェクトが含まれます。一般的に、ドキュメントが「パート」について言及する場合、ほとんどの `Class.BasePart` 実装が機能し、必ずしも `Class.Part` のみを指すわけではありません。

`Class.BasePart|BaseParts` がシミュレーションされた剛体にどのようにグループ化されるかについての情報は、[Assemblies](/physics/assemblies) を参照してください。

`Class.BasePart`（`Class.Terrain` 以外）が相互作用するさまざまなオブジェクトには以下が含まれます。

- 複数の `Class.BasePart|BaseParts` が `Class.Model` 内にグループ化されて同時に移動する場合、`Class.PVInstance:PivotTo()` を使用します。詳細は [Models](/parts/models) を参照してください。
- `Class.Decal` は、`Class.BasePart` の面に伸びた画像テクスチャを適用し、`Class.Texture` は面にタイル状の画像テクスチャを適用します。詳細は [Textures and Decals](/parts/textures-decals) を参照してください。
- `Class.SurfaceGui` は、パートの面に `Class.GuiObject|GuiObjects` をレンダリングします。詳細は [In-Experience UI Containers](/ui/in-experience-containers) を参照してください。
- `Class.Attachment|Attachments` を `Class.BasePart` に追加して、パートに対する `Datatype.CFrame|CFrames` を指定できます。これらはしばしば、[Mechanical Constraints](/physics/mechanical-constraints) や [Mover Constraints](/physics/mover-constraints) に詳述されている物理的な `Class.Constraint` オブジェクトによって使用されます。
- `Class.ParticleEmitter` オブジェクトは、親にしている `Class.BasePart` の体積内で均等にパーティクルを放出します。詳細は [Particle Emitters](/effects/particle-emitters) を参照してください。
- `Class.PointLight` のような光オブジェクトは、`Class.BasePart` の中心から光を放出します。詳細は [Light Sources](/effects/light-sources) を参照してください。
- `Class.Tool` に親子付けされて、名前が **Handle** に設定された場合、`Class.BasePart` はキャラクターによって持つことができます。詳細は [In-Experience Tools](/players/tools) を参照してください。


別の部品が他のオブジェクトに接触したときに発火します。このイベントは、2つの部品が衝突したことを通知するためにクライアントにデータを送信するだけであり、`Class.BasePart.Touched`はサーバーにデータを送信します。


BasePart.LocalSimulationTouched

part

部品の外観が`Class.Shirt`クラスによって影響を受ける場合に発火します。


BasePart.OutfitChanged

BasePart.StoppedTouching

otherPart

このコードサンプルは、現在接触している部品の数を表示する
BillboardGuiを部品に作成します。


このコードサンプルでは、`Class.Model`内の複数の部品の`Class.BasePart.Touched`
イベントを1つの関数に接続する方法を示します。


**Touched**イベントは、部品が別の部品に接触したときに発火します。たとえば、**PartA**が**PartB**にぶつかると、`Class.BasePart.Touched|PartA.Touched`が**PartB**で発火し、`Class.BasePart.Touched|PartB.Touched`が**PartA**で発火します。

このイベントは物理運動の結果としてのみ発火し、部品の`Class.BasePart.CFrame|CFrame`プロパティが変更されて他の部品と重なった場合は発火しません。これにより、関係する部品のうち少なくとも1つが衝突時に`Class.BasePart.Anchored|Anchored`でない必要があります。

このイベントは、衝突グループが認識されるかどうかを指定するために、`Class.Workspace.TouchesUseCollisionGroups`と連携して動作します。


BasePart.Touched

指定された部品に接触した他の部品。


部品が物理運動の結果として別の部品に触れたときに発火します。


このイベントは、`Class.BasePart.Touched` の条件と同様の条件下で、部品が別の部品に接触しなくなったときに発生します。

このイベントは、`Class.Workspace.TouchesUseCollisionGroups` と連携して、[衝突グループ](/workspace/collisions#collision-filtering) が検出のために考慮されるかどうかを指定します。


BasePart.TouchEnded

物理的な動きの結果として、部品が別の部品に接触しなくなったときに発生します。


指定された角加速度を達成するために部品のアセンブリに適用すべきワールドスペーストルクベクトルを返します。この結果は、`Class.Torque`インスタンスまたは`Class.BasePart:ApplyAngularImpulse()`を介して適用すべきトルクを決定するために使用できます。

計算は、_I_がアセンブリのワールドスペース慣性テンソル、_α_が望ましい角加速度、_ω_が角速度のオイラー回転方程式を使用します。

_τ = I · α + ω × (I · ω)_

部品が`Class.Workspace`の子孫でない場合、このメソッドは無限ベクトルを返します。アセンブリが固定されている場合も同様に無限ベクトルを返します。

#### ジャイロ効果

回転するアセンブリに非対称慣性テンソルがある場合、指定された角加速度を達成するために必要なトルクは、ボディの向きの変化により増加します。オプションの`angVelocity`パラメータは、これらのジャイロ効果を考慮します。省略されると（デフォルトはゼロ）、この寄与は計算から除外されます。

```lua
local part = workspace.Part
local angularVelocity = part.AssemblyAngularVelocity
local desiredAcceleration = Vector3.new(0, 10, 0)

-- 必要なトルクを計算します
local torque = part:AngularAccelerationToTorque(desiredAcceleration, angularVelocity)
```


BasePart:AngularAccelerationToTorque

angAcceleration

ワールドスペースでの希望する角加速度ベクトル。


angVelocity

アセンブリの現在の角速度。デフォルトは`(0, 0, 0)`です。ジャイロ効果を考慮するためにアセンブリの角速度を提供します。


指定された角加速度を生成するために必要なワールドスペーストルクを表す`Datatype.Vector3`。


この部品のアセンブリで指定された角加速度を達成するために必要なトルクを返します。必要に応じてジャイロ効果を考慮します。


この部品のアセンブリに瞬時の角力インパルスを適用し、アセンブリが回転します。

インパルスによって生じる角速度は、アセンブリの`Class.BasePart.AssemblyMass|mass`に依存します。したがって、より重いアセンブリを動かすにはより高いインパルスが必要となります。インパルスは、爆発や衝突など、瞬時に力を適用したい場合に有効です。

部品が[所有](/physics/network-ownership)されている場合、この関数はサーバーの`Class.Script`から呼び出す必要があります（`Class.LocalScript`や`Class.Script`の`Class.BaseScript.RunContext|RunContext`が`Enum.RunContext.Client`に設定されている場合は呼び出さないでください）。部品がクライアントによる**自動的**な所有によって所有されている場合、この関数はクライアントスクリプト**または**サーバースクリプトから呼び出すことができます。サーバー所有の部品に対してクライアントスクリプトから呼び出すと、効果はありません。


BasePart:ApplyAngularImpulse

impulse

アセンブリに適用される角インパルスベクトル。


アセンブリに角インパルスを適用します。


この関数は、部品のアセンブリに瞬時の力インパルスを適用します。

力はアセンブリの`Class.BasePart.AssemblyCenterOfMass|重心`に適用されるため、結果的に移動は線形のみになります。

インパルスによって生じる速度は、アセンブリの`Class.BasePart.AssemblyMass|mass`に依存します。したがって、より重いアセンブリを移動させるにはより高いインパルスが必要です。インパルスは、爆発や衝突など、瞬時に力を適用したい場合に有効です。

部品が[所有](/physics/network-ownership)されている場合、この関数はサーバーの`Class.Script`から呼び出す必要があります（`Class.LocalScript`や`Class.Script`の`Class.BaseScript.RunContext|RunContext`が`Enum.RunContext.Client`に設定されている場合は呼び出さないでください）。部品がクライアントによる**自動的**な所有によって所有されている場合、この関数はクライアントスクリプト**または**サーバースクリプトから呼び出すことができます。サーバー所有の部品に対してクライアントスクリプトから呼び出すと、効果はありません。


BasePart:ApplyImpulse

アセンブリに適用される線形インパルスベクトル。


アセンブリの`Class.BasePart.AssemblyCenterOfMass|重心`でインパルスを適用します。


この関数は、部品のアセンブリに指定された位置で瞬時の力インパルスを適用します。

位置がアセンブリの`Class.BasePart.AssemblyCenterOfMass|重心`でない場合、インパルスは位置移動と回転移動を引き起こします。

インパルスによって生じる速度は、アセンブリの`Class.BasePart.AssemblyMass|mass`に依存します。したがって、より重いアセンブリを移動させるにはより高いインパルスが必要です。インパルスは、開発者が爆発や衝突など、瞬時に力を適用したい場合に有効です。

部品が[所有](/physics/network-ownership)されている場合、この関数はサーバーの`Class.Script`から呼び出す必要があります（`Class.LocalScript`や`Class.Script`の`Class.BaseScript.RunContext|RunContext`が`Enum.RunContext.Client`に設定されている場合は呼び出さないでください）。部品がクライアントによる**自動的**な所有によって所有されている場合、この関数はクライアントスクリプト**または**サーバースクリプトから呼び出すことができます。サーバー所有の部品に対してクライアントスクリプトから呼び出すと、効果はありません。


BasePart:ApplyImpulseAtPosition

アセンブリに適用されるインパルスベクトル。


position

インパルスを適用するワールドスペースにおける位置。


指定された位置でアセンブリにインパルスを適用します。


隣接する部品との任意の表面接続を切断します。`Class.Weld`や他の`Class.JointInstance`を含みます。


BasePart:BreakJoints

BasePart:breakJoints

部品同士が衝突できるかどうかを返します。この関数は、2つの部品の衝突グループを考慮します。指定された部品がBasePartでない場合、この関数はエラーを返します。


BasePart:CanCollideWith

衝突可否をチェックされる指定された部品。


部品同士が衝突できるかどうかを示します。


部品同士が衝突できるかどうかを返します。


この例では、`Workspace`内の最初の`BasePart`である_Part_のネットワーク所有権が設定可能かどうかをチェックします。


CanSetNetworkOwnership関数は、部品のネットワーク所有権を設定できるかどうかを確認します。

関数の返り値は`Class.BasePart:SetNetworkOwner()`や`Class.BasePart:SetNetworkOwnershipAuto()`をエラーなく呼び出すことができるかどうかを検証します。ネットワーク所有権を変更/読み取りできる場合はtrueを返し、できない理由を文字列として返します。


BasePart:CanSetNetworkOwnership

ネットワーク所有権を変更または読み取れるかどうかとその理由。


部品のネットワーク所有権を設定できるかどうかを確認します。


与えられたワールドスペースの位置に対する部品の表面の最も近い点を返します。指定された位置が部品の内部にある場合、そのまま返されます。

`Class.MeshPart`および`Class.PartOperation`インスタンスについて、このメソッドは部品の`Enum.CollisionFidelity`値を尊重します。返り値は、メッシュがボックス、ハル、またはより複雑な形状として扱われるかどうかによって異なる場合があります。


BasePart:GetClosestPointOnSurface

最も近い表面点を見つけるためのワールドスペースの点。


ワールドスペース内の部品の表面の最も近い点。


与えられた点への部品の表面の最も近い点を返します。


任意の剛性ジョイントによってオブジェクトに接続されている部品のテーブルを返します。

`recursive`がtrueの場合、この関数はBasePartに剛性に接続されたすべての部品を返します。

#### 剛性ジョイント

ジョイントが2つの部品を接続する時（`Part0 → Part1`）、ジョイントは**剛性**と見なされます。`Part1`の物理が`Part0`によって完全にロックされている場合のみです。これは以下のジョイントタイプにのみ適用されます：

- `Class.Weld`
- `Class.Snap`
- `Class.ManualWeld`
- `Class.Motor`
- `Class.Motor6D`
- `Class.WeldConstraint`


BasePart:GetConnectedParts

recursive

任意の`Class.JointInstance|ジョイント`によってオブジェクトに接続されている部品のテーブル。


任意の剛性ジョイントによってオブジェクトに接続されている部品のテーブルを返します。


この部品に接続されているすべてのジョイントまたは制約を返します。


BasePart:GetJoints

部品に接続されているすべてのジョイントまたは制約の配列。


この例では、ゲームのWorkspaceに新しいパーツ、myPartを作成し、
寸法は4x6x4スタッドです。このパーツはアンカーされています。

その後、myMassは新しいパーツの質量と等しく設定されます。パーツの質量は
print文の最後に出力されます:

> 私のパーツの質量は ...

**GetMass**は読み取り専用の`Class.BasePart.Mass|Mass`プロパティの値を返します。

この関数は質量プロパティの前に登場しました。互換性を維持するためにサポートされていますが、直接質量プロパティを使用するべきです。


BasePart:GetMass

`Class.BasePart.Mass|Mass`プロパティの値を返します。


BasePart:getMass

この部品のネットワーク所有者である現在のプレーヤーを返します。サーバーの場合は`nil`を返します。


BasePart:GetNetworkOwner

この部品のネットワーク所有者である現在のプレーヤー。サーバーの場合は`nil`。


ゲームエンジンがこの部品のネットワーク所有者を自動的に決定する場合はtrueを返します。


BasePart:GetNetworkOwnershipAuto

ゲームエンジンがこの部品のネットワーク所有者を自動的に決定するかどうか。


BasePart:GetNoCollisionConstraints

この関数は、Robloxの部品の遅延補償補間が内部的に行われていたときに関連していました。補間は現在、`Datatype.CFrame`に直接適用されます。


BasePart:GetRenderCFrame

廃止。部品が表示されている位置を説明するCFrameを返します。


アセンブリのベース部品を返します。部品の集合を`Datatype.CFrame`を使用して移動する場合は、このベース部品を移動することが重要です（これにより、接続されたすべての他の部品も適切に移動します）。詳細は[アセンブリ](/physics/assemblies)の記事を参照してください。

この関数は、`Class.BasePart.AssemblyRootPart|AssemblyRootPart`プロパティの前に存在しました。後方互換性があるためサポートされていますが、直接`Class.BasePart.AssemblyRootPart|AssemblyRootPart`を使用するべきです。


BasePart:GetRootPart

アセンブリのベース部品（接続された部品の集合）。


部品のアセンブリのベース部品を返します。


この部品と物理的に相互作用しているすべての部品のテーブルを返します。この部品自体がCanCollideをfalseに設定されている場合、この関数は空のテーブルを返します。ただし、部品がそのTouchedイベントに接続されている`Class.TouchTransmitter|TouchInterest`オブジェクトを持っている場合は空ではありません。隣接する部品は、衝突していない限りタッチと見なされません。この関数は、より多くの柔軟性を提供し、上記の特別な`Class.TouchTransmitter|TouchInterest`ルールを回避する`Class.WorldRoot:GetPartsInPart()`関数の前に登場しました。そのため、`Class.WorldRoot:GetPartsInPart()`を使用するべきです。


BasePart:GetTouchingParts

この部品と交差し、衝突できるすべての部品のテーブル。


この部品と交差するすべての`Class.BasePart.CanCollide`がtrueの部品のテーブルを返します。


この部品に対する指定された位置におけるアセンブリの線形速度を返します。アセンブリの他の部品の線形速度を識別するのに使用できます。アセンブリに角速度がない場合、線形速度はすべての位置に対して常に同じになります。


BasePart:GetVelocityAtPosition

この部品に対する指定された位置におけるアセンブリの線形速度を返します。


与えられた配列内の部品との交差した幾何学から新しい`Class.IntersectOperation`を作成します。`Class.Part|Parts`のみがサポートされており、`Class.Terrain`や`Class.MeshPart|MeshParts`はサポートされていません。`Class.Instance:Clone()|Clone()`に似て、返されたオブジェクトには設定された`Class.Instance.Parent|Parent`がありません。

呼び出し元の部品の以下のプロパティが結果の`Class.IntersectOperation`に適用されます：

- `Class.BasePart.Color|Color`、`Class.BasePart.Material|Material`、`Class.BasePart.MaterialVariant|MaterialVariant`、
  `Class.BasePart.Reflectance|Reflectance`、`Class.BasePart.Transparency|Transparency`
- `Class.BasePart.CanCollide|CanCollide`
- `Class.BasePart.Anchored|Anchored`、`Class.BasePart.Density|Density`、`Class.BasePart.Elasticity|Elasticity`、
  `Class.BasePart.ElasticityWeight|ElasticityWeight`、`Class.BasePart.Friction|Friction`、`Class.BasePart.FrictionWeight|FrictionWeight`

以下の画像比較において、`Class.BasePart:IntersectAsync()|IntersectAsync()`は紫のブロックを青のブロックのテーブルを使用して呼び出されます。その結果、得られた`Class.IntersectOperation`は、2つの部品の交差した幾何学の形状に解決されます。

<figure>
<img src="../../../assets/modeling/solid-modeling/Separate-Parts-To-Intersect.jpg"
width="720" alt="2つのブロックが重なっている" />
<figcaption>別々の部品</figcaption>
</figure>
<figure>
<img src="../../../assets/modeling/solid-modeling/Intersect-Result.jpg"
width="720" alt="部品が新しいソリッドモデルに交差した" />
<figcaption>結果</figcaption>
</figure>

#### 注意

- 元の部品は、成功した交差操作の後も無傷のままです。ほとんどの場合、元の部品をすべて`Class.Instance.Destroy|Destroy()`し、返された`Class.IntersectOperation`を呼び出した`Class.BasePart`と同じ場所に親付けするべきです。
- デフォルトでは、得られた交差の面の色は元の部品の`Class.BasePart.Color|Color`プロパティから借用されます。特定の色に全体の交差を変更するには、その`Class.PartOperation.UsePartColor|UsePartColor`プロパティをtrueに設定します。
- 交差操作が20,000を超える三角形を持つ部品を生成する場合、それは20,000三角形に簡略化されます。


BasePart:IntersectAsync

parts

交差に参加するオブジェクト。


collisionfidelity

結果の`Class.IntersectOperation`の`Enum.CollisionFidelity`値。


renderFidelity

結果の`Class.PartOperation`の`Enum.RenderFidelity`値。


デフォルト名**Intersect**の結果の`Class.IntersectOperation`。


注意：この関数の代わりに新しい`Class.GeometryService:IntersectAsync`の使用を強くお勧めします。新しい関数は、パフォーマンスが向上し、より多くの機能を持っているだけでなく、以下のように異なります：

- 出力は単一のインスタンスではなくインスタンスの配列です。
- 入力部品はシーンに親付けされている必要はなく、バックグラウンド操作が可能です。
- `SplitApart`オプションがtrue（デフォルト）に設定されている場合、各異なるボディがそれぞれ`Class.PartOperation`として返されます。
- すべての返された部品はメイン部品の座標空間にあり、その`Class.PVInstance.Origin`の位置はメイン部品と同じです。このため、操作の前と同じ位置にメッシュの頂点が保持されますが、返された部品の`(0, 0, 0)`がそのボディの中心にあるとは限りません。

新しい`Class.IntersectOperation`を、部品と与えられた配列内の他の部品とのオーバーラップした幾何学から作成します。


オブジェクトが、その場所で保持する部品に接続されている場合（例：`Class.BasePart.Anchored|Anchored`部品）、trueを返し、そうでない場合はfalseを返します。部品が`Class.BasePart.Anchored|Anchored`なアセンブリ内では、他のすべての部品が固定されています。


BasePart:IsGrounded

オブジェクトが、その場所で保持する部品に接続されているかどうか。


オブジェクトが、その場所で保持する部品に接続されている場合（例：`Class.BasePart.Anchored|Anchored`部品）、trueを返し、そうでない場合はfalseを返します。


`Class.BasePart|Part`の任意の側に、ジョイントを作成することができる`Enum.SurfaceType`を持つ面がある場合、隣接する部品とジョイントを作成します。

ジョイントは側面および任意の平面に接触する表面の間に作成されます。

- スムースな面はジョイントを作成しません。
- グルー面は`Class.Glue`ジョイントを作成します。
- ウェルドは、Unjoinableを除くすべての表面と`Class.Weld`ジョイントを作成します。
- スタッド、インレット、またはユニバーサルは、それぞれ他の2つの表面のいずれかとの`Class.Snap`ジョイントを作成します（例：スタッドとインレットおよびユニバーサル）。
- ヒンジとモーター面は、`Class.Rotate`および`Class.RotateV`ジョイントインスタンスを作成します。

`Class.Model:MakeJoints()`とは異なり、この関数はパラメータとして部品の配列を要求します。この配列は次のように与えられます：

```
part:MakeJoints({part1, part2, part3})
```
十分な力が適用されると、ジョイントは破壊されます（例：`Class.Explosion`による）。`Class.ForceField`オブジェクトが`Class.BasePart`または祖先の`Class.Model`に親付けされていない限りです。このため、単純に破壊可能な建物や他のモデルを作成するためにしばしば使用されます。


BasePart:MakeJoints

ジョイントを作ることができるサーフェスIDを持つオブジェクトの任意の側にジョイントを作成します。


BasePart:makeJoints

オブジェクトのサイズを、Studioのリサイズツールを使用するのと同様に変更します。


BasePart:Resize

normalId

deltaAmount

指定された側でどれくらい成長/縮小させるか。


部品がリサイズされたかどうか。


BasePart:resize

指定されたプレイヤーをこの部品およびすべての接続部品のネットワーク所有者として設定します。`playerInstance`が`nil`の場合、サーバーがプレイヤーの代わりに所有者になります。


BasePart:SetNetworkOwner

playerInstance

部品のネットワーク所有権を与えられるプレイヤー。


指定されたプレイヤーをこの部品およびすべての接続部品のネットワーク所有者として設定します。


ゲームエンジンが、部品の物理を誰が処理するかを動的に決定します（クライアントの1つまたはサーバーのどちらか）。


BasePart:SetNetworkOwnershipAuto

この例は、別の `Class.BasePart` からパートを減算して、否定された `Class.UnionOperation` を形成する方法を示しています。

与えられた配列に含まれる部品によって占有されている幾何学から新しい`Class.UnionOperation`を作成します。`Class.Part|Parts`のみがサポートされており、`Class.Terrain`や`Class.MeshPart|MeshParts`はサポートされていません。`Class.Instance:Clone()|Clone()`に似て、返されたオブジェクトには設定された`Class.Instance.Parent|Parent`がありません。

引き算による結果が空になることは許可されていません。操作が完全に空の幾何学を生成する場合、失敗します。

以下の画像比較において、`Class.BasePart:SubtractAsync()|SubtractAsync()`は青いシリンダーを紫のブロックを含むテーブルに対して呼び出されます。結果の`Class.UnionOperation`はシリンダーの幾何学からブロックの幾何学を省略した形状に解決されます。

<figure>
<img src="../../../assets/modeling/solid-modeling/Separate-Parts-To-Subtract.jpg"
width="720" alt="シリンダーに重なる長いブロック" />
<figcaption>別々の部品</figcaption>
</figure>
<figure>
<img src="../../../assets/modeling/solid-modeling/Negate-Result.jpg" width="720"
alt="シリンダーからブロック部品が引かれた" />
<figcaption>結果</figcaption>
</figure>


BasePart:SubtractAsync

引き算に参加するオブジェクト。


結果の`Class.UnionOperation`の`Enum.CollisionFidelity`値。


結果の`Class.UnionOperation`デフォルト名**Union**。


注意：この関数の代わりに新しい`Class.GeometryService:UnionAsync`の使用を強くお勧めします。新しい関数は、パフォーマンスが向上し、より多くの機能を持っているだけでなく、以下のように異なります：

- 出力は単一のインスタンスではなくインスタンスの配列です。
- 入力部品はシーンに親付けされている必要はなく、バックグラウンド操作が可能です。
- `SplitApart`オプションがtrueに設定されている場合（デフォルト）、各異なるボディがそれぞれ`Class.PartOperation`として返されます。
- 返された部品はすべてメイン部品の座標空間にあり、その`Class.PVInstance.Origin`位置はメイン部品の位置と同じです。このため、操作の前と同様にメッシュの頂点が部品に対して保持されていることを意味しますが、返された部品の`(0, 0, 0)`がそのボディの中心であるとは限りません。

新しい`Class.UnionOperation`を、部品と、与えられた配列に含まれる部品によって占有されている幾何学から作成します。


部品のアセンブリに指定されたトルクを適用した場合に生じるワールドスペースでの角加速度を返します。ジャイロ効果を考慮することも可能です。

これは`Class.BasePart:AngularAccelerationToTorque()`の逆です。適用されたトルクに対するアセンブリの応答を予測するのに役立ちます。

計算には次の式を使用します：

**α = I⁻¹ · (τ − ω × (I · ω))**

ここで**I**はアセンブリのワールドスペース慣性テンソル、**τ**は適用されたトルク、**ω**は角速度です。

部品が`Class.Workspace`の子孫でない場合、`(0, 0, 0)`を返します。アセンブリが固定されている場合も同様に`(0, 0, 0)`を返します。

#### ジャイロ効果

回転するアセンブリに非対称の慣性テンソルがある場合、適用されたトルクから生じる加速度は、現在の角速度にも依存します。`angVelocity`パラメータは、これらのジャイロ効果を考慮します。省略されると（デフォルトはゼロ）、結果はこの寄与を無視します。

```lua
local part = workspace.Part
local angularVelocity = part.AssemblyAngularVelocity
local appliedTorque = Vector3.new(0, 100, 0)

-- このトルクから角加速度を予測します
local angAccel = part:TorqueToAngularAcceleration(appliedTorque, angularVelocity)
```


BasePart:TorqueToAngularAcceleration

torque

アセンブリに適用されるワールドスペースでのトルクベクトル。


結果の角加速度を表す`Datatype.Vector3`。


指定されたトルクをこの部品のアセンブリに適用した場合に生じる角加速度を返します。ジャイロ効果を考慮するオプションがあります。


この例では、1つの `Class.BasePart` のジオメトリを他のパートのジオメトリと組み合わせて、`Class.UnionOperation` を形成する方法を示します。

この部品と、与えられた配列に含まれる部品の占有する幾何学から新しい`Class.UnionOperation`を作成します。`Class.Part|Parts`のみがサポートされており、`Class.Terrain`や`Class.MeshPart|MeshParts`はサポートされていません。`Class.Instance:Clone()|Clone()`に似て、返されたオブジェクトには設定された`Class.Instance.Parent|Parent`がありません。

呼び出す部品のプロパティは、得られた`Class.UnionOperation`に適用されます：

- `Class.BasePart.Color|Color`、`Class.BasePart.Material|Material`、
  `Class.BasePart.MaterialVariant|MaterialVariant`、
  `Class.BasePart.Reflectance|Reflectance`、`Class.BasePart.Transparency|Transparency`
- `Class.BasePart.CanCollide|CanCollide`
- `Class.BasePart.Anchored|Anchored`、`Class.BasePart.Density|Density`、`Class.BasePart.Elasticity|Elasticity`、
  `Class.BasePart.ElasticityWeight|ElasticityWeight`、`Class.BasePart.Friction|Friction`、
  `Class.BasePart.FrictionWeight|FrictionWeight`

以下の画像比較において、`Class.BasePart:UnionAsync()|UnionAsync()`は青いブロックを紫のシリンダーを含むテーブルに対して呼び出されます。結果の`Class.UnionOperation`は、両方の部品の幾何学を結合した形状に解決されます。

<figure>
<img src="../../../assets/modeling/solid-modeling/Separate-Parts-To-Union.jpg"
width="720" alt="ブロック部品とシリンダー部品が重なっている" />
<figcaption>別々の部品</figcaption>
</figure>
<figure>
<img src="../../../assets/modeling/solid-modeling/Union-Result.jpg" width="720"
alt="パーツが一つのソリッドユニオンに結合される" />
<figcaption>結果</figcaption>
</figure>

#### 注意

- 成功したユニオン操作の後、元の部品は無傷のままです。ほとんどの場合、元の部品をすべて`Class.Instance.Destroy|Destroy()`し、返された`Class.UnionOperation`を呼び出した`Class.BasePart`と同じ位置に親付けするべきです。
- デフォルトでは、得られたユニオンは各部品の`Class.BasePart.Color|Color`プロパティを尊重します。全体のユニオンを特定の色に変更するには、その`Class.PartOperation.UsePartColor|UsePartColor`プロパティをtrueに設定します。
- ユニオン操作が20,000を超える三角形を持つ部品を生成する場合、それは20,000三角形に簡略化されます。


BasePart:UnionAsync

呼び出す部品とのユニオンに参加するオブジェクト。


得られた`Class.UnionOperation`の`Enum.CollisionFidelity`値。


得られた`Class.PartOperation`の`Enum.RenderFidelity`値。


デフォルト名**Union**の結果の`Class.UnionOperation`。


注意：この関数の代わりに新しい`Class.GeometryService:UnionAsync`の使用を強くお勧めします。新しい関数は、パフォーマンスが向上し、より多くの機能を持っているだけでなく、以下のように異なります：

- 出力は単一のインスタンスではなくインスタンスの配列です。
- 入力部品はシーンに親付けされている必要はなく、バックグラウンド操作が可能です。
- `SplitApart`オプションがtrueに設定されている場合（デフォルト）、各異なるボディがそれぞれ`Class.PartOperation`として返されます。
- 返された部品はすべてメイン部品の座標空間にあり、その`Class.PVInstance.Origin`位置はメイン部品の位置と同じです。このため、操作の前と同様にメッシュの頂点が部品に対して保持されていることを意味しますが、返された部品の`(0, 0, 0)`がそのボディの中心であるとは限りません。

新しい`Class.UnionOperation`を、この部品と与えられた配列に含まれる部品の占有する幾何学から作成します。


BasePart

このコードサンプルでは、パーツをクリックしてその固定プロパティを切り替えることができます。
切り替えられると、パーツの外観が更新されます（赤は固定、黄色は自由を意味します）。


`Anchored` プロパティは、パートが物理的に動かせないかどうかを決定します。有効にすると、パートは重力、他のパートとの衝突、他のパートとの重複、またはその他の物理関連の原因によって位置が変わることはありません。その結果、2つのアンカーされたパートはお互いに対して `Class.BasePart.Touched|Touched` イベントを発火させることはありません。

アンカーされたパートは、`Class.BasePart.CFrame|CFrame` または `Class.BasePart.Position|Position` を変更することで移動できます。また、`Class.BasePart.AssemblyLinearVelocity|AssemblyLinearVelocity` および `Class.BasePart.AssemblyAngularVelocity|AssemblyAngularVelocity` がゼロ以外の値を持つこともあります。

最後に、取り外されたパートが `Class.Weld` などのオブジェクトを介してアンカーされたパートと接続されている場合、取り外されたパートもアンカーされた状態になります。そのようなジョイントが壊れると、パートは再び物理的に影響を受ける可能性があります。詳細については [Assemblies](/physics/assemblies) を参照してください。

アンカーされたパートにネットワーク所有権を設定することはできません。パートのアンカー状態がサーバーで変更された場合、そのパートのネットワーク所有権は影響を受けます。


BasePart.Anchored

パートが物理的に動かせないかどうかを決定します。


このパートのアセンブリの角速度ベクトルです。これは、ラジアン毎秒での方向の変化速度です。

角速度はアセンブリのすべての点で同じです。

速度を直接設定すると非現実的な動きになる可能性があります。 `Class.Torque` または `Class.AngularVelocity` 制約を使用することが推奨されます。もし瞬時に速度を変えたい場合は、`Class.BasePart:ApplyAngularImpulse()|ApplyAngularImpulse()` を使用してください。

パートが [所有権](/physics/network-ownership) をサーバーが持つ場合、このプロパティはサーバー `Class.Script` から変更されなければなりません（`Class.LocalScript` や `Class.Script` の `Class.BaseScript.RunContext|RunContext` が `Enum.RunContext.Client` に設定されている場合からは変更できません）。クライアントが **自動的に** 所有する場合、このプロパティはクライアントスクリプト **または** サーバースクリプトのいずれからでも変更できます。サーバーが所有するパートに対してクライアントスクリプトから変更しても効果はありません。


BasePart.AssemblyAngularVelocity

パートのアセンブリの角速度。


すべてのパートの `Class.BasePart.Mass|Mass` と `Class.BasePart.Position|Position` によって計算される位置です。

アセンブリにアンカーされたパートがある場合、そのパートの質量中心はアセンブリの質量中心となり、アセンブリの質量は無限大となります。

質量中心を知ることは、アセンブリの安定性を維持するのに役立ちます。質量中心に力を加えた場合は角加速度を引き起こすことなく、直線的な加速度のみが発生します。質量中心が低いアセンブリは、重力の影響下で直立を保つのがより容易です。


BasePart.AssemblyCenterOfMass

パートのアセンブリの質量中心をワールド空間で示します。


このパートのアセンブリの線速度ベクトルです。これは、`Class.BasePart.AssemblyCenterOfMass|AssemblyCenterOfMass` の位置の変化速度をスタッド毎秒で表します。

アセンブリの質量中心以外の点での速度を知りたい場合は、`Class.BasePart:GetVelocityAtPosition()|GetVelocityAtPosition()` を使用してください。

速度を直接設定すると非現実的な動きになる可能性があります。 `Class.VectorForce` 制約を使用することが推奨されます。もし瞬時に速度を変えたい場合は、`Class.BasePart:ApplyImpulse()|ApplyImpulse()` を使用してください。

パートが [所有権](/physics/network-ownership) をサーバーが持つ場合、このプロパティはサーバー `Class.Script` から変更されなければなりません（`Class.LocalScript` や `Class.Script` の `Class.BaseScript.RunContext|RunContext` が `Enum.RunContext.Client` に設定されている場合からは変更できません）。クライアントが **自動的に** 所有する場合、このプロパティはクライアントスクリプト **または** サーバースクリプトのいずれからでも変更できます。サーバーが所有するパートに対してクライアントスクリプトから変更しても効果はありません。


BasePart.AssemblyLinearVelocity

パートのアセンブリの線速度。


このパートのアセンブリに含まれるすべての `Class.BasePart|BaseParts` の質量の合計です。`Class.BasePart.Massless|Massless` のパートは、アセンブリのルートパートでない限り、`AssemblyMass` には寄与しません。

アセンブリにアンカーされたパートがある場合、そのアセンブリの質量は無限大として考慮されます。質量の大きな違いを持つ取り外されたアセンブリ間の制約や他の物理的相互作用は、不安定性を引き起こす可能性があります。


BasePart.AssemblyMass

パートのアセンブリの総質量。


このプロパティは、アセンブリのルートパートを表すために自動的に選択された `Class.BasePart` を示します。パートが `Class.Workspace` に親子付けされていない場合、このプロパティは `nil` になります。

ルートパートは、アセンブリ内のパートの `Class.BasePart.RootPriority|RootPriority` を変更することで変更できます。

同じ `AssemblyRootPart` を共有するパートは、同じアセンブリに含まれます。

ルートパートについての詳細は [Assemblies](/physics/assemblies) を参照してください。


BasePart.AssemblyRootPart

アセンブリのルートパートへの参照。


`AudioCanCollide` は、パートが音声シミュレーションと物理的に相互作用するかどうかを決定します。これは、照明のための `Class.BasePart.CastShadow|CastShadow` と似ています。

無効にすると、オーディオはパートを通過し、遮蔽や反射が行われません。


BasePart.AudioCanCollide

パートが音声シミュレーションと物理的に相互作用するかどうかを決定します。


このコードサンプルは、表面プロパティをNormalId（上、前など）を使用して設定する方法を示しています。モーターの -SurfaceInput を NoInput、Constant、Sin に切り替え、各プロパティが -ParamA および -ParamB プロパティを使用してどのように動作するかを示します。

`BackParamA` プロパティは、パートの `Class.BasePart.BackSurface` が Motor または SteppingMotor に設定され、`Class.BasePart.BackSurfaceInput` が Sin に設定されている場合に関連します。これは、モーターの回転速度の **振幅** を決定します。


BasePart.BackParamA

パートの裏面の SurfaceType に対する最初のパラメーターを決定します。


`BackParamB` プロパティは、パートの `Class.BasePart.BackSurface` が Motor または SteppingMotor に設定され、`Class.BasePart.BackSurfaceInput` が Constant または Sin に設定されている場合に関連します。Constant の場合、モーターの一定の回転速度を決定します。Sin の場合、モーターの回転速度の **周波数** を決定します。


BasePart.BackParamB

パートの裏面の SurfaceType に対する2番目のパラメーターを決定します。


`BackSurface` プロパティは、パートの正の **Z** 方向に使用される表面のタイプを決定します。2つのパートの面が隣接して配置されると、それらの間にジョイントが生成される場合があります。


BasePart.BackSurface

パートの裏面の表面のタイプを決定します。


`BackSurfaceInput` プロパティは、パートの `Class.BasePart.BackSurface` に提供される入力のタイプを決定します。これは Motor または SteppingMotor SurfaceTypes にのみ関連します。このプロパティは、`Class.BasePart.BackParamA` と `Class.BasePart.BackParamB` がどのように使用されるかを決定します。簡潔にするため、これらのプロパティは、それぞれ ParamA と ParamB と呼ばれます。

- デフォルトでは、これは NoInput に設定されています。これにより、モーターが完全に停止します。
- Constant の場合、モーターは `ParamB` に等しい一定の速度で回転します。
- Sin の場合、モーターは `ParamA * math.sin(workspace.DistributedGameTime * ParamB)` に等しい速度で回転します。詳細は `Class.Workspace.DistributedGameTime` を参照してください。


BasePart.BackSurfaceInput

パートの裏面の入力タイプを決定します。


`BottomParamA` プロパティは、パートの `Class.BasePart.BottomSurface` が Motor または SteppingMotor に設定され、`Class.BasePart.BottomSurfaceInput` が Sin に設定されている場合に関連します。これは、モーターの回転速度の **振幅** を決定します。


BasePart.BottomParamA

パートの底面の SurfaceType に対する最初のパラメーターを決定します。


`BottomParamB` プロパティは、パートの `Class.BasePart.BottomSurface` が Motor または SteppingMotor に設定され、`Class.BasePart.BottomSurfaceInput` が Constant または Sin に設定されている場合に関連します。Constant の場合、モーターの一定の回転速度を決定します。Sin の場合、モーターの回転速度の **周波数** を決定します。


BasePart.BottomParamB

パートの底面の SurfaceType に対する2番目のパラメーターを決定します。


物理的に相互作用するワールド内オブジェクトの抽象ベースクラス。
