Merge pull request #162 from RobLoach/exception

Add Exceptions

Author: RobLoach

.github/workflows/Tests.yml

@@ -22,4 +22,4 @@ jobs:
       run: cmake --build build
 
     - name: Test
-      run: ./build/tests/raylib_test
+      run: ./build/tests/raylib_cpp_test

README.md

@@ -220,6 +220,26 @@ std::string url = "https://raylib.com";
 raylib::OpenURL(url);
 ```
 
+### Exceptions
+
+When loading an asset fails, raylib will log a warning, but provide no other feedback for you to act upon. raylib-cpp will throw a [`RaylibException`](include/RaylibException.hpp) [runtime exception](https://en.cppreference.com/w/cpp/error/runtime_error), allowing to provide a safe method to catch failed loads.
+
+``` cpp
+// raylib
+Texture texture = LoadTexture("FileNotFound.png");
+if (texture.width == 0) {
+    TraceLog(LOG_ERROR, "Texture failed to load!");
+}
+
+// raylib-cpp
+try {
+    raylib::Texture texture("FileNotFound.png");
+}
+catch (raylib::RaylibException& error) {
+    error.TraceLog(LOG_ERROR);
+}
+```
+
 ### RayMath
 
 The [raymath](https://github.com/raysan5/raylib/blob/master/src/raymath.h) methods are included.

clib.json

@@ -43,6 +43,7 @@
     "include/Physics.hpp",
     "include/Ray.hpp",
     "include/RayCollision.hpp",
+    "include/RaylibException.hpp",
     "include/raylib-cpp-utils.hpp",
     "include/raylib-cpp.hpp",
     "include/raylib.hpp",

docs/_audio_device_8hpp_source.html

@@ -130,7 +130,7 @@
 <div class="line"><a name="l00078"></a><span class="lineno">   78</span>&#160; </div>
 <div class="line"><a name="l00079"></a><span class="lineno">   79</span>&#160;<span class="preprocessor">#endif  // RAYLIB_CPP_INCLUDE_BOUNDINGBOX_HPP_</span></div>
 </div><!-- fragment --></div><!-- contents -->
-<div class="ttc" id="anamespaceraylib_html"><div class="ttname"><a href="namespaceraylib.html">raylib</a></div><div class="ttdoc">All raylib-cpp classes and functions appear in the raylib namespace.</div><div class="ttdef"><b>Definition:</b> <a href="_audio_device_8hpp_source.html#l00007">AudioDevice.hpp:7</a></div></div>
+<div class="ttc" id="anamespaceraylib_html"><div class="ttname"><a href="namespaceraylib.html">raylib</a></div><div class="ttdoc">All raylib-cpp classes and functions appear in the raylib namespace.</div><div class="ttdef"><b>Definition:</b> <a href="_audio_device_8hpp_source.html#l00008">AudioDevice.hpp:8</a></div></div>
 <div class="ttc" id="aclassraylib_1_1_ray_collision_html"><div class="ttname"><a href="classraylib_1_1_ray_collision.html">raylib::RayCollision</a></div><div class="ttdoc">Raycast hit information.</div><div class="ttdef"><b>Definition:</b> <a href="_ray_collision_8hpp_source.html#l00011">RayCollision.hpp:11</a></div></div>
 <div class="ttc" id="aclassraylib_1_1_bounding_box_html_a8417253000c9381b4afc1869d5e3a611"><div class="ttname"><a href="classraylib_1_1_bounding_box.html#a8417253000c9381b4afc1869d5e3a611">raylib::BoundingBox::BoundingBox</a></div><div class="ttdeci">BoundingBox(const ::Mesh &amp;mesh)</div><div class="ttdoc">Compute mesh bounding box limits.</div><div class="ttdef"><b>Definition:</b> <a href="_bounding_box_8hpp_source.html#l00020">BoundingBox.hpp:20</a></div></div>
 <div class="ttc" id="aclassraylib_1_1_bounding_box_html_aae0a66351992f36372ef68a6d4508c62"><div class="ttname"><a href="classraylib_1_1_bounding_box.html#aae0a66351992f36372ef68a6d4508c62">raylib::BoundingBox::Draw</a></div><div class="ttdeci">BoundingBox &amp; Draw(::Color color={255, 255, 255, 255})</div><div class="ttdoc">Draw a bounding box with wires.</div><div class="ttdef"><b>Definition:</b> <a href="_bounding_box_8hpp_source.html#l00038">BoundingBox.hpp:38</a></div></div>

docs/_audio_stream_8hpp_source.html

@@ -133,7 +133,7 @@
 <div class="line"><a name="l00072"></a><span class="lineno">   72</span>&#160; </div>
 <div class="line"><a name="l00073"></a><span class="lineno">   73</span>&#160;<span class="preprocessor">#endif  // RAYLIB_CPP_INCLUDE_CAMERA2D_HPP_</span></div>
 </div><!-- fragment --></div><!-- contents -->
-<div class="ttc" id="anamespaceraylib_html"><div class="ttname"><a href="namespaceraylib.html">raylib</a></div><div class="ttdoc">All raylib-cpp classes and functions appear in the raylib namespace.</div><div class="ttdef"><b>Definition:</b> <a href="_audio_device_8hpp_source.html#l00007">AudioDevice.hpp:7</a></div></div>
+<div class="ttc" id="anamespaceraylib_html"><div class="ttname"><a href="namespaceraylib.html">raylib</a></div><div class="ttdoc">All raylib-cpp classes and functions appear in the raylib namespace.</div><div class="ttdef"><b>Definition:</b> <a href="_audio_device_8hpp_source.html#l00008">AudioDevice.hpp:8</a></div></div>
 <div class="ttc" id="aclassraylib_1_1_matrix_html"><div class="ttname"><a href="classraylib_1_1_matrix.html">raylib::Matrix</a></div><div class="ttdoc">Matrix type (OpenGL style 4x4 - right handed, column major)</div><div class="ttdef"><b>Definition:</b> <a href="_matrix_8hpp_source.html#l00016">Matrix.hpp:16</a></div></div>
 <div class="ttc" id="aclassraylib_1_1_camera2_d_html_a1eed5bde73d8c1a227250b6caaefcb42"><div class="ttname"><a href="classraylib_1_1_camera2_d.html#a1eed5bde73d8c1a227250b6caaefcb42">raylib::Camera2D::GetScreenToWorld</a></div><div class="ttdeci">Vector2 GetScreenToWorld(::Vector2 position) const</div><div class="ttdoc">Returns the world space position for a 2d camera screen space position.</div><div class="ttdef"><b>Definition:</b> <a href="_camera2_d_8hpp_source.html#l00059">Camera2D.hpp:59</a></div></div>
 <div class="ttc" id="aclassraylib_1_1_camera2_d_html_aa1f8ea4d3a25feb15c2cb2a09628c7a1"><div class="ttname"><a href="classraylib_1_1_camera2_d.html#aa1f8ea4d3a25feb15c2cb2a09628c7a1">raylib::Camera2D::GetMatrix</a></div><div class="ttdeci">Matrix GetMatrix() const</div><div class="ttdoc">Returns camera 2d transform matrix.</div><div class="ttdef"><b>Definition:</b> <a href="_camera2_d_8hpp_source.html#l00045">Camera2D.hpp:45</a></div></div>

docs/_bounding_box_8hpp_source.html

@@ -188,7 +188,7 @@
 <div class="line"><a name="l00163"></a><span class="lineno">  163</span>&#160; </div>
 <div class="line"><a name="l00164"></a><span class="lineno">  164</span>&#160;<span class="preprocessor">#endif  // RAYLIB_CPP_INCLUDE_CAMERA3D_HPP_</span></div>
 </div><!-- fragment --></div><!-- contents -->
-<div class="ttc" id="anamespaceraylib_html"><div class="ttname"><a href="namespaceraylib.html">raylib</a></div><div class="ttdoc">All raylib-cpp classes and functions appear in the raylib namespace.</div><div class="ttdef"><b>Definition:</b> <a href="_audio_device_8hpp_source.html#l00007">AudioDevice.hpp:7</a></div></div>
+<div class="ttc" id="anamespaceraylib_html"><div class="ttname"><a href="namespaceraylib.html">raylib</a></div><div class="ttdoc">All raylib-cpp classes and functions appear in the raylib namespace.</div><div class="ttdef"><b>Definition:</b> <a href="_audio_device_8hpp_source.html#l00008">AudioDevice.hpp:8</a></div></div>
 <div class="ttc" id="aclassraylib_1_1_matrix_html"><div class="ttname"><a href="classraylib_1_1_matrix.html">raylib::Matrix</a></div><div class="ttdoc">Matrix type (OpenGL style 4x4 - right handed, column major)</div><div class="ttdef"><b>Definition:</b> <a href="_matrix_8hpp_source.html#l00016">Matrix.hpp:16</a></div></div>
 <div class="ttc" id="anamespaceraylib_html_abd45302dac72cb253026bce044dee236"><div class="ttname"><a href="namespaceraylib.html#abd45302dac72cb253026bce044dee236">raylib::UpdateCamera</a></div><div class="ttdeci">static void UpdateCamera(const ::Camera &amp;camera)</div><div class="ttdoc">Update camera depending on selected mode.</div><div class="ttdef"><b>Definition:</b> <a href="_functions_8hpp_source.html#l00195">Functions.hpp:195</a></div></div>
 <div class="ttc" id="aclassraylib_1_1_camera3_d_html_ac59decb87b851c16adee7c2c742f8961"><div class="ttname"><a href="classraylib_1_1_camera3_d.html#ac59decb87b851c16adee7c2c742f8961">raylib::Camera3D::GetMouseRay</a></div><div class="ttdeci">Ray GetMouseRay(::Vector2 mousePosition) const</div><div class="ttdoc">Returns a ray trace from mouse position.</div><div class="ttdef"><b>Definition:</b> <a href="_camera3_d_8hpp_source.html#l00115">Camera3D.hpp:115</a></div></div>

docs/_camera2_d_8hpp_source.html

@@ -282,7 +282,7 @@
 <div class="line"><a name="l00257"></a><span class="lineno">  257</span>&#160; </div>
 <div class="line"><a name="l00258"></a><span class="lineno">  258</span>&#160;<span class="preprocessor">#endif  // RAYLIB_CPP_INCLUDE_COLOR_HPP_</span></div>
 </div><!-- fragment --></div><!-- contents -->
-<div class="ttc" id="anamespaceraylib_html"><div class="ttname"><a href="namespaceraylib.html">raylib</a></div><div class="ttdoc">All raylib-cpp classes and functions appear in the raylib namespace.</div><div class="ttdef"><b>Definition:</b> <a href="_audio_device_8hpp_source.html#l00007">AudioDevice.hpp:7</a></div></div>
+<div class="ttc" id="anamespaceraylib_html"><div class="ttname"><a href="namespaceraylib.html">raylib</a></div><div class="ttdoc">All raylib-cpp classes and functions appear in the raylib namespace.</div><div class="ttdef"><b>Definition:</b> <a href="_audio_device_8hpp_source.html#l00008">AudioDevice.hpp:8</a></div></div>
 <div class="ttc" id="aclassraylib_1_1_vector4_html"><div class="ttname"><a href="classraylib_1_1_vector4.html">raylib::Vector4</a></div><div class="ttdoc">Vector4 type.</div><div class="ttdef"><b>Definition:</b> <a href="_vector4_8hpp_source.html#l00017">Vector4.hpp:17</a></div></div>
 <div class="ttc" id="aclassraylib_1_1_color_html_ace467f20d71ff4af44e0211d6aeea9b5"><div class="ttname"><a href="classraylib_1_1_color.html#ace467f20d71ff4af44e0211d6aeea9b5">raylib::Color::ClearBackground</a></div><div class="ttdeci">Color &amp; ClearBackground()</div><div class="ttdoc">Set background color (framebuffer clear color)</div><div class="ttdef"><b>Definition:</b> <a href="_color_8hpp_source.html#l00107">Color.hpp:107</a></div></div>
 <div class="ttc" id="aclassraylib_1_1_color_html_ae94a7282beb9cd71dd8d1b0dac24652a"><div class="ttname"><a href="classraylib_1_1_color.html#ae94a7282beb9cd71dd8d1b0dac24652a">raylib::Color::Color</a></div><div class="ttdeci">Color(unsigned int hexValue)</div><div class="ttdoc">Get Color structure from hexadecimal value.</div><div class="ttdef"><b>Definition:</b> <a href="_color_8hpp_source.html#l00048">Color.hpp:48</a></div></div>