以下脚本生成一个新的 `Part` 实例并设置几个部件的
属性。

最值得注意的是，脚本将 `Class.Part.Shape` 属性设置为
`Enum.PartType.Ball`。它还将部件命名为 _JurassicPart_，将其固定，设置为 _Workspace_ 的子级，并将颜色设置为白色。

Part 对象是一种 `Class.BasePart`。它有五种不同的
基本形状：球、方块、圆柱、楔形和角楔。


Part

Shape 属性将对象的整体形状设置为预先确定的内置形状列表中的一种。

`Enum.PartType` 枚举控制形状值，且有五种可能的形状：

| 形状/值      | 描述                                   |
| ------------ | -------------------------------------- |
| 球          | 一个球形。                             |
| 方块        | 一个方块形状。                         |
| 圆柱        | 一个圆柱形状。                        |
| 楔形        | 一侧带有斜面的楔形。                  |
| 角楔        | 两侧带有斜面的楔形。                  |

`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`。这些通常被物理 `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`
事件连接到一个函数。

当一个部件与另一个部件接触时，将触发 **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|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

返回部件是否可以相互碰撞。此函数考虑了两个部件的碰撞组。如果指定的部件不是 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 刚性连接的所有部件。

#### 刚性关节

当一个关节将两个部件连接在一起时，关节是**刚性**的，如果 `Part1` 的物理特性完全由 `Part0` 锁定。这仅适用于以下关节类型：

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

BasePart:GetConnectedParts

recursive

与该对象通过任何类型的 `Class.JointInstance|关节` 连接的部件表。

返回与该对象通过任何刚性关节连接的部件表。

返回所有与此部件连接的关节或约束。

BasePart:GetJoints

与部件连接的所有关节或约束的数组。

这个示例在游戏的 Workspace 中创建一个新的零件 myPart，尺寸为 4x6x4 studs。这个零件也被固定了。

然后，myMass 被设置为新零件的质量。零件的质量在打印语句的最后打印出来：

> 我零件的质量是 ...

**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` 移动一组部分时，移动此基部件很重要（这将相应地移动所有其他连接的部件）。有关更多信息，请参见 [Assemblies](/physics/assemblies) 文章。

此函数早于 `Class.BasePart.AssemblyRootPart|AssemblyRootPart` 属性。为了向后兼容，仍然支持它，但您应该直接使用 `Class.BasePart.AssemblyRootPart|AssemblyRootPart`。

BasePart:GetRootPart

一组的基部件（连接在一起的部件集合）。

返回所有与此部件物理交互的部件的表。如果部件本身的 CanCollide 设置为 false，则此函数返回空表，除非该部件有一个 `Class.TouchTransmitter|TouchInterest` 对象作为其父级（这意味着某物连接到其触摸事件）。相邻但不相交的部件不会被视为接触。此函数早于 `Class.WorldRoot:GetPartsInPart()` 函数，该函数提供了更大的灵活性，并避免了上述特定的 `Class.TouchTransmitter|TouchInterest` 规则。请改用 `Class.WorldRoot:GetPartsInPart()`。

BasePart:GetTouchingParts

与此部件相交并可以碰撞的所有部件的表。

返回所有与此部件相交的 `Class.BasePart.CanCollide` 为真部件的表。

返回与此部件相对的给定位置的组件的线速度。它可用于识别集中的线速度，除了根部件以外。如果组件没有角速度，则每个位置的线速度将始终相同。

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` Resolve 成为两个部分的交锋几何形状。

<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。

在任何 `Class.BasePart|Part` 的任何侧面创建一个可以制作关节的 `Enum.SurfaceType` 的关节，它会与任何相邻的部件创建一个关节。

关节将在侧面之间和任何平面接触表面之间创建，具体取决于侧面的表面。

- 光滑表面不会创建关节
- 粘合表面将创建一个 `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.BasePart:SubtractAsync()|SubtractAsync()` 在蓝色圆柱体上调用，使用包含紫色块的表。得到的 `Class.UnionOperation` Resolve 成为一个形状，省略了该块的几何形状，而保留圆柱体的几何形状。

<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` Resolve 成为两个部分结合的几何形状。

<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()`，如果你想要瞬时改变速度。

如果部件是 [owned](/physics/network-ownership) by the 服务器，此属性必须从服务器 `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()`，如果要瞬时改变速度。

如果部件是 [owned](/physics/network-ownership) by the 服务器，此属性必须从服务器 `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`](https://developer.roblox.com/api-reference/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

这个代码示例展示了一个部件在被类人角色触碰时如何消失，
然后在短暂的一瞬间后再次出现，以创造一个可通过的门。

`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` 被移除。

注意，该碰撞逻辑可以通过 `Class.Workspace.TouchesUseCollisionGroups` 属性 respect [collision groups](/workspace/collisions#collision-filtering)进行设置。如果为 `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

与物理交互的世界内部对象的抽象基类。