Class: Magick::Image::View

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

Overview

Magick::Image::View class

Defined Under Namespace

Classes: Pixels, Rows

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(img, x, y, width, height) ⇒ View

Returns a new instance of View.



1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
# File 'lib/RMagick.rb', line 1061

def initialize(img, x, y, width, height)
    img.check_destroyed
    if width <= 0 || height <= 0
        Kernel.raise ArgumentError, "invalid geometry (#{width}x#{height}+#{x}+#{y})"
    end
    if x < 0 || y < 0 || (x+width) > img.columns || (y+height) > img.rows
        Kernel.raise RangeError, "geometry (#{width}x#{height}+#{x}+#{y}) exceeds image boundary"
    end
    @view = img.get_pixels(x, y, width, height)
    @img = img
    @x = x
    @y = y
    @width = width
    @height = height
    @dirty = false
end

Instance Attribute Details

#dirtyObject

Returns the value of attribute dirty.



1059
1060
1061
# File 'lib/RMagick.rb', line 1059

def dirty
  @dirty
end

#heightObject (readonly)

Returns the value of attribute height.



1058
1059
1060
# File 'lib/RMagick.rb', line 1058

def height
  @height
end

#widthObject (readonly)

Returns the value of attribute width.



1058
1059
1060
# File 'lib/RMagick.rb', line 1058

def width
  @width
end

#xObject (readonly)

Returns the value of attribute x.



1058
1059
1060
# File 'lib/RMagick.rb', line 1058

def x
  @x
end

#yObject (readonly)

Returns the value of attribute y.



1058
1059
1060
# File 'lib/RMagick.rb', line 1058

def y
  @y
end

Instance Method Details

#[](*args) ⇒ Object



1078
1079
1080
1081
1082
# File 'lib/RMagick.rb', line 1078

def [](*args)
    rows = Rows.new(@view, @width, @height, args)
    rows.add_observer(self)
    return rows
end

#sync(force = false) ⇒ Object

Store changed pixels back to image



1085
1086
1087
1088
# File 'lib/RMagick.rb', line 1085

def sync(force=false)
    @img.store_pixels(x, y, width, height, @view) if (@dirty || force)
    return (@dirty || force)
end

#update(rows) ⇒ Object

Get update from Rows - if @dirty ever becomes true, don’t change it back to false!



1092
1093
1094
1095
1096
# File 'lib/RMagick.rb', line 1092

def update(rows)
    @dirty = true
    rows.delete_observer(self)      # No need to tell us again.
    nil
end