Class: Magick::Geometry

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

Constant Summary collapse

FLAGS = 
['', '%', '!', '<', '>', '@', '^']
RFLAGS = 
{ '%' => PercentGeometry,
'!' => AspectGeometry,
'<' => LessGeometry,
'>' => GreaterGeometry,
'@' => AreaGeometry,
'^' => MinimumGeometry }
W =

Construct an object from a geometry string

/(\d+\.\d+%?)|(\d*%?)/
H = 
W
X = 
/(?:([-+]\d+))?/
Y = 
X
RE = 
/\A#{W}x?#{H}#{X}#{Y}([!<>@\^]?)\Z/

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(width = nil, height = nil, x = nil, y = nil, flag = nil) ⇒ Geometry

Returns a new instance of Geometry.



68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
 
# File 'lib/rmagick_internal.rb', line 68

def initialize(width=nil, height=nil, x=nil, y=nil, flag=nil)
  fail(ArgumentError, "width set to #{width}") if width.is_a? GeometryValue
    fail(ArgumentError, "height set to #{height}") if height.is_a? GeometryValue
    fail(ArgumentError, "x set to #{x}") if x.is_a? GeometryValue
    fail(ArgumentError, "y set to #{y}") if y.is_a? GeometryValue
    
    # Support floating-point width and height arguments so Geometry
    # objects can be used to specify Image#density= arguments.
    if width.nil?
      @width = 0
    elsif width.to_f >= 0.0
      @width = width.to_f
    else
      Kernel.raise ArgumentError, "width must be >= 0: #{width}"
    end
    if height.nil?
      @height = 0
    elsif height.to_f >= 0.0
      @height = height.to_f
    else
      Kernel.raise ArgumentError, "height must be >= 0: #{height}"
    end
    
    @x    = x.to_i
    @y    = y.to_i
    @flag = flag
end

Instance Attribute Details

#flag ⇒ Object

Returns the value of attribute flag.



66
67
68
 
# File 'lib/rmagick_internal.rb', line 66

def flag
  @flag
end

#height ⇒ Object

Returns the value of attribute height.



66
67
68
 
# File 'lib/rmagick_internal.rb', line 66

def height
  @height
end

#width ⇒ Object

Returns the value of attribute width.



66
67
68
 
# File 'lib/rmagick_internal.rb', line 66

def width
  @width
end

#x ⇒ Object

Returns the value of attribute x.



66
67
68
 
# File 'lib/rmagick_internal.rb', line 66

def x
  @x
end

#y ⇒ Object

Returns the value of attribute y.



66
67
68
 
# File 'lib/rmagick_internal.rb', line 66

def y
  @y
end

Class Method Details

.from_s(str) ⇒ Object 



103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
 
# File 'lib/rmagick_internal.rb', line 103

def self.from_s(str)
  m = RE.match(str)
    if m
      width  = (m[1] || m[2]).to_f
        height = (m[3] || m[4]).to_f
        x      = m[5].to_i
        y      = m[6].to_i
        flag   = RFLAGS[m[7]]
    else
      Kernel.raise ArgumentError, 'invalid geometry format'
    end
    if str['%']
      flag = PercentGeometry
    end
    Geometry.new(width, height, x, y, flag)
end

Instance Method Details

#to_s ⇒ Object

Convert object to a geometry string



121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
 
# File 'lib/rmagick_internal.rb', line 121

def to_s
  str = ''
    if @width > 0
      fmt = @width.truncate == @width ? '%d' : '%.2f'
      str << sprintf(fmt, @width)
      str << '%' if @flag == PercentGeometry
    end
    
    if (@width > 0 && @flag != PercentGeometry) || (@height > 0)
      str << 'x'
    end
    
    if @height > 0
      fmt = @height.truncate == @height ? '%d' : '%.2f'
      str << sprintf(fmt, @height)
      str << '%' if @flag == PercentGeometry
    end
    str << sprintf('%+d%+d', @x, @y) if @x != 0 || @y != 0
    if @flag != PercentGeometry
      str << FLAGS[@flag.to_i]
    end
    str
end