ascii_pngfy 0.2.0

data/lib/ascii_pngfy/settings/vertical_spacing_setting.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module AsciiPngfy
+  module Settings
+    # Reponsibilities
+    #   - Keeps track of the the vertical_spacing setting
+    #   - Validates vertical_spacing
+    class VerticalSpacingSetting
+      include SetableGetable
+
+      def initialize(initial_spacing)
+        self.vertical_spacing = 0
+
+        set(initial_spacing)
+      end
+
+      def get
+        vertical_spacing
+      end
+
+      def set(desired_spacing)
+        validated_vertical_spacing = validate_vertical_spacing(desired_spacing)
+
+        self.vertical_spacing = validated_vertical_spacing
+      end
+
+      private
+
+      attr_accessor(:vertical_spacing)
+
+      def vertical_spacing_valid?(some_spacing)
+        some_spacing.is_a?(Integer) && (some_spacing >= 0)
+      end
+
+      def validate_vertical_spacing(some_spacing)
+        return some_spacing if vertical_spacing_valid?(some_spacing)
+
+        error_message = String.new
+        error_message << "#{some_spacing} is not a valid vertical spacing. "
+        error_message << 'Must be an Integer in the range (0..).'
+
+        raise AsciiPngfy::Exceptions::InvalidVerticalSpacingError, error_message
+      end
+    end
+  end
+end

data/lib/ascii_pngfy/settings_renderer.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module AsciiPngfy
+  # Reponsibilities
+  #   - Uses RenderingRules to interpret settings into a Result object
+  #   - Uses Glyph designs to plot design data into the result png
+  class SettingsRenderer
+    def initialize(use_glyph_designs: true)
+      self.use_glyph_designs = use_glyph_designs
+    end
+
+    def render_result(settings_snapshot)
+      png = generate_png(settings_snapshot)
+
+      RenderingRules.plot_settings(settings_snapshot, use_glyph_designs, png)
+
+      generate_result(settings_snapshot, png)
+    end
+
+    private
+
+    def generate_png(settings)
+      ChunkyPNG::Image.new(
+        RenderingRules.png_width(settings),
+        RenderingRules.png_height(settings),
+        RenderingRules.color_rgba_to_chunky_png_integer(settings.background_color)
+      )
+    end
+
+    def generate_result(settings, png)
+      Result.new(
+        png,
+        RenderingRules.render_width(settings),
+        RenderingRules.render_height(settings),
+        settings
+      )
+    end
+
+    attr_accessor(:use_glyph_designs)
+  end
+end

data/lib/ascii_pngfy/vec2i.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module AsciiPngfy
+  # Reponsibilities
+  #   - Helper used to represent integer pixel coordinate pair
+  #   - Public getters for each coordinate
+  class Vec2i
+    attr_reader(:x, :y)
+
+    def initialize(initial_x = 0, initial_y = 0)
+      self.x = initial_x
+      self.y = initial_y
+    end
+
+    def to_s
+      "[#{x}, #{y}]"
+    end
+
+    private
+
+    attr_writer(:x, :y)
+  end
+end

metadata

@@ -0,0 +1,155 @@
+--- !ruby/object:Gem::Specification
+name: ascii_pngfy
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Sven Garson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2021-02-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: chunky_png
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.4.0
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 5.14.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 5.14.3
+- !ruby/object:Gem::Dependency
+  name: minitest-reporters
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.4.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.4.3
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 13.0.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 13.0.3
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.9.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.9.1
+- !ruby/object:Gem::Dependency
+  name: rubocop-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.10.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.10.3
+description: AsciiPngfy is a Ruby Gem that enables you to render ASCII text into a
+  PNG image up to a resolution of 3840(width) by 2160(height) using a 5x9 monospaced
+  font. Configurable settings that influence   the result are font-color, background-color,
+  font-height, horizontal-spacing, vertical-spacing, and text. The result includes
+  the PNG containing the intended image with all the settings applied, a snapshot
+  of the settings used, and render dimensions that define the size the generated png
+  should be rendered at to reflect the font-height settings. The generated png is
+  always the lowest possible resolution. Each monospaced character takes up a 5(width)
+  by 9(height) space to take advantage of scaled rendering and avoid unnecessarily
+  large images. For the best visual results, the resulting png should be rendered
+  in the original dimensions or the render dimensions along with a NEAREST filter.
+email: sven.garson@outlook.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/ascii_pngfy.rb
+- lib/ascii_pngfy/aabb.rb
+- lib/ascii_pngfy/color_rgba.rb
+- lib/ascii_pngfy/exceptions.rb
+- lib/ascii_pngfy/glyphs.rb
+- lib/ascii_pngfy/pngfyer.rb
+- lib/ascii_pngfy/rendering_rules.rb
+- lib/ascii_pngfy/result.rb
+- lib/ascii_pngfy/settings.rb
+- lib/ascii_pngfy/settings/color_setting.rb
+- lib/ascii_pngfy/settings/font_height_setting.rb
+- lib/ascii_pngfy/settings/horizontal_spacing_setting.rb
+- lib/ascii_pngfy/settings/setable_getable.rb
+- lib/ascii_pngfy/settings/setable_getable_settings.rb
+- lib/ascii_pngfy/settings/settings_snapshot.rb
+- lib/ascii_pngfy/settings/text_setting.rb
+- lib/ascii_pngfy/settings/vertical_spacing_setting.rb
+- lib/ascii_pngfy/settings_renderer.rb
+- lib/ascii_pngfy/vec2i.rb
+homepage: https://github.com/SvenGarson/ascii_pngfy
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: 2.7.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.4
+signing_key: 
+specification_version: 4
+summary: Ruby Gem that renders ASCII text into PNGs using a 5x9 monospaced font.
+test_files: []