rmagick 1.7.1

data/doc/ex/color_fill_to_border.rb

@@ -0,0 +1,29 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#color_fill_to_border method
+
+before = Magick::Image.new(200,200) {
+    self.background_color = 'white'
+    self.border_color = 'black'
+    }
+before.border!(1,1,'black')
+
+circle = Magick::Draw.new
+circle.fill('transparent')
+circle.stroke('black')
+circle.stroke_width(2)
+circle.circle(100,100,180,100)
+circle.fill('plum1')
+circle.stroke('transparent')
+circle.circle( 60,100, 40,100)
+circle.circle(140,100,120,100)
+circle.circle(100, 60,100, 40)
+circle.circle(100,140,100,120)
+circle.draw(before)
+
+before.write('color_fill_to_border_before.gif')
+
+after = before.color_fill_to_border(100,100, 'aquamarine')
+after.write('color_fill_to_border_after.gif')
+exit

data/doc/ex/color_floodfill.rb

@@ -0,0 +1,28 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#color_floodfill method
+
+before = Magick::Image.new(200,200) { self.background_color = 'white' }
+before.border!(1,1,'black')
+
+circle = Magick::Draw.new
+circle.fill('transparent')
+circle.stroke_width(2)
+circle.stroke('black')
+circle.circle(100,100,180,100)
+circle.fill('plum1')
+circle.stroke('transparent')
+circle.circle( 60,100, 40,100)
+circle.circle(140,100,120,100)
+circle.circle(100, 60,100, 40)
+circle.circle(100,140,100,120)
+circle.draw(before)
+
+before.write('color_floodfill_before.gif')
+
+aquamarine = Magick::Pixel.from_color('aquamarine')
+after = before.color_floodfill(100,100, aquamarine)
+
+after.write('color_floodfill_after.gif')
+exit

data/doc/ex/color_histogram.rb

@@ -0,0 +1,60 @@
+#! /usr/local/bin/ruby -w
+
+require 'RMagick'
+include Magick
+
+NUM_COLORS = 256
+HIST_HEIGHT = 200
+
+img = Image.read('images/Hot_Air_Balloons_H.jpg').first
+img = img.quantize(NUM_COLORS)
+
+begin
+    hist = img.color_histogram
+rescue NotImplementedError
+    img = Image.read('images/notimplemented.gif').first
+    img.write('color_histogram.gif')
+    exit
+end
+
+# sort pixels by increasing count
+begin
+    pixels = hist.keys.sort_by {|pixel| hist[pixel] }
+rescue NameError    # No sort_by?
+    pixels = hist.keys.sort { |p, q| hist[p] <=> hist[q] }
+end
+
+scale = HIST_HEIGHT / (hist.values.max*1.025)   # put 2.5% air at the top
+
+gc = Draw.new
+gc.stroke_width(1)
+gc.affine(1, 0, 0, -scale, 0, HIST_HEIGHT)
+
+# handle images with fewer than NUM_COLORS colors
+start = NUM_COLORS - img.number_colors
+
+pixels.each { |pixel|
+    gc.stroke(pixel.to_color)
+    gc.line(start, 0, start, hist[pixel])
+    start = start.succ
+}
+
+hatch = HatchFill.new("white", "gray95")
+canvas = Image.new(NUM_COLORS, HIST_HEIGHT, hatch)
+gc.draw(canvas)
+
+text = Draw.new
+text.annotate(canvas, 0, 0, 0, 20, "Color Frequency\nHistogram") {
+    self.pointsize = 10
+    self.gravity = NorthGravity
+    self.stroke = 'transparent'
+    }
+
+canvas.border!(1, 1, "white")
+canvas.border!(1, 1, "black")
+canvas.border!(3, 3, "white")
+#canvas.display
+canvas.write("color_histogram.gif")
+
+exit
+

data/doc/ex/color_reset.rb

@@ -0,0 +1,11 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#color_reset! method
+
+f = Magick::Image.new(100,100) { self.background_color = 'white' }
+red = Magick::Pixel.from_color('red')
+f.color_reset!(red)
+#f.display
+f.write('color_reset.gif')
+exit

data/doc/ex/colorize.rb

@@ -0,0 +1,16 @@
+#!/usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#colorize method by converting
+# a full-color image to "sepia-tone"
+
+img = Magick::Image.read('images/Flower_Hat.jpg').first
+
+# Convert the color image to monochrome
+mono = img.quantize(256, Magick::GRAYColorspace)
+
+# Colorize with a 30% blend of a brownish-orange color
+colorized = mono.colorize(0.30, 0.30, 0.30, '#cc9933')
+
+colorized.write('colorize.jpg')
+exit

data/doc/ex/colors.rb

@@ -0,0 +1,65 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+include Magick
+
+puts("Creating colors.miff. This may take a few seconds...")
+
+colors = ImageList.new
+
+# Add a row of "null" colors so we'll have
+# room to add the title at the top.
+4.times { colors.read('null:') }
+
+puts("\tCreating color swatches...")
+
+# Create a 200x25 image for each named color.
+# Label with the name, RGB values, and compliance type.
+colors { |c|
+    if c.name !~ /grey/ then    # omit SVG 'grays'
+        colors.new_image(200, 25) {
+            self.background_color = c.color
+            self.border_color = 'gray50'
+            }
+        rgb  = sprintf('#%02x%02x%02x', c.color.red&0xff,  c.color.green&0xff, c.color.blue&0xff)
+        rgb += sprintf('%02x', c.color.opacity&0xff) if c.color.opacity != 0
+        m = /(.*?)Compliance/.match c.compliance.to_s
+        colors.cur_image['Label'] = "#{c.name} (#{rgb}) #{m[1]}"
+    end
+}
+
+puts("\tCreating montage...")
+
+# Montage. Each image will have 40 tiles.
+# There will be 16 images.
+montage = colors.montage {
+    self.geometry = '200x25+10+5'
+    self.gravity = CenterGravity
+    self.tile = '4x10'
+    self.background_color = 'black'
+    self.border_width = 1
+    self.fill = 'white'
+    self.stroke = 'transparent'
+}
+
+# Add the title at the top, over the 'null:'
+# tiles we added at the very beginning.
+title = Draw.new
+title.annotate(montage, 0,0,0,20, 'Named Colors') {
+    self.font_family = 'Helvetica'
+    self.fill = 'white'
+    self.stroke = 'transparent'
+    self.pointsize = 32
+    self.font_weight = BoldWeight
+    self.gravity = NorthGravity
+}
+
+puts("\tWriting ./colors.miff")
+montage.each { |f| f.compression = ZipCompression }
+montage.write('colors.miff')
+
+# Make a small sample of the full montage to display in the HTML file.
+sample = montage[8].crop(55, 325, 495, 110)
+sample.page = Rectangle.new(495,110)
+sample.write('colors.gif')
+
+exit

data/doc/ex/composite.rb

@@ -0,0 +1,135 @@
+#! /usr/local/bin/ruby -w
+
+# Demonstrate the effects of various composite operators.
+# Based on ImageMagick's composite test.
+
+require 'RMagick'
+include Magick
+
+ROWS = 70
+COLS = 70
+COLOR_A = "#999966"
+COLOR_B = "#990066"
+
+img = Image.new(COLS, ROWS)
+triangle = Draw.new
+triangle.fill(COLOR_A)
+triangle.stroke('transparent')
+triangle.polygon(0,0, COLS,0, 0,ROWS, 0,0)
+triangle.draw(img)
+image_A = img.transparent('white', TransparentOpacity)
+image_A['Label'] = 'A'
+
+img = Image.new(COLS, ROWS)
+triangle = Draw.new
+triangle.fill(COLOR_B)
+triangle.stroke('transparent')
+triangle.polygon(0,0, COLS,ROWS, COLS,0, 0,0)
+triangle.draw(img)
+image_B = img.transparent('white', TransparentOpacity)
+image_B['Label'] = 'B'
+
+list = ImageList.new
+null = Image.read("xc:white") { self.size = Geometry.new(COLS,ROWS) }
+null = null.first.transparent('white', TransparentOpacity)
+null.border_color = 'transparent'
+granite =  Image.read("granite:")
+
+list << null.copy
+list << image_A
+list << image_B
+list << null.copy
+
+
+list << image_B.composite(image_A, CenterGravity, OverCompositeOp)
+list.cur_image['Label'] = 'A over B'
+list << image_A.composite(image_B, CenterGravity, OverCompositeOp)
+list.cur_image['Label'] = 'B over A'
+
+list << image_B.composite(image_A, CenterGravity, InCompositeOp)
+list.cur_image['Label'] = 'A in B'
+list << image_A.composite(image_B, CenterGravity, InCompositeOp)
+list.cur_image['Label'] = 'B in A'
+
+list << image_B.composite(image_A, CenterGravity, OutCompositeOp)
+list.cur_image['Label'] = 'A out B'
+list << image_A.composite(image_B, CenterGravity, OutCompositeOp)
+list.cur_image['Label'] = 'B out A'
+
+list << image_B.composite(image_A, CenterGravity, AtopCompositeOp)
+list.cur_image['Label'] = 'A atop B'
+list << image_A.composite(image_B, CenterGravity, AtopCompositeOp)
+list.cur_image['Label'] = 'B atop A'
+
+list << image_B.composite(image_A, CenterGravity, XorCompositeOp)
+list.cur_image['Label'] = 'A xor B'
+
+list << image_B.composite(image_A, CenterGravity, MultiplyCompositeOp)
+list.cur_image['Label'] = 'A multiply B'
+
+list << image_B.composite(image_A, CenterGravity, ScreenCompositeOp)
+list.cur_image['Label'] = 'A screen B'
+
+list << image_B.composite(image_A, CenterGravity, DarkenCompositeOp)
+list.cur_image['Label'] = 'A darken B'
+
+list << image_B.composite(image_A, CenterGravity, LightenCompositeOp)
+list.cur_image['Label'] = 'A lighten B'
+
+list << image_B.composite(image_A, CenterGravity, PlusCompositeOp)
+list.cur_image['Label'] = 'A plus B'
+
+list << image_B.composite(image_A, CenterGravity, MinusCompositeOp)
+list.cur_image['Label'] = 'A minus B'
+
+list << image_B.composite(image_A, CenterGravity, AddCompositeOp)
+list.cur_image['Label'] = 'A add B'
+
+list << image_B.composite(image_A, CenterGravity, SubtractCompositeOp)
+list.cur_image['Label'] = 'A subtract B'
+
+list << image_B.composite(image_A, CenterGravity, DifferenceCompositeOp)
+list.cur_image['Label'] = 'A difference B'
+
+list << image_B.composite(image_A, CenterGravity, HueCompositeOp)
+list.cur_image['Label'] = 'A hue B'
+
+list << image_B.composite(image_A, CenterGravity, SaturateCompositeOp)
+list.cur_image['Label'] = 'A saturate B'
+
+list << image_B.composite(image_A, CenterGravity, LuminizeCompositeOp)
+list.cur_image['Label'] = 'A luminize B'
+
+list << image_B.composite(image_A, CenterGravity, ColorizeCompositeOp)
+list.cur_image['Label'] = 'A colorize B'
+
+list << image_B.composite(image_A, CenterGravity, BumpmapCompositeOp)
+list.cur_image['Label'] = 'A bumpmap B'
+
+list << image_B.composite(image_A, CenterGravity, DissolveCompositeOp)
+list.cur_image['Label'] = 'A dissolve B'
+
+list << image_B.composite(image_A, CenterGravity, ThresholdCompositeOp)
+list.cur_image['Label'] = 'A threshold B'
+
+list << image_B.composite(image_A, CenterGravity, ModulateCompositeOp)
+list.cur_image['Label'] = 'A modulate B'
+
+list << image_A.composite(image_B, CenterGravity, ModulateCompositeOp)
+list.cur_image['Label'] = 'B modulate A'
+
+list << image_B.composite(image_A, CenterGravity, OverlayCompositeOp)
+list.cur_image['Label'] = 'A overlay B'
+
+montage = list.montage {
+    self.geometry = Geometry.new(COLS, ROWS, 3, 3)
+    rows = (list.size+3) / 4
+    self.tile = Geometry.new(4, rows)
+    self.texture = granite[0]
+    self.fill = 'white'
+    self.stroke = 'transparent'
+}
+
+montage.write('composite.gif')
+exit
+

data/doc/ex/contrast.rb

@@ -0,0 +1,37 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#contrast method
+
+img = Magick::ImageList.new('images/Flower_Hat.jpg')
+img.resize!(0.5)
+
+# Prepare to label each image with a number from 1 to 4
+legend = Magick::Draw.new
+legend.font_family = 'Helvetica'
+legend.stroke = 'transparent'
+legend.pointsize = 12
+legend.gravity = Magick::SouthEastGravity
+
+# Add 3 images, each one having slightly less contrast
+f = 1
+3.times {
+    img << img.contrast
+
+    # Annotate the previous image
+    legend.annotate(img[f-1], 0,0,7,10, f.to_s)
+    f += 1
+    }
+
+# Annotate the last image
+legend.annotate(img, 0,0,7,10, f.to_s)
+
+# Montage into a single image
+imgs = img.montage {
+    self.geometry = Magick::Geometry.new(img.columns, img.rows)
+    self.tile = "2x2"
+    }
+
+imgs.write('contrast.jpg')
+#imgs.display
+exit

data/doc/ex/crop.rb

@@ -0,0 +1,31 @@
+#!/usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#crop method
+
+img = Magick::Image.read('images/Flower_Hat.jpg')[0]
+
+# Crop the specified rectangle out of the img.
+chopped = img.crop(23, 81, 107, 139)
+
+# Go back to the original and highlight the area
+# corresponding to the retained rectangle.
+rect = Magick::Draw.new
+rect.stroke('transparent')
+rect.fill('white')
+rect.fill_opacity(0.25)
+rect.rectangle(23, 81, 107+23, 139+81)
+rect.draw(img)
+
+img.write('crop_before.jpg')
+
+# Create a image to use as a background for
+# the "after" image.
+bg = Magick::Image.new(img.columns, img.rows)
+
+# Composite the the "after" (chopped) image on the background
+bg = bg.composite(chopped, 23, 81, Magick::OverCompositeOp)
+
+bg.write('crop_after.jpg')
+
+exit

data/doc/ex/crop_with_gravity.rb

@@ -0,0 +1,46 @@
+#! /usr/local/bin/ruby -w
+
+#=======================================================#
+# Thanks to Robert Wagner for the idea of allowing a    #
+# GravityType instead of the x- and y-offset arguments! #
+#=======================================================#
+
+# Demo the use of the GravityType argument to Image#crop.
+
+require 'RMagick'
+include Magick
+
+shorts = Image.read('images/Shorts.jpg').first
+
+regwidth = shorts.columns/2
+regheight = shorts.rows/2
+
+mask = Image.new(regwidth, regheight) { self.background_color = 'white'}
+mask.opacity = 0.50 * TransparentOpacity
+
+black = Image.new(shorts.columns, shorts.rows) {self.background_color = 'black'}
+pairs = ImageList.new
+
+[NorthWestGravity, NorthGravity, NorthEastGravity,
+ WestGravity, CenterGravity, EastGravity,
+ SouthWestGravity, SouthGravity, SouthEastGravity].each do |gravity|
+    pattern = shorts.composite(mask, gravity, OverCompositeOp)
+    cropped = shorts.crop(gravity, regwidth, regheight)
+    result = black.composite(cropped, gravity, OverCompositeOp)
+    result.border_color = "white"
+    pairs << pattern
+    pairs << result
+end
+
+# Montage into a single image
+montage = pairs.montage {
+    self.geometry = "#{pairs.columns}x#{pairs.rows}+0+0"
+    self.tile = "6x3"
+    self.border_width = 1
+    }
+montage.write('crop_with_gravity.miff')
+#montage.display
+
+
+
+