transform.h

/********************************************************************
 * Copyright (C) 2015 Liangliang Nan <liangliang.nan@gmail.com>
 * https://3d.bk.tudelft.nl/liangliang/
 *
 * This file is part of Easy3D. If it is useful in your research/work,
 * I would be grateful if you show your appreciation by citing it:
 * ------------------------------------------------------------------
 *      Liangliang Nan.
 *      Easy3D: a lightweight, easy-to-use, and efficient C++ library
 *      for processing and rendering 3D data.
 *      Journal of Open Source Software, 6(64), 3255, 2021.
 * ------------------------------------------------------------------
 *
 * Easy3D is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License Version 3
 * as published by the Free Software Foundation.
 *
 * Easy3D is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
 ********************************************************************/
 
#ifndef EASY3D_RENDERER_TRANSFORM_H
#define EASY3D_RENDERER_TRANSFORM_H
 
#include <easy3d/core/types.h>
 
 
namespace easy3d {

    namespace transform {

        mat4 ortho(float left, float right, float bottom, float top, float near, float far);

        mat4 ortho(float left, float right, float bottom, float top);

        mat4 frustum(float left, float right, float bottom, float top, float near, float far);

        mat4 perspective(float fov_y, float aspect, float near, float far);
        mat4 perspective(float fov_y, float width, float height, float near, float far);

        mat4 infinite_perspective(float fov_y, float aspect, float near);

        mat4 viewport(float width, float height);

        mat4 look_at(const vec3& eye, const vec3& center, const vec3& up);

        mat4 pick_matrix(const vec2& center, const vec2& delta, const vec4& viewport);

        vec3 project(const vec3& obj, const mat4& model, const mat4& proj, const int viewport[4], bool lowerleft = true);
        vec3 project(const vec3& obj, const mat4& mvp, const int viewport[4], bool lowerleft = true); // mvp = proj * model;

        vec3 unproject(const vec3& win, const mat4& model, const mat4& proj, const int viewport[4], bool lowerleft = true);
        vec3 unproject(const vec3& win, const mat4& mvp, const int viewport[4], bool lowerleft = true); // mvp = proj * model;
 
        // --------------------------------------------------------------------------------------------------

        mat3  normal_matrix(const mat4& mat);

        mat43 normal_matrix_padded(const mat4& mat);
 
    } // namespace transform
 
}
 
 
#endif  // EASY3D_RENDERER_TRANSFORM_H