raylib-bindings 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a24ae09d1d8e13d58febdd5d222b7c219291c49531939bddccdcd89079bb4943
-  data.tar.gz: 536927a5880fa2ed1a7007951fd505bbe81cb0263011c9ead49912e484938d2d
+  metadata.gz: ec140a3aeb14467dddc0851eb6dc9b26f1e189955eda32aede4cdb9068163d2a
+  data.tar.gz: 9edeefc3c423bb8436b9d0a3779c86abe584a0c719090a8819dd8489689079db
 SHA512:
-  metadata.gz: 3b38f484780698c0ae0ceb9a9f79ae31d5eb86a883df27434f61e96b3e75b50e6d5c285e9e83196852c5b4ca9597a355b7bf1627c66a8d07ddbff3cd44b15328
-  data.tar.gz: 29fb98821c8a10b45ae37b81aadd1ccba54864ed962990e0ebd424dd6f0d100b06e32057de13775155c3be0607e81f34f620ea71174140bf74d99f8f87ba489b
+  metadata.gz: 6f46201e5a1c794a319ccae7008220e092837aa860040710d9ba41ff5836bf81c179d48ba72994cf863ce9dce393134d1218e237b76c4f414de6422ddd19bf19
+  data.tar.gz: 349f290348f0fe2ac8690dd2bf712a2d1a41f979f4c95e4ca5a1cf7d85dcdd278714688aa359112a845960549870d0deb4775ef88642c4e567b1999966c515ce

data/ChangeLog

@@ -1,3 +1,25 @@
+2022-12-30  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* generator: Now generates binding code for config.h
+
+2022-12-29  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* generator: Now generates enum descriptions
+	* Fixed several codes according to Rubocop warnings
+	* lib/raylib_helper.rb: Added several helper functions/classes
+
+2022-12-25  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* Converted DrawModelEx into a wrapper function of rbDrawModelEx to avoid Matrix problem found in models_animation sample
+	* Attach functions with an explicit name - Ref.: https://www.rubydoc.info/github/ffi/ffi/FFI%2FLibrary:attach_function
+	* setup_xxx_symbols: name, retval and arguments of one function are now packed into one line
+	* generator: Now imports descriptions from original API schema
+	* Generated with the latest raylib ( https://github.com/raysan5/raylib/commit/03cc540d5f1df71bd7ad8118d0e11b492fa5cc18 )
+
+2022-12-24  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* Experimental Linux (Chromebook) support
+
 2022-12-10  vaiorabbit  <http://twitter.com/vaiorabbit>
 
 	* Pulled latest raylib ( https://github.com/raysan5/raylib/commit/2c9d116a5ce835328dc3267313f1b34b2e7ad8c9 ) / and raygui ( https://github.com/raysan5/raygui/commit/64179558e425f6e05054d2a70eb12530e0fec103 )

data/LICENSE.txt

@@ -1,5 +1,5 @@
 Ruby-raylib : Yet another raylib wrapper for Ruby
-Copyright (c) 2021-2022 vaiorabbit <http://twitter.com/vaiorabbit>
+Copyright (c) 2021-2023 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

@@ -3,7 +3,7 @@
 # Yet another raylib wrapper for Ruby #
 
 *   Created : 2021-10-17
-*   Last modified : 2022-12-10
+*   Last modified : 2022-12-31
 
 Provides Ruby bindings for raylib-related libraries including:
 
@@ -45,9 +45,9 @@ D:\> ruby template.rb
 *   Ruby interpreter
     *   Tested on:
         *   [macOS]
-            *   ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [arm64-darwin21]
+            *   ruby 3.2.0 (2022-12-25 revision a528908271) [arm64-darwin21]
         *   [Windows] https://rubyinstaller.org/downloads/ Ruby+Devkit
-            *   ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [x64-mingw-ucrt]
+            *   ruby 3.2.0 (2022-12-25 revision a528908271) [x64-mingw-ucrt]
 
 *   If you need to build DLLs/shared libralies for your own runtime envrioenment (Linux, etc.):
     *   CMake https://cmake.org/download/
@@ -63,7 +63,7 @@ D:\> ruby template.rb
 
             *   [Windows] gcc
 
-                    gcc (Rev10, Built by MSYS2 project) 11.2.0
+                    gcc (Rev7, Built by MSYS2 project) 12.2.0
 
 
 <details>
@@ -72,9 +72,11 @@ D:\> ruby template.rb
 *   Ruby interpreter
     *   Tested on:
         *   [macOS]
+            *   ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [arm64-darwin21]
             *   ruby 3.1.0p0 (2021-12-25 revision fb4df44d16) [arm64-darwin20]
             *   ruby 3.0.2p107 (2021-07-07 revision 0db68f0233) [arm64-darwin20]
         *   [Windows] https://rubyinstaller.org/downloads/ Ruby+Devkit
+            *   ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [x64-mingw-ucrt]
             *   ruby 3.1.1p18 (2022-02-18 revision 53f5fc4236) [x64-mingw-ucrt]
             *   ruby 3.0.2p107 (2021-07-07 revision 0db68f0233) [x64-mingw32]
 
@@ -96,9 +98,18 @@ D:\> ruby template.rb
         *   [Windows] gcc
 
                 gcc (Rev9, Built by MSYS2 project) 11.2.0
+                gcc (Rev10, Built by MSYS2 project) 11.2.0
 
 </details>
 
+## Project ##
+
+See the project below to learn how to use this library:
+
+*   Whac-a-Mole! : Ruby raylib bindings demo
+    *   <img src="https://raw.githubusercontent.com/vaiorabbit/raylib-bindings-whacamole/main/doc/screenshot_00.png" width="300"> <img src="https://raw.githubusercontent.com/vaiorabbit/raylib-bindings-whacamole/main/doc/screenshot_01.png" width="300">
+    *   <https://github.com/vaiorabbit/raylib-bindings-whacamole>
+
 ## Limitation ##
 
 *   `SetTraceLogCallback` and `TraceLogCallback` are unusable since Ruby-FFI does not support `:varargs` parameter in callbacks (`Proc`, etc.)
@@ -121,7 +132,7 @@ Shared libraries in `lib` directory are built on top of these products and are a
 All ruby codes here are available under the terms of the zlib/libpng License ( http://opensource.org/licenses/Zlib ).
 
     Ruby-raylib : Yet another raylib wrapper for Ruby
-    Copyright (c) 2021-2022 vaiorabbit <http://twitter.com/vaiorabbit>
+    Copyright (c) 2021-2023 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/examples/template.rb

@@ -20,6 +20,8 @@ when /mswin|msys|mingw|cygwin/
   Raylib.load_lib(shared_lib_path + 'libraylib.dll', raygui_libpath: shared_lib_path + 'raygui.dll', physac_libpath: shared_lib_path + 'physac.dll')
 when /darwin/
   Raylib.load_lib(shared_lib_path + 'libraylib.dylib', raygui_libpath: shared_lib_path + 'raygui.dylib', physac_libpath: shared_lib_path + 'physac.dylib')
+when /linux/
+  Raylib.load_lib(shared_lib_path + 'libraylib.so', raygui_libpath: shared_lib_path + 'raygui.so', physac_libpath: shared_lib_path + 'physac.so')
 else
   raise RuntimeError, "Unknown OS: #{RUBY_PLATFORM}"
 end
@@ -37,11 +39,11 @@ if __FILE__ == $PROGRAM_NAME
   # Camera
   camera = Camera.new
   reset_camera = lambda {
-    camera[:position] = Vector3.create(0.0, 10.0, 10.0)
-    camera[:target] = Vector3.create(0.0, 0.0, 0.0)
-    camera[:up] = Vector3.create(0.0, 1.0, 0.0)
-    camera[:fovy] = 45.0
-    camera[:projection] = CAMERA_PERSPECTIVE
+    camera.position.set(0.0, 10.0, 10.0)
+    camera.target.set(0.0, 0.0, 0.0)
+    camera.up.set(0.0, 1.0, 0.0)
+    camera.fovy = 45.0
+    camera.projection = CAMERA_PERSPECTIVE
   }
   reset_camera.call
   SetCameraMode(camera, CAMERA_FREE)
@@ -76,29 +78,29 @@ if __FILE__ == $PROGRAM_NAME
     move[:z] += speed if IsKeyDown(KEY_DOWN)
     move[:z] -= speed if IsKeyDown(KEY_UP)
 
-    to_camera = Vector3Normalize(Vector3.create(camera[:position][:x], 0, camera[:position][:z]))
+    to_camera = Vector3Normalize(Vector3.create(camera.position.x, 0, camera.position.z))
     rotate_y = QuaternionFromVector3ToVector3(Vector3.create(0, 0, 1), to_camera)
     move = Vector3RotateByQuaternion(move, rotate_y)
 
     player_pos = Vector3Add(player_pos, move)
-    player_screen_pos = GetWorldToScreen(Vector3.create(player_pos[:x], player_pos[:y] + 2.5, player_pos[:z]), camera)
+    player_screen_pos = GetWorldToScreen(Vector3.create(player_pos.x, player_pos.y + 2.5, player_pos.z), camera)
 
     # Check collision status
     collision = false
 
-    player_bbox = BoundingBox.create(player_pos[:x] - player_size[:x]/2,
-                                     player_pos[:y] - player_size[:y]/2,
-                                     player_pos[:z] - player_size[:z]/2,
-                                     player_pos[:x] + player_size[:x]/2,
-                                     player_pos[:y] + player_size[:y]/2,
-                                     player_pos[:z] + player_size[:z]/2)
+    player_bbox = BoundingBox.create(player_pos.x - player_size.x/2,
+                                     player_pos.y - player_size.y/2,
+                                     player_pos.z - player_size.z/2,
+                                     player_pos.x + player_size.x/2,
+                                     player_pos.y + player_size.y/2,
+                                     player_pos.z + player_size.z/2)
 
-    obstacle_cube_bbox = BoundingBox.create(obstacle_cube_pos[:x] - obstacle_cube_size[:x]/2,
-                                            obstacle_cube_pos[:y] - obstacle_cube_size[:y]/2,
-                                            obstacle_cube_pos[:z] - obstacle_cube_size[:z]/2,
-                                            obstacle_cube_pos[:x] + obstacle_cube_size[:x]/2,
-                                            obstacle_cube_pos[:y] + obstacle_cube_size[:y]/2,
-                                            obstacle_cube_pos[:z] + obstacle_cube_size[:z]/2)
+    obstacle_cube_bbox = BoundingBox.create(obstacle_cube_pos.x - obstacle_cube_size.x/2,
+                                            obstacle_cube_pos.y - obstacle_cube_size.y/2,
+                                            obstacle_cube_pos.z - obstacle_cube_size.z/2,
+                                            obstacle_cube_pos.x + obstacle_cube_size.x/2,
+                                            obstacle_cube_pos.y + obstacle_cube_size.y/2,
+                                            obstacle_cube_pos.z + obstacle_cube_size.z/2)
 
     # Check collisions player vs obstacle_cube
     collision = true if CheckCollisionBoxes(player_bbox, obstacle_cube_bbox)
@@ -118,8 +120,8 @@ if __FILE__ == $PROGRAM_NAME
         DrawCube(player_pos, 2.0, 2.0, 2.0, collision ? Fade(ruby_red, 0.25) : ruby_red)
         DrawCubeWires(player_pos, 2.0, 2.0, 2.0, MAROON)
         # Obstacle cube
-        DrawCube(obstacle_cube_pos, obstacle_cube_size[:x], obstacle_cube_size[:y], obstacle_cube_size[:z], GRAY)
-        DrawCubeWires(obstacle_cube_pos, obstacle_cube_size[:x], obstacle_cube_size[:y], obstacle_cube_size[:z], DARKGRAY)
+        DrawCube(obstacle_cube_pos, obstacle_cube_size.x, obstacle_cube_size.y, obstacle_cube_size.z, GRAY)
+        DrawCubeWires(obstacle_cube_pos, obstacle_cube_size.x, obstacle_cube_size.y, obstacle_cube_size.z, DARKGRAY)
         # Obstacle sphere
         DrawSphere(obstacle_sphere_pos, obstacle_sphere_size, GRAY)
         DrawSphereWires(obstacle_sphere_pos, obstacle_sphere_size, 16, 16, DARKGRAY)
@@ -129,7 +131,7 @@ if __FILE__ == $PROGRAM_NAME
 
       ## HUD
       # Text over the red cube
-      DrawText("Player HP: 100 / 100", player_screen_pos[:x] - MeasureText("Player HP: 100/100", 20)/2, player_screen_pos[:y], 20, BLACK)
+      DrawText("Player HP: 100 / 100", player_screen_pos.x - MeasureText("Player HP: 100/100", 20)/2, player_screen_pos.y, 20, BLACK)
       # Help message
       DrawRectangle(10, screen_height - 100, 300, 80, Fade(MAROON, 0.25))
       DrawRectangleLines(10, screen_height - 100, 300, 80, ruby_red)

data/lib/config.rb

@@ -0,0 +1,98 @@
+# Yet another raylib wrapper for Ruby
+#
+# * https://github.com/vaiorabbit/raylib-bindings
+#
+# [NOTICE] Autogenerated. Do not edit.
+
+require 'ffi'
+
+module Raylib
+  extend FFI::Library
+
+  # Define/Macro
+
+  SUPPORT_MODULE_RSHAPES = 1
+  SUPPORT_MODULE_RTEXTURES = 1
+  SUPPORT_MODULE_RTEXT = 1 # WARNING: It requires SUPPORT_MODULE_RTEXTURES to load sprite font textures
+  SUPPORT_MODULE_RMODELS = 1
+  SUPPORT_MODULE_RAUDIO = 1
+  SUPPORT_CAMERA_SYSTEM = 1
+  SUPPORT_GESTURES_SYSTEM = 1
+  SUPPORT_MOUSE_GESTURES = 1
+  SUPPORT_SSH_KEYBOARD_RPI = 1
+  SUPPORT_WINMM_HIGHRES_TIMER = 1
+  SUPPORT_PARTIALBUSY_WAIT_LOOP = 1
+  SUPPORT_SCREEN_CAPTURE = 1
+  SUPPORT_GIF_RECORDING = 1
+  SUPPORT_COMPRESSION_API = 1
+  MAX_FILEPATH_CAPACITY = 8192 # Maximum file paths capacity
+  MAX_FILEPATH_LENGTH = 4096 # Maximum length for filepaths (Linux PATH_MAX default value)
+  MAX_KEYBOARD_KEYS = 512 # Maximum number of keyboard keys supported
+  MAX_MOUSE_BUTTONS = 8 # Maximum number of mouse buttons supported
+  MAX_GAMEPADS = 4 # Maximum number of gamepads supported
+  MAX_GAMEPAD_AXIS = 8 # Maximum number of axis supported (per gamepad)
+  MAX_GAMEPAD_BUTTONS = 32 # Maximum number of buttons supported (per gamepad)
+  MAX_TOUCH_POINTS = 8 # Maximum number of touch points supported
+  MAX_KEY_PRESSED_QUEUE = 16 # Maximum number of keys in the key input queue
+  MAX_CHAR_PRESSED_QUEUE = 16 # Maximum number of characters in the char input queue
+  MAX_DECOMPRESSION_SIZE = 64 # Max size allocated for decompression in MB
+  RL_DEFAULT_BATCH_BUFFERS = 1 # Default number of batch buffers (multi-buffering)
+  RL_DEFAULT_BATCH_DRAWCALLS = 256 # Default number of batch draw calls (by state changes: mode, texture)
+  RL_DEFAULT_BATCH_MAX_TEXTURE_UNITS = 4 # Maximum number of textures units that can be activated on batch drawing (SetShaderValueTexture())
+  RL_MAX_MATRIX_STACK_SIZE = 32 # Maximum size of internal Matrix stack
+  RL_MAX_SHADER_LOCATIONS = 32 # Maximum number of shader locations supported
+  RL_CULL_DISTANCE_NEAR = 0.01 # Default projection matrix near cull distance
+  RL_CULL_DISTANCE_FAR = 1000.0 # Default projection matrix far cull distance
+  RL_DEFAULT_SHADER_ATTRIB_NAME_POSITION = "vertexPosition" # Binded by default to shader location: 0
+  RL_DEFAULT_SHADER_ATTRIB_NAME_TEXCOORD = "vertexTexCoord" # Binded by default to shader location: 1
+  RL_DEFAULT_SHADER_ATTRIB_NAME_NORMAL = "vertexNormal" # Binded by default to shader location: 2
+  RL_DEFAULT_SHADER_ATTRIB_NAME_COLOR = "vertexColor" # Binded by default to shader location: 3
+  RL_DEFAULT_SHADER_ATTRIB_NAME_TANGENT = "vertexTangent" # Binded by default to shader location: 4
+  RL_DEFAULT_SHADER_ATTRIB_NAME_TEXCOORD2 = "vertexTexCoord2" # Binded by default to shader location: 5
+  RL_DEFAULT_SHADER_UNIFORM_NAME_MVP = "mvp" # model-view-projection matrix
+  RL_DEFAULT_SHADER_UNIFORM_NAME_VIEW = "matView" # view matrix
+  RL_DEFAULT_SHADER_UNIFORM_NAME_PROJECTION = "matProjection" # projection matrix
+  RL_DEFAULT_SHADER_UNIFORM_NAME_MODEL = "matModel" # model matrix
+  RL_DEFAULT_SHADER_UNIFORM_NAME_NORMAL = "matNormal" # normal matrix (transpose(inverse(matModelView))
+  RL_DEFAULT_SHADER_UNIFORM_NAME_COLOR = "colDiffuse" # color diffuse (base tint color, multiplied by texture color)
+  RL_DEFAULT_SHADER_SAMPLER2D_NAME_TEXTURE0 = "texture0" # texture0 (texture slot active 0)
+  RL_DEFAULT_SHADER_SAMPLER2D_NAME_TEXTURE1 = "texture1" # texture1 (texture slot active 1)
+  RL_DEFAULT_SHADER_SAMPLER2D_NAME_TEXTURE2 = "texture2" # texture2 (texture slot active 2)
+  SUPPORT_QUADS_DRAW_MODE = 1
+  SUPPORT_FILEFORMAT_PNG = 1
+  SUPPORT_FILEFORMAT_GIF = 1
+  SUPPORT_FILEFORMAT_QOI = 1
+  SUPPORT_FILEFORMAT_DDS = 1
+  SUPPORT_FILEFORMAT_HDR = 1
+  SUPPORT_IMAGE_EXPORT = 1
+  SUPPORT_IMAGE_GENERATION = 1
+  SUPPORT_IMAGE_MANIPULATION = 1
+  SUPPORT_DEFAULT_FONT = 1
+  SUPPORT_FILEFORMAT_FNT = 1
+  SUPPORT_FILEFORMAT_TTF = 1
+  SUPPORT_TEXT_MANIPULATION = 1
+  MAX_TEXT_BUFFER_LENGTH = 1024 # Size of internal static buffers used on some functions:
+  MAX_TEXTSPLIT_COUNT = 128 # Maximum number of substrings to split: TextSplit()
+  SUPPORT_FILEFORMAT_OBJ = 1
+  SUPPORT_FILEFORMAT_MTL = 1
+  SUPPORT_FILEFORMAT_IQM = 1
+  SUPPORT_FILEFORMAT_GLTF = 1
+  SUPPORT_FILEFORMAT_VOX = 1
+  SUPPORT_FILEFORMAT_M3D = 1
+  SUPPORT_MESH_GENERATION = 1
+  MAX_MATERIAL_MAPS = 12 # Maximum number of shader maps supported
+  MAX_MESH_VERTEX_BUFFERS = 7 # Maximum vertex buffers (VBO) per mesh
+  SUPPORT_FILEFORMAT_WAV = 1
+  SUPPORT_FILEFORMAT_OGG = 1
+  SUPPORT_FILEFORMAT_XM = 1
+  SUPPORT_FILEFORMAT_MOD = 1
+  SUPPORT_FILEFORMAT_MP3 = 1
+  AUDIO_DEVICE_FORMAT = "ma_format_f32" # Device output format (miniaudio: float-32bit)
+  AUDIO_DEVICE_CHANNELS = 2 # Device output channels: stereo
+  AUDIO_DEVICE_SAMPLE_RATE = 0 # Device sample rate (device default)
+  MAX_AUDIO_BUFFER_POOL_CHANNELS = 16 # Maximum number of audio pool channels
+  SUPPORT_STANDARD_FILEIO = 1
+  SUPPORT_TRACELOG = 1
+  MAX_TRACELOG_MSG_LENGTH = 128 # Max length of one trace-log message
+
+end

data/lib/physac.rb

@@ -2,18 +2,19 @@
 #
 # * https://github.com/vaiorabbit/raylib-bindings
 #
-# [NOTICE] This is an automatically generated file.
+# [NOTICE] Autogenerated. Do not edit.
 
 require 'ffi'
 
 module Raylib
   extend FFI::Library
+
   # Define/Macro
 
-  PHYSAC_MAX_BODIES = 64
-  PHYSAC_MAX_MANIFOLDS = 4096
-  PHYSAC_MAX_VERTICES = 24
-  PHYSAC_DEFAULT_CIRCLE_VERTICES = 24
+  PHYSAC_MAX_BODIES = 64 # Maximum number of physic bodies supported
+  PHYSAC_MAX_MANIFOLDS = 4096 # Maximum number of physic bodies interactions (64x64)
+  PHYSAC_MAX_VERTICES = 24 # Maximum number of vertex for polygons shapes
+  PHYSAC_DEFAULT_CIRCLE_VERTICES = 24 # Default number of vertices for circle shapes
   PHYSAC_COLLISION_ITERATIONS = 100
   PHYSAC_PENETRATION_ALLOWANCE = 0.05
   PHYSAC_PENETRATION_CORRECTION = 0.4
@@ -21,9 +22,11 @@ module Raylib
 
   # Enum
 
+  # enum PhysicsShapeType
   PHYSICS_CIRCLE = 0
   PHYSICS_POLYGON = 1
 
+
   # Typedef
 
   typedef :int, :PhysicsShapeType
@@ -32,6 +35,7 @@ module Raylib
 
   # Struct
 
+  # Matrix2x2 type (used for polygon shape rotation matrix)
   class Matrix2x2 < FFI::Struct
     layout(
       :m00, :float,
@@ -43,136 +47,176 @@ module Raylib
 
   class PhysicsVertexData < FFI::Struct
     layout(
-      :vertexCount, :uint,
-      :positions, [Vector2, 24],
-      :normals, [Vector2, 24],
+      :vertexCount, :uint, # Vertex count (positions and normals)
+      :positions, [Vector2, 24], # Vertex positions vectors
+      :normals, [Vector2, 24], # Vertex normals vectors
     )
   end
 
   class PhysicsShape < FFI::Struct
     layout(
-      :type, :int,
-      :body, :pointer,
-      :vertexData, PhysicsVertexData,
-      :radius, :float,
-      :transform, Matrix2x2,
+      :type, :int, # Shape type (circle or polygon)
+      :body, :pointer, # Shape physics body data pointer
+      :vertexData, PhysicsVertexData, # Shape vertices data (used for polygon shapes)
+      :radius, :float, # Shape radius (used for circle shapes)
+      :transform, Matrix2x2, # Vertices transform matrix 2x2
     )
   end
 
   class PhysicsBodyData < FFI::Struct
     layout(
-      :id, :uint,
-      :enabled, :bool,
-      :position, Vector2,
-      :velocity, Vector2,
-      :force, Vector2,
-      :angularVelocity, :float,
-      :torque, :float,
-      :orient, :float,
-      :inertia, :float,
-      :inverseInertia, :float,
-      :mass, :float,
-      :inverseMass, :float,
-      :staticFriction, :float,
-      :dynamicFriction, :float,
-      :restitution, :float,
-      :useGravity, :bool,
-      :isGrounded, :bool,
-      :freezeOrient, :bool,
-      :shape, PhysicsShape,
+      :id, :uint, # Unique identifier
+      :enabled, :bool, # Enabled dynamics state (collisions are calculated anyway)
+      :position, Vector2, # Physics body shape pivot
+      :velocity, Vector2, # Current linear velocity applied to position
+      :force, Vector2, # Current linear force (reset to 0 every step)
+      :angularVelocity, :float, # Current angular velocity applied to orient
+      :torque, :float, # Current angular force (reset to 0 every step)
+      :orient, :float, # Rotation in radians
+      :inertia, :float, # Moment of inertia
+      :inverseInertia, :float, # Inverse value of inertia
+      :mass, :float, # Physics body mass
+      :inverseMass, :float, # Inverse value of mass
+      :staticFriction, :float, # Friction when the body has not movement (0 to 1)
+      :dynamicFriction, :float, # Friction when the body has movement (0 to 1)
+      :restitution, :float, # Restitution coefficient of the body (0 to 1)
+      :useGravity, :bool, # Apply gravity force to dynamics
+      :isGrounded, :bool, # Physics grounded on other body state
+      :freezeOrient, :bool, # Physics rotation constraint
+      :shape, PhysicsShape, # Physics body shape information (type, radius, vertices, transform)
     )
   end
 
   class PhysicsManifoldData < FFI::Struct
     layout(
-      :id, :uint,
-      :bodyA, :pointer,
-      :bodyB, :pointer,
-      :penetration, :float,
-      :normal, Vector2,
-      :contacts, [Vector2, 2],
-      :contactsCount, :uint,
-      :restitution, :float,
-      :dynamicFriction, :float,
-      :staticFriction, :float,
+      :id, :uint, # Unique identifier
+      :bodyA, :pointer, # Manifold first physics body reference
+      :bodyB, :pointer, # Manifold second physics body reference
+      :penetration, :float, # Depth of penetration from collision
+      :normal, Vector2, # Normal direction vector from 'a' to 'b'
+      :contacts, [Vector2, 2], # Points of contact during collision
+      :contactsCount, :uint, # Current collision number of contacts
+      :restitution, :float, # Mixed restitution during collision
+      :dynamicFriction, :float, # Mixed dynamic friction during collision
+      :staticFriction, :float, # Mixed static friction during collision
     )
   end
 
 
   # Function
 
-  def self.setup_physac_symbols()
-    symbols = [
-      :InitPhysics,
-      :UpdatePhysics,
-      :ResetPhysics,
-      :ClosePhysics,
-      :SetPhysicsTimeStep,
-      :SetPhysicsGravity,
-      :CreatePhysicsBodyCircle,
-      :CreatePhysicsBodyRectangle,
-      :CreatePhysicsBodyPolygon,
-      :DestroyPhysicsBody,
-      :PhysicsAddForce,
-      :PhysicsAddTorque,
-      :PhysicsShatter,
-      :SetPhysicsBodyRotation,
-      :GetPhysicsBody,
-      :GetPhysicsBodiesCount,
-      :GetPhysicsShapeType,
-      :GetPhysicsShapeVerticesCount,
-      :GetPhysicsShapeVertex,
+  def self.setup_physac_symbols
+    entries = [
+
+      # InitPhysics : Initializes physics system
+      # @return [void]
+      [:InitPhysics, :InitPhysics, [], :void],
+
+      # UpdatePhysics : Update physics system
+      # @return [void]
+      [:UpdatePhysics, :UpdatePhysics, [], :void],
+
+      # ResetPhysics : Reset physics system (global variables)
+      # @return [void]
+      [:ResetPhysics, :ResetPhysics, [], :void],
+
+      # ClosePhysics : Close physics system and unload used memory
+      # @return [void]
+      [:ClosePhysics, :ClosePhysics, [], :void],
+
+      # SetPhysicsTimeStep : Sets physics fixed time step in milliseconds. 1.666666 by default
+      # @param delta [double]
+      # @return [void]
+      [:SetPhysicsTimeStep, :SetPhysicsTimeStep, [:double], :void],
+
+      # SetPhysicsGravity : Sets physics global gravity force
+      # @param x [float]
+      # @param y [float]
+      # @return [void]
+      [:SetPhysicsGravity, :SetPhysicsGravity, [:float, :float], :void],
+
+      # CreatePhysicsBodyCircle : Creates a new circle physics body with generic parameters
+      # @param pos [Vector2]
+      # @param radius [float]
+      # @param density [float]
+      # @return [PhysicsBody]
+      [:CreatePhysicsBodyCircle, :CreatePhysicsBodyCircle, [Vector2.by_value, :float, :float], :pointer],
+
+      # CreatePhysicsBodyRectangle : Creates a new rectangle physics body with generic parameters
+      # @param pos [Vector2]
+      # @param width [float]
+      # @param height [float]
+      # @param density [float]
+      # @return [PhysicsBody]
+      [:CreatePhysicsBodyRectangle, :CreatePhysicsBodyRectangle, [Vector2.by_value, :float, :float, :float], :pointer],
+
+      # CreatePhysicsBodyPolygon : Creates a new polygon physics body with generic parameters
+      # @param pos [Vector2]
+      # @param radius [float]
+      # @param sides [int]
+      # @param density [float]
+      # @return [PhysicsBody]
+      [:CreatePhysicsBodyPolygon, :CreatePhysicsBodyPolygon, [Vector2.by_value, :float, :int, :float], :pointer],
+
+      # DestroyPhysicsBody : Destroy a physics body
+      # @param body [PhysicsBody]
+      # @return [void]
+      [:DestroyPhysicsBody, :DestroyPhysicsBody, [:pointer], :void],
+
+      # PhysicsAddForce : Adds a force to a physics body
+      # @param body [PhysicsBody]
+      # @param force [Vector2]
+      # @return [void]
+      [:PhysicsAddForce, :PhysicsAddForce, [:pointer, Vector2.by_value], :void],
+
+      # PhysicsAddTorque : Adds an angular force to a physics body
+      # @param body [PhysicsBody]
+      # @param amount [float]
+      # @return [void]
+      [:PhysicsAddTorque, :PhysicsAddTorque, [:pointer, :float], :void],
+
+      # PhysicsShatter : Shatters a polygon shape physics body to little physics bodies with explosion force
+      # @param body [PhysicsBody]
+      # @param position [Vector2]
+      # @param force [float]
+      # @return [void]
+      [:PhysicsShatter, :PhysicsShatter, [:pointer, Vector2.by_value, :float], :void],
+
+      # SetPhysicsBodyRotation : Sets physics body shape transform based on radians parameter
+      # @param body [PhysicsBody]
+      # @param radians [float]
+      # @return [void]
+      [:SetPhysicsBodyRotation, :SetPhysicsBodyRotation, [:pointer, :float], :void],
+
+      # GetPhysicsBody : Returns a physics body of the bodies pool at a specific index
+      # @param index [int]
+      # @return [PhysicsBody]
+      [:GetPhysicsBody, :GetPhysicsBody, [:int], :pointer],
+
+      # GetPhysicsBodiesCount : Returns the current amount of created physics bodies
+      # @return [int]
+      [:GetPhysicsBodiesCount, :GetPhysicsBodiesCount, [], :int],
+
+      # GetPhysicsShapeType : Returns the physics body shape type (PHYSICS_CIRCLE or PHYSICS_POLYGON)
+      # @param index [int]
+      # @return [int]
+      [:GetPhysicsShapeType, :GetPhysicsShapeType, [:int], :int],
+
+      # GetPhysicsShapeVerticesCount : Returns the amount of vertices of a physics body shape
+      # @param index [int]
+      # @return [int]
+      [:GetPhysicsShapeVerticesCount, :GetPhysicsShapeVerticesCount, [:int], :int],
+
+      # GetPhysicsShapeVertex : Returns transformed position of a body shape (body position + vertex transformed position)
+      # @param body [PhysicsBody]
+      # @param vertex [int]
+      # @return [Vector2]
+      [:GetPhysicsShapeVertex, :GetPhysicsShapeVertex, [:pointer, :int], Vector2.by_value],
     ]
-    args = {
-      :InitPhysics => [],
-      :UpdatePhysics => [],
-      :ResetPhysics => [],
-      :ClosePhysics => [],
-      :SetPhysicsTimeStep => [:double],
-      :SetPhysicsGravity => [:float, :float],
-      :CreatePhysicsBodyCircle => [Vector2.by_value, :float, :float],
-      :CreatePhysicsBodyRectangle => [Vector2.by_value, :float, :float, :float],
-      :CreatePhysicsBodyPolygon => [Vector2.by_value, :float, :int, :float],
-      :DestroyPhysicsBody => [:pointer],
-      :PhysicsAddForce => [:pointer, Vector2.by_value],
-      :PhysicsAddTorque => [:pointer, :float],
-      :PhysicsShatter => [:pointer, Vector2.by_value, :float],
-      :SetPhysicsBodyRotation => [:pointer, :float],
-      :GetPhysicsBody => [:int],
-      :GetPhysicsBodiesCount => [],
-      :GetPhysicsShapeType => [:int],
-      :GetPhysicsShapeVerticesCount => [:int],
-      :GetPhysicsShapeVertex => [:pointer, :int],
-    }
-    retvals = {
-      :InitPhysics => :void,
-      :UpdatePhysics => :void,
-      :ResetPhysics => :void,
-      :ClosePhysics => :void,
-      :SetPhysicsTimeStep => :void,
-      :SetPhysicsGravity => :void,
-      :CreatePhysicsBodyCircle => :pointer,
-      :CreatePhysicsBodyRectangle => :pointer,
-      :CreatePhysicsBodyPolygon => :pointer,
-      :DestroyPhysicsBody => :void,
-      :PhysicsAddForce => :void,
-      :PhysicsAddTorque => :void,
-      :PhysicsShatter => :void,
-      :SetPhysicsBodyRotation => :void,
-      :GetPhysicsBody => :pointer,
-      :GetPhysicsBodiesCount => :int,
-      :GetPhysicsShapeType => :int,
-      :GetPhysicsShapeVerticesCount => :int,
-      :GetPhysicsShapeVertex => Vector2.by_value,
-    }
-    symbols.each do |sym|
-      begin
-        attach_function sym, args[sym], retvals[sym]
-      rescue FFI::NotFoundError => error
-        $stderr.puts("[Warning] Failed to import #{sym} (#{error}).")
-      end
+    entries.each do |entry|
+      attach_function entry[0], entry[1], entry[2], entry[3]
+    rescue FFI::NotFoundError => e
+      warn "[Warning] Failed to import #{entry[0]} (#{e})."
     end
   end
-
 end
-