이 페이지에는 피직스(Physics) 및 콜리전(Collision) 프로퍼티 카테고리의 프로퍼티 레퍼런스 목록이 포함되어 있습니다. 콜리전 반응(Collision Responses) 또는 콜리전 프리셋(Collision Presets)에 대한 레퍼런스는 콜리전 반응 레퍼런스를 참조하세요.
프로퍼티
다음은 주요 카테고리로 구분된 피직스 바디(바디 인스턴스)의 프로퍼티입니다.
피직스
| 프로퍼티 | 설명 |
|---|---|
| 양면 지오메트리(Double Sided Geometry) | 이 프로퍼티가 활성화되면 피직스 트라이앵글 메시는 씬을 쿼리할 때 양면 페이스를 사용합니다. 양면 모두 트레이스해야 하는 평면 및 단면 메시에 유용합니다. |
| 단순 콜리전 피지컬 머티리얼(Simple Collision Physical Material) | 이 바디에서 단순 콜리전에 사용할 피지컬 머티리얼입니다. 밀도, 마찰 등에 대한 정보를 인코딩합니다. |
| 피직스 타입(Physics Type) |
|
| Mass in KG | kg 단위의 바디 질량입니다. |
| 선형 댐핑(Linear Damping) | 가해지면 선형 이동을 줄이는 '항력'입니다. |
| 각 댐핑(Angular Damping) | 가해지면 각 이동을 줄이는 '항력'입니다. |
| 중력 활성화(Enable Gravity) | 오브젝트에 중력이 적용되는지 여부입니다. |
고급
| 프로퍼티 | 설명 |
|---|---|
| 깨우기 시작(Start Awake) | 오브젝트가 깨어난 채로 시작하는지 아니면 슬립 상태로 시작하는지입니다. |
| Center Of Mass Offset | 계산된 위치로부터 이 오브젝트의 질량 중심에 적용할 사용자 지정 오프셋입니다. |
| 질량 스케일(Mass Scale) | 인스턴스별 질량 스케일링입니다. |
| 최대 각 속도(Max Angular Velocity) | 이 인스턴스의 최대 각 속도입니다. |
| 슬립 패밀리(Sleep Family) | 이 바디를 슬립 상태로 전환할 시기를 고려할 때 사용되는 값 세트입니다. Normal, Sensitive, Custom 중에서 선택할 수 있습니다. |
| 관성 텐서 스케일(Inertia Tensor Scale) | 인스턴스별 관성 스케일링입니다. 값이 클수록 회전이 어렵습니다. |
| 걸을 수 있는 경사 오버라이드(Walkable Slope Override) | 이 바디에 적용되는 '걸을 수 있는 경사' 커스텀 세팅입니다. 관련 사용법을 알아보려면 걸을 수 있는 경사 문서를 참조하세요. |
| 걸을 수 있는 경사 동작(Walkable Slope Behavior) | 이 표면의 행동으로서, 걸을 수 있는 경사에 영향을 주는지 여부를 나타냅니다. |
| 걸을 수 있는 경사 각도(Walkable Slope Angle) | 걸을 수 있는 경사 동작 규칙을 적용하여 걸을 수 있는 경사를 오버라이드합니다. |
| 커스텀 슬립 한계치 배수(Custom Sleep Threshold Multiplier) | 슬립 패밀리(Sleep Family)가 커스텀(Custom) 으로 설정된 경우 자연 슬립 한계치에 이 값을 곱합니다. 숫자가 클수록 바디는 더 빨리 슬립 상태로 전환됩니다. |
| 안정화 한계치 배수(Stabilization Threshold Multiplier) | 피직스 안정화 기능이 활성화된 경우 이 바디에 적용되는 안정화 지수입니다. 숫자가 클수록 바디가 더욱 적극적으로 안정화되지만, 저속에서 운동량이 줄어들 수 있습니다. 값이 0이면 이 바디가 안정화되지 않습니다. |
| 스케일 변경 시 매스 업데이트(Update Mass when Scale Changes) | true일 경우 스케일 변경 시 질량을 업데이트합니다. |
| 깨어남 이벤트 생성(Generate Wake Events) | 피직스 시뮬레이션으로 이 오브젝트를 깨우거나 슬립시킬 때 '깨어남/슬립' 이벤트가 실행될지 여부를 결정합니다. |
콜리전
| 프로퍼티 | 설명 |
|---|---|
| 쿠킹된 콜리전 데이터 필요 없음(Never Needs Cooked Collision Data) | TODO 카오스 특정 메시를 CreatePhysicsMeshes에서 제외합니다. 장기적 메시가 메시 인스턴스에 필요하다고 파악되기 전까지는 CreatePhysicsMesh를 호출하지 않는 편이 더 좋습니다. |
| 콜리전 복잡도(Collision Complexity) | 콜리전 트레이스 행동 - 기본적으로 단순(컨벡스) 콜리전과 복합(폴리곤별) 콜리전을 분리합니다. |
| 콜리전 반응(Collision Responses) | 자세한 정보는 콜리전 반응 레퍼런스 문서를 참조하세요. |
| 시뮬레이션 중 히트 이벤트 생성(Simulation Generates Hit Events) | 피직스 시뮬레이션 중에 이 오브젝트가 충돌할 때 '히트' 이벤트가 실행될지 여부입니다. |
| 피직스 머티리얼 오버라이드(Phys Material Override) | 이 바디에서 단순 콜리전에 사용할 수 있는 피지컬 머티리얼(PhysicalMaterial)을 오버라이드하도록 허용합니다. |
고급
| 프로퍼티 | 설명 |
|---|---|
| CCD 사용(Use CCD) | true일 경우 지속 콜리전 감지(Continuous Collision Detection, CCD)가 이 컴포넌트에 사용됩니다. |
| 분석 콜리전 무시(Ignore Analytic Collisions) | true일 경우 분석 콜리전을 무시하고 오브젝트를 일반 묵시적 표면으로 취급합니다. |
| 부드러운 에지 콜리전(Smooth Edge Collisions) | 불필요한 에지 콜리전을 제거하여 여러 액터와 컴포넌트로 구성된 표면에서도 부드럽게 미끄러지도록 합니다. |
바디 구성
| 프로퍼티 | 설명 |
|---|---|
| 애니메이션에서 스케일 건너뛰기(Skip Scale from Animation) | true일 경우 애니메이션의 스케일 변화를 무시합니다. 피직스 콜리전이 그대로 유지되어야 하는 미묘한 스케일 애니메이션(예: 숨쉬기)에 유용합니다. |
| 프리미티브(Primitives) | 이 오브젝트의 단순화된 콜리전입니다. |
| 스피어(Spheres) | 스피어 엘리먼트입니다. |
| 박스(Boxes) | 박스 엘리먼트입니다. |
| 캡슐(Capsules) | 스필(Sphyl) 엘리먼트입니다. |
| 컨벡스 엘리먼트(Convex Elements) | 컨벡스 엘리먼트입니다. |
| 테이퍼드 캡슐(Tapered Capsules) | 테이퍼드 캡슐 엘리먼트입니다. |
| 바운드에 고려(Consider for Bounds) | 피직스 에셋(PhysicsAsset)과 스켈레탈 메시 컴포넌트(SkeletalMeshComponent)의 바운딩 박스에 이 바디 셋업(BodySetup)이 고려될지 여부를 결정합니다. 바운드를 업데이트할 때 프레임별로 처리되는 바디 셋업이 줄어들면 속도가 향상됩니다. |
| 본 이름(Bone Name) | 피직스 에셋(PhysicsAsset) 사례에 사용하며, 이 바디를 스켈레탈 메시의 본에 연결합니다. |
다음은 각 프리미티브 타입의 디테일 프로퍼티입니다.
프리미티브 타입
스피어
| 프로퍼티 | 설명 |
|---|---|
| 중앙(Center) | 스피어의 원점 위치입니다. |
| 반경(Radius) | 스피어의 반경입니다. |
| 나머지 오프셋(Rest Offset) | 컨택트 포인트를 생성할 때 사용되는 오프셋입니다. 이 오프셋을 사용하면 민코프스키 합을 반경 R로 스무딩할 수 있습니다. 오브젝트가 불규칙한 조건에서 부드럽게 미끄러지도록 할 때 유용합니다. |
| 이름(Name) | 이 셰이프의 사용자 정의 이름입니다. |
| 질량에 기여(Contribute to Mass) | 이 셰이프가 소속 바디의 전체 질량에 기여하는 경우 본 프로퍼티를 활성화합니다. 본 프로퍼티를 활성화하면 오브젝트의 질량 프로퍼티에 영향을 주지 않는 추가 콜리전 볼륨을 생성할 수 있습니다. |
| 콜리전 활성화됨(Collision Enabled) | 프리미티브 콜리전 필터링별 코스입니다. 이 코스를 사용하면 개별 프리미티브가 시뮬레이션 안팎으로 토글될 수 있으며 필터링 디테일 변경 없이도 콜리전을 쿼리할 수 있습니다. |
박스
| 프로퍼티 | 설명 |
|---|---|
| 중앙(Center) | 박스의 원점 위치입니다. |
| 회전(Rotation) | 각 축을 중심으로 한 박스의 회전 각도입니다. |
| X 크기(X Extent) | 박스의 X축 규모입니다. |
| Y 크기(Y Extent) | 박스의 Y축 규모입니다. |
| Z 크기(Z Extent) | 박스의 Z축 규모입니다. |
| 나머지 오프셋(Rest Offset) | 컨택트 포인트를 생성할 때 사용되는 오프셋입니다. 이 오프셋을 사용하면 민코프스키 합을 반경 R로 스무딩할 수 있습니다. 오브젝트가 불규칙한 조건에서 부드럽게 미끄러지도록 할 때 유용합니다. |
| 이름(Name) | 이 셰이프의 사용자 정의 이름입니다. |
| 질량에 기여(Contribute to Mass) | 이 셰이프가 소속 바디의 전체 질량에 기여하는 경우 본 프로퍼티를 활성화합니다. 본 프로퍼티를 활성화하면 오브젝트의 질량 프로퍼티에 영향을 주지 않는 추가 콜리전 볼륨을 생성할 수 있습니다. |
| 콜리전 활성화됨(Collision Enabled) | 프리미티브 콜리전 필터링별 코스입니다. 이 코스를 사용하면 개별 프리미티브가 시뮬레이션 안팎으로 토글될 수 있으며 필터링 디테일 변경 없이도 콜리전을 쿼리할 수 있습니다. |
캡슐
| 프로퍼티 | 설명 |
|---|---|
| 중앙(Center) | 캡슐의 원점 위치입니다. |
| 회전(Rotation) | 각 축을 중심으로 한 캡슐의 회전 각도입니다. |
| 반경(Radius) | 캡슐의 반경입니다. |
| 길이(Length) | 선분 길이입니다. 반경을 양쪽 끝에 더해 총길이를 구합니다. |
| 나머지 오프셋(Rest Offset) | 컨택트 포인트를 생성할 때 사용되는 오프셋입니다. 이 오프셋을 사용하면 민코프스키 합을 반경 R로 스무딩할 수 있습니다. 오브젝트가 불규칙한 조건에서 부드럽게 미끄러지도록 할 때 유용합니다. |
| 이름(Name) | 이 셰이프의 사용자 정의 이름입니다. |
| 질량에 기여(Contribute to Mass) | 이 셰이프가 소속 바디의 전체 질량에 기여하는 경우 본 프로퍼티를 활성화합니다. 본 프로퍼티를 활성화하면 오브젝트의 질량 프로퍼티에 영향을 주지 않는 추가 콜리전 볼륨을 생성할 수 있습니다. |
| 콜리전 활성화됨(Collision Enabled) | 프리미티브 콜리전 필터링별 코스입니다. 이 코스를 사용하면 개별 프리미티브가 시뮬레이션 안팎으로 토글될 수 있으며 필터링 디테일 변경 없이도 콜리전을 쿼리할 수 있습니다. |
컨벡스 엘리먼트
| 프로퍼티 | 설명 |
|---|---|
| 나머지 오프셋(Rest Offset) | 컨택트 포인트를 생성할 때 사용되는 오프셋입니다. 이 오프셋을 사용하면 민코프스키 합을 반경 R로 스무딩할 수 있습니다. 오브젝트가 불규칙한 조건에서 부드럽게 미끄러지도록 할 때 유용합니다. |
| 이름(Name) | 이 셰이프의 사용자 정의 이름입니다. |
| 질량에 기여(Contribute to Mass) | 이 셰이프가 소속 바디의 전체 질량에 기여하는 경우 본 프로퍼티를 활성화합니다. 본 프로퍼티를 활성화하면 오브젝트의 질량 프로퍼티에 영향을 주지 않는 추가 콜리전 볼륨을 생성할 수 있습니다. |
| 콜리전 활성화됨(Collision Enabled) | 프리미티브 콜리전 필터링별 코스입니다. 이 코스를 사용하면 개별 프리미티브가 시뮬레이션 안팎으로 토글될 수 있으며 필터링 디테일 변경 없이도 콜리전을 쿼리할 수 있습니다. |
테이퍼드 캡슐
| 프로퍼티 | 설명 |
|---|---|
| 중앙(Center) | 캡슐의 원점 위치입니다. |
| 회전(Rotation) | 각 축을 중심으로 한 캡슐의 회전 각도입니다. |
| 반경 0(Radius 0) | 캡슐 시작 지점의 반경입니다. |
| 반경 1(Radius 1) | 캡슐 끝 지점의 반경입니다. |
| 길이(Length) | 선분 길이입니다. 반경 0(Radius 0)과 반경 1(Radius 1)을 더해 총길이를 구합니다. |
| 나머지 오프셋(Rest Offset) | 컨택트 포인트를 생성할 때 사용되는 오프셋입니다. 이 오프셋을 사용하면 민코프스키 합을 반경 R로 스무딩할 수 있습니다. 오브젝트가 불규칙한 조건에서 부드럽게 미끄러지도록 할 때 유용합니다. |
| 이름(Name) | 이 셰이프의 사용자 정의 이름입니다. |
| 질량에 기여(Contribute to Mass) | 이 셰이프가 소속 바디의 전체 질량에 기여하는 경우 본 프로퍼티를 활성화합니다. 본 프로퍼티를 활성화하면 오브젝트의 질량 프로퍼티에 영향을 주지 않는 추가 콜리전 볼륨을 생성할 수 있습니다. |
| 콜리전 활성화됨(Collision Enabled) | 프리미티브 콜리전 필터링별 코스입니다. 이 코스를 사용하면 개별 프리미티브가 시뮬레이션 안팎으로 토글될 수 있으며 필터링 디테일 변경 없이도 콜리전을 쿼리할 수 있습니다. |