rmagick 1.7.4 → 1.8.0

data/doc/ex/InitialCoords.rb

@@ -0,0 +1,24 @@
+require 'rvg/rvg'
+include Magick
+
+rvg = RVG.new(300, 100) do |canvas|
+    canvas.desc = "Example InitialCoords - SVG's initial coordinate system"
+    canvas.background_fill = 'white'
+    canvas.g.styles(:fill=>'none', :stroke=>'black', :stroke_width=>3) do |grp|
+        grp.line(0, 1.5, 300, 1.5)
+        grp.line(1.5, 0, 1.5, 100)
+    end
+    canvas.g.styles(:fill=>'red', :stroke=>'none') do |grp|
+        grp.rect(3, 3)
+        grp.rect(3, 3, 297,  0)
+        grp.rect(3, 3,   0, 97)
+    end
+    canvas.g.styles(:font_size=>14, :font_family=>'Verdana') do |grp|
+        grp.text(10, 20, '(0,0)')
+        grp.text(240, 20, '(300,0)')
+        grp.text(10, 90, '(0,100)')
+    end
+end
+
+rvg.draw.write('InitialCoords.gif')
+

data/doc/ex/NewCoordSys.rb

@@ -0,0 +1,33 @@
+require 'rvg/rvg'
+include Magick
+
+rvg = RVG.new(400, 150) do |canvas|
+    canvas.background_fill = 'white'
+    canvas.desc = 'Example NewCoordSys - New user coordinate system'
+    canvas.g.styles(:fill=>'none', :stroke=>'black', :stroke_width=>3) do |grp|
+        # Draw the axes of the original coordinate system
+        grp.line(0, 1.5, 400, 1.5)
+        grp.line(1.5, 0, 1.5, 150)
+    end
+
+    canvas.g do |grp|
+        grp.text(30, 30, 'ABC (orig coord system)').styles(:font_size=>20, :font_family=>'Verdana')
+    end
+
+    # Establish a new coordinate system, which is
+    # shifted (i.e., translated) from the initial coordinate
+    # system by 50 user units along each axis.
+    canvas.g.translate(50, 50) do |grp|
+        grp.g.styles(:fill=>'none', :stroke=>'red', :stroke_width=>3) do |grp2|
+            # Draw lines of length 50 user units along
+            # the axes of the new coordinate system
+            grp2.line(0, 0, 50, 0)
+            grp2.line(0, 0, 0, 50)
+        end
+        grp.text(30, 30, 'ABC (translated coord system)').styles(:font_size=>20, :font_family=>'Verdana')
+    end
+
+end
+
+rvg.draw.write('NewCoordSys.gif')
+

data/doc/ex/OrigCoordSys.rb

@@ -0,0 +1,19 @@
+require 'rvg/rvg'
+include Magick
+
+rvg = RVG.new(400, 150) do |canvas|
+    canvas.desc = "Example OrigCoordSys - Simple transformations: original picture"
+    canvas.background_fill = 'white'
+
+    canvas.g.styles(:fill=>'none', :stroke=>'black', :stroke_width=>3) do |grp|
+        # Draw the axes of the original coordinate system
+        grp.line(0, 1.5, 400, 1.5)
+        grp.line(1.5, 0, 1.5, 150)
+    end
+
+    canvas.text(30, 30, 'ABC (orig coord system)').styles(:font_size=>20, :font_family=>'Verdana')
+
+end
+
+rvg.draw.write('OrigCoordSys.gif')
+

data/doc/ex/PreserveAspectRatio.rb

@@ -0,0 +1,206 @@
+require 'rvg/rvg'
+include Magick
+
+rvg = RVG.new(450, 300) do |canvas|
+    canvas.desc = 'Example Preserve Aspect Ratio'
+    canvas.background_fill = 'white'
+
+    canvas.rect(448, 298, 1, 1).styles(:fill=>'none', :stroke=>'blue')
+
+    # Define the smiley-face
+    smile = RVG::Group.new do |grp|
+        grp.translate(0, 5)
+        grp.circle(10, 15, 15).styles(:fill=>'yellow', :stroke=>'none')
+        grp.circle(1.5, 12, 12).styles(:fill=>'black', :stroke=>'none')
+        grp.circle(1.5, 17, 12).styles(:fill=>'black', :stroke=>'none')
+        grp.path("M10 19 A 8 8 0 0 0 20 19").styles(:stroke=>'black', :stroke_width=>2)
+    end
+
+    viewport1 = RVG::Group.new do |grp|
+        grp.rect(49, 29, 0.5, 0.5).styles(:fill => 'none', :stroke => 'blue')
+    end
+
+    viewport2 = RVG::Group.new do |grp|
+        grp.rect(29, 39, 0.5, 0.5).styles(:fill=>'black', :stroke=>'red')
+    end
+
+    # SVG to fit
+    grp = canvas.g.styles(:font_size=>9) do |grp|
+        grp.text(10, 30, "SVG to fit")
+        grp.g.translate(20, 40) do |grp2|
+            grp2.use(viewport2)
+            grp2.use(smile)
+        end
+
+        # Viewport 1
+        grp.g.translate(10, 120) do |grp2|
+           grp2.use(viewport1)
+        end
+        grp.text(10, 110, 'Viewport 1')
+
+        # Viewport 2
+        grp.g.translate(20, 190) do |grp2|
+           grp2.rect(29, 50, 0.5, 0.5).styles(:fill => 'none', :stroke => 'blue')
+        end
+        grp.text(10, 180, 'Viewport 2')
+
+        # meet-group-1
+        grp.g.translate(100, 60) do |grp2|
+            grp2.text(0, -30, "--------------- meet ---------------")
+            grp2.g do |grp3|
+                grp3.text(0, -10, "xMin*")
+                grp3.use(viewport1)
+
+                # xMin
+                grp3.rvg(50, 30).viewbox(0,0,30,40).preserve_aspect_ratio('xMinYMin', 'meet') do |canvas2|
+                    canvas2.rect(29, 39, 0.5, 0.5).styles(:fill => 'black', :stroke => 'red')
+                    canvas2.use(smile)
+                end
+            end
+
+            # xMid
+            grp2.g.translate(70, 0) do |grp3|
+                grp3.text(0, -10, "xMid*")
+                grp3.use(viewport1)
+                grp3.rvg(50, 30).viewbox(0, 0, 30, 40).preserve_aspect_ratio('xMidYMid', 'meet') do |canvas2|
+                    canvas2.rect(29, 39, 0.5, 0.5).styles(:fill => 'black', :stroke => 'red')
+                    canvas2.use(smile)
+                end
+            end
+
+            # xMax
+            grp2.g.translate(0, 70) do |grp3|
+                grp3.text(0, -10, "xMax*")
+                grp3.use(viewport1)
+                grp3.rvg(50, 30).viewbox(0,0,30,40).preserve_aspect_ratio('xMaxYMax', 'meet') do |canvas2|
+                    canvas2.rect(29, 39, 0.5, 0.5).styles(:fill => 'black', :stroke => 'red')
+                    canvas2.use(smile)
+                end
+            end
+        end
+
+        # meet-group-2
+        grp.g.translate(250, 60) do |grp2|
+            grp2.text(0, -30, "--------------- meet ---------------")
+
+            # xMin
+            grp2.g do |grp3|
+                grp3.text(0, -10, "*YMin")
+                grp3.rect(29, 59, 0.5, 0.5).styles(:fill => 'none', :stroke => 'blue')
+                grp3.rvg(30, 60).viewbox(0,0,30,40).preserve_aspect_ratio('xMinYMin', 'meet') do |canvas2|
+                    canvas2.use(viewport2)
+                    canvas2.use(smile)
+                end
+            end
+
+            # xMid
+            grp2.g.translate(50, 0) do |grp3|
+                grp3.text(0, -10, "*YMid")
+                grp3.rect(29, 59, 0.5, 0.5).styles(:fill => 'none', :stroke => 'blue')
+                grp3.rvg(30, 60).viewbox(0, 0, 30, 40).preserve_aspect_ratio('xMidYMid', 'meet') do |canvas2|
+                    canvas2.use(viewport2)
+                    canvas2.use(smile)
+                end
+            end
+
+            # xMax
+            grp2.g.translate(100, 0) do |grp3|
+                grp3.text(0, -10, "*YMax")
+                grp3.rect(29, 59, 0.5, 0.5).styles(:fill => 'none', :stroke => 'blue')
+                grp3.rvg(30, 60).viewbox(0,0,30,40).preserve_aspect_ratio('xMaxYMax', 'meet') do |canvas2|
+                    canvas2.rect(29, 39, 0.5, 0.5).styles(:fill => 'black', :stroke => 'red')
+                    canvas2.use(smile)
+                end
+            end
+        end
+
+        # slice-group-1
+        grp.g.translate(100, 220) do |grp2|
+            grp2.text(0, -30, "--------------- slice ---------------")
+
+            # xMin
+            grp2.g do |grp3|
+                grp3.text(0, -10, "xMin*")
+                grp3.rect(29, 59, 0.5, 0.5).styles(:fill => 'none', :stroke => 'blue')
+                grp3.rvg(30, 60) do |canvas2|
+                    canvas2.preserve_aspect_ratio('xMinYMin', 'slice')
+                    canvas2.viewbox(0,0,30,40)
+                    canvas2.use(viewport2)
+                    canvas2.use(smile)
+                end
+            end
+
+            # xMid
+            grp2.g do |grp3|
+                grp3.text(0, -10, "xMid*")
+                grp3.translate(50, 0)
+                grp3.rect(29, 59, 0.5, 0.5).styles(:fill => 'none', :stroke => 'blue')
+                grp3.rvg(30, 60) do |canvas2|
+                    canvas2.preserve_aspect_ratio('xMidYMid', 'slice')
+                    canvas2.viewbox(0,0,30,40)
+                    canvas2.rect(29, 39, 0.5, 0.5).styles(:fill => 'black', :stroke => 'red')
+                    canvas2.use(smile)
+                end
+            end
+
+            # xMax
+            grp2.g do |grp3|
+                grp3.text(0, -10, "xMax*")
+                grp3.translate(100, 0)
+                grp3.rect(29, 59, 0.5, 0.5).styles(:fill => 'none', :stroke => 'blue')
+                grp3.rvg(30, 60) do |canvas2|
+                    canvas2.preserve_aspect_ratio('xMaxYMax', 'slice')
+                    canvas2.viewbox(0,0,30,40)
+                    canvas2.rect(29, 39, 0.5, 0.5).styles(:fill => 'black', :stroke => 'red')
+                    canvas2.use(smile)
+                end
+            end
+        end
+
+        # slice-group-2
+        grp.g.translate(250, 200) do |grp2|
+            grp2.text(0, -30, "--------------- slice ---------------")
+
+            # YMin
+            grp2.g do |grp3|
+                grp3.text(0, -10, "*YMin")
+                grp3.use(viewport1)
+                grp3.rvg(50, 30) do |canvas2|
+                    canvas2.preserve_aspect_ratio('xMinYMin', 'slice')
+                    canvas2.viewbox(0,0,30,40)
+                    canvas2.rect(29, 39, 0.5, 0.5).styles(:fill => 'black', :stroke => 'red')
+                    canvas2.use(smile)
+                end
+            end
+
+            # YMid
+            grp2.g do |grp3|
+                grp3.text(0, -10, "*YMid")
+                grp3.translate(70, 0)
+                grp3.use(viewport1)
+                grp3.rvg(50, 30) do |canvas2|
+                    canvas2.preserve_aspect_ratio('xMidYMid', 'slice')
+                    canvas2.viewbox(0,0,30,40)
+                    canvas2.rect(29, 39, 0.5, 0.5).styles(:fill => 'black', :stroke => 'red')
+                    canvas2.use(smile)
+                end
+            end
+
+            # YMax
+            grp2.g do |grp3|
+                grp3.text(0, -10, "*YMax")
+                grp3.translate(140, 0)
+                grp3.use(viewport1)
+                grp3.rvg(50, 30) do |canvas2|
+                    canvas2.preserve_aspect_ratio('xMaxYMax', 'slice')
+                    canvas2.viewbox(0,0,30,40)
+                    canvas2.rect(29, 39, 0.5, 0.5).styles(:fill => 'black', :stroke => 'red')
+                    canvas2.use(smile)
+                end
+            end
+        end
+    end
+end
+
+rvg.draw.write('PreserveAspectRatio.gif')
+

data/doc/ex/RotateScale.rb

@@ -0,0 +1,38 @@
+require 'rvg/rvg'
+include Magick
+
+rvg = RVG.new(400, 120) do |canvas|
+    canvas.desc = 'Example RotateScale - Rotate and scale transforms'
+    canvas.background_fill = 'white'
+    canvas.g.styles(:fill=>'none', :stroke=>'black', :stroke_width=>3) do |grp|
+        # Draw the axes of the original coordinate system
+        grp.line(0, 1.5, 400, 1.5)
+        grp.line(1.5, 0, 1.5, 120)
+    end
+    # Establish a new coordinate system whose origin is at (50,30)
+    # in the original coord. system and which is rotated by 30 degrees.
+    canvas.g.translate(50,30) do |grp|
+        grp.g.rotate(30) do |grp2|
+            grp2.g.styles(:fill=>'none',:stroke=>'red',:stroke_width=>3) do |grp3|
+                grp3.line(0, 0, 50, 0)
+                grp3.line(0, 0, 0, 50)
+            end
+            grp2.text(0, 0, "ABC (rotate)").styles(:font_size=>20, :fill=>'blue', :font_family=>'Verdana')
+        end
+    end
+
+    # Establish a new coordinate system whose origin is at (200,40)
+    # in the original coord. systm and which is scaled by 1.5
+    canvas.g.translate(200,40) do |grp|
+        grp.g.scale(1.5) do |grp2|
+            grp2.g.styles(:fill=>'none',:stroke=>'red',:stroke_width=>3) do |grp3|
+                grp3.line(0, 0, 50, 0)
+                grp3.line(0, 0, 0, 50)
+            end
+            grp2.text(0, 0, "ABC (scale)").styles(:font_size=>20, :fill=>'blue', :font_family=>'Verdana')
+        end
+    end
+end
+
+rvg.draw.write('RotateScale.gif')
+

data/doc/ex/Skew.rb

@@ -0,0 +1,39 @@
+require 'rvg/rvg'
+include Magick
+
+rvg = RVG.new(400, 120) do |canvas|
+    canvas.desc = 'Example Skew - Show effects of skewX and skewY'
+    canvas.background_fill = 'white'
+
+    canvas.g.styles(:fill=>'none',:stroke=>'black',:stroke_width=>3) do |grp|
+        # Draw the axes of the original coordinate system
+        grp.line(0, 1.5, 400, 1.5)
+        grp.line(1.5, 0, 1.5, 120)
+    end
+
+    # Establisha new coordinate system whose origin is at (30,30)
+    # in the initial coord. system and which is skewed in X by 30 degrees.
+    canvas.g.translate(30,30) do |grp|
+        grp.skewX(30) do |grp2|
+            grp2.g.styles(:fill=>'none', :stroke=>'red', :stroke_width=>3) do |grp3|
+                grp3.line(0, 0, 50, 0)
+                grp3.line(0, 0, 0, 50)
+            end
+            grp.text(0, 0, 'ABC (skewX)').styles(:font_size=>20, :fill=>'blue', :font_family=>'Verdana')
+        end
+    end
+
+    # Establish a new coordinate system whose origin is at (200,30)
+    # in the initial coord. system and which is skewed in Y by 30 degrees.
+    canvas.g.translate(200,30) do |grp|
+        grp.skewY(30) do |grp2|
+            grp2.g.styles(:fill=>'none', :stroke=>'red', :stroke_width=>3) do |grp3|
+                grp3.line(0, 0, 50, 0)
+                grp3.line(0, 0, 0, 50)
+            end
+            grp.text(0, 0, 'ABC (skewY)').styles(:font_size=>20, :fill=>'blue', :font_family=>'Verdana')
+        end
+    end
+end
+
+rvg.draw.write('Skew.gif')

data/doc/ex/Use01.rb

@@ -0,0 +1,17 @@
+require 'rvg/rvg'
+include Magick
+
+RVG.dpi = 90
+
+rvg = RVG.new(10.cm, 3.cm).viewbox(0, 0, 100, 30) do |canvas|
+    canvas.background_fill = 'white'
+    canvas.desc = "Example Use01 - Simple case of 'use' on a 'rect'"
+    r = RVG::Group.new do |grp|
+            grp.rect(60, 10)
+        end
+    canvas.rect(99.6, 29.6, 0.1, 0.1).styles(:fill=>'none', :stroke=>'blue', :stroke_width=>0.2)
+    canvas.use(r, 20, 10)
+end
+
+rvg.draw.write('Use01.gif')
+

data/doc/ex/Use02.rb

@@ -0,0 +1,22 @@
+require 'rvg/rvg'
+include Magick
+
+RVG.dpi = 90
+
+rvg = RVG.new(10.cm, 3.5.cm).viewbox(0, 0, 100, 35) do |canvas|
+    canvas.background_fill = 'white'
+    canvas.desc = "Example Use02 - Chain 'styles' to 'use'"
+    r = RVG::Group.new do |grp|
+            grp.rect(60, 10).styles(:fill=>'yellow')
+        end
+    canvas.rect(99.6, 34.6, 0.1, 0.1).styles(:fill=>'none', :stroke=>'blue', :stroke_width=>0.2)
+
+    # Since the rectangle specified the fill color the :fill style is ignored here.
+    # However, since the rectangle did not specify a stroke color, the :stroke style
+    # specified here is respected.
+    canvas.use(r, 20, 5).styles(:fill=>'green', :stroke=>'red')
+    canvas.use(r, 20, 20).styles(:fill=>'green', :stroke=>'blue')
+end
+
+rvg.draw.write('Use02.gif')
+

data/doc/ex/Use03.rb

@@ -0,0 +1,17 @@
+require 'rvg/rvg'
+include Magick
+
+RVG.dpi = 90
+
+rvg = RVG.new(10.cm, 3.cm).viewbox(0, 0, 100, 30) do |canvas|
+    canvas.background_fill = 'white'
+    canvas.desc = "Example Use03 - 'use' with a 'transform' attribute"
+
+    myrect = RVG::Group.new do |grp|
+                 grp.rect(60, 10)
+             end
+    canvas.rect(99.6, 29.6, 0.1, 0.1).styles(:fill=>'none', :stroke=>'blue', :stroke_width=>0.2)
+    canvas.use(myrect).translate(20,2.5).rotate(10)
+end
+
+rvg.draw.write('Use03.gif')

data/doc/ex/ViewBox.rb

@@ -0,0 +1,34 @@
+require 'rvg/rvg'
+include Magick
+
+def example(cols, rows)
+    rvg = RVG.new(cols, rows) do |canvas|
+        canvas.background_fill = 'white'
+        canvas.desc = <<-'END_DESC'
+            Example ViewBox - uses the viewBox attribute to automatically create an
+            initial user coordinate system which causes the graphic to scale to fit
+            into the viewport no matter what size the viewport is.
+            END_DESC
+
+        canvas.viewbox(0, 0, 1500, 1000)
+        canvas.preserve_aspect_ratio('none')
+
+        # This rectangle goes from (0,0) to (1500,1000) in user space.
+        # Because of the viewBox attribute above,
+        # the rectangle will end up filling the entire area
+        # reserved for the SVG content.
+        canvas.rect(1500, 1000).styles(:fill=>'yellow',:stroke=>'blue',:stroke_width=>12)
+
+        # A large, red triangle
+        canvas.path("M 750,100 L 250,900 L 1250,900 z").styles(:fill=>'red')
+
+        # A text string that spans most of the viewport
+        canvas.text(100, 600, 'Stretch to fit').styles(:font_size=>200, :font_family=>'Verdana')
+
+    end
+    return rvg.draw
+end
+
+example(300, 200).write('ViewBox_300x200.gif')
+example(150, 200).write('ViewBox_150x200.gif')
+