rmagick 1.7.1

data/doc/ex/Adispatch.rb

@@ -0,0 +1,43 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+f = Magick::Image.read("images/Flower_Hat.jpg").first
+
+pixels = f.dispatch(0,0,f.columns,f.rows,"RGB")
+
+# Write the pixels to a file, to be loaded in the Zconstitute.rb
+# example.  Ruby 1.6.8 # loads the Pixels array much faster if we break
+# the array into many small pieces and concatenate them together, so this
+# program generates such a sequence.
+
+first = true
+total = pixels.length
+
+File.open('pixels-array', 'w') { |txt|
+    txt.puts("Width = #{f.columns}")
+    txt.puts("Height = #{f.rows}")
+    txt.puts('Pixels = [')
+    x = 0
+    pixels.each do |p|
+        txt.printf("%3d,", p)
+        x = x.succ
+        txt.printf("\n") if x % 25 == 0
+        if x % 1000 == 0
+            if first
+                txt.puts(']')
+                first = false
+            else
+                txt.puts('])')
+            end
+            txt.print('Pixels.concat([')
+        end
+    end
+
+    if first
+        txt.puts(']')
+        first = false
+    else
+        txt.puts('])')
+    end
+}
+exit

data/doc/ex/Zconstitute.rb

@@ -0,0 +1,9 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+load 'pixels-array'
+
+image = Magick::Image.constitute(Width, Height, "RGB", Pixels)
+
+image.write("constitute.jpg")
+exit

data/doc/ex/adaptive_threshold.rb

@@ -0,0 +1,19 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#adaptive_threshold method
+
+img = Magick::Image.read("images/Flower_Hat.jpg").first
+
+begin
+    result = img.adaptive_threshold
+
+# Substitute the standard "Not Implemented" image
+rescue NotImplementedError
+    result = Magick::Image.read("images/notimplemented.gif").first
+    result.resize!(img.columns, img.rows)
+end
+
+result.write("adaptive_threshold.jpg")
+exit
+

data/doc/ex/add_noise.rb

@@ -0,0 +1,18 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+include Magick
+
+# Demonstrate the Image#add_noise method
+NOISE_TYPES = [UniformNoise, GaussianNoise,
+               MultiplicativeGaussianNoise,
+               ImpulseNoise, LaplacianNoise,
+               PoissonNoise]
+
+img = Magick::Image.read('images/Flower_Hat.jpg').first
+
+NOISE_TYPES.each do |noise|
+    copy = img.add_noise(noise)
+    copy.write "add_noise_#{noise.to_s}.jpg"
+
+end
+exit

data/doc/ex/affine.rb

@@ -0,0 +1,48 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the affine primitive. Transform the
+# coordinate space to put the origin in the lower
+# left corner.
+
+imgl = Magick::ImageList.new
+imgl.new_image 200, 200, Magick::HatchFill.new('white','lightcyan2')
+
+gc = Magick::Draw.new
+
+max_x = imgl.columns
+max_y = imgl.rows
+
+# Translate the y origin to the bottom of the window.
+# Invert the y points by scaling by -1. Combine the
+# two operations using the affine method. That is, the
+# affine method is equivalent to:
+#       gc.translate 0, max_y
+#       gc.scale 1, -1
+gc.affine(1, 0, 0, -1, 0, max_y)
+gc.stroke('gray50')
+gc.fill('gray50')
+gc.stroke_width(1)
+
+# Draw up-pointing arrow.
+gc.polyline(10, 10, 10, max_y-10, 5, max_y-15, 15, max_y-15, 10, max_y-10)
+
+# Draw right-pointing arrow
+gc.polyline(10, 10, max_x-10, 10, max_x-15, 5, max_x-15, 15, max_x-10, 10)
+
+gc.draw(imgl)
+
+# Add labels. Use a different graphics context with a "normal"
+# coordinate system so the text isn't inverted.
+text_gc = Magick::Draw.new
+text_gc.pointsize(14)
+text_gc.font_weight(Magick::NormalWeight)
+text_gc.stroke('transparent')
+text_gc.text(15, max_y-15, "'0,0'")
+text_gc.text(max_x-20, max_y-16, "'+x'")
+text_gc.text(12, 15, "'+y'")
+text_gc.draw(imgl)
+
+imgl.border!(1, 1, "lightcyan2")
+
+imgl.write("affine.gif")

data/doc/ex/affine_transform.rb

@@ -0,0 +1,20 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#affine_transform method
+
+# Construct a simple affine matrix
+flipflop = Magick::AffineMatrix.new(-1, Math::PI/6, Math::PI/6, -1, 0, 0)
+
+img = Magick::Image.read("images/Flower_Hat.jpg").first
+
+# Apply the transform
+img = img.affine_transform(flipflop)
+
+# Scale the image, make the background transparent,
+# and write it to a JPEG file.
+img.scale!(250.0/img.rows)
+img = img.matte_replace(0,0)
+img.write("affine_transform.jpg")
+
+exit

data/doc/ex/arc.rb

@@ -0,0 +1,47 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+i = Magick::Image.new(300, 220, Magick::HatchFill.new("white","lightcyan2"))
+gc = Magick::Draw.new
+
+# Draw the border rectangle.
+gc.fill_opacity(0)
+gc.stroke_width(1)
+gc.stroke('gray50')
+gc.rectangle(40, 50, 250, 180)
+
+# Draw the circles around the rectangle corners and
+# arc endpoints. All the circles have a 3-pixel radius.
+gc.circle(40,   50,  40+3,  50)
+gc.circle(250, 180, 250+3, 180)
+gc.circle(250, 114, 250+3, 114)
+gc.circle(146,  50, 146+3,  50)
+
+# Annotate
+gc.stroke('transparent')
+gc.fill("black")
+gc.fill_opacity(1)
+
+# xMagick recognizes the braces as delimiters.
+gc.gravity(Magick::NorthWestGravity)
+gc.text(43, 45, "{40, 50}")
+gc.text(195, 118, "{0 degrees}")
+
+gc.gravity(Magick::SouthEastGravity)
+gc.text(300-250, 220-195, "{250, 180}")
+
+gc.gravity(Magick::NorthGravity)
+gc.text(0, 67, "{270 degrees}")
+
+# Draw the arc
+gc.fill_opacity(0)
+gc.stroke('red').stroke_width(3)
+gc.arc(40, 50, 250,180, 0, 270)
+
+# Draw on the canvas
+gc.draw(i)
+
+i.border!(1,1, "lightcyan2")
+
+#i.display
+i.write("arc.gif")

data/doc/ex/arcpath.rb

@@ -0,0 +1,33 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the "path" drawing primitive.
+
+imgl = Magick::ImageList.new
+imgl.new_image(450, 200, Magick::HatchFill.new('white','lightcyan2'))
+
+gc = Magick::Draw.new
+
+# Draw "pie chart"
+gc.fill('red')
+gc.stroke('blue')
+gc.stroke_width(2)
+gc.path('M110,100 h-75 a75,75 0 1,0 75,-75 z')
+gc.fill('yellow')
+gc.path('M97.5,87.5 v-75 a75,75 0 0,0 -75,75 z')
+
+# Draw wiggly line
+gc.fill_opacity(0)
+gc.stroke('#00cd00')
+gc.stroke_width(3)
+gc.path('M200,175 l 25,-12.5 ' +
+                'a12.5,12.5 -15 0,1 25,-12.5 l 25,-12.5 ' +
+                'a12.5,25   -15 0,1 25,-12.5 l 25,-12.5 ' +
+                'a12.5,37.5 -15 0,1 25,-12.5 l 25,-12.5 ' +
+                'a12.5,50   -15 0,1 25,-12.5 l 25,-12.5')
+
+gc.draw imgl
+imgl.border!(1,1, "lightcyan2")
+
+imgl.write('arcpath.gif')
+

data/doc/ex/average.rb

@@ -0,0 +1,15 @@
+#! /usr/local/bin/ruby -w
+# Demonstrate ImageList#average method
+require 'RMagick'
+
+images = Magick::ImageList.new("images/Button_A.gif", "images/Button_B.gif", "images/Button_C.gif")
+
+group = images.append false
+group.compression = Magick::LZWCompression
+group.write "average_before.gif"
+
+average_image = images.average
+
+average_image.compression = Magick::LZWCompression
+average_image.write "average_after.gif"
+exit

data/doc/ex/axes.rb

@@ -0,0 +1,64 @@
+#!/usr/local/bin/ruby -w
+
+require 'RMagick'
+
+# Demonstrate the use of RMagick's Draw class
+# and show the default coordinate system.
+
+# Create a canvas to draw on. Use the HatchFill class to
+# cross-hatch the background with light gray lines every 10 pixels.
+canvas = Magick::ImageList.new
+canvas.new_image(250, 250, Magick::HatchFill.new('white', 'gray90'))
+
+# Draw a border around the edges of the canvas.
+border = Magick::Draw.new
+border.stroke('thistle')
+border.fill_opacity(0)
+border.rectangle(0,0, canvas.rows-1, canvas.columns-1)
+border.draw(canvas)
+
+# Draw gold axes with arrow-heads.
+axes = Magick::Draw.new
+axes.fill_opacity(0)
+axes.stroke('gold3')
+axes.stroke_width(4)
+axes.stroke_linecap('round')
+axes.stroke_linejoin('round')
+axes.polyline(18,canvas.rows-10, 10,canvas.rows-3, 3,canvas.rows-10,
+              10,canvas.rows-10, 10,10, canvas.columns-10,10,
+              canvas.columns-10,3, canvas.columns-3,10, canvas.columns-10, 18)
+axes.draw(canvas)
+
+# Draw a red circle to show the direction of rotation.
+# Make it slightly transparent so the hatching will show through.
+circle = Magick::Draw.new
+circle.stroke('tomato')
+circle.fill_opacity(0)
+circle.stroke_opacity(0.75)
+circle.stroke_width(6)
+circle.stroke_linecap('round')
+circle.stroke_linejoin('round')
+circle.ellipse(canvas.rows/2,canvas.columns/2, 80, 80, 0, 315)
+circle.polyline(180,70, 173,78, 190,78, 191,62)
+circle.draw(canvas)
+
+# Label the axes and the circle.
+labels = Magick::Draw.new
+labels.fill('black')
+labels.stroke('transparent')
+labels.font_family('helvetica')
+labels.font_style(Magick::ItalicStyle)
+labels.pointsize(14)
+labels.gravity(Magick::NorthWestGravity)
+labels.text(20,30, "'0,0'")
+labels.gravity(Magick::NorthEastGravity)
+labels.text(20,30, "'+x'")
+labels.gravity(Magick::SouthWestGravity)
+labels.text(20,20, "'+y'")
+labels.gravity(Magick::CenterGravity)
+labels.text(0,0, "Rotation")
+labels.draw(canvas)
+
+#canvas.display
+canvas.write("axes.gif")
+exit

data/doc/ex/bilevel_channel.rb

@@ -0,0 +1,20 @@
+#! /usr/local/bin/ruby -w
+
+require 'RMagick'
+include Magick
+
+img = Image.read('images/Flower_Hat.jpg').first
+
+begin
+
+result = img.bilevel_channel(2*MaxRGB/3, RedChannel)
+
+# Substitute the standard "Not Implemented" image
+rescue NotImplementedError
+    result = Magick::Image.read("images/notimplemented.gif").first
+    result.resize!(img.columns, img.rows)
+end
+
+result.write('bilevel_channel.jpg')
+exit
+

data/doc/ex/blur_image.rb

@@ -0,0 +1,12 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#blur_image method
+
+img = Magick::Image.read('images/Flower_Hat.jpg').first
+
+# Make a blurry copy.
+img = img.blur_image(0.0,2.5)
+
+img.write('blur_image.jpg')
+exit

data/doc/ex/border.rb

@@ -0,0 +1,10 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#border method
+
+img = Magick::Image.read('images/Flower_Hat.jpg').first
+
+img.border!(10,10,'rgb(255,110,140)')
+img.write('border.jpg')
+exit

data/doc/ex/bounding_box.rb

@@ -0,0 +1,48 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+i = Magick::ImageList.new
+i.new_image(200, 200) { self.background_color = "#ffffcc" }
+
+# Draw a blue circle.
+primitives = Magick::Draw.new
+primitives.stroke_width 5
+primitives.stroke "blue"
+primitives.fill_opacity 0
+primitives.circle 100,100, 100,150
+primitives.draw i
+
+# Get the bounding box. Use the values to draw
+# a gray square surrounding the circle. Highlight
+# the corners with tiny red circles.
+
+bb = i.bounding_box
+primitives = Magick::Draw.new
+primitives.stroke "gray50"
+primitives.fill_opacity 0
+primitives.rectangle bb.x, bb.y, bb.x+bb.width, bb.y+bb.height
+primitives.stroke "red"
+primitives.circle bb.x, bb.y, bb.x+2, bb.y+2
+primitives.circle bb.x+bb.width, bb.y, bb.x+bb.width+2, bb.y+2
+primitives.circle bb.x, bb.y+bb.height, bb.x+2, bb.y+bb.height+2
+primitives.circle bb.x+bb.width, bb.y+bb.height, bb.x+bb.width+2, bb.y+bb.height+2
+
+
+primitives.pointsize 10
+primitives.fill "black"
+primitives.stroke "transparent"
+primitives.gravity Magick::NorthWestGravity
+primitives.text bb.x-15, bb.y-5, "\'#{bb.x},#{bb.y}\'"
+primitives.gravity Magick::NorthEastGravity
+primitives.text bb.x-15, bb.y-5, "\'#{bb.x+bb.width},#{bb.y}\'"
+primitives.gravity Magick::SouthWestGravity
+primitives.text bb.x-15, bb.y-12, "\'#{bb.x},#{bb.y+bb.height}\'"
+primitives.gravity Magick::SouthEastGravity
+primitives.text bb.x-15, bb.y-12, "\'#{bb.x+bb.width},#{bb.y+bb.height}\'"
+
+
+primitives.draw i
+
+#i.display
+i.write "bounding_box.gif"
+exit

data/doc/ex/cbezier1.rb

@@ -0,0 +1,40 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+imgl = Magick::ImageList.new
+imgl.new_image(390, 140, Magick::HatchFill.new('white','lightcyan2'))
+gc = Magick::Draw.new
+
+# Draw Bezier curve
+gc.stroke('red')
+gc.stroke_width(2)
+gc.fill_opacity(0)
+gc.bezier(20,120, 20,20, 320, 20, 320,120)
+
+# Draw circles around endpoints
+gc.fill_opacity(0)
+gc.stroke('gray50').stroke_width(1)
+gc.circle(20,120, 23, 123)
+gc.circle(320,120, 323, 123)
+
+# Draw filled circles around control points
+gc.line(20,120, 20,20)
+gc.line(320,120, 320,20)
+gc.fill_opacity(1)
+gc.fill('gray50')
+gc.circle(20,20, 23,23)
+gc.circle(320,20, 323,23)
+
+# Annotate
+gc.fill('black')
+gc.stroke('transparent')
+gc.text(27,120, "'20,120'")
+gc.text(27,20, "'20,20'")
+gc.text(327,120, "'320,120'")
+gc.text(327,20, "'320,20'")
+gc.draw(imgl)
+
+imgl.border!(1, 1, "lightcyan2")
+imgl.write('cbezier1.gif')
+exit(0)
+