ComfyUI Node: Ordered Face Filter

Ordered Face Filter:

The OrderedFaceFilter node is designed to help you organize and filter detected faces based on specific criteria, such as the area of the face. This node allows you to sort faces in either ascending or descending order and select a subset of faces to work with, making it easier to focus on the most relevant faces for your project. By using this node, you can streamline your workflow and ensure that you are working with the most important faces, whether you are creating art, animations, or other AI-driven projects.

Ordered Face Filter Input Parameters:

faces

This parameter expects a list of faces that you want to filter and sort. Each face should be represented in a format that includes its dimensions and other relevant attributes.

criteria

This parameter determines the criteria used to sort the faces. Currently, the only available option is area, which sorts the faces based on their area (width multiplied by height). This helps in prioritizing larger or smaller faces depending on your needs.

order

This parameter specifies the order in which the faces should be sorted. You can choose between descending and ascending. Selecting descending will sort the faces from largest to smallest, while ascending will sort them from smallest to largest.

take_start

This integer parameter indicates the starting index from which to take faces after sorting. The default value is 0, meaning the selection starts from the first face in the sorted list. The minimum value is 0, and it increments in steps of 1.

take_count

This integer parameter specifies the number of faces to take from the sorted list, starting from the take_start index. The default value is 1, meaning only one face will be selected. The minimum value is 1, and it increments in steps of 1.

Ordered Face Filter Output Parameters:

filtered

This output provides the list of faces that have been filtered and selected based on the specified criteria and order. These are the faces you will likely focus on for further processing or analysis.

rest

This output provides the list of faces that were not selected in the filtering process. These faces are still available for any additional processing or as a fallback option.

Ordered Face Filter Usage Tips:

• To prioritize larger faces in your project, set the criteria to area and the order to descending.
• If you need to work with a specific subset of faces, adjust the take_start and take_count parameters to select the desired range of faces from the sorted list.
• Use the rest output to keep track of faces that were not selected, which can be useful for secondary processing or backup purposes.

Ordered Face Filter Common Errors and Solutions:

Invalid criteria specified

• Explanation: The criteria parameter was set to a value that is not supported.
• Solution: Ensure that the criteria parameter is set to area, as it is the only supported option currently.

Invalid order specified

• Explanation: The order parameter was set to a value that is not supported.
• Solution: Ensure that the order parameter is set to either descending or ascending.

take_start out of range

• Explanation: The take_start parameter was set to a value that is outside the range of the sorted faces list.
• Solution: Adjust the take_start parameter to a value within the range of the sorted faces list.

take_count out of range

• Explanation: The take_count parameter was set to a value that exceeds the number of available faces starting from the take_start index.
• Solution: Adjust the take_count parameter to a value that fits within the available range of faces starting from the take_start index.