rmagick-windows 2.16.1

data/doc/ex/enhance.rb

@@ -0,0 +1,28 @@
+#!/usr/bin/env 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/bin/env 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/evenodd.rb

@@ -0,0 +1,42 @@
+#!/usr/bin/env ruby -w
+require 'rvg/rvg'
+
+Magick::RVG.dpi = 90
+
+rvg = Magick::RVG.new(12.cm, 4.cm).viewbox(0, 0, 1200, 400) do |canvas|
+  canvas.background_fill = 'white'
+  canvas.desc = "Example fillrule - nonzero - demonstrates fill_rule=>'nonzero'"
+
+  canvas.rect(1195, 393, 1, 1).styles(:fill=>'none', :stroke=>'blue')
+
+  triangle = Magick::RVG::Group.new do |defs|
+    defs.path('M 16,0 L -8,9 v-18 z').styles(:fill=>'black', :stroke=>'none')
+  end
+
+  canvas.g.styles(:clip_rule=>'evenodd', :fill=>'red', :stroke=>'black', :stroke_width=>3) do |grp|
+    grp.path('M 250,75 L 323,301 131,161 369,161 177,301 z')
+    grp.use(triangle).translate(306.21, 249).rotate(72)
+    grp.use(triangle).translate(175.16,193.2).rotate(216)
+    grp.use(triangle).translate(314.26,161).rotate(0)
+    grp.use(triangle).translate(221.16,268.8).rotate(144)
+    grp.use(triangle).translate(233.21,126.98).rotate(288)
+    grp.path('M 600,81 A 107,107 0 0,1 600,295 A 107,107 0 0,1 600,81 z' \
+             'M 600,139 A 49,49 0 0,1 600,237 A 49,49 0 0,1 600,139 z')
+    grp.use(triangle).translate(600,188).rotate(0).translate(107,0).rotate(90)
+    grp.use(triangle).translate(600,188).rotate(120).translate(107,0).rotate(90)
+    grp.use(triangle).translate(600,188).rotate(240).translate(107,0).rotate(90)
+    grp.use(triangle).translate(600,188).rotate(60).translate(49,0).rotate(90)
+    grp.use(triangle).translate(600,188).rotate(180).translate(49,0).rotate(90)
+    grp.use(triangle).translate(600,188).rotate(300).translate(49,0).rotate(90)
+    grp.path('M 950,81 A 107,107 0 0,1 950,295 A 107,107 0 0,1 950,81 z' \
+             'M 950,139 A 49,49 0 0,0 950,237 A 49,49 0 0,0 950,139 z')
+    grp.use(triangle).translate(950,188).rotate(0).translate(107,0).rotate(90)
+    grp.use(triangle).translate(950,188).rotate(120).translate(107,0).rotate(90)
+    grp.use(triangle).translate(950,188).rotate(240).translate(107,0).rotate(90)
+    grp.use(triangle).translate(950,188).rotate(60).translate(49,0).rotate(-90)
+    grp.use(triangle).translate(950,188).rotate(180).translate(49,0).rotate(-90)
+    grp.use(triangle).translate(950,188).rotate(300).translate(49,0).rotate(-90)
+  end
+end
+
+rvg.draw.write('evenodd.gif')

data/doc/ex/fill_pattern.rb

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby -w
+require 'rmagick'
+
+# Demonstrate the Magick::Draw#fill_pattern and #stroke_pattern attributes.
+
+temp = Magick::ImageList.new
+temp << Magick::Image.new(5, 10) {self.background_color = 'black'}
+temp << Magick::Image.new(5, 10) {self.background_color = 'gold'}
+stroke_pattern = temp.append(false)
+
+img = Magick::Image.new(280, 250) {self.background_color = 'none'}
+
+gc = Magick::Draw.new
+gc.annotate(img, 0, 0, 0, 0, "PATT\nERNS") do
+  self.gravity = Magick::CenterGravity
+  self.font_weight = Magick::BoldWeight
+  self.pointsize = 100
+  self.fill_pattern = Magick::Image.read('images/Flower_Hat.jpg').first
+  self.stroke_width = 5
+  self.stroke_pattern = stroke_pattern
+end
+
+img.write('fill_pattern.gif')

data/doc/ex/flatten_images.rb

@@ -0,0 +1,36 @@
+#!/usr/bin/env 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.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.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/bin/env 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/bin/env 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/font_styles.rb

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby -w
+require 'rvg/rvg'
+
+rvg = Magick::RVG.new(200, 250) do |canvas|
+  canvas.background_fill = 'white'
+
+  canvas.g do |grp|
+    grp.g.styles(:font_weight=>'normal', :font_style=>'normal') do |grp2|
+      grp2.text(10, 30, 'default size')
+      grp2.text(10, 50, ':font_size=>14').styles(:font_size=>14)
+      grp2.text(10, 70, ':font_size=>16').styles(:font_size=>16)
+      grp2.text(10,100, ':font_size=>24').styles(:font_size=>24)
+    end
+  end
+
+  canvas.g.styles(:font_size=>14, :font_weight=>'normal', :font_style=>'normal') do |grp|
+    if RUBY_PLATFORM =~ /mswin32/
+      grp.text( 8, 120, ":font_family=>'Courier-New'").styles(:font_family=>'Courier-New')
+    else
+      grp.text( 8, 120, ":font_family=>'Courier'").styles(:font_family=>'Courier')
+    end
+    grp.text(10, 140, ":font_weight=>'bold'").styles(:font_weight=>'bold')
+    grp.text(10, 160, ":font_stretch=>'normal'").styles(:font_stretch=>'normal')
+    grp.text(10, 180, ":font_stretch=>'condensed'").styles(:font_stretch=>'condensed')
+    grp.text(10, 200, ":font_style=>'italic'").styles(:font_style=>'italic')
+    grp.text(10, 220, ':font_weight=>900').styles(:font_weight=>900)
+  end
+
+  canvas.rect(199, 249).styles(:fill=>'none', :stroke=>'blue')
+end
+
+rvg.draw.write('font_styles.gif')

data/doc/ex/fonts.rb

@@ -0,0 +1,20 @@
+#!/usr/bin/env ruby -w
+require 'rmagick'
+
+# Compute column widths
+name_length = 0
+family_length = 0
+Magick.fonts do |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
+end
+
+# Print all fonts
+Magick.fonts do |font|
+  printf("%-*s %-*s %d %s\t%s\n", name_length, font.name,
+         family_length, font.family, font.weight, font.style, font.stretch)
+end

data/doc/ex/frame.rb

@@ -0,0 +1,12 @@
+#!/usr/bin/env 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/bin/env 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,41 @@
+#!/usr/bin/env ruby -w
+require 'rmagick'
+
+TEXT = 'get\nmultiline\ntype\nmetrics'
+
+background = Magick::Image.new(200, 200)
+gc = Magick::Draw.new
+
+# Draw the text centered on the background
+gc.annotate(background, 0, 0, 0, 0, TEXT) do
+  gc.font_family = 'Verdana'
+  gc.pointsize = 36
+  gc.gravity = Magick::CenterGravity
+  gc.stroke = 'none'
+end
+
+# 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 = Magick::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')
+
+background.write('get_multiline_type_metrics.gif')

data/doc/ex/get_pixels.rb

@@ -0,0 +1,47 @@
+#!/usr/bin/env 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 do |x|
+  opacity_steps[x] = Magick::TransparentOpacity - Integer(x * step)
+  if opacity_steps[x] < Magick::OpaqueOpacity
+    opacity_steps[x] = Magick::OpaqueOpacity
+  end
+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 do |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)
+end
+
+# 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,141 @@
+#!/usr/bin/env ruby -w
+require 'rmagick'
+
+# Add a method for drawing braces.
+module Magick
+  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)
+      fail(ArgumentError, 'width must be != 0') unless w != 0
+      fail(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
+end
+
+Origin_x = 110
+Origin_y = 230
+Glyph = 'g'
+Face = RUBY_PLATFORM =~ /mswin/ ? 'Verdana' : 'Times'
+
+canvas = Magick::Image.new(410, 320, Magick::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 = Magick::Draw.new
+glyph.annotate(canvas, 0, 0, Origin_x, Origin_y, Glyph) do
+  glyph.pointsize = 124
+  glyph.stroke = 'none'
+  glyph.fill = 'black'
+  glyph.font_family = Face
+  glyph.undercolor = '#ffff00c0'
+end
+
+# Call get_type_metrics. This is what this example's all about.
+metrics = glyph.get_type_metrics(canvas, Glyph)
+
+gc = Magick::Draw.new
+gc.translate(Origin_x, Origin_y)
+
+# Draw the origin as a big red dot.
+gc.stroke('red')
+gc.fill('red')
+gc.circle(0, 0, 0, 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(-10, 0, metrics.width+20, 0)
+
+# a vertical line through the origin
+gc.line(0, -metrics.descent-metrics.height-10, 0, -metrics.descent+15)
+
+# descent
+gc.line(-10, -metrics.descent, metrics.width+20, -metrics.descent)
+
+# ascent
+gc.line(-10, -metrics.ascent, metrics.width+20, -metrics.ascent)
+
+# height
+gc.line(-10, -metrics.descent-metrics.height,
+        metrics.width+10, -metrics.descent-metrics.height)
+
+# width
+gc.line(metrics.width, -metrics.descent-metrics.height-10,
+        metrics.width, -metrics.descent+20)
+
+# max_advance
+gc.line(metrics.max_advance, -10, metrics.max_advance, -metrics.descent+20)
+
+gc.draw(canvas)
+
+# Draw the braces and labels. Position the braces by transforming the
+# user coordinate system with translate and rotate methods.
+gc = Magick::Draw.new
+gc.font_family('Face')
+gc.pointsize(13)
+gc.fill('none')
+gc.stroke('black')
+gc.stroke_width(1)
+gc.translate(Origin_x, Origin_y)
+
+# between origin and descent
+gc.push
+gc.translate(metrics.width+23, 0)
+gc.brace(10, metrics.descent)
+gc.pop
+
+# between origin and ascent
+gc.push
+gc.translate(metrics.width+23, 0)
+gc.brace(10, metrics.ascent)
+gc.pop
+
+# between origin and height
+gc.push
+gc.translate(-13, -metrics.descent-metrics.height)
+gc.rotate(180)
+gc.brace(10, metrics.height)
+gc.pop
+
+# between origin and width
+gc.push
+gc.translate(metrics.width, -metrics.descent-metrics.height-10-3)
+gc.rotate(-90)
+gc.brace(10, metrics.width)
+gc.pop
+
+# between origin and max_advance
+gc.push
+gc.translate(0, -metrics.descent+15)
+gc.rotate(90)
+gc.brace(10, metrics.max_advance)
+gc.pop
+
+# Add labels
+gc.font_weight(Magick::NormalWeight)
+gc.font_style(Magick::NormalStyle)
+gc.stroke('none')
+gc.fill('black')
+gc.text(metrics.width+40, -(metrics.ascent/2)+4, 'ascent')
+gc.text(metrics.width+40, -(metrics.descent/2)+4, 'descent')
+gc.text(-60, -metrics.descent-metrics.height/2+4, 'height')
+gc.text((metrics.width/2)-15, -metrics.descent-metrics.height-25, 'width')
+gc.text((metrics.max_advance)/2-38, -metrics.descent+35, 'max_advance')
+
+gc.draw(canvas)
+canvas.border!(1,1,'blue')
+canvas.write('get_type_metrics.gif')