bestguigui_lab 0.12.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 232fd8759bb525cb0e243e8fa4eccfb4fa94dc9b4a0f6fb7ce73a003f52d505d
-  data.tar.gz: 666da34d4cea8a5f3d2efec9564e6d610854a249ffd9bf484d3b1a41dce7cc3a
+  metadata.gz: c8ae9a4f1ed462793b85d3bc6c0307ca45958e7f4cfa47e47e8714709f397e28
+  data.tar.gz: cb1b88bb9b5fbf2e163de51e59e1bb3e787339782557a09f7194a4f5f04c610c
 SHA512:
-  metadata.gz: 8950ebdc674b3141c96dd79872f55af0ac520c1e2bfc13270cffd887b337d7dc36c6890b7a28c86f6136bddd8c28aad565d274ef7830e97e2747e427e22c7752
-  data.tar.gz: '039120dc1ae9996040c279190835707d89ebdf935b7ffd6efc4cd5323b4ed0a2dd80f2e4b2796f2ee0c6ae4a517ea6ec6a1f349c77a820204e99d0ba1da02d8a'
+  metadata.gz: 92b8120063fa68d38ee3146420f700afa121d18cb0b701df124cc69bd893fb1d9b18bb724ba816f4938aa27371530c1188037c911b9cd421047eee639ec1477d
+  data.tar.gz: 5eb225c89974c30a6a2cff05464d7f9b5204e9accebb5a8d7fa9a38020bff9b80ec8f987a18977ff6ceee20f62ab5b01762f802676b9de2191fd837e492af41f

data/lib/bestguigui_lab/assets.rb

@@ -10,7 +10,7 @@ module Bestguigui
         @sounds = Hash.new { |cache, path| cache[path] = Gosu::Sample.new(path) }
         @songs = Hash.new { |cache, path| cache[path] = Gosu::Song.new(path) }
         @fonts = Hash.new { |cache, key| cache[key] = Gosu::Font.new(key[1], name: key[0]) }
-        @models = Hash.new { |cache, path| cache[path] = ObjModel.new(path) }
+        @models = Hash.new { |cache, key| cache[key] = ObjModel.new(key[0], shading: key[1]) }
         @textures = Hash.new { |cache, path| cache[path] = GLTexture.new(path) }
         @frames = Hash.new { |cache, key| cache[key] = Gosu::Image.load_tiles(key[0], key[1], key[2], retro: true) }
 
@@ -28,7 +28,7 @@ module Bestguigui
             @fonts[[path, size]]
         end
 
-        def self.model(name) = @models[resolve(name)]
+        def self.model(name, shading: :texture) = @models[[resolve(name), shading]]
         def self.texture(name) = @textures[resolve(name)]
         def self.frames(name, tile_width, tile_height) = @frames[[resolve(name), tile_width, tile_height]]
     end

data/lib/bestguigui_lab/gl_buffer.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Bestguigui
+    # Envoie un buffer de floats vers un VBO OpenGL (GL_ARRAY_BUFFER) et
+    # renvoie son nom — utilisé par ObjModel pour charger sa géométrie.
+    class GLBuffer
+        def self.upload(data)
+            name_buffer = "\x00" * 4
+            glGenBuffers(1, name_buffer)
+            vbo = name_buffer.unpack1('L')
+
+            glBindBuffer(GL_ARRAY_BUFFER, vbo)
+            glBufferData(GL_ARRAY_BUFFER, data.bytesize, data, GL_STATIC_DRAW)
+
+            vbo
+        end
+    end
+end

data/lib/bestguigui_lab/gouraud_shading.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Bestguigui
+    # Calcule une couleur par sommet à partir de sa normale et d'une lumière
+    # fixe, quantifiée en peu de nuances par canal — utilisé par ObjModel en
+    # mode shading: :gouraud pour simuler, en plus de la texture (elle la
+    # module, ne la remplace pas), un rendu façon modèles de perso PSX
+    # (FF7 & co) : pas de lumière OpenGL temps réel, un effet "en bandes"
+    # plutôt qu'un dégradé lisse.
+    class GouraudShading
+        LIGHT_DIRECTION = [0.4, 0.8, 0.4].freeze # direction fixe
+        AMBIENT = 0.35 # part de lumière reçue même côté ombre
+        COLOR_LEVELS = 16 # teintes par canal : peu de nuances, façon banding PSX
+
+        def initialize(light_direction: LIGHT_DIRECTION, ambient: AMBIENT, color_levels: COLOR_LEVELS)
+            @light_direction = normalize(light_direction)
+            @ambient = ambient
+            @color_levels = color_levels
+        end
+
+        def vertex_color(normal, material_color)
+            intensity = @ambient + ((1.0 - @ambient) * [dot(normal, @light_direction), 0.0].max)
+            material_color.map { |channel| quantize(channel * intensity) }
+        end
+
+        private
+
+        def dot(vector_a, vector_b) = vector_a.zip(vector_b).sum { |x, y| x * y }
+
+        def normalize(vector)
+            length = Math.sqrt(vector.sum { |c| c * c })
+            vector.map { |c| c / length }
+        end
+
+        # Réduit à COLOR_LEVELS nuances entre 0 et 1 : le dégradé de lumière
+        # devient visiblement "en bandes", comme la faible précision couleur
+        # de la PSX.
+        def quantize(value)
+            step = 1.0 / (@color_levels - 1)
+            (value.clamp(0.0, 1.0) / step).round * step
+        end
+    end
+end

data/lib/bestguigui_lab/obj_model.rb

@@ -1,20 +1,23 @@
 # frozen_string_literal: true
 
 module Bestguigui
-    # Charge un modèle .obj/.mtl et le dessine via un VBO : géométrie
+    # Charge un modèle .obj/.mtl et le dessine via un VBO texturé. shading:
+    # :gouraud ajoute, en plus de la texture (ou d'un blanc si absente), une
+    # teinte par sommet calculée une fois au chargement à partir de sa
+    # normale et d'une lumière fixe (voir GouraudShading) : simule le rendu
+    # bas-poly des perso PSX (FF7 & co), sans lumière OpenGL temps réel.
     class ObjModel
-        # position (3) + texcoord (2) + normale (3) par sommet.
+        # position (3) + texcoord (2) + normale ou teinte Gouraud (3) par sommet.
         FLOATS_PER_VERTEX = 8
         STRIDE = FLOATS_PER_VERTEX * 4 # 4 octets par float
 
-        def initialize(obj_path)
+        def initialize(obj_path, shading: :texture)
             super()
-            @vertices = []
-            @tex_coords = []
-            @normals = []
-            @faces = []
+            @shading = shading
+            # rubocop:disable-next Style/ParallelAssignment -- reste sous la limite de Metrics/MethodLength
+            @vertices, @tex_coords, @normals, @faces = [], [], [], []
             @texture = nil
-
+            @material_color = [1.0, 1.0, 1.0]
             parse_obj(obj_path)
             @texture ||= GLTexture.blank
             @vertex_count = @faces.size
@@ -75,53 +78,60 @@ module Bestguigui
             end
         end
 
-        # Un seul matériau par modèle : la dernière texture (map_Kd) trouvée.
+        # Un seul matériau : dernière texture (map_Kd) et couleur diffuse (Kd) trouvées, Kd sert de base au Gouraud.
         def load_material(path)
             directory = File.dirname(path)
 
             File.foreach(path) do |line|
                 tokens = line.split
-                next if tokens.empty? || tokens.shift != 'map_Kd'
+                next if tokens.empty?
 
-                @texture = GLTexture.new(File.join(directory, tokens.first))
+                keyword = tokens.shift
+                case keyword
+                when 'Kd' then @material_color = tokens.map(&:to_f)
+                when 'map_Kd' then @texture = GLTexture.new(File.join(directory, tokens.first))
+                end
             end
         end
 
         # Buffer plat non indexé : les sommets partagés sont dupliqués, pas
         # d'index buffer pour rester simple.
         def build_vertex_buffer
-            data = @faces.flat_map { |v, vt, vn| vertex_attributes(v, vt, vn) }.pack('F*')
-
-            name_buffer = "\x00" * 4
-            glGenBuffers(1, name_buffer)
-            vbo = name_buffer.unpack1('L')
-
-            glBindBuffer(GL_ARRAY_BUFFER, vbo)
-            glBufferData(GL_ARRAY_BUFFER, data.bytesize, data, GL_STATIC_DRAW)
-
-            vbo
+            gouraud = GouraudShading.new if @shading == :gouraud
+            data = @faces.flat_map { |v, vt, vn| vertex_attributes(v, vt, vn, gouraud) }.pack('F*')
+            GLBuffer.upload(data)
         end
 
-        def vertex_attributes(vertex_index, tex_coord_index, normal_index)
+        # extra : la normale (mode :texture, inutilisée) ou une teinte Gouraud qui modulera la texture au dessin.
+        def vertex_attributes(vertex_index, tex_coord_index, normal_index, gouraud)
             position = @vertices[vertex_index]
             tex_coord = tex_coord_index ? @tex_coords[tex_coord_index] : [0.0, 0.0]
             normal = normal_index ? @normals[normal_index] : [0.0, 0.0, 1.0]
+            extra = gouraud ? gouraud.vertex_color(normal, @material_color) : normal
 
-            position + tex_coord + normal
+            position + tex_coord + extra
         end
 
         def enable_vertex_arrays
             glEnableClientState(GL_VERTEX_ARRAY)
             glEnableClientState(GL_TEXTURE_COORD_ARRAY)
-            glEnableClientState(GL_NORMAL_ARRAY)
-
             glVertexPointer(3, GL_FLOAT, STRIDE, 0)
             glTexCoordPointer(2, GL_FLOAT, STRIDE, 3 * 4)
+            @shading == :gouraud ? enable_color_array : enable_normal_array
+        end
+
+        def enable_color_array
+            glEnableClientState(GL_COLOR_ARRAY)
+            glColorPointer(3, GL_FLOAT, STRIDE, 5 * 4)
+        end
+
+        def enable_normal_array
+            glEnableClientState(GL_NORMAL_ARRAY)
             glNormalPointer(GL_FLOAT, STRIDE, 5 * 4)
         end
 
         def disable_vertex_arrays
-            glDisableClientState(GL_NORMAL_ARRAY)
+            glDisableClientState(@shading == :gouraud ? GL_COLOR_ARRAY : GL_NORMAL_ARRAY)
             glDisableClientState(GL_TEXTURE_COORD_ARRAY)
             glDisableClientState(GL_VERTEX_ARRAY)
         end

data/lib/bestguigui_lab/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Bestguigui
-    VERSION = '0.12.0'
+    VERSION = '0.13.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bestguigui_lab
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Bestguigui
@@ -45,7 +45,9 @@ files:
 - lib/bestguigui_lab/animation.rb
 - lib/bestguigui_lab/assets.rb
 - lib/bestguigui_lab/assets/splash_jingle.wav
+- lib/bestguigui_lab/gl_buffer.rb
 - lib/bestguigui_lab/gl_texture.rb
+- lib/bestguigui_lab/gouraud_shading.rb
 - lib/bestguigui_lab/helpers.rb
 - lib/bestguigui_lab/image_pixels.rb
 - lib/bestguigui_lab/input.rb