ComfyUI Node: Hunyuan 3D 2.1 Camera Config

Hunyuan 3D 2.1 Camera Config:

The Hy3D21CameraConfig node is designed to configure camera settings for 3D rendering tasks within the Hunyuan 3D 2.1 framework. This node allows you to define specific camera angles and weights, which are crucial for generating multi-view images of 3D models. By setting azimuths and elevations, you can control the camera's orientation around the model, while view weights help in prioritizing certain views over others. Additionally, the node provides an orthographic scale option to adjust the camera's projection type, which can be particularly useful for achieving the desired visual effects in your 3D scenes. This configuration is essential for artists looking to create detailed and accurate 3D representations, as it ensures that the camera captures the model from the most effective angles, enhancing the overall quality and realism of the rendered images.

Hunyuan 3D 2.1 Camera Config Input Parameters:

camera_azimuths

The camera_azimuths parameter is a string that specifies the horizontal angles at which the camera will be positioned around the 3D model. These angles are expressed in degrees and separated by commas. The default value is "0, 90, 180, 270, 0, 180", which means the camera will capture views from the front, sides, and back of the model. This parameter allows you to control the camera's rotation around the vertical axis, providing a comprehensive view of the model from different perspectives.

camera_elevations

The camera_elevations parameter is a string that defines the vertical angles of the camera relative to the 3D model. Like azimuths, these angles are in degrees and separated by commas. The default value is "0, 0, 0, 0, 90, -90", which positions the camera at the same height as the model for most views, with additional views from directly above and below. This parameter is crucial for capturing the model from various heights, ensuring that all important details are visible.

view_weights

The view_weights parameter is a string that assigns importance to each camera view. The values are floating-point numbers separated by commas, with a default of "1, 0.1, 0.5, 0.1, 0.05, 0.05". Higher weights indicate more significant views, which can influence rendering processes that prioritize certain angles. This parameter helps in focusing on specific views that are more critical for the final output, optimizing the rendering process.

ortho_scale

The ortho_scale parameter is a float that adjusts the scale of the orthographic projection used by the camera. It ranges from 0.1 to 2.0, with a default value of 1.0. This parameter affects how the 3D model is projected onto the 2D plane, with larger values providing a more zoomed-out view. Adjusting the ortho scale can help achieve the desired level of detail and perspective in the rendered images.

Hunyuan 3D 2.1 Camera Config Output Parameters:

camera_config

The camera_config output is a dictionary containing the processed camera settings, including selected azimuths, elevations, view weights, and the orthographic scale. This configuration is used by other nodes in the Hunyuan 3D 2.1 pipeline to render multi-view images of the 3D model. It ensures that the camera settings are consistently applied across different stages of the rendering process, maintaining the intended visual style and accuracy.

Hunyuan 3D 2.1 Camera Config Usage Tips:

• Experiment with different camera_azimuths and camera_elevations to capture your model from unique angles that highlight its features.
• Use view_weights to emphasize views that are more important for your project, ensuring they receive more attention during rendering.
• Adjust the ortho_scale to find the right balance between detail and perspective, especially when working with complex models.

Hunyuan 3D 2.1 Camera Config Common Errors and Solutions:

Invalid angle format

• Explanation: The camera_azimuths or camera_elevations strings contain non-numeric values or incorrect formatting.
• Solution: Ensure that all values are numeric and separated by commas without spaces.

Weight parsing error

• Explanation: The view_weights string contains non-numeric values or incorrect formatting.
• Solution: Verify that all weights are valid floating-point numbers and properly separated by commas.

Ortho scale out of range

• Explanation: The ortho_scale value is set outside the allowed range of 0.1 to 2.0.
• Solution: Adjust the ortho_scale to be within the specified range to ensure proper camera projection.