TriangleMeshPart是一個抽象中介類別，`Class.MeshPart`和`Class.PartOperation`繼承自此類別。它的創建是為了整合這兩個子類別之間物理幾何特性的管理。它實現了唯讀的
`Class.TriangleMeshPart.CollisionFidelity|CollisionFidelity`。


TriangleMeshPart

此屬性確定`Class.TriangleMeshPart`的碰撞模型如何與網格的實際幾何關聯。此屬性在運行時無法被腳本讀取或操作。

請參見[這裡](/workspace/collisions#collision-fidelity)以獲取各種選項的視覺表示。


TriangleMeshPart.CollisionFidelity

確定部件的物理將遵循其網格的細節級別。


確定用於計算空氣動力學力和扭矩的幾何表示。


TriangleMeshPart.FluidFidelity

TriangleMeshPart.MeshSize

抽象的中介類別，管理PartOperations和MeshParts的物理幾何特性。


創建一個藍色零件和紅色目標零件。藍色零件將會試著平滑地
達到紅色目標零件。移動和旋轉目標以查看其行為。
改變 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`。這些通常被物理的 `Class.Constraint` 對象使用，詳情請參見 [Mechanical Constraints](/physics/mechanical-constraints) 和 [Mover Constraints](/physics/mover-constraints)。
- `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)。


當另一個零件與另一個物體接觸時觸發。此事件僅向客戶端發送數據，通知它兩個零件已經碰撞，而 `Class.BasePart.Touched` 則向伺服器發送數據。


BasePart.LocalSimulationTouched

part

如果零件的外觀受到 `Class.Shirt` 類的影響，則會觸發。


BasePart.OutfitChanged

BasePart.StoppedTouching

otherPart

這段代碼範例在一個部件上創建了一個 BillboardGui，顯示目前觸碰它的部件數量。

此程式碼範例示範如何將多個 `Class.Model` 中的 `Class.BasePart.Touched`
event 連接至同一個函數。


**Touched** 事件在一個零件與另一個零件接觸時觸發。例如，如果 **PartA** 碰到 **PartB**，則 `Class.BasePart.Touched|PartA.Touched` 將觸發
帶有 **PartB** 的事件，而 `Class.BasePart.Touched|PartB.Touched` 將觸發帶有 **PartA** 的事件。

此事件僅因物理運動而觸發，因此如果 `Class.BasePart.CFrame|CFrame` 屬性發生變化，使得零件重疊了另一個零件，則不會觸發該事件。這也意味著，事件中的零件至少有一個必須在碰撞時 **不** 是 `Class.BasePart.Anchored|Anchored`。

此事件與 `Class.Workspace.TouchesUseCollisionGroups` 協同工作，以指定是否承認 [碰撞組](/workspace/collisions#collision-filtering)
進行檢測。


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|質量`。因此，需要更大的脈衝來移動更大質量的裝配。在您想要立即施加力量的情況下，例如爆炸或碰撞，脈衝非常有用。

如果該零件是由伺服器 [擁有](/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|質量`。因此，需要更大的脈衝來移動更大質量的裝配。在開發人員想要立即施加力量的情況下，例如爆炸或
碰撞，脈衝非常有用。

如果該零件是由伺服器 [擁有](/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

返回零件是否可以互相碰撞。此函數考慮了兩個零件的碰撞組別。如果指定的零件不是 BasePart，則該函數會產生錯誤。


BasePart:CanCollideWith

此範例檢查 `Workspace` 中名為 _Part_ 的第一個 `BasePart` 的網路擁有權是否可以設定。

CanSetNetworkOwnership 函數檢查您是否可以設置零件的網絡擁有權。

該函數的返回值驗證您是否可以調用
`Class.BasePart:SetNetworkOwner()` 或
`Class.BasePart:SetNetworkOwnershipAuto()` 而不會遇到錯誤。
如果您可以修改/讀取網絡擁有權，它將返回 true，否則返回 false 和您無法設置的原因，作為字符串。


BasePart:CanSetNetworkOwnership

您是否可以修改或讀取網絡擁有權及原因。


檢查您是否可以設置零件的網絡擁有權。


返回零件表面上最接近給定的世界空間
位置的點。如果提供的位置在零件內部，則按原樣返回。

對於 `Class.MeshPart` 和 `Class.PartOperation` 實例，該方法
尊重零件的 `Enum.CollisionFidelity` 值。返回值可能會根據是否將網格視為框、外殼或更複雜的形狀而有所不同。


BasePart:GetClosestPointOnSurface

要查找最接近的表面點的世界空間點。


世界空間中零件表面上最接近的點。


返回零件表面上最接近給定點的點。


返回與物體通過任何類型的剛性關節連接的零件表。

如果 `recursive` 為 true，這個函數將返回所有與 BasePart 嚴格連接的零件。

#### 剛性關節

當一個關節將兩個零件連接在一起時 `(Part0 → Part1)`，如果`Part0` 完全鎖定了 `Part1` 的物理則該關節是 **剛性**。這僅適用於以下關節類型：

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


BasePart:GetConnectedParts

recursive

通過任何類型的
`Class.JointInstance|關節` 連接到物體的零件表。


返回與物體通過任何類型的剛性關節連接的零件表。


返回所有連接到此零件的關節或約束。


BasePart:GetJoints

與零件連接的所有關節或約束的數組。


這個範例在遊戲的工作區創建一個新的零件 myPart，尺寸為 4x6x4 釘子。該零件也被固定住。

然後，myMass 被設定為新零件的質量。最後會在打印語句中輸出該零件的質量：

> 我的零件的質量是 ...

**GetMass** 返回只讀的 `Class.BasePart.Mass|質量`
屬性的值。

此函數在質量屬性之前就已存在。它保持支持以實現向後相容性；您應該直接使用質量屬性。


BasePart:GetMass

返回 `Class.BasePart.Mass|質量` 屬性的值。


BasePart:getMass

返回當前玩家，該玩家是此零件的網絡擁有者，如果是伺服器則返回 `nil`。


BasePart:GetNetworkOwner

當前玩家，該玩家是此零件的網絡擁有者，如果是伺服器則返回 `nil`。


如果遊戲引擎自動決定該零件的網絡擁有者，則返回 true。


BasePart:GetNetworkOwnershipAuto

遊戲引擎是否自動決定該零件的網絡擁有者。


BasePart:GetNoCollisionConstraints

當 Roblox 的延遲補償內插所有在線的零件時，此函數曾是有關鍵的。內插現在直接應用於 `Datatype.CFrame`。


BasePart:GetRenderCFrame

過時。返回描述零件渲染位置的 CFrame。


返回一組裝配的基底零件。在使用 `Datatype.CFrame` 移動一組零件時，
移動此基底零件非常重要（這會相應地移動其他所有連接的零件）。有關更多信息，請參見 [Assemblies](/physics/assemblies) 文章。

此函數在 `Class.BasePart.AssemblyRootPart|AssemblyRootPart` 屬性之前就已存在。它保持支持以實現向後相容性，但您應該直接使用
`Class.BasePart.AssemblyRootPart|AssemblyRootPart`。


BasePart:GetRootPart

一個裝配的基底零件（連接在一起的零件的集合）。


返回所有與此零件物理交互的零件表。如果該零件本身的 CanCollide 設置為 false，則此函數返回空表，除非該零件有一個
`Class.TouchTransmitter|TouchInterest` 對象作為其父級（這意味著有東西連接到其 Touched 事件）。相鄰但未相交的零件不被視為接觸。此函數在 `Class.WorldRoot:GetPartsInPart()` 函數之前就已存在，該函數提供了更多彈性，並避免上述特殊的 `Class.TouchTransmitter|TouchInterest` 規則。請改用 `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` 解析為兩個零件的交集幾何形狀。

<figure>
<img src="../../../assets/modeling/solid-modeling/Separate-Parts-To-Intersect.jpg"
width="720" alt="兩個塊部分重疊" />
<figcaption>分開的零件</figcaption>
</figure>
<figure>
<img src="../../../assets/modeling/solid-modeling/Intersect-Result.jpg"
width="720" alt="零件交集生成新的實體模型" />
<figcaption>結果 <code>Class.IntersectOperation</code></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` 值。


結果的 `Class.IntersectOperation`，默認名稱為 **Intersect**。


注意：強烈建議使用更新的 `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。


在任何具有 `Enum.SurfaceType` 可以生成關節的 `Class.BasePart|Part` 的一側創建一個關節，將與任何相鄰零件創建關節。

根據側面的表面，將在側面和任何平面接觸面之間創建關節。

- 光滑的表面不會創建關節
- 粘合表面將創建 `Class.Glue` 關節
- 焊接將在除了無法接合的地方創建 `Class.Weld` 關節
- Studs、Inlet 或 Universal 之間將根據其他兩個表面創建 `Class.Snap` 關節（例如，在 Studs 與 Inlet 和 Universal 之間）
- 鉸鏈和馬達表面創建 `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

被賦予該粒子網絡所有權的玩家。


將給定的玩家設置為該部分和所有連接零件的網絡擁有者。


讓遊戲引擎動態決定誰將處理該零件的物理（客戶端之一或伺服器）。


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.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>結果 <code>Class.UnionOperation</code></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

施加於裝配的世界空間扭矩向量。


目前裝配的世界空間角速度。默認為 `(0, 0, 0)`。請提供裝配的角速度以考慮陀螺效應。


一個 `Datatype.Vector3`，代表結果世界空間中的角加速度。


返回應用給定扭矩到該零件組合時所產生的角加速度，選擇性地考慮陀螺效應。


此範例展示了如何將一個 `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>結果 <code>Class.UnionOperation</code></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.GeometryService:UnionAsync` 而不是此函數。以及更好的性能和更多功能，新函數的不同之處在於：

- 輸出為實例的數組，而不是單個實例。
- 輸入零件不需要舊泛型在場景中，允許後台操作。
- 當 `SplitApart` 選項設置為 `true`（默認）時，每個不同的
  體將在自己的 `Class.PartOperation` 中返回。
- 所有返回的零件都在主要零件的坐標空間中，因此它們的 `Class.PVInstance.Origin` 位置與主要零件的相同。這保持了網格的頂點在操作之前的相對於對象的位置，但這也意味著
  返回零件的 `(0, 0, 0)` 不一定位於其主體的中心。

        從部分創建新的 `Class.UnionOperation`，加上給定數組中的所在幾何體。


BasePart

這段代碼範例將允許用戶點擊一個零件來切換其固定屬性。當切換時，該零件的視覺外觀會被更新（紅色表示固定，黃色表示自由）。


該 `Anchored` 屬性確定部分是否將無法被物理影響。啟用後，部分不會因重力、其他部分碰撞、重疊其他部分或任何其他物理原因而改變位置。因此，兩個固定的部分永遠不會相互觸發 `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` 在每秒中的位置變化率，以 studs 為單位。

如果你想知道在組件的質心以外的其他點的速度, 則使用 `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

確定部分是否會與音頻模擬進行物理互動，類似於 `Class.BasePart.CastShadow|CastShadow` 用於照明。


此程式碼範例演示如何僅使用 NormalId (上方、前方等) 設定表面屬性。它切換馬達的 -SurfaceInput 從 NoInput、Constant 和 Sin，以展示每種使用 -ParamA 和 -ParamB 屬性的效果。

當一個部分的 `Class.BasePart.BackSurface` 設置為 Motor 或 SteppingMotor 而 `Class.BasePart.BackSurfaceInput` 設置為 Sin 時，`BackParamA` 屬性相關。它確定馬達的旋轉速度的 **幅度**。


BasePart.BackParamA

確定在部件的後面表面上的 SurfaceType 的第一個參數。


當一個部分的 `Class.BasePart.BackSurface` 設置為 Motor 或 SteppingMotor 而 `Class.BasePart.BackSurfaceInput` 設置為 Constant 或 Sin 時，`BackParamB` 屬性相關。對於 Constant，它確定馬達的恆定旋轉速度。對於 Sin，它確定馬達旋轉速度的 **頻率**。


BasePart.BackParamB

確定在部件的後面表面上的 SurfaceType 的第二個參數。


`BackSurface` 屬性確定用於部件正 **Z** 方向的表面類型。當兩個部件的面放置在一起時，它們可能會在之間創建一個接頭。


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

確定部件後面表面的輸入類型。


當一個部分的 `Class.BasePart.BottomSurface` 設置為 Motor 或 SteppingMotor 而 `Class.BasePart.BottomSurfaceInput` 設置為 Sin 時，`BottomParamA` 屬性相關。它確定馬達的旋轉速度的 **幅度**。


BasePart.BottomParamA

確定部件底部表面的 SurfaceType 的第一個參數。


當一個部分的 `Class.BasePart.BottomSurface` 設置為 Motor 或 SteppingMotor 而 `Class.BasePart.BottomSurfaceInput` 設置為 Constant 或 Sin 時，`BottomParamB` 屬性相關。對於 Constant，它確定馬達的恆定旋轉速度。對於 Sin，它確定馬達旋轉速度的 **頻率**。


BasePart.BottomParamB

確定部件底部表面的 SurfaceType 的第二個參數。


`BottomSurface` 屬性確定用於部件負 **Y** 方向的表面類型。當兩個部件的面放置在一起時，它們可能會在之間創建一個接頭。


BasePart.BottomSurface

`BottomSurfaceInput` 屬性確定提供給部分的 `Class.BasePart.BottomSurface` 的輸入類型。這僅與 Motor 或 SteppingMotor SurfaceTypes 相關。此屬性確定如何使用 `Class.BasePart.BottomParamA` 和 `Class.BasePart.BottomParamB`。為簡潔起見，這些屬性將分別稱為 ParamA 和 ParamB。

- 默認情況下，這設置為 NoInput。這會完全停止馬達。
- 對於 Constant，馬達以與 `ParamB` 相等的恆定速度旋轉。
- 對於 Sin，馬達以 `ParamA * math.sin(workspace.DistributedGameTime * ParamB)` 的速度旋轉。請參見 `Class.Workspace.DistributedGameTime`。


BasePart.BottomSurfaceInput

確定部件底部表面的輸入類型。


此屬性確定部分的顏色。如果部分具有 `Class.BasePart.Material|Material`，這還確定在渲染材質紋理時使用的顏色。要對顏色進行更多控制，可以使用 `Class.BasePart.Color|Color` 屬性，並且該屬性將使用最接近的 `BrickColor`。

部分的其他可視屬性由 `Class.BasePart.Transparency|Transparency` 和 `Class.BasePart.Reflectance|Reflectance` 確定。


BasePart.BrickColor

BasePart.brickColor

這段程式碼範例展示了如何在接觸到 humanoid 時使部件淡化，然後在短暫的時間後重新出現，以創造一扇可通行的門。

`CanCollide` 確定部件是否將與其他部件物理互動。禁用時，其他部件可以不受阻礙地穿過該部分。用於 **裝飾** 的部件通常將 `CanCollide` 禁用，因為它們不需要被物理引擎考慮。

如果一個部分不是 `Class.BasePart.Anchored|Anchored`，且 `CanCollide` 禁用，則可能會掉出世界並最終被 `Class.Workspace.FallenPartsDestroyHeight` 銷毀。

當 `CanCollide` 禁用時，部分仍然可以觸發 `Class.BasePart.Touched|Touched` 事件（以及其他觸碰到它的部分）。您可以使用 `Class.BasePart.CanTouch|CanTouch` 禁用這一功能。

有關碰撞的更多信息，請參見 [Collisions](/workspace/collisions)。


BasePart.CanCollide

確定部分是否可以與其他部分碰撞。


此屬性確定該部分是否在空間查詢操作中考慮，例如 `Class.WorldRoot:GetPartBoundsInBox()|GetPartBoundsInBox` 或 `Class.WorldRoot:Raycast()|Raycast`。注意 `Class.BasePart.CanCollide|CanCollide` 必須被禁用才能使 `CanQuery` 生效，而且空間查詢功能永遠不會包含 `CanQuery` 為 `false` 的部分。

除了此屬性，還可以使用 `Datatype.OverlapParams` 或 `Datatype.RaycastParams` 對象來排除給定部件列表的後代，當調用空間查詢功能時。

BasePart.CanQuery

確定是否在空間查詢操作中考慮該部分。


此屬性確定是否在部分上觸發 `Class.BasePart.Touched|Touched` 和 `Class.BasePart.TouchEnded|TouchEnded` 事件。如果 `true`，則其他觸摸部分也必須將 `CanTouch` 設置為 `true`，才能發生觸碰事件。如果 `false`，則無法為該部分設置觸碰事件，嘗試這樣做會拋出錯誤。類似地，如果在連接觸碰事件後將屬性設置為 `false`，則該事件將被斷開，並且 `Class.TouchTransmitter` 將被移除。

請注意，此碰撞邏輯可以設置為尊重 [碰撞組](/workspace/collisions#collision-filtering)，通過 `Class.Workspace.TouchesUseCollisionGroups` 屬性。如果為 `true`，則在非碰撞組中的部分將同時忽略碰撞 **和** 觸摸事件，因此使此屬性無關緊要。

#### 性能

對於同時將 `CanTouch` 和 `Class.BasePart.CanCollide|CanCollide` 設置為 `false` 的部分，性能稍有提升，因為這些部分將永遠不需要計算任何部分之間的碰撞。然而，它們仍然可能被 `Class.WorldRoot:Raycast()|Raycasts` 和 `Datatype.OverlapParams` 查詢命中。


BasePart.CanTouch

確定是否在部分上觸發 `Class.BasePart.Touched|Touched` 和 `Class.BasePart.TouchEnded|TouchEnded` 事件。


確定部分是否投射陰影。在給定部分上禁用此屬性可能會導致投射到該部分上的陰影出現視覺瑕疵。

該屬性不是為了提高性能設計，但在複雜場景中，戰略性地禁用某些部件上的該屬性可以提高性能。由於可能出現視覺瑕疵，通常建議在大多數情況下在所有部分上保留其啟用狀態。


BasePart.CastShadow

`CenterOfMass` 屬性描述部分質心的 **本地** 位置。如果這是一個單個部分組件，則這是從世界空間轉換的 `Class.BasePart.AssemblyCenterOfMass|AssemblyCenterOfMass`。在簡單的 `Class.Part|Parts` 中，質心始終為 `(0, 0, 0)`，但對於 `Class.WedgePart` 或 `Class.MeshPart` 則可能會有所不同。


BasePart.CenterOfMass

描述部分質心所在的世界位置。


在世界中物理互動的抽象基類。


/reference/engine/classes/TriangleMeshPart.yaml