UnrealInput

Clear·2025년 3월 6일

EPortfolio docs

EnhancedInput

Unreal Engine 의 Input 을 대체하여 나온 새로운 InputSystem 으로
5.1 부터는 EnhancedInput 이 기본 설정되어 있다.

  • EnhancedInput 의 핵심
    • Input Action 입력 액션
    • Input Mapping Contexts 입력 매핑 컨텍스트
    • Input Modifiers 입력 모디파이어
    • Input Triggers 입력 트리거

UEnhancedInputLocalPlayerSubsystem

Unreal Engine 5에서 Enhanced Input System을 관리하는 핵심 서브시스템입니다.


	UFUNCTION(BlueprintCallable, BlueprintCosmetic, Category = "Input", meta=(AutoCreateRefTerm = "Options"))
	virtual void AddMappingContext(const UInputMappingContext* MappingContext, int32 Priority, const FModifyContextOptions& Options = FModifyContextOptions());

UInputMappingContext를 Subsytem에 추가합니다.
Parameter

  • MappingContext
    추가할 UInputMappingContext
  • Priority
    입력 우선순위 숫자가 높을수록 우선 적용

Input Action

  • ConsumeInput
    동일한 키로 발생하는 다른 액션을 차단 할지 여부를 지정한다.
    true 설정시 동리한 키로 발생하는 우선순위가 낮은 다른 입력 액션이 발생하지 않는다.

  • Trigger When Paused
    게임이 일시 정지 상태에서도 입력 액션을 발생시킬지 여부를 지정한다.

  • Reverse All Mappings
    동일한 키로 입력이 발생할 경우 더 높은 우선순위의 입력 액션을 발생시킬지 여부를 지정한다.

  • Value Type
    입력 액션의 값 타입을 지정한다.
    • Digital(bool)
      바이너리 상태를 갖는 입력 액션에 사용된다.
    • Axis1D(float)
      1차원의 스칼라 상태를 갖는 입력 액션에 사용된다.
    • Axis2D(Vector2D)
      2차원의 스칼라 상태를 갖는 입력 액션에 사용된다.
    • Axis3D(Vector3D)
      3차원의 스칼라 상태를 갖는 입력 액션에 사용된다.

InputMapping Context

입력 액션과 입력 액션을 실행할 키를 지정한다.
입력 액션의 트리거와 모디파이어를 수정하는 일반적인 방법은 여기에서 진행한다.

Triggers

입력 액션을 실행할 키 이벤트를 지정한다.

  • Chorded Action
    지정된 다른 액션이 발생하는 한 이 입력 액션도 발생한다.
  • Down
    키가 동작 임계값을 초과하는 모든 프레임에 입력 액션이 발생한다,.
  • Hold
    지정된 시간 동안 동작 임계값을 초과하면 입력 액션이 발생한다.
  • Hold and Release
    키 입력이 지정된 시간 동안 동작 임계값을 초과한 다음 해당 임계값을 다시 초과하지 않게되면 입력 액션이 발생한다.
  • Pressed
    키 입력이 동작 임계값을 초과하면 입력 액션이 발생하며, 키 입력이 해제 될 떄 까지 다시 발생하지 않는다.
  • Pulse
    키 입력이 임계값을 초과하는 한 지정한 간격으로 계속해서 입력이 발생한다.
    첫 번째 펄스가 입력 액션을 발생시킬지 여부와 호출 가능한 최대 횟수를 지정할 수 있다.
  • Released
    키 입력이 임계값을 초과하지 않으면 입력 액션이 발생하지 않으며, 키가 동작 임계값을 초과한 후에 키 누르밍 해제 될 떄 입력액션이 발생한다.
  • Tab
    키 입력이 동작 임계값을 초과한 후, 지정된 시간 안에 키를 눌렀다가 해제하면 입력 액션이 발생한다.

Modifiers

입력 액션을 수정하는 방법을 지정한다.

  • Dead Zone
    키의 입력이 하한 값보다 낮으면 0으로 인식하고 상한 값보다 높으면 1로 인식한다.
  • FOV Scaling
    키의 입력 값이 시야각과 함꼐 조정된다.
    시야각이 증가하면 키의 입력 값도 증가하고 시야각이 줄어들면 키 입력 값도 함께 줄어든다.
  • Modifier Collection
    지정된 모디파이어의 목록에 따라 키의 입력이 수정된다.
  • Negate
    키의 입력이 반전된다.
  • Response Curve - Exponential
    지수형 커브가 키 입력에 적용된다.
  • Response Curve - Use Defined
    사용자가 지정한 곡선이 키 입력에 적용된다.
  • Scalar
    입력 키의 각 축에 지정한 스칼라에 따라 입력 값이 조정된다.
  • Smooth
    키의 입력 값이 여러 프레임에 걸쳐 부드럽게 조정된다.
  • Swizzle Input Axis Values
    키 입력의 순서를 변경할 수 있다.
  • To World Space
    키 입력 축이 월드 공간으로 변환 된다.

ETriggerEvent

  • None
    중요한 트리거 상태 변경이 발생하지 않았으며 활성 장치 입력이 없음을 나타낸다. 이 상태는 작업이 트리거되지 않음을 의미한다.
  • Triggered
    트리거 평가가 시작된 이벤트가 발생했음을 의미한다. Started 이벤트는 Triggered이벤트와 동일한 프레임에서 발생할 수도 있지만 항상 Started가 먼저 시작된다.
  • Started
    트리거 평가가 시작되면 시작된다. 즉, 액션 트리거의 시작이다.
  • Ongoing
    트리거가 아직 평가 중임을 의미한다. 작업의 트리거가 여전히 발생하고 있음을 나타내는 데 사용된다.
  • Canceled
    이 상태는 트리거 평가가 취소되었을 때 사용된다. 이는 작업의 트리거가 완료되기 전에 중지 되었음을 의미한다.
  • Completed
    이 상태는 이 프레임에서 Triggered 상태가 에서 None 으로 전환되었d음을 나타낸다. 즉, 트리거 평가가 완료되 었음을 의미한다.
profile
Programmer

0개의 댓글