rmath3d 1.2.2 → 1.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: dc8123d1ad73cb760f30d7c6a3496f13ad54fcb1
-  data.tar.gz: 41ae8b2437dfe3fdc2b0ec6c01fc511a0e5ada20
+SHA256:
+  metadata.gz: 9e8d8b8a38ad55ec12170a103c39607b841855790e279ae4c003e394900f3391
+  data.tar.gz: 8d74d4f0917015c74accd26293cb4036d9befa0bbe0d562893a324881a1b005f
 SHA512:
-  metadata.gz: 39615da4c1208ebfdb06644ce2a6612ed88172afc334c36eb9a08b20211c3fb89359bcdb4e348924fd09fad057745397774be8f3de00e211373a98c6cc6ab11c
-  data.tar.gz: 7e6b01b7f44b95ccb8f2c8a9419d74f730ef1bd6eac59afa7dc128c1e5cfa6ffb171cd151957a8d6d41a4fcbc987ebae63487bb0b30c5299513c936c7179f205
+  metadata.gz: c6ea5c48fba49380581ae07cef869767a73ab1e3f2d8bda7481b352241bf3bd82197a188d529bf230ec786dedb35bb9a49145d430b54f298729598f7b3ba6702
+  data.tar.gz: b02fb89b9fbb8fe9bc1dd3456ef99507d4d1d1e659b3a2884243ea5342100bca7bee219550e6764e15e43c352cf4561bea5615db56827c2d9365596e9e098802

data/ChangeLog

@@ -1,3 +1,11 @@
+2020-06-21  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* rmath3d.c, rmath3d_plain.rb (RMtx4): Added argument 'ndc_homogeneous' for projection matrix APIs.
+	Set true for the environment with Z coordinate ranges from -1 to +1 (OpenGL), and false otherwise (Direct3D, Metal)
+	https://www.slideshare.net/Mark_Kilgard/opengl-32-and-more/26-Direct3D_vs_OpenGL_Coordinate_System
+	https://metashapes.com/blog/opengl-metal-projection-matrix-problem/
+	* rmath3d_plain.rb: Removed Fixnum and Bignum symbols (deprecated and unified into Integer class since Ruby 2.4)
+
 2017-07-22  vaiorabbit  <http://twitter.com/vaiorabbit>
 
 	* Added 'Integer' type for argument type branching (constant ::Fixnum is deprecated since ruby 2.4).

data/LICENSE.txt

@@ -1,5 +1,5 @@
 rmath3d : Ruby math module for 3D Applications
-Copyright (c) 2008-2017 vaiorabbit  <http://twitter.com/vaiorabbit>
+Copyright (c) 2008-2020 vaiorabbit  <http://twitter.com/vaiorabbit>
 
 This software is provided 'as-is', without any express or implied
 warranty. In no event will the authors be held liable for any damages

data/README.md

@@ -4,9 +4,12 @@
 
 rmath3d is a math module for 3D game programming and computer graphics.
 
-*   Last Update: Jul 22, 2017
+*   Last Update: Jun 21, 2020
 *   Since: Jul 20, 2008
 
+* rmath3d (C Extension Library Implementation) [![Gem Version](https://badge.fury.io/rb/rmath3d.svg)](https://badge.fury.io/rb/rmath3d) [![Gem](https://img.shields.io/gem/dt/rmath3d.svg)](https://rubygems.org/gems/rmath3d)
+* rmath3d_plain (Pure Ruby Implementation) [![Gem Version](https://badge.fury.io/rb/rmath3d_plain.svg)](https://badge.fury.io/rb/rmath3d_plain) [![Gem](https://img.shields.io/gem/dt/rmath3d_plain.svg)](https://rubygems.org/gems/rmath3d_plain)
+
 ## Features ##
 
 ### Supports frequently-used vector and matrix classes ###

data/ext/rmath3d/RMath3D.h

@@ -14,7 +14,7 @@
 
 /*
 RMath : Ruby math module for 3D Applications
-Copyright (c) 2008-2017 vaiorabbit  <http://twitter.com/vaiorabbit>
+Copyright (c) 2008-2020 vaiorabbit  <http://twitter.com/vaiorabbit>
 
 This software is provided 'as-is', without any express or implied
 warranty. In no event will the authors be held liable for any damages

data/ext/rmath3d/RMtx2.c

@@ -232,7 +232,7 @@ RMtx2Scale( RMtx2* out, const RMtx2* m, rmReal f )
 
 /*
 RMath : Ruby math module for 3D Applications
-Copyright (c) 2008-2017 vaiorabbit  <http://twitter.com/vaiorabbit>
+Copyright (c) 2008-2020 vaiorabbit  <http://twitter.com/vaiorabbit>
 
 This software is provided 'as-is', without any express or implied
 warranty. In no event will the authors be held liable for any damages

data/ext/rmath3d/RMtx2.h

@@ -65,7 +65,7 @@ void    RMtx2Scale( RMtx2* out, const RMtx2* m, rmReal f );
 
 /*
 RMath : Ruby math module for 3D Applications
-Copyright (c) 2008-2017 vaiorabbit  <http://twitter.com/vaiorabbit>
+Copyright (c) 2008-2020 vaiorabbit  <http://twitter.com/vaiorabbit>
 
 This software is provided 'as-is', without any express or implied
 warranty. In no event will the authors be held liable for any damages

data/ext/rmath3d/RMtx3.c

@@ -347,7 +347,7 @@ RMtx3Scale( RMtx3* out, const RMtx3* m, rmReal f )
 
 /*
 RMath : Ruby math module for 3D Applications
-Copyright (c) 2008-2017 vaiorabbit  <http://twitter.com/vaiorabbit>
+Copyright (c) 2008-2020 vaiorabbit  <http://twitter.com/vaiorabbit>
 
 This software is provided 'as-is', without any express or implied
 warranty. In no event will the authors be held liable for any damages

data/ext/rmath3d/RMtx3.h

@@ -72,7 +72,7 @@ void    RMtx3Scale( RMtx3* out, const RMtx3* m, rmReal f );
 
 /*
 RMath : Ruby math module for 3D Applications
-Copyright (c) 2008-2017 vaiorabbit  <http://twitter.com/vaiorabbit>
+Copyright (c) 2008-2020 vaiorabbit  <http://twitter.com/vaiorabbit>
 
 This software is provided 'as-is', without any express or implied
 warranty. In no event will the authors be held liable for any damages

data/ext/rmath3d/RMtx4.c

@@ -479,37 +479,42 @@ RMtx4LookAtRH( RMtx4* out, const RVec3* eye, const RVec3* at, const RVec3* up )
 }
 
 void
-RMtx4PerspectiveRH( RMtx4* out, rmReal width, rmReal height, rmReal znear, rmReal zfar )
+RMtx4PerspectiveRH( RMtx4* out, rmReal width, rmReal height, rmReal znear, rmReal zfar, bool ndc_homogeneous )
 {
-    RMtx4PerspectiveOffCenterRH( out, -width/2.0f, width/2.0f, -height/2.0f, height/2.0f, znear, zfar );
+    RMtx4PerspectiveOffCenterRH( out, -width/2.0f, width/2.0f, -height/2.0f, height/2.0f, znear, zfar, ndc_homogeneous );
 }
 
-/* http://pyopengl.sourceforge.net/documentation/manual/gluPerspective.3G.html
+/* https://www.khronos.org/registry/OpenGL-Refpages/gl2.1/xhtml/gluPerspective.xml
+   Game Programming in C++ (2018) https://www.oreilly.com/library/view/game-programming-in/9780134598185/
  */
 void
-RMtx4PerspectiveFovRH( RMtx4* out, rmReal fovy_radian, rmReal aspect, rmReal znear, rmReal zfar )
+RMtx4PerspectiveFovRH( RMtx4* out, rmReal fovy_radian, rmReal aspect, rmReal znear, rmReal zfar, bool ndc_homogeneous )
 {
     rmReal f = rmTan( fovy_radian / 2.0f );
     f = 1.0f / f;
 
+    rmReal C = ndc_homogeneous ? -(zfar+znear) / (zfar-znear) : zfar / -(zfar-znear);
+    rmReal D = ndc_homogeneous ? -(2*znear*zfar) / (zfar-znear) : -(znear*zfar) / (zfar-znear);
+
     RMtx4Identity( out );
     SET_ELEMENT( out, 0, 0, f / aspect );
     SET_ELEMENT( out, 1, 1, f );
-    SET_ELEMENT( out, 2, 2, (zfar+znear)/(znear-zfar) );
-    SET_ELEMENT( out, 2, 3, 2*zfar*znear/(znear-zfar) );
+    SET_ELEMENT( out, 2, 2, C );
+    SET_ELEMENT( out, 2, 3, D );
     SET_ELEMENT( out, 3, 2, -1.0f );
     SET_ELEMENT( out, 3, 3, 0.0f );
 }
 
-/* http://pyopengl.sourceforge.net/documentation/manual/glFrustum.3G.html
+/* https://www.khronos.org/registry/OpenGL-Refpages/gl2.1/xhtml/glFrustum.xml
+   Game Programming in C++ (2018) https://www.oreilly.com/library/view/game-programming-in/9780134598185/
  */
 void
-RMtx4PerspectiveOffCenterRH( RMtx4* out, rmReal left, rmReal right, rmReal bottom, rmReal top, rmReal znear, rmReal zfar )
+RMtx4PerspectiveOffCenterRH( RMtx4* out, rmReal left, rmReal right, rmReal bottom, rmReal top, rmReal znear, rmReal zfar, bool ndc_homogeneous )
 {
     rmReal A = (right+left) / (right-left);
     rmReal B = (top+bottom) / (top-bottom);
-    rmReal C = -(zfar+znear) / (zfar-znear);
-    rmReal D = -(2*znear*zfar) / (zfar-znear);
+    rmReal C = ndc_homogeneous ? -(zfar+znear) / (zfar-znear) : -zfar / (zfar-znear);
+    rmReal D = ndc_homogeneous ? -(2*znear*zfar) / (zfar-znear) : -(znear*zfar) / (zfar-znear);
 
     RMtx4Identity( out );
     SET_ELEMENT( out, 0, 0, 2*znear/(right-left) );
@@ -523,33 +528,34 @@ RMtx4PerspectiveOffCenterRH( RMtx4* out, rmReal left, rmReal right, rmReal botto
 }
 
 void
-RMtx4OrthoRH( RMtx4* out, rmReal width, rmReal height, rmReal znear, rmReal zfar )
+RMtx4OrthoRH( RMtx4* out, rmReal width, rmReal height, rmReal znear, rmReal zfar, bool ndc_homogeneous )
 {
-    RMtx4OrthoOffCenterRH( out, -width/2.0f, width/2.0f, -height/2.0f, height/2.0f, znear, zfar );
+    RMtx4OrthoOffCenterRH( out, -width/2.0f, width/2.0f, -height/2.0f, height/2.0f, znear, zfar, ndc_homogeneous );
 }
 
-/* http://pyopengl.sourceforge.net/documentation/manual/glOrtho.3G.html
+/* https://www.khronos.org/registry/OpenGL-Refpages/gl2.1/xhtml/glOrtho.xml
+   Game Programming in C++ (2018) https://www.oreilly.com/library/view/game-programming-in/9780134598185/
  */
 void
-RMtx4OrthoOffCenterRH( RMtx4* out, rmReal left, rmReal right, rmReal bottom, rmReal top, rmReal znear, rmReal zfar )
+RMtx4OrthoOffCenterRH( RMtx4* out, rmReal left, rmReal right, rmReal bottom, rmReal top, rmReal znear, rmReal zfar, bool ndc_homogeneous )
 {
-    rmReal tx = (right+left) / (right-left);
-    rmReal ty = (top+bottom) / (top-bottom);
-    rmReal tz = (zfar+znear) / (zfar-znear);
+    rmReal tx = -(right+left) / (right-left);
+    rmReal ty = -(top+bottom) / (top-bottom);
+    rmReal tz = ndc_homogeneous ? -(zfar+znear) / (zfar-znear) : -znear / (zfar-znear);
 
     RMtx4Identity( out );
     SET_ELEMENT( out, 0, 0, 2.0f/(right-left) );
     SET_ELEMENT( out, 0, 3, tx );
     SET_ELEMENT( out, 1, 1, 2.0f/(top-bottom) );
     SET_ELEMENT( out, 1, 3, ty );
-    SET_ELEMENT( out, 2, 2, -2.0f/(zfar-znear) );
+    SET_ELEMENT( out, 2, 2, -(ndc_homogeneous ? 2.0f : 1.0f)/(zfar-znear) );
     SET_ELEMENT( out, 2, 3, tz );
 }
 
 
 /*
 RMath : Ruby math module for 3D Applications
-Copyright (c) 2008-2017 vaiorabbit  <http://twitter.com/vaiorabbit>
+Copyright (c) 2008-2020 vaiorabbit  <http://twitter.com/vaiorabbit>
 
 This software is provided 'as-is', without any express or implied
 warranty. In no event will the authors be held liable for any damages

data/ext/rmath3d/RMtx4.h

@@ -2,6 +2,7 @@
 #ifndef RMATHMTX4_H_INCLUDED
 #define RMATHMTX4_H_INCLUDED
 
+#include <stdbool.h>
 #include "RType.h"
 
 struct RVec3;
@@ -71,11 +72,11 @@ void    RMtx4Mul( RMtx4* out, const RMtx4* m1, const RMtx4* m2 );
 void    RMtx4Scale( RMtx4* out, const RMtx4* m, rmReal f );
 
 void    RMtx4LookAtRH( RMtx4* out, const struct RVec3* eye, const struct RVec3* at, const struct RVec3* up );
-void    RMtx4PerspectiveRH( RMtx4* out, rmReal width, rmReal height, rmReal znear, rmReal zfar );
-void    RMtx4PerspectiveFovRH( RMtx4* out, rmReal fovy_radian, rmReal aspect, rmReal znear, rmReal zfar );
-void    RMtx4PerspectiveOffCenterRH( RMtx4* out, rmReal left, rmReal right, rmReal bottom, rmReal top, rmReal znear, rmReal zfar );
-void    RMtx4OrthoRH( RMtx4* out, rmReal width, rmReal height, rmReal znear, rmReal zfar );
-void    RMtx4OrthoOffCenterRH( RMtx4* out, rmReal left, rmReal right, rmReal bottom, rmReal top, rmReal znear, rmReal zfar );
+void    RMtx4PerspectiveRH( RMtx4* out, rmReal width, rmReal height, rmReal znear, rmReal zfar, bool ndc_homogeneous );
+void    RMtx4PerspectiveFovRH( RMtx4* out, rmReal fovy_radian, rmReal aspect, rmReal znear, rmReal zfar, bool ndc_homogeneous );
+void    RMtx4PerspectiveOffCenterRH( RMtx4* out, rmReal left, rmReal right, rmReal bottom, rmReal top, rmReal znear, rmReal zfar, bool ndc_homogeneous );
+void    RMtx4OrthoRH( RMtx4* out, rmReal width, rmReal height, rmReal znear, rmReal zfar, bool ndc_homogeneous );
+void    RMtx4OrthoOffCenterRH( RMtx4* out, rmReal left, rmReal right, rmReal bottom, rmReal top, rmReal znear, rmReal zfar, bool ndc_homogeneous );
 
 #ifdef __cplusplus
 }
@@ -87,7 +88,7 @@ void    RMtx4OrthoOffCenterRH( RMtx4* out, rmReal left, rmReal right, rmReal bot
 
 /*
 RMath : Ruby math module for 3D Applications
-Copyright (c) 2008-2017 vaiorabbit  <http://twitter.com/vaiorabbit>
+Copyright (c) 2008-2020 vaiorabbit  <http://twitter.com/vaiorabbit>
 
 This software is provided 'as-is', without any express or implied
 warranty. In no event will the authors be held liable for any damages

data/ext/rmath3d/RQuat.c

@@ -344,7 +344,7 @@ RQuatToAxisAngle( const RQuat* in, struct RVec3* axis, rmReal* radian )
 
 /*
 RMath : Ruby math module for 3D Applications
-Copyright (c) 2008-2017 vaiorabbit  <http://twitter.com/vaiorabbit>
+Copyright (c) 2008-2020 vaiorabbit  <http://twitter.com/vaiorabbit>
 
 This software is provided 'as-is', without any express or implied
 warranty. In no event will the authors be held liable for any damages

data/ext/rmath3d/RQuat.h

@@ -69,7 +69,7 @@ void    RQuatToAxisAngle( const RQuat* in, struct RVec3* axis, rmReal* radian );
 
 /*
 RMath : Ruby math module for 3D Applications
-Copyright (c) 2008-2017 vaiorabbit  <http://twitter.com/vaiorabbit>
+Copyright (c) 2008-2020 vaiorabbit  <http://twitter.com/vaiorabbit>
 
 This software is provided 'as-is', without any express or implied
 warranty. In no event will the authors be held liable for any damages

data/ext/rmath3d/RType.h

@@ -53,7 +53,7 @@ typedef double rmReal;
 
 /*
 RMath : Ruby math module for 3D Applications
-Copyright (c) 2008-2017 vaiorabbit  <http://twitter.com/vaiorabbit>
+Copyright (c) 2008-2020 vaiorabbit  <http://twitter.com/vaiorabbit>
 
 This software is provided 'as-is', without any express or implied
 warranty. In no event will the authors be held liable for any damages

data/ext/rmath3d/RVec2.c

@@ -144,7 +144,7 @@ RVec2Transform( RVec2* out, const RMtx2* m, const RVec2* in )
 
 /*
 RMath : Ruby math module for 3D Applications
-Copyright (c) 2008-2017 vaiorabbit  <http://twitter.com/vaiorabbit>.
+Copyright (c) 2008-2020 vaiorabbit  <http://twitter.com/vaiorabbit>.
 
 This software is provided 'as-is', without any express or implied
 warranty. In no event will the authors be held liable for any damages

data/ext/rmath3d/RVec2.h

@@ -57,7 +57,7 @@ void    RVec2Transform( struct RVec2* out, const struct RMtx2* m, const RVec2* i
 
 /*
 RMath : Ruby math module for 3D Applications
-Copyright (c) 2008-2017 vaiorabbit  <http://twitter.com/vaiorabbit>
+Copyright (c) 2008-2020 vaiorabbit  <http://twitter.com/vaiorabbit>
 
 This software is provided 'as-is', without any express or implied
 warranty. In no event will the authors be held liable for any damages

data/ext/rmath3d/RVec3.c

@@ -262,7 +262,7 @@ RVec3TransformByQuaternion( RVec3* out, const struct RQuat* q, const RVec3* in )
 
 /*
 RMath : Ruby math module for 3D Applications
-Copyright (c) 2008-2017 vaiorabbit  <http://twitter.com/vaiorabbit>.
+Copyright (c) 2008-2020 vaiorabbit  <http://twitter.com/vaiorabbit>.
 
 This software is provided 'as-is', without any express or implied
 warranty. In no event will the authors be held liable for any damages

data/ext/rmath3d/RVec3.h

@@ -66,7 +66,7 @@ void    RVec3TransformByQuaternion( RVec3* out, const struct RQuat* q, const RVe
 
 /*
 RMath : Ruby math module for 3D Applications
-Copyright (c) 2008-2017 vaiorabbit  <http://twitter.com/vaiorabbit>
+Copyright (c) 2008-2020 vaiorabbit  <http://twitter.com/vaiorabbit>
 
 This software is provided 'as-is', without any express or implied
 warranty. In no event will the authors be held liable for any damages

data/ext/rmath3d/RVec4.c

@@ -192,7 +192,7 @@ RVec4TransformTransposed( RVec4* out, const struct RMtx4* m, const RVec4* in )
 
 /*
 RMath : Ruby math module for 3D Applications
-Copyright (c) 2008-2017 vaiorabbit  <http://twitter.com/vaiorabbit>
+Copyright (c) 2008-2020 vaiorabbit  <http://twitter.com/vaiorabbit>
 
 This software is provided 'as-is', without any express or implied
 warranty. In no event will the authors be held liable for any damages

data/ext/rmath3d/RVec4.h

@@ -63,7 +63,7 @@ void    RVec4TransformTransposed( RVec4* out, const struct RMtx4* m, const RVec4
 
 /*
 RMath : Ruby math module for 3D Applications
-Copyright (c) 2008-2017 vaiorabbit  <http://twitter.com/vaiorabbit>
+Copyright (c) 2008-2020 vaiorabbit  <http://twitter.com/vaiorabbit>
 
 This software is provided 'as-is', without any express or implied
 warranty. In no event will the authors be held liable for any damages

data/ext/rmath3d/rmath3d.c

@@ -258,7 +258,7 @@ RMtx2_initialize( int argc, VALUE* argv, VALUE self )
 
     default:
     {
-        rb_raise( rb_eRuntimeError, "RMtx2_initialize : wrong # of arguments (%d)", argc );
+        rb_raise( rb_eArgError, "RMtx2_initialize : wrong # of arguments (%d)", argc );
         return Qnil;
     }
     break;
@@ -377,7 +377,7 @@ RMtx2_setElements( int argc, VALUE* argv, VALUE self )
 #ifdef RMATH_ENABLE_ARGUMENT_CHECK
     if ( argc != 4 )
     {
-        rb_raise( rb_eRuntimeError, "RMtx2_setElements : wrong # of arguments (%d)", argc );
+        rb_raise( rb_eArgError, "RMtx2_setElements : wrong # of arguments (%d)", argc );
         return Qnil;
     }
 #endif
@@ -1139,7 +1139,7 @@ RMtx3_initialize( int argc, VALUE* argv, VALUE self )
 
     default:
     {
-        rb_raise( rb_eRuntimeError, "RMtx3_initialize : wrong # of arguments (%d)", argc );
+        rb_raise( rb_eArgError, "RMtx3_initialize : wrong # of arguments (%d)", argc );
         return Qnil;
     }
     break;
@@ -1258,7 +1258,7 @@ RMtx3_setElements( int argc, VALUE* argv, VALUE self )
 #ifdef RMATH_ENABLE_ARGUMENT_CHECK
     if ( argc != 9 )
     {
-        rb_raise( rb_eRuntimeError, "RMtx3_setElements : wrong # of arguments (%d)", argc );
+        rb_raise( rb_eArgError, "RMtx3_setElements : wrong # of arguments (%d)", argc );
         return Qnil;
     }
 #endif
@@ -2227,7 +2227,7 @@ RMtx4_initialize( int argc, VALUE* argv, VALUE self )
 
     default:
     {
-        rb_raise( rb_eRuntimeError, "RMtx4_initialize : wrong # of arguments (%d)", argc );
+        rb_raise( rb_eArgError, "RMtx4_initialize : wrong # of arguments (%d)", argc );
         return Qnil;
     }
     break;
@@ -2348,7 +2348,7 @@ RMtx4_setElements( int argc, VALUE* argv, VALUE self )
 #ifdef RMATH_ENABLE_ARGUMENT_CHECK
     if ( argc != 16 )
     {
-        rb_raise( rb_eRuntimeError, "RMtx4_setElements : wrong # of arguments (%d)", argc );
+        rb_raise( rb_eArgError, "RMtx4_setElements : wrong # of arguments (%d)", argc );
         return Qnil;
     }
 #endif
@@ -3247,59 +3247,81 @@ RMtx4_lookAtRH( VALUE self, VALUE e, VALUE a, VALUE u )
 }
 
 /*
- * call-seq: perspectiveRH(width,height,znear,zfar) -> self
+ * call-seq: perspectiveRH(width,height,znear,zfar,ndc_homogeneous) -> self
  *
  * Builds a perspective projection matrix for a right-handed coordinate system from:
  * * View volume width (+width+)
  * * View volume height (+height+)
  * * Near clip plane distance (+znear+)
  * * Far clip plane distance (+zfar+)
+ * * Set true for the environment with Z coordinate ranges from -1 to +1 (OpenGL), and false otherwise (Direct3D, Metal) (+ndc_homogeneous+)
  */
 static VALUE
-RMtx4_perspectiveRH( VALUE self, VALUE w, VALUE h, VALUE zn, VALUE zf )
+RMtx4_perspectiveRH( int argc, VALUE* argv, VALUE self )
 {
+    VALUE w, h, zn, zf, ndch;
     RMtx4* m = NULL;
     rmReal width, height, znear, zfar;
+    bool ndc_homogeneous;
+
+    if (argc < 4 || argc > 5)
+    {
+        rb_raise(rb_eArgError, "RMtx4_perspectiveRH : wrong # of arguments (%d)", argc );
+    }
+
+    rb_scan_args(argc, argv, "41", &w, &h, &zn, &zf, &ndch);
 
     TypedData_Get_Struct( self, RMtx4, &RMtx4_type, m );
     width  = NUM2DBL(w);
     height = NUM2DBL(h);
     znear  = NUM2DBL(zn);
     zfar   = NUM2DBL(zf);
+    ndc_homogeneous = NIL_P(ndch) ? true : ((ndch == Qtrue) ? true : false);
 
-    RMtx4PerspectiveRH( m, width, height, znear, zfar );
+    RMtx4PerspectiveRH( m, width, height, znear, zfar, ndc_homogeneous );
 
     return self;
 }
 
 /*
- * call-seq: perspectiveFovRH(fovy,aspect,znear,zfar) -> self
+ * call-seq: perspectiveFovRH(fovy,aspect,znear,zfar,ndc_homogeneous) -> self
  *
  * Builds a perspective projection matrix for a right-handed coordinate system from:
  * * Field of view in y direction (+fovy+ radian)
  * * Aspect ratio (+aspect+)
  * * Near clip plane distance (+znear+)
  * * Far clip plane distance (+zfar+)
+ * * Set true for the environment with Z coordinate ranges from -1 to +1 (OpenGL), and false otherwise (Direct3D, Metal) (+ndc_homogeneous+)
  */
 static VALUE
-RMtx4_perspectiveFovRH( VALUE self, VALUE fovy, VALUE asp, VALUE zn, VALUE zf )
+RMtx4_perspectiveFovRH( int argc, VALUE* argv, VALUE self )
 {
+    VALUE fovy, asp, zn, zf, ndch;
     RMtx4* m = NULL;
     rmReal fovy_radian, aspect, znear, zfar;
+    bool ndc_homogeneous;
+
+    if (argc < 4 || argc > 5)
+    {
+        rb_raise(rb_eArgError, "RMtx4_perspectiveFovRH : wrong # of arguments (%d)", argc );
+    }
+
+    rb_scan_args(argc, argv, "41", &fovy, &asp, &zn, &zf, &ndch);
 
     TypedData_Get_Struct( self, RMtx4, &RMtx4_type, m );
     fovy_radian = NUM2DBL(fovy);
     aspect      = NUM2DBL(asp);
     znear       = NUM2DBL(zn);
     zfar        = NUM2DBL(zf);
+    ndc_homogeneous = NIL_P(ndch) ? true : ((ndch == Qtrue) ? true : false);
 
-    RMtx4PerspectiveFovRH( m, fovy_radian, aspect, znear, zfar );
+    RMtx4PerspectiveFovRH( m, fovy_radian, aspect, znear, zfar, ndc_homogeneous );
 
     return self;
 }
 
 /*
- * call-seq: perspectiveOffCenterRH(left,right,bottom,top,znear,zfar) -> self
+ * call-seq: perspectiveOffCenterRH(left,right,bottom,top,znear,zfar,ndc_homogeneous) -> self
  *
  * Builds a perspective projection matrix for a right-handed coordinate system from:
  * * Minimum value of the view volume width (+left+)
@@ -3308,12 +3330,22 @@ RMtx4_perspectiveFovRH( VALUE self, VALUE fovy, VALUE asp, VALUE zn, VALUE zf )
  * * Maximum value of the view volume height (+top+)
  * * Near clip plane distance (+znear+)
  * * Far clip plane distance (+zfar+)
+ * * Set true for the environment with Z coordinate ranges from -1 to +1 (OpenGL), and false otherwise (Direct3D, Metal) (+ndc_homogeneous+)
  */
 static VALUE
-RMtx4_perspectiveOffCenterRH( VALUE self, VALUE l, VALUE r, VALUE b, VALUE t, VALUE zn, VALUE zf )
+RMtx4_perspectiveOffCenterRH( int argc, VALUE* argv, VALUE self )
 {
+    VALUE l, r, b, t, zn, zf, ndch;
     RMtx4* m = NULL;
     rmReal left, right, bottom, top, znear, zfar;
+    bool ndc_homogeneous;
+
+    if (argc < 6 || argc > 7)
+    {
+        rb_raise(rb_eArgError, "RMtx4_perspectiveOffCenterRH : wrong # of arguments (%d)", argc );
+    }
+
+    rb_scan_args(argc, argv, "61", &l, &r, &b, &t, &zn, &zf, &ndch);
 
     TypedData_Get_Struct( self, RMtx4, &RMtx4_type, m );
     left   = NUM2DBL(l);
@@ -3322,39 +3354,52 @@ RMtx4_perspectiveOffCenterRH( VALUE self, VALUE l, VALUE r, VALUE b, VALUE t, VA
     top    = NUM2DBL(t);
     znear  = NUM2DBL(zn);
     zfar   = NUM2DBL(zf);
-    RMtx4PerspectiveOffCenterRH( m, left, right, bottom, top, znear, zfar );
+    ndc_homogeneous = NIL_P(ndch) ? true : ((ndch == Qtrue) ? true : false);
+
+    RMtx4PerspectiveOffCenterRH( m, left, right, bottom, top, znear, zfar, ndc_homogeneous );
 
     return self;
 }
 
 /*
- * call-seq: orthoRH(width,height,znear,zfar) -> self
+ * call-seq: orthoRH(width,height,znear,zfar,ndc_homogeneous) -> self
  *
  * Builds a orthogonal projection matrix for a right-handed coordinate system from:
  * * View volume width (+width+)
  * * View volume height (+height+)
  * * Near clip plane distance (+znear+)
  * * Far clip plane distance (+zfar+)
+ * * Set true for the environment with Z coordinate ranges from -1 to +1 (OpenGL), and false otherwise (Direct3D, Metal) (+ndc_homogeneous+)
  */
 static VALUE
-RMtx4_orthoRH( VALUE self, VALUE w, VALUE h, VALUE zn, VALUE zf )
+RMtx4_orthoRH( int argc, VALUE* argv, VALUE self )
 {
+    VALUE w, h, zn, zf, ndch;
     RMtx4* m = NULL;
     rmReal width, height, znear, zfar;
+    bool ndc_homogeneous;
+
+    if (argc < 4 || argc > 5)
+    {
+        rb_raise(rb_eArgError, "RMtx4_orthoRH : wrong # of arguments (%d)", argc );
+    }
+
+    rb_scan_args(argc, argv, "41", &w, &h, &zn, &zf, &ndch);
 
     TypedData_Get_Struct( self, RMtx4, &RMtx4_type, m );
     width  = NUM2DBL(w);
     height = NUM2DBL(h);
     znear  = NUM2DBL(zn);
     zfar   = NUM2DBL(zf);
+    ndc_homogeneous = NIL_P(ndch) ? true : ((ndch == Qtrue) ? true : false);
 
-    RMtx4OrthoRH( m, width, height, znear, zfar );
+    RMtx4OrthoRH( m, width, height, znear, zfar, ndc_homogeneous );
 
     return self;
 }
 
 /*
- * call-seq: orthoOffCenterRH(left,right,bottom,top,znear,zfar) -> self
+ * call-seq: orthoOffCenterRH(left,right,bottom,top,znear,zfar,ndc_homogeneous) -> self
  *
  * Builds a orthogonal projection matrix for a right-handed coordinate system from:
  * * Minimum value of the view volume width (+left+)
@@ -3363,12 +3408,22 @@ RMtx4_orthoRH( VALUE self, VALUE w, VALUE h, VALUE zn, VALUE zf )
  * * Maximum value of the view volume height (+top+)
  * * Near clip plane distance (+znear+)
  * * Far clip plane distance (+zfar+)
+ * * Set true for the environment with Z coordinate ranges from -1 to +1 (OpenGL), and false otherwise (Direct3D, Metal) (+ndc_homogeneous+)
  */
 static VALUE
-RMtx4_orthoOffCenterRH( VALUE self, VALUE l, VALUE r, VALUE b, VALUE t, VALUE zn, VALUE zf )
+RMtx4_orthoOffCenterRH( int argc, VALUE* argv, VALUE self )
 {
+    VALUE l, r, b, t, zn, zf, ndch;
     RMtx4* m = NULL;
     rmReal left, right, bottom, top, znear, zfar;
+    bool ndc_homogeneous;
+
+    if (argc < 6 || argc > 7)
+    {
+        rb_raise(rb_eArgError, "RMtx4_orthoOffCenterRH : wrong # of arguments (%d)", argc );
+    }
+
+    rb_scan_args(argc, argv, "61", &l, &r, &b, &t, &zn, &zf, &ndch);
 
     TypedData_Get_Struct( self, RMtx4, &RMtx4_type, m );
     left   = NUM2DBL(l);
@@ -3377,7 +3432,9 @@ RMtx4_orthoOffCenterRH( VALUE self, VALUE l, VALUE r, VALUE b, VALUE t, VALUE zn
     top    = NUM2DBL(t);
     znear  = NUM2DBL(zn);
     zfar   = NUM2DBL(zf);
-    RMtx4OrthoOffCenterRH( m, left, right, bottom, top, znear, zfar );
+    ndc_homogeneous = NIL_P(ndch) ? true : ((ndch == Qtrue) ? true : false);
+
+    RMtx4OrthoOffCenterRH( m, left, right, bottom, top, znear, zfar, ndc_homogeneous );
 
     return self;
 }
@@ -3734,7 +3791,7 @@ RQuat_initialize( int argc, VALUE* argv, VALUE self )
 
     default:
     {
-        rb_raise( rb_eRuntimeError, "RQuat_initialize : wrong # of arguments (%d)", argc );
+        rb_raise( rb_eArgError, "RQuat_initialize : wrong # of arguments (%d)", argc );
         return Qnil;
     }
     break;
@@ -4692,7 +4749,7 @@ RVec2_initialize( int argc, VALUE* argv, VALUE self )
 
     default:
     {
-        rb_raise( rb_eRuntimeError, "RVec2_initialize : wrong # of arguments (%d)", argc );
+        rb_raise( rb_eArgError, "RVec2_initialize : wrong # of arguments (%d)", argc );
         return Qnil;
     }
     break;
@@ -5392,7 +5449,7 @@ RVec3_initialize( int argc, VALUE* argv, VALUE self )
 
     default:
     {
-        rb_raise( rb_eRuntimeError, "RVec3_initialize : wrong # of arguments (%d)", argc );
+        rb_raise( rb_eArgError, "RVec3_initialize : wrong # of arguments (%d)", argc );
         return Qnil;
     }
     break;
@@ -6353,7 +6410,7 @@ RVec4_initialize( int argc, VALUE* argv, VALUE self )
 
     default:
     {
-        rb_raise( rb_eRuntimeError, "RVec4_initialize : wrong # of arguments (%d)", argc );
+        rb_raise( rb_eArgError, "RVec4_initialize : wrong # of arguments (%d)", argc );
         return Qnil;
     }
     break;
@@ -7324,11 +7381,11 @@ Init_rmath3d()
     rb_define_method( rb_cRMtx4, "scaling", RMtx4_scaling, 3 );
 
     rb_define_method( rb_cRMtx4, "lookAtRH", RMtx4_lookAtRH, 3 );
-    rb_define_method( rb_cRMtx4, "perspectiveRH", RMtx4_perspectiveRH, 4 );
-    rb_define_method( rb_cRMtx4, "perspectiveFovRH", RMtx4_perspectiveFovRH, 4 );
-    rb_define_method( rb_cRMtx4, "perspectiveOffCenterRH", RMtx4_perspectiveOffCenterRH, 6 );
-    rb_define_method( rb_cRMtx4, "orthoRH", RMtx4_orthoRH, 4 );
-    rb_define_method( rb_cRMtx4, "orthoOffCenterRH", RMtx4_orthoOffCenterRH, 6 );
+    rb_define_method( rb_cRMtx4, "perspectiveRH", RMtx4_perspectiveRH, -1 );
+    rb_define_method( rb_cRMtx4, "perspectiveFovRH", RMtx4_perspectiveFovRH, -1 );
+    rb_define_method( rb_cRMtx4, "perspectiveOffCenterRH", RMtx4_perspectiveOffCenterRH, -1 );
+    rb_define_method( rb_cRMtx4, "orthoRH", RMtx4_orthoRH, -1 );
+    rb_define_method( rb_cRMtx4, "orthoOffCenterRH", RMtx4_orthoOffCenterRH, -1 );
 
     rb_define_method( rb_cRMtx4, "+@", RMtx4_op_unary_plus, 0 );
     rb_define_method( rb_cRMtx4, "-@", RMtx4_op_unary_minus, 0 );
@@ -7544,7 +7601,7 @@ Init_rmath3d()
 
 /*
 RMath : Ruby math module for 3D Applications
-Copyright (c) 2008-2017 vaiorabbit  <http://twitter.com/vaiorabbit>
+Copyright (c) 2008-2020 vaiorabbit  <http://twitter.com/vaiorabbit>
 
 This software is provided 'as-is', without any express or implied
 warranty. In no event will the authors be held liable for any damages