rmath3d 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8ba56d50a0d57ad2687e2d3fb34278961e0524e5
-  data.tar.gz: d12e16143db7abb2ceb3018ebba52081b72631dd
+  metadata.gz: 9a700202c9e7eef16d28ce463264f47a59ba3faf
+  data.tar.gz: d49ce789c770777cf1e326d1e32c50c0d50d8b80
 SHA512:
-  metadata.gz: 442b329ea744cafb2ed79b33e1443d604dce6770dbe2f2fb39cda1921a738a84f20ae4575ef837ff8a93d030d53285fb387e80b7d9a06323a9674ed8862703a0
-  data.tar.gz: 801f92748ee33a253fbb0bf232ed1879d99ff6ee2fd76b34673fa7dadcd4a7d69e1166f094d917c04786b3ee06f7ed790d716ffe3a777642a6bc658369b48773
+  metadata.gz: 62d369ef680312199f91933deaea5f6aea82512ed7c075debd74bfa18fd027d2324dc878f29a77cf7f2fc8fa553510999479fbc5d3a98ad01cf64cbff169b1d5
+  data.tar.gz: 77bf3ebfe50445d49c5cfb6108b2e034a4bcbc414f2aa2ad2ed43c62a918d162697d453af602fb0033e445af1dbf13ba3d364a2261fced89b17e9efffe0cd3ca

data/ChangeLog

@@ -1,3 +1,8 @@
+2013-09-21  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* README.txt: Updated tested environment and information about building native extension.
+	* README.md: Renamed from README.txt
+
 2013-09-16  vaiorabbit  <http://twitter.com/vaiorabbit>
 
 	* sample/opengl-bingings: Added sample using my opengl-bindings gem ( https://rubygems.org/gems/opengl-bindings ).

data/Gemfile

@@ -0,0 +1,2 @@
+gemspec
+gem "rake"

data/README.md

@@ -0,0 +1,174 @@
+<!-- -*- mode:markdown; coding:utf-8; -*- -->
+
+# rmath3d : Ruby Math Module for 3D Applications #
+
+rmath3d is a math module for 3D game programming and computer graphics.
+
+*   Last Update: Sep 21, 2013
+*   Since: Jul 20, 2008
+
+## Features ##
+
+### Supports frequently-used vector and matrix classes ###
+
+*   RMtx3 (3x3 matrix)
+*   RMtx4 (4x4 matrix)
+*   RQuat (Quaternion)
+*   RVec3 (3 element vector)
+*   RVec4 (4 element vector)
+
+### Two implementations that are interchangeable with each other ###
+
+1. rmath3d.{so|bundle} : Ruby extension library for faster execution.
+2. rmath3d_plain.rb    : Ruby implemantation for debugging use.
+
+
+## Tested Environment ##
+
+Notice: This library provides native extension. You must setup develop environment (or DevKit) before installation.
+
+*   Ruby
+    *   ruby 2.0.0p247 (2013-06-27 revision 41674) [x86_64-darwin12.4.0]
+    *   ruby 2.0.0p247 (2013-06-27) [i386-mingw32] With Development Kit installed.
+        *   I used: DevKit-mingw64-32-4.7.2-20130224-1151-sfx.exe
+        *   Unpack the archive -> "> ruby dk.rb init" -> edit config.yml (just add your ruby foldier) -> "> ruby dk.rb install" 
+        *   Ref.: http://blog.mattwynne.net/2010/10/12/installing-ruby-gems-with-native-extensions-on-windows/
+
+## Building rmath3d.{so|bundle} ##
+
+Via RubyGems ( https://rubygems.org/gems/opengl-bindings ):
+
+    $ gem install opengl-bindings
+
+### From source package ###
+
+    $ rake install
+
+### For mkmf users ###
+
+    $ ruby extconf.rb
+    $ make
+
+For Windows users, type commands below via the "Visual Studio 200{5|8}
+Command Prompt". This process requires "cl.exe", "link.exe and
+"mt.exe" to be exist in the program PATH:
+
+    X:\> ruby extconf.rb
+    X:\> nmake
+
+You might encounter the "MSC version unmatch: _MSC_VER: XXXX is
+expected." error at the time compiling "rmath3d.c". See the
+instruction in the extconf.rb to avoid this error.
+
+
+### Embedding manifest file (For Windows users) ###
+
+Make sure that your rmath3d.so has "rmath3d.so.manifest" embedded into itself.
+Otherwise, while using rmath3d.so in your application, you might come
+across an error dialog saying:
+
+    ---------------------------
+    Microsoft Visual C++ Runtime Library
+    ---------------------------
+    Runtime Error!
+    
+    Program: d:\ruby\bin\ruby.exe
+    
+    R6034
+    An application has made an attempt to load the C runtime library incorrectly.
+    Please contact the application's support team for more information.
+    
+    ---------------------------
+    OK   
+    ---------------------------
+
+To ensure the file status, try checking if the string "manifest" can
+be found in the file:
+
+    X:\> strings rmath3d.so | grep manifest
+
+If you don't see any outputs, it's time to embed "rmath3d.so.manifest". 
+
+    X:\> mt -manifest rmath3d.so.manifest -outputresource:rmath3d.so;2
+
+or run the "embed_manifest.bat" instead. Then check again the status.
+
+    X:\> strings rmath3d.so | grep manifest
+    <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
+    
+    X:\> 
+
+If you see some similar output like that, the manifest file
+"rmath3d.so.manifest" is successfully embedded.
+
+
+## About rmath3d_plain.rb ##
+
+rmath3d_plain.rb is a pure Ruby version of rmath3d.so: all the functionality of
+rmath3d.so is implemented with plain Ruby code.
+It is possible to trace the bugs caused by rmath3d.so by replacing the code
+
+    gem 'rmath3d'
+    require 'rmath3d/rmath3d'
+
+with
+
+    gem 'rmath3d'
+    require 'rmath3d/rmath3d_plain'
+
+rmath3d_plain.rb performs more strict type checking, that might be some burden
+for its execution speed. So don't expect the performance efficiency
+when you use rmath3d_plain.rb instead of rmath3d.so.
+
+
+## Notes ##
+
+### Collaboration with ruby-opengl ###
+
+The instances of RMtx4 can be used directly as the arguments of the
+ruby-opengl functions that accept matrices.
+
+For example, this code snippet using RMath:
+
+    eye = RVec3.new(0.0, 15.0, 15.0)
+    at  = RVec3.new(0.0,  0.0,  0.0)
+    up  = RVec3.new(0.0,  1.0,  0.0)
+    mtxLookAt = RMtx4.new.lookAtRH( eye, at, up )
+    glMatrixMode( GL_PROJECTION )
+    glLoadMatrix( @mtxProj )
+    
+    mtxProj = RMtx4.new.perspectiveFovRH( 30.0*Math::PI/180.0, WINDOW_WIDTH/WINDOW_HEIGHT, 0.1, 1000.0 )
+    glMatrixMode( GL_MODELVIEW )
+    glLoadMatrix( @mtxLookAt )
+
+has the same transformation effect with the OpenGL fixed pipeline:
+
+    glMatrixMode( GL_PROJECTION )
+    gluPerspective( 30.0*Math::PI/180.0, WINDOW_WIDTH/WINDOW_HEIGHT, 0.1, 1000.0 )
+    
+    glMatrixMode( GL_MODELVIEW )
+    gluLookAt( 0.0,15.0,15.0, 0.0,0.0,0.0, 0.0,1.0,0.0 )
+
+
+### Compatibility with matrix.rb ###
+
+Currently, there is no combenient way to convert between matrix.rb's
++Matrix+ and +RMtx{3|4}".
+
+(The matrix.rb is a standard Ruby library that provides N-dimensional
++Vector+ class and "N x M" +Matrix+ class.)
+
+
+
+## Information ##
+
+*   RubyGems
+	*   https://rubygems.org/gems/opengl-bindings
+*   Github
+	*   https://github.com/vaiorabbit/rmath3d
+
+ 
+## License ##
+
+All source codes are available under the terms of the zlib/libpng license
+(see LICENSE.txt).

metadata

@@ -1,17 +1,18 @@
 --- !ruby/object:Gem::Specification
 name: rmath3d
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - vaiorabbit
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-09-16 00:00:00.000000000 Z
+date: 2013-09-21 00:00:00.000000000 Z
 dependencies: []
 description: |
   Provides vector3/4, matrix3x3/4x4 and quaternion in C extension library form (and plain Ruby form with the same interface for debugging use).
+  Notice: This library provides native extension. You must setup development environment (or DevKit) before installation.
 email:
 - vaiorabbit@gmail.com
 executables: []
@@ -45,8 +46,9 @@ files:
 - test/test_RVec4.rb
 - ChangeLog
 - LICENSE.txt
-- README.txt
+- README.md
 - Rakefile
+- Gemfile
 homepage: https://github.com/vaiorabbit/rmath3d
 licenses:
 - zlib/libpng
@@ -67,7 +69,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.5
+rubygems_version: 2.1.4
 signing_key: 
 specification_version: 4
 summary: Ruby Math Module for 3D Applications

data/README.txt

@@ -1,154 +0,0 @@
-=            rmath3d : Ruby Math Module for 3D Applications
-
-rmath3d is a math module for 3D game programming and computer graphics.
-
-                                             Last Update: Sep 16, 2013
-                                                   Since: Jul 20, 2008
-                                                   by vaiorabbit
-== Features
-
-=== Supports frequently-used vector and matrix classes
-
-* RMtx3 (3x3 matrix)
-* RMtx4 (4x4 matrix)
-* RQuat (Quaternion)
-* RVec3 (3 element vector)
-* RVec4 (4 element vector)
-
-=== Two implementations that are interchangeable with each other
-
-1. rmath3d.{so|bundle} : Ruby extension library for faster execution.
-2. rmath3d_plain.rb    : Ruby implemantation for debugging use.
-
-
-== Building rmath3d.{so|bundle}
-
-=== From source package
-
-  $ rake install
-
-=== For mkmf users
-
-  $ ruby extconf.rb
-  $ make
-
-For Windows users, type commands below via the "Visual Studio 200{5|8}
-Command Prompt". This process requires "cl.exe", "link.exe and
-"mt.exe" to be exist in the program PATH:
-
-  X:\> ruby extconf.rb
-  X:\> nmake
-
-You might encounter the "MSC version unmatch: _MSC_VER: XXXX is
-expected." error at the time compiling "rmath3d.c". See the
-instruction in the extconf.rb to avoid this error.
-
-
-=== Embedding manifest file (For Windows users)
-
-Make sure that your rmath3d.so has "rmath3d.so.manifest" embedded into itself.
-Otherwise, while using rmath3d.so in your application, you might come
-across an error dialog saying:
-
-  ---------------------------
-  Microsoft Visual C++ Runtime Library
-  ---------------------------
-  Runtime Error!
-  
-  Program: d:\ruby\bin\ruby.exe
-  
-  R6034
-  An application has made an attempt to load the C runtime library incorrectly.
-  Please contact the application's support team for more information.
-  
-  ---------------------------
-  OK   
-  ---------------------------
-
-To ensure the file status, try checking if the string "manifest" can
-be found in the file:
-
-  X:\> strings rmath3d.so | grep manifest
-
-If you don't see any outputs, it's time to embed "rmath3d.so.manifest". 
-
-  X:\> mt -manifest rmath3d.so.manifest -outputresource:rmath3d.so;2
-
-or run the "embed_manifest.bat" instead. Then check again the status.
-
-  X:\> strings rmath3d.so | grep manifest
-  <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
-
-  X:\> 
-
-If you see some similar output like that, the manifest file
-"rmath3d.so.manifest" is successfully embedded.
-
-
-== About rmath3d_plain.rb
-
-rmath3d_plain.rb is a pure Ruby version of rmath3d.so: all the functionality of
-rmath3d.so is implemented with plain Ruby code.
-It is possible to trace the bugs caused by rmath3d.so by replacing the code
-
-  gem 'rmath3d'
-  require 'rmath3d/rmath3d'
-
-with
-
-  gem 'rmath3d'
-  require 'rmath3d/rmath3d_plain'
-
-rmath3d_plain.rb performs more strict type checking, that might be some burden
-for its execution speed. So don't expect the performance efficiency
-when you use rmath3d_plain.rb instead of rmath3d.so.
-
-
-== Notes
-
-=== Collaboration with ruby-opengl
-
-The instances of RMtx4 can be used directly as the arguments of the
-ruby-opengl functions that accept matrices.
-
-For example, this code snippet using RMath:
-
-  eye = RVec3.new(0.0, 15.0, 15.0)
-  at  = RVec3.new(0.0,  0.0,  0.0)
-  up  = RVec3.new(0.0,  1.0,  0.0)
-  mtxLookAt = RMtx4.new.lookAtRH( eye, at, up )
-  glMatrixMode( GL_PROJECTION )
-  glLoadMatrix( @mtxProj )
-  
-  mtxProj = RMtx4.new.perspectiveFovRH( 30.0*Math::PI/180.0, WINDOW_WIDTH/WINDOW_HEIGHT, 0.1, 1000.0 )
-  glMatrixMode( GL_MODELVIEW )
-  glLoadMatrix( @mtxLookAt )
-
-has the same transformation effect with the OpenGL fixed pipeline:
-
-  glMatrixMode( GL_PROJECTION )
-  gluPerspective( 30.0*Math::PI/180.0, WINDOW_WIDTH/WINDOW_HEIGHT, 0.1, 1000.0 )
-
-  glMatrixMode( GL_MODELVIEW )
-  gluLookAt( 0.0,15.0,15.0, 0.0,0.0,0.0, 0.0,1.0,0.0 )
-
-
-=== Compatibility with matrix.rb
-
-Currently, there is no combenient way to convert between matrix.rb's
-+Matrix+ and +RMtx{3|4}".
-
-(The matrix.rb is a standard Ruby library that provides N-dimensional
-+Vector+ class and "N x M" +Matrix+ class.)
-
-
-
-== Credits
-
-* vaiorabbit  <http://twitter.com/vaiorabbit>
-
- 
-== License
-
-All source codes are available under the terms of the zlib/libpng license
-(see LICENSE.txt).