gstreamer 4.3.6 → 4.3.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 90a24d64e10b3a4c5d4ac3172cf5521ca579097b040554c4ddaef62dbe2f15fc
-  data.tar.gz: 40cf5470e711abf4b9327cbe3609c9c25e3e970a0c4f95ec4c7787f79d40411a
+  metadata.gz: 415cab8d4468bf433442b7e8da40f47dc4acf152e7dbb1dcc3a2e23edf26581b
+  data.tar.gz: 1c132d585039e4d9e50ebf262e89289dd77935d30cc628ecafdd4d6e151d05f3
 SHA512:
-  metadata.gz: 0c1af5c7dc657d9b81c9e119a6a9a34f4559d62bfff461209dd886e38c88776f445a5bfa39d7f85f2f14ea281c2a9047a531ae755b9dd1b21edbfbb79f33848d
-  data.tar.gz: 15b94702d7bb135c0719416f131a7c94af8a79ed1682285648fe2908e80017ad33d8dde821b532ea36fc8ee9bea514724b3be3d5cffed08ceffc02ff9e421240
+  metadata.gz: 2fe1ef493c43e1370b6f4650cb1e7aadfa353ec1134c565668309dc2c634cab9cdcae29449f7a481ef36f29f897031907a9dacf7f1f9554f1075b8f00c0d77c0
+  data.tar.gz: 797aec06192c0dba4801d73d72483dd2c9c38b285a832608be4c62260b7b37c49aff03b6dc6658a1b43fcf29294ce8085a6f79e2ba863c0a3eb9cefc88937df1

data/ext/gstreamer/extconf.rb

@@ -28,6 +28,7 @@ $LOAD_PATH.unshift(mkmf_gnome2_dir.to_s) if mkmf_gnome2_dir.exist?
 
 module_name = "gstreamer"
 package_id = "gstreamer-1.0"
+audio_package_id = "gstreamer-audio-1.0"
 
 require "mkmf-gnome"
 
@@ -45,11 +46,23 @@ unless required_pkg_config_package(package_id,
                                    :redhat => "pkgconfig(#{package_id})",
                                    :arch_linux => "gstreamer",
                                    :homebrew => "gstreamer",
-                                   :macports => "gstreamer",
+                                   :macports => "gstreamer1",
                                    :msys2 => "gstreamer")
   exit(false)
 end
 
+unless required_pkg_config_package(audio_package_id,
+                                   :alt_linux => ["gst-plugins1.0-devel", "liborc-devel"],
+                                   :alpine_linux => "gst-plugins-base-dev",
+                                   :conda => "gst-plugins-base",
+                                   :debian => "libgstreamer-plugins-base1.0-dev",
+                                   :redhat => "pkgconfig(#{audio_package_id})",
+                                   :arch_linux => "gst-plugins-base",
+                                   :macports => "gstreamer1-gst-plugins-base",
+                                   :msys2 => "gst-plugins-base")
+  exit(false)
+end
+
 unless PKGConfig.have_package("gobject-introspection-1.0")
   exit(false)
 end

data/ext/gstreamer/rbgst-sample.c

@@ -0,0 +1,418 @@
+/* -*- c-file-style: "ruby"; indent-tabs-mode: nil -*- */
+/*
+ *  Copyright (C) 2026  Ruby-GNOME Project Team
+ *
+ *  This library is free software; you can redistribute it and/or
+ *  modify it under the terms of the GNU Lesser General Public
+ *  License as published by the Free Software Foundation; either
+ *  version 2.1 of the License, or (at your option) any later version.
+ *
+ *  This library is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ *  Lesser General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Lesser General Public
+ *  License along with this library; if not, write to the Free Software
+ *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
+ *  MA  02110-1301  USA
+ */
+
+#include <ruby.h>
+#include <ruby/version.h>
+#include <ruby/memory_view.h>
+#include <gst/gstversion.h>
+#include <gst/audio/audio.h>
+#include "rbgst.h"
+
+typedef struct memview_private_data {
+    GstBuffer *buffer;
+    GstMapInfo *map_info;
+} memview_private_data;
+
+static gboolean
+rg_gst_combine_buffer_list(GstBuffer **buffer, guint idx, gpointer user_data)
+{
+    GstBuffer **acc;
+
+    acc = (GstBuffer **)user_data;
+    *acc = gst_buffer_append(*acc, gst_buffer_ref(*buffer));
+
+    return TRUE;
+}
+
+static gboolean
+rg_gst_is_supported_caps(const gchar *name)
+{
+    return g_str_has_prefix(name, "audio/x-raw");
+}
+
+static bool
+rg_gst_memory_view_init_from_audio(VALUE obj, rb_memory_view_t *view, int flags, GstSample *sample, GstCaps *caps)
+{
+    GstBuffer *buffer;
+    GstBufferList *buffer_list;
+    GstAudioInfo *audio_info;
+    GstMapInfo *map_info;
+    bool is_writable_requested;
+    gboolean is_writable;
+    bool is_interleaved;
+    ssize_t *shape;
+    ssize_t *strides;
+    gint width;
+    const char *format = NULL;
+    gsize n_samples;
+    memview_private_data *private_data;
+
+    audio_info = gst_audio_info_new_from_caps(caps);
+    if (!audio_info) {
+        rb_warn("Gst::Sample: failed to get audio info");
+
+        return false;
+    }
+    if (!audio_info->finfo) {
+        gst_audio_info_free(audio_info);
+        rb_warn("Gst::Sample: failed to retrieve audio format info");
+
+        return false;
+    }
+
+    is_interleaved = audio_info->layout == GST_AUDIO_LAYOUT_INTERLEAVED;
+    if (!is_interleaved) {
+        // TODO: non-interleaved layout support
+        gst_audio_info_free(audio_info);
+        rb_warn("Gst::Sample: currently only interleaved layout is supported");
+
+        return false;
+    }
+
+    is_writable_requested = flags & RUBY_MEMORY_VIEW_WRITABLE;
+
+    buffer_list = gst_sample_get_buffer_list(sample);
+    if (buffer_list) {
+      if (is_writable_requested) {
+          gst_audio_info_free(audio_info);
+          rb_warn("Gst::Sample: currently writable buffer list is not supported");
+
+          return false;
+      }
+      buffer = gst_buffer_new();
+      gst_buffer_list_foreach(buffer_list, rg_gst_combine_buffer_list, &buffer);
+    } else {
+        buffer = gst_sample_get_buffer(sample);
+        if (!buffer) {
+            gst_audio_info_free(audio_info);
+            rb_warn("Gst::Sample: failed to get buffer");
+
+            return false;
+        }
+        buffer = gst_buffer_ref(buffer);
+    }
+
+    is_writable = gst_sample_is_writable(sample);
+    if (is_writable_requested && !is_writable) {
+        rb_warn("Gst::Sample: sample is not writable but writable memory view is requested");
+        gst_audio_info_free(audio_info);
+        gst_buffer_unref(buffer);
+
+        return false;
+    }
+    // Doesn't use ALLOC/ALLOC_N because they may raise an exception and then
+    // the map_info and audio_info won't be freed and the buffer won't be unrefed.
+    map_info = g_new(GstMapInfo, 1);
+    if (!gst_buffer_map(buffer, map_info, is_writable_requested ? GST_MAP_WRITE : GST_MAP_READ)) {
+        rb_warn("Gst::Sample: failed to map buffer");
+        g_free(map_info);
+        gst_audio_info_free(audio_info);
+        gst_buffer_unref(buffer);
+
+        return false;
+    }
+
+    width = audio_info->finfo->width / 8;
+
+    switch (audio_info->finfo->format) {
+    case GST_AUDIO_FORMAT_UNKNOWN:
+        rb_warn("Gst::Sample: format is unknown");
+        break;
+    case GST_AUDIO_FORMAT_ENCODED:
+        rb_warn("Gst::Sample: encoded format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_S8:
+        format = "c";
+        break;
+    case GST_AUDIO_FORMAT_U8:
+        format = "C";
+        break;
+    case GST_AUDIO_FORMAT_S16LE:
+        format = "s<";
+        break;
+    case GST_AUDIO_FORMAT_S16BE:
+        format = "s>";
+        break;
+    case GST_AUDIO_FORMAT_U16LE:
+        format = "S<";
+        break;
+    case GST_AUDIO_FORMAT_U16BE:
+        format = "S>";
+        break;
+    case GST_AUDIO_FORMAT_S24_32LE:
+        rb_warn("Gst::Sample: S24_32LE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_S24_32BE:
+        rb_warn("Gst::Sample: S24_32BE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_U24_32LE:
+        rb_warn("Gst::Sample: U24_32LE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_U24_32BE:
+        rb_warn("Gst::Sample: U24_32BE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_S32LE:
+        format = "l<";
+        break;
+    case GST_AUDIO_FORMAT_S32BE:
+        format = "l>";
+        break;
+    case GST_AUDIO_FORMAT_U32LE:
+        format = "L<";
+        break;
+    case GST_AUDIO_FORMAT_U32BE:
+        format = "L>";
+        break;
+    case GST_AUDIO_FORMAT_S24LE:
+        rb_warn("Gst::Sample: S24LE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_S24BE:
+        rb_warn("Gst::Sample: S24BE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_U24LE:
+        rb_warn("Gst::Sample: U24LE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_U24BE:
+        rb_warn("Gst::Sample: U24BE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_S20LE:
+        rb_warn("Gst::Sample: S20LE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_S20BE:
+        rb_warn("Gst::Sample: S20BE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_U20LE:
+        rb_warn("Gst::Sample: U20LE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_U20BE:
+        rb_warn("Gst::Sample: U20BE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_S18LE:
+        rb_warn("Gst::Sample: S18LE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_S18BE:
+        rb_warn("Gst::Sample: S18BE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_U18LE:
+        rb_warn("Gst::Sample: U18LE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_U18BE:
+        rb_warn("Gst::Sample: U18BE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_F32LE:
+        if (rb_memory_view_item_size_from_format("e", NULL) == 4) {
+            format = "e";
+        } else {
+            rb_warn("Gst::Sample: only environment float size is 4 bytes is supported");
+        }
+        break;
+    case GST_AUDIO_FORMAT_F32BE:
+        if (rb_memory_view_item_size_from_format("g", NULL) == 4) {
+            format = "g";
+        } else {
+            rb_warn("Gst::Sample: only environment float size is 4 bytes is supported");
+        }
+        break;
+    case GST_AUDIO_FORMAT_F64LE:
+        if (rb_memory_view_item_size_from_format("E", NULL) == 8) {
+            format = "E";
+        } else if (rb_memory_view_item_size_from_format("e", NULL) == 8) {
+            format = "e";
+        } else {
+            rb_warn("Gst::Sample: only environment double or float size is 8 bytes is supported");
+        }
+        break;
+    case GST_AUDIO_FORMAT_F64BE:
+        if (rb_memory_view_item_size_from_format("G", NULL) == 8) {
+            format = "G";
+        } else if (rb_memory_view_item_size_from_format("g", NULL) == 8) {
+            format = "g";
+        } else {
+            rb_warn("Gst::Sample: only environment double or float size is 8 bytes is supported");
+        }
+        break;
+#if GST_CHECK_VERSION(1, 28, 0)
+    case GST_AUDIO_FORMAT_S20_32LE:
+        rb_warn("Gst::Sample: S20_32LE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_S20_32BE:
+        rb_warn("Gst::Sample: S20_32BE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_U20_32LE:
+        rb_warn("Gst::Sample: U20_32LE format is not supported");
+        break;
+    case GST_AUDIO_FORMAT_U20_32BE:
+        rb_warn("Gst::Sample: U20_32BE format is not supported");
+        break;
+#endif
+    }
+
+    if (!format) {
+        gst_buffer_unmap(buffer, map_info);
+        g_free(map_info);
+        gst_buffer_unref(buffer);
+        gst_audio_info_free(audio_info);
+
+        return false;
+    }
+
+    if (map_info->size % (width * audio_info->channels) != 0) {
+        rb_warn("Gst::Sample: buffer size is not aligned with sample width and channels");
+        gst_buffer_unmap(buffer, map_info);
+        g_free(map_info);
+        gst_buffer_unref(buffer);
+        gst_audio_info_free(audio_info);
+
+        return false;
+    }
+    n_samples = map_info->size / width / audio_info->channels;
+    // Doesn't use ALLOC/ALLOC_N because they may raise an exception and then
+    // the audio_info won't be freed.
+    shape = g_new(ssize_t, 2);
+    strides = g_new(ssize_t, 2);
+    // Currently, interleaved and row-major audio is supported
+    shape[0] = n_samples;
+    shape[1] = audio_info->channels;
+    strides[0] = width * audio_info->channels;
+    strides[1] = width;
+
+    gst_audio_info_free(audio_info);
+
+    // Uses g_new instead of ALLOC/ALLOC_N for consistency.
+    private_data = g_new(memview_private_data, 1);
+    private_data->buffer = buffer;
+    private_data->map_info = map_info;
+
+    view->format = format;
+    view->data = map_info->data;
+    view->obj = obj;
+    view->item_size = width;
+    view->byte_size = map_info->size;
+    view->readonly = !is_writable_requested;
+    view->ndim = 2;
+    view->shape = shape;
+    view->strides = strides;
+    view->sub_offsets = NULL;
+#if RUBY_API_VERSION_MAJOR == 3 && RUBY_API_VERSION_MINOR == 0
+    *((void **)&view->private) = private_data;
+#else
+    view->private_data = (void *)private_data;
+#endif
+
+    return true;
+}
+
+static bool
+rg_gst_sample_get(VALUE obj, rb_memory_view_t *view, int flags)
+{
+    GstSample *sample;
+    GstCaps *caps;
+    bool is_column_major_requested;
+
+    is_column_major_requested = flags & RUBY_MEMORY_VIEW_COLUMN_MAJOR;
+    if (is_column_major_requested) {
+        // TODO: column-major support
+        rb_warn("Gst::Sample: currently column-major is not supported");
+
+        return false;
+    }
+
+    sample = GST_SAMPLE(RVAL2GOBJ(obj));
+
+    caps = gst_sample_get_caps(sample);
+
+    if (rg_gst_memory_view_init_from_audio(obj, view, flags, sample, caps)) {
+        gst_sample_ref(sample);
+        return true;
+    }
+
+    return false;
+}
+
+static bool
+rg_gst_sample_release(VALUE obj, rb_memory_view_t *view)
+{
+    GstSample *sample;
+    memview_private_data *private_data;
+
+    g_free((gpointer)view->shape);
+    g_free((gpointer)view->strides);
+#if RUBY_API_VERSION_MAJOR == 3 && RUBY_API_VERSION_MINOR == 0
+    private_data = (memview_private_data *)view->private;
+#else
+    private_data = (memview_private_data *)view->private_data;
+#endif
+    gst_buffer_unmap(private_data->buffer, private_data->map_info);
+    gst_buffer_unref(private_data->buffer);
+    g_free(private_data->map_info);
+    g_free(private_data);
+    sample = GST_SAMPLE(RVAL2GOBJ(obj));
+    gst_sample_unref(sample);
+
+    return true;
+}
+
+static bool
+rg_gst_sample_available_p(VALUE obj)
+{
+    GstSample *sample;
+    GstCaps *caps;
+    gchar *name;
+    gboolean is_supported_caps;
+
+    sample = GST_SAMPLE(RVAL2GOBJ(obj));
+
+    caps = gst_sample_get_caps(sample);
+    if (!caps) {
+        return false;
+    }
+    if (gst_caps_get_size(caps) != 1) {
+        return false;
+    }
+
+    name = gst_caps_to_string(caps);
+    is_supported_caps = rg_gst_is_supported_caps(name);
+    if (!is_supported_caps) {
+        rb_warn("Gst::Sample: currently audio/x-raw caps only supported but is %s", name);
+    }
+
+    g_free(name);
+
+    return is_supported_caps;
+}
+
+static rb_memory_view_entry_t rg_gst_sample_entry = {
+    rg_gst_sample_get,
+    rg_gst_sample_release,
+    rg_gst_sample_available_p,
+};
+
+void
+rb_gst_init_sample(void)
+{
+#if GST_CHECK_VERSION(1, 20, 0)
+    VALUE mGst;
+    VALUE cSample;
+
+    mGst = rb_const_get(rb_cObject, rb_intern("Gst"));
+    cSample = rb_const_get(mGst, rb_intern("Sample"));
+    rb_memory_view_register(cSample, &rg_gst_sample_entry);
+#endif
+}

data/ext/gstreamer/rbgst.c

@@ -72,4 +72,5 @@ Init_gstreamer (void)
 
     rb_gst_init_child_proxy();
     rb_gst_init_element();
+    rb_gst_init_sample();
 }

data/ext/gstreamer/rbgst.h

@@ -25,3 +25,4 @@
 extern void Init_gstreamer (void);
 G_GNUC_INTERNAL extern void rb_gst_init_child_proxy (void);
 G_GNUC_INTERNAL extern void rb_gst_init_element (void);
+G_GNUC_INTERNAL extern void rb_gst_init_sample (void);

data/gstreamer.gemspec

@@ -44,18 +44,33 @@ Gem::Specification.new do |s|
 
   s.add_runtime_dependency("gobject-introspection", "= #{s.version}")
 
-  [
-    ["alpine_linux", "gstreamer-dev"],
-    ["alt_linux", "gstreamer1.0-devel"],
-    ["arch_linux", "gstreamer"],
-    ["conda", "gstreamer"],
-    ["debian", "libgstreamer1.0-dev"],
-    ["homebrew", "gstreamer"],
-    ["macports", "gstreamer"],
-    ["msys2", "gstreamer"],
-    ["rhel", "pkgconfig(gstreamer-1.0)"],
-  ].each do |platform, package|
-    s.requirements << "system: gstreamer-1.0: #{platform}: #{package}"
+  {
+    "gstreamer-1.0" => [
+      ["alpine_linux", "gstreamer-dev"],
+      ["alt_linux", "gstreamer1.0-devel"],
+      ["arch_linux", "gstreamer"],
+      ["conda", "gstreamer"],
+      ["debian", "libgstreamer1.0-dev"],
+      ["homebrew", "gstreamer"],
+      ["macports", "gstreamer1"],
+      ["msys2", "gstreamer"],
+      ["rhel", "pkgconfig(gstreamer-1.0)"]
+    ],
+    "gstreamer-audio-1.0" => [
+      ["alpine_linux", "gst-plugins-base-dev"],
+      ["alt_linux", "gst-plugins1.0-devel"],
+      ["alt_linux", "liborc-devel"],
+      ["arch_linux", "gst-plugins-base"],
+      ["conda", "gst-plugins-base"],
+      ["debian", "libgstreamer-plugins-base1.0-dev"],
+      ["macports", "gstreamer1-gst-plugins-base"],
+      ["msys2", "gst-plugins-base"],
+      ["rhel", "pkgconfig(gstreamer-audio-1.0)"]
+    ]
+  }.each_pair do |id, requirements|
+    requirements.each do |platform, package|
+      s.requirements << "system: #{id}: #{platform}: #{package}"
+    end
   end
 
   s.metadata["msys2_mingw_dependencies"] = "gstreamer"

data/lib/gst/buffer.rb

@@ -0,0 +1,45 @@
+# Copyright (C) 2026  Ruby-GNOME Project Team
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+module Gst
+  class Buffer
+    alias_method :map_raw, :map
+    def map(flags)
+      success, info = map_raw(flags)
+      raise Gst::CoreError::Failed.new("failed to map buffer") unless success
+      return info unless block_given?
+
+      begin
+        yield info
+      ensure
+        unmap(info)
+      end
+    end
+
+    alias_method :map_range_raw, :map_range
+    def map_range(idx, length, flags)
+      success, info = map_range_raw(idx, length, flags)
+      raise Gst::CoreError::Failed.new("failed to map buffer") unless success
+      return info unless block_given?
+
+      begin
+        yield info
+      ensure
+        unmap(info)
+      end
+    end
+  end
+end

data/lib/gst/loader.rb

@@ -60,6 +60,7 @@ module Gst
 
     def require_libraries
       require "gst/bin"
+      require "gst/buffer"
       require "gst/bus"
       require "gst/caps"
       require "gst/element"

data/sample/audio-extract.rb

@@ -37,7 +37,7 @@ sink.emit_signals = true
 sink.signal_connect(:new_sample) do |_|
   sample = sink.pull_sample
   buffer = sample.buffer
-  success, map = buffer.map(:read)
+  map = buffer.map(:read)
   p map.data
   buffer.unmap(map)
   Gst::FlowReturn::OK

data/test/test-buffer.rb

@@ -0,0 +1,127 @@
+# Copyright (C) 2026  Ruby-GNOME Project Team
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+class TestBuffer < Test::Unit::TestCase
+  def setup
+    unless Gst::ElementFactory.find("videotestsrc")
+      omit("gst-plugins-good is needed")
+    end
+    @pipeline = Gst.parse_launch("videotestsrc ! appsink name=sink")
+    @sink = @pipeline.get_by_name("sink")
+  end
+
+  def test_map
+    @pipeline.play
+    begin
+      sample = @sink.try_pull_sample(Gst::SECOND)
+      buffer = sample.buffer
+      map_info = buffer.map(:read)
+
+      assert do
+        map_info.data.size >= 115200
+      end
+    ensure
+      @pipeline.stop
+    end
+  end
+
+  def test_map_with_block
+    @pipeline.play
+    begin
+      sample = @sink.try_pull_sample(Gst::SECOND)
+      buffer = sample.buffer
+      buffer.map(:read) do |map_info|
+        assert do
+          map_info.data.size >= 115200
+        end
+      end
+    ensure
+      @pipeline.stop
+    end
+  end
+
+  def test_map_fail
+    @pipeline.play
+    begin
+      sample = @sink.try_pull_sample(Gst::SECOND)
+      buffer = sample.buffer
+
+      assert_raise(Gst::CoreError::Failed) do
+        buffer.map(:write)
+      end
+    ensure
+      @pipeline.stop
+    end
+  end
+
+  def test_map_range_full
+    @pipeline.play
+    begin
+      sample = @sink.try_pull_sample(Gst::SECOND)
+      buffer = sample.buffer
+      map_info = buffer.map_range(0, -1, :read)
+
+      assert do
+        map_info.data.size >= 115200
+      end
+    ensure
+      @pipeline.stop
+    end
+  end
+
+  def test_map_range_with_block
+    @pipeline.play
+    begin
+      sample = @sink.try_pull_sample(Gst::SECOND)
+      buffer = sample.buffer
+      buffer.map_range(0, -1, :read) do |map_info|
+        assert do
+          map_info.data.size >= 115200
+        end
+      end
+    ensure
+      @pipeline.stop
+    end
+  end
+
+  def test_map_range_full_fail
+    @pipeline.play
+    begin
+      sample = @sink.try_pull_sample(Gst::SECOND)
+      buffer = sample.buffer
+
+      assert_raise(Gst::CoreError::Failed) do
+        buffer.map_range(0, -1, :write)
+      end
+    ensure
+      @pipeline.stop
+    end
+  end
+
+  def test_map_range_partial
+    allocator = Gst::Allocator.find
+    memory1 = allocator.alloc(100)
+    memory2 = allocator.alloc(200)
+    memory3 = allocator.alloc(300)
+    buffer = Gst::Buffer.new
+    buffer.append_memory(memory1)
+    buffer.append_memory(memory2)
+    buffer.append_memory(memory3)
+    map_info = buffer.map_range(1, 2, :read)
+
+    assert_equal(500, map_info.data.size)
+  end
+end

data/test/test-map-info.rb

@@ -28,8 +28,7 @@ class TestMapInfo < Test::Unit::TestCase
     begin
       sample = @sink.try_pull_sample(Gst::SECOND)
       buffer = sample.buffer
-      success, map_info = buffer.map(:read)
-      assert_true(success)
+      map_info = buffer.map(:read)
       assert do
         map_info.data.size >= 115200
       end

data/test/test-sample.rb

@@ -0,0 +1,187 @@
+# Copyright (C) 2026  Ruby-GNOME Project Team
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+require "fiddle"
+
+class TestSample < Test::Unit::TestCase
+  include GStreamerTestUtils
+
+  AUDIO_TEST_SRC_DEFAULT_SAMPLES_PER_BUFFER = 1024
+  AUDIO_TEST_SRC_RAMP = 1
+
+  def test_memory_view_mono
+    only_gstreamer_version(1, 20)
+
+    samples = generate_samples
+
+    samples.each_with_index do |sample, i|
+      Fiddle::MemoryView.export(sample) do |view|
+        assert_equal({
+                       byte_size: AUDIO_TEST_SRC_DEFAULT_SAMPLES_PER_BUFFER * 4,
+                       readonly?: true,
+                       format: "e",
+                       item_size: 4,
+                       ndim: 2,
+                       shape: [AUDIO_TEST_SRC_DEFAULT_SAMPLES_PER_BUFFER, 1],
+                       strides: [4, 4],
+                       sub_offsets: nil,
+                     },
+                     {
+                       byte_size: view.byte_size,
+                       readonly?: view.readonly?,
+                       format: view.format,
+                       item_size: view.item_size,
+                       ndim: view.ndim,
+                       shape: view.shape,
+                       strides: view.strides,
+                       sub_offsets: view.sub_offsets,
+                     })
+
+        offset = AUDIO_TEST_SRC_DEFAULT_SAMPLES_PER_BUFFER * i
+        (view.byte_size / view.item_size).times do |j|
+          assert_in_delta(Math.sin((offset + j + AUDIO_TEST_SRC_RAMP) * 2 * Math::PI * 440 / 16_000) * 0.8,
+                          view[j, 0],
+                          0.001,
+                          "#{i}th buffer, #{j}th sample")
+        end
+      end
+    end
+  end
+
+  def test_memory_view_stereo
+    only_gstreamer_version(1, 20)
+
+    samples = generate_samples(channels: 2)
+
+    samples.each_with_index do |sample, i|
+      Fiddle::MemoryView.export(sample) do |view|
+        assert_equal({
+                        byte_size: AUDIO_TEST_SRC_DEFAULT_SAMPLES_PER_BUFFER * 4 * 2,
+                        readonly?: true,
+                        format: "e",
+                        item_size: 4,
+                        ndim: 2,
+                        shape: [AUDIO_TEST_SRC_DEFAULT_SAMPLES_PER_BUFFER, 2],
+                        strides: [8, 4],
+                        sub_offsets: nil,
+                     },
+                     {
+                       byte_size: view.byte_size,
+                       readonly?: view.readonly?,
+                       format: view.format,
+                       item_size: view.item_size,
+                       ndim: view.ndim,
+                       shape: view.shape,
+                       strides: view.strides,
+                       sub_offsets: view.sub_offsets,
+                     })
+
+        offset = AUDIO_TEST_SRC_DEFAULT_SAMPLES_PER_BUFFER * i
+        (view.byte_size / view.item_size).times do |j|
+          index, channel = j.divmod(2)
+          expected_value = Math.sin((offset + index + AUDIO_TEST_SRC_RAMP) * 2 * Math::PI * 440 / 16_000) * 0.8
+          assert_in_delta(expected_value, view[index, channel], 0.001, "#{i}th buffer, #{channel}th channel, #{index}th sample")
+        end
+      end
+    end
+  end
+
+  def test_memory_view_non_interleaved
+    only_gstreamer_version(1, 20)
+
+    samples = generate_samples(layout: "non-interleaved", channels: 2)
+
+    assert_raise(ArgumentError) do
+      Fiddle::MemoryView.export(samples[0]) {}
+    end
+  end
+
+  def test_memory_view_unsupported_format
+    only_gstreamer_version(1, 20)
+
+    samples = generate_samples(format: "S24_32LE")
+
+    assert_raise(ArgumentError) do
+      Fiddle::MemoryView.export(samples[0]) {}
+    end
+  end
+
+  def test_memory_view_from_buffer_list
+    only_gstreamer_version(1, 20)
+
+    samples = generate_samples
+    assert_equal(15, samples.size)
+
+    buffer_list = Gst::BufferList.new
+    expected_data = +"".b
+
+    samples.each do |sample|
+      buffer = sample.buffer
+      buffer.map(:read) do |map|
+        expected_data << map.data.pack("C*")
+      end
+      buffer_list.insert(-1, buffer)
+    end
+
+    caps = samples.first.caps
+    sample = Gst::Sample.new(Gst::Buffer.new, caps, Gst::Segment.new, caps.structures[0])
+    sample.buffer_list = buffer_list
+
+    Fiddle::MemoryView.export(sample) do |view|
+      assert_equal(expected_data, view.to_s)
+    end
+  end
+
+  private
+
+  def generate_samples(format: "F32LE", layout: "interleaved", rate: 16_000, channels: 1)
+    samples = []
+
+    pipeline = Gst::Pipeline.new("audio-generator")
+    src = Gst::ElementFactory.make("audiotestsrc", nil)
+    convert = Gst::ElementFactory.make("audioconvert", nil)
+    sink = Gst::ElementFactory.make("appsink", nil)
+
+    src.set_property("num-buffers", rate / AUDIO_TEST_SRC_DEFAULT_SAMPLES_PER_BUFFER)
+
+    caps = Gst::Caps.new("audio/x-raw")
+    caps["format"] = format
+    caps["rate", :int] = rate
+    caps["channels", :int] = channels
+    caps["layout"] = layout
+
+    sink.caps = caps
+
+    pipeline << src << convert << sink
+    src >> convert >> sink
+
+    pipeline.play
+    begin
+      loop do
+        sample = sink.try_pull_sample(Gst::SECOND)
+        if sample
+          samples << sample
+        else
+          break
+        end
+      end
+    ensure
+      pipeline.stop
+    end
+
+    samples
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gstreamer
 version: !ruby/object:Gem::Version
-  version: 4.3.6
+  version: 4.3.7
 platform: ruby
 authors:
 - The Ruby-GNOME Project Team
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 4.3.6
+        version: 4.3.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 4.3.6
+        version: 4.3.7
 description: Ruby/GStreamer is a Ruby binding for GStreamer.
 email: ruby-gnome2-devel-en@lists.sourceforge.net
 executables: []
@@ -37,6 +37,7 @@ files:
 - ext/gstreamer/extconf.rb
 - ext/gstreamer/rbgst-child-proxy.c
 - ext/gstreamer/rbgst-element.c
+- ext/gstreamer/rbgst-sample.c
 - ext/gstreamer/rbgst.c
 - ext/gstreamer/rbgst.h
 - extconf.rb
@@ -45,6 +46,7 @@ files:
 - lib/gst/audio-loader.rb
 - lib/gst/base-loader.rb
 - lib/gst/bin.rb
+- lib/gst/buffer.rb
 - lib/gst/bus.rb
 - lib/gst/caps.rb
 - lib/gst/controller-loader.rb
@@ -74,11 +76,13 @@ files:
 - test/run-test.rb
 - test/test-audio.rb
 - test/test-bin.rb
+- test/test-buffer.rb
 - test/test-bus.rb
 - test/test-caps.rb
 - test/test-child-proxy.rb
 - test/test-element-factory.rb
 - test/test-map-info.rb
+- test/test-sample.rb
 - test/test-tag-list.rb
 - test/test-version.rb
 homepage: https://ruby-gnome.github.io/
@@ -106,10 +110,19 @@ requirements:
 - 'system: gstreamer-1.0: conda: gstreamer'
 - 'system: gstreamer-1.0: debian: libgstreamer1.0-dev'
 - 'system: gstreamer-1.0: homebrew: gstreamer'
-- 'system: gstreamer-1.0: macports: gstreamer'
+- 'system: gstreamer-1.0: macports: gstreamer1'
 - 'system: gstreamer-1.0: msys2: gstreamer'
 - 'system: gstreamer-1.0: rhel: pkgconfig(gstreamer-1.0)'
-rubygems_version: 4.0.6
+- 'system: gstreamer-audio-1.0: alpine_linux: gst-plugins-base-dev'
+- 'system: gstreamer-audio-1.0: alt_linux: gst-plugins1.0-devel'
+- 'system: gstreamer-audio-1.0: alt_linux: liborc-devel'
+- 'system: gstreamer-audio-1.0: arch_linux: gst-plugins-base'
+- 'system: gstreamer-audio-1.0: conda: gst-plugins-base'
+- 'system: gstreamer-audio-1.0: debian: libgstreamer-plugins-base1.0-dev'
+- 'system: gstreamer-audio-1.0: macports: gstreamer1-gst-plugins-base'
+- 'system: gstreamer-audio-1.0: msys2: gst-plugins-base'
+- 'system: gstreamer-audio-1.0: rhel: pkgconfig(gstreamer-audio-1.0)'
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Ruby/GStreamer is a Ruby binding for GStreamer.
 test_files: []