인바이런먼트 쿼리 시스템 노드 레퍼런스

인바이런먼트 쿼리 시스템 에디터에서 사용할 수 있는 여러가지 노드에 대한 분석 및 설명입니다.

Windows
MacOS
Linux

인바이런먼트 쿼리 에디터에서 사용할 수 있는 노드와 테스트에 대한 간략 레퍼런스입니다.

Generators

Actors of Class

Search Center (검색 중심) 주변 Search Radius (검색 반경) 내 한 클래스의 모든 액터를 찾습니다. 검색 결과 액터는 테스트에서 사용할 아이템으로 반환됩니다.

gen_actor.png

gen_actor_props.png

프로퍼티

설명

Search Radius

검색 반경 - 원하는 액터를 찾아볼 최대 거리입니다.

Searched Actor Class

검색된 액터 클래스 - 검색할 액터의 클래스(Pawn, Character 등)입니다.

Search Center

검색 중심 - 검색 중심으로 삼을 컨텍스트로, Querier (질의자) 또는 다른 컨텍스트일 수도 있습니다.

On circle

Circle Center (원 중심)에서 방사형으로 트레이스를 뿌리고, 걸린 것 또는 (생성된 원의) 반경 에지를 아이템으로 반환합니다.

gen_circle.png

gen_circle_props.png

프로퍼티

설명

Circle Radius

원 반경 - Circle Center 에서 뻗어나가는 원의 반경입니다.

Space Between

사이 여백 - 원의 외부 에지에 생성되는 아이템 사이의 (cm 단위) 여백입니다.

Arc Direction

원호 방향 - 컨텍스트의 회전 또는 두 위치 사이에 형성된 벡터를 기반으로 원호를 한 방향으로 집중시킬 수 있도록 해 줍니다.

Arc Angle

원호 각도 - 도 단위로 측정한 원호 각도입니다.

Circle Center

원 중심 - 원의 중심으로 사용되는 컨텍스트입니다.

Trace Data

트레이스 데이터 - 사용할 트레이스 유형입니다.

Projection Data

투영 데이터 - 결과 아이템을 내비메시에 투영시킬지(, 어느 내비메시 데이터 세트를 사용할지) 입니다.

Pathing Grid

그리드와 비슷하지만, 내비메시의 각기 다른 지점으로의 길찾기를 통해 거리가 Max Distance 이하인 아이템만 반환합니다.

gen_pathing.png

gen_pathing_props.png

프로퍼티

설명

Max Distance

최대 거리 - 질의자에서 어느 거리까지 길찾기를 할지 입니다.

Distance Between

사이 거리 - 생성되는 아이템 사이의 거리입니다.

Path to Item

아이템으로 길찾기 - 아이템에서 오고 가는 길찾기를 할것인지 입니다.

Generate Around

생성 중심 - 길찾기 그리드를 생성할 중심 컨텍스트입니다.

Navigation Filter

내비게이션 필터 - 사용할 내비게이션 필터입니다.

Simple Grid

질의자 중심으로 아이템 그리드를 생성합니다.

gen_grid.png

gen_grid_props.png

프로퍼티

설명

Grid Size

그리드 크기 - 생성할 아이템 그리드의 높이와 폭입니다.

Space Between

사이 여백 - 그리드 아이템 사이 거리입니다.

Generated Around

생성 중심 - 그리드 생성에 사용할 컨텍스트입니다.

Projected Data

투영된 데이터 - 그리드를 내비메시에 투영할지 입니다. 벽 안에 있거나 막힌 아이템을 내비메시로 되돌려놓는 것으로, 그리드 선이 내비메시 에지 너머에 있게 된다면 뭉텅이지게 될 수도 있습니다.

Tests

Distance

아이템과 선택된 Distance To 사이의 직접 거리를 반환합니다. Distance To 의 위치가 둘 이상인 경우, 각 거리 검사 결과를 평균냅니다.

test_dist.png

test_dist_props.png

프로퍼티

설명

Test Mode

테스트 모드 - 거리 검사를 3D 에서 할지, 2D XY 면으로 할지, Z 축으로만 할지 입니다.

Distance To

거리 대상 - 거리를 측정하는 데 사용할 컨텍스트입니다.

Test Purpose

테스트 용도 - 테스트가 결과를 필터, 스코어, 또는 필터/스코어 할지 입니다. 필터는 테스트에 실패하는 아이템을 제거하고, 스코어는 아이템을 가중시킵니다.

Filter Type

필터 유형 - 필터 유형을 최소, 최대, 또는 값 범위로 변경합니다. Float Value Min 및/또는 Float Value Max 에 설정된 값 이외의 값은 걸러집니다.

Float Value Min

플로트 값 최소 - 이 값 이하의 값은 필터링합니다.

Float Value Max

플로트 값 최대 - 이 값 이상의 값은 필터링합니다.

Clamping

클램핑 - 값이 필터링되지 않은 경우, 테스트의 영향력을 제한하도록 할 수 있습니다. 이 기능을 켜려면 Clamp Min/Max Type 프로퍼티를 변경하세요.

Clamp Min Type

클램프 최소 유형 - 스코어 공식 적용 전 원본 테스트 값의 정규화 하한값을 어떻게 결정할지 입니다. 검색된 최저값을 사용할지, 필터링 하한값을 낮출지, 아니면 지정된 정규화 최소치를 분리할지 입니다.

Clamp Max Type

클램프 최대 유형 - 스코어 공식 적용 전 원본 테스트 값의 정규화 상한값을 어떻게 결정할지 입니다. 검색된 최고값을 사용할지, 필터링 상한값을 높일지, 지정된 정규화 최대치를 분리시킬지 입니다.

Scoring Equation

스코어 등식 - 커브를 따라갈 테스트의 스코어를 변경합니다. 상수, 선형, 제곱, 역선형 커브가 가능합니다.

Scoring Factor

스코어 인수 - 모든 테스트를 기준으로 이 테스트가 갖는 가중치입니다. 음수가 될 수 있습니다.

Dot

두 벡터의 내적을 계산합니다. 컨텍스트 로테이션, 또는 한 지점에서 다른 지점까지의 벡터가 될 수도 있습니다. 무언가가 다른 것을 향하고 있는지 알아낼 때 좋습니다.

test_dot.png

test_dot_props.png

프로퍼티

설명

Line A

Mode 가 Rotation 으로 설정된 경우:

프로퍼티

설명

Rotation

로테이션 - 로테이션 벡터 또는 선택된 컨텍스트를 반환합니다.

Mode 가 Two Points 로 설정된 경우:

프로퍼티

설명

Line From

이 컨텍스트의 위치를 벡터가 로테이션을 정의하는 첫 지점으로 사용합니다.

Line To

이 컨텍스트의 위치를 벡터가 로테이션을 정의하는 끝 지점으로 사용합니다.

Line B

Mode 가 Rotation 으로 설정된 경우:

프로퍼티

설명

Rotation

로테이션 - 로테이션 벡터 또는 선택된 컨텍스트를 반환합니다.

Mode 가 Two Points 로 설정된 경우:

프로퍼티

설명

Line From

이 컨텍스트의 위치를 벡터가 로테이션을 정의하는 첫 지점으로 사용합니다.

Line To

이 컨텍스트의 위치를 벡터가 로테이션을 정의하는 끝 지점으로 사용합니다.

Test Mode

테스트 모드 - 테스트가 완전한 3D 벡터를 사용해서 계산할지, 그냥 Line A 와 Line B 벡터의 2D 헤딩 벡터를 사용해서 계산할지 입니다.

Absolute Value

절대값 - Dot Product 는 -1.0 에서 1.0 사이의 값을 반환하는데, 이렇게 하면 테스트가 Dot Product 의 절대값을 반환합니다.

Test Purpose

테스트 용도 - 테스트가 결과를 필터, 스코어, 또는 필터/스코어 할지 입니다. 필터는 테스트에 실패하는 아이템을 제거하고, 스코어는 아이템을 가중시킵니다.

Filter Type

필터 유형 - 필터 유형을 최소, 최대, 또는 값 범위로 변경합니다. Float Value Min 및/또는 Float Value Max 에 설정된 값 이외의 값은 걸러집니다.

Float Value Min

플로트 값 최소 - 이 값 이하의 값은 필터링합니다.

Float Value Max

플로트 값 최대 - 이 값 이상의 값은 필터링합니다.

Clamping

클램핑 - 값이 필터링되지 않은 경우, 테스트의 영향력을 제한하도록 할 수 있습니다. 이 기능을 켜려면 Clamp Min/Max Type 프로퍼티를 변경하세요.

Clamp Min Type

클램프 최소 유형 - 스코어 공식 적용 전 원본 테스트 값의 정규화 하한값을 어떻게 결정할지 입니다. 검색된 최저값을 사용할지, 필터링 하한값을 낮출지, 아니면 지정된 정규화 최소치를 분리할지 입니다.

Clamp Max Type

클램프 최대 유형 - 스코어 공식 적용 전 원본 테스트 값의 정규화 상한값을 어떻게 결정할지 입니다. 검색된 최고값을 사용할지, 필터링 상한값을 높일지, 지정된 정규화 최대치를 분리시킬지 입니다.

Scoring Equation

스코어 등식 - 커브를 따라갈 테스트의 스코어를 변경합니다. 상수, 선형, 제곱, 역선형 커브가 가능합니다.

Scoring Factor

스코어 인수 - 모든 테스트를 기준으로 이 테스트가 갖는 가중치입니다. 음수가 될 수 있습니다.

Gameplay Tags

test_tags.png

test_tags_props.png

프로퍼티

설명

Tags to Match

일치시킬 태그 - Gameplay Tags 프로퍼티의 태그 Any (일부) 또는 All (전부) 를 일치시킬지 입니다. 기본적으로 or 또는 and 문입니다.

Gameplay Tags

게임플레이 태그 - 일치시킬 태그입니다.

Test Purpose

테스트 용도 - 테스트가 결과를 필터, 스코어, 또는 필터/스코어 할지 입니다. 필터는 테스트에 실패하는 아이템을 제거하고, 스코어는 아이템을 가중시킵니다.

Bool Match

부울 일치 - 본질적으로 원하는 것이 True 일치인가 또는 False 일치인가 입니다. 아이템에 원하는 태그가 있다고 반환된 경우, 이를 통해 유지하는 대신 제거 하는 것이 가능합니다.

Scoring Factor

스코어 인수 - 모든 테스트를 기준으로 이 테스트가 갖는 가중치입니다. 음수가 될 수 있습니다.

Path Finding

test_path.png

test_path_props.png

프로퍼티

설명

Test Mode

Path Exist

경로 존재 - 컨텍스트 로/에서의 경로가 존재하는지 입니다.

Path Cost

경로 비용 - 컨텍스트 로/에서의 경로가 얼마나 비싼지 입니다.

Path Length

경로 길이 - 컨텍스트 로/에서의 경로가 얼마나 긴지 입니다.

Context

컨텍스트 - 길찾기에 오고갈 컨텍스트 입니다.

Path From Context

컨텍스트에서 길찾기 - 길찾기가 컨텍스트에서 오는 쪽으로 이동하도록 할 것인지 입니다.

Skip Unreachable

도달불가 생략 - 도달 불가능한 아이템을 필터링합니다.

Use Hierarchical Pathfinding

계층구조식 길찾기 사용 - 정확도는 떨어지지만 더욱 빠른 계층구조식 길찾기를 사용할 것인지 입니다.

Test Purpose

테스트 용도 - 테스트가 결과를 필터, 스코어, 또는 필터/스코어 할지 입니다. 필터는 테스트에 실패하는 아이템을 제거하고, 스코어는 아이템을 가중시킵니다.

Filter Type

필터 유형 - 필터 유형을 최소, 최대, 또는 값 범위로 변경합니다. Float Value Min 및/또는 Float Value Max 에 설정된 값 이외의 값은 걸러집니다.

Float Value Min

플로트 값 최소 - 이 값 이하의 값은 필터링합니다.

Float Value Max

플로트 값 최대 - 이 값 이상의 값은 필터링합니다.

Clamping

클램핑 - 값이 필터링되지 않은 경우, 테스트의 영향력을 제한하도록 할 수 있습니다. 이 기능을 켜려면 Clamp Min/Max Type 프로퍼티를 변경하세요.

Clamp Min Type

클램프 최소 유형 - 스코어 공식 적용 전 원본 테스트 값의 정규화 하한값을 어떻게 결정할지 입니다. 검색된 최저값을 사용할지, 필터링 하한값을 낮출지, 아니면 지정된 정규화 최소치를 분리할지 입니다.

Clamp Max Type

클램프 최대 유형 - 스코어 공식 적용 전 원본 테스트 값의 정규화 상한값을 어떻게 결정할지 입니다. 검색된 최고값을 사용할지, 필터링 상한값을 높일지, 지정된 정규화 최대치를 분리시킬지 입니다.

Scoring Equation

스코어 등식 - 커브를 따라갈 테스트의 스코어를 변경합니다. 상수, 선형, 제곱, 역선형 커브가 가능합니다.

Scoring Factor

스코어 인수 - 모든 테스트를 기준으로 이 테스트가 갖는 가중치입니다. 음수가 될 수 있습니다.

Random

테스트라기 보다는 (아이템을 임의로 필터링하는 데 사용할 수 있기는 하지만), AI 의 의사결정에 약간의 모호함을 더하기 위해서 아이템의 가중치를 변경하기 위한 방편입니다. 0.0 에서 1.0 사이의 값을 생성합니다.

test_rand.png

test_rand_props.png

프로퍼티

설명

Test Purpose

테스트 용도 - 테스트가 결과를 필터, 스코어, 또는 필터/스코어 할지 입니다. 필터는 테스트에 실패하는 아이템을 제거하고, 스코어는 아이템을 가중시킵니다.

Filter Type

필터 유형 - 필터 유형을 최소, 최대, 또는 값 범위로 변경합니다. Float Value Min 및/또는 Float Value Max 에 설정된 값 이외의 값은 걸러집니다.

Float Value Min

플로트 값 최소 - 이 값 이하의 값은 필터링합니다.

Float Value Max

플로트 값 최대 - 이 값 이상의 값은 필터링합니다.

Clamping

클램핑 - 값이 필터링되지 않은 경우, 테스트의 영향력을 제한하도록 할 수 있습니다. 이 기능을 켜려면 Clamp Min/Max Type 프로퍼티를 변경하세요.

Clamp Min Type

클램프 최소 유형 - 스코어 공식 적용 전 원본 테스트 값의 정규화 하한값을 어떻게 결정할지 입니다. 검색된 최저값을 사용할지, 필터링 하한값을 낮출지, 아니면 지정된 정규화 최소치를 분리할지 입니다.

Clamp Max Type

클램프 최대 유형 - 스코어 공식 적용 전 원본 테스트 값의 정규화 상한값을 어떻게 결정할지 입니다. 검색된 최고값을 사용할지, 필터링 상한값을 높일지, 지정된 정규화 최대치를 분리시킬지 입니다.

Scoring Equation

스코어 등식 - 커브를 따라갈 테스트의 스코어를 변경합니다. 상수, 선형, 제곱, 역선형 커브가 가능합니다.

Scoring Factor

스코어 인수 - 모든 테스트를 기준으로 이 테스트가 갖는 가중치입니다. 음수가 될 수 있습니다.

Trace

아이템으로, 또는 아이템에서 컨텍스트로 트레이스한 다음 히트 여부를 반환합니다. Bool Match 프로퍼티를 통해 결과를 반전시킬 수 있습니다.

test_vis.png

test_vis_props.png

프로퍼티

설명

Trace Data

Trance Channel

트레이스 채널 - 테스트 대상 채널로, 언리얼 엔진 4 에는 기본적으로 Visibility 와 Camera 가 있습니다. 트레이스 채널은 편집 메뉴 -> 프로젝트 세팅 -> 피직스 -> 트레이스 채널 에서 조절 가능합니다.

Trace Shape

트레이스 셰이프 - 선, 구체, 박스, 캡슐 입니다.

Trace Complex

트레이스 컴플렉스 - 트레이스 대상이 메시 (컴플렉스, 복잡)인지 그냥 심플 (단순) 콜리전인지 입니다.

Only Blocking Hits

블로킹만 히트 - 트레이스 결과에 블로킹 트레이스를 쓸것인지 블로킹하지 않는 트레이스를 쓸것인지 입니다.

Trace From Context

컨텍스트에서 트레이스 - 어디서부터 트레이스를 할 것인지에 대한 컨텍스트로, Querier, Item, 또는 생성한 Custom Context 가 될 수 있습니다.

Context

Item Height Offset

아이템 높이 오프셋 - 테스트 트레이스가 오고 가는 아이템에 Z 오프셋을 cm 단위로 추가합니다.

Context Height Offset

컨텍스트 높이 오프셋 - 테스트 트레이스가 오고 가는 컨텍스트에 Z 오프셋을 cm 단위로 추가합니다.

Test Purpose

테스트 용도 - 테스트가 결과를 필터, 스코어, 또는 필터/스코어 할지 입니다. 필터는 테스트에 실패하는 아이템을 제거하고, 스코어는 아이템을 가중시킵니다.

Filter Type

필터 유형 - 필터 유형을 최소, 최대, 또는 값 범위로 변경합니다. Float Value Min 및/또는 Float Value Max 에 설정된 값 이외의 값은 걸러집니다.

Float Value Min

플로트 값 최소 - 이 값 이하의 값은 필터링합니다.

Float Value Max

플로트 값 최대 - 이 값 이상의 값은 필터링합니다.

Clamping

클램핑 - 값이 필터링되지 않은 경우, 테스트의 영향력을 제한하도록 할 수 있습니다. 이 기능을 켜려면 Clamp Min/Max Type 프로퍼티를 변경하세요.

Clamp Min Type

클램프 최소 유형 - 스코어 공식 적용 전 원본 테스트 값의 정규화 하한값을 어떻게 결정할지 입니다. 검색된 최저값을 사용할지, 필터링 하한값을 낮출지, 아니면 지정된 정규화 최소치를 분리할지 입니다.

Clamp Max Type

클램프 최대 유형 - 스코어 공식 적용 전 원본 테스트 값의 정규화 상한값을 어떻게 결정할지 입니다. 검색된 최고값을 사용할지, 필터링 상한값을 높일지, 지정된 정규화 최대치를 분리시킬지 입니다.

Scoring Equation

스코어 등식 - 커브를 따라갈 테스트의 스코어를 변경합니다. 상수, 선형, 제곱, 역선형 커브가 가능합니다.

Scoring Factor

스코어 인수 - 모든 테스트를 기준으로 이 테스트가 갖는 가중치입니다. 음수가 될 수 있습니다.

Contexts

Context, 컨텍스트는 실제 노드는 아니지만 인바이런먼트 쿼리 작업방식에 중요한 부분을 차지하므로 여기에 참고삼아 나열합니다.

EnvQueryContext_Item

Item, 아이템은 제너레이터에 의해 생성되는 것입니다. 가장 단순하게, EQS Testing Pawn 을 사용한다면, 에디터에서 구체로 표시되는 것입니다.

EnvQueryContext_Querier

Querier, 질의자는 현재 이 인바이런먼트 쿼리에서 호출된 비헤이비어 트리를 실행하는 AI 컨트롤러에 의해 소유된 Pawn 입니다.

새로운 언리얼 엔진 4 문서 사이트에 오신 것을 환영합니다!

문서 사이트에 대한 의견을 모을 수 있는 피드백 시스템을 포함해서 여러가지 새로운 기능을 준비하고 있습니다. 아래 Documentation Feedback 포럼(영문) 또는 언리얼 엔진 네이버 공식 카페(한글) 중 편하신 곳에 의견이나 문제점을 알려 주세요.

새 시스템이 준비되면 알려 드리겠습니다.

네이버 카페
공식 포럼