raylib-bindings 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a24ae09d1d8e13d58febdd5d222b7c219291c49531939bddccdcd89079bb4943
-  data.tar.gz: 536927a5880fa2ed1a7007951fd505bbe81cb0263011c9ead49912e484938d2d
+  metadata.gz: 5b3f1d67b53ae29240274be47c367f11b21ca8b0f6ade8d3d7681d85ad4f48d2
+  data.tar.gz: 9ca39c8d175730002cff693ac0708ba6f0bca4931b700c70798ed7272d2f5e35
 SHA512:
-  metadata.gz: 3b38f484780698c0ae0ceb9a9f79ae31d5eb86a883df27434f61e96b3e75b50e6d5c285e9e83196852c5b4ca9597a355b7bf1627c66a8d07ddbff3cd44b15328
-  data.tar.gz: 29fb98821c8a10b45ae37b81aadd1ccba54864ed962990e0ebd424dd6f0d100b06e32057de13775155c3be0607e81f34f620ea71174140bf74d99f8f87ba489b
+  metadata.gz: 803d0c18648fd377db9d89b4f603bc0759f147c6281d83d56457215334615c3fca80acb1b324ce7fe6b84369bd452968061a02c7dd46db529286337cd5497f64
+  data.tar.gz: 17b06c4f5738faa6f69581155bdf0596fc1db33a8d29ab892a569b0d299d1d39cfd484a40dbfea9a28cd70b6e6eb37b6936bb55d239b532745c0e87d1cb135c9

data/ChangeLog

@@ -1,3 +1,15 @@
+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/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-25
 
 Provides Ruby bindings for raylib-related libraries including:
 

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
@@ -32,6 +33,7 @@ module Raylib
 
   # Struct
 
+  # Matrix2x2 type (used for polygon shape rotation matrix)
   class Matrix2x2 < FFI::Struct
     layout(
       :m00, :float,
@@ -43,133 +45,177 @@ 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(output_error = false)
+    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|
+    entries.each do |entry|
       begin
-        attach_function sym, args[sym], retvals[sym]
+        attach_function entry[0], entry[1], entry[2], entry[3]
       rescue FFI::NotFoundError => error
-        $stderr.puts("[Warning] Failed to import #{sym} (#{error}).")
+        $stderr.puts("[Warning] Failed to import #{entry[0]} (#{error}).") if output_error
       end
     end
   end