ComfyUI Node: SAM3D Body Type Preset

SAM3D Body Type Preset:

The SAM3DBodyMod_BodyTypePreset node is designed to modify and enhance 3D body shapes by applying specific body type presets such as ectomorph, mesomorph, endomorph, or amplifying detected features. This node is particularly useful for AI artists who want to experiment with different body types and proportions in their 3D models. By leveraging the semantic width targets projected into the MHR's identity basis, it allows for a nuanced transformation of body shapes, providing a versatile tool for creative expression. Whether you are aiming to subtly adjust a model's physique or dramatically alter its appearance, this node offers a range of options to achieve your desired outcome.

SAM3D Body Type Preset Input Parameters:

sam3d_body_model

This parameter requires the input of a SAM3D body model, which serves as the foundational structure for applying the body type presets. It is essential for the node to function as it provides the necessary data for shape modification.

shape_profile

The shape_profile input is a crucial parameter that defines the initial shape characteristics of the 3D model. This profile is used as a baseline to apply the selected body type preset, allowing for targeted modifications.

body_type

The body_type parameter allows you to select from a range of options: "detected," "ectomorph," "mesomorph," "endomorph," and "maximize_detected." The default is "detected." This selection determines the type of body shape transformation applied to the model. For example, choosing "ectomorph" will project a slimmer physique, while "endomorph" will create a more robust appearance. The "maximize_detected" option amplifies all recognized shape and proportion coefficients.

strength

The strength parameter controls the intensity of the body type effect, with a default value of 1.0. It ranges from 0.0 to 3.0, allowing for fine-tuning of the transformation. A value of 0 leaves the detected profile unchanged, while higher values increase the effect of the selected body type, enabling more pronounced modifications.

SAM3D Body Type Preset Output Parameters:

shape_profile

The output shape_profile is a modified version of the input profile, reflecting the changes made by the selected body type preset. This output is essential for further processing or rendering, as it represents the final shape of the 3D model after the transformation.

SAM3D Body Type Preset Usage Tips:

• Experiment with different body_type options to see how each affects your model's appearance. This can help you find the perfect fit for your creative vision.
• Adjust the strength parameter incrementally to achieve subtle or dramatic changes, depending on your project's needs. Start with small adjustments to understand the impact before making larger changes.

SAM3D Body Type Preset Common Errors and Solutions:

RuntimeError: "SAM3D BodyMod: native SAM3D prediction returned no pose data"

• Explanation: This error occurs when the SAM3D prediction does not return any pose data, which is necessary for the node to function.
• Solution: Ensure that the input sam3d_body_model and shape_profile are correctly configured and contain valid data. Verify that the input image or data source is appropriate and correctly formatted.

ValueError: "SAM3D BodyMod: expected 204 packed MHR model parameters, got <actual_number>"

• Explanation: This error indicates that the input model parameters do not match the expected format or size.
• Solution: Check the input data to ensure it contains the correct number of parameters. If necessary, preprocess the data to match the expected format before inputting it into the node.