`Class.MeshPart`와 `Class.PartOperation`에서 상속받는 추상 중간 클래스인 TriangleMeshPart입니다. 두 하위 클래스 간의 물리적 기하학 속성 관리를 통합하기 위해 생성되었습니다. 읽기 전용
`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()`를 사용하여 이동할 수 있습니다. [모델](/parts/models)를 참조하세요.
- `Class.Decal`은 부품의 면에 늘어난 이미지 텍스처를 적용하고, `Class.Texture`는 면에 타일형 이미지 텍스처를 적용합니다. [텍스처 및 데칼](/parts/textures-decals)을 참조하세요.
- `Class.SurfaceGui`는 부품의 면에 `Class.GuiObject|GuiObjects`를 렌더링합니다. [인 경험 UI 컨테이너](/ui/in-experience-containers)를 참조하세요.
- `Class.Attachment|Attachments`는 부품과 관련된 `Datatype.CFrame|CFrames`를 지정하기 위해 `Class.BasePart`에 추가될 수 있습니다. 이는 종종 물리적 `Class.Constraint` 객체에 의해 사용되며, [기계적 제약조건](/physics/mechanical-constraints) 및 [이동 제약조건](/physics/mover-constraints)에서 설명한 대로 사용됩니다.
- `Class.ParticleEmitter` 객체는 상위 부품의 체적 내에서 균일하게 입자를 방출합니다. [입자 방출기](/effects/particle-emitters)를 참조하세요.
- `Class.PointLight`와 같은 조명 객체는 부품의 중앙에서 빛을 방출하며 [조명 소스](/effects/light-sources)에서 설명된 바와 같이 작동합니다.
- 만약 `Class.Tool`에 부모가 되고 **Handle**라는 이름이 주어지면, `Class.BasePart`는 캐릭터에 의해 잡힐 수 있습니다. [인 경험 도구](/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.BaseScript.RunContext|RunContext`가 `Enum.RunContext.Client`로 설정된 `Class.Script`에서 호출될 수 없습니다).
부품이 클라이언트의 **자동** 소유를 통해 소유되면, 이 함수는 클라이언트 스크립트 **또는** 서버 스크립트에서 호출될 수 있습니다;
클라이언트 스크립트에서 서버 소유의 부품에 대해 호출하면 아무 효과가 없습니다.


BasePart:ApplyAngularImpulse

impulse

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


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


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

힘은 조립체의 `Class.BasePart.AssemblyCenterOfMass|질량 중심`에서 적용되므로,
결과적으로 발생하는 움직임은 선형적입니다.

임펄스의 결과로 발생하는 속도는 조립체의 `Class.BasePart.AssemblyMass|mass`에 의존합니다. 따라서 더 큰 질량의 조립체를 이동시키기 위해 더 높은 임펄스가 필요합니다.
임펄스는 폭발이나 충돌과 같이 힘이 즉시 적용되는 경우에 유용합니다.

부품이 [소유](/physics/network-ownership)되는 경우, 이 함수는 서버 `Class.Script`에서 호출되어야 합니다( `Class.LocalScript` 또는 `Class.BaseScript.RunContext|RunContext`가 `Enum.RunContext.Client`로 설정된 `Class.Script`에서 호출될 수 없습니다).
부품이 클라이언트의 **자동** 소유를 통해 소유되면, 이 함수는 클라이언트 스크립트 **또는** 서버 스크립트에서 호출될 수 있습니다;
클라이언트 스크립트에서 서버 소유의 부품에 대해 호출하면 아무 효과가 없습니다.


BasePart:ApplyImpulse

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


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


이 함수는 이 부품의 조립체에 순간적인 힘 임펄스를 지정된 위치에서 적용합니다.

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

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

부품이 [소유](/physics/network-ownership)되는 경우, 이 함수는 서버 `Class.Script`에서 호출되어야 합니다( `Class.LocalScript` 또는 `Class.BaseScript.RunContext|RunContext`가 `Enum.RunContext.Client`로 설정된 `Class.Script`에서 호출될 수 없습니다).
부품이 클라이언트의 **자동** 소유를 통해 소유되면, 이 함수는 클라이언트 스크립트 **또는** 서버 스크립트에서 호출될 수 있습니다;
클라이언트 스크립트에서 서버 소유의 부품에 대해 호출하면 아무 효과가 없습니다.


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)`, 조인트는 **강체**가 됩니다. 이는 `Part1`의 물리학이 `Part0`로 인해 완전히 고정된 경우에만 해당됩니다.
이는 다음의 조인트 타입에만 적용됩니다:

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


BasePart:GetConnectedParts

recursive

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


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


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


BasePart:GetJoints

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


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

그 다음, 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`를 사용하여 부품 조립체를 이동할 때, 이 기본 부품을 이동하는 것이 중요합니다(이는 이와 연결된 모든 다른 부품을 accordingly 이동합니다). 더 많은 정보는 [조립체](/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

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


주어진 배열의 부품과의 교차하는 기하학으로부터 새로운 `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="Two block parts overlapping" />
<figcaption>서로 분리된 부품</figcaption>
</figure>
<figure>
<img src="../../../assets/modeling/solid-modeling/Intersect-Result.jpg"
width="720" alt="Parts intersected into a new solid model" />
<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 triangles 이상의 부품 결과로 끝나면, 20,000 triangles로 단순화합니다.


BasePart:IntersectAsync

parts

교차 작업에 참여하는 객체들입니다.


collisionfidelity

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


renderFidelity

결과 `Class.PartOperation`의 `Enum.RenderFidelity` 값입니다.


기본 이름 **Intersect**의 결과 `Class.IntersectOperation`입니다.


참고: 이 함수 대신 최신 `Class.GeometryService:IntersectAsync` 사용을 강력히 권장합니다. 성능과 기능 모두 개선된 새로운 함수는 다음과 같은 차이점이 있습니다:

- 출력은 단일 인스턴스가 아닌 인스턴스의 배열입니다.
- 입력 부품은 장면의 부모가 될 필요가 없으므로 백그라운드 작업이 가능합니다.
- `SplitApart` 옵션이 true(기본값)로 설정되면 각 독립체가 별도의 `Class.PartOperation`으로 반환됩니다.
- 반환된 모든 부품은 주 부품의 좌표 공간에 있습니다.
  따라서 `Class.PVInstance.Origin` 위치는 주 부품과 같습니다. 이는 메쉬의 정점이 이전과 같은 위치에 유지되도록 하지만,
  이는 반환된 부품의 `(0, 0, 0)`가 본체의 중심에 있지 않음을 의미합니다.

   주어진 배열의 다른 부품과 교차하는 부품의 기하학으로부터 새로운 `Class.IntersectOperation`를 생성합니다.


객체가 위치를 고정할 다른 부품과 연결되어 있는지 여부를 반환합니다(예: `Class.BasePart.Anchored|Anchored` 부품).
조립체에 `Class.BasePart.Anchored|Anchored` 부품이 있는 경우 모든 다른 부품은 고정됩니다.


BasePart:IsGrounded

객체가 위치를 고정할 다른 부품과 연결되어 있는지 여부입니다.


객체가 위치를 고정할 다른 부품과 연결되어 있는지 여부를 반환합니다(예: `Class.BasePart.Anchored|Anchored` 부품).


`Class.BasePart|Part`의 조인트를 생성할 수 있는 `Enum.SurfaceType`이 있는 어떤 면에 조인트를 생성하며, 인접한 부품과의 조인트를 생성합니다.

조인트는 면과 평면 접촉 표면 간에 생성되며, 면의 표면에 따라 달라집니다.

- 매끄러운 표면은 조인트를 생성하지 않음
- 접착 표면은 `Class.Glue` 조인트를 생성
- 용접은 Unjoinable이 아닌 모든 표면과 함께 `Class.Weld` 조인트를 생성
- Studs, Inlet 또는 Universal은 서로 두 표면(예: Studs와 Inlet 및 Universal) 사이에 `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.BasePart`에서 다른 파트(들)를 빼서 부정된 `Class.UnionOperation`을 형성하는 방법을 보여줍니다.

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

제거로 인해 결과 유니온이 비어있을 수는 없음을 유의하기 바랍니다. 작업 결과가 완전히 비어있는 기하학으로 끝나는 경우,
실패합니다.

아래의 이미지 비교에서,
`Class.BasePart:SubtractAsync()|SubtractAsync()`는 파란색 실린더를 사용하여 호출됩니다.
그 결과 `Class.UnionOperation`은 실린더의 기하학에서 보라색 블록을 생략한 형태로 해결됩니다.

<figure>
<img src="../../../assets/modeling/solid-modeling/Separate-Parts-To-Subtract.jpg"
width="720" alt="Longer block overlapping a cylinder" />
<figcaption>서로 분리된 부품</figcaption>
</figure>
<figure>
<img src="../../../assets/modeling/solid-modeling/Negate-Result.jpg" width="720"
alt="Block part subtracted from cylinder" />
<figcaption>결과 <code>Class.UnionOperation</code></figcaption>
</figure>


BasePart:SubtractAsync

제거 작업에 참여하는 객체들입니다.


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


기본 이름 **Union**의 결과 `Class.UnionOperation`입니다.


참고: 이 함수 대신 최신 `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="Block and cylinder parts overlapping" />
<figcaption>서로 분리된 부품</figcaption>
</figure>
<figure>
<img src="../../../assets/modeling/solid-modeling/Union-Result.jpg" width="720"
alt="Parts joined together into a single solid union" />
<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 triangles 이상의 부품 결과를 초래한다면 20,000 triangles로 단순화됩니다.


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`의 위치 변화의 초당 비율을 나타냅니다.

어셈블리의 질량 중심 외의 다른 점에서의 속도를 알고 싶다면, `Class.BasePart:GetVelocityAtPosition()|GetVelocityAtPosition()`을 사용할 수 있습니다.

속도를 직접 설정하면 비현실적인 움직임이 발생할 수 있습니다. 선형 속도가 즉각적으로 변화되도록 하려면 `Class.BasePart:ApplyImpulse()|ApplyImpulse()`를 사용하는 것이 바람직합니다.

부품이 [소유](/physics/network-ownership)되고 있다면 이 속성은 서버의 `Class.Script`에서 변경해야 합니다 (즉, `Class.LocalScript` 또는 `Class.Script`의 `Class.BaseScript.RunContext|RunContext`가 `Enum.RunContext.Client`로 설정된 경우에는 변경할 수 없습니다). 부품이 클라이언트를 통해 **자동** 소유권이 있을 경우 이 속성은 클라이언트 스크립트 **또는** 서버 스크립트에서 변경될 수 있으며, 서버 소유 부품을 위한 클라이언트 스크립트에서 이를 변경하면 아무런 효과가 없습니다.


BasePart.AssemblyLinearVelocity

부품 어셈블리의 선형 속도를 나타냅니다.


이 부품의 어셈블리에 있는 모든 `Class.BasePart|BaseParts`의 질량 합계입니다. `Class.BasePart.Massless|Massless`인 부품이며 어셈블리의 루트 부품이 아닌 경우 `AssemblyMass`에 기여하지 않습니다.

어셈블리에 고정된 부품이 있는 경우, 어셈블리의 질량은 무한대로 간주됩니다. 큰 질량 차이를 가진 고정되지 않은 어셈블리 간의 제약조건 및 기타 물리적 상호작용은 불안정을 초래할 수 있습니다.


BasePart.AssemblyMass

부품 어셈블리의 총 질량을 나타냅니다.


이 속성은 어셈블리의 루트 부품을 나타내기 위해 자동으로 선택된 `Class.BasePart`를 표시합니다. 부품이 `Class.Workspace`에 부모가 되어 있지 않은 경우, 이 속성은 `nil`이 됩니다.

루트 부품은 어셈블리의 부품들의 `Class.BasePart.RootPriority|RootPriority`를 변경하여 변경할 수 있습니다.

모두 같은 `AssemblyRootPart`를 공유하는 부품들은 같은 어셈블리에 속합니다.

루트 부품에 대한 자세한 정보는 [Assemblies](/physics/assemblies)를 참조하세요.


BasePart.AssemblyRootPart

어셈블리의 루트 부품에 대한 참조입니다.


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

비활성화된 경우, 오디오는 부품을 통과하며 차단되거나 반사되지 않습니다.


BasePart.AudioCanCollide

부품이 오디오 시뮬레이션과 물리적으로 상호작용하는지를 결정합니다.


이 코드 샘플은 NormalId(위쪽, 앞쪽 등)만 사용하여 표면 속성을 설정하는 방법을 보여줍니다. 모터의 -SurfaceInput을 NoInput, Constant 및 Sin으로 전환하여 각각이 -ParamA 및 -ParamB 속성을 사용하여 어떻게 작동하는지 보여줍니다.

부품의 `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

부품의 아랫면에 대한 입력 유형을 결정합니다.


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


/reference/engine/classes/TriangleMeshPart.yaml