ruby_spriter 0.6.7 → 0.7.0.1

data/lib/ruby_spriter/compression_manager.rb

@@ -1,101 +1,101 @@
-# frozen_string_literal: true
-
-require 'open3'
-require 'fileutils'
-
-module RubySpriter
-  # Manages PNG compression with metadata preservation
-  class CompressionManager
-    # Compress PNG file using ImageMagick with maximum compression
-    # @param input_file [String] Source PNG file
-    # @param output_file [String] Destination PNG file
-    # @param debug [Boolean] Enable debug output
-    def self.compress(input_file, output_file, debug: false)
-      Utils::FileHelper.validate_readable!(input_file)
-
-      cmd = build_compression_command(input_file, output_file)
-
-      if debug
-        Utils::OutputFormatter.indent("DEBUG: Compression command: #{cmd}")
-      end
-
-      stdout, stderr, status = Open3.capture3(cmd)
-
-      unless status.success?
-        raise ProcessingError, "Failed to compress PNG: #{stderr}"
-      end
-
-      Utils::FileHelper.validate_exists!(output_file)
-    end
-
-    # Compress PNG file while preserving embedded metadata
-    # @param input_file [String] Source PNG file
-    # @param output_file [String] Destination PNG file
-    # @param debug [Boolean] Enable debug output
-    def self.compress_with_metadata(input_file, output_file, debug: false)
-      # Read metadata before compression
-      metadata = MetadataManager.read(input_file)
-
-      # Compress the file
-      temp_file = output_file.gsub('.png', '_compress_temp.png')
-      compress(input_file, temp_file, debug: debug)
-
-      # Re-embed metadata if it existed
-      if metadata
-        MetadataManager.embed(
-          temp_file,
-          output_file,
-          columns: metadata[:columns],
-          rows: metadata[:rows],
-          frames: metadata[:frames],
-          debug: debug
-        )
-
-        # Clean up temp file
-        FileUtils.rm_f(temp_file) if File.exist?(temp_file)
-      else
-        # No metadata, just move temp to output
-        FileUtils.mv(temp_file, output_file)
-      end
-    end
-
-    # Get compression statistics
-    # @param original_file [String] Original file path
-    # @param compressed_file [String] Compressed file path
-    # @return [Hash] Statistics including sizes and reduction percentage
-    def self.compression_stats(original_file, compressed_file)
-      original_size = File.size(original_file)
-      compressed_size = File.size(compressed_file)
-      saved_bytes = original_size - compressed_size
-      reduction_percent = (saved_bytes.to_f / original_size * 100.0)
-
-      {
-        original_size: original_size,
-        compressed_size: compressed_size,
-        saved_bytes: saved_bytes,
-        reduction_percent: reduction_percent
-      }
-    end
-
-    private_class_method def self.build_compression_command(input_file, output_file)
-      magick_cmd = Platform.imagemagick_convert_cmd
-
-      # Use maximum PNG compression settings:
-      # - compression-level=9: Maximum zlib compression
-      # - compression-filter=5: Paeth filter (best for most images)
-      # - compression-strategy=1: Filtered strategy
-      # - quality=95: High quality
-      # - strip: Remove all metadata (we'll re-add it later)
-      [
-        magick_cmd,
-        Utils::PathHelper.quote_path(input_file),
-        '-strip',
-        '-define', 'png:compression-level=9',
-        '-define', 'png:compression-filter=5',
-        '-define', 'png:compression-strategy=1',
-        '-quality', '95',
-        Utils::PathHelper.quote_path(output_file)
-      ].join(' ')
-    end
-  end
-end
+# frozen_string_literal: true
+
+require 'open3'
+require 'fileutils'
+
+module RubySpriter
+  # Manages PNG compression with metadata preservation
+  class CompressionManager
+    # Compress PNG file using ImageMagick with maximum compression
+    # @param input_file [String] Source PNG file
+    # @param output_file [String] Destination PNG file
+    # @param debug [Boolean] Enable debug output
+    def self.compress(input_file, output_file, debug: false)
+      Utils::FileHelper.validate_readable!(input_file)
+
+      cmd = build_compression_command(input_file, output_file)
+
+      if debug
+        Utils::OutputFormatter.indent("DEBUG: Compression command: #{cmd}")
+      end
+
+      stdout, stderr, status = Open3.capture3(cmd)
+
+      unless status.success?
+        raise ProcessingError, "Failed to compress PNG: #{stderr}"
+      end
+
+      Utils::FileHelper.validate_exists!(output_file)
+    end
+
+    # Compress PNG file while preserving embedded metadata
+    # @param input_file [String] Source PNG file
+    # @param output_file [String] Destination PNG file
+    # @param debug [Boolean] Enable debug output
+    def self.compress_with_metadata(input_file, output_file, debug: false)
+      # Read metadata before compression
+      metadata = MetadataManager.read(input_file)
+
+      # Compress the file
+      temp_file = output_file.gsub('.png', '_compress_temp.png')
+      compress(input_file, temp_file, debug: debug)
+
+      # Re-embed metadata if it existed
+      if metadata
+        MetadataManager.embed(
+          temp_file,
+          output_file,
+          columns: metadata[:columns],
+          rows: metadata[:rows],
+          frames: metadata[:frames],
+          debug: debug
+        )
+
+        # Clean up temp file
+        FileUtils.rm_f(temp_file) if File.exist?(temp_file)
+      else
+        # No metadata, just move temp to output
+        FileUtils.mv(temp_file, output_file)
+      end
+    end
+
+    # Get compression statistics
+    # @param original_file [String] Original file path
+    # @param compressed_file [String] Compressed file path
+    # @return [Hash] Statistics including sizes and reduction percentage
+    def self.compression_stats(original_file, compressed_file)
+      original_size = File.size(original_file)
+      compressed_size = File.size(compressed_file)
+      saved_bytes = original_size - compressed_size
+      reduction_percent = (saved_bytes.to_f / original_size * 100.0)
+
+      {
+        original_size: original_size,
+        compressed_size: compressed_size,
+        saved_bytes: saved_bytes,
+        reduction_percent: reduction_percent
+      }
+    end
+
+    private_class_method def self.build_compression_command(input_file, output_file)
+      magick_cmd = Platform.imagemagick_convert_cmd
+
+      # Use maximum PNG compression settings:
+      # - compression-level=9: Maximum zlib compression
+      # - compression-filter=5: Paeth filter (best for most images)
+      # - compression-strategy=1: Filtered strategy
+      # - quality=95: High quality
+      # - strip: Remove all metadata (we'll re-add it later)
+      [
+        magick_cmd,
+        Utils::PathHelper.quote_path(input_file),
+        '-strip',
+        '-define', 'png:compression-level=9',
+        '-define', 'png:compression-filter=5',
+        '-define', 'png:compression-strategy=1',
+        '-quality', '95',
+        Utils::PathHelper.quote_path(output_file)
+      ].join(' ')
+    end
+  end
+end

data/lib/ruby_spriter/consolidator.rb

@@ -1,179 +1,179 @@
-# frozen_string_literal: true
-
-require 'open3'
-
-module RubySpriter
-  # Consolidates multiple spritesheets vertically
-  class Consolidator
-    attr_reader :options
-
-    def initialize(options = {})
-      @options = options
-    end
-
-    # Consolidate multiple spritesheets into one
-    # @param files [Array<String>] Array of spritesheet file paths
-    # @param output_file [String] Output consolidated file path
-    # @return [Hash] Processing results
-    def consolidate(files, output_file)
-      validate_files!(files)
-
-      Utils::OutputFormatter.header("Consolidating Spritesheets")
-
-      metadata_list = read_all_metadata(files)
-      validate_compatibility!(metadata_list) if options[:validate_columns]
-
-      create_consolidated_image(files, output_file)
-
-      total_frames = metadata_list.sum { |m| m[:frames] }
-      columns = metadata_list.first[:columns]
-      rows = (total_frames.to_f / columns).ceil
-
-      # Embed consolidated metadata
-      temp_file = output_file.sub('.png', '_temp.png')
-      File.rename(output_file, temp_file)
-
-      MetadataManager.embed(
-        temp_file,
-        output_file,
-        columns: columns,
-        rows: rows,
-        frames: total_frames,
-        debug: options[:debug]
-      )
-
-      File.delete(temp_file) if File.exist?(temp_file)
-
-      file_size = File.size(output_file)
-
-      # Display results with Godot instructions
-      display_consolidation_results(output_file, file_size, files, metadata_list, columns, rows, total_frames)
-
-      {
-        output_file: output_file,
-        columns: columns,
-        rows: rows,
-        frames: total_frames,
-        size: file_size
-      }
-    end
-
-    # Find all PNG files with spritesheet metadata in a directory
-    # @param directory [String] Directory path to scan
-    # @return [Array<String>] Sorted array of spritesheet file paths
-    def find_spritesheets_in_directory(directory)
-      # Validate directory exists
-      unless File.directory?(directory)
-        raise ValidationError, "Directory not found: #{directory}"
-      end
-
-      # Find all PNG files
-      pattern = File.join(directory, '*.png')
-      png_files = Dir.glob(pattern)
-
-      # Filter to only files with metadata
-      spritesheets = png_files.select do |file|
-        metadata = MetadataManager.read(file)
-        !metadata.nil?
-      end
-
-      # Validate we found at least one
-      if spritesheets.empty?
-        raise ValidationError, "No PNG files with spritesheet metadata found in directory: #{directory}"
-      end
-
-      # Validate we have at least 2
-      if spritesheets.length < 2
-        raise ValidationError, "Found only #{spritesheets.length} spritesheet, need at least 2 for consolidation"
-      end
-
-      # Sort alphabetically by filename
-      spritesheets.sort
-    end
-
-    private
-
-    def validate_files!(files)
-      raise ValidationError, "Need at least 2 files to consolidate" if files.length < 2
-
-      files.each { |file| Utils::FileHelper.validate_readable!(file) }
-    end
-
-    def read_all_metadata(files)
-      metadata_list = files.map do |file|
-        metadata = MetadataManager.read(file)
-        
-        unless metadata
-          raise ValidationError, "File missing metadata: #{file}\nAll files must be Ruby Spriter spritesheets."
-        end
-
-        metadata
-      end
-
-      metadata_list
-    end
-
-    def validate_compatibility!(metadata_list)
-      columns = metadata_list.first[:columns]
-      
-      incompatible = metadata_list.find { |m| m[:columns] != columns }
-      
-      if incompatible
-        raise ValidationError, 
-          "Column count mismatch: Expected #{columns}, found #{incompatible[:columns]}\n" \
-          "Use --no-validate-columns to force consolidation."
-      end
-    end
-
-    def create_consolidated_image(files, output_file)
-      Utils::OutputFormatter.indent("Stacking spritesheets vertically...")
-
-      # Use ImageMagick to stack images vertically
-      magick_cmd = Platform.imagemagick_convert_cmd
-      
-      cmd = [
-        magick_cmd,
-        *files.map { |f| Utils::PathHelper.quote_path(f) },
-        '-append',
-        Utils::PathHelper.quote_path(output_file)
-      ].join(' ')
-
-      if options[:debug]
-        Utils::OutputFormatter.indent("DEBUG: ImageMagick command: #{cmd}")
-      end
-
-      stdout, stderr, status = Open3.capture3(cmd)
-
-      unless status.success?
-        raise ProcessingError, "ImageMagick consolidation failed: #{stderr}"
-      end
-
-      Utils::FileHelper.validate_exists!(output_file)
-    end
-
-    def display_consolidation_results(output_file, file_size, files, metadata_list, columns, rows, total_frames)
-      Utils::OutputFormatter.success("Consolidated spritesheet created")
-      Utils::OutputFormatter.indent("Output: #{output_file}")
-      Utils::OutputFormatter.indent("Size: #{Utils::FileHelper.format_size(file_size)}")
-      Utils::OutputFormatter.note("Combined #{files.length} spritesheets (#{total_frames} total frames)")
-      
-      puts "\n      Grid Layout:"
-      Utils::OutputFormatter.indent("Columns: #{columns}")
-      Utils::OutputFormatter.indent("Rows: #{rows}")
-      Utils::OutputFormatter.indent("Total Frames: #{total_frames}")
-      
-      puts "\n      📊 Godot AnimatedSprite2D Settings:"
-      Utils::OutputFormatter.indent("HFrames = #{columns}")
-      Utils::OutputFormatter.indent("VFrames = #{rows}")
-      
-      puts "\n      📋 Source Breakdown:"
-      metadata_list.each_with_index do |meta, index|
-        file_basename = File.basename(files[index])
-        Utils::OutputFormatter.indent("#{index + 1}. #{file_basename}")
-        Utils::OutputFormatter.indent("   └─ #{meta[:columns]}×#{meta[:rows]} grid (#{meta[:frames]} frames)")
-      end
-      
-      puts ""
-    end
-  end
-end
+# frozen_string_literal: true
+
+require 'open3'
+
+module RubySpriter
+  # Consolidates multiple spritesheets vertically
+  class Consolidator
+    attr_reader :options
+
+    def initialize(options = {})
+      @options = options
+    end
+
+    # Consolidate multiple spritesheets into one
+    # @param files [Array<String>] Array of spritesheet file paths
+    # @param output_file [String] Output consolidated file path
+    # @return [Hash] Processing results
+    def consolidate(files, output_file)
+      validate_files!(files)
+
+      Utils::OutputFormatter.header("Consolidating Spritesheets")
+
+      metadata_list = read_all_metadata(files)
+      validate_compatibility!(metadata_list) if options[:validate_columns]
+
+      create_consolidated_image(files, output_file)
+
+      total_frames = metadata_list.sum { |m| m[:frames] }
+      columns = metadata_list.first[:columns]
+      rows = (total_frames.to_f / columns).ceil
+
+      # Embed consolidated metadata
+      temp_file = output_file.sub('.png', '_temp.png')
+      File.rename(output_file, temp_file)
+
+      MetadataManager.embed(
+        temp_file,
+        output_file,
+        columns: columns,
+        rows: rows,
+        frames: total_frames,
+        debug: options[:debug]
+      )
+
+      File.delete(temp_file) if File.exist?(temp_file)
+
+      file_size = File.size(output_file)
+
+      # Display results with Godot instructions
+      display_consolidation_results(output_file, file_size, files, metadata_list, columns, rows, total_frames)
+
+      {
+        output_file: output_file,
+        columns: columns,
+        rows: rows,
+        frames: total_frames,
+        size: file_size
+      }
+    end
+
+    # Find all PNG files with spritesheet metadata in a directory
+    # @param directory [String] Directory path to scan
+    # @return [Array<String>] Sorted array of spritesheet file paths
+    def find_spritesheets_in_directory(directory)
+      # Validate directory exists
+      unless File.directory?(directory)
+        raise ValidationError, "Directory not found: #{directory}"
+      end
+
+      # Find all PNG files
+      pattern = File.join(directory, '*.png')
+      png_files = Dir.glob(pattern)
+
+      # Filter to only files with metadata
+      spritesheets = png_files.select do |file|
+        metadata = MetadataManager.read(file)
+        !metadata.nil?
+      end
+
+      # Validate we found at least one
+      if spritesheets.empty?
+        raise ValidationError, "No PNG files with spritesheet metadata found in directory: #{directory}"
+      end
+
+      # Validate we have at least 2
+      if spritesheets.length < 2
+        raise ValidationError, "Found only #{spritesheets.length} spritesheet, need at least 2 for consolidation"
+      end
+
+      # Sort alphabetically by filename
+      spritesheets.sort
+    end
+
+    private
+
+    def validate_files!(files)
+      raise ValidationError, "Need at least 2 files to consolidate" if files.length < 2
+
+      files.each { |file| Utils::FileHelper.validate_readable!(file) }
+    end
+
+    def read_all_metadata(files)
+      metadata_list = files.map do |file|
+        metadata = MetadataManager.read(file)
+        
+        unless metadata
+          raise ValidationError, "File missing metadata: #{file}\nAll files must be Ruby Spriter spritesheets."
+        end
+
+        metadata
+      end
+
+      metadata_list
+    end
+
+    def validate_compatibility!(metadata_list)
+      columns = metadata_list.first[:columns]
+      
+      incompatible = metadata_list.find { |m| m[:columns] != columns }
+      
+      if incompatible
+        raise ValidationError, 
+          "Column count mismatch: Expected #{columns}, found #{incompatible[:columns]}\n" \
+          "Use --no-validate-columns to force consolidation."
+      end
+    end
+
+    def create_consolidated_image(files, output_file)
+      Utils::OutputFormatter.indent("Stacking spritesheets vertically...")
+
+      # Use ImageMagick to stack images vertically
+      magick_cmd = Platform.imagemagick_convert_cmd
+      
+      cmd = [
+        magick_cmd,
+        *files.map { |f| Utils::PathHelper.quote_path(f) },
+        '-append',
+        Utils::PathHelper.quote_path(output_file)
+      ].join(' ')
+
+      if options[:debug]
+        Utils::OutputFormatter.indent("DEBUG: ImageMagick command: #{cmd}")
+      end
+
+      stdout, stderr, status = Open3.capture3(cmd)
+
+      unless status.success?
+        raise ProcessingError, "ImageMagick consolidation failed: #{stderr}"
+      end
+
+      Utils::FileHelper.validate_exists!(output_file)
+    end
+
+    def display_consolidation_results(output_file, file_size, files, metadata_list, columns, rows, total_frames)
+      Utils::OutputFormatter.success("Consolidated spritesheet created")
+      Utils::OutputFormatter.indent("Output: #{output_file}")
+      Utils::OutputFormatter.indent("Size: #{Utils::FileHelper.format_size(file_size)}")
+      Utils::OutputFormatter.note("Combined #{files.length} spritesheets (#{total_frames} total frames)")
+      
+      puts "\n      Grid Layout:"
+      Utils::OutputFormatter.indent("Columns: #{columns}")
+      Utils::OutputFormatter.indent("Rows: #{rows}")
+      Utils::OutputFormatter.indent("Total Frames: #{total_frames}")
+      
+      puts "\n      📊 Godot AnimatedSprite2D Settings:"
+      Utils::OutputFormatter.indent("HFrames = #{columns}")
+      Utils::OutputFormatter.indent("VFrames = #{rows}")
+      
+      puts "\n      📋 Source Breakdown:"
+      metadata_list.each_with_index do |meta, index|
+        file_basename = File.basename(files[index])
+        Utils::OutputFormatter.indent("#{index + 1}. #{file_basename}")
+        Utils::OutputFormatter.indent("   └─ #{meta[:columns]}×#{meta[:rows]} grid (#{meta[:frames]} frames)")
+      end
+      
+      puts ""
+    end
+  end
+end