TriangleMeshPart는 `Class.MeshPart`와 `Class.PartOperation`이 상속하는 추상 중간 클래스입니다. 두 하위 클래스 간의 물리적 기하학 속성 관리를 통합하기 위해 생성되었습니다. 읽기 전용 `Class.TriangleMeshPart.CollisionFidelity|CollisionFidelity` 및 `Class.TriangleMeshPart.CollisionPrecision|CollisionPrecision`를 구현합니다.


TriangleMeshPart

이 속성은 `Class.TriangleMeshPart`의 충돌 모델이 메쉬의 실제 기하학과 어떻게 관련되는지를 결정합니다. 이 속성은 런타임 중 스크립트에 의해 읽거나 조작할 수 없습니다.

여기에서 다양한 옵션의 시각적 표현을 확인하세요.
[여기](/workspace/collisions#collision-fidelity)

TriangleMeshPart.CollisionFidelity

부품 물리학이 메쉬에 고수할 세부 사항 수준을 결정합니다.

이 속성은 `Class.TriangleMeshPart.CollisionFidelity`가 `Enum.CollisionFidelity.Tunable`로 설정될 때 부품의 충돌 기하학의 정밀도와 성능 간의 균형을 설명합니다. `0`의 값은 가장 간단한 충돌 메시로 최대 성능을 선호하고, `1`의 값은 시각적 메시와 밀접하게 일치하는 충돌 메시로 최대 정밀도를 선호합니다.


TriangleMeshPart.CollisionPrecision

`Enum.CollisionFidelity.Tunable` 충돌 기하학의 정밀도 또는 성능을 `0`에서 `1`까지 정량화합니다.


이 속성은 물리 엔진이 부품에 대한 공기역학적(유체) 힘과 토크를 계산할 때 사용하는 기하학적 표현을 제어합니다. 기본값은 `Enum.FluidFidelity.Automatic`이며, 이 경우 엔진이 대신 표현을 선택합니다.

- `Enum.FluidFidelity.Automatic` — 엔진이 표현을 선택합니다; 현재 부품의 충돌 기하학에 대해 유체 힘을 평가합니다.
- `Enum.FluidFidelity.UseCollisionGeometry` — 유체 힘이 부품의 충돌 기하학에 대해 평가되며, 충돌 감지에 사용되는 형태와 일치합니다.
- `Enum.FluidFidelity.UsePreciseGeometry` — 유체 힘이 부품의 정밀 메시 기하학에 대해 평가되어 더 높은 계산 비용으로 더 정확한 힘을 생성합니다.

이 속성은 플러그인 수준의 쓰기 보안이 있으므로 런타임 스크립트에 의해 할당되지 않고 스튜디오에서 구성됩니다.

이 설정은 유체 힘이 활성화된 동안에만 부품에 영향을 미치며, 이는 `Class.Workspace.FluidForces`에 의해 관리됩니다(기본값은 `Default`인 `Enum.FluidForces` 값; 이를 `Experimental`로 설정하면 공기역학적 힘 모델이 활성화됩니다). 유체 힘이 부품에 적용되지 않을 때 선택된 정밀도는 영향을 미치지 않습니다.


TriangleMeshPart.FluidFidelity

공기역학적 힘과 토크를 계산하는 데 사용되는 기하학적 표현을 결정합니다.


이 읽기 전용 속성은 부품의 메시 기하학이 로드될 때의 크기를 스터드 단위로 너비, 높이 및 깊이로 보고합니다. `Class.BasePart.Size`를 통해 부품의 크기를 조정해도 영향을 받지 않으므로, `Class.BasePart.Size`를 `MeshSize`로 나누면 메시의 시각적 및 물리적 기하학에 현재 적용된 스케일 팩터를 제공합니다.


TriangleMeshPart.MeshSize

`Class.BasePart.Size`를 통해 적용된 스케일링 이전의 부품의 원래 메시 기하학 크기입니다.


물리적 기하학 속성을 관리하는 추상 중간 클래스입니다.
PartOperations 및 MeshParts에 대해.

파란색 파트를 만들고 빨간색 목표 파트를 만듭니다. 파란색 파트는 빨간색 목표 파트에 부드럽게 도달하려고 합니다.
목표를 이동하고 회전시켜 행동을 확인하세요.
smoothTime을 변경하면 부드러움 속도가 달라집니다.

`Class.BasePart`는 `Class.Workspace` 내에서 렌더링되고 물리적으로 시뮬레이션되는 세계 내 객체를 위한 추상 기본 클래스입니다. `Class.BasePart`의 여러 구현이 있으며, 가장 일반적인 것은 `Class.Part`와 `Class.MeshPart`입니다. 다른 구현으로는 `Class.WedgePart`, `Class.SpawnLocation`, 그리고 단일 인스턴스인 `Class.Terrain` 객체가 있습니다. 일반적으로 문서에서 "part"를 언급할 때, 대부분의 `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`는 part의 면에 `Class.GuiObject|GuiObjects`를 렌더링합니다. [In-Experience UI Containers](/ui/in-experience-containers)를 참조하십시오.
- `Class.Attachment|Attachments`는 `Class.BasePart`에 추가되어 part에 대한 상대적인 `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)를 참조하십시오.

다른 부품이 다른 객체와 접촉할 때 발생합니다. 이 이벤트는 두 부품이 충돌했음을 클라이언트에 알리는 데이터만 전송하며, `Class.BasePart.Touched`는 서버에 데이터를 전송합니다.

BasePart.LocalSimulationTouched

part

이 부품과 접촉한 다른 부품입니다.

다른 부품이 이 부품과 접촉할 때 로컬 클라이언트에서 발생합니다.

부품의 외관이 `Class.Shirt` 클래스에 의해 영향을 받을 경우 발생합니다.

BasePart.OutfitChanged

`Class.Shirt`로 인해 부품의 외관이 변경될 때 발생합니다.

사용 중단되었습니다. 부품이 다른 부품과의 접촉을 중단할 때 로컬 클라이언트에서 발생하며, `Class.BasePart.TouchEnded`와 유사한 조건에서 발생합니다. 이 이벤트는 `Class.BasePart.TouchEnded`의 클라이언트 전용 대응물입니다: 두 부품이 분리되었다는 것을 로컬 클라이언트에만 알리며, `Class.BasePart.TouchEnded`는 서버에 데이터도 전송합니다. 대신 `Class.BasePart.TouchEnded`를 사용하십시오.

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.Workspace.TouchesUseCollisionGroups`와 함께 작동하여 [충돌 그룹](/workspace/collisions#collision-filtering)이 감지에 인정되는지를 지정합니다.

BasePart.Touched

주어진 부품과 접촉한 다른 부품입니다.

부품이 물리적 이동의 결과로 다른 부품에 닿을 때 발생합니다.

부품이 `Class.BasePart.Touched`와 유사한 조건에서 다른 부품과의 접촉을 중지할 때 발생합니다.

이 이벤트는 `Class.Workspace.TouchesUseCollisionGroups`와 함께 작동하여 [충돌 그룹](/workspace/collisions#collision-filtering)이 감지에 인정되는지를 지정합니다.

BasePart.TouchEnded

이 부품과의 접촉을 중단한 다른 부품입니다.

부품이 물리적 이동의 결과로 다른 부품과의 접촉을 중지할 때 발생합니다.

이 예제는 `Class.BasePart:AngularAccelerationToTorque()`를 보여줍니다.


지정된 각 가속도를 달성하기 위해 부품의 조립체에 적용해야 하는 세계 공간 토크 벡터를 반환합니다. 이 결과는 `Class.Torque` 인스턴스 또는 `Class.BasePart:ApplyAngularImpulse()`를 통해 적용해야 하는 토크를 결정하는 데 사용할 수 있습니다.

계산은 오일러의 회전 방정식을 사용하며, 여기서 _I_는 조립체의 세계 공간 관성 텐서, _α_는 원하는 각 가속도, _ω_는 각 속도입니다.

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

부품이 `Class.Workspace`의 자손이 아닌 경우, 이 메서드는 무한 벡터를 반환합니다. 조립체가 고정되어 있는 경우에도 무한 벡터를 반환합니다.

#### 자이로스코프 효과

회전하는 조립체가 비대칭 관성 텐서를 가질 때, 지정된 각 가속도를 달성하기 위해 필요한 토크는 몸체의 방향 변화로 인해 증가합니다. 선택적 `angVelocity` 매개변수는 이러한 자이로스코프 효과를 고려합니다. 생략할 경우, 이러한 자이로스코프 효과는 계산에서 제외됩니다.

BasePart:AngularAccelerationToTorque

angAcceleration

세계 공간에서 원하는 각 가속도 벡터입니다.

angVelocity

세계 공간에서 조립체의 현재 각 속도입니다. 기본값은 `(0, 0, 0)`입니다. 자이로스코프 효과를 고려하기 위해 조립체의 각 속도를 제공하십시오.

지정된 각 가속도를 생성하는 데 필요한 세계 공간 토크를 나타내는 `Datatype.Vector3`입니다.

주어진 각 가속도를 달성하기 위해 이 부품의 조립체에 필요한 토크를 반환합니다. 선택적으로 자이로스코프 효과를 고려합니다.

이 부품의 조립체에 즉각적인 각 힘 임펄스를 적용하여 조립체가 회전하게 합니다.

임펄스에서 발생하는 각 속도는 조립체의 `Class.BasePart.AssemblyMass|mass`에 의존합니다. 따라서 더 무거운 조립체를 이동시키기 위해서는 더 높은 임펄스가 필요합니다. 임펄스는 폭발이나 충돌과 같이 즉시 힘을 적용하고자 할 때 유용합니다.

부품이 [소유](/physics/network-ownership)된 경우, 이 함수는 서버 `Class.Script`에서 호출해야 합니다 (서버 소유 부품에 대해 클라이언트 스크립트 또는 `Class.LocalScript`에서 호출하면 효과가 없습니다).

BasePart:ApplyAngularImpulse

impulse

조립체에 적용할 각 임펄스 벡터입니다.

조립체에 각 임펄스를 적용합니다.

이 함수는 이 부품의 조립체에 즉각적인 힘 임펄스를 적용합니다.

힘은 조립체의 `Class.BasePart.AssemblyCenterOfMass|질량 중심`에서 적용되므로, 결과적인 이동은 선형적입니다.

임펄스에서 발생하는 속도는 조립체의 `Class.BasePart.AssemblyMass|mass`에 의존합니다. 따라서 더 무거운 조립체를 이동시키기 위해서는 더 높은 임펄스가 필요합니다. 임펄스는 폭발이나 충돌과 같이 즉시 힘을 적용하고자 할 때 유용합니다.

부품이 [소유](/physics/network-ownership)된 경우, 이 함수는 서버 `Class.Script`에서 호출해야 합니다 (서버 소유 부품에 대해 클라이언트 스크립트 또는 `Class.LocalScript`에서 호출하면 효과가 없습니다).

BasePart:ApplyImpulse

조립체에 적용할 선형 임펄스 벡터입니다.

조립체의 `Class.BasePart.AssemblyCenterOfMass|질량 중심`에서 임펄스를 적용합니다.

이 함수는 이 부품의 조립체에 즉각적인 힘 임펄스를 적용하며, 세계 공간의 지정된 위치에서 적용됩니다.

위치가 조립체의 `Class.BasePart.AssemblyCenterOfMass|질량 중심`에 있지 않으면, 임펄스는 위치적 및 회전적 이동을 초래합니다.

임펄스에서 발생하는 속도는 조립체의 `Class.BasePart.AssemblyMass|mass`에 의존합니다. 따라서 더 무거운 조립체를 이동시키기 위해서는 더 높은 임펄스가 필요합니다. 임펄스는 개발자가 폭발이나 충돌과 같이 즉시 힘을 적용하고자 할 때 유용합니다.

부품이 [소유](/physics/network-ownership)된 경우, 이 함수는 서버 `Class.Script`에서 호출해야 합니다 (서버 소유 부품에 대해 클라이언트 스크립트 또는 `Class.LocalScript`에서 호출하면 효과가 없습니다).

BasePart:ApplyImpulseAtPosition

조립체에 적용할 임펄스 벡터입니다.

position

임펄스를 적용할 세계 공간의 위치입니다.

지정된 위치에서 조립체에 임펄스를 적용합니다.

`callback`을 물리 엔진이 충돌을 감지하는 동안 이 부품에 대해 생성하는 접촉 데이터에 구독합니다. 시뮬레이션이 한 프레임을 진행한 후, `callback`은 해당 프레임 동안 이 부품이 관련된 모든 접촉 패치를 설명하는 요약 배열을 받습니다. 각 요약은 접촉이 발생한 위치, 접촉 방향, 그리고 그 시점에서 두 부품이 서로에 대해 얼마나 빠르게 움직였는지를 보고합니다.

이 메서드는 `Class.BasePart.Touched`와는 별개의 메커니즘입니다.

`callback`이 `nil`이거나 부품이 `Class.Workspace`의 자손이 아닐 경우 오류를 발생시킵니다.

#### 요약 필드

`callback`에 전달된 배열의 각 항목은 다음 키를 가진 테이블입니다:

<table size="small">
<thead>
  <tr>
    <th>키</th>
    <th>유형</th>
    <th>요약</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td><code>Time</code></td>
    <td><code>number</code></td>
    <td>이 요약을 생성한 물리 서브스텝의 시뮬레이션 시간(초).</td>
  </tr>
  <tr>
    <td><code>Part0</code></td>
    <td><code>Class.BasePart</code></td>
    <td>구독된 부품.</td>
  </tr>
  <tr>
    <td><code>Part1</code></td>
    <td><code>Class.BasePart</code></td>
    <td>쌍의 다른 부품, <code>Class.Terrain</code>일 수 있습니다.</td>
  </tr>
  <tr>
    <td><code>Point</code></td>
    <td><code>Datatype.Vector3</code></td>
    <td>패치의 점들을 평균한 세계 공간의 접촉 지점.</td>
  </tr>
  <tr>
    <td><code>Normal</code></td>
    <td><code>Datatype.Vector3</code></td>
    <td>구독된 부품에 대해 상대적으로 방향이 설정된 패치의 단위 접촉 법선.</td>
  </tr>
  <tr>
    <td><code>RelativeVelocity</code></td>
    <td><code>Datatype.Vector3</code></td>
    <td>접촉 지점에서 <code>Part1</code>의 <code>Part0</code>에 대한 속도.</td>
  </tr>
  <tr>
    <td><code>Area</code></td>
    <td><code>number</code></td>
    <td>접촉 패치의 추정 면적(제곱 스터드). 세 점 미만의 패치(예: 모서리 접촉)의 경우 <code>0</code>.</td>
  </tr>
</tbody>
</table>

`Normal`은 엔진이 첫 번째로 나열한 부품이 아닌 구독된 부품에 대해 상대적으로 방향이 설정되므로, 쌍의 두 부품이 모두 구독된 경우 각 구독은 자신을 `Part0`로 하고 법선이 일치하도록 뒤집힌 요약을 받습니다.

`RelativeVelocity`는 `Part1`의 `Part0`에 대한 속도이므로, `Normal`에 대한 투영의 크기는 두 부품이 정면으로 접근하거나 분리되는 속도를 나타내며, `Normal`에 대한 접선 성분은 미끄러짐 및 스치기 접촉을 설명합니다.

#### 보고 동작

- 접촉 기록은 `Class.Workspace`에 적어도 하나의 구독이 존재하는 동안에만 활성화되며, 그 비용은 구독된 부품의 수에 따라 증가하고 장면의 총 충돌 수에 따라 증가하지 않습니다.
- 여러 개의 수면 부품 간의 접촉은 요약을 생성하지 않습니다.
- `Class.BasePart.CanCollide`가 `false`로 설정된 부품의 접촉은 요약을 생성하지 않습니다.
- 물리는 프레임당 여러 서브스텝을 실행할 수 있으므로, 여러 서브스텝에 걸쳐 접촉을 유지하는 쌍은 각 패치당 최대 하나의 요약을 생성하며, 모두 같은 `callback` 호출에서 전달됩니다. `Time`을 사용하여 정렬합니다.
- 비볼록 충돌 기하학은 접촉하는 볼록 외피 쌍당 하나의 요약을 생성하며, `Class.Terrain`과의 접촉은 접촉 법선에 따라 더 나뉘므로, 둘 다 하나의 서브스텝 내에서 동일한 쌍에 대해 여러 요약을 생성할 수 있습니다.
- 아무것도 복제되지 않습니다. 각 클라이언트는 자신이 소유한 충돌에 대한 요약을 생성합니다. [네트워크 소유권](/physics/network-ownership)을 참조하십시오.
- 부품을 파괴하면 해당 구독이 끊어집니다.


BasePart:BindToCollisionSummaries

callback

부품이 충돌에 관련된 경우, 프레임당 최대 한 번 요약 테이블 배열로 호출됩니다.


`Datatype.RBXScriptConnection`으로, 연결이 끊어지면 구독이 종료됩니다.


이 부품이 관련된 충돌에 대한 프레임별 상세 접촉 데이터를 구독합니다.


인접한 부품과의 모든 표면 연결을 끊습니다. `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)`, 조인트는 **강체**일 때 `Part1`의 물리가 `Part0`에 의해 완전히 잠겨 있습니다. 이는 다음 조인트 유형에만 적용됩니다:

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


BasePart:GetConnectedParts

recursive

어떤 종류의 `Class.JointInstance|joint`로 객체에 연결된 부품의 테이블입니다.


강체 조인트로 이 부품에 연결된 `Class.BasePart|BaseParts`의 배열입니다. `recursive`가 true인 경우 조립체의 모든 부품을 포함합니다.


어떤 종류의 강체 조인트로 객체에 연결된 부품의 테이블을 반환합니다.


이 부품에 연결된 모든 조인트 또는 제약 조건을 반환합니다.


BasePart:GetJoints

부품에 연결된 모든 조인트 또는 제약 조건의 배열입니다.


이 예제는 게임의 Workspace에 새로운 부품인 myPart를 생성하며,
크기는 4x6x4 스터드입니다. 이 부품은 고정되어 있습니다.

그런 다음, myMass는 새로운 부품의 질량과 같도록 설정됩니다. 부품의 질량은
출력 문장의 끝에 인쇄됩니다:

> 내 부품의 질량은 ...


**GetMass**는 읽기 전용 `Class.BasePart.Mass|Mass` 속성의 값을 반환합니다.

이 함수는 Mass 속성보다 먼저 존재했습니다. 하위 호환성을 위해 지원되며, Mass 속성을 직접 사용하는 것이 좋습니다.


BasePart:GetMass

`Class.BasePart.Mass|Mass` 속성의 값을 반환합니다.


BasePart:getMass

이 부품의 네트워크 소유자인 현재 플레이어를 반환하거나 서버의 경우 `nil`을 반환합니다.


BasePart:GetNetworkOwner

이 부품의 네트워크 소유자인 현재 플레이어 또는 서버의 경우 `nil`입니다.


게임 엔진이 이 부품의 네트워크 소유자를 자동으로 결정하는 경우 true를 반환합니다.


BasePart:GetNetworkOwnershipAuto

게임 엔진이 이 부품의 네트워크 소유자를 자동으로 결정하는지 여부입니다.


현재 이 부품의 물리 세계에 등록된 활성 `Class.NoCollisionConstraint` 객체를 반환합니다. `Class.NoCollisionConstraint`는 참조하는 두 특정 부품 간의 충돌을 비활성화하며, 각 부품은 여전히 나머지 세계와 충돌할 수 있습니다.

현재 이 부품에 대해 등록된 제약 조건이 없으면 반환된 배열은 비어 있습니다. 반환된 제약 조건의 순서는 보장되지 않습니다.


BasePart:GetNoCollisionConstraints

현재 이 부품의 물리 세계에 등록된 활성 `Class.NoCollisionConstraint` 객체의 배열입니다.


현재 이 부품의 물리 세계에 등록된 활성 `Class.NoCollisionConstraint` 객체를 반환합니다.


이 함수는 Roblox의 지연 보상 보간이 온라인에서 내부적으로 관련되었을 때 유효했습니다. 이제 보간은 `Datatype.CFrame`에 직접 적용됩니다.


BasePart:GetRenderCFrame

부품이 렌더링되는 위치를 나타내는 `Datatype.CFrame`으로, 이제는 부품의 `Class.BasePart.CFrame|CFrame`과 동일합니다.


구식입니다. 부품이 렌더링되는 위치를 설명하는 CFrame을 반환합니다.


부품 조립체의 기본 부품을 반환합니다. `Datatype.CFrame`을 사용하여 부품 조립체를 이동할 때 이 기본 부품을 이동하는 것이 중요합니다(이렇게 하면 연결된 모든 다른 부품도 적절하게 이동합니다). 더 많은 정보는 [조립체](/physics/assemblies) 문서에서 확인할 수 있습니다.

이 함수는 `Class.BasePart.AssemblyRootPart|AssemblyRootPart` 속성보다 먼저 존재했습니다. 하위 호환성을 위해 지원되지만, `Class.BasePart.AssemblyRootPart|AssemblyRootPart`를 직접 사용하는 것이 좋습니다.


BasePart:GetRootPart

조립체의 기본 부품(서로 연결된 부품의 모음)입니다.


부품 조립체의 기본 부품을 반환합니다.


이 부품과 물리적으로 상호작용하는 모든 부품의 테이블을 반환합니다. 부품 자체의 CanCollide가 false로 설정된 경우, 이 함수는 부품에 `Class.TouchTransmitter|TouchInterest` 객체가 부모로 연결되어 있지 않는 한 빈 테이블을 반환합니다(즉, Touched 이벤트에 연결된 것이 없습니다). 인접하지만 교차하지 않는 부품은 접촉으로 간주되지 않습니다. 이 함수는 더 많은 유연성을 제공하고 위에서 설명한 특별한 `Class.TouchTransmitter|TouchInterest` 규칙을 피하는 `Class.WorldRoot:GetPartsInPart()` 함수보다 먼저 존재했습니다. 대신 `Class.WorldRoot:GetPartsInPart()`를 사용하십시오.


BasePart:GetTouchingParts

이 부품과 교차하고 충돌할 수 있는 모든 부품의 테이블입니다.


이 부품과 교차하는 모든 `Class.BasePart.CanCollide`가 true인 부품의 테이블을 반환합니다.


이 부품에 대해 주어진 위치에서 부품 조립체의 선형 속도를 반환합니다. 이는 루트 부품 외의 조립체 내 부품의 선형 속도를 식별하는 데 사용할 수 있습니다. 조립체에 각속도가 없으면 선형 속도는 모든 위치에서 항상 동일합니다.


BasePart:GetVelocityAtPosition

조립체의 선형 속도를 계산할 세계 공간의 위치입니다.


지정된 세계 공간 위치에서 조립체의 선형 속도를 나타내는 `Datatype.Vector3`입니다.


이 부품에 대해 주어진 위치에서 부품 조립체의 선형 속도를 반환합니다.


부품과 주어진 배열의 다른 부품의 겹치는 기하학에서 새로운 `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.GeometryService:IntersectAsync()`를 사용하는 것이 강력히 권장됩니다. 더 나은 성능과 더 많은 기능을 제공할 뿐만 아니라, 새로운 메서드는 다음과 같이 다릅니다:

- 출력은 단일 인스턴스가 아닌 인스턴스 배열입니다.
- 입력 부품은 장면에 부모로 연결될 필요가 없으며, 백그라운드 작업을 허용합니다.
- `SplitApart` 옵션이 true(기본값)로 설정되면 각 개별 본체가 자신의 `Class.PartOperation`으로 반환됩니다.
- 반환된 모든 부품은 주 부품의 좌표 공간에 있으므로, 그들의 `Class.PVInstance.Origin` 위치는 주 부품과 동일합니다. 이는 메쉬의 정점이 작업 전과 동일한 위치에 유지되도록 하지만, 반환된 부품의 `(0, 0, 0)`이 반드시 본체의 중심에 있는 것은 아닙니다.

#### 주의 사항

- 원래 부품은 성공적인 교차 작업 후에도 그대로 유지됩니다. 대부분의 경우, 원래 부품을 모두 `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.IntersectOperation`을 생성합니다.


객체가 제자리에 고정할 부품에 연결되어 있는 경우 true를 반환하고, 그렇지 않으면 false를 반환합니다. `Class.BasePart.Anchored|Anchored` 부품이 있는 조립체에서는 모든 다른 부품이 고정됩니다.


BasePart:IsGrounded

객체가 제자리에 고정할 부품에 연결되어 있는지 여부입니다.


객체가 제자리에 고정할 부품에 연결되어 있는 경우 true를 반환하고, 그렇지 않으면 false를 반환합니다.


`Class.BasePart|Part`의 모든 면에 조인트를 생성합니다. 조인트를 만들 수 있는 `Enum.SurfaceType`이 있는 면이 있는 경우 인접한 부품과 조인트를 생성합니다.

면과 평면 접촉 표면 간에 조인트가 생성됩니다.

- 매끄러운 표면은 조인트를 생성하지 않습니다.
- 접착 표면은 `Class.Glue` 조인트를 생성합니다.
- 용접은 Unjoinable을 제외한 모든 표면과 `Class.Weld` 조인트를 생성합니다.
- 스터드, 인렛 또는 유니버설은 각각 다른 두 표면(예: 스터드와 인렛 및 유니버설)과 `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

스튜디오 크기 조정 도구를 사용하는 것처럼 객체의 크기를 변경합니다.


BasePart:Resize

normalId

deltaAmount

지정된 면에서 얼마나 성장/축소할 것인지입니다.


부품이 크기가 조정되었는지 여부입니다.


BasePart:resize

주어진 플레이어를 이 부품 및 모든 연결된 부품의 네트워크 소유자로 설정합니다. playerInstance가 `nil`인 경우 서버가 플레이어 대신 소유자가 됩니다.


BasePart:SetNetworkOwner

playerInstance

부품의 네트워크 소유권을 부여받는 플레이어입니다.


주어진 플레이어를 이 부품 및 모든 연결된 부품의 네트워크 소유자로 설정합니다.


게임 엔진이 부품의 물리를 처리할 클라이언트 또는 서버를 동적으로 결정하도록 허용합니다.


BasePart:SetNetworkOwnershipAuto

부품에서 주어진 배열의 부품이 차지하는 기하학을 제외한 새로운 `Class.UnionOperation`을 생성합니다. `Class.Part|Parts`만 지원되며, `Class.Terrain` 또는 `Class.MeshPart|MeshParts`는 지원되지 않습니다. `Class.Instance:Clone()|Clone()`와 유사하게, 반환된 객체는 설정된 `Class.Instance.Parent|Parent`가 없습니다.

결과 유니온은 뺄셈으로 인해 비어 있을 수 없습니다. 작업이 완전히 비어 있는 기하학을 생성하면 실패합니다.

#### 마이그레이션

이 메서드 대신 더 새로운 `Class.GeometryService:SubtractAsync()`를 사용하는 것이 강력히 권장됩니다. 더 나은 성능과 더 많은 기능을 제공할 뿐만 아니라, 새로운 메서드는 다음과 같이 다릅니다:

- 출력은 단일 인스턴스가 아닌 인스턴스 배열입니다.
- 입력 부품은 장면에 부모로 연결될 필요가 없으며, 백그라운드 작업을 허용합니다.
- `SplitApart` 옵션이 true(기본값)로 설정되면 각 개별 본체가 자신의 `Class.PartOperation`으로 반환됩니다.
- 반환된 모든 부품은 주 부품의 좌표 공간에 있으므로, 그들의 `Class.PVInstance.Origin` 위치는 주 부품과 동일합니다. 이는 메쉬의 정점이 작업 전과 동일한 위치에 유지되도록 하지만, 반환된 부품의 `(0, 0, 0)`이 반드시 본체의 중심에 있는 것은 아닙니다.


BasePart:SubtractAsync

뺄셈에 참여하는 객체들입니다.


결과 `Class.UnionOperation`의 `Enum.CollisionFidelity` 값입니다.


기본 이름 **Union**을 가진 결과 `Class.UnionOperation`입니다.


부품에서 주어진 배열의 부품이 차지하는 기하학을 제외한 새로운 `Class.UnionOperation`을 생성합니다.


이것은 `Class.BasePart:TorqueToAngularAcceleration()`을 보여줍니다.


주어진 토크를 이 부품의 조립체에 적용할 때 발생할 세계 공간의 각 가속도를 반환하며, 필요에 따라 자이로스코픽 효과를 고려합니다.

이는 `Class.BasePart:AngularAccelerationToTorque()`의 역입니다. 이는 조립체가 적용된 토크에 어떻게 반응할지를 예측하는 데 유용합니다.

계산은 다음을 사용합니다:

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

여기서 **I**는 조립체의 세계 공간 관성 텐서, **τ**는 적용된 토크, **ω**는 각속도입니다.

부품이 `Class.Workspace`의 자손이 아닌 경우 `(0, 0, 0)`을 반환합니다. 조립체가 고정된 경우 `(0, 0, 0)`을 반환합니다.

#### 자이로스코픽 효과

회전하는 조립체가 비대칭 관성 텐서를 가질 때, 적용된 토크로 인해 발생하는 가속도는 현재 각속도에 따라 달라집니다. `angVelocity` 매개변수는 이러한 자이로스코픽 효과를 고려합니다. 생략하면(기본값은 0) 결과에서 이 기여를 무시합니다.


BasePart:TorqueToAngularAcceleration

torque

조립체에 세계 공간에서 적용된 토크 벡터입니다.


세계 공간에서 조립체의 현재 각속도입니다. 기본값은 `(0, 0, 0)`입니다. 자이로스코픽 효과를 고려하려면 조립체의 각속도를 제공하십시오.


세계 공간에서 발생하는 각 가속도를 나타내는 `Datatype.Vector3`입니다.


주어진 토크를 이 부품의 조립체에 적용할 때 발생할 각 가속도를 반환하며, 필요에 따라 자이로스코픽 효과를 고려합니다.


부품에서 주어진 배열의 부품이 차지하는 기하학을 포함한 새로운 `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.GeometryService:UnionAsync()`를 사용하는 것이 강력히 권장됩니다. 더 나은 성능과 더 많은 기능을 제공할 뿐만 아니라, 새로운 메서드는 다음과 같이 다릅니다:

- 출력은 단일 인스턴스가 아닌 인스턴스 배열입니다.
- 입력 부품은 장면에 부모로 연결될 필요가 없으며, 백그라운드 작업을 허용합니다.
- `SplitApart` 옵션이 true(기본값)로 설정되면 각 개별 본체가 자신의 `Class.PartOperation`으로 반환됩니다.
- 반환된 모든 부품은 주 부품의 좌표 공간에 있으므로, 그들의 `Class.PVInstance.Origin` 위치는 주 부품과 동일합니다. 이는 메쉬의 정점이 작업 전과 동일한 위치에 유지되도록 하지만, 반환된 부품의 `(0, 0, 0)`이 반드시 본체의 중심에 있는 것은 아닙니다.

#### 주의 사항

- 원래 부품은 성공적인 유니온 작업 후에도 그대로 유지됩니다. 대부분의 경우, 원래 부품을 모두 `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`을 생성합니다.


BasePart

이 코드 샘플은 부품을 클릭하여 고정 속성을 전환할 수 있게 합니다.
전환되면 부품의 시각적 모양이 업데이트됩니다 (빨간색은 고정됨, 노란색은 자유로움).


`Anchored` 속성은 part가 물리적으로 이동할 수 있는지를 결정합니다. 활성화되면, part는 중력, 다른 part와의 충돌, 다른 part와의 겹침 또는 기타 물리적 원인으로 인해 위치가 변경되지 않습니다. 결과적으로, 두 개의 고정된 part는 서로 `Class.BasePart.Touched|Touched` 이벤트를 발생시키지 않습니다.

고정된 part는 여전히 `Class.BasePart.CFrame|CFrame` 또는 `Class.BasePart.Position|Position`을 변경하여 이동할 수 있으며, 여전히 비제로의 `Class.BasePart.AssemblyLinearVelocity|AssemblyLinearVelocity` 및 `Class.BasePart.AssemblyAngularVelocity|AssemblyAngularVelocity`를 가질 수 있습니다.

마지막으로, 고정되지 않은 part가 고정된 part와 `Class.Weld`와 같은 객체를 통해 연결되면, 그것도 고정된 것처럼 작동합니다. 이러한 조인트가 끊어지면, part는 다시 물리적 영향을 받을 수 있습니다. 자세한 내용은 [Assemblies](/physics/assemblies)를 참조하십시오.

고정된 part에 대한 네트워크 소유권은 설정할 수 없습니다. 서버에서 part의 고정 상태가 변경되면, 해당 part의 네트워크 소유권이 영향을 받습니다.

BasePart.Anchored

part가 물리적으로 이동할 수 없는지 여부를 결정합니다.

이 part의 조립체의 각속도 벡터입니다. 이는 초당 라디안으로 방향의 변화율입니다.

각속도는 조립체의 모든 지점에서 동일합니다.

속도를 직접 설정하면 비현실적인 움직임이 발생할 수 있습니다. `Class.Torque` 또는 `Class.AngularVelocity` 제약 조건을 사용하는 것이 좋으며, 즉각적인 속도 변화를 원할 경우 `Class.BasePart:ApplyAngularImpulse()|ApplyAngularImpulse()`를 사용하십시오.

part가 [소유](/physics/network-ownership)되어 있는 경우, 이 속성은 서버 `Class.Script`에서 변경해야 합니다 ( `Class.LocalScript` 또는 `Class.BaseScript.RunContext|RunContext`가 `Enum.RunContext.Client`로 설정된 `Class.Script`에서 변경할 수 없습니다). part가 클라이언트에 의해 **자동** 소유된 경우, 이 속성은 클라이언트 스크립트 **또는** 서버 스크립트에서 변경할 수 있습니다; 서버 소유 part에 대해 클라이언트 스크립트에서 변경하면 효과가 없습니다.

BasePart.AssemblyAngularVelocity

조립체의 모든 part의 `Class.BasePart.Mass|Mass`와 `Class.BasePart.Position|Position`을 통해 계산된 위치입니다.

조립체에 고정된 part가 있는 경우, 해당 part의 질량 중심이 조립체의 질량 중심이 되며, 조립체는 무한한 질량을 가집니다.

질량 중심을 아는 것은 조립체의 안정성을 유지하는 데 도움이 될 수 있습니다. 질량 중심에 적용된 힘은 각 가속도를 유발하지 않으며, 선형 가속도만 유발합니다. 질량 중심이 낮은 조립체는 중력의 영향을 받을 때 더 잘 서 있을 수 있습니다.

BasePart.AssemblyCenterOfMass

part의 조립체의 질량 중심입니다.

이 part의 조립체의 선형 속도 벡터입니다. 이는 초당 `Class.BasePart.AssemblyCenterOfMass|AssemblyCenterOfMass`의 위치 변화율입니다.

조립체의 질량 중심이 아닌 다른 지점에서의 속도를 알고 싶다면, `Class.BasePart:GetVelocityAtPosition()|GetVelocityAtPosition()`을 사용하십시오.

속도를 직접 설정하면 비현실적인 움직임이 발생할 수 있습니다. `Class.VectorForce` 제약 조건을 사용하는 것이 좋으며, 즉각적인 속도 변화를 원할 경우 `Class.BasePart:ApplyImpulse()|ApplyImpulse()`를 사용하십시오.

part가 [소유](/physics/network-ownership)되어 있는 경우, 이 속성은 서버 `Class.Script`에서 변경해야 합니다 ( `Class.LocalScript` 또는 `Class.BaseScript.RunContext|RunContext`가 `Enum.RunContext.Client`로 설정된 `Class.Script`에서 변경할 수 없습니다). part가 클라이언트에 의해 **자동** 소유된 경우, 이 속성은 클라이언트 스크립트 **또는** 서버 스크립트에서 변경할 수 있습니다; 서버 소유 part에 대해 클라이언트 스크립트에서 변경하면 효과가 없습니다.

BasePart.AssemblyLinearVelocity

part의 조립체의 선형 속도입니다.

이 part의 조립체에 있는 모든 `Class.BasePart|BaseParts`의 질량의 합입니다. `Class.BasePart.Massless|Massless`인 part는 조립체의 루트 part가 아닌 경우 `AssemblyMass`에 기여하지 않습니다.

조립체에 고정된 part가 있는 경우, 조립체의 질량은 무한한 것으로 간주됩니다. 질량 차이가 큰 고정되지 않은 조립체 간의 제약 조건 및 기타 물리적 상호작용은 불안정을 초래할 수 있습니다.

BasePart.AssemblyMass

part의 조립체의 총 질량입니다.

이 속성은 조립체의 루트 part를 나타내기 위해 자동으로 선택된 `Class.BasePart`를 나타냅니다. part가 `Class.Workspace`에 부모가 아닌 경우, 이 속성은 `nil`이 됩니다.

루트 part는 조립체의 part의 `Class.BasePart.RootPriority|RootPriority`를 변경하여 변경할 수 있습니다.

모든 `AssemblyRootPart`를 공유하는 part는 동일한 조립체에 있습니다.

루트 part에 대한 자세한 내용은 [Assemblies](/physics/assemblies)를 참조하십시오.

BasePart.AssemblyRootPart

조립체의 루트 part에 대한 참조입니다.

`AudioCanCollide`는 part가 조명에 대한 `Class.BasePart.CastShadow|CastShadow`와 유사하게 오디오 시뮬레이션과 물리적으로 상호작용할지를 결정합니다.

비활성화되면, 오디오는 part를 통과하며, 차단되거나 반사되지 않습니다.

BasePart.AudioCanCollide

part가 조명에 대한 `Class.BasePart.CastShadow|CastShadow`와 유사하게 오디오 시뮬레이션과 물리적으로 상호작용할지를 결정합니다.

물리적으로 상호작용하는 세계 내 객체를 위한 추상 기본 클래스입니다.

/reference/engine/classes/TriangleMeshPart.yaml