ShapeConstructors.h

Go to the documentation of this file.

/*--------------------------------------------------------------------------------------------
Copyright (c) 2019, NDEVR LLC
tyler.parke@ndevr.org
  __    __   ____     _____ __     __  _______
 |  \  |  | |  __ \  |  ___|\ \   / / |   __  \
 |   \ |  | | |  \ \ | |___  \ \ / /  |  |__)  |
 |  . \|  | | |__/ / | |___   \ V /   |   _   /
 |  |\    |_|_____/__|_____|___\_/____|  | \  \
 |__| \__________________________________|  \__\
 
Subject to the terms of the Enterprise+ Agreement, NDEVR hereby grants 
Licensee a limited, non-exclusive, non-transferable, royalty-free license 
(without the right to sublicense) to use the API solely for the purpose of 
Licensee's internal development efforts to develop applications for which 
the API was provided.
 
The above copyright notice and this permission notice shall be included in all 
copies or substantial portions of the Software.
 
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.
 
Library: Design
File: ShapeConstructors
Included in API: True
Author(s): Tyler Parke
 *-----------------------------------------------------------------------------------------**/
#pragma once
#include "DLLInfo.h"
#include <NDEVR/BaseValues.h>
#include <NDEVR/Matrix.h>
#include <NDEVR/Vertex.h>
#include <NDEVR/Bounds.h>
namespace NDEVR
{
    class Geometry;
    class Scene;
 
    /**--------------------------------------------------------------------------------------------------
    \brief Logic for setting up a mesh that is broken apart by latitude and longitude lines with a set
        angle difference between them.
    **/
    struct ZippedRadialMeshOptions
    {
        ZippedRadialMeshOptions(uint04 width, uint04 height)
            : size(width, height)
        {}
        Vector<2, uint04> size = Vector <2, uint04>(44, 32);
        Bounds<2, Angle<fltp08>> radial_bounds;
        Vector<2, Angle<fltp08>> vertexIndexToAngle(uint04 index) const;
        uint04 angleToVertexIndex(Vector<2, Angle<fltp08>> angle) const;
        Vector<2, fltp08> angleToTextureCoord(Vector<2, Angle<fltp08>> angle) const;
    private:
        Vector<2, Angle<fltp08>> _vertexIndexToAngle(uint04 index) const;
        uint04 _angleToVertexIndex(Vector<2, Angle<fltp08>> angle) const;
        
    };
 
    /**--------------------------------------------------------------------------------------------------
    \brief Logic for writing various basic shapes to a Geometry object. Shapes will be appended to the end
        of the geometry.
    **/
    class NDEVR_DESIGN_API ShapeConstructors
    {
    public:
        static Geometry StaticLine(Scene& parent);
        static Geometry StaticCircleOutline(Scene& parent);
        static Geometry StaticRectangleFilled(Scene& parent);
        static Geometry StaticRectangularPrismFilled(Scene& parent);
        static void Quad(Geometry& mesh, const Matrix<fltp08>& trans, Vertex<3, fltp08> p1, Vertex<3, fltp08> p2, Vertex<3, fltp08> p3, Vertex<3, fltp08> p4);
        static void Rectangle(Geometry& mesh, const Matrix<fltp08>& trans = Matrix<fltp08>(1), fltp08 top_length = 2.0, fltp08 bottom_length = 2.0, fltp08 left_length = 2.0, fltp08 right_length = 2.0, fltp08 vertical_scew = 0.0, fltp08 horizontal_scew = 0.0);
        static void RectangularPrism(Geometry& mesh, const Matrix<fltp08>& trans = Matrix<fltp08>(1));
        static void Circle(Geometry& mesh, const Matrix<fltp08>& trans = Matrix<fltp08>(1), uint04 width_segments = 128, fltp08 radius = 1.0f, Angle<fltp08> phi_start = Angle<fltp08>(DEGREES, 0.0f), Angle<fltp08> phi_length = Angle<fltp08>(DEGREES, 360.0f), bool join = true);
        static void Cylinder(Geometry& mesh, const Matrix<fltp08>& trans = Matrix<fltp08>(1), uint04 width_segments = 44, fltp08 top_radius = 1.0f, fltp08 bottom_radius = 1.0, fltp08 height = 1.0, Angle<fltp08> phi_start = Angle<fltp08>(DEGREES, 0.0f), Angle<fltp08> phi_length = Angle<fltp08>(DEGREES, 360.0f), bool draw_top_circle = true, bool draw_bottom_circle = true);
        static void Cone(Geometry& mesh, const Matrix<fltp08>& trans = Matrix<fltp08>(1), uint04 width_segments = 44, fltp08 bottom_radius = 1.0, fltp08 height = 1.0, Angle<fltp08> phi_start = Angle<fltp08>(DEGREES, 0.0f), Angle<fltp08> phi_length = Angle<fltp08>(DEGREES, 360.0f), bool draw_bottom_circle = true);
        static void Sphere(Geometry& mesh, uint04 width_segments = 44, uint04 height_segments = 32, Angle<fltp08> phi_start = Angle<fltp08>(DEGREES, 0.0f), Angle<fltp08> phi_length = Angle<fltp08>(DEGREES, 360.0f), Angle<fltp08> theta_start = Angle<fltp08>(DEGREES, 0.0f), Angle<fltp08> theta_length = Angle<fltp08>(DEGREES, 180.0f));
        static void ZippedRadialMesh(Geometry& mesh, const ZippedRadialMeshOptions& options);
        static void ZippedTorus(Geometry& mesh, uint04 width_segments = 44, uint04 height_segments = 32);
    protected:
        static void SetupStaticGeometry(Geometry& geo);
    };
}