VrchStudio-comfyui-web-viewer/docs/logic_nodes.md

### Node: `INT Remap @ vrch.ai` (vrch.ai/logic)

1. **Add the `INT Remap @ vrch.ai` node to your ComfyUI workflow.**

2. **Configure the Node:**
   - **Optional Input:**
     - **`input`**: The integer value to remap. Connect an INT input or leave unconnected for the default.
   - **Required Parameters:**
     - **`input_min`**: Minimum of the input range (default: 0).
     - **`input_max`**: Maximum of the input range (default: 1).
     - **`output_min`**: Minimum of the output range (default: 0).
     - **`output_max`**: Maximum of the output range (default: 100).
     - **`output_invert`**: Toggle to invert the mapping (default: False).
     - **`output_default`**: Default output if mapping fails (default: 0).

3. **Remapping Behavior:**
   - Ensures `input_min <= input_max` and `output_min <= output_max`, otherwise raises an error.
   - Maps the input proportionally from the input range to the output range.
   - Clamps the result within `[output_min, output_max]` and casts to INT.
   - On any exception, outputs `output_default`.

4. **Node Output:**
   - **Output (INT):** The remapped integer value.

---

### Node: `FLOAT Remap @ vrch.ai` (vrch.ai/logic)

1. **Add the `FLOAT Remap @ vrch.ai` node to your ComfyUI workflow.**

2. **Configure the Node:**
   - **Optional Input:**
     - **`input`**: The float value to remap. Connect a FLOAT input or leave unconnected for the default.
   - **Required Parameters:**
     - **`input_min`**: Minimum of the input range (default: 0.0).
     - **`input_max`**: Maximum of the input range (default: 1.0).
     - **`output_min`**: Minimum of the output range (default: 0.0).
     - **`output_max`**: Maximum of the output range (default: 100.0).
     - **`output_invert`**: Toggle to invert the mapping (default: False).
     - **`output_default`**: Default output if mapping fails (default: 0.0).

3. **Remapping Behavior:**
   - Validates ranges (`input_min <= input_max` and `output_min <= output_max`).
   - Maps the input proportionally, clamps to `[output_min, output_max]`.
   - Returns a FLOAT. On error, outputs `output_default`.

4. **Node Output:**
   - **Output (FLOAT):** The remapped float value.

---

### Node: `Trigger Toggle @ vrch.ai` (vrch.ai/logic)

1. **Add the `Trigger Toggle @ vrch.ai` node to your ComfyUI workflow.**

2. **Configure the Node:**
   - **Optional Input:**
     - **`trigger`**: BOOLEAN trigger input; toggles state when True.
   - **Required Parameters:**
     - **`initial_state`**: Starting boolean state (default: False).
     - **`debug`**: Enable console logging of transitions (default: False).

3. **Toggle Behavior:**
   - If `initial_state` changes, resets the internal state accordingly.
   - On each True `trigger` event, flips the current state.
   - If `debug` is enabled, prints trigger, initial, and current states.

4. **Node Output:**
   - **Output (BOOLEAN):** The current toggle state.
   - **JSON (JSON):** A JSON object containing `trigger`, `initial_state`, and `current_state`.

5. **Visual Indicators:**
   - Displays a non‑clickable circular indicator in the UI reflecting the current state.

---

### Node: `Trigger Toggle x4 @ vrch.ai` (vrch.ai/logic)

1. **Add the `Trigger Toggle x4 @ vrch.ai` node to your ComfyUI workflow.**

2. **Configure the Node:**
   - **Optional Inputs:**
     - **`trigger1`**, **`trigger2`**, **`trigger3`**, **`trigger4`**: Four BOOLEAN triggers.
   - **Required Parameters:**
     - **`initial_state1`** … **`initial_state4`**: Four starting states (default: False).
     - **`debug`**: Enable console logging (default: False).

3. **Toggle Behavior:**
   - Resets each channel when its initial state changes.
   - Toggles individual channel states on corresponding triggers.
   - Builds a JSON summary of all four channels.
   - If `debug` is enabled, prints the JSON summary.

4. **Node Outputs:**
   - **Output1–Output4 (BOOLEAN):** Current states for each channel.
   - **JSON (JSON):** JSON object grouping triggers, initial, and current states for all channels.

5. **Visual Indicators:**
   - Renders four non‑clickable circular indicators in the UI, one per channel, showing each current state.

---

### Node: `Trigger Toggle x8 @ vrch.ai` (vrch.ai/logic)

1. **Add the `Trigger Toggle x8 @ vrch.ai` node to your ComfyUI workflow.**

2. **Configure the Node:**
   - **Optional Inputs:**
     - **`trigger1` … `trigger8`**: Eight BOOLEAN triggers.
   - **Required Parameters:**
     - **`initial_state1` … `initial_state8`**: Eight starting states (default: False).
     - **`debug`**: Enable console logging (default: False).

3. **Toggle Behavior:**
   - Resets each channel on initial state change.
   - Toggles individual states on corresponding triggers.
   - Builds a JSON summary of all eight channels.
   - If `debug` is enabled, prints the JSON summary.

4. **Node Outputs:**
   - **Output1–Output8 (BOOLEAN):** Current states for each channel.
   - **JSON (JSON):** JSON object grouping triggers, initial, and current states for all channels.

5. **Visual Indicators:**
   - Renders eight non‑clickable circular indicators in the UI, one per channel, showing each current state.

---

### Node: `Delay @ vrch.ai` (vrch.ai/logic)

1. **Add the `Delay @ vrch.ai` node to your ComfyUI workflow.**

2. **Configure the Node:**
   - **Input:**
     - **`any_input`**: Connect any type of input that you want to delay.
   - **Parameters:**
     - **`delay_ms`**: Delay period in milliseconds (integer, default is `0`, range `0` to `10000`).
     - **`debug`**: Enable debug mode to print detailed logs (default is `False`).

3. **Delay Behavior:**
   - The node delays the passing of its input by the specified `delay_ms` value.
   - Uses `time.sleep()` to synchronously pause the workflow for the specified duration.
   - After the delay completes, it passes the original input to the output.

4. **Node Output:**
   - **`ANY_OUTPUT`**: The delayed input (same type and value as `any_input`).

**Note:**
- **Blocking Behavior**: The node uses `time.sleep` to synchronously pause the workflow. Use reasonable delay periods to avoid making the interface unresponsive.
- **Debug Mode**: When enabled, prints messages about the delay process.
- **Error Handling**: If any exception occurs during the delay, the node will log the error if debug is enabled, but will still attempt to output the input value.
- **Use Cases**: Useful for introducing timing delays in animations, creating sequential effects, or synchronizing operations that need specific timing.

---

### Node: `QR Code Generator @ vrch.ai` (vrch.ai/logic)

1. **Add the `QR Code Generator @ vrch.ai` node to your ComfyUI workflow.**

2. **Configure the Node:**
   - **Required Parameters:**
     - **`text`**: The text string to encode into a QR code (default: "Hello, World!"). Supports multiline text input.
     - **`size`**: The size of the generated QR code image in pixels (default: 256, range: 64-1024, step: 32).
     - **`error_correction`**: Error correction level - "L", "M", "Q", "H" (default: "M").
     - **`border`**: White border size around the QR code (default: 4, range: 0-20).
     - **`debug`**: Enable debug logging (default: False).

3. **QR Code Generation:**
   - Uses Python's `qrcode` library for backend generation.
   - Automatically regenerates when any parameter changes.
   - Converts output to ComfyUI IMAGE tensor format.

4. **Node Output:**
   - **QR_CODE (IMAGE):** The generated QR code as a ComfyUI IMAGE tensor.

5. **Library Dependency:**
   - Requires `qrcode[pil]` Python package: `pip install qrcode[pil]`
   - Creates placeholder image with warning message if library is missing.

**Note:**
- **Error Correction Levels**: L (~7%), M (~15%), Q (~25%), H (~30%) - higher levels provide better reliability.
- **Debug Mode**: When enabled, prints generation details to Python console.
- **Use Cases**: Generate QR codes for URLs, contact info, or text messages that can be integrated with other image processing workflows.