ReActorOptions Node Documentation

Overview

The ReActorOptions node is a configurable node designed for use in the ComfyUI interface as part of the ComfyUI-ReActor extension. This node allows users to set and manage various options related to face swapping, specifically controlling the order and preference of faces and gender detection in both input and source images. It is a supportive node used to customize and optimize the performance of face-swapping operations within workflows.

Features

The ReActorOptions node offers the following capabilities to enhance face-swapping operations:

• Face Order Control: Define the order for processing faces in input and source images based on spatial arrangements (e.g., left-to-right, top-to-bottom) and size considerations.
• Face and Gender Indexing: Specify which faces in input and source images to prioritize using comma-separated index values.
• Gender Detection: Set gender detection preferences to ensure that the face swap respects gender boundaries according to the user-defined criteria.
• Console Log Level: Adjust the level of information output to the console for debugging or informational purposes.

Input Parameters

The ReActorOptions node accepts the following inputs:

1. Input Faces Order:

   • A selection parameter to determine the order in which faces from the input image are processed. Options include:
     • Left-Right
     • Right-Left
     • Top-Bottom
     • Bottom-Top
     • Small-Large
     • Large-Small

2. Input Faces Index:

   • A string specifying face indexes from the input image in a comma-separated format.
   • Default: "0"

3. Detect Gender Input:

   • A choice to enable gender detection for faces in input images, with options:
     • No
     • Female
     • Male

4. Source Faces Order:

   • Similar to input faces order, this parameter sets the order for processing source image faces with the same options.

5. Source Faces Index:

   • Specifies face indexes from the source image in a comma-separated format.
   • Default: "0"

6. Detect Gender Source:

   • Controls gender detection for faces in the source image, with choice options:
     • No
     • Female
     • Male

7. Console Log Level:

   • Sets the verbosity of console logs to assist debugging or provide informational insights. Options typically range from minimal (e.g., errors only) to detailed logs.

Output

The ReActorOptions node produces a single output:

• Options Dictionary:
  • A dictionary-like structure containing all set options, which is then used to guide the behavior of face-swapping nodes, particularly ReActorFaceSwapOpt.

Use in Workflows

The ReActorOptions node is generally used in conjunction with the ReActorFaceSwapOpt node, which performs the face-swapping operation. By providing a comprehensive set of configurable options, this node allows users to precisely control how faces are detected and swapped, enabling a more customized face-swapping experience.

Typical Setup

• Configure Options: Place the ReActorOptions node into your workflow to define desired processing parameters.
• Connect to Face Swap Node: Attach the output from ReActorOptions to the options input of the ReActorFaceSwapOpt node.
• Optimize Output: Adjust options for best results based on the specific requirements of your face-swapping project.

Special Considerations

• Ordering and Indexing: Proper understanding of how face ordering and indexing work is essential for achieving desired results, especially in images with multiple faces.
• Gender Constraints: Setting gender detection correctly can prevent unintended swaps and ensure ethical use of the tool.
• Verbosity Levels: Leveraging the console log level options can be beneficial during development and troubleshooting to gain insight into node operations.

By adjusting these parameters, users can finely control the behavior of face-swapping operations, leading to more accurate and tailored results suitable for various applications within the ComfyUI environment.