text2image 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bb0d3931cb713209d4e80ca9523e0ef0ce77d48196c0e90cd93c04625b4f6fbd
+  data.tar.gz: e5ddf3e583a8311733e10c218d3e1e421d44d254c4b9a7c3b331120d36b973c1
+SHA512:
+  metadata.gz: 86ccbdd21981642e01bee9983358dbb2684b89ae454021009f71a24ede88b4b2a8f9075380018cc5315c82b136f25d54b1fa1317c8da1029be6afb1cdf07a50a
+  data.tar.gz: 32eea1ac4e7840d28bd293f6694eec07ed0c40817561ea60484f3b4843038d19b47f02aed079dc5223e0f4071d478a67758dd68464fbe16ac45198c0d504c6c0

data/.gitignore

@@ -0,0 +1,29 @@
+*.gem
+*.rbc
+capybara-*.html
+.rspec
+/log
+/tmp
+/db/*.sqlite3
+/db/*.sqlite3-journal
+/public/system
+/coverage/
+/spec/tmp
+**.orig
+rerun.txt
+pickle-email-*.html
+
+# TODO: If you are using rspec, code coverage, or any other tool, add their 
+# files/directories here.
+
+# Configuration
+.env
+
+# Dependencies
+/vendor/bundle
+/bundle/
+/bin/
+.bundle/
+
+# Gemfile.lock
+Gemfile.lock

data/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.0.0] - 2026-01-15
+
+### Added
+- **Initial Release**: Core text-to-image conversion features.
+- **Smart Padding Control**: Added `padding` option to automatically add space around text by calculating the bounding box.
+- **Auto Font Detection**: Automatically finds the best available system font using `fontconfig`.
+- **Bilingual Documentation**: Support for both English and Korean (`_ko.md`) documentation.
+- **Verification Tools**: Included `verify_work.rb` for functionality testing and result verification.

data/CHANGELOG_ko.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.0.0] - 2026-01-15
+
+### Added
+- **Initial Release**: Core text-to-image conversion features.
+- **Smart Padding Control**: Added `padding` option to automatically add space around text by calculating the bounding box.
+- **Auto Font Detection**: Automatically finds the best available system font using `fontconfig`.
+- **Bilingual Documentation**: Support for both English and Korean (`_ko.md`) documentation.
+- **Verification Tools**: Included `verify_work.rb` for functionality testing and result verification.

data/CONTRIBUTING.md

@@ -0,0 +1,47 @@
+# Contributing to text2image
+
+먼저 `text2image`에 관심을 가져주셔서 감사합니다! 이 프로젝트에 참여하고 싶으시다면 다음 가이드를 따라주세요.
+
+Thank you for your interest in contributing to `text2image`! To contribute, please follow these guidelines.
+
+## How to Contribute
+
+1.  **Fork the repository** on GitHub.
+2.  **Clone your fork** to your local machine.
+3.  **Create a new branch** for your feature or bug fix:
+    ```bash
+    git checkout -b feature/cool-new-feature
+    ```
+4.  **Make your changes** and ensure they follow the code style.
+5.  **Write and run tests** (if applicable).
+6.  **Commit your changes** with a descriptive message:
+    ```bash
+    git commit -m "Add a cool new feature"
+    ```
+7.  **Push to your fork**:
+    ```bash
+    git push origin feature/cool-new-feature
+    ```
+8.  **Submit a Pull Request** to the `main` branch of the original repository.
+
+## Development Setup
+
+To share your development environment:
+
+```bash
+git clone https://github.com/rheehose/text2image.git
+cd text2image
+bin/setup
+```
+
+## Code of Conduct
+
+Everyone interacting in the text2image project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct].
+
+## Author
+
+- **Rheehose (Rhee Creative)** - *Initial work* - [rheehose](https://github.com/rheehose)
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

data/CONTRIBUTING_ko.md

@@ -0,0 +1,47 @@
+# Contributing to text2image
+
+먼저 `text2image`에 관심을 가져주셔서 감사합니다! 이 프로젝트에 참여하고 싶으시다면 다음 가이드를 따라주세요.
+
+Thank you for your interest in contributing to `text2image`! To contribute, please follow these guidelines.
+
+## How to Contribute
+
+1.  **Fork the repository** on GitHub.
+2.  **Clone your fork** to your local machine.
+3.  **Create a new branch** for your feature or bug fix:
+    ```bash
+    git checkout -b feature/cool-new-feature
+    ```
+4.  **Make your changes** and ensure they follow the code style.
+5.  **Write and run tests** (if applicable).
+6.  **Commit your changes** with a descriptive message:
+    ```bash
+    git commit -m "Add a cool new feature"
+    ```
+7.  **Push to your fork**:
+    ```bash
+    git push origin feature/cool-new-feature
+    ```
+8.  **Submit a Pull Request** to the `main` branch of the original repository.
+
+## Development Setup
+
+To share your development environment:
+
+```bash
+git clone https://github.com/rheehose/text2image.git
+cd text2image
+bin/setup
+```
+
+## Code of Conduct
+
+Everyone interacting in the text2image project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct].
+
+## Author
+
+- **Rheehose (Rhee Creative)** - *Initial work* - [rheehose](https://github.com/rheehose)
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

data/Gemfile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in rupack_text2image.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2008-2026 Rheehose (Rhee Creative)
+
+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/LICENSE_ko.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2008-2026 Rheehose (Rhee Creative)
+
+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,64 @@
+# text2image
+
+`text2image` is a Ruby library that transforms text into black-on-white images. It automatically detects system fonts and generates optimized images with configurable padding around the text.
+
+## Features
+
+- **Text to Image**: Convert any text string into a PNG/JPG image.
+- **Auto Font Detection**: Automatically finds the best available system font using `fontconfig`.
+- **Smart Padding**: Calculates the bounding box of the text and adds uniform padding on all four sides.
+- **Customizable**: Options for font size, background/foreground colors, and padding width.
+
+## Requirements
+
+This library requires **ImageMagick** and **fontconfig** to be installed on your system.
+
+### Linux (Ubuntu/Debian)
+```bash
+sudo apt update
+sudo apt install imagemagick fontconfig
+```
+
+### macOS
+```bash
+brew install imagemagick fontconfig
+```
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'text2image'
+```
+
+And then execute:
+
+```bash
+$ bundle install
+```
+
+## Usage
+
+### Basic Usage
+
+```ruby
+require 'text2image'
+
+# Save text to an image file (default 10px padding)
+Text2image.convert("Hello, World!", output: "hello.png")
+
+# With custom options including padding
+Text2image.convert("Ruby is Awesome", 
+  output: "ruby.png",
+  font_size: 48,
+  padding: 30,
+  background: "white",
+  foreground: "black"
+)
+```
+
+## License
+
+Copyright (c) 2008-2026 Rheehose (Rhee Creative).
+Released under the [MIT License](LICENSE).

data/README_ko.md

@@ -0,0 +1,66 @@
+# text2image
+
+`text2image`는 텍스트를 하얀 바탕에 검은색 글꼴로 자동화하여 이미지로 변환해주는 루비(Ruby) 라이브러리입니다. 시스템에 설치된 폰트를 자동으로 탐지하고, 텍스트 크기에 맞춰 여백(Padding)이 포함된 최적의 이미지를 생성합니다.
+
+`text2image` is a Ruby library that transforms text into black-on-white images with automatic system font detection and smart padding adjustment.
+
+## 주요 기능 (Features)
+
+- **텍스트-이미지 변환**: 어떤 문자열이든 PNG/JPG 이미지로 변환합니다.
+- **자동 폰트 탐지**: `fontconfig`를 사용하여 시스템의 최적 폰트를 자동으로 찾습니다.
+- **스마트 여백 (Smart Padding)**: 텍스트의 실제 크기를 계산하여 4방면에 균일한 여백을 자동으로 추가합니다.
+- **유연한 설정**: 폰트 크기, 배경색, 글자색, 여백 크기 등을 자유롭게 조절할 수 있습니다.
+
+## 설치 요구사항 (Requirements)
+
+이 라이브러리는 **ImageMagick**과 **fontconfig**가 시스템에 설치되어 있어야 합니다.
+
+### Linux (Ubuntu/Debian)
+```bash
+sudo apt update
+sudo apt install imagemagick fontconfig
+```
+
+### macOS
+```bash
+brew install imagemagick fontconfig
+```
+
+## 설치 (Installation)
+
+`Gemfile`에 다음 줄을 추가하세요:
+
+```ruby
+gem 'text2image'
+```
+
+그 후 아래 명령어를 실행합니다:
+
+```bash
+$ bundle install
+```
+
+## 사용법 (Usage)
+
+### 기본 사용 (Basic Usage)
+
+```ruby
+require 'text2image'
+
+# 텍스트를 이미지 파일로 저장 (기본 여백 10px 적용)
+Text2image.convert("안녕하세요!", output: "hello.png")
+
+# 옵션 설정 (여백 포함)
+Text2image.convert("Ruby", 
+  output: "ruby.png",
+  font_size: 50,
+  padding: 20,
+  background: "white",
+  foreground: "black"
+)
+```
+
+## 저작권 및 라이선스 (License)
+
+Copyright (c) 2008-2026 Rheehose (Rhee Creative).
+이 라이브러리는 [MIT License](LICENSE) 하에 배포됩니다.

data/lib/text2image/converter.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require 'mini_magick'
+
+module Text2image
+  class Converter
+    attr_accessor :text, :font, :font_size, :background, :foreground, :padding
+
+    def initialize(text, options = {})
+      @text = text
+      @font = options[:font] || FontFinder.find_font
+      @font_size = options[:font_size] || 24
+      @background = options[:background] || "white"
+      @foreground = options[:foreground] || "black"
+      @padding = options[:padding] || 10
+    end
+
+    def render(output_path = nil)
+      require 'tempfile'
+      
+      # Step 1: Get text dimensions without padding
+      # We use 'pango' or 'caption' if available for better text handling
+      # But for simplicity and portability, we use 'label' or 'caption' with trim
+      
+      temp_raw = Tempfile.new(['text2image_raw', '.png'])
+      raw_path = temp_raw.path
+      temp_raw.close
+
+      # Render text on a large enough canvas then trim to find bounding box
+      MiniMagick::Tool::Convert.new do |c|
+        c.background @background
+        c.fill @foreground
+        c.font @font if @font
+        c.pointsize @font_size
+        c << "label:#{@text}"
+        c.trim
+        c << raw_path
+      end
+
+      # Step 2: Get dimensions of the trimmed text
+      trimmed_image = MiniMagick::Image.open(raw_path)
+      width = trimmed_image.width
+      height = trimmed_image.height
+
+      # Step 3: Create final image with padding
+      final_width = width + (@padding * 2)
+      final_height = height + (@padding * 2)
+
+      temp_final = Tempfile.new(['text2image_final', '.png'])
+      final_path = temp_final.path
+      temp_final.close
+
+      MiniMagick::Tool::Convert.new do |c|
+        c.size "#{final_width}x#{final_height}"
+        c.canvas @background
+        c.fill @foreground
+        c.font @font if @font
+        c.pointsize @font_size
+        c.gravity "Center"
+        c.draw "text 0,0 '#{@text.gsub("'", "\\\\'")}'"
+        c << final_path
+      end
+
+      image = MiniMagick::Image.open(final_path)
+
+      if output_path
+        image.write(output_path)
+        output_path
+      else
+        image
+      end
+    rescue StandardError => e
+      raise "Failed to render image: #{e.message}. Ensure ImageMagick is installed and accessible."
+    end
+
+    def to_blob(format = "png")
+      render.format(format).to_blob
+    end
+  end
+end

data/lib/text2image/font_finder.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'open3'
+
+module Text2image
+  class FontFinder
+    class << self
+      def find_font(name = nil)
+        return name if name && File.exist?(name)
+
+        search_query = name || "sans-serif"
+        
+        cmd = "fc-list \"#{search_query}\" :file"
+        stdout, stderr, status = Open3.capture3(cmd)
+        
+        if status.success? && !stdout.empty?
+          path = stdout.split("\n").first.split(":").first.strip
+          return path if File.exist?(path)
+        end
+
+        fallback_fonts = [
+          "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf",
+          "/usr/share/fonts/truetype/liberation/LiberationSans-Regular.ttf",
+          "/usr/share/fonts/TTF/DejaVuSans.ttf",
+          "Arial"
+        ]
+
+        fallback_fonts.each do |f|
+          return f if File.exist?(f) || f == "Arial"
+        end
+
+        nil
+      end
+    end
+  end
+end

data/lib/text2image/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Text2image
+  VERSION = "1.0.0"
+end

data/lib/text2image.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require_relative "text2image/version"
+require_relative "text2image/font_finder"
+require_relative "text2image/converter"
+
+module Text2image
+  class Error < StandardError; end
+
+  class << self
+    def convert(text, options = {})
+      converter = Converter.new(text, options)
+      
+      if options[:output]
+        converter.render(options[:output])
+      else
+        converter.render
+      end
+    end
+
+    def find_font(name = nil)
+      FontFinder.find_font(name)
+    end
+  end
+end

data/text2image.gemspec

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative "lib/text2image/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "text2image"
+  spec.version       = Text2image::VERSION
+  spec.authors       = ["Rheehose (Rhee Creative)"]
+  spec.email         = ["rheehose@example.com"]
+
+  spec.summary       = "A Ruby library to convert text to images with automatic system font detection."
+  spec.description   = "text2image allows you to easily transform text into black-and-white images using the best available system fonts. Ideal for quick image generation from text data."
+  spec.homepage      = "https://github.com/rheehose/text2image"
+  spec.license       = "MIT"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.6.0")
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "mini_magick", "~> 4.12"
+end

data/verify_work.rb

@@ -0,0 +1,36 @@
+require_relative 'lib/text2image'
+
+begin
+  puts "--- text2image v1.1.0 최종 통합 테스트 ---"
+  
+  # 1. 시스템 폰트 탐지 테스트
+  font_path = Text2image.find_font
+  puts "탐지된 시스템 폰트 경로: #{font_path}"
+  
+  # 2. 이미지 생성 테스트 (스마트 여백 기능 확인)
+  output_file = "test_padded_result.png"
+  padding_value = 50
+  
+  puts "이미지 생성 중 (여백: #{padding_value}px)..."
+  Text2image.convert("Ruby Text2Image\nSmart Padding Test", 
+    output: output_file,
+    font_size: 40,
+    padding: padding_value,
+    background: "white",
+    foreground: "black"
+  )
+  
+  if File.exist?(output_file)
+    puts "✅ 성공! 이미지가 생성되었습니다: #{File.expand_path(output_file)}"
+    
+    # 3. 실제 이미지 크기 확인 (여백이 잘 들어갔는지 간접 확인)
+    image = MiniMagick::Image.open(output_file)
+    puts "생성된 이미지 크기: #{image.width}x#{image.height}"
+    puts "테스트 완료!"
+  else
+    puts "❌ 실패: 이미지가 생성되지 않았습니다."
+  end
+
+rescue => e
+  puts "❌ 오류 발생: #{e.message}"
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: text2image
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Rheehose (Rhee Creative)
+bindir: exe
+cert_chain: []
+date: 2026-01-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mini_magick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.12'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.12'
+description: text2image allows you to easily transform text into black-and-white images
+  using the best available system fonts. Ideal for quick image generation from text
+  data.
+email:
+- rheehose@example.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- CHANGELOG.md
+- CHANGELOG_ko.md
+- CONTRIBUTING.md
+- CONTRIBUTING_ko.md
+- Gemfile
+- LICENSE
+- LICENSE_ko.md
+- README.md
+- README_ko.md
+- lib/text2image.rb
+- lib/text2image/converter.rb
+- lib/text2image/font_finder.rb
+- lib/text2image/version.rb
+- test_padded_result.png
+- text2image.gemspec
+- verify_work.rb
+homepage: https://github.com/rheehose/text2image
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/rheehose/text2image
+  source_code_uri: https://github.com/rheehose/text2image
+  changelog_uri: https://github.com/rheehose/text2image/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: A Ruby library to convert text to images with automatic system font detection.
+test_files: []