freetype-ruby 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: adc5b7ad1ba57d87445fae976c5efb291089b19029c1d2cb274adef20c38abc7
+  data.tar.gz: e95fad7662fee87f88d2eac4942ee7b6f92ffa0bf347abfc6f64132dfaa33f5a
+SHA512:
+  metadata.gz: f6670e92527f4a077838d143aa1b7fb9a7799a7e42082a271e8a89639844691452a737d305ad80effbc1d385daf035cf684bd3a56f6dd097ab441ba7c79a74f8
+  data.tar.gz: f0df4c355e61f1da405ac07423e0c1da67a15199b458c701a77e24ba87b2d898ef29c79705a8c847c7c87f98cac2677ca829c86f8607ffc28fe6b01c0dec4627

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Yudai Takada
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,175 @@
+# freetype
+
+Ruby FFI bindings for FreeType 2.11 and newer. The public API converts all
+FreeType 26.6 and 16.16 fixed-point values to pixel `Float`s and provides the
+rasterization half of a shape → rasterize → atlas → GPU text pipeline.
+
+## Requirements
+
+- Ruby 3.2 or newer
+- A system FreeType library (2.11 or newer for SDF rendering)
+- The `ffi` gem
+- Optional: `texel` for `Texel::Image` bitmap values
+- Optional: `harfbuzz-ruby` for shaped text meshes
+- Optional: `rugl` plus GLFW/OpenGL for the GPU example
+
+Install FreeType with the platform package manager, then add the gem:
+
+```sh
+bundle add freetype
+```
+
+The native loader searches `freetype`, `libfreetype.so.6`, and
+`libfreetype.6.dylib`. Set `FREETYPE_LIBRARY` to an explicit shared-library
+path when the system loader cannot find it.
+
+## Faces and glyphs
+
+```ruby
+require "freetype"
+
+FreeType.open do |library|
+  library.face("NotoSansJP-Regular.ttf") do |face|
+    face.set_pixel_size(32)
+
+    p face.family_name
+    p face.style_name
+    p face.metrics # ascender, descender, line_height, max_advance in pixels
+
+    glyph = face.glyph("あ")
+    glyph = face.glyph_by_id(1234) # use this for HarfBuzz output
+    p [glyph.width, glyph.height, glyph.bearing_x, glyph.bearing_y, glyph.advance]
+  end
+end
+```
+
+`Library#face` also accepts font bytes. A memory face retains its own frozen
+copy for the full face lifetime because FreeType does not copy the source:
+
+```ruby
+font_bytes = File.binread("font.ttf")
+face = library.face(font_bytes)
+```
+
+Use `set_char_size(pt: 12, dpi: 96)` for point sizes. `Face#kerning` accepts
+two glyph IDs. `Face#line_advance` is a small unshaped helper for simple text;
+use HarfBuzz for script shaping, bidi text, and production layout.
+
+The normal bitmap is an immutable `Texel::Image` with one `:u8` channel and
+`:linear` color space when Texel is installed. Otherwise it is an immutable
+`{ width:, height:, data: }` hash. Mono bitmaps are expanded to byte values
+0 and 255, and all row pitch padding and bottom-up storage are normalized.
+
+## SDF and atlases
+
+```ruby
+glyph = face.glyph("A", mode: :sdf, spread: 8)
+
+atlas = FreeType::Atlas.build(
+  face,
+  chars: FreeType::Charset::ASCII + "こんにちは世界".chars,
+  size: 48,
+  mode: :sdf,
+  padding: 2,
+  max_width: 1024
+)
+
+atlas.image   # one-channel u8 image; both dimensions are powers of two
+atlas.entries # glyph ID => normalized UV and pixel metrics
+atlas.metrics
+atlas.missing
+```
+
+Pass `glyph_ids:` instead of `chars:` when shaping has already produced glyph
+IDs. `Charset` includes `ASCII`, `LATIN1`, `KANA`, and the 2,136-character
+`JOYO_KANJI` set. SDF rendering raises `FreeType::UnsupportedError` on
+FreeType older than 2.11.
+
+## HarfBuzz text meshes
+
+Load the optional integration and configure the HarfBuzz font at 26.6 pixel
+scale. This makes its advances and offsets use the same coordinate system as
+the FreeType atlas:
+
+```ruby
+require "freetype/harfbuzz"
+
+size = 48
+hb_font.scale = [size * 64, size * 64]
+hb_font.ppem = [size, size]
+
+buffer = HarfBuzz::Buffer.new
+buffer.add_utf8("グラフィックス強化中")
+buffer.guess_segment_properties
+HarfBuzz.shape(hb_font, buffer)
+
+atlas = FreeType::Atlas.build(
+  face,
+  glyph_ids: buffer.glyph_infos.map(&:glyph_id),
+  size: size,
+  mode: :sdf
+)
+run = FreeType::TextRun.layout(buffer, atlas)
+packed = run.to_packed
+
+packed[:vertices] # little-endian f32 (x, y, u, v), four vertices per quad
+packed[:indices]  # little-endian u16, six indices per quad
+```
+
+Quads use a baseline origin with y increasing downward. Missing atlas entries
+do not emit a quad, but their HarfBuzz advances still move the cursor. See
+[`examples/rugl_text.rb`](examples/rugl_text.rb) and
+[`examples/stagecraft_text.rb`](examples/stagecraft_text.rb) for GPU handoff.
+
+The Rugl example opens a real GLFW/OpenGL window. Its one-frame smoke mode
+renders the SDF text, reads back the physical framebuffer (including HiDPI
+framebuffers), and fails if no text pixels were produced:
+
+```sh
+FREETYPE_RUGL_SMOKE=1 bundle exec ruby \
+  examples/rugl_text.rb spec/fixtures/ABeeZee-Regular.ttf "GPU smoke"
+```
+
+The Stagecraft example remains an adapter contract because no public
+Stagecraft Ruby package/API is available. Its syntax and adapter boundary are
+tested; the example exits with an explicit message instead of claiming an
+unverified integration. It must be validated and adjusted when the real API is
+published.
+
+## Threading and lifetime
+
+A FreeType library must not be shared by concurrent threads. Use one
+`FreeType::Library` per thread, or use `FreeType::Pool`, which keeps a
+thread-local library and face cache:
+
+```ruby
+pool = FreeType::Pool.new
+face = pool.face("font.ttf") # cached only in the current thread
+# use pool independently from worker threads
+pool.close
+```
+
+Closing a library first closes every live face. Closing is idempotent. A
+glyph bitmap is copied immediately because the native slot is overwritten by
+the next glyph load. `Glyph#raw` intentionally exposes that transient native
+slot for callers that need native fields.
+
+## Development
+
+```sh
+bundle install
+bundle exec rake spec
+```
+
+The test suite includes an OFL font, bitmap goldens, pitch and fixed-point
+tests, SDF coverage, atlas geometry checks, and a compiled ABI probe that
+compares every field offset and total size of the public FreeType structs. CI
+tests Ruby 3.2, 3.3, 3.4, 4.0, and head; builds FreeType 2.11.1 and 2.14.3 from
+checksum-verified official sources; exercises real HarfBuzz and Texel gems;
+and runs the Rugl readback test with Mesa under Xvfb. Ruby head is an
+experimental compatibility signal and does not block stable releases.
+
+## License
+
+The gem is available under the MIT License. The bundled ABeeZee test font is
+distributed under the SIL Open Font License; see `spec/fixtures/OFL.txt`.

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/examples/rugl_text.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+# Usage: bundle exec ruby examples/rugl_text.rb FONT_PATH [TEXT]
+# Set FREETYPE_RUGL_SMOKE=1 to render one frame, verify it by framebuffer
+# readback, and exit. The default remains an interactive window.
+
+require "freetype/harfbuzz"
+require "rugl"
+
+font_path = ARGV[0] || abort("usage: #{$PROGRAM_NAME} FONT_PATH [TEXT]")
+text = ARGV[1] || "FreeType + HarfBuzz + Rugl"
+font_size = 64
+smoke = ENV["FREETYPE_RUGL_SMOKE"] == "1"
+
+blob = HarfBuzz::Blob.from_file!(font_path)
+hb_face = HarfBuzz::Face.new(blob, 0)
+hb_font = HarfBuzz::Font.new(hb_face)
+hb_font.scale = [font_size * 64, font_size * 64]
+hb_font.ppem = [font_size, font_size]
+buffer = HarfBuzz::Buffer.new
+buffer.add_utf8(text)
+buffer.guess_segment_properties
+HarfBuzz.shape(hb_font, buffer)
+
+FreeType.open do |library|
+  library.face(font_path) do |face|
+    ids = buffer.glyph_infos.map(&:glyph_id)
+    atlas = FreeType::Atlas.build(
+      face, glyph_ids: ids, size: font_size, mode: :sdf,
+      padding: 2, max_width: 1024
+    )
+    packed = FreeType::TextRun.layout(buffer, atlas).to_packed
+
+    atlas_data = FreeType::Image.data(atlas.image)
+    rgba = atlas_data.each_byte.each_with_object(String.new(capacity: atlas_data.bytesize * 4).b) do |alpha, bytes|
+      bytes << 255 << 255 << 255 << alpha
+    end
+    image_width = atlas.image.respond_to?(:width) ? atlas.image.width : atlas.image.fetch(:width)
+    image_height = atlas.image.respond_to?(:height) ? atlas.image.height : atlas.image.fetch(:height)
+
+    rugl = Rugl.create(width: 960, height: 320, title: "FreeType SDF text")
+    vertices = indices = texture = draw_text = nil
+    begin
+      vertices = rugl.buffer(data: packed.fetch(:vertices), type: :float)
+      indices = rugl.elements(data: packed.fetch(:indices).unpack("S<*"), type: :uint16)
+      texture = rugl.texture(
+        width: image_width, height: image_height, format: :rgba,
+        type: :uint8, data: rgba, min_filter: :linear, mag_filter: :linear
+      )
+
+      draw_text = rugl.command(
+        vert: <<~GLSL,
+          #version 410 core
+          layout(location = 0) in vec2 position;
+          layout(location = 1) in vec2 uv;
+          uniform vec2 viewport;
+          uniform vec2 origin;
+          out vec2 text_uv;
+          void main() {
+            vec2 pixel = position + origin;
+            vec2 clip = vec2(pixel.x / viewport.x * 2.0 - 1.0,
+                             1.0 - pixel.y / viewport.y * 2.0);
+            gl_Position = vec4(clip, 0.0, 1.0);
+            text_uv = uv;
+          }
+        GLSL
+        frag: <<~GLSL,
+          #version 410 core
+          in vec2 text_uv;
+          uniform sampler2D atlas_texture;
+          out vec4 frag_color;
+          void main() {
+            float distance_value = texture(atlas_texture, text_uv).a;
+            float alpha = smoothstep(0.45, 0.55, distance_value);
+            frag_color = vec4(0.92, 0.95, 1.0, alpha);
+          }
+        GLSL
+        attributes: {
+          position: { buffer: vertices, size: 2, stride: 16, offset: 0 },
+          uv: { buffer: vertices, size: 2, stride: 16, offset: 8 }
+        },
+        uniforms: {
+          viewport: [960.0, 320.0],
+          origin: [48.0, 150.0],
+          atlas_texture: texture
+        },
+        elements: indices,
+        viewport: {
+          width: Rugl.context(:framebuffer_width),
+          height: Rugl.context(:framebuffer_height)
+        },
+        blend: { enable: true, func: { src: :src_alpha, dst: :one_minus_src_alpha } }
+      )
+
+      rugl.frame(max_frames: smoke ? 1 : nil) do |context|
+        rugl.clear(color: [0.025, 0.035, 0.06, 1.0])
+        draw_text.call
+
+        next unless smoke
+
+        pixels = rugl.read(
+          width: context.fetch(:framebuffer_width),
+          height: context.fetch(:framebuffer_height)
+        )
+        maximum = [0, 0, 0, 0]
+        rendered = pixels.each_byte.each_slice(4).any? do |red, green, blue, alpha|
+          maximum[0] = [maximum[0], red].max
+          maximum[1] = [maximum[1], green].max
+          maximum[2] = [maximum[2], blue].max
+          maximum[3] = [maximum[3], alpha].max
+          red > 32 || green > 32 || blue > 32
+        end
+        unless rendered
+          abort("Rugl GPU smoke failed: no rendered pixels (maximum RGBA #{maximum.join(", ")})")
+        end
+
+        puts "Rugl GPU smoke passed (OpenGL #{rugl.limits.fetch(:version)})"
+      end
+    ensure
+      draw_text&.destroy
+      texture&.destroy
+      indices&.destroy
+      vertices&.destroy
+      rugl.destroy
+    end
+  end
+end

data/examples/stagecraft_text.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+# Usage: bundle exec ruby examples/stagecraft_text.rb FONT_PATH [TEXT]
+#
+# Stagecraft's GPU backend is intentionally isolated behind the four-method
+# adapter below. Map these calls to the backend version used by the host app;
+# the FreeType/HarfBuzz side remains unchanged.
+
+require "freetype/harfbuzz"
+
+begin
+  require "stagecraft"
+rescue LoadError
+  abort <<~MESSAGE
+    The Stagecraft Ruby package/API is not publicly available yet.
+    This example currently documents the StagecraftTextRenderer adapter contract;
+    validate and update it against the real API once that package is released.
+  MESSAGE
+end
+
+class StagecraftTextRenderer
+  def initialize(stage, atlas, packed)
+    width = atlas.image.respond_to?(:width) ? atlas.image.width : atlas.image.fetch(:width)
+    height = atlas.image.respond_to?(:height) ? atlas.image.height : atlas.image.fetch(:height)
+    @stage = stage
+    @texture = stage.texture_2d(
+      width: width, height: height, format: :r8_unorm,
+      data: FreeType::Image.data(atlas.image)
+    )
+    @mesh = stage.indexed_mesh(
+      vertices: packed.fetch(:vertices), indices: packed.fetch(:indices),
+      vertex_stride: 16,
+      attributes: { position: [:float32x2, 0], uv: [:float32x2, 8] },
+      index_format: :uint16
+    )
+    @material = stage.sdf_text_material(texture: @texture, edge: 0.5, softness: 0.1)
+  end
+
+  def draw
+    @stage.draw_indexed(mesh: @mesh, material: @material)
+  end
+end
+
+font_path = ARGV[0] || abort("usage: #{$PROGRAM_NAME} FONT_PATH [TEXT]")
+text = ARGV[1] || "FreeType + HarfBuzz + Stagecraft"
+font_size = 64
+
+blob = HarfBuzz::Blob.from_file!(font_path)
+hb_face = HarfBuzz::Face.new(blob, 0)
+hb_font = HarfBuzz::Font.new(hb_face)
+hb_font.scale = [font_size * 64, font_size * 64]
+hb_font.ppem = [font_size, font_size]
+buffer = HarfBuzz::Buffer.new
+buffer.add_utf8(text)
+buffer.guess_segment_properties
+HarfBuzz.shape(hb_font, buffer)
+
+FreeType.open do |library|
+  library.face(font_path) do |face|
+    atlas = FreeType::Atlas.build(
+      face, glyph_ids: buffer.glyph_infos.map(&:glyph_id),
+      size: font_size, mode: :sdf, padding: 2, max_width: 1024
+    )
+    packed = FreeType::TextRun.layout(buffer, atlas).to_packed
+
+    Stagecraft.run(title: "FreeType SDF text", width: 960, height: 320) do |stage|
+      renderer = StagecraftTextRenderer.new(stage, atlas, packed)
+      stage.frame { renderer.draw }
+    end
+  end
+end

data/lib/freetype/atlas.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+module FreeType
+  class Atlas
+    Entry = Data.define(
+      :u0, :v0, :u1, :v1, :bearing_x, :bearing_y, :width, :height, :advance
+    )
+    Placement = Data.define(:glyph, :x, :y)
+
+    attr_reader :image, :entries, :metrics, :missing
+
+    def self.build(face, chars: nil, glyph_ids: nil, size:, mode: :gray, padding: 2, max_width: 1024, spread: 8)
+      new(face, chars: chars, glyph_ids: glyph_ids, size: size, mode: mode,
+        padding: padding, max_width: max_width, spread: spread)
+    end
+
+    def initialize(face, chars:, glyph_ids:, size:, mode:, padding:, max_width:, spread:)
+      validate_options!(chars, glyph_ids, size, padding, max_width)
+      face.set_pixel_size(size)
+      glyphs, @missing = rasterize(face, chars, glyph_ids, mode, spread)
+      placements, width, height = pack(glyphs, padding, max_width)
+      pixels = compose(placements, width, height, padding)
+      @image = Image.build(width: width, height: height, data: pixels)
+      @entries = build_entries(placements, width, height, padding).freeze
+      @metrics = face.metrics
+      @missing = @missing.freeze
+      freeze
+    end
+
+    private
+
+    def validate_options!(chars, glyph_ids, size, padding, max_width)
+      if chars.nil? == glyph_ids.nil?
+        raise ArgumentError, "provide exactly one of chars or glyph_ids"
+      end
+      raise ArgumentError, "size must be a positive integer" unless size.is_a?(Integer) && size.positive?
+      raise ArgumentError, "padding must be a non-negative integer" unless padding.is_a?(Integer) && padding >= 0
+      unless max_width.is_a?(Integer) && max_width.positive?
+        raise ArgumentError, "max_width must be a positive integer"
+      end
+    end
+
+    def rasterize(face, chars, glyph_ids, mode, spread)
+      ids = if glyph_ids
+              glyph_ids.to_a.map { |id| Integer(id) }
+            else
+              characters(chars).map { |character| face.char_index(character) }
+            end
+
+      missing = []
+      glyphs = ids.uniq.filter_map do |id|
+        face.glyph_by_id(id, mode: mode, spread: spread)
+      rescue NativeError, RangeError
+        missing << id
+        nil
+      end
+      [glyphs, missing]
+    end
+
+    def characters(chars)
+      chars.is_a?(String) ? chars.each_char.to_a : chars.to_a
+    end
+
+    def pack(glyphs, padding, max_width)
+      shelf_width = 1 << (max_width.bit_length - 1)
+      x = 0
+      y = 0
+      shelf_height = 0
+      used_width = 0
+      placements = []
+
+      glyphs.sort_by { |glyph| [-glyph.height, -glyph.width, glyph.id] }.each do |glyph|
+        packed_width = glyph.width + (padding * 2)
+        packed_height = glyph.height + (padding * 2)
+        if packed_width > shelf_width
+          raise AtlasError, "glyph #{glyph.id} is wider than max_width #{max_width} after power-of-two rounding"
+        end
+
+        if x.positive? && x + packed_width > shelf_width
+          y += shelf_height
+          x = 0
+          shelf_height = 0
+        end
+
+        placements << Placement.new(glyph: glyph, x: x, y: y)
+        x += packed_width
+        shelf_height = [shelf_height, packed_height].max
+        used_width = [used_width, x].max
+      end
+
+      used_height = y + shelf_height
+      [placements.freeze, power_of_two([used_width, 1].max), power_of_two([used_height, 1].max)]
+    end
+
+    def compose(placements, width, height, padding)
+      pixels = "\0".b * (width * height)
+      placements.each do |placement|
+        glyph = placement.glyph
+        source = Image.data(glyph.bitmap)
+        glyph.height.times do |row|
+          destination_offset = ((placement.y + padding + row) * width) + placement.x + padding
+          pixels[destination_offset, glyph.width] = source.byteslice(row * glyph.width, glyph.width)
+        end
+      end
+      pixels.freeze
+    end
+
+    def build_entries(placements, width, height, padding)
+      placements.to_h do |placement|
+        glyph = placement.glyph
+        x = placement.x + padding
+        y = placement.y + padding
+        entry = Entry.new(
+          u0: x.fdiv(width), v0: y.fdiv(height),
+          u1: (x + glyph.width).fdiv(width), v1: (y + glyph.height).fdiv(height),
+          bearing_x: glyph.bearing_x, bearing_y: glyph.bearing_y,
+          width: glyph.width, height: glyph.height, advance: glyph.advance
+        )
+        [glyph.id, entry]
+      end
+    end
+
+    def power_of_two(value)
+      1 << (value - 1).bit_length
+    end
+  end
+end

data/lib/freetype/bitmap.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module FreeType
+  module BitmapConverter
+    module_function
+
+    def copy(bitmap)
+      width = bitmap[:width]
+      rows = bitmap[:rows]
+      return "".b.freeze if width.zero? || rows.zero?
+
+      buffer = bitmap[:buffer]
+      raise StateError, "FreeType returned a null bitmap buffer" if buffer.null?
+
+      case bitmap[:pixel_mode]
+      when Native::FT_PIXEL_MODE_GRAY
+        copy_gray(buffer, width, rows, bitmap[:pitch])
+      when Native::FT_PIXEL_MODE_MONO
+        copy_mono(buffer, width, rows, bitmap[:pitch])
+      else
+        raise UnsupportedError, "unsupported FreeType pixel mode #{bitmap[:pixel_mode]}"
+      end.freeze
+    end
+
+    def copy_gray(buffer, width, rows, pitch)
+      rows.times.each_with_object(String.new(capacity: width * rows, encoding: Encoding::BINARY)) do |row, data|
+        data << row_pointer(buffer, row, pitch).get_bytes(0, width)
+      end
+    end
+
+    def copy_mono(buffer, width, rows, pitch)
+      packed_width = (width + 7) / 8
+      rows.times.each_with_object(String.new(capacity: width * rows, encoding: Encoding::BINARY)) do |row, data|
+        packed = row_pointer(buffer, row, pitch).get_bytes(0, packed_width)
+        width.times do |column|
+          byte = packed.getbyte(column / 8)
+          data << ((byte & (0x80 >> (column % 8))).zero? ? 0 : 255)
+        end
+      end
+    end
+
+    def row_pointer(buffer, row, pitch)
+      FFI::Pointer.new(:uchar, buffer.address + (row * pitch))
+    end
+  end
+end

data/lib/freetype/charset.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module FreeType
+  module Charset
+    ASCII = (0x20..0x7E).map { |codepoint| [codepoint].pack("U") }.freeze
+    LATIN1 = (0x20..0xFF).map { |codepoint| [codepoint].pack("U") }.freeze
+    KANA = [*(0x3040..0x309F), *(0x30A0..0x30FF)].map { |codepoint| [codepoint].pack("U") }.freeze
+
+    joyo_path = File.expand_path("data/joyo_kanji.txt", __dir__)
+    JOYO_KANJI = File.read(joyo_path, encoding: Encoding::UTF_8)
+      .each_char.reject { |character| character.match?(/\s/) }.freeze
+  end
+end

data/lib/freetype/data/joyo_kanji.txt

@@ -0,0 +1 @@
+亜哀挨愛悪握圧扱安暗案以衣位囲医依委威為胃尉異移偉意違維慰遺域育一壱逸茨芋引印因姻員院淫陰飲隠韻右宇羽雨唄鬱畝浦運雲永泳英映栄営詠影鋭衛易疫益液駅悦越謁閲円延沿炎怨宴媛援園煙猿遠鉛塩演縁艶汚王凹央応往押旺欧殴桜翁奥横岡屋億憶臆虞乙俺卸音恩温穏下化火加可仮何花佳価果河苛科架夏家荷華菓貨渦過嫁暇禍靴寡歌箇稼課蚊牙瓦我画芽賀雅餓介回灰会快戒改怪拐悔海界皆械絵開階塊楷解潰壊懐諧貝外劾害崖涯慨蓋該概骸垣柿各角拡革格核殻郭覚較隔閣確獲嚇穫学岳楽額顎掛潟括活喝渇割葛滑褐轄且株釜鎌刈干刊甘汗缶完肝官冠巻看陥乾勘患貫寒喚堪換敢棺款間閑勧寛幹感漢慣管関歓監緩憾還館環簡観韓艦鑑丸含岸岩玩眼頑顔願企伎危机気岐希忌汽奇祈季紀軌既記起飢鬼帰基寄規亀喜幾揮期棋貴棄毀旗器畿輝機騎技宜偽欺義疑儀戯擬犠議菊吉喫詰却客脚逆虐九久及弓丘旧休吸朽臼求究泣急級糾宮救球給嗅窮牛去巨居拒拠挙虚許距魚御漁凶共叫狂京享供協況峡挟狭恐恭胸脅強教郷境橋矯鏡競響驚仰暁業凝曲局極玉巾斤均近金菌勤琴筋僅禁緊錦謹襟吟銀区句苦駆具惧愚空偶遇隅串屈掘窟熊繰君訓勲薫軍郡群兄刑形系径茎係型契計恵啓掲渓経蛍敬景軽傾携継詣慶憬稽憩警鶏芸迎鯨隙劇撃激桁欠穴血決結傑潔月犬件見券肩建研県倹兼剣拳軒健険圏堅検嫌献絹遣権憲賢謙鍵繭顕験懸元幻玄言弦限原現舷減源厳己戸古呼固股虎孤弧故枯個庫湖雇誇鼓錮顧五互午呉後娯悟碁語誤護口工公勾孔功巧広甲交光向后好江考行坑孝抗攻更効幸拘肯侯厚恒洪皇紅荒郊香候校耕航貢降高康控梗黄喉慌港硬絞項溝鉱構綱酵稿興衡鋼講購乞号合拷剛傲豪克告谷刻国黒穀酷獄骨駒込頃今困昆恨根婚混痕紺魂墾懇左佐沙査砂唆差詐鎖座挫才再災妻采砕宰栽彩採済祭斎細菜最裁債催塞歳載際埼在材剤財罪崎作削昨柵索策酢搾錯咲冊札刷刹拶殺察撮擦雑皿三山参桟蚕惨産傘散算酸賛残斬暫士子支止氏仕史司四市矢旨死糸至伺志私使刺始姉枝祉肢姿思指施師恣紙脂視紫詞歯嗣試詩資飼誌雌摯賜諮示字寺次耳自似児事侍治持時滋慈辞磁餌璽鹿式識軸七叱失室疾執湿嫉漆質実芝写社車舎者射捨赦斜煮遮謝邪蛇尺借酌釈爵若弱寂手主守朱取狩首殊珠酒腫種趣寿受呪授需儒樹収囚州舟秀周宗拾秋臭修袖終羞習週就衆集愁酬醜蹴襲十汁充住柔重従渋銃獣縦叔祝宿淑粛縮塾熟出述術俊春瞬旬巡盾准殉純循順準潤遵処初所書庶暑署緒諸女如助序叙徐除小升少召匠床抄肖尚招承昇松沼昭宵将消症祥称笑唱商渉章紹訟勝掌晶焼焦硝粧詔証象傷奨照詳彰障憧衝賞償礁鐘上丈冗条状乗城浄剰常情場畳蒸縄壌嬢錠譲醸色拭食植殖飾触嘱織職辱尻心申伸臣芯身辛侵信津神唇娠振浸真針深紳進森診寝慎新審震薪親人刃仁尽迅甚陣尋腎須図水吹垂炊帥粋衰推酔遂睡穂随髄枢崇数据杉裾寸瀬是井世正生成西声制姓征性青斉政星牲省凄逝清盛婿晴勢聖誠精製誓静請整醒税夕斥石赤昔析席脊隻惜戚責跡積績籍切折拙窃接設雪摂節説舌絶千川仙占先宣専泉浅洗染扇栓旋船戦煎羨腺詮践箋銭潜線遷選薦繊鮮全前善然禅漸膳繕狙阻祖租素措粗組疎訴塑遡礎双壮早争走奏相荘草送倉捜挿桑巣掃曹曽爽窓創喪痩葬装僧想層総遭槽踪操燥霜騒藻造像増憎蔵贈臓即束足促則息捉速側測俗族属賊続卒率存村孫尊損遜他多汰打妥唾堕惰駄太対体耐待怠胎退帯泰堆袋逮替貸隊滞態戴大代台第題滝宅択沢卓拓託濯諾濁但達脱奪棚誰丹旦担単炭胆探淡短嘆端綻誕鍛団男段断弾暖談壇地池知値恥致遅痴稚置緻竹畜逐蓄築秩窒茶着嫡中仲虫沖宙忠抽注昼柱衷酎鋳駐著貯丁弔庁兆町長挑帳張彫眺釣頂鳥朝超腸跳徴嘲潮澄調聴懲直勅捗沈珍朕陳賃鎮追椎墜通痛塚漬坪爪鶴低呈廷弟定底抵邸亭貞帝訂庭逓停偵堤提程艇締諦泥的笛摘滴適敵溺哲鉄徹撤天典店点展添転塡田伝殿電斗吐妬途都渡塗賭土奴努度怒刀冬灯当投豆東到逃倒凍唐島桃討透党悼盗陶塔搭棟湯痘登答等筒統稲踏糖頭謄藤闘騰同洞胴動堂童道働銅導瞳峠匿特得督徳篤毒独読栃凸突届屯豚頓貪鈍曇丼那奈内梨謎鍋南軟難二尼弐肉虹日入乳尿任妊忍認寧熱年念捻粘燃悩納能脳農濃把波派破覇馬婆罵拝杯背肺俳配排敗廃輩売倍梅培陪媒買賠白伯拍泊迫剝舶博薄麦漠縛爆箱箸畑肌八鉢発髪伐抜罰閥反半氾犯帆汎伴判坂阪板版班畔般販斑飯搬煩頒範繁藩晩番蛮盤比皮妃否批彼披肥非卑飛疲秘被悲扉費碑罷避尾眉美備微鼻膝肘匹必泌筆姫百氷表俵票評漂標苗秒病描猫品浜貧賓頻敏瓶不夫父付布扶府怖阜附訃負赴浮婦符富普腐敷膚賦譜侮武部舞封風伏服副幅復福腹複覆払沸仏物粉紛雰噴墳憤奮分文聞丙平兵併並柄陛閉塀幣弊蔽餅米壁璧癖別蔑片辺返変偏遍編弁便勉歩保哺捕補舗母募墓慕暮簿方包芳邦奉宝抱放法泡胞俸倣峰砲崩訪報蜂豊飽褒縫亡乏忙坊妨忘防房肪某冒剖紡望傍帽棒貿貌暴膨謀頰北木朴牧睦僕墨撲没勃堀本奔翻凡盆麻摩磨魔毎妹枚昧埋幕膜枕又末抹万満慢漫未味魅岬密蜜脈妙民眠矛務無夢霧娘名命明迷冥盟銘鳴滅免面綿麺茂模毛妄盲耗猛網目黙門紋問冶夜野弥厄役約訳薬躍闇由油喩愉諭輸癒唯友有勇幽悠郵湧猶裕遊雄誘憂融優与予余誉預幼用羊妖洋要容庸揚揺葉陽溶腰様瘍踊窯養擁謡曜抑沃浴欲翌翼拉裸羅来雷頼絡落酪辣乱卵覧濫藍欄吏利里理痢裏履璃離陸立律慄略柳流留竜粒隆硫侶旅虜了両良料涼猟陵量僚領寮療瞭糧力緑林厘倫輪隣臨瑠涙累塁類令礼冷励戻例鈴零霊隷齢麗暦歴列劣烈裂恋連廉練錬呂炉賂路露老労弄郎朗浪廊楼漏籠六録麓論和話賄脇惑枠湾腕匂咽宛嵐彙徒慮曖椅畏緯萎街貼迭

data/lib/freetype/errors.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module FreeType
+  class Error < StandardError; end
+  class ClosedError < Error; end
+  class StateError < Error; end
+  class UnsupportedError < Error; end
+  class AtlasError < Error; end
+
+  class NativeError < Error
+    attr_reader :code, :name
+
+    def initialize(code, operation: nil)
+      @code = Integer(code)
+      @name = Native::ERROR_NAMES.fetch(@code, :Unknown_Error)
+      prefix = operation ? "#{operation} failed: " : ""
+      super(format("%sFreeType error 0x%02X (%s)", prefix, @code, @name))
+    end
+  end
+end