Class: Magick::RVG::PathData

Inherits:
Object
  • Object
show all
Defined in:
lib/rvg/pathdata.rb

Overview

The PathData class provides an object-oriented way to produce an SVG path. Each of the methods corresponds to a path command. Construct a path by calling one or more methods. The path object can be passed as an argument to the RVG::ShapeConstructors#path method.

Instance Method Summary collapse

Constructor Details

#initializePathData

Construct an empty path



27
28
29
# File 'lib/rvg/pathdata.rb', line 27

def initialize
    @path = ''
end

Instance Method Details

#arc(abs, rx, ry, x_axis_rotation, large_arc_flag, sweep_flag, x, y) ⇒ Object

Add an arc command. If abs is true the coordinates are absolute, otherwise the coordinates are relative.



122
123
124
# File 'lib/rvg/pathdata.rb', line 122

def arc(abs, rx, ry, x_axis_rotation, large_arc_flag, sweep_flag, x, y)
    @path << sprintf('%s%g,%g %g %d %d %g,%g ', (abs ? 'A' : 'a'), rx, ry, x_axis_rotation, large_arc_flag, sweep_flag, x, y)
end

#closepath(abs = true) ⇒ Object

Add a closepath command. The abs argument is ignored.



51
52
53
# File 'lib/rvg/pathdata.rb', line 51

def closepath(abs=true)
    @path << 'Z'    # ignore `abs'
end

#curveto(abs, x1, y1, x2, y2, x, y, *coords) ⇒ Object

Add a curveto (cubic Bezier) command. If abs is true the coordinates are absolute, otherwise the coordinates are relative.



83
84
85
86
87
# File 'lib/rvg/pathdata.rb', line 83

def curveto(abs, x1, y1, x2, y2, x, y, *coords)
    @path << sprintf('%s%g,%g %g,%g %g,%g ', (abs ? 'C' : 'c'), x1, y1, x2, y2, x, y)
    # "multiple sets of coordinates may be specified to draw a polybezier"
    add_points(6, *coords)
end

#deep_copy(h = nil) ⇒ Object

:nodoc:



36
37
38
# File 'lib/rvg/pathdata.rb', line 36

def deep_copy(h=nil)        #:nodoc:
    @path.dup
end

#hlineto(abs, x) ⇒ Object

Add a horizontal lineto command. If abs is true the coordinates are absolute, otherwise the coordinates are relative.



68
69
70
# File 'lib/rvg/pathdata.rb', line 68

def hlineto(abs, x)
    @path << sprintf('%s%g ', (abs ? 'H' : 'h'), x)
end

#lineto(abs, x, y, *coords) ⇒ Object

Add a lineto command. Any number of x,y coordinate pairs may be specified. If abs is true the coordinates are absolute, otherwise the coordinates are relative.



59
60
61
62
63
# File 'lib/rvg/pathdata.rb', line 59

def lineto(abs, x, y, *coords)
    @path << sprintf('%s%g,%g ', (abs ? 'L' : 'l'), x, y)
    # "a number of coordinate pairs may be specified to draw a polyline"
    add_points(2, *coords)
end

#moveto(abs, x, y, *coords) ⇒ Object

Add a moveto command. If abs is true the coordinates are absolute, otherwise the coordinates are relative.



43
44
45
46
47
# File 'lib/rvg/pathdata.rb', line 43

def moveto(abs, x, y, *coords)
    @path << sprintf('%s%g,%g ', (abs ? 'M' : 'm'), x, y)
    # "subsequent pairs are treated as implicit lineto commands"
    add_points(2, *coords)
end

#quadratic_curveto(abs, x1, y1, x, y, *coords) ⇒ Object

Add a quadratic Bezier curveto command. If abs is true the coordinates are absolute, otherwise the coordinates are relative.



103
104
105
106
# File 'lib/rvg/pathdata.rb', line 103

def quadratic_curveto(abs, x1, y1, x, y, *coords)
    @path << sprintf('%s%g,%g %g,%g ', (abs ? 'Q' : 'q'), x1, y1, x, y)
    add_points(4, *coords)
end

#smooth_curveto(abs, x2, y2, x, y, *coords) ⇒ Object

Add a smooth curveto (cubic Bezier) command. If abs is true the coordinates are absolute, otherwise the coordinates are relative.



93
94
95
96
97
# File 'lib/rvg/pathdata.rb', line 93

def smooth_curveto(abs, x2, y2, x, y, *coords)
    @path << sprintf('%s%g,%g %g,%g ', (abs ? 'S' : 's'), x2, y2, x, y)
    # "multiple sets of coordinates may be specified to draw a polybezier"
    add_points(4, *coords)
end

#smooth_quadratic_curveto(abs, x, y, *coords) ⇒ Object

Add a smooth quadratic Bezier curveto command. If abs is true the coordinates are absolute, otherwise the coordinates are relative.



112
113
114
115
# File 'lib/rvg/pathdata.rb', line 112

def smooth_quadratic_curveto(abs, x, y, *coords)
    @path << sprintf('%s%g,%g ', (abs ? 'T' : 't'), x, y)
    add_points(2, *coords)
end

#to_sObject

Convert the path to its string equivalent.



32
33
34
# File 'lib/rvg/pathdata.rb', line 32

def to_s
    @path
end

#vlineto(abs, y) ⇒ Object

Add a vertical lineto command. If abs is true the coordinates are absolute, otherwise the coordinates are relative.



75
76
77
# File 'lib/rvg/pathdata.rb', line 75

def vlineto(abs, y)
    @path << sprintf('%s%g ', (abs ? 'V' : 'v'), y)
end