Open 3D Engine AzFramework API Reference
24.09
O3DE is an open-source, fully-featured, high-fidelity, modular 3D engine for building games and simulations, available to every industry.
|
#include <InputContext.h>
Inherits AzFramework::InputDevice, and AzFramework::InputChannelEventListener.
Classes | |
struct | InitData |
Custom data struct used to initialize input contexts. More... | |
Public Member Functions | |
AZ_CLASS_ALLOCATOR (InputContext, AZ::SystemAllocator) | |
AZ_RTTI (InputContext, "{D17A85B2-405F-40AB-BBA7-F118256D39AB}", InputDevice) | |
InputContext (const char *name) | |
InputContext (const char *name, const InitData &initData) | |
AZ_DISABLE_COPY_MOVE (InputContext) | |
~InputContext () override | |
Destructor. | |
void | Activate () |
Activate the input context (this just calls the base InputChannelEventListener::Connect) | |
void | Deactivate () |
Deactivate the input context (this just calls the base InputChannelEventListener::Disconnect) | |
bool | AddInputMapping (AZStd::shared_ptr< InputMapping > inputMapping) |
bool | RemoveInputMapping (const InputChannelId &inputMappingId) |
Public Member Functions inherited from AzFramework::InputDevice | |
AZ_CLASS_ALLOCATOR (InputDevice, AZ::SystemAllocator) | |
AZ_RTTI (InputDevice, "{29F9FB6B-15CB-4DB4-9F36-DE7396B82F3D}") | |
InputDevice (const InputDeviceId &inputDeviceId) | |
AZ_DISABLE_COPY_MOVE (InputDevice) | |
~InputDevice () override | |
Destructor. | |
const InputDevice * | GetInputDevice () const final |
AzFramework::InputDeviceRequests::GetInputDevice | |
const InputDeviceId & | GetInputDeviceId () const |
virtual LocalUserId | GetAssignedLocalUserId () const |
virtual void | PromptLocalUserSignIn () const |
Public Member Functions inherited from AzFramework::InputChannelEventListener | |
InputChannelEventListener () | |
Constructor. | |
InputChannelEventListener (bool autoConnect) | |
InputChannelEventListener (AZ::s32 priority) | |
InputChannelEventListener (AZ::s32 priority, bool autoConnect) | |
InputChannelEventListener (AZStd::shared_ptr< InputChannelEventFilter > filter) | |
InputChannelEventListener (AZStd::shared_ptr< InputChannelEventFilter > filter, AZ::s32 priority) | |
InputChannelEventListener (AZStd::shared_ptr< InputChannelEventFilter > filter, AZ::s32 priority, bool autoConnect) | |
AZ_DEFAULT_COPY (InputChannelEventListener) | |
~InputChannelEventListener () override=default | |
Default destructor. | |
AZ::s32 | GetPriority () const override |
AzFramework::InputChannelNotifications::GetPriority | |
void | SetFilter (AZStd::shared_ptr< InputChannelEventFilter > filter) |
void | Connect () |
Connect to the input notification bus to start receiving input notifications. | |
void | Disconnect () |
Disconnect from the input notification bus to stop receiving input notifications. | |
Protected Member Functions | |
const InputChannelByIdMap & | GetInputChannelsById () const override |
AzFramework::InputDevice::GetInputChannelsById | |
bool | IsSupported () const override |
AzFramework::InputDevice::IsSupported | |
bool | IsConnected () const override |
AzFramework::InputDevice::IsConnected | |
void | TickInputDevice () override |
AzFramework::InputDeviceRequests::TickInputDevice | |
bool | OnInputChannelEventFiltered (const InputChannel &inputChannel) override |
AzFramework::InputChannelEventListener::OnInputChannelEventFiltered | |
Protected Member Functions inherited from AzFramework::InputDevice | |
void | BroadcastInputChannelEvent (const InputChannel &inputChannel) const |
void | BroadcastInputTextEvent (const AZStd::string &textUTF8) const |
void | BroadcastInputDeviceConnectedEvent () const |
Broadcast an event when the input device connects to the system. | |
void | BroadcastInputDeviceDisconnectedEvent () const |
Broadcast an event when the input device disconnects from the system. | |
void | ResetInputChannelStates () |
Reset the state of all this input device's associated input channels. | |
Protected Member Functions inherited from AzFramework::InputChannelEventListener | |
void | OnInputChannelEvent (const InputChannel &inputChannel, bool &o_hasBeenConsumed) final |
AzFramework::InputChannelNotifications::OnInputChannelEvent | |
Additional Inherited Members | |
Static Public Member Functions inherited from AzFramework::InputDevice | |
static void | Reflect (AZ::ReflectContext *context) |
Static Public Member Functions inherited from AzFramework::InputChannelEventListener | |
static AZ::s32 | GetPriorityFirst () |
static AZ::s32 | GetPriorityDebug () |
static AZ::s32 | GetPriorityDebugUI () |
static AZ::s32 | GetPriorityUI () |
static AZ::s32 | GetPriorityDefault () |
static AZ::s32 | GetPriorityLast () |
An InputContext is an InputEventListener that owns a collection of InputMapping objects and forwards input events to them. By inheriting from InputEventListener the InputContext gains access to the same priority and 'consumed' systems that all other input event listeners use, meaning they can be interleaved with any other engine / gameplay system that consumes input. InputContext also inherits from InputDevice, which while unintuitive is necessary for input mapping instances that need to be created by passing a reference to the parent input device.
|
explicit |
Constructor
[in] | name | Unique, will be truncated if exceeds InputDeviceId::MAX_NAME_LENGTH = 64 |
AzFramework::InputContext::InputContext | ( | const char * | name, |
const InitData & | initData | ||
) |
Constructor
[in] | name | Unique, will be truncated if exceeds InputDeviceId::MAX_NAME_LENGTH = 64 |
[in] | initData | Custom data struct used to initialize the input context |
bool AzFramework::InputContext::AddInputMapping | ( | AZStd::shared_ptr< InputMapping > | inputMapping | ) |
Add an input mapping to this input context (the input context will share ownership of it)
[in] | inputMapping | Shared pointer to the input mapping to add to this input context |
bool AzFramework::InputContext::RemoveInputMapping | ( | const InputChannelId & | inputMappingId | ) |
Remove an input mapping from this input context (the shared ownership will be released)
[in] | inputMappingId | The id of the input mapping to remove from this input context |