rmagick 1.7.1

data/doc/ex/stroke_linecap.rb

@@ -0,0 +1,44 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+imgl = Magick::ImageList.new
+imgl.new_image(615, 100)
+
+gc = Magick::Draw.new
+gc.stroke('black').stroke_width(30)
+
+# Draw thick line with "butt" linecap
+gc.stroke_linecap('butt')
+gc.line(25,50, 175,50)
+
+# Draw thick line with "round" linecap
+gc.stroke_linecap('round')
+gc.line(225,50, 375,50)
+
+# Draw thick line with "square" linecap
+gc.stroke_linecap('square')
+gc.line(425,50, 575,50)
+
+# Show line endpoints in pink
+gc.fill('lightpink')
+gc.stroke('lightpink').stroke_width(3)
+gc.line(25,50, 175,50)
+gc.circle(25,50, 27,52).circle(175,50,177,52)
+gc.line(225,50, 375,50)
+gc.circle(225,50, 227,52).circle(375,50,377,52)
+gc.line(425,50, 575, 50)
+gc.circle(425,50, 427,52).circle(575,50,577,52)
+
+# Annotate
+gc.fill('black')
+gc.stroke('transparent')
+gc.pointsize(14)
+gc.font_weight(Magick::BoldWeight)
+
+gc.text(55,90, "\"'butt' cap\"")
+gc.text(250,90, "\"'round' cap\"")
+gc.text(450,90, "\"'square' cap\"")
+
+gc.draw(imgl)
+
+imgl.write("stroke_linecap.gif")

data/doc/ex/stroke_linejoin.rb

@@ -0,0 +1,48 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+imgl = Magick::ImageList.new
+imgl.new_image(400, 150) { self.background_color = 'white' }
+
+gc = Magick::Draw.new
+
+gc.stroke('black').stroke_width(15)
+gc.fill_opacity(0)
+gc.stroke_linecap('butt')
+
+# Draw lines with miter join
+gc.stroke_linejoin('miter')
+gc.polyline(25,100, 75,25, 125,100)
+
+# Draw lines with round join
+gc.stroke_linejoin('round')
+gc.polyline(150,100, 200,25, 250,100)
+
+# Draw lines with bevel join
+gc.stroke_linejoin('bevel')
+gc.polyline(275,100, 325,25, 375,100)
+
+# Show line endpoints in pink
+gc.fill('lightpink').fill_opacity(0)
+gc.stroke('lightpink').stroke_width(2)
+gc.stroke_linejoin('miter')
+gc.polyline(25,100, 75,25, 125,100)
+gc.polyline(150,100, 200,25, 250,100)
+gc.polyline(275,100, 325,25, 375,100)
+gc.fill_opacity(1)
+gc.circle(75,25, 76,26)
+gc.circle(200,25, 201,26)
+gc.circle(325,25, 326,26)
+
+# Annotate
+gc.fill('black')
+gc.stroke('transparent')
+gc.pointsize(14)
+gc.font_weight(Magick::BoldWeight)
+gc.text(35,120, "\"'miter' join\"")
+gc.text(160,120, "\"'round' join\"")
+gc.text(280,120, "\"'bevel' join\"")
+
+gc.draw(imgl)
+
+imgl.write("stroke_linejoin.gif")

data/doc/ex/stroke_width.rb

@@ -0,0 +1,47 @@
+#! /usr/local/bin/ruby -w
+
+require 'RMagick'
+
+imgl = Magick::ImageList.new
+imgl.new_image(500,80, Magick::HatchFill.new('white','lightcyan2'))
+
+gc = Magick::Draw.new
+
+# Draw 5-pixel wide line
+gc.stroke('LightPink')
+gc.stroke_width(5)
+gc.line(10,30, 130,30)
+
+# Draw 10-pixel wide line
+gc.stroke('LightSkyBlue2')
+gc.stroke_width(10)
+gc.line(130,30, 230,30)
+
+# Draw 20-pixel wide line
+gc.stroke('GreenYellow')
+gc.stroke_width(20)
+gc.line(230,30,370,30)
+
+# Draw 40-pixel wide line
+gc.stroke('MediumOrchid2')
+gc.stroke_width(40)
+gc.line(370,30,490,30)
+
+# Draw 1-pixel wide line through the center
+gc.stroke('black')
+gc.stroke_width(1)
+gc.line(10,30,490,30)
+
+# Annotate
+gc.fill('black')
+gc.stroke('transparent')
+gc.text(60,70,"'5'")
+gc.text(180,70,"'10'")
+gc.text(300,70,"'20'")
+gc.text(420,70,"'40'")
+
+gc.draw(imgl)
+imgl.border!(1,1,"lightcyan2")
+
+imgl.write('stroke_width.gif')
+exit

data/doc/ex/swirl.rb

@@ -0,0 +1,17 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#swirl method
+
+img = Magick::Image.read('images/Flower_Hat.jpg').first
+
+# Make an animated image.
+animation = Magick::ImageList.new
+animation << img.copy
+30.step(360,45) { |degrees| animation << img.swirl(degrees) }
+
+animation.delay = 20
+animation.iterations = 10000
+
+animation.write('swirl.gif')
+exit

data/doc/ex/text.rb

@@ -0,0 +1,32 @@
+#! /usr/local/bin/ruby -w
+
+require 'RMagick'
+
+imgl = Magick::ImageList.new
+imgl.new_image(190,190)
+
+sample = Magick::Draw.new
+sample.stroke('transparent')
+sample.font_family('times')
+sample.pointsize(24)
+
+sample.font_style(Magick::NormalStyle)
+sample.text(20,40, 'NormalStyle')
+
+sample.font_style(Magick::ItalicStyle)
+sample.text(20,70, 'ItalicStyle')
+
+sample.font_style(Magick::ObliqueStyle)
+sample.text(20,100, 'ObliqueStyle')
+
+sample.font_style(Magick::NormalStyle)
+sample.font_weight(Magick::BoldWeight)
+sample.text(20,130, 'BoldWeight')
+
+sample.font_weight(Magick::LighterWeight)
+sample.text(20,160, 'LighterWeight')
+
+sample.draw(imgl)
+
+imgl.write('text.gif')
+exit

data/doc/ex/text_align.rb

@@ -0,0 +1,36 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Draw#text_align method
+
+canvas = Magick::Image.new(200, 100)
+gc = Magick::Draw.new
+
+# Draw three samples of text, each using
+# a different alignment constant. Put the
+# samples on different points on the y-axis
+# so we can tell them apart.
+gc.stroke('transparent')
+gc.pointsize(16)
+gc.fill('red')
+gc.text_align(Magick::RightAlign)
+gc.text(100, 30,  'RightAlign')
+gc.fill('blue')
+gc.text_align(Magick::CenterAlign)
+gc.text(100, 50, 'CenterAlign')
+gc.fill('green')
+gc.text_align(Magick::LeftAlign)
+gc.text(100, 70, 'LeftAlign')
+
+# Now draw lines to show the points
+# to which each sample is aligned.
+gc.stroke('gray50')
+gc.line(100, 10, 100, 90)
+gc.line( 98, 30, 102, 30)
+gc.line( 98, 50, 102, 50)
+gc.line( 98, 70, 102, 70)
+
+gc.draw(canvas)
+canvas.border!(1,1,'gray50')
+canvas.write('text_align.gif')
+exit

data/doc/ex/text_antialias.rb

@@ -0,0 +1,33 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+imgl = Magick::ImageList.new
+imgl.new_image(275, 170) { self.background_color = "white" }
+
+gc = Magick::Draw.new
+gc.fill('black')
+gc.stroke('transparent')
+
+gc.font_family('courier')
+gc.font_weight(Magick::BoldWeight)
+gc.pointsize(200)
+
+# Turn off antialiasing
+gc.text_antialias(false)
+gc.text(15, 145, 'A')
+
+# Turn it back on
+gc.text_antialias(true)
+gc.text(145, 145, 'A')
+
+gc.draw(imgl)
+
+# Blow up the image so we can
+# easily see the image, then
+# crop to a representative portion.
+imgl.resize!(3).crop!(235,270, 365,180)
+imgl.page = Magick::Rectangle.new(365, 180)
+imgl.border!(1,1,"black")
+imgl.write("text_antialias.gif")
+exit
+

data/doc/ex/text_undercolor.rb

@@ -0,0 +1,26 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Draw#text_undercolor method
+
+canvas = Magick::Image.new(250, 100)  {self.background_color ='white'}
+
+gc = Magick::Draw.new
+
+gc.stroke('transparent')
+gc.pointsize(16)
+gc.gravity(Magick::CenterGravity)
+
+gc.text_undercolor('cyan')
+gc.text(0,-20,"text_undercolor('cyan')")
+
+gc.text_undercolor('yellow')
+gc.text(0,0,"text_undercolor('yellow')")
+
+gc.text_undercolor('pink')
+gc.text(0,20,"text_undercolor('pink')")
+
+gc.draw(canvas)
+
+canvas.write('text_undercolor.gif')
+exit

data/doc/ex/texture_fill_to_border.rb

@@ -0,0 +1,34 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#texture_fill_to_border method
+# This example is nearly identical to the color_fill_to_border example.
+
+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.compression = Magick::LZWCompression
+before.write('texture_fill_to_border_before.gif')
+
+# Use the builtin 'rose' image as the texture fill.
+rose = Magick::Image.read('rose:').first
+after = before.texture_fill_to_border(100,100, rose)
+
+after.write('texture_fill_to_border_after.gif')
+exit

data/doc/ex/texture_floodfill.rb

@@ -0,0 +1,31 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#texture_floodfill method
+# This example is nearly identical to the color_floodfill example.
+
+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.compression = Magick::LZWCompression
+before.write('texture_floodfill_before.gif')
+
+rose = Magick::Image.read('rose:').first
+before.fuzz = 25
+after = before.texture_floodfill(100,100, rose)
+
+after.write('texture_floodfill_after.gif')
+exit

data/doc/ex/texturefill.rb

@@ -0,0 +1,25 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Magick::TextureFill class.
+
+granite = Magick::Image.read('granite:').first
+fill = Magick::TextureFill.new(granite)
+img = Magick::ImageList.new
+img.new_image(300, 100, fill)
+
+# Annotate the filled image with the code that created the fill.
+
+ann = Magick::Draw.new
+ann.annotate(img, 0,0,0,0, "TextureFill.new(granite)") {
+    self.gravity = Magick::CenterGravity
+    self.fill = 'white'
+    self.font_weight = Magick::BoldWeight
+    self.stroke = 'transparent'
+    self.pointsize = 14
+    }
+
+#img.display
+img.write("texturefill.gif")
+exit
+

data/doc/ex/threshold.rb

@@ -0,0 +1,13 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the Image#threshold method
+
+img = Magick::Image.read('images/Flower_Hat.jpg').first
+
+# Use a threshold of 55% of MaxRGB.
+img = img.threshold(Magick::MaxRGB*0.55)
+
+#img.display
+img.write('threshold.jpg')
+exit

data/doc/ex/to_blob.rb

@@ -0,0 +1,14 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+before = Magick::Image.read("images/Flower_Hat.jpg").first
+before.resize!(0.50)  # make it small so this example will run fast
+
+blob = before.to_blob
+# We could pass the format, depth, and geometry as optional
+# arguments to `from_blob' but that is not required.
+after = Magick::Image.from_blob(blob)
+
+after[0].write("to_blob.gif")
+exit
+

data/doc/ex/translate.rb

@@ -0,0 +1,37 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+imgl = Magick::ImageList.new
+imgl.new_image(250, 250, Magick::HatchFill.new('white','lightcyan2'))
+
+gc = Magick::Draw.new
+gc.stroke('red')
+gc.stroke_width(2)
+
+# Move the origin to the center.
+gc.translate(125, 125)
+max_x = imgl.columns/2
+max_y = imgl.rows/2
+
+# Draw down-pointing arrow
+gc.line(0, -max_y,   0, max_y)
+gc.line(0,  max_y,  10, max_y-10)
+gc.line(0,  max_y, -10, max_y-10)
+
+# Draw right-pointing arrow
+gc.line(-max_x, 0, max_x,     0)
+gc.line( max_x, 0, max_x-10, -10)
+gc.line( max_x, 0, max_x-10,  10)
+
+# Add labels
+gc.fill('black')
+gc.stroke('transparent')
+gc.text(8, 15, "'0,0'")
+gc.text(110, 16, "x")
+gc.text(12, 115, "y")
+
+gc.draw(imgl)
+
+imgl.border!(1,1, "lightcyan2")
+
+imgl.write("translate.gif")