You're breathtaking!

Source/Engine/Core/Math/Viewport.h

@@ -0,0 +1,170 @@
+// Copyright (c) 2010-2014 SharpDX - Alexandre Mutel
+// Copyright (c) 2012-2020 Wojciech Figat. All rights reserved.
+
+#pragma once
+
+#include "Vector2.h"
+
+struct Vector3;
+struct Matrix;
+struct Rectangle;
+
+// Describes the viewport dimensions.
+API_STRUCT(InBuild) struct Viewport
+{
+public:
+
+    union
+    {
+        struct
+        {
+            // Position of the pixel coordinate of the upper-left corner of the viewport.
+            float X;
+
+            // Position of the pixel coordinate of the upper-left corner of the viewport.
+            float Y;
+        };
+
+        // Upper left corner location.
+        Vector2 Location;
+    };
+
+    union
+    {
+        struct
+        {
+            // Width dimension of the viewport.
+            float Width;
+
+            // Height dimension of the viewport.
+            float Height;
+        };
+
+        // Size
+        Vector2 Size;
+    };
+
+    // Minimum depth of the clip volume.
+    float MinDepth;
+
+    // Maximum depth of the clip volume.
+    float MaxDepth;
+
+public:
+
+    /// <summary>
+    /// Empty constructor.
+    /// </summary>
+    Viewport()
+    {
+    }
+
+    // Init
+    // @param x The x coordinate of the upper-left corner of the viewport in pixels
+    // @param y The y coordinate of the upper-left corner of the viewport in pixels
+    // @param width The width of the viewport in pixels
+    // @param height The height of the viewport in pixels
+    Viewport(float x, float y, float width, float height)
+        : X(x)
+        , Y(y)
+        , Width(width)
+        , Height(height)
+        , MinDepth(0.0f)
+        , MaxDepth(1.0f)
+    {
+    }
+
+    // Init
+    // @param x The x coordinate of the upper-left corner of the viewport in pixels
+    // @param y The y coordinate of the upper-left corner of the viewport in pixels
+    // @param width The width of the viewport in pixels
+    // @param height The height of the viewport in pixels
+    // @param minDepth The minimum depth of the clip volume
+    // @param maxDepth The maximum depth of the clip volume
+    Viewport(float x, float y, float width, float height, float minDepth, float maxDepth)
+        : X(x)
+        , Y(y)
+        , Width(width)
+        , Height(height)
+        , MinDepth(minDepth)
+        , MaxDepth(maxDepth)
+    {
+    }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="Viewport"/> struct.
+    /// </summary>
+    /// <param name="size">The viewport size.</param>
+    explicit Viewport(const Vector2& size)
+        : X(0)
+        , Y(0)
+        , Width(size.X)
+        , Height(size.Y)
+        , MinDepth(0.0f)
+        , MaxDepth(1.0f)
+    {
+    }
+
+    // Init
+    // @param bounds A bounding box that defines the location and size of the viewport in a render target
+    Viewport(const Rectangle& bounds);
+
+public:
+
+    String ToString() const;
+
+public:
+
+    // Gets the aspect ratio used by the viewport
+    // @returns The aspect ratio
+    float GetAspectRatio() const
+    {
+        if (Height != 0.0f)
+        {
+            return Width / Height;
+        }
+        return 0.0f;
+    }
+
+    // Gets the size of the viewport
+    // @eturns The bounds
+    Rectangle GetBounds() const;
+
+    // Sets the size of the viewport
+    // @param bounds The bounds
+    void SetBounds(const Rectangle& bounds);
+
+public:
+
+    bool operator==(const Viewport& other) const
+    {
+        return X == other.X && Y == other.Y && Width == other.Width && Height == other.Height && MinDepth == other.MinDepth && MaxDepth == other.MaxDepth;
+    }
+
+    bool operator!=(const Viewport& other) const
+    {
+        return X != other.X || Y != other.Y || Width != other.Width || Height != other.Height || MinDepth != other.MinDepth || MaxDepth != other.MaxDepth;
+    }
+
+public:
+
+    // Projects a 3D vector from object space into screen space
+    // @param source The vector to project
+    // @param vp A combined WorldViewProjection matrix
+    // @param vector The projected vector
+    void Project(const Vector3& source, const Matrix& vp, Vector3& result) const;
+
+    // Converts a screen space point into a corresponding point in world space
+    // @param source The vector to project
+    // @param vp An inverted combined WorldViewProjection matrix
+    // @param vector The unprojected vector
+    void Unproject(const Vector3& source, const Matrix& ivp, Vector3& result) const;
+};
+
+template<>
+struct TIsPODType<Viewport>
+{
+    enum { Value = true };
+};
+
+DEFINE_DEFAULT_FORMATTING(Viewport, "X:{0} Y:{1} Width:{2} Height:{3} MinDepth:{4} MaxDeth:{5}", v.X, v.Y, v.Width, v.Height, v.MinDepth, v.MaxDepth);