CreateShape.hpp

Go to the documentation of this file.

/**************************************************************************
 * EngineSquared v0.2.0
 *
 * EngineSquared is a software package, part of the Engine² organization.
 *
 * This file is part of the EngineSquared project that is under MIT License.
 * Copyright © 2025-present by @EngineSquared, All rights reserved.
 *
 * EngineSquared is a free software: you can redistribute it and/or modify
 * it under the terms of the MIT License. See the project's LICENSE file for
 * the full license text and details.
 *
 * @file CreateShape.hpp
 * @brief Helper functions to generate basic geometric shapes
 *
 * This file provides helper functions to create common 3D shapes like cubes,
 * spheres, planes, etc. with proper vertices, normals, texture coordinates,
 * and indices.
 *
 * @author @EngineSquared
 * @version 0.2.0
 * @date 2025-10-28
 **************************************************************************/
 
#pragma once
 
#include "component/Mesh.hpp"
#include "component/Transform.hpp"
#include "core/Core.hpp"
#include "entity/Entity.hpp"
 
#include <glm/glm.hpp>
 
namespace Object::Helper {

struct CreateCubeInfo {
    float size = 1.0f;                                      
    glm::vec3 position = glm::vec3(0.0f);                   
    glm::quat rotation = glm::quat(1.0f, 0.0f, 0.0f, 0.0f); 
    glm::vec3 scale = glm::vec3(1.0f);                      
};

Engine::Entity CreateCube(Engine::Core &core, CreateCubeInfo info = {});

struct CreateSphereInfo {
    float radius = 0.5f;                                    
    glm::vec3 position = glm::vec3(0.0f);                   
    glm::quat rotation = glm::quat(1.0f, 0.0f, 0.0f, 0.0f); 
    glm::vec3 scale = glm::vec3(1.0f);                      
    uint32_t segments = 32u;                                
    uint32_t rings = 16u;                                   
};

Engine::Entity CreateSphere(Engine::Core &core, CreateSphereInfo info = {});

struct CreatePlaneInfo {
    float width = 1.0f;                                     
    float depth = 1.0f;                                     
    glm::vec3 position = glm::vec3(0.0f);                   
    glm::quat rotation = glm::quat(1.0f, 0.0f, 0.0f, 0.0f); 
    glm::vec3 scale = glm::vec3(1.0f);                      
    uint32_t subdivisionsX = 1u;                            
    uint32_t subdivisionsZ = 1u;                            
};

Engine::Entity CreatePlane(Engine::Core &core, CreatePlaneInfo info = {});

struct CreateCylinderInfo {
    float radiusTop = 0.5f;                                 
    float radiusBottom = 0.5f;                              
    float height = 1.0f;                                    
    glm::vec3 position = glm::vec3(0.0f);                   
    glm::quat rotation = glm::quat(1.0f, 0.0f, 0.0f, 0.0f); 
    glm::vec3 scale = glm::vec3(1.0f);                      
    uint32_t segments = 32u;                                
    uint32_t heightSegments = 1u;                           
};

Engine::Entity CreateCylinder(Engine::Core &core, CreateCylinderInfo info = {});

struct CreateCapsuleInfo {
    float radius = 0.5f;                                    
    float height = 1.0f;                                    
    glm::vec3 position = glm::vec3(0.0f);                   
    glm::quat rotation = glm::quat(1.0f, 0.0f, 0.0f, 0.0f); 
    glm::vec3 scale = glm::vec3(1.0f);                      
    uint32_t segments = 32u;                                
    uint32_t heightSegments = 4u; 
};

Engine::Entity CreateCapsule(Engine::Core &core, CreateCapsuleInfo info = {});

struct CreateClothInfo {
    uint32_t width = 10u;                                   
    uint32_t height = 10u;                                  
    float spacing = 0.1f;                                   
    glm::vec3 position = glm::vec3(0.0f);                   
    glm::quat rotation = glm::quat(1.0f, 0.0f, 0.0f, 0.0f); 
    glm::vec3 scale = glm::vec3(1.0f);                      
};

Engine::Entity CreateCloth(Engine::Core &core, CreateClothInfo info = {});

struct CreateRopeInfo {
    uint32_t segmentCount = 10u;                            
    float segmentLength = 0.1f;                             
    glm::vec3 position = glm::vec3(0.0f);                   
    glm::quat rotation = glm::quat(1.0f, 0.0f, 0.0f, 0.0f); 
    glm::vec3 scale = glm::vec3(1.0f);                      
};

Engine::Entity CreateRope(Engine::Core &core, CreateRopeInfo info = {});

struct CreateJellyCubeInfo {
    float size = 1.0f;                                      
    uint32_t gridSize = 5u;                                 
    glm::vec3 position = glm::vec3(0.0f);                   
    glm::quat rotation = glm::quat(1.0f, 0.0f, 0.0f, 0.0f); 
    glm::vec3 scale = glm::vec3(1.0f);                      
};

Engine::Entity CreateJellyCube(Engine::Core &core, CreateJellyCubeInfo info = {});
 
} // namespace Object::Helper