libpng 1.6.58.3 → 1.6.58.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b8e15eabb884474f99879a934d6472eba94e686b19dd734f87a6ab80b7f815d2
-  data.tar.gz: 511877de0b69d9813a7eec8ea2d5e25ab932a32a9edf89139ac8a5e635adf426
+  metadata.gz: e9edc7cf7190ff782780b914a63bc3a26cd3c1dd71199c26ec144e3e3f72619f
+  data.tar.gz: bed30533f0f5b33e4064213aa6bacecb8e815ca56234a8991ae8af70627cb40f
 SHA512:
-  metadata.gz: 1bdb8b75f3ca27c415793d03ba234b18e63a155266e1f187012866eceda8c3e40b5409375a3045a1686ea6c3bed527c8d8be710aeb2a68483f362273c5bf467e
-  data.tar.gz: ae9cf74ed74fc27bf55ddc92a4a50b2cd347a0319e3d8eb6821e2456a7dd762e062061b7a208708ef358161251b7ae488f80a46aa783effe85b164280f49f036
+  metadata.gz: e94cbd6af3fbc2accb177d8f3adc9565582d1853e9f998ff314934b6b5f2816f058164b40a32ee7661b55ea5c58e920c03d600d30e49e7f1d51d5f71e280f3f7
+  data.tar.gz: 88fca2579a17b68e184b381483687e43eef88d5a104ac74deb12056bd376e494db7e3b795312fad2042219979a0c9119b2daef8cd4dd2e47c6cf49925a2f5274

data/.github/workflows/build.yml

@@ -143,6 +143,12 @@ jobs:
             platform: x86_64-linux-musl
           - os: ubuntu-24.04-arm
             platform: aarch64-linux-musl
+          # OHOS (OpenHarmony / Huawei HarmonyOS PC) is musl-based arm64.
+          # Built inside the same Alpine container as aarch64-linux-musl;
+          # the resulting binary is byte-compatible. Only the gem's
+          # platform label differs so RubyGems on OHOS selects it.
+          - os: ubuntu-24.04-arm
+            platform: aarch64-linux-ohos
 
     steps:
     - uses: actions/checkout@v4
@@ -168,12 +174,27 @@ jobs:
         git config --global --add safe.directory /work
         bundle install --jobs 4
         bundle exec rake "gem:native:${PLATFORM}"
-        gem install -b pkg/libpng-*.gem
-        # Smoke test from /tmp so bundler's source-tree LOAD_PATH doesn't
-        # shadow the installed gem. Activate via `gem` so RubyGems resolves
-        # the platform-specific binary gem (Alpine Ruby's platform string
-        # is *-linux-musl, which must match the gem's platform suffix).
-        (cd /tmp && ruby -e 'gem "libpng"; require "libpng"; png = Libpng.encode(2, 2, "\xff" * 16, pixel_format: "RGBA"); File.binwrite("test.png", png); puts Libpng.decode(png, pixel_format: "RGBA").inspect')
+        case "${PLATFORM}" in
+          *-ohos)
+            # OHOS gem is labeled aarch64-linux-ohos so RubyGems on OHOS
+            # selects it, but Alpine Ruby reports *-linux-musl -- a
+            # platform mismatch. The .so inside is musl-compatible, so
+            # unpack the gem and load it via -Ilib directly to verify
+            # the binary works without going through RubyGems install.
+            mkdir -p /tmp/ohos-smoke
+            gem unpack pkg/libpng-*.gem --target /tmp/ohos-smoke
+            (cd /tmp/ohos-smoke/libpng-* && \
+              ruby -Ilib -e 'require "libpng"; png = Libpng.encode(2, 2, "\xff" * 16, pixel_format: "RGBA"); puts Libpng.decode(png, pixel_format: "RGBA").inspect')
+            ;;
+          *)
+            gem install -b pkg/libpng-*.gem
+            # Smoke test from /tmp so bundler's source-tree LOAD_PATH doesn't
+            # shadow the installed gem. Activate via `gem` so RubyGems resolves
+            # the platform-specific binary gem (Alpine Ruby's platform string
+            # is *-linux-musl, which must match the gem's platform suffix).
+            (cd /tmp && ruby -e 'gem "libpng"; require "libpng"; png = Libpng.encode(2, 2, "\xff" * 16, pixel_format: "RGBA"); File.binwrite("test.png", png); puts Libpng.decode(png, pixel_format: "RGBA").inspect')
+            ;;
+        esac
         BUILD_EOF
         chmod +x /tmp/alpine-build.sh
         docker run --rm \

data/.github/workflows/release.yml

@@ -201,6 +201,10 @@ jobs:
             platform: x86_64-linux-musl
           - os: ubuntu-24.04-arm
             platform: aarch64-linux-musl
+          # OHOS: same Alpine-built musl arm64 binary as aarch64-linux-musl,
+          # packaged under a distinct platform label.
+          - os: ubuntu-24.04-arm
+            platform: aarch64-linux-ohos
     steps:
       - uses: actions/checkout@v4
         with:
@@ -218,8 +222,22 @@ jobs:
           git config --global --add safe.directory /work
           bundle install --jobs 4
           bundle exec rake "gem:native:${PLATFORM}"
-          gem install -b pkg/libpng-*.gem
-          (cd /tmp && ruby -e 'gem "libpng"; require "libpng"; png = Libpng.encode(2, 2, "\xff" * 16, pixel_format: "RGBA"); puts Libpng.decode(png, pixel_format: "RGBA").inspect')
+          case "${PLATFORM}" in
+            *-ohos)
+              # OHOS gem is labeled aarch64-linux-ohos so RubyGems on OHOS
+              # selects it, but Alpine Ruby reports *-linux-musl. The .so
+              # inside is musl-compatible -- unpack and load via -Ilib to
+              # verify the binary without going through RubyGems install.
+              mkdir -p /tmp/ohos-smoke
+              gem unpack pkg/libpng-*.gem --target /tmp/ohos-smoke
+              (cd /tmp/ohos-smoke/libpng-* && \
+                ruby -Ilib -e 'require "libpng"; png = Libpng.encode(2, 2, "\xff" * 16, pixel_format: "RGBA"); puts Libpng.decode(png, pixel_format: "RGBA").inspect')
+              ;;
+            *)
+              gem install -b pkg/libpng-*.gem
+              (cd /tmp && ruby -e 'gem "libpng"; require "libpng"; png = Libpng.encode(2, 2, "\xff" * 16, pixel_format: "RGBA"); puts Libpng.decode(png, pixel_format: "RGBA").inspect')
+              ;;
+          esac
           BUILD_EOF
           chmod +x /tmp/alpine-build.sh
           docker run --rm \

data/.gitignore

@@ -12,6 +12,8 @@
 /lib/libpng/*.so.*
 /lib/libpng/*.dylib
 /lib/libpng/*.dll
+/Makefile
+/lib/libpng/Makefile
 /.idea/
 /.vscode/
 *.gem

data/.rspec

@@ -1,3 +1,3 @@
-RSpec
 --format documentation
 --color
+--require spec_helper

data/.rubocop.yml

@@ -22,7 +22,7 @@ Metrics/ModuleLength:
 Metrics/PerceivedComplexity:
   Max: 20
 Metrics/ParameterLists:
-  Max: 9
+  Max: 10
 
 Metrics/BlockLength:
   Exclude:
@@ -37,3 +37,11 @@ Style/FrozenStringLiteralComment:
   Exclude:
     - ext/extconf.rb
     - lib/libpng/recipe.rb
+
+# libpng's C function names use mixed case + digits (e.g.
+# png_set_strip_16, png_set_expand_gray_1_2_4_to_8). We attach them
+# via FFI with their canonical names so docs and headers cross-
+# reference cleanly.
+Naming/VariableNumber:
+  Exclude:
+    - lib/libpng/binding.rb

data/CHANGELOG.md

@@ -7,6 +7,70 @@ This gem follows a `{LIBPNG_VERSION}.{LIBPNG_RUBY_ITERATION}` version
 scheme. `LIBPNG_VERSION` is the upstream libpng release; `ITERATION`
 bumps for Ruby-side changes and resets to 0 when LIBPNG_VERSION bumps.
 
+## [1.6.58.5] - 2026-07-26
+
+### Added
+- **Write-side metadata on `encode_standard`**. Six new keyword options:
+  - `text:` -- `Hash<String,String>` of tEXt/iTXt entries. Non-ASCII
+    values automatically use iTXt (UTF-8) instead of tEXt (Latin-1).
+  - `gamma:` -- `Float` file gamma (e.g. `0.45455` for sRGB).
+  - `srgb_intent:` -- `Integer 0..3` rendering intent.
+  - `chromaticities:` -- `Hash` with the 8 cHRM primaries.
+  - `icc_profile:` -- `Hash` with `:name` and `:data` for an ICC
+    color profile (libpng compresses internally).
+  - `phys:` -- `Hash` with `:pixels_per_unit_x/y` and `:unit`
+    (`0` unknown, `1` meters).
+- **`pHYs` chunk read support**. `Libpng::ChunkWalker#phys_chunk`
+  returns a Hash with `:pixels_per_unit_x/y`, `:unit`, and (when
+  `unit==1`) computed `:dpi_x/y`. `DecodedImage#phys` is populated
+  by both decode paths.
+- **`Libpng.decode_standard`** -- standard libpng read API
+  (`png_create_read_struct` -> `png_read_info` -> transforms ->
+  `png_read_image`). Counterpart to `encode_standard`; gives
+  callers explicit control over which transforms apply
+  (palette-to-RGB, gray-to-RGB, alpha add/strip, 16-to-8 demotion,
+  interlace handling). Returns the same `DecodedImage` shape as
+  `decode`, so metadata access is uniform across both decode paths.
+- New classes/modules: `Libpng::StandardDecoder`,
+  `Libpng::MetadataWriter`, `Libpng::TextWriter`, `Libpng::TextEntry`.
+- 27 new specs across `spec/write_metadata_spec.rb` (round-trips for
+  every metadata type + validation errors) and
+  `spec/standard_decoder_spec.rb` (transform coverage + Ractor safety).
+
+### Fixed
+- Internal: refactored `StandardEncoder` to delegate metadata writing
+  to `MetadataWriter`. Class length back under rubocop limits.
+- Corrected `FILLER_BEFORE`/`FILLER_AFTER` constant values (the code
+  had them swapped -- libpng uses `BEFORE=0, AFTER=1`).
+
+## [1.6.58.4] - 2026-07-26
+
+### Added
+- `Libpng::ChunkWalker#text_chunks` -- parses `tEXt`, `zTXt`, and `iTXt`
+  chunks into a flat Hash of keyword -> UTF-8 String. zTXt values are
+  zlib-inflated; tEXt/zTXt values are transcoded from Latin-1 to UTF-8;
+  iTXt values stay UTF-8 (with optional compression). Malformed chunks
+  are silently skipped so a single broken entry doesn't poison the rest
+  of the decode.
+- `Libpng::ChunkWalker#color_chunks` -- parses `gAMA`, `cHRM`, `sRGB`,
+  and `iCCP` chunks into a Hash with Symbol keys (`:gamma`,
+  `:white_point_x/y`, `:red_x/y`, `:green_x/y`, `:blue_x/y`,
+  `:srgb_intent`, `:icc_profile_name`, `:icc_profile`). iCCP profiles
+  are zlib-decompressed into raw binary bytes for downstream ICC
+  libraries.
+- `Libpng::DecodedImage#text` and `#color` -- new keyword Struct fields,
+  populated by `Libpng.decode` via the new ChunkWalker accessors. Both
+  default to an empty Hash when the source PNG has no relevant chunks.
+- New platform: `aarch64-linux-ohos` (OpenHarmony / Huawei HarmonyOS PC).
+  OHOS is musl-based arm64 -- the resulting shared library is
+  byte-compatible with `aarch64-linux-musl`; only the gem's platform
+  label differs so RubyGems on OHOS selects the right variant. Built in
+  the same Alpine container as the musl gem.
+- Specs: 24 new specs across `spec/text_chunk_spec.rb` and
+  `spec/color_metadata_spec.rb` covering all 7 chunk types, malformed
+  input handling, Ractor moving, and end-to-end metadata exposure on
+  `DecodedImage`.
+
 ## [1.6.58.3] - 2026-07-26
 
 ### Added

data/CLAUDE.md

@@ -6,7 +6,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 `libpng` is a Ruby gem that wraps the official libpng shared library via FFI. The native `libpng16.{so,dylib,dll}` is **pre-compiled per target platform and shipped inside the gem** — `gem install libpng` must not require a C compiler on the host.
 
-10 platform gems are published per release (see README for the full matrix).
+11 platform gems are published per release (10 native + the source `ruby` gem). Native targets: `x86_64-linux`, `x86_64-linux-musl`, `aarch64-linux`, `aarch64-linux-musl`, `aarch64-linux-ohos`, `x64-mingw32`, `x64-mingw-ucrt`, `aarch64-mingw-ucrt`, `x86_64-darwin`, `arm64-darwin`.
 
 ## Architecture
 
@@ -20,12 +20,15 @@ loaded via `autoload` from `lib/libpng.rb`. **Never use `require_relative`
 | `lib/libpng.rb` | Module + FFI setup + constants + public dispatch (`encode`/`decode`/`encode_standard`) + autoloads |
 | `lib/libpng/version.rb` | `LIBPNG_VERSION`, `LIBPNG_RUBY_ITERATION`, `VERSION` |
 | `lib/libpng/error.rb` | `Libpng::Error` |
-| `lib/libpng/decoded_image.rb` | `Libpng::DecodedImage` (Struct returned by `decode`) |
-| `lib/libpng/chunk_walker.rb` | `Libpng::ChunkWalker` (walk/strip/extract metadata from PNG bytes) |
+| `lib/libpng/decoded_image.rb` | `Libpng::DecodedImage` (Struct returned by `decode` / `decode_standard`) |
+| `lib/libpng/chunk_walker.rb` | `Libpng::ChunkWalker` (walk/strip/extract metadata: `#each_chunk`, `#ihdr_fields`, `#text_chunks` for tEXt/zTXt/iTXt, `#color_chunks` for gAMA/cHRM/sRGB/iCCP, `#phys_chunk` for pHYs, `#strip_ancillary`) |
 | `lib/libpng/bytes_per_pixel.rb` | `Libpng::BytesPerPixel` (pure-data lookup) |
 | `lib/libpng/simplified_encoder.rb` | `Libpng::SimplifiedEncoder` (libpng simplified write API) |
-| `lib/libpng/simplified_decoder.rb` | `Libpng::SimplifiedDecoder` (libpng simplified read API + IHDR metadata) |
-| `lib/libpng/standard_encoder.rb` | `Libpng::StandardEncoder` (libpng standard write API with filter/compression/interlace/bit_depth/palette options) |
+| `lib/libpng/simplified_decoder.rb` | `Libpng::SimplifiedDecoder` (libpng simplified read API + metadata via ChunkWalker) |
+| `lib/libpng/standard_encoder.rb` | `Libpng::StandardEncoder` (libpng standard write API; filter/compression/interlace/bit_depth/palette + metadata via MetadataWriter) |
+| `lib/libpng/standard_decoder.rb` | `Libpng::StandardDecoder` (libpng standard read API; explicit transform control) |
+| `lib/libpng/metadata_writer.rb` | `Libpng::MetadataWriter` (validates + writes text/gAMA/sRGB/cHRM/iCCP/pHYs onto a png_ptr/info_ptr pair) |
+| `lib/libpng/text_writer.rb` | `Libpng::TextWriter` + `Libpng::TextEntry` (builds png_text struct array, calls `png_set_text`) |
 | `lib/libpng/recipe.rb` | `Libpng::Recipe < MiniPortileCMake` (builds libpng from source for the source gem) |
 | `ext/extconf.rb` | Gem extension entry. Triggers `Libpng::Recipe` autoload via `require 'libpng'`, then emits a dummy Makefile |
 
@@ -33,7 +36,9 @@ loaded via `autoload` from `lib/libpng.rb`. **Never use `require_relative`
 
 ```ruby
 Libpng.encode(width, height, pixels, pixel_format:, convert_to_8bit:, strip_colorspace:)
-Libpng.encode_standard(width, height, pixels, pixel_format:, filter:, compression_level:, interlace:, bit_depth:, palette:)
+Libpng.encode_standard(width, height, pixels, pixel_format:, filter:, compression_level:, interlace:, bit_depth:, palette:, **metadata)
+Libpng.decode(png, pixel_format:)
+Libpng.decode_standard(png, pixel_format:, bit_depth:)
 Libpng.decode(png, pixel_format:)
 ```
 
@@ -58,7 +63,7 @@ Ruby 4.0 removed `Ractor#take`; use the helper `ractor_result(r)` which prefers
 ```sh
 bundle install
 bundle exec rake compile         # build libpng via MiniPortile (needs cmake + zlib)
-bundle exec rake spec            # all specs (~81 examples)
+bundle exec rake spec            # all specs (~132 examples)
 bundle exec rspec spec/libpng_spec.rb:17   # single spec by line
 bundle exec rake rubocop
 bundle exec rake                 # default: spec + rubocop
@@ -67,7 +72,7 @@ bundle exec rake gem:native:arm64-darwin    # build a pre-compiled gem
 bundle exec rake gem:native:any             # source gem (compiles on install)
 ```
 
-Platform gem tasks: `x64-mingw32`, `x64-mingw-ucrt`, `aarch64-mingw-ucrt`, `x86_64-linux`, `x86_64-linux-musl`, `aarch64-linux`, `aarch64-linux-musl`, `x86_64-darwin`, `arm64-darwin`.
+Platform gem tasks: `x64-mingw32`, `x64-mingw-ucrt`, `aarch64-mingw-ucrt`, `x86_64-linux`, `x86_64-linux-musl`, `aarch64-linux`, `aarch64-linux-musl`, `aarch64-linux-ohos`, `x86_64-darwin`, `arm64-darwin`.
 
 ## Release process
 
@@ -79,7 +84,7 @@ gh workflow run release.yml --repo claricle/libpng-ruby --ref main -f bump-type=
 # or: -f bump-type=current  # release current VERSION as-is
 ```
 
-The workflow bumps `lib/libpng/version.rb`, pushes a `v*` tag, builds all 10 platform gems, and publishes to RubyGems via OIDC Trusted Publishing.
+The workflow bumps `lib/libpng/version.rb`, pushes a `v*` tag, builds all 11 platform gems (10 native + the source `ruby` gem), and publishes to RubyGems via OIDC Trusted Publishing.
 
 **Never** push tags or merge to main directly — always go through PRs.
 
@@ -96,14 +101,17 @@ The workflow bumps `lib/libpng/version.rb`, pushes a `v*` tag, builds all 10 pla
 - `spec/libpng_spec.rb` — `encode`/`decode` simplified API
 - `spec/libpng_standard_spec.rb` — `encode_standard` core
 - `spec/standard_encoder_options_spec.rb` — `interlace:`/`bit_depth:`/`palette:` options
+- `spec/write_metadata_spec.rb` — text/gAMA/sRGB/cHRM/pHYs write round-trips + validation
 - `spec/decoded_image_metadata_spec.rb` — IHDR metadata + `ChunkWalker`
+- `spec/text_chunk_spec.rb` — tEXt/zTXt/iTXt parsing (read side)
+- `spec/color_metadata_spec.rb` — gAMA/cHRM/sRGB/iCCP parsing (read side)
+- `spec/standard_decoder_spec.rb` — `decode_standard` transforms + Ractor safety
 - `spec/malformed_input_spec.rb` — corrupt PNG input handling
 - `spec/ractor_spec.rb` — Ractor safety for simplified API
-- `spec/ractor_standard_spec.rb` — Ractor safety for standard API
+- `spec/ractor_standard_spec.rb` — Ractor safety for standard write API
 - `spec/benchmark_spec.rb` — encode/decode timing comparison
 
 ## See also
 
-- `TODO.roadmap/` — prioritized backlog with status (done/planned/wontdo) per item
 - `CHANGELOG.md` — release history
 - `REPORT-complex-api-needs.md` — historical report that drove `encode_standard`

data/README.adoc

@@ -31,8 +31,9 @@ source tarball at install time and compiles it via CMake (requires
 
 == Supported platforms
 
-The following pre-compiled platform gems are published for each release
-(see the link:https://rubygems.org/gems/libpng/versions[RubyGems versions page]
+The following 11 pre-compiled platform gems are published for each
+release -- 10 native targets plus the platform-agnostic source (`ruby`)
+gem (see the link:https://rubygems.org/gems/libpng/versions[RubyGems versions page]
 for the current set):
 
 [cols="1,1,3", options="header"]
@@ -43,6 +44,7 @@ for the current set):
 | `x86_64-linux-musl` | x86_64 Linux (musl, e.g. Alpine) | `ruby:<ver>-alpine` on x86_64
 | `aarch64-linux` | ARM64 Linux (glibc) | `ubuntu-24.04-arm` (native)
 | `aarch64-linux-musl` | ARM64 Linux (musl) | `ruby:<ver>-alpine` on arm64
+| `aarch64-linux-ohos` | ARM64 OpenHarmony / Huawei HarmonyOS PC | `ruby:<ver>-alpine` on arm64 (byte-compatible with `aarch64-linux-musl`)
 | `x64-mingw32` | x64 Windows, RubyInstaller < 3.0 (MSVCRT) | `windows-latest`
 | `x64-mingw-ucrt` | x64 Windows, RubyInstaller >= 3.0 (UCRT) | `windows-latest`
 | `aarch64-mingw-ucrt` | ARM64 Windows (Ruby >= 3.4) | `windows-11-arm` (native)
@@ -67,6 +69,9 @@ for the current set):
   decoded.bit_depth   # => 8 (from IHDR)
   decoded.color_type  # => 6 (PNG_COLOR_TYPE_RGB_ALPHA, from IHDR)
   decoded.interlace   # => 0 (PNG_INTERLACE_NONE, from IHDR)
+  decoded.text        # => {"Title" => "Sunset", "Author" => "Jane"} (tEXt/zTXt/iTXt)
+  decoded.color       # => {:gamma => 0.45455, :srgb_intent => 0, ...} (gAMA/cHRM/sRGB/iCCP)
+  decoded.phys        # => {:pixels_per_unit_x => 3779, :unit => 1, :dpi_x => 95.99, ...} (pHYs)
 
 === Supported pixel formats
 
@@ -105,7 +110,14 @@ by `libemf2svg`'s `rgb2png` -- use `encode_standard` instead of
                          compression_level: 6,
                          interlace: :none,
                          bit_depth: 8,
-                         palette: nil)
+                         palette: nil,
+                         # Metadata writers (each optional):
+                         text: { "Title" => "Sunset", "Author" => "Jane" },
+                         gamma: 0.45455,
+                         srgb_intent: 0,
+                         chromaticities: { white_point_x: 0.3127, ... },
+                         icc_profile: { name: "sRGB IEC61966-2.1", data: bytes },
+                         phys: { pixels_per_unit_x: 3779, pixels_per_unit_y: 3779, unit: 1 })
 
 `pixel_format`:: `:gray`, `:ga`, `:rgb`, `:rgba`, or `:palette`. The
 byte-order variants (`BGR`, `ARGB`, `BGRA`, `ABGR`) are simplified-API
@@ -144,12 +156,29 @@ Differences from `encode`:
   `ensure` block calls `png_destroy_write_struct` to release the C
   state.
 
+=== Standard API (decode_standard)
+
+`Libpng.decode_standard` is the read-side counterpart to
+`encode_standard`. It calls `png_create_read_struct` +
+`png_set_read_fn` (memory reader) + `png_read_info` + transforms +
+`png_read_image`, giving the caller explicit control over which
+transforms apply (palette-to-RGB, gray-to-RGB, alpha add/strip,
+16-to-8 demotion, interlace handling).
+
+  decoded = Libpng.decode_standard(png_bytes, pixel_format: "RGBA", bit_depth: 8)
+
+Returns the same `Libpng::DecodedImage` shape as `decode`, so metadata
+fields (`text`, `color`, `phys`) work uniformly across both decode
+paths. Use `decode` for the common case (auto-transforms); use
+`decode_standard` when you need to know exactly which transforms
+applied (e.g. for parity with `libemf2svg`'s `png2rgb`).
+
 == Ractor safety
 
-`Libpng.encode` and `Libpng.decode` are Ractor-safe. Every call
-allocates and frees its own libpng `png_image`; no shared mutable state
-exists on the Ruby side. Calls from multiple Ractors run concurrently
-without locking.
+`Libpng.encode`, `Libpng.encode_standard`, `Libpng.decode`, and
+`Libpng.decode_standard` are all Ractor-safe. Every call allocates and
+frees its own libpng state; no shared mutable state exists on the Ruby
+side. Calls from multiple Ractors run concurrently without locking.
 
 Example (Ruby 3.x uses `Ractor#take`; Ruby 4.0+ uses `Ractor#value`):
 

data/Rakefile

@@ -39,6 +39,7 @@ platforms = %w[
   x86_64-linux-musl
   aarch64-linux
   aarch64-linux-musl
+  aarch64-linux-ohos
   x86_64-darwin
   arm64-darwin
 ]

data/lib/libpng/binding.rb

@@ -28,7 +28,9 @@ module Libpng
     # __dir__ is lib/libpng/; the shared library ships at lib/libpng/.
     ffi_lib File.expand_path(lib_filename, __dir__)
 
+    # ----------------------------------------------------------------
     # libpng simplified API (png_image / png_image_*).
+    # ----------------------------------------------------------------
     attach_function :png_image_begin_read_from_memory,
                     %i[pointer pointer size_t], :int
     attach_function :png_image_finish_read,
@@ -37,7 +39,9 @@ module Libpng
                     %i[pointer pointer pointer int pointer int pointer], :int
     attach_function :png_image_free, [:pointer], :void
 
-    # libpng standard (non-simplified) write API.
+    # ----------------------------------------------------------------
+    # libpng standard write API.
+    # ----------------------------------------------------------------
     attach_function :png_create_write_struct,
                     %i[string pointer pointer pointer], :pointer
     attach_function :png_create_info_struct, [:pointer], :pointer
@@ -53,5 +57,77 @@ module Libpng
     attach_function :png_set_write_fn,
                     %i[pointer pointer pointer pointer], :void
     attach_function :png_write_png, %i[pointer pointer int pointer], :void
+
+    # ----------------------------------------------------------------
+    # Metadata writers (called between png_set_IHDR and png_write_png).
+    # ----------------------------------------------------------------
+    # png_text is a struct; we pass an array pointer + count.
+    attach_function :png_set_text,
+                    %i[pointer pointer pointer int], :void
+    # file_gamma is a double.
+    attach_function :png_set_gAMA,
+                    %i[pointer pointer double], :void
+    attach_function :png_set_sRGB,
+                    %i[pointer pointer int], :void
+    # 8 chromaticity doubles (white_x, white_y, r_x, r_y, g_x, g_y, b_x, b_y).
+    attach_function :png_set_cHRM,
+                    %i[pointer pointer double double double double
+                       double double double double], :void
+    # png_set_iCCP(png_ptr, info_ptr, name, compression_type, profile, length)
+    attach_function :png_set_iCCP,
+                    %i[pointer pointer string int pointer uint], :void
+    # png_set_pHYs(png_ptr, info_ptr, res_x, res_y, unit_type)
+    attach_function :png_set_pHYs,
+                    %i[pointer pointer uint32 uint32 int], :void
+
+    # ----------------------------------------------------------------
+    # libpng standard read API.
+    # ----------------------------------------------------------------
+    attach_function :png_create_read_struct,
+                    %i[string pointer pointer pointer], :pointer
+    attach_function :png_destroy_read_struct, %i[pointer pointer pointer], :void
+    attach_function :png_set_read_fn,
+                    %i[pointer pointer pointer pointer], :void
+    attach_function :png_read_info, %i[pointer pointer], :void
+    attach_function :png_read_update_info, %i[pointer pointer], :void
+    attach_function :png_read_image, %i[pointer pointer], :void
+    attach_function :png_read_end, %i[pointer pointer], :void
+    # Returns the byte count per row AFTER any transforms are applied.
+    attach_function :png_get_rowbytes, %i[pointer pointer], :size_t
+    # Returns the post-transform color type / bit depth / channels.
+    attach_function :png_get_color_type, %i[pointer pointer], :uint8
+    attach_function :png_get_bit_depth, %i[pointer pointer], :uint8
+    attach_function :png_get_channels, %i[pointer pointer], :uint8
+    # Returns post-transform width / height (transforms rarely change these).
+    attach_function :png_get_image_width, %i[pointer pointer], :uint32
+    attach_function :png_get_image_height, %i[pointer pointer], :uint32
+    attach_function :png_get_interlace_type, %i[pointer pointer], :uint8
+    # png_get_IHDR signature differs from png_set_IHDR: widths are passed
+    # by reference (pointer to uint32) so libpng can write them back.
+    attach_function :png_get_IHDR,
+                    %i[pointer pointer pointer pointer pointer pointer
+                       pointer pointer pointer], :uint32
+
+    # ----------------------------------------------------------------
+    # Read-side transforms (call between png_read_info and png_read_image).
+    # Each takes only (png_ptr); they toggle internal state.
+    # ----------------------------------------------------------------
+    attach_function :png_set_expand, [:pointer], :void
+    attach_function :png_set_palette_to_rgb, [:pointer], :void
+    attach_function :png_set_tRNS_to_alpha, [:pointer], :void
+    attach_function :png_set_strip_alpha, [:pointer], :void
+    attach_function :png_set_strip_16, [:pointer], :void
+    attach_function :png_set_expand_gray_1_2_4_to_8, [:pointer], :void
+    attach_function :png_set_gray_to_rgb, [:pointer], :void
+    attach_function :png_set_rgb_to_gray, %i[pointer int double double], :void
+    attach_function :png_set_filler, %i[pointer uint int], :void
+    attach_function :png_set_add_alpha, %i[pointer uint int], :void
+    attach_function :png_set_packing, [:pointer], :void
+    attach_function :png_set_swap, [:pointer], :void
+    attach_function :png_set_interlace_handling, [:pointer], :int
+    attach_function :png_set_gamma, %i[pointer double double], :void
+
+    # PNG_INFO_* bit flags returned by png_get_valid.
+    attach_function :png_get_valid, %i[pointer pointer uint], :uint
   end
 end