rockbox_ffi 0.3.0-x86_64-linux → 0.4.0-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6dd2f127b4800986cfca1e7ff4d80ab686f61e0aa3bcb53588f0205ea461ee23
-  data.tar.gz: 70beb0ea3c2d2f7f38cec9a422fd177e10a97eba659be2323e9033bb79a3b590
+  metadata.gz: 4e35ed08865d334c859871d63d0b7599d05bdce99f42c41fe9ab3e0f80278f9c
+  data.tar.gz: 6aa2a2005ba3b9eaf949678ddcda94d8da0bb0410d7f18e565ab1bbbf58396c2
 SHA512:
-  metadata.gz: 3c986e0a8ce4f0254fd1e1ff3384e8d2d63b9b02f543f57bb321d0dec642ffbaea240299e9d36bbda5e361d56a0ab0a0bb7e91f71462b1bfae762e431a6114ca
-  data.tar.gz: 1a93d231892a3b84ed892eae5684b3476835478769141638fc263fe2b217fb1585dbf25390e1b94e3473c6044a50fafac1682aaa90413b22baf622a0e7cb924e
+  metadata.gz: '09503d7c32511c00a392769ea4202ee21f140457e4beb21106b31da4949d681d530945ac2da51108846b93075192b1c7cc2e4932e4201cd51a1cbcbe2fc551ee'
+  data.tar.gz: 8e40d3a60b54597cd08361ad80aa151e20e48ce257469b09fc80c157679f597970843ed9a5ac442c7414134a97fb33551239f0ca417695da0297ffcc5279314b

data/lib/rockbox_ffi/decoder.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+require "json"
+
+module RockboxFFI
+  # Decode a local audio file to interleaved-stereo S16 PCM, one chunk at a
+  # time, using the Rockbox codec engine.
+  #
+  # The codec state is process-wide, so only one Decoder may decode at a time
+  # and it must be used from one thread. Call #close when done, or use the block
+  # form Decoder.open(path) { |dec| ... }.
+  class Decoder
+    # Open a Decoder for +path+; if a block is given, close it automatically
+    # afterwards.
+    def self.open(path)
+      dec = new(path)
+      return dec unless block_given?
+
+      begin
+        yield dec
+      ensure
+        dec.close
+      end
+    end
+
+    def initialize(path)
+      @ptr = Lib.rb_decoder_open(path.to_s)
+      raise "could not open decoder for #{path.inspect}" if @ptr.null?
+
+      @finalizer = self.class.send(:finalizer, @ptr)
+      ObjectSpace.define_finalizer(self, @finalizer)
+    end
+
+    # -- lifecycle --------------------------------------------------------
+    def close
+      return if @ptr.nil?
+
+      ObjectSpace.undefine_finalizer(self)
+      Lib.rb_decoder_free(@ptr)
+      @ptr = nil
+    end
+
+    def closed?
+      @ptr.nil?
+    end
+
+    def self.finalizer(ptr)
+      proc { Lib.rb_decoder_free(ptr) }
+    end
+    private_class_method :finalizer
+
+    # -- metadata ---------------------------------------------------------
+    # Tags and stream properties (same shape as Metadata.read). Returns a Hash
+    # with symbol keys. Raises on failure.
+    def metadata
+      s = RockboxFFI.take_string(Lib.rb_decoder_metadata_json(@ptr))
+      raise "rb_decoder_metadata_json returned NULL" if s.nil?
+
+      JSON.parse(s, symbolize_names: true)
+    end
+
+    # -- decoding ---------------------------------------------------------
+    # Next buffer of decoded PCM as +[samples, sample_rate]+, where +samples+
+    # is an Array of interleaved stereo int16 Integers. Returns nil at end of
+    # track (or after a codec error — see #finished).
+    def next_chunk
+      out_len = "\0" * Fiddle::SIZEOF_VOIDP      # size_t* out-param (i16 count)
+      out_rate = "\0" * Fiddle::SIZEOF_INT       # uint32_t* out-param (Hz)
+      ptr = Lib.rb_decoder_next_chunk(@ptr, out_len, out_rate)
+
+      produced = out_len.unpack1(Fiddle::SIZEOF_VOIDP == 8 ? "Q" : "L")
+      return nil if ptr.null? || produced.zero?
+
+      rate = out_rate.unpack1("L")
+      begin
+        ptr.size = produced * 2
+        [ptr[0, produced * 2].unpack("s<*"), rate]
+      ensure
+        Lib.rb_buffer_free(ptr, produced)
+      end
+    end
+
+    # Yield each +[samples, sample_rate]+ chunk until end of track. Returns an
+    # Enumerator when no block is given.
+    def each_chunk
+      return enum_for(:each_chunk) unless block_given?
+
+      while (chunk = next_chunk)
+        yield chunk
+      end
+    end
+
+    # Request a seek to +ms+ milliseconds.
+    def seek_ms(ms)
+      Lib.rb_decoder_seek_ms(@ptr, Integer(ms))
+    end
+
+    # Playback position last reported by the codec, in milliseconds.
+    def elapsed_ms
+      Lib.rb_decoder_elapsed_ms(@ptr)
+    end
+
+    # +[done, code]+: +done+ is true once the track has ended; +code+ is the
+    # exit status (0 = clean end, negative = codec error), valid only when
+    # +done+.
+    def finished
+      out_code = "\0" * Fiddle::SIZEOF_INT       # int32_t* out-param
+      r = Lib.rb_decoder_finished(@ptr, out_code)
+      done = r == true || r == 1
+      [done, out_code.unpack1("l")]
+    end
+  end
+end

data/lib/rockbox_ffi/ffi.rb

@@ -98,6 +98,15 @@ module RockboxFFI
     extern "void* rb_meta_read_json(void*)"
     extern "void* rb_meta_probe(void*)"
 
+    # ---- decoder ------------------------------------------------------
+    extern "void* rb_decoder_open(void*)"
+    extern "void rb_decoder_free(void*)"
+    extern "void* rb_decoder_metadata_json(void*)"
+    extern "int16_t* rb_decoder_next_chunk(void*, void*, void*)"
+    extern "void rb_decoder_seek_ms(void*, uint64_t)"
+    extern "uint64_t rb_decoder_elapsed_ms(void*)"
+    extern "bool rb_decoder_finished(void*, void*)"
+
     # ---- player -------------------------------------------------------
     extern "void* rb_player_new()"
     extern "void* rb_player_new_with_config(uint32_t, float, float, int32_t, float, bool, int32_t, uint32_t, uint32_t, uint32_t, uint32_t, int32_t)"
@@ -116,9 +125,11 @@ module RockboxFFI
     extern "void rb_player_skip_to(void*, size_t)"
     extern "void rb_player_seek_ms(void*, uint64_t)"
     extern "void rb_player_set_volume(void*, float)"
+    extern "void rb_player_set_balance(void*, int32_t)"
     extern "void rb_player_set_crossfade(void*, int32_t, uint32_t, uint32_t, uint32_t, uint32_t, int32_t)"
     extern "void rb_player_set_replaygain(void*, int32_t, float, bool)"
     extern "float rb_player_volume(void*)"
+    extern "int32_t rb_player_balance(void*)"
     extern "uint32_t rb_player_sample_rate(void*)"
     extern "void* rb_player_status_json(void*)"
     extern "void rb_player_set_shuffle(void*, bool)"

data/lib/rockbox_ffi/player.rb

@@ -169,10 +169,21 @@ module RockboxFFI
       self
     end
 
+    # Stereo balance, -100 (full left) to +100 (full right); 0 = centre.
+    def set_balance(balance)
+      Lib.rb_player_set_balance(@ptr, Integer(balance))
+      self
+    end
+
     def volume
       Lib.rb_player_volume(@ptr)
     end
 
+    # Current stereo balance, -100 (full left) to +100 (full right).
+    def balance
+      Lib.rb_player_balance(@ptr)
+    end
+
     def sample_rate
       Lib.rb_player_sample_rate(@ptr)
     end

data/lib/rockbox_ffi/version.rb

@@ -1,3 +1,3 @@
 module RockboxFFI
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/rockbox_ffi.rb

@@ -3,7 +3,7 @@
 # Ruby bindings for the Rockbox DSP / metadata / playback engine.
 #
 # Thin Fiddle wrappers over the librockbox_ffi C ABI. See RockboxFFI::Metadata,
-# RockboxFFI::Dsp, and RockboxFFI::Player.
+# RockboxFFI::Dsp, RockboxFFI::Player, and RockboxFFI::Decoder.
 
 require "rockbox_ffi/version"
 require "rockbox_ffi/ffi"
@@ -11,6 +11,7 @@ require "rockbox_ffi/enums"
 require "rockbox_ffi/metadata"
 require "rockbox_ffi/dsp"
 require "rockbox_ffi/player"
+require "rockbox_ffi/decoder"
 
 require "json"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rockbox_ffi
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: x86_64-linux
 authors:
 - Tsiry Sandratraina
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-12 00:00:00.000000000 Z
+date: 2026-07-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fiddle
@@ -37,6 +37,7 @@ files:
 - examples/play.rb
 - examples/smoke.rb
 - lib/rockbox_ffi.rb
+- lib/rockbox_ffi/decoder.rb
 - lib/rockbox_ffi/dsp.rb
 - lib/rockbox_ffi/enums.rb
 - lib/rockbox_ffi/ffi.rb