dreamega-ico-encoder 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d4345524ff4b6e7884c49fe13bffbd43c9f9d457e98d079c8ad0439c0be1bb8e
+  data.tar.gz: bcd895c3326b63bae6da60d7ecb76f46db256aae0184da9247ab3b6b836df8f0
+SHA512:
+  metadata.gz: e644bea1d797a0c0e329ede2bd83c670ba851da387e8e9d2d864821f41e5fd8e4f55df4ab4bca29f8ba3ff8b7715d515cde7d0aac2ae4811a6d4936ff70299de
+  data.tar.gz: b3b39c8c27814e160f887f3ef271bca3ab76f5b681aee5d9b5ab5bdb160622ce616b9ea2322e6d53e2040cc6484672d4aa64740df7ef2c43553247d4081efe9f

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dreamega
+
+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,39 @@
+# dreamega-ico-encoder
+
+Generate multi-size ICO favicon files from PNG images in pure Ruby.
+
+## Installation
+
+```ruby
+gem install dreamega-ico-encoder
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem "dreamega-ico-encoder"
+```
+
+## Usage
+
+```ruby
+require "dreamega-ico-encoder"
+
+# Build a hash of size => PNG binary data
+png_images = {
+  16  => File.binread("icon-16.png"),
+  32  => File.binread("icon-32.png"),
+  64  => File.binread("icon-64.png"),
+}
+
+ico_data = Dreamega::IcoEncoder.generate(png_images)
+File.binwrite("favicon.ico", ico_data)
+```
+
+## Links
+
+- Homepage: [https://dreamega.ai](https://dreamega.ai)
+
+## License
+
+MIT

data/lib/dreamega/ico_encoder.rb

@@ -0,0 +1,46 @@
+module Dreamega
+  module IcoEncoder
+    # Default icon sizes for ICO generation.
+    DEFAULT_SIZES = [16, 32, 48, 64, 128, 256].freeze
+
+    # Generate an ICO file from a hash of {size => png_bytes}.
+    #
+    # @param png_images [Hash<Integer, String>] mapping of pixel size to PNG binary data
+    # @return [String] ICO file binary string
+    def self.generate(png_images)
+      entries = png_images.sort_by { |size, _| size }
+      count = entries.length
+
+      # ICO header (6 bytes): reserved, type=1 (ICO), image count
+      header = [0, 1, count].pack("v3")
+
+      # Calculate offset where image data starts
+      # Header (6) + directory entries (16 * count)
+      data_offset_base = 6 + 16 * count
+      current_offset = data_offset_base
+
+      directory = "".b
+      image_data = "".b
+
+      entries.each do |size, png_data|
+        png_bytes = png_data.b
+        w = size >= 256 ? 0 : size
+        h = w
+
+        # Directory entry (16 bytes):
+        # width, height, color_count, reserved (each 1 byte)
+        # color_planes (2 bytes), bits_per_pixel (2 bytes)
+        # data_size (4 bytes), data_offset (4 bytes)
+        entry = [w, h, 0, 0].pack("C4")
+        entry += [1, 32].pack("v2")
+        entry += [png_bytes.length, current_offset].pack("V2")
+
+        directory += entry
+        image_data += png_bytes
+        current_offset += png_bytes.length
+      end
+
+      header + directory + image_data
+    end
+  end
+end

data/lib/dreamega-ico-encoder.rb

@@ -0,0 +1 @@
+require_relative "dreamega/ico_encoder"

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: dreamega-ico-encoder
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Dreamega
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-04-07 00:00:00.000000000 Z
+dependencies: []
+description: A pure Ruby library for generating ICO favicon files. Supports multiple
+  image sizes with proper ICO binary format headers.
+email:
+- dev@dreamega.ai
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/dreamega-ico-encoder.rb
+- lib/dreamega/ico_encoder.rb
+homepage: https://dreamega.ai
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/dreamega-ai/dreamega-ico-encoder-ruby
+  homepage_uri: https://dreamega.ai
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Generate multi-size ICO favicon files from PNG images
+test_files: []