`Class.MeshPart`는 물리적으로 시뮬레이션된 사용자 정의 메시를 포함하는 `Class.BasePart`의 형태입니다.
다른 메시 클래스인 `Class.SpecialMesh` 및 `Class.BlockMesh`와는 달리, 이들은 `Class.BasePart`에 부모로 연결되지 않고
자체적으로 `Class.BasePart`처럼 동작합니다.

`Class.MeshPart`의 메시와 텍스처는 `Class.MeshPart.MeshId|MeshId` 및 `Class.MeshPart.TextureID|TextureID`
속성에 의해 결정됩니다. 자세한 내용은 [메시](/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

이 `Class.MeshPart`에 복사되는 `Class.MeshPart`의 소스입니다. `Class.MeshPart.MeshContent|MeshContent`,
`Class.MeshPart.TextureContent|TextureContent`, 및 충돌 기하학(및 `Class.MeshPart.RenderFidelity|RenderFidelity`,
`Class.MeshPart.CollisionFidelity|CollisionFidelity`, `Class.MeshPart.FluidFidelity|FluidFidelity`, 및
`Class.MeshPart.MeshSize|MeshSize`)이 이 부품에 복사됩니다. 객체는 `Class.MeshPart`여야 하며, 그렇지 않으면 호출 시 오류가 발생합니다.


주어진 소스 `meshPart`로부터 이 `Class.MeshPart`의 `Class.MeshPart.MeshContent|MeshContent`,
`Class.MeshPart.TextureContent|TextureContent`, 및 충돌 기하학 속성을 덮어씁니다.


MeshPart

이 속성은 메시의 다각형 양면을 렌더링할지 여부를 결정합니다. 이는 일반적으로 "카드"로 모델링된 메시, 예를 들어
잎사귀, 머리카락 또는 천과 같은 경우에 유용합니다.


MeshPart.DoubleSided

메시의 다각형 양면을 렌더링할지 여부를 결정합니다.


`Class.MeshPart`의 내부 `Class.MeshPart.JointOffset|JointOffset`와 관련된 사용 중단된 레거시 속성입니다.
엔진에 의해 관리되며 스크립트로 설정할 수 없습니다. 새로운 작업에서 사용하지 마세요.


MeshPart.HasJointOffset

부품의 `Class.MeshPart.JointOffset|JointOffset`와 관련된 사용 중단된 레거시 플래그입니다.


`Class.MeshPart`에 현재 적용된 메시가 스키닝(뼈 및 관절) 데이터를 포함하는지 여부를 나타냅니다. 이는 스켈레탈 변형을 위한
아머처로 작성된 메시와 같은 경우입니다.

기본값은 `false`입니다. 메시가 로드될 때 엔진이 자동으로 설정하며(`true`는 메시 데이터에 관절이 포함된 경우), 스크립트로 설정할 수 없습니다.


MeshPart.HasSkinnedMesh

`Class.MeshPart`에 현재 적용된 메시가 스키닝(뼈 및 관절) 데이터를 포함하는지 여부를 나타냅니다.


사용 중단되었습니다. 스키닝된 메시의 관절을 위치시키기 위해 한때 사용되었던 `Datatype.Vector3` 오프셋입니다.
기본값은 `0, 0, 0`이며 새로운 메시가 부품에 적용될 때마다 초기화됩니다. 스크립트로 설정할 수 없으며, 새로운 작업에서 사용하지 마세요.


MeshPart.JointOffset

사용 중단되었습니다. 스키닝된 메시의 관절을 위치시키기 위해 한때 사용되었던 오프셋입니다.


`Class.MeshPart`에 표시되는 메시입니다. [자산 URI](/projects/assets#asset-uris) 및
`Class.EditableMesh` 객체를 지원합니다.

이 속성은 스크립트에 의해 직접 변경될 수 없으며, 메시의 충돌 기하학은 실시간으로 재계산될 수 없습니다. `Class.AssetService:CreateMeshPartAsync()`를 사용하여 주어진 `Datatype.Content`로부터 새로운 `Class.MeshPart`를 생성할 수 있습니다.
`Class.MeshPart:ApplyMesh()`를 사용하여 기존 `Class.MeshPart`의 `Class.MeshPart.MeshContent|MeshContent`,
`Class.MeshPart.TextureContent|TextureContent`, 및 충돌 기하학을 덮어쓸 수 있습니다.


MeshPart.MeshContent

`Class.MeshPart`에 표시되는 메시입니다. [자산 URI](/projects/assets#asset-uris) 및
`Class.EditableMesh` 객체를 지원합니다.


`Class.MeshPart`에 표시되는 메시의 [자산 URI](/projects/assets#asset-uris)입니다.
`Class.MeshPart.MeshContent|MeshContent`에 읽기 및 쓰기를 수행합니다.

이 속성은 스크립트에 의해 직접 변경될 수 없으며, 메시의 충돌 기하학은 실시간으로 재계산될 수 없습니다. `Class.AssetService:CreateMeshPartAsync()`를 사용하여 주어진 `Datatype.Content`로부터 새로운 `Class.MeshPart`를 생성할 수 있습니다.
`Class.MeshPart:ApplyMesh()`를 사용하여 기존 `Class.MeshPart`의 `Class.MeshPart.MeshContent|MeshContent`,
`Class.MeshPart.TextureContent|TextureContent`, 및 충돌 기하학을 덮어쓸 수 있습니다.


MeshPart.MeshId

`Class.MeshPart`에 표시되는 메시의 [자산 URI](/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`에 적용된 텍스처입니다. [자산 URI](/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에 데칼로 업로드할 수 있으며, 그 [자산 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를 사용하여 수행할 수 없으며, [Blender](https://www.blender.org/)와 같은 외부 3D 모델링 애플리케이션을 사용해야 합니다.


MeshPart.TextureContent

`Class.MeshPart`에 적용된 텍스처입니다. [자산 URI](/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` 및 `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`을 생성합니다.


BasePart

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