Merge branch 'hash-checkers-keyboard' into 'main'

[REMIX-4642] [REMIX-4643] [REMIX-4643] Add components for detecting mesh hash, texture hash, and keyboard input

See merge request lightspeedrtx/dxvk-remix-nv!1735

Author: MarkEHenderson

documentation/components/KeyboardInput.md

@@ -0,0 +1,62 @@
+# Keyboard Input
+
+Checks the state of a keyboard key or key combination using the same format as RTX options\.
+
+## Component Information
+
+- **Name:** `KeyboardInput`
+- **UI Name:** Keyboard Input
+- **Version:** 1
+- **Categories:** Sense
+
+## Input Properties
+
+| Property | Display Name | Type | IO Type | Default Value | Optional |
+|----------|--------------|------|---------|---------------|----------|
+| keyString | Key String | String | Input | "A" | No | 
+
+### Key String
+
+The key combination string \(e\.g\., 'A', 'CTRL,A', 'SHIFT,SPACE'\)\. Supports key names and combinations like RTX options\.
+
+
+## State Properties
+
+| Property | Display Name | Type | IO Type | Default Value | Optional |
+|----------|--------------|------|---------|---------------|----------|
+| wasPressedLastFrame |  | Bool | State | false | No | 
+
+### 
+
+Internal state to track if the key was pressed in the previous frame\.
+
+
+## Output Properties
+
+| Property | Display Name | Type | IO Type | Default Value | Optional |
+|----------|--------------|------|---------|---------------|----------|
+| isPressed | Is Pressed | Bool | Output | false | No | 
+| wasJustPressed | Was Just Pressed | Bool | Output | false | No | 
+| wasClicked | Was Clicked | Bool | Output | false | No | 
+
+### Is Pressed
+
+True if the key combination is currently being pressed\.
+
+
+### Was Just Pressed
+
+True if the key combination was just pressed this frame\.
+
+
+### Was Clicked
+
+True for one frame after the key combination is released \(press then release cycle\)\.
+
+
+## Usage Notes
+
+This component is part of the RTX Remix graph system. It is intended for use in the Remix Toolkit and Runtime only.
+
+---
+[← Back to Component Index](index.md)

documentation/components/MeshHashChecker.md

@@ -0,0 +1,45 @@
+# Mesh Hash Checker
+
+Checks if a specific mesh hash was processed in the current frame\.
+
+## Component Information
+
+- **Name:** `MeshHashChecker`
+- **UI Name:** Mesh Hash Checker
+- **Version:** 1
+- **Categories:** Sense
+
+## Input Properties
+
+| Property | Display Name | Type | IO Type | Default Value | Optional |
+|----------|--------------|------|---------|---------------|----------|
+| meshHash | Mesh Hash | Uint64 | Input | 0 | No | 
+
+### Mesh Hash
+
+The mesh hash to check for usage in the current frame\.
+
+
+## Output Properties
+
+| Property | Display Name | Type | IO Type | Default Value | Optional |
+|----------|--------------|------|---------|---------------|----------|
+| isUsed | Is Used | Bool | Output | false | No | 
+| usageCount | Usage Count | Uint32 | Output | 0 | No | 
+
+### Is Used
+
+True if the mesh hash was used in the current frame\.
+
+
+### Usage Count
+
+Number of times the mesh hash was used in the current frame\.
+
+
+## Usage Notes
+
+This component is part of the RTX Remix graph system. It is intended for use in the Remix Toolkit and Runtime only.
+
+---
+[← Back to Component Index](index.md)

documentation/components/TextureHashChecker.md

@@ -0,0 +1,45 @@
+# Texture Hash Checker
+
+Checks if a specific hash was used for material replacement in the current frame\.
+
+## Component Information
+
+- **Name:** `TextureHashChecker`
+- **UI Name:** Texture Hash Checker
+- **Version:** 1
+- **Categories:** Sense
+
+## Input Properties
+
+| Property | Display Name | Type | IO Type | Default Value | Optional |
+|----------|--------------|------|---------|---------------|----------|
+| textureHash | Texture Hash | Uint64 | Input | 0 | No | 
+
+### Texture Hash
+
+The texture hash to check for usage in the current frame\.
+
+
+## Output Properties
+
+| Property | Display Name | Type | IO Type | Default Value | Optional |
+|----------|--------------|------|---------|---------------|----------|
+| isUsed | Is Used | Bool | Output | false | No | 
+| usageCount | Usage Count | Uint32 | Output | 0 | No | 
+
+### Is Used
+
+True if the texture hash was used in the current frame\.
+
+
+### Usage Count
+
+Number of times the texture hash was used in the current frame\.
+
+
+## Usage Notes
+
+This component is part of the RTX Remix graph system. It is intended for use in the Remix Toolkit and Runtime only.
+
+---
+[← Back to Component Index](index.md)

documentation/components/index.md

@@ -10,6 +10,9 @@ This documentation provides detailed information about all available components
 
 | Component | Description | Version |
 |-----------|-------------|---------|
+| [Texture Hash Checker](TextureHashChecker.md) | Checks if a specific hash was used for material replacement in the current frame\. | 1 |
+| [Keyboard Input](KeyboardInput.md) | Checks the state of a keyboard key or key combination using the same format as RTX options\. | 1 |
+| [Mesh Hash Checker](MeshHashChecker.md) | Checks if a specific mesh hash was processed in the current frame\. | 1 |
 | [Time](Time.md) | Outputs the time in seconds since the component was created\. Can be paused and speed\-adjusted\. | 1 |
 
 ### Logic
@@ -28,8 +31,8 @@ This documentation provides detailed information about all available components
 
 ## Statistics
 
-- **Total Components:** 5
-- **Categorized Components:** 5
+- **Total Components:** 8
+- **Categorized Components:** 8
 - **Categories:** 3
 
 ---

src/dxvk/rtx_render/graph/components/keyboard_input.h

@@ -0,0 +1,91 @@
+/*
+* Copyright (c) 2025, NVIDIA CORPORATION. All rights reserved.
+*
+* Permission is hereby granted, free of charge, to any person obtaining a
+* copy of this software and associated documentation files (the "Software"),
+* to deal in the Software without restriction, including without limitation
+* the rights to use, copy, modify, merge, publish, distribute, sublicense,
+* and/or sell copies of the Software, and to permit persons to whom the
+* Software is furnished to do so, subject to the following conditions:
+*
+* The above copyright notice and this permission notice shall be included in
+* all copies or substantial portions of the Software.
+*
+* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
+* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+* DEALINGS IN THE SOFTWARE.
+*/
+
+#pragma once
+
+#include "../rtx_graph_component_macros.h"
+#include "../../imgui/dxvk_imgui.h"
+#include "../../../util/util_keybind.h"
+#include "../../../util/config/config.h"
+
+namespace dxvk {
+namespace components {
+
+#define LIST_INPUTS(X) \
+  X(RtComponentPropertyType::String, std::string("A"), keyString, "Key String", "The key combination string (e.g., 'A', 'CTRL,A', 'SHIFT,SPACE'). Supports key names and combinations like RTX options.")
+
+#define LIST_STATES(X) \
+  X(RtComponentPropertyType::Bool, false, wasPressedLastFrame, "", "Internal state to track if the key was pressed in the previous frame.")
+
+#define LIST_OUTPUTS(X) \
+  X(RtComponentPropertyType::Bool, false, isPressed, "Is Pressed", "True if the key combination is currently being pressed.") \
+  X(RtComponentPropertyType::Bool, false, wasJustPressed, "Was Just Pressed", "True if the key combination was just pressed this frame.") \
+  X(RtComponentPropertyType::Bool, false, wasClicked, "Was Clicked", "True for one frame after the key combination is released (press then release cycle).")
+
+REMIX_COMPONENT( \
+  /* the Component name */ KeyboardInput, \
+  /* the UI name */        "Keyboard Input", \
+  /* the UI categories */  "Sense", \
+  /* the doc string */     "Checks the state of a keyboard key or key combination using the same format as RTX options.", \
+  /* the version number */ 1, \
+  LIST_INPUTS, LIST_STATES, LIST_OUTPUTS);
+
+#undef LIST_INPUTS
+#undef LIST_STATES
+#undef LIST_OUTPUTS
+
+void KeyboardInput::updateRange(const Rc<DxvkContext>& context, const size_t start, const size_t end) {
+  for (size_t i = start; i < end; i++) {
+    // Parse the key string into VirtualKeys
+    VirtualKeys virtualKeys;
+    const bool parseSuccess = Config::parseOptionValue(m_keyString[i], virtualKeys);
+    
+    if (parseSuccess && !virtualKeys.empty()) {
+      // Check if the key combination is currently pressed (continuous press)
+      const bool currentlyPressed = ImGUI::checkHotkeyState(virtualKeys, true);
+      
+      // Check if the key combination was just pressed this frame (single press)
+      const bool justPressed = ImGUI::checkHotkeyState(virtualKeys, false);
+      
+      // Check if the key was clicked (pressed last frame, released this frame)
+      const bool wasClicked = m_wasPressedLastFrame[i] && !currentlyPressed;
+      
+      // Update outputs
+      m_isPressed[i] = currentlyPressed;
+      m_wasJustPressed[i] = justPressed;
+      m_wasClicked[i] = wasClicked;
+      
+      // Update state for next frame
+      m_wasPressedLastFrame[i] = currentlyPressed;
+    } else {
+      ONCE(Logger::err(str::format("Failed to parse key string: '", m_keyString[i], "'")));
+      // Invalid key string - default to false
+      m_isPressed[i] = false;
+      m_wasJustPressed[i] = false;
+      m_wasClicked[i] = false;
+      m_wasPressedLastFrame[i] = false;
+    }
+  }
+}
+
+}  // namespace components
+}  // namespace dxvk

src/dxvk/rtx_render/graph/components/mesh_hash_checker.h

@@ -0,0 +1,71 @@
+/*
+* Copyright (c) 2025, NVIDIA CORPORATION. All rights reserved.
+*
+* Permission is hereby granted, free of charge, to any person obtaining a
+* copy of this software and associated documentation files (the "Software"),
+* to deal in the Software without restriction, including without limitation
+* the rights to use, copy, modify, merge, publish, distribute, sublicense,
+* and/or sell copies of the Software, and to permit persons to whom the
+* Software is furnished to do so, subject to the following conditions:
+*
+* The above copyright notice and this permission notice shall be included in
+* all copies or substantial portions of the Software.
+*
+* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
+* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+* DEALINGS IN THE SOFTWARE.
+*/
+
+#pragma once
+
+#include "../rtx_graph_component_macros.h"
+#include "../../rtx_scene_manager.h"
+
+namespace dxvk {
+namespace components {
+
+#define LIST_INPUTS(X) \
+  X(RtComponentPropertyType::Uint64, 0, meshHash, "Mesh Hash", "The mesh hash to check for usage in the current frame.")
+
+#define LIST_STATES(X)
+
+#define LIST_OUTPUTS(X) \
+  X(RtComponentPropertyType::Bool, false, isUsed, "Is Used", "True if the mesh hash was used in the current frame.") \
+  X(RtComponentPropertyType::Uint32, 0, usageCount, "Usage Count", "Number of times the mesh hash was used in the current frame.")
+
+REMIX_COMPONENT( \
+  /* the Component name */ MeshHashChecker, \
+  /* the UI name */        "Mesh Hash Checker", \
+  /* the UI categories */  "Sense", \
+  /* the doc string */     "Checks if a specific mesh hash was processed in the current frame.", \
+  /* the version number */ 1, \
+  LIST_INPUTS, LIST_STATES, LIST_OUTPUTS);
+
+#undef LIST_INPUTS
+#undef LIST_STATES
+#undef LIST_OUTPUTS
+
+void MeshHashChecker::updateRange(const Rc<DxvkContext>& context, const size_t start, const size_t end) {
+  // Get the scene manager from context
+  RtxContext* rtxContext = dynamic_cast<RtxContext*>(context.ptr());
+  assert(rtxContext != nullptr && "Components must be run within a valid RtxContext.");
+  const SceneManager& sceneManager = rtxContext->getSceneManager();
+  
+  for (size_t i = start; i < end; i++) {
+    const uint64_t targetHash = m_meshHash[i];
+    
+    // Check if the mesh hash was used in the current frame
+    uint32_t count = sceneManager.getMeshHashUsageCount(targetHash);
+    bool isUsed = count > 0;
+    
+    m_isUsed[i] = isUsed;
+    m_usageCount[i] = count;
+  }
+}
+
+}  // namespace components
+}  // namespace dxvk