skia 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e71b72f2e4a4beeadc80cc96833789db9ee8916ae38287d8b8a2ef2af6569122
+  data.tar.gz: a786a9b50ae23c14bafb49354a639244c3efa201c737e86b782b29fb2f1ce889
+SHA512:
+  metadata.gz: 3f7d931e61b8f9967f25e14f2fc1cd7782b6869ac2a68f5f84f065fad3eeb8276abc2ff2813c81e6ed23c2ea376da65e2ca9fff7a974f7c0a0aa3c5a6abf4e2d
+  data.tar.gz: 8ae82f68f257171a00ca82302e26b9114cf865c13e17fbdec6a2ea920173cd503c42ae426e15872a475b909ad6d67be05cb282f08d14e9c2d2ac979f7d6af5ad

data/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## Unreleased
+
+## 0.1.0 - 2025-12-31
+
+- Initial release

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 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,345 @@
+# Skia Ruby
+
+Ruby bindings for the Skia 2D graphics library.
+
+<img width="400" alt="Image" src="https://github.com/user-attachments/assets/440971a6-bf10-4cc2-abe6-e5cf28949b95" />
+
+## Overview
+
+This gem provides Ruby bindings for Skia, Google's high-performance 2D graphics library. It uses FFI (Foreign Function Interface) to interface with SkiaSharp's C API, enabling hardware-accelerated graphics rendering from Ruby.
+
+## Requirements
+
+- Ruby 3.0 or later
+- SkiaSharp native library (libSkiaSharp)
+
+### Installing SkiaSharp
+
+**macOS:**
+```bash
+# Download from SkiaSharp releases
+curl -L -o skiasharp.nupkg https://www.nuget.org/api/v2/package/SkiaSharp.NativeAssets.macOS
+unzip skiasharp.nupkg -d skiasharp-extract
+cp skiasharp-extract/runtimes/osx/native/libSkiaSharp.dylib .
+```
+
+**Linux:**
+```bash
+curl -L -o skiasharp.nupkg https://www.nuget.org/api/v2/package/SkiaSharp.NativeAssets.Linux.x64
+unzip skiasharp.nupkg -d skiasharp-extract
+cp skiasharp-extract/runtimes/linux-x64/native/libSkiaSharp.so .
+```
+
+**Windows:**
+```powershell
+Invoke-WebRequest -Uri https://www.nuget.org/api/v2/package/SkiaSharp.NativeAssets.Win32 -OutFile skiasharp.nupkg
+Expand-Archive skiasharp.nupkg -DestinationPath skiasharp-extract
+copy skiasharp-extract\runtimes\win-x64\native\libSkiaSharp.dll .
+```
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'skia'
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+Or install it yourself as:
+
+```bash
+gem install skia
+```
+
+## Usage
+
+### Basic Example
+
+```ruby
+require 'skia'
+
+surface = Skia::Surface.make_raster(640, 480)
+
+surface.draw do |canvas|
+  canvas.clear(Skia::Color::WHITE)
+
+  paint = Skia::Paint.new
+  paint.antialias = true
+  paint.color = Skia::Color::RED
+
+  canvas.draw_circle(320, 240, 100, paint)
+end
+
+surface.save_png('output.png')
+```
+
+### Drawing Shapes
+
+```ruby
+surface = Skia::Surface.make_raster(400, 400)
+
+surface.draw do |canvas|
+  canvas.clear(Skia::Color::WHITE)
+
+  paint = Skia::Paint.new
+  paint.antialias = true
+
+  # Rectangle
+  paint.color = Skia::Color::BLUE
+  canvas.draw_rect(Skia::Rect.from_xywh(50, 50, 100, 80), paint)
+
+  # Circle
+  paint.color = Skia::Color::RED
+  canvas.draw_circle(250, 100, 50, paint)
+
+  # Oval
+  paint.color = Skia::Color::GREEN
+  canvas.draw_oval(Skia::Rect.from_xywh(150, 200, 150, 80), paint)
+
+  # Rounded rectangle
+  paint.color = Skia::Color::MAGENTA
+  canvas.draw_round_rect(Skia::Rect.from_xywh(50, 300, 120, 60), 15, paint)
+
+  # Line
+  paint.style = :stroke
+  paint.stroke_width = 3
+  paint.color = Skia::Color::BLACK
+  canvas.draw_line(300, 200, 380, 350, paint)
+end
+
+surface.save_png('shapes.png')
+```
+
+### Using Paths
+
+```ruby
+path = Skia::Path.build do
+  move_to 100, 100
+  line_to 200, 100
+  line_to 200, 200
+  quad_to 150, 250, 100, 200
+  close
+end
+
+surface.draw do |canvas|
+  paint = Skia::Paint.new
+  paint.color = Skia::Color.rgb(255, 128, 0)
+  canvas.draw_path(path, paint)
+end
+```
+
+### Gradients
+
+```ruby
+surface.draw do |canvas|
+  # Linear gradient
+  shader = Skia::Shader.linear_gradient(
+    Skia::Point.new(0, 0),
+    Skia::Point.new(400, 0),
+    [Skia::Color::RED, Skia::Color::YELLOW, Skia::Color::BLUE]
+  )
+
+  paint = Skia::Paint.new
+  paint.shader = shader
+  canvas.draw_rect(Skia::Rect.from_xywh(0, 0, 400, 200), paint)
+
+  # Radial gradient
+  radial = Skia::Shader.radial_gradient(
+    Skia::Point.new(200, 300),
+    80,
+    [Skia::Color::WHITE, Skia::Color::BLUE]
+  )
+
+  paint.shader = radial
+  canvas.draw_circle(200, 300, 80, paint)
+end
+```
+
+### Text Drawing
+
+```ruby
+surface.draw do |canvas|
+  canvas.clear(Skia::Color::WHITE)
+
+  font = Skia::Font.new(nil, 48.0)
+  paint = Skia::Paint.new
+  paint.antialias = true
+  paint.color = Skia::Color::BLACK
+
+  canvas.draw_text('Hello, Skia!', 50, 100, font, paint)
+
+  # Measure text
+  width, bounds = font.measure_text('Hello, Skia!')
+  puts "Text width: #{width}"
+end
+```
+
+### Canvas Transformations
+
+```ruby
+surface.draw do |canvas|
+  canvas.clear(Skia::Color::WHITE)
+
+  paint = Skia::Paint.new
+  paint.color = Skia::Color::BLUE
+
+  # Save state, transform, draw, restore
+  canvas.with_save do
+    canvas.translate(200, 200)
+    canvas.rotate(45)
+    canvas.draw_rect(Skia::Rect.from_xywh(-50, -50, 100, 100), paint)
+  end
+
+  # Scale
+  canvas.with_save do
+    canvas.translate(100, 100)
+    canvas.scale(2.0, 0.5)
+    paint.color = Skia::Color::RED
+    canvas.draw_circle(0, 0, 30, paint)
+  end
+end
+```
+
+### PDF Output
+
+```ruby
+Skia::Document.create_pdf('output.pdf') do |doc|
+  doc.begin_page(612, 792) do |canvas|
+    canvas.clear(Skia::Color::WHITE)
+
+    font = Skia::Font.new(nil, 24.0)
+    paint = Skia::Paint.new
+    paint.color = Skia::Color::BLACK
+
+    canvas.draw_text('Hello, PDF!', 50, 100, font, paint)
+  end
+
+  doc.begin_page(612, 792) do |canvas|
+    canvas.clear(Skia::Color::WHITE)
+    # Second page content
+  end
+end
+```
+
+### Picture Recording
+
+```ruby
+bounds = Skia::Rect.from_xywh(0, 0, 200, 200)
+
+picture = Skia::Picture.record(bounds) do |canvas|
+  paint = Skia::Paint.new
+  paint.color = Skia::Color::RED
+  canvas.draw_circle(100, 100, 80, paint)
+end
+
+# Replay on different surfaces
+surface.draw do |canvas|
+  canvas.translate(50, 50)
+  picture.playback(canvas)
+
+  canvas.translate(250, 0)
+  canvas.scale(0.5, 0.5)
+  picture.playback(canvas)
+end
+
+# Serialize/deserialize
+data = picture.serialize
+loaded = Skia::Picture.from_data(data)
+```
+
+### Image Loading and Saving
+
+```ruby
+# Load image
+image = Skia::Image.from_file('input.png')
+puts "Image size: #{image.width}x#{image.height}"
+
+# Draw image
+surface.draw do |canvas|
+  canvas.draw_image(image, 0, 0)
+end
+
+# Save in different formats
+surface.save_png('output.png')
+surface.save_jpeg('output.jpg', quality: 90)
+surface.save_webp('output.webp', quality: 80)
+```
+
+## API Reference
+
+### Main Classes
+
+- `Skia::Surface` - Drawing surface (raster or GPU-backed)
+- `Skia::Canvas` - Drawing context with transformation and clipping
+- `Skia::Paint` - Style and color settings for drawing
+- `Skia::Path` - Vector path for complex shapes
+- `Skia::Image` - Immutable bitmap image
+- `Skia::Shader` - Gradient and pattern fills
+- `Skia::Font` - Font for text rendering
+- `Skia::Typeface` - Font family and style
+- `Skia::Document` - Multi-page document (PDF)
+- `Skia::Picture` - Recorded drawing commands
+
+### Geometry Classes
+
+- `Skia::Point` - 2D point (x, y)
+- `Skia::Rect` - Rectangle (left, top, right, bottom)
+- `Skia::Matrix` - 3x3 transformation matrix
+- `Skia::Color` - ARGB color value
+
+### Constants
+
+Paint styles:
+- `:fill` - Fill shapes
+- `:stroke` - Outline shapes
+- `:stroke_and_fill` - Both fill and outline
+
+Stroke caps:
+- `:butt` - Flat cap
+- `:round` - Round cap
+- `:square` - Square cap
+
+Stroke joins:
+- `:miter` - Sharp corners
+- `:round` - Rounded corners
+- `:bevel` - Beveled corners
+
+Blend modes:
+- `:src_over`, `:multiply`, `:screen`, `:overlay`, etc.
+
+## Development
+
+After checking out the repo, run:
+
+```bash
+bundle install
+bundle exec rspec
+```
+
+To run examples:
+
+```bash
+ruby examples/basic_drawing.rb
+ruby examples/gradient.rb
+ruby examples/bar_chart.rb
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub.
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).
+
+## Acknowledgments
+
+- [Skia Graphics Library](https://skia.org/)
+- [SkiaSharp](https://github.com/mono/SkiaSharp)
+- [Ruby FFI](https://github.com/ffi/ffi)

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/avatar_generator.rb

@@ -0,0 +1,74 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../lib/skia'
+
+def generate_avatar(name, size: 200, output: nil)
+  initials = name.split.map { |n| n[0].upcase }.join[0, 2]
+
+  hash = name.chars.map(&:ord).sum
+  hue = hash % 360
+
+  c = 0.6
+  x = c * (1 - ((hue / 60.0) % 2 - 1).abs)
+  m = 0.2
+
+  r, g, b = case hue / 60
+            when 0 then [c, x, 0]
+            when 1 then [x, c, 0]
+            when 2 then [0, c, x]
+            when 3 then [0, x, c]
+            when 4 then [x, 0, c]
+            else [c, 0, x]
+            end
+
+  bg_color = Skia::Color.rgb(
+    ((r + m) * 255).to_i,
+    ((g + m) * 255).to_i,
+    ((b + m) * 255).to_i
+  )
+
+  surface = Skia::Surface.make_raster(size, size)
+
+  surface.draw do |canvas|
+    canvas.clear(Skia::Color::TRANSPARENT)
+
+    paint = Skia::Paint.new
+    paint.antialias = true
+
+    paint.color = bg_color
+    paint.style = :fill
+    canvas.draw_circle(size / 2.0, size / 2.0, size / 2.0, paint)
+
+    font_size = size * 0.4
+    font = Skia::Font.new(nil, font_size)
+    paint.color = Skia::Color::WHITE
+
+    text_width, text_bounds = font.measure_text(initials)
+    metrics = font.metrics
+    x = (size - text_width) / 2.0
+    y = (size / 2.0) - (metrics.ascent + metrics.descent) / 2.0
+
+    canvas.draw_text(initials, x, y, font, paint)
+  end
+
+  output_file = output || "avatar_#{name.downcase.gsub(/\s+/, '_')}.png"
+  surface.save_png(output_file)
+  puts "Generated: #{output_file}"
+  output_file
+end
+
+names = [
+  'John Doe',
+  'Alice Smith',
+  'Bob Johnson',
+  'Emma Wilson',
+  'Michael Brown'
+]
+
+puts 'Generating avatars...'
+names.each { |name| generate_avatar(name, size: 128) }
+
+generate_avatar('Ruby Developer', size: 256, output: 'avatar_large.png')
+
+puts "\nAll avatars generated!"

data/examples/bar_chart.rb

@@ -0,0 +1,89 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../lib/skia'
+
+data = {
+  'Maguro' => 92,
+  'Salmon' => 88,
+  'Ebi' => 75,
+  'Tamago' => 68,
+  'Ika' => 45
+}
+
+WIDTH = 600
+HEIGHT = 400
+MARGIN = { top: 40, right: 30, bottom: 60, left: 80 }.freeze
+CHART_WIDTH = WIDTH - MARGIN[:left] - MARGIN[:right]
+CHART_HEIGHT = HEIGHT - MARGIN[:top] - MARGIN[:bottom]
+
+surface = Skia::Surface.make_raster(WIDTH, HEIGHT)
+
+surface.draw do |canvas|
+  canvas.clear(Skia::Color::WHITE)
+
+  paint = Skia::Paint.new
+  paint.antialias = true
+
+  font_title = Skia::Font.new(nil, 20.0)
+  paint.color = Skia::Color::BLACK
+  canvas.draw_text('Sushi Popularity Ranking', 180, 28, font_title, paint)
+
+  font_axis = Skia::Font.new(nil, 12.0)
+  paint.style = :stroke
+  paint.stroke_width = 1
+  paint.color = Skia::Color.rgb(200, 200, 200)
+
+  max_value = 100
+  5.times do |i|
+    value = i * 25
+    y = MARGIN[:top] + CHART_HEIGHT - (value.to_f / max_value * CHART_HEIGHT)
+
+    canvas.draw_line(MARGIN[:left], y, WIDTH - MARGIN[:right], y, paint)
+
+    paint.style = :fill
+    paint.color = Skia::Color::BLACK
+    canvas.draw_text(value.to_s, MARGIN[:left] - 35, y + 4, font_axis, paint)
+    paint.style = :stroke
+    paint.color = Skia::Color.rgb(200, 200, 200)
+  end
+
+  bar_width = CHART_WIDTH / data.size * 0.7
+  bar_spacing = CHART_WIDTH / data.size
+
+  colors = [
+    Skia::Color.rgb(220, 53, 69),
+    Skia::Color.rgb(255, 127, 80),
+    Skia::Color.rgb(255, 182, 193),
+    Skia::Color.rgb(255, 215, 0),
+    Skia::Color.rgb(230, 230, 250)
+  ]
+
+  data.each_with_index do |(name, value), i|
+    x = MARGIN[:left] + (i * bar_spacing) + (bar_spacing - bar_width) / 2
+    bar_height = (value.to_f / max_value) * CHART_HEIGHT
+    y = MARGIN[:top] + CHART_HEIGHT - bar_height
+
+    paint.style = :fill
+    paint.color = colors[i]
+    canvas.draw_rect(Skia::Rect.from_xywh(x, y, bar_width, bar_height), paint)
+
+    paint.style = :stroke
+    paint.stroke_width = 1
+    paint.color = Skia::Color.rgb(100, 100, 100)
+    canvas.draw_rect(Skia::Rect.from_xywh(x, y, bar_width, bar_height), paint)
+
+    paint.style = :fill
+    paint.color = Skia::Color::BLACK
+    text_width, = font_axis.measure_text(name)
+    label_x = x + (bar_width - text_width) / 2
+    canvas.draw_text(name, label_x, HEIGHT - MARGIN[:bottom] + 20, font_axis, paint)
+
+    value_text = "#{value}%"
+    value_width, = font_axis.measure_text(value_text)
+    canvas.draw_text(value_text, x + (bar_width - value_width) / 2, y - 8, font_axis, paint)
+  end
+end
+
+surface.save_png('bar_chart.png')
+puts 'Saved to bar_chart.png'

data/examples/basic_drawing.rb

@@ -0,0 +1,43 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../lib/skia'
+
+surface = Skia::Surface.make_raster(640, 480)
+
+surface.draw do |canvas|
+  canvas.clear(Skia::Color::WHITE)
+
+  paint = Skia::Paint.new
+  paint.antialias = true
+
+  paint.color = Skia::Color::RED
+  paint.style = :fill
+  canvas.draw_rect(Skia::Rect.from_xywh(50, 50, 150, 100), paint)
+
+  paint.color = Skia::Color::BLUE
+  canvas.draw_circle(400, 200, 80, paint)
+
+  paint.color = Skia::Color::GREEN
+  paint.style = :stroke
+  paint.stroke_width = 3
+  canvas.draw_oval(Skia::Rect.from_xywh(200, 300, 200, 100), paint)
+
+  path = Skia::Path.build do
+    move_to 100, 300
+    line_to 200, 400
+    line_to 50, 400
+    close
+  end
+  paint.color = Skia::Color.rgb(255, 165, 0)
+  paint.style = :fill
+  canvas.draw_path(path, paint)
+
+  paint.color = Skia::Color::MAGENTA
+  paint.style = :stroke
+  paint.stroke_width = 2
+  canvas.draw_line(500, 50, 600, 150, paint)
+end
+
+surface.save_png('output.png')
+puts 'Saved to output.png'

data/examples/gradient.rb

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../lib/skia'
+
+surface = Skia::Surface.make_raster(400, 400)
+
+surface.draw do |canvas|
+  canvas.clear(Skia::Color::WHITE)
+
+  colors = [Skia::Color::RED, Skia::Color::YELLOW, Skia::Color::BLUE]
+  shader = Skia::Shader.linear_gradient(
+    Skia::Point.new(0, 0),
+    Skia::Point.new(400, 0),
+    colors
+  )
+
+  paint = Skia::Paint.new
+  paint.shader = shader
+  canvas.draw_rect(Skia::Rect.from_wh(400, 200), paint)
+
+  radial_shader = Skia::Shader.radial_gradient(
+    Skia::Point.new(200, 300),
+    100,
+    [Skia::Color::WHITE, Skia::Color::BLUE]
+  )
+  paint.shader = radial_shader
+  canvas.draw_circle(200, 300, 100, paint)
+end
+
+surface.save_png('gradient.png')
+puts 'Saved to gradient.png'

data/examples/pdf_output.rb

@@ -0,0 +1,48 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../lib/skia'
+
+Skia::Document.create_pdf('output.pdf') do |doc|
+  doc.begin_page(612, 792) do |canvas|
+    canvas.clear(Skia::Color::WHITE)
+
+    font = Skia::Font.new(nil, 36.0)
+    paint = Skia::Paint.new
+    paint.antialias = true
+    paint.color = Skia::Color::BLACK
+
+    canvas.draw_text('Hello, PDF!', 50, 100, font, paint)
+
+    paint.color = Skia::Color::RED
+    paint.style = :fill
+    canvas.draw_rect(Skia::Rect.from_xywh(50, 150, 200, 100), paint)
+
+    paint.color = Skia::Color::BLUE
+    canvas.draw_circle(400, 300, 80, paint)
+  end
+
+  doc.begin_page(612, 792) do |canvas|
+    canvas.clear(Skia::Color::WHITE)
+
+    font = Skia::Font.new(nil, 24.0)
+    paint = Skia::Paint.new
+    paint.antialias = true
+    paint.color = Skia::Color::BLACK
+
+    canvas.draw_text('Page 2', 50, 100, font, paint)
+
+    path = Skia::Path.build do
+      move_to 100, 200
+      line_to 200, 400
+      line_to 50, 400
+      close
+    end
+
+    paint.color = Skia::Color::GREEN
+    paint.style = :fill
+    canvas.draw_path(path, paint)
+  end
+end
+
+puts 'Saved to output.pdf'