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.


1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
# File 'lib/RMagick.rb', line 1040

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


1038
1039
1040
# File 'lib/RMagick.rb', line 1038

def dirty
  @dirty
end

#heightObject (readonly)

Returns the value of attribute height


1037
1038
1039
# File 'lib/RMagick.rb', line 1037

def height
  @height
end

#widthObject (readonly)

Returns the value of attribute width


1037
1038
1039
# File 'lib/RMagick.rb', line 1037

def width
  @width
end

#xObject (readonly)

Returns the value of attribute x


1037
1038
1039
# File 'lib/RMagick.rb', line 1037

def x
  @x
end

#yObject (readonly)

Returns the value of attribute y


1037
1038
1039
# File 'lib/RMagick.rb', line 1037

def y
  @y
end

Instance Method Details

#[](*args) ⇒ Object


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

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


1064
1065
1066
1067
# File 'lib/RMagick.rb', line 1064

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!


1071
1072
1073
1074
1075
# File 'lib/RMagick.rb', line 1071

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