pixel_raster 0.0.2

data/README.md

@@ -0,0 +1,26 @@
+![](Beispiel.svg)
+
+# pixel-raster
+Create a pixel raster representation of an image (for educational purposes).
+
+## Bits and pixels
+
+A digital (pixel) image simply is a number of bits in a given format.
+It encodes the size (width and height) of the image, i.e. how many
+columns and rows of pixels the image consists of as well as the color
+(and saturation and brightness) of each pixel.
+
+The most easy case is a black and white image where each pixel is
+represented by one bit.
+
+## A paint yourself binary pixel image 
+
+To explain how an image is represented as data it can help to show
+paint-yourself raster versions (see [images.pdf](images.pdf)).
+
+## xpm2tikz
+
+The script takes xpm images from the command line as input and
+outputs [tikz](https://ctan.org/pkg/pgf)-code to stdout.
+
+See `xpm2tikz -h`.

data/bin/xpm2tikz

@@ -0,0 +1,8 @@
+#! /usr/bin/env ruby
+# -*- coding: utf-8 -*-
+
+require 'xpm2tikz'
+
+include PixelRaster
+
+command_line

data/lib/pixel_raster.rb

@@ -0,0 +1,44 @@
+#! /usr/bin/env ruby
+
+module PixelRaster
+  # read xpm files
+  # this is not very robust but assumes a straight forward file format
+  # without color/grayscale etc being mixed.
+  def read_xpm(filename)
+    lines = File.readlines(filename)
+    lines.shift # get rid of  /* XPM */
+    lines.shift # get rid of  static char * ...[] = {
+    meta = lines.shift.scan(/[0-9]+/)
+    n_x = meta[0].to_i
+    n_y = meta[1].to_i
+    n_of_colors = meta[2].to_i
+    n_of_chars = meta[3].to_i
+    
+    colors = {}
+    
+    n_of_colors.times do
+      lines.shift =~ /"(.{#{n_of_chars}})\s+([cgms]4?)\s+(.*?)"/
+      colors[$1] = $3
+    end
+    
+    (1..n_y).collect do
+      lines.shift[1..n_x].scan(/.{#{n_of_chars}}/).collect { |c| colors[c] }
+    end
+  end
+  
+  def xpm2tikz(filename, prefix="n")
+    xpm = read_xpm(filename)
+    "\\begin{tikzpicture}[yscale=-1]
+  \\draw[step=1,help lines] (0,0) grid (#{xpm.first.length},#{xpm.length});
+    " + xpm.each_with_index.collect { |row,r|
+      row.each_with_index.collect { |color,c|
+        cc = color=='#FFFFFF' ? '0' : '1'
+        "\\node[#{prefix+cc}] at (#{c+0.5},#{r+0.5}) {#{cc}};"
+      }.join("\n")
+    }.join("\n") + "
+\\end{tikzpicture}
+  "
+  end
+end
+
+  

data/lib/xpm2tikz.rb

@@ -0,0 +1,45 @@
+#! /usr/bin/env ruby
+# -*- coding: utf-8 -*-
+
+require 'pixel_raster'
+require 'optparse'
+
+module PixelRaster
+
+  def command_line
+    out = $stdout
+    
+    OptionParser.new do |parser|
+      parser.banner = "\nConvert xpm image(s) to tikz. \n\nUsage: $0 [-O OUTFILE] INFILE [INFILE…]"
+
+      parser.on("-h", "--help", "Show this help message") do
+        puts parser
+        exit
+      end
+      
+      parser.on('-O', '--output FILENAME',
+                'write output to FILENAME (default: stdout)') do |filename|
+        begin
+          # We open the outfile here without ensuring it will be closed.
+          # This is ok as we need it throughout the whole script runtime
+          # and it will be closed on exit automatically.
+          out = File.open(filename, 'w')
+
+        # We could be more specific about catching errors, but we
+        # exit the script anyway, and this may be different on different OSes.
+        rescue StandardError => e
+          warn "Could not open “#{filename}” for writing."
+          warn e
+          exit e.errno
+        end
+      end
+    end.parse!
+
+    ARGV.each do |filename|
+      out << xpm2tikz(filename)
+      out << "\n\\vfill\n\n"
+      out << xpm2tikz(filename,'y')
+      out << "\n\\vfill\n\n"
+    end
+  end
+end

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: pixel_raster
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Klaus Stein
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-06-24 00:00:00.000000000 Z
+dependencies: []
+description: Create a pixel raster representation of an image (for educational purposes).
+email: ruby@istik.de
+executables:
+- xpm2tikz
+extensions: []
+extra_rdoc_files: []
+files:
+- Beispiel.svg
+- LICENSE
+- README.md
+- bin/xpm2tikz
+- lib/pixel_raster.rb
+- lib/xpm2tikz.rb
+homepage: https://github.com/Lapizistik/pixel_raster
+licenses:
+- GPL-3.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2.1
+signing_key: 
+specification_version: 4
+summary: Pixel image TikZ creator
+test_files: []