rmagick 1.7.1

data/doc/ex/edge.rb

@@ -0,0 +1,11 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#edge method
+
+img = Magick::Image.read('images/Flower_Hat.jpg').first
+
+img = img.edge(5)
+
+img.write('edge.jpg')
+exit

data/doc/ex/ellipse.rb

@@ -0,0 +1,43 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+imgl = Magick::ImageList.new
+imgl.new_image(360, 250, Magick::HatchFill.new('white','LightCyan2'))
+
+gc = Magick::Draw.new
+
+gc.fill_opacity(0)
+gc.stroke('red').stroke_width(3)
+
+# Draw ellipse
+gc.ellipse(180,125, 150,75, 0, 270)
+
+# Draw horizontal width line
+gc.stroke('gray50').stroke_width(1)
+gc.line(180-150, 125, 180, 125)
+
+# Draw vertical height line
+gc.line(180, 125-75, 180, 125)
+gc.fill_opacity(0)
+
+# Draw arcStart circle
+gc.circle(180+150, 125, 180+150+3, 125+3)
+
+# Draw arcEnd circle
+gc.circle(180, 125-75, 180+3, 125-75+3)
+
+# Annotate
+gc.fill_opacity(1)
+gc.circle(180,125, 183,128)
+gc.fill('black')
+gc.stroke('transparent')
+gc.text(187,125, "'180,125'")
+gc.text(253, 118, "'Start 0 degrees'")
+gc.text(187, 50, "'End 270 degrees'")
+gc.text(120, 100, "'Height=75'")
+gc.text(85, 140, "'Width=150'")
+gc.draw(imgl)
+
+imgl.border!(1,1, "LightCyan2")
+
+imgl.write("ellipse.gif")

data/doc/ex/emboss.rb

@@ -0,0 +1,11 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#edge method
+
+img = Magick::Image.read('images/Flower_Hat.jpg').first
+
+img = img.emboss
+
+img.write('emboss.jpg')
+exit

data/doc/ex/enhance.rb

@@ -0,0 +1,28 @@
+#!/usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#enhance method
+
+img = Magick::Image.read('images/Flower_Hat.jpg').first
+img = img.add_noise(Magick::UniformNoise)
+
+eimg = img.enhance
+
+# Zoom in so we can see the change
+img.resize!(3)
+eimg.resize!(3)
+
+# Make a before-and-after composite
+eimg.crop!(Magick::EastGravity, eimg.columns/2, eimg.rows)
+img = img.composite(eimg, Magick::EastGravity, Magick::OverCompositeOp)
+
+# Draw a black line between the before and after parts.
+line = Magick::Draw.new
+line.line(img.columns/2, 0, img.columns/2, img.rows)
+line.draw(img)
+
+# Crop everything but the face.
+img.crop!(Magick::CenterGravity, 250, 200)
+
+img.write('enhance.jpg')
+exit

data/doc/ex/equalize.rb

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

data/doc/ex/flatten_images.rb

@@ -0,0 +1,38 @@
+#! /usr/local/bin/ruby -w
+
+# Demonstrate flatten_images method. Create an image with a drop-shadow effect.
+
+require 'RMagick'
+
+RMagick = 'RMagick'
+
+i = Magick::ImageList.new
+
+# Create a background image with a gradient fill
+i.new_image(200, 100, Magick::GradientFill.new(100,50, 100, 50, "khaki1", "turquoise"))
+
+# Create a transparent image for the text shadow
+i.new_image(200, 100) { self.background_color = 'transparent' }
+primitives = Magick::Draw.new
+primitives.annotate i, 0, 0, 2, 2, RMagick do
+    self.pointsize = 32
+    self.font = "Helvetica"
+    self.fill = "gray50"
+    self.gravity = Magick::CenterGravity
+    end
+
+# Create another transparent image for the text itself
+i.new_image(200, 100) { self.background_color = 'transparent' }
+primitives = Magick::Draw.new
+primitives.annotate i, 0, 0, -2, -2, RMagick do
+    self.pointsize = 32
+    self.font = "Helvetica"
+    self.fill = "red"
+    self.stroke = "black"
+    self.gravity = Magick::CenterGravity
+    end
+
+# Flatten all 3 into a single image.
+# i.display
+i.flatten_images.write "flatten_images.gif"
+exit

data/doc/ex/flip.rb

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

data/doc/ex/flop.rb

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

data/doc/ex/fonts.rb

@@ -0,0 +1,20 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Compute column widths
+name_length = 0
+family_length = 0
+Magick::fonts { |font|
+    if font.name.length > name_length
+        name_length = font.name.length
+    end
+    if font.family.length > family_length
+        family_length = font.family.length
+    end
+}
+
+# Print all fonts
+Magick::fonts { |font|
+    printf("%-*s %-*s %d %s\t%s\n", name_length, font.name,
+        family_length, font.family, font.weight, font.style, font.stretch)
+}

data/doc/ex/frame.rb

@@ -0,0 +1,12 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#frame method
+
+img = Magick::Image.read('images/Flower_Hat.jpg').first
+
+img.matte_color="gray75"
+img = img.frame
+
+img.write('frame.jpg')
+exit

data/doc/ex/gaussian_blur.rb

@@ -0,0 +1,11 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#gaussian_blur method
+
+img = Magick::Image.read('images/Flower_Hat.jpg').first
+
+img = img.gaussian_blur(0.0, 3.0)
+
+img.write('gaussian_blur.jpg')
+exit

data/doc/ex/get_multiline_type_metrics.rb

@@ -0,0 +1,53 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+include Magick
+
+TEXT = 'get\nmultiline\ntype\nmetrics'
+
+background = Image.new(200, 200)
+gc = Draw.new
+
+# Draw the text centered on the background
+gc.annotate(background, 0, 0, 0, 0, TEXT) do |gc|
+    gc.font_family = 'Verdana'
+    gc.pointsize = 36
+    gc.gravity = CenterGravity
+    gc.stroke = 'none'
+end
+
+begin
+
+    # Get the metrics
+    metrics = gc.get_multiline_type_metrics(background, TEXT)
+
+    # Compute the corners for a rectangle surrounding the text
+    x = (background.columns - metrics.width) / 2
+    y = (background.rows - metrics.height) / 2
+
+    # Draw 2 rectangles over the text.
+    gc = Draw.new
+    gc.stroke('red')
+    gc.stroke_width(5)
+    gc.stroke_linejoin('round')
+    gc.fill('cyan')
+    gc.fill_opacity(0.10)
+    gc.rectangle(x, y, x+metrics.width, y+metrics.height)
+
+    gc.stroke('white')
+    gc.stroke_width(1)
+    gc.fill('none')
+    gc.rectangle(x, y, x+metrics.width, y+metrics.height)
+    gc.draw(background)
+
+    background.border!(1,1, 'blue')
+
+# Substitute the standard "Not Implemented" image
+rescue NotImplementedError
+    not_implemented = Magick::Image.read("images/notimplemented.gif").first
+    not_implemented.resize!(background.columns, background.rows)
+    background = not_implemented
+end
+
+background.write('get_multiline_type_metrics.gif')
+

data/doc/ex/get_pixels.rb

@@ -0,0 +1,48 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate partial transparency and the get_pixels and
+# store_pixels methods by creating an image that goes from
+# full-color on the left to monochrome on the right.
+
+# Read the colorful picture of a rock formation. Scale
+# it to 300 pixels high because we don't want a big picture.
+rocks = Magick::Image.read('images/Red_Rocks.jpg').first
+rocks.scale!(250.0/rocks.rows)
+
+# Make a monochrome copy. See Image#quantize for details
+grayrocks = rocks.quantize(256, Magick::GRAYColorspace)
+
+rows = grayrocks.rows
+cols = grayrocks.columns
+
+# Create an array of opacity values, proceeding from
+# transparent to opaque. The array should have as many
+# elements as there are columns in the image. The first
+# element should be TransparentOpacity and each succeeding
+# element slightly more opaque than its predecessor.
+step = Magick::TransparentOpacity / cols.to_f
+opacity_steps = Array.new(cols)
+cols.times { |x|
+    opacity_steps[x] = Magick::TransparentOpacity - Integer(x * step)
+    if opacity_steps[x] < Magick::OpaqueOpacity
+        opacity_steps[x] = Magick::OpaqueOpacity
+    end
+}
+
+# Get each row of pixels from the mono image.
+# Copy the pre-computed opacity values to the pixels.
+# Store the pixels back.
+rows.times { |y|
+    pixels = grayrocks.get_pixels(0, y, cols, 1)
+    pixels.each_with_index { |p,x| p.opacity = opacity_steps[x] }
+    grayrocks.store_pixels(0, y, cols, 1, pixels)
+}
+
+# Composite the mono version of the image over the color version.
+grayrocks.matte = true
+combine = rocks.composite(grayrocks, Magick::CenterGravity, Magick::OverCompositeOp)
+#combine.display
+combine.write 'get_pixels.jpg'
+exit
+

data/doc/ex/get_type_metrics.rb

@@ -0,0 +1,140 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+include Magick
+
+# Add a method for drawing braces.
+class Draw
+
+    # (w,h) - width & height of rectangle enclosing brace.
+    # Normally the brace is drawn with its opening to the
+    # left and its lower point on the origin.
+    #
+    # Set w < 0 to draw right-opening brace. Set h < 0 to
+    # position top point at origin.
+    #
+    # The placement & orientation is affected by the
+    # current user coordinate system.
+    def brace(w, h)
+        raise(ArgumentError, "width must be != 0") unless w != 0
+        raise(ArgumentError, "height must be != 0") unless h != 0
+        path("M0,0 Q#{w},0 #{w/2.0},#{-h/4.0} T#{w},#{-h/2.0}" +
+             "Q0,#{-h/2.0} #{w/2.0},#{-(3.0*h/4.0)} T0,#{-h}")
+    end
+
+end     # class Draw
+
+
+
+
+Origin_x = 110
+Origin_y = 220
+Glyph = 'g'
+
+canvas = Image.new(410,300,HatchFill.new('white', 'lightcyan2'))
+
+# Draw a big lowercase 'g' on the canvas. Leave room on all sides for
+# the labels. Use 'undercolor' to set off the glyph.
+glyph = Draw.new
+glyph.annotate(canvas, 0, 0, Origin_x, Origin_y, Glyph) do |opts|
+    opts.pointsize = 124
+    opts.stroke = 'none'
+    opts.fill = 'black'
+    opts.font_family = 'Times'
+    opts.undercolor = '#ffff00c0'
+end
+
+# Call get_type_metrics. This is what this example's all about.
+metrics = glyph.get_type_metrics(canvas, Glyph)
+
+gc = Draw.new
+
+# Draw the origin as a big red dot.
+gc.stroke('red')
+gc.fill('red')
+gc.circle(Origin_x, Origin_y, Origin_x, Origin_y+2)
+
+# All our lines will be medium-gray, dashed, and thin.
+gc.stroke('gray50')
+gc.stroke_dasharray(5,2)
+gc.stroke_width(1)
+gc.fill('none')
+
+# baseline
+gc.line(Origin_x-10, Origin_y, Origin_x+metrics.width+20, Origin_y)
+
+# a vertical line through the origin
+gc.line(Origin_x, 30, Origin_x, 270)
+
+# descent
+gc.line(Origin_x-10, Origin_y-metrics.descent, Origin_x+metrics.width+20, Origin_y-metrics.descent)
+
+# ascent
+gc.line(Origin_x-10, Origin_y-metrics.ascent, Origin_x+metrics.width+20, Origin_y-metrics.ascent)
+
+# height
+gc.line(Origin_x-10, Origin_y-metrics.height, Origin_x+metrics.width+10, Origin_y-metrics.height)
+
+# width
+gc.line(Origin_x+metrics.width, 30, Origin_x+metrics.width, 270)
+
+# max_advance
+gc.line(Origin_x+metrics.max_advance, Origin_y-metrics.descent-10,
+        Origin_x+metrics.max_advance, 270)
+
+gc.draw(canvas)
+
+# Draw the braces and labels. Position the braces by transforming the
+# user coordinate system with translate and rotate methods.
+gc = Draw.new
+gc.font_family('Times')
+gc.pointsize(13)
+gc.fill('none')
+gc.stroke('black')
+gc.stroke_width(1)
+
+# between origin and descent
+gc.push
+gc.translate(Origin_x+metrics.width+23, Origin_y)
+gc.brace(10, metrics.descent)
+gc.pop
+
+# between origin and ascent
+gc.push
+gc.translate(Origin_x+metrics.width+23, Origin_y)
+gc.brace(10, metrics.ascent)
+gc.pop
+
+# between origin and height
+gc.push
+gc.translate(Origin_x-13, Origin_y-metrics.height)
+gc.rotate(180)
+gc.brace(10, metrics.height)
+gc.pop
+
+# between origin and width
+gc.push
+gc.translate(Origin_x+metrics.width, 27.0)
+gc.rotate(-90)
+gc.brace(10, metrics.width)
+gc.pop
+
+# between origin and max_advance
+gc.push
+gc.translate(Origin_x, Origin_y-metrics.descent+14)
+gc.rotate(90)
+gc.brace(10, metrics.max_advance)
+gc.pop
+
+# Add labels
+gc.stroke('none')
+gc.fill('black')
+gc.text(Origin_x+metrics.width+40, Origin_y-(metrics.ascent/2)+4, 'ascent')
+gc.text(Origin_x+metrics.width+40, Origin_y-(metrics.descent/2)+4, 'descent')
+gc.text(Origin_x-60, Origin_y-metrics.height/2+4, 'height')
+gc.text(Origin_x+(metrics.width/2)-15, 15, 'width')
+gc.text(Origin_x+(metrics.max_advance)/2-38, 290, "max_advance")
+
+gc.draw(canvas)
+canvas.border!(1,1,'blue')
+canvas.write('get_type_metrics.gif')
+