`Class.MeshPart` 是一种包含物理模拟自定义网格的 `Class.BasePart`。
与其他网格类（如 `Class.SpecialMesh` 和 `Class.BlockMesh`）不同，它们并不是以 `Class.BasePart` 为父对象，而是独立作为 `Class.BasePart` 进行行为处理。

`Class.MeshPart` 的网格和纹理由 `Class.MeshPart.MeshId|MeshId` 和 `Class.MeshPart.TextureID|TextureID` 属性决定。有关更多信息，请参见 [Meshes](/parts/meshes)。

从给定源 `meshPart` 覆盖此 `Class.MeshPart` 的 `Class.MeshPart.MeshContent|MeshContent`、`Class.MeshPart.TextureContent|TextureContent` 和碰撞几何体属性。

这些属性中的大多数是只读的，无法在运行时直接更改。为了保持 `Class.MeshPart.MeshContent|MeshContent` 和物理数据同步，必须一起更新。

复制以下属性：

- `Class.MeshPart.MeshContent`（隐式更新 `Class.MeshPart.MeshId|MeshId`）
- `Class.MeshPart.TextureContent`（隐式更新 `Class.MeshPart.TextureID|TextureID`）
- `Class.MeshPart.RenderFidelity`
- `Class.MeshPart.CollisionFidelity`（带有任何内部碰撞几何体）
- `Class.MeshPart.FluidFidelity`（带有任何内部气动几何体）
- `Class.MeshPart.MeshSize`

MeshPart:ApplyMesh

meshPart

从给定源 `meshPart` 覆盖此 `Class.MeshPart` 的 `Class.MeshPart.MeshContent|MeshContent`、`Class.MeshPart.TextureContent|TextureContent` 和碰撞几何体属性。

MeshPart

该属性确定是否渲染网格中多边形的两个面。仅在Studio中可更改。对于通常建模为"卡片"的网格（例如叶子、头发或布料），这是很有用的。

MeshPart.DoubleSided

确定是否渲染网格中多边形的两个面。

MeshPart.HasJointOffset

MeshPart.HasSkinnedMesh

MeshPart.JointOffset

在`Class.MeshPart`上显示的网格。支持
[资产URI](/projects/assets#asset-uris)和
`Class.EditableMesh`对象。

请注意，脚本不能直接更改此属性，因为网格的
碰撞几何体不能实时重新计算。请参阅
`Class.AssetService:CreateMeshPartAsync()`作为从给定的
`Datatype.Content`与指定的
`Class.MeshPart.CollisionFidelity|CollisionFidelity`创建新的
`Class.MeshPart`的方法。
`Class.MeshPart:ApplyMesh()`可用于覆盖
`Class.MeshPart.MeshContent|MeshContent`、
`Class.MeshPart.TextureContent|TextureContent`和
现有`Class.MeshPart`的碰撞几何体。

MeshPart.MeshContent

显示在 `Class.MeshPart` 上的网格。支持
[asset URIs](/projects/assets#asset-uris) 和
`Class.EditableMesh` 对象。

在`Class.MeshPart`上显示的网格的[资产URI](/projects/assets#asset-uris)。读取和写入
`Class.MeshPart.MeshContent|MeshContent`。

请注意，脚本不能直接更改此属性，因为网格的
碰撞几何体不能实时重新计算。请参阅
`Class.AssetService:CreateMeshPartAsync()`作为从给定的
`Datatype.Content`与指定的
`Class.MeshPart.CollisionFidelity|CollisionFidelity`创建新的
`Class.MeshPart`的方法。
`Class.MeshPart:ApplyMesh()`可用于覆盖
`Class.MeshPart.MeshContent|MeshContent`、
`Class.MeshPart.TextureContent|TextureContent`和
现有`Class.MeshPart`的碰撞几何体。

MeshPart.MeshId

`Class.MeshPart` 上显示的网格的 [asset URIs](/projects/assets#asset-uris)。读取和写入 `Class.MeshPart.MeshContent|MeshContent`。

该属性确定 `Class.MeshPart` 将以何种细节级别显示。可以设置为 `Enum.RenderFidelity` 枚举的可能值。

默认值为 `Enum.RenderFidelity.Automatic|Automatic`，这意味着网格的细节基于其与摄像机的距离，如下表所示。

<table>
    <thead>
        <tr>
            <th>距离摄像机的距离</th>
            <th>渲染保真度</th>
            <th>示例</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>少于 250 个单位</td>
            <td>最高</td>
            <td><img src="../../../assets/modeling/meshes/Render-Fidelity-High.jpg" width="200" /></td>
        </tr>
        <tr>
            <td>250-500 个单位</td>
            <td>中等</td>
            <td><img src="../../../assets/modeling/meshes/Render-Fidelity-Medium.jpg" width="200" /></td>
        </tr>
        <tr>
            <td>500 个单位或更多</td>
            <td>最低</td>
            <td><img src="../../../assets/modeling/meshes/Render-Fidelity-Low.jpg" width="200" /></td>
        </tr>
    </tbody>
</table>

MeshPart.RenderFidelity

用于渲染 `Class.MeshPart` 的细节级别。

应用于 `Class.MeshPart` 的纹理。支持
[asset URIs](/projects/assets#asset-uris) 和
`Class.EditableImage` 对象。

当此属性设置为 `Datatype.Content.none` 时，不会向网格应用纹理。

```
local Workspace = game:GetService("Workspace")

local meshPart = Workspace.MeshPart
meshPart.TextureContent = Content.none  -- 无纹理
```
请注意，在运行时不能直接更改 `Class.MeshPart.MeshContent|MeshContent` 属性，但纹理可以。

##### 更改网格纹理

使用 `Class.MeshPart.TextureContent|TextureContent` 属性，可以在不重新上传网格的情况下更改网格的纹理。为此，可以将带有所需纹理的新图像上传到 Roblox。
原始纹理图像文件可以通过使用 Studio 中的 **导出选择** 选项导出网格来获得。图像文件将与导出的 `.obj` 文件一起保存。

新纹理可以作为贴花上传到 Roblox，并且其 [asset URI](/projects/assets#asset-uris) 可以通过 `Class.MeshPart.TextureContent|TextureContent` 或 `Class.MeshPart.TextureID|TextureID` 属性应用于网格。

`Class.MeshPart.TextureContent|TextureContent` 还可以设置为引用尚未发布的 `Class.EditableImage`。

```
local AssetService = game:GetService("AssetService")
local Workspace = game:GetService("Workspace")

local meshPart = Workspace.MeshPart

local editableImage = AssetService:CreateEditableImageAsync(meshPart.TextureContent)
meshPart.TextureContent = Content.fromObject(editableImage)  -- 实时更新
```
当 `Class.MeshPart.TextureContent|TextureContent` 引用 `Class.EditableImage` 时，纹理将随着对 `Class.EditableImage` 对象的任何编辑而实时更新。

##### 制作带纹理的网格

网格只能被纹理化，如果该网格已进行 UV 映射，指的是将纹理图投影到网格上的做法。这不能通过 Roblox Studio 完成，必须使用外部 3D 建模应用程序（如 [Blender](https://www.blender.org/)）进行。

MeshPart.TextureContent

应用于 `Class.MeshPart` 的纹理。支持
[asset URIs](/projects/assets#asset-uris) 和
`Class.EditableImage` 对象。

应用于 `Class.MeshPart` 的纹理。读取和写入 `Class.MeshPart.TextureContent|TextureContent`。

当此属性设置为一个空字符串时，将不会向网格应用纹理。

```
local Workspace = game:GetService("Workspace")

local meshPart = Workspace.MeshPart
meshPart.TextureID = ""  -- 无纹理
```
请注意，`Class.MeshPart.MeshId` 属性在运行时无法更改，但纹理可以。有关详情，请参见 `Class.MeshPart.TextureContent|TextureContent`。

MeshPart.TextureID

应用于 `Class.MeshPart` 的纹理。读取和写入 `Class.MeshPart.TextureContent|TextureContent`。

一种包含物理模拟自定义网格的 `Class.BasePart`。

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`
事件连接到一个函数。

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

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