ComfyUI Node: Create Primitive

Create Primitive:

The GeomPackCreatePrimitive node is designed to generate basic geometric shapes, such as cubes, spheres, and planes, which are essential building blocks in 3D modeling and computer graphics. This node leverages high-quality mesh creation functions to produce precise and detailed primitive shapes, making it a valuable tool for artists and designers who need to quickly create foundational geometry for their projects. By providing a straightforward interface to specify the type, size, and complexity of the shape, this node simplifies the process of generating 3D models, allowing you to focus on creative aspects rather than technical details. Whether you're creating a simple scene or a complex structure, the GeomPackCreatePrimitive node offers a reliable and efficient way to start your 3D modeling journey.

Create Primitive Input Parameters:

shape

The shape parameter determines the type of geometric primitive to be created. You can choose from three options: "cube," "sphere," or "plane." Each option corresponds to a different basic shape, allowing you to select the one that best fits your project needs. The default value is "cube," which is a versatile shape often used as a starting point in 3D modeling.

size

The size parameter specifies the overall dimensions of the primitive shape. It is a floating-point value that defines the scale of the shape, with a minimum value of 0.01 and a maximum value of 100.0. The default size is set to 1.0, providing a standard unit size for the shape. Adjusting this parameter allows you to create larger or smaller versions of the selected shape, depending on your design requirements.

subdivisions

The subdivisions parameter controls the level of detail for the sphere and plane shapes by specifying the number of subdivisions applied to the mesh. It is an integer value with a default of 2, and it can range from 0 to 5. Increasing the number of subdivisions results in a more detailed and smoother surface, which is particularly useful for creating high-quality spheres and planes. This parameter is optional and does not affect the cube shape.

Create Primitive Output Parameters:

mesh

The mesh output parameter provides the generated 3D mesh of the selected primitive shape. This output is a trimesh.Trimesh object, which contains the vertices, faces, and other geometric data necessary for rendering and manipulating the shape in a 3D environment. The mesh is the primary output of the node and serves as the foundation for further modeling, texturing, and rendering tasks.

Create Primitive Usage Tips:

• To create a highly detailed sphere, increase the subdivisions parameter to a higher value, such as 4 or 5, which will result in a smoother and more refined surface.
• When working on large-scale projects, adjust the size parameter to ensure that the primitive shapes fit well within your scene's dimensions and maintain proportionality with other elements.
• Use the shape parameter to quickly switch between different geometric forms, allowing you to experiment with various design concepts and find the best fit for your project.

Create Primitive Common Errors and Solutions:

Unknown shape: <shape>

• Explanation: This error occurs when an invalid shape type is provided to the shape parameter. The node only supports "cube," "sphere," and "plane" as valid shape types.
• Solution: Ensure that the shape parameter is set to one of the supported options: "cube," "sphere," or "plane." Double-check for any typos or incorrect values.

ValueError: Size must be greater than 0

• Explanation: This error is raised when the size parameter is set to a value less than or equal to zero, which is not allowed as it would result in an invalid geometric shape.
• Solution: Adjust the size parameter to a positive value greater than 0.01 to ensure the shape is created with valid dimensions.