Class: Magick::ImageList
- Inherits:
-
Object
- Object
- Magick::ImageList
- Includes:
- Comparable, Enumerable
- Defined in:
- lib/rmagick_internal.rb,
ext/RMagick/rmmain.c
Overview
class Magick::Image
Defined Under Namespace
Classes: Montage
Instance Attribute Summary collapse
-
#scene ⇒ Object
Returns the value of attribute scene.
Instance Method Summary collapse
- #*(n) ⇒ Object
- #<<(obj) ⇒ Object
-
#<=>(other) ⇒ Object
Compare ImageLists Compare each image in turn until the result of a comparison is not 0.
- #[](*args) ⇒ Object
- #[]=(*args) ⇒ Object
-
#__respond_to__? ⇒ Object
Ensure respond_to? answers correctly when we are delegating to Image.
-
#animate(*args) ⇒ Object
Repeatedly display the images in the images array to an XWindow screen.
-
#append(stack_arg) ⇒ Object
Append all the images by calling ImageAppend.
-
#average ⇒ Object
Average all images together by calling AverageImages.
- #clear ⇒ Object
- #clone ⇒ Object
-
#coalesce ⇒ Object
Call CoalesceImages.
-
#collect(&block) ⇒ Object
(also: #__map__)
override Enumerable#collect.
- #collect!(&block) ⇒ Object (also: #map!, #__map__!)
- #compact ⇒ Object
- #compact! ⇒ Object
-
#composite_layers(*args) ⇒ Object
Equivalent to convert’s -layers composite option.
- #concat(other) ⇒ Object
-
#copy ⇒ Object
Make a deep copy.
-
#cur_image ⇒ Object
Return the current image.
-
#deconstruct ⇒ Object
Compare each image with the next in a sequence and returns the maximum bounding region of any pixel differences it discovers.
-
#delay=(d) ⇒ Object
Set same delay for all images.
- #delete(obj, &block) ⇒ Object
- #delete_at(ndx) ⇒ Object
- #delete_if(&block) ⇒ Object
-
#display ⇒ Object
(also: #__display__)
Display all the images to an X window screen.
- #dup ⇒ Object
- #eql?(other) ⇒ Boolean
- #fill(*args, &block) ⇒ Object
-
#find_all(&block) ⇒ Object
(also: #select)
Override Enumerable’s find_all.
-
#flatten_images ⇒ Object
Merge all the images into a single image.
- #from_blob(*blobs, &block) ⇒ Object
-
#fx(*args) ⇒ Object
Apply fx on the images.
-
#initialize(*filenames, &block) ⇒ ImageList
constructor
Initialize new instances.
- #insert(index, *args) ⇒ Object
-
#inspect ⇒ Object
Call inspect for all the images.
-
#iterations=(n) ⇒ Object
Set the number of iterations of an animated GIF.
- #last(*args) ⇒ Object
-
#map(*args) ⇒ Object
Call MapImages.
-
#marshal_dump ⇒ Object
Custom marshal/unmarshal for Ruby 1.8.
- #marshal_load(ary) ⇒ Object
-
#method_missing(methID, *args, &block) ⇒ Object
The ImageList class supports the Magick::Image class methods by simply sending the method to the current image.
-
#montage ⇒ Object
Call MontageImages.
-
#morph(nimages) ⇒ Object
Requires a minimum of two images.
-
#mosaic ⇒ Object
Merge all the images into a single image.
-
#new_image(cols, rows, *fill, &info_blk) ⇒ Object
Create a new image and add it to the end.
- #nitems ⇒ Object
-
#optimize_layers(method) ⇒ Object
Equivalent to -layers option in ImageMagick 6.2.6.
- #partition(&block) ⇒ Object
-
#ping(*files, &block) ⇒ Object
Ping files and concatenate the new images.
- #pop ⇒ Object
- #push(*objs) ⇒ Object
-
#quantize(*args) ⇒ Object
Call QuantizeImages.
-
#read(*files, &block) ⇒ Object
Read files and concatenate the new images.
-
#reject(&block) ⇒ Object
override Enumerable’s reject.
- #reject!(&block) ⇒ Object
-
#remap(*args) ⇒ Object
(also: #affinity)
Call RemapImages.
- #replace(other) ⇒ Object
- #respond_to?(methID, priv = false) ⇒ Boolean
- #reverse ⇒ Object
- #reverse! ⇒ Object
- #reverse_each ⇒ Object
- #shift ⇒ Object
- #slice(*args) ⇒ Object
- #slice!(*args) ⇒ Object
- #ticks_per_second=(t) ⇒ Object
- #to_a ⇒ Object
-
#to_blob ⇒ Object
Return the imagelist as a blob (a String).
- #uniq ⇒ Object
- #uniq!(*args) ⇒ Object
- #unshift(obj) ⇒ Object
- #values_at(*args) ⇒ Object (also: #indexes, #indices)
-
#write(file) ⇒ Object
Write all the images to the specified file.
Constructor Details
#initialize(*filenames, &block) ⇒ ImageList
Initialize new instances
1621 1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 |
# File 'lib/rmagick_internal.rb', line 1621 def initialize(*filenames, &block) @images = [] @scene = nil filenames.each { |f| Magick::Image.read(f, &block).each { |n| @images << n } } if length > 0 @scene = length - 1 # last image in array end self end |
Dynamic Method Handling
This class handles dynamic methods through the method_missing method
#method_missing(methID, *args, &block) ⇒ Object
The ImageList class supports the Magick::Image class methods by simply sending the method to the current image. If the method isn’t explicitly supported, send it to the current image in the array. If there are no images, send it up the line. Catch a NameError and emit a useful message.
1688 1689 1690 1691 1692 1693 1694 1695 1696 1697 1698 1699 1700 1701 |
# File 'lib/rmagick_internal.rb', line 1688 def method_missing(methID, *args, &block) begin if @scene @images[@scene].send(methID, *args, &block) else super end rescue NoMethodError Kernel.raise NoMethodError, "undefined method `#{methID.id2name}' for #{self.class}" rescue Exception $@.delete_if { |s| /:in `send'$/.match(s) || /:in `method_missing'$/.match(s) } Kernel.raise end end |
Instance Attribute Details
#scene ⇒ Object
Returns the value of attribute scene.
1288 1289 1290 |
# File 'lib/rmagick_internal.rb', line 1288 def scene @scene end |
Instance Method Details
#*(n) ⇒ Object
1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 |
# File 'lib/rmagick_internal.rb', line 1380 def *(n) unless n.kind_of? Integer Kernel.raise ArgumentError, "Integer required (#{n.class} given)" end current = get_current() ilist = self.class.new (@images * n).each {|image| ilist << image} ilist.set_current current return ilist end |
#<<(obj) ⇒ Object
1391 1392 1393 1394 1395 1396 |
# File 'lib/rmagick_internal.rb', line 1391 def <<(obj) is_an_image obj @images << obj @scene = @images.length - 1 self end |
#<=>(other) ⇒ Object
Compare ImageLists Compare each image in turn until the result of a comparison is not 0. If all comparisons return 0, then
return if A.scene != B.scene
return A.length <=> B.length
1403 1404 1405 1406 1407 1408 1409 1410 1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 |
# File 'lib/rmagick_internal.rb', line 1403 def <=>(other) unless other.kind_of? self.class Kernel.raise TypeError, "#{self.class} required (#{other.class} given)" end size = [self.length, other.length].min size.times do |x| r = self[x] <=> other[x] return r unless r == 0 end if @scene.nil? && other.scene.nil? return 0 elsif @scene.nil? && ! other.scene.nil? Kernel.raise TypeError, "cannot convert nil into #{other.scene.class}" elsif ! @scene.nil? && other.scene.nil? Kernel.raise TypeError, "cannot convert nil into #{self.scene.class}" end r = self.scene <=> other.scene return r unless r == 0 return self.length <=> other.length end |
#[](*args) ⇒ Object
1424 1425 1426 1427 1428 1429 1430 1431 1432 |
# File 'lib/rmagick_internal.rb', line 1424 def [](*args) a = @images[*args] if a.respond_to?(:each) then ilist = self.class.new a.each {|image| ilist << image} a = ilist end return a end |
#[]=(*args) ⇒ Object
1434 1435 1436 1437 1438 1439 1440 1441 1442 1443 1444 1445 1446 |
# File 'lib/rmagick_internal.rb', line 1434 def []=(*args) obj = @images.[]=(*args) if obj && obj.respond_to?(:each) then is_an_image_array(obj) set_current obj.last.__id__ elsif obj is_an_image(obj) set_current obj.__id__ else set_current nil end return obj end |
#__respond_to__? ⇒ Object
Ensure respond_to? answers correctly when we are delegating to Image
1788 |
# File 'lib/rmagick_internal.rb', line 1788 alias_method :__respond_to__?, :respond_to? |
#animate(*args) ⇒ Object
Repeatedly display the images in the images array to an XWindow screen. The “delay” argument is the number of 1/100ths of a second (0 to 65535) to delay between images.
Ruby usage:
- @verbatim ImageList#animate @endverbatim
- @verbatim ImageList#animate(delay) @endverbatim
42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 |
# File 'ext/RMagick/rmilist.c', line 42
VALUE
ImageList_animate(int argc, VALUE *argv, VALUE self)
{
Image *images;
Info *info;
volatile VALUE info_obj;
if (argc > 1)
{
rb_raise(rb_eArgError, "wrong number of arguments (%d for 0 or 1)", argc);
}
// Create a new Info object to use with this call
info_obj = rm_info_new();
// Convert the images array to an images sequence.
images = images_from_imagelist(self);
if (argc == 1)
{
Image *img;
unsigned int delay;
delay = NUM2UINT(argv[0]);
for (img = images; img; img = GetNextImageInList(img))
{
img->delay = delay;
}
}
Data_Get_Struct(info_obj, Info, info);
(void) AnimateImages(info, images);
rm_check_image_exception(images, RetainOnError);
rm_split(images);
return self;
}
|
#append(stack_arg) ⇒ Object
Append all the images by calling ImageAppend.
Ruby usage:
- @verbatim ImageList#append(stack) @endverbatim
91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 |
# File 'ext/RMagick/rmilist.c', line 91
VALUE
ImageList_append(VALUE self, VALUE stack_arg)
{
Image *images, *new_image;
unsigned int stack;
ExceptionInfo *exception;
// Convert the image array to an image sequence.
images = images_from_imagelist(self);
// If stack == true, stack rectangular images top-to-bottom,
// otherwise left-to-right.
stack = RTEST(stack_arg);
exception = AcquireExceptionInfo();
new_image = AppendImages(images, stack, exception);
rm_split(images);
rm_check_exception(exception, new_image, DestroyOnError);
(void) DestroyExceptionInfo(exception);
rm_ensure_result(new_image);
return rm_image_new(new_image);
}
|
#average ⇒ Object
Average all images together by calling AverageImages.
Ruby usage:
- @verbatim ImageList#average @endverbatim
126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 |
# File 'ext/RMagick/rmilist.c', line 126
VALUE
ImageList_average(VALUE self)
{
Image *images, *new_image;
ExceptionInfo *exception;
// Convert the images array to an images sequence.
images = images_from_imagelist(self);
exception = AcquireExceptionInfo();
#if defined(HAVE_EVALUATEIMAGES)
new_image = EvaluateImages(images, MeanEvaluateOperator, exception);
#else
new_image = AverageImages(images, exception);
#endif
rm_split(images);
rm_check_exception(exception, new_image, DestroyOnError);
(void) DestroyExceptionInfo(exception);
rm_ensure_result(new_image);
return rm_image_new(new_image);
}
|
#clear ⇒ Object
1465 1466 1467 1468 |
# File 'lib/rmagick_internal.rb', line 1465 def clear @scene = nil @images.clear end |
#clone ⇒ Object
1470 1471 1472 1473 1474 |
# File 'lib/rmagick_internal.rb', line 1470 def clone ditto = dup ditto.freeze if frozen? return ditto end |
#coalesce ⇒ Object
Call CoalesceImages.
Ruby usage:
- @verbatim ImageList#coalesce @endverbatim
Notes:
- Respects the delay, matte, and start_loop fields in each image.
images array
165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 |
# File 'ext/RMagick/rmilist.c', line 165
VALUE
ImageList_coalesce(VALUE self)
{
Image *images, *new_images;
ExceptionInfo *exception;
// Convert the image array to an image sequence.
images = images_from_imagelist(self);
exception = AcquireExceptionInfo();
new_images = CoalesceImages(images, exception);
rm_split(images);
rm_check_exception(exception, new_images, DestroyOnError);
(void) DestroyExceptionInfo(exception);
rm_ensure_result(new_images);
return rm_imagelist_from_images(new_images);
}
|
#collect(&block) ⇒ Object Also known as: __map__
override Enumerable#collect
1477 1478 1479 1480 1481 1482 1483 1484 |
# File 'lib/rmagick_internal.rb', line 1477 def collect(&block) current = get_current() a = @images.collect(&block) ilist = self.class.new a.each {|image| ilist << image} ilist.set_current current return ilist end |
#collect!(&block) ⇒ Object Also known as: map!, __map__!
1486 1487 1488 1489 1490 |
# File 'lib/rmagick_internal.rb', line 1486 def collect!(&block) @images.collect!(&block) is_an_image_array @images self end |
#compact ⇒ Object
1517 1518 1519 1520 1521 1522 1523 1524 |
# File 'lib/rmagick_internal.rb', line 1517 def compact current = get_current() ilist = self.class.new a = @images.compact a.each {|image| ilist << image} ilist.set_current current return ilist end |
#compact! ⇒ Object
1526 1527 1528 1529 1530 1531 |
# File 'lib/rmagick_internal.rb', line 1526 def compact! current = get_current() a = @images.compact! # returns nil if no changes were made set_current current return a.nil? ? nil : self end |
#composite_layers(*args) ⇒ Object
Equivalent to convert’s -layers composite option.
Ruby usage:
- @verbatim ImageList#composite_layers(images) @endverbatim
- @verbatim ImageList#composite_layers(images,operator) @endverbatim
Notes:
- Default operator is OverCompositeOp
202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 |
# File 'ext/RMagick/rmilist.c', line 202
VALUE
ImageList_composite_layers(int argc, VALUE *argv, VALUE self)
{
volatile VALUE source_images;
Image *dest, *source, *new_images;
RectangleInfo geometry;
CompositeOperator operator = OverCompositeOp;
ExceptionInfo *exception;
switch (argc)
{
case 2:
VALUE_TO_ENUM(argv[1], operator, CompositeOperator);
case 1:
source_images = argv[0];
break;
default:
rb_raise(rb_eArgError, "wrong number of arguments (expected 1 or 2, got %d)", argc);
break;
}
// Convert ImageLists to image sequences.
dest = images_from_imagelist(self);
new_images = clone_imagelist(dest);
rm_split(dest);
source = images_from_imagelist(source_images);
SetGeometry(new_images,&geometry);
(void) ParseAbsoluteGeometry(new_images->geometry, &geometry);
geometry.width = source->page.width != 0 ? source->page.width : source->columns;
geometry.height = source->page.height != 0 ? source->page.height : source->rows;
GravityAdjustGeometry(new_images->page.width != 0 ? new_images->page.width : new_images->columns
, new_images->page.height != 0 ? new_images->page.height : new_images->rows
, new_images->gravity, &geometry);
exception = AcquireExceptionInfo();
CompositeLayers(new_images, operator, source, geometry.x, geometry.y, exception);
rm_split(source);
rm_check_exception(exception, new_images, DestroyOnError);
(void) DestroyExceptionInfo(exception);
return rm_imagelist_from_images(new_images);
}
|
#concat(other) ⇒ Object
1533 1534 1535 1536 1537 1538 |
# File 'lib/rmagick_internal.rb', line 1533 def concat(other) is_an_image_array other other.each {|image| @images << image} @scene = length-1 return self end |
#copy ⇒ Object
Make a deep copy
1493 1494 1495 1496 1497 1498 1499 |
# File 'lib/rmagick_internal.rb', line 1493 def copy ditto = self.class.new @images.each { |f| ditto << f.copy } ditto.scene = @scene ditto.taint if tainted? return ditto end |
#cur_image ⇒ Object
Return the current image
1502 1503 1504 1505 1506 1507 |
# File 'lib/rmagick_internal.rb', line 1502 def cur_image if ! @scene Kernel.raise IndexError, "no images in this list" end @images[@scene] end |
#deconstruct ⇒ Object
Compare each image with the next in a sequence and returns the maximum bounding region of any pixel differences it discovers.
Ruby usage:
- @verbatim ImageList#deconstruct @endverbatim
259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 |
# File 'ext/RMagick/rmilist.c', line 259
VALUE
ImageList_deconstruct(VALUE self)
{
Image *new_images, *images;
ExceptionInfo *exception;
images = images_from_imagelist(self);
exception = AcquireExceptionInfo();
new_images = DeconstructImages(images, exception);
rm_split(images);
rm_check_exception(exception, new_images, DestroyOnError);
(void) DestroyExceptionInfo(exception);
rm_ensure_result(new_images);
return rm_imagelist_from_images(new_images);
}
|
#delay=(d) ⇒ Object
Set same delay for all images
1541 1542 1543 1544 1545 1546 |
# File 'lib/rmagick_internal.rb', line 1541 def delay=(d) if Integer(d) < 0 raise ArgumentError, "delay must be greater than or equal to 0" end @images.each { |f| f.delay = Integer(d) } end |
#delete(obj, &block) ⇒ Object
1548 1549 1550 1551 1552 1553 1554 |
# File 'lib/rmagick_internal.rb', line 1548 def delete(obj, &block) is_an_image obj current = get_current() a = @images.delete(obj, &block) set_current current return a end |
#delete_at(ndx) ⇒ Object
1556 1557 1558 1559 1560 1561 |
# File 'lib/rmagick_internal.rb', line 1556 def delete_at(ndx) current = get_current() a = @images.delete_at(ndx) set_current current return a end |
#delete_if(&block) ⇒ Object
1563 1564 1565 1566 1567 1568 |
# File 'lib/rmagick_internal.rb', line 1563 def delete_if(&block) current = get_current() @images.delete_if(&block) set_current current self end |
#display ⇒ Object Also known as: __display__
Display all the images to an X window screen.
Ruby usage:
- @verbatim ImageList#display @endverbatim
287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 |
# File 'ext/RMagick/rmilist.c', line 287
VALUE
ImageList_display(VALUE self)
{
Image *images;
Info *info;
volatile VALUE info_obj;
// Create a new Info object to use with this call
info_obj = rm_info_new();
Data_Get_Struct(info_obj, Info, info);
// Convert the images array to an images sequence.
images = images_from_imagelist(self);
(void) DisplayImages(info, images);
rm_split(images);
rm_check_image_exception(images, RetainOnError);
return self;
}
|
#dup ⇒ Object
1570 1571 1572 1573 1574 1575 1576 |
# File 'lib/rmagick_internal.rb', line 1570 def dup ditto = self.class.new @images.each {|img| ditto << img} ditto.scene = @scene ditto.taint if tainted? return ditto end |
#eql?(other) ⇒ Boolean
1578 1579 1580 1581 1582 1583 1584 1585 1586 1587 |
# File 'lib/rmagick_internal.rb', line 1578 def eql?(other) is_an_image_array other eql = other.eql?(@images) begin # "other" is another ImageList eql &&= @scene == other.scene rescue NoMethodError # "other" is a plain Array end return eql end |
#fill(*args, &block) ⇒ Object
1589 1590 1591 1592 1593 1594 1595 1596 |
# File 'lib/rmagick_internal.rb', line 1589 def fill(*args, &block) is_an_image args[0] unless block_given? current = get_current() @images.fill(*args, &block) is_an_image_array self set_current current self end |
#find_all(&block) ⇒ Object Also known as: select
Override Enumerable’s find_all
1599 1600 1601 1602 1603 1604 1605 1606 |
# File 'lib/rmagick_internal.rb', line 1599 def find_all(&block) current = get_current() a = @images.find_all(&block) ilist = self.class.new a.each {|image| ilist << image} ilist.set_current current return ilist end |
#flatten_images ⇒ Object
Merge all the images into a single image.
Ruby usage:
- @verbatim ImageList#flatten_images @endverbatim
Notes:
- Can't use "flatten" because that's an Array method
321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 |
# File 'ext/RMagick/rmilist.c', line 321
VALUE
ImageList_flatten_images(VALUE self)
{
Image *images, *new_image;
ExceptionInfo *exception;
images = images_from_imagelist(self);
exception = AcquireExceptionInfo();
#if defined(HAVE_ENUM_FLATTENLAYER)
new_image = MergeImageLayers(images, FlattenLayer, exception);
#else
new_image = FlattenImages(images, exception);
#endif
rm_split(images);
rm_check_exception(exception, new_image, DestroyOnError);
(void) DestroyExceptionInfo(exception);
rm_ensure_result(new_image);
return rm_image_new(new_image);
}
|
#from_blob(*blobs, &block) ⇒ Object
1609 1610 1611 1612 1613 1614 1615 1616 1617 1618 |
# File 'lib/rmagick_internal.rb', line 1609 def from_blob(*blobs, &block) if (blobs.length == 0) Kernel.raise ArgumentError, "no blobs given" end blobs.each { |b| Magick::Image.from_blob(b, &block).each { |n| @images << n } } @scene = length - 1 self end |
#fx(*args) ⇒ Object
Apply fx on the images.
Ruby usage:
- @verbatim ImageList#fx(expression) @endverbatim
- @verbatim ImageList#fx(expression, channel) @endverbatim
- @verbatim ImageList#fx(expression, channel, ...) @endverbatim
Notes:
- Default channel is AllChannels
362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 |
# File 'ext/RMagick/rmilist.c', line 362
VALUE
ImageList_fx(int argc, VALUE *argv, VALUE self)
{
Image *images, *new_image;
char *expression;
ChannelType channels;
ExceptionInfo *exception;
channels = extract_channels(&argc, argv);
// There must be exactly 1 remaining argument.
if (argc == 0)
{
rb_raise(rb_eArgError, "wrong number of arguments (0 for 1 or more)");
}
else if (argc > 1)
{
raise_ChannelType_error(argv[argc-1]);
}
expression = StringValuePtr(argv[0]);
images = images_from_imagelist(self);
exception = AcquireExceptionInfo();
new_image = FxImageChannel(images, channels, expression, exception);
rm_split(images);
rm_check_exception(exception, new_image, DestroyOnError);
(void) DestroyExceptionInfo(exception);
rm_ensure_result(new_image);
return rm_image_new(new_image);
}
|
#insert(index, *args) ⇒ Object
1633 1634 1635 1636 1637 1638 1639 |
# File 'lib/rmagick_internal.rb', line 1633 def insert(index, *args) args.each {|image| is_an_image image} current = get_current() @images.insert(index, *args) set_current current return self end |
#inspect ⇒ Object
Call inspect for all the images
1642 1643 1644 1645 1646 |
# File 'lib/rmagick_internal.rb', line 1642 def inspect img = [] @images.each {|image| img << image.inspect } img = "[" + img.join(",\n") + "]\nscene=#{@scene}" end |
#iterations=(n) ⇒ Object
Set the number of iterations of an animated GIF
1649 1650 1651 1652 1653 1654 1655 1656 |
# File 'lib/rmagick_internal.rb', line 1649 def iterations=(n) n = Integer(n) if n < 0 || n > 65535 Kernel.raise ArgumentError, "iterations must be between 0 and 65535" end @images.each {|f| f.iterations=n} self end |
#last(*args) ⇒ Object
1658 1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 |
# File 'lib/rmagick_internal.rb', line 1658 def last(*args) if args.length == 0 a = @images.last else a = @images.last(*args) ilist = self.class.new a.each {|img| ilist << img} @scene = a.length - 1 a = ilist end return a end |
#map(*args) ⇒ Object
Call MapImages.
Ruby usage:
- @verbatim ImageList#map(reference) @endverbatim
- @verbatim ImageList#map(reference, dither) @endverbatim
Notes:
- Default dither is false
- Sets \@scene to self.scene
414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 |
# File 'ext/RMagick/rmilist.c', line 414
VALUE
ImageList_map(int argc, VALUE *argv, VALUE self)
{
Image *images, *new_images = NULL;
Image *map;
unsigned int dither = MagickFalse;
volatile VALUE scene, new_imagelist, t;
ExceptionInfo *exception;
#if defined(HAVE_REMAPIMAGES)
QuantizeInfo quantize_info;
rb_warning("ImageList#map is deprecated. Use ImageList#remap instead.");
#endif
switch (argc)
{
case 2:
dither = RTEST(argv[1]);
case 1:
t = rm_cur_image(argv[0]);
map = rm_check_destroyed(t);
break;
default:
rb_raise(rb_eArgError, "wrong number of arguments (%d for 1 or 2)", argc);
break;
}
// Convert image array to image sequence, clone image sequence.
exception = AcquireExceptionInfo();
images = images_from_imagelist(self);
new_images = CloneImageList(images, exception);
rm_split(images);
rm_check_exception(exception, new_images, DestroyOnError);
(void) DestroyExceptionInfo(exception);
rm_ensure_result(new_images);
// Call ImageMagick
#if defined(HAVE_REMAPIMAGES)
GetQuantizeInfo(&quantize_info);
quantize_info.dither = dither;
(void) RemapImages(&quantize_info, new_images, map);
#else
(void) MapImages(new_images, map, dither);
#endif
rm_check_image_exception(new_images, DestroyOnError);
// Set @scene in new ImageList object to same value as in self.
new_imagelist = rm_imagelist_from_images(new_images);
scene = rb_iv_get(self, "@scene");
(void) imagelist_scene_eq(new_imagelist, scene);
return new_imagelist;
}
|
#marshal_dump ⇒ Object
Custom marshal/unmarshal for Ruby 1.8.
1672 1673 1674 1675 1676 |
# File 'lib/rmagick_internal.rb', line 1672 def marshal_dump() ary = [@scene] @images.each {|i| ary << Marshal.dump(i)} ary end |
#marshal_load(ary) ⇒ Object
1678 1679 1680 1681 1682 |
# File 'lib/rmagick_internal.rb', line 1678 def marshal_load(ary) @scene = ary.shift @images = [] ary.each {|a| @images << Marshal.load(a)} end |
#montage ⇒ Object
Call MontageImages.
Ruby usage:
- @verbatim ImageList#montage <{parm block}> @endverbatim
Notes:
- Creates Montage object, yields to block if present in Montage object's
scope.
485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 |
# File 'ext/RMagick/rmilist.c', line 485
VALUE
ImageList_montage(VALUE self)
{
volatile VALUE montage_obj;
Montage *montage;
Image *new_images, *images;
ExceptionInfo *exception;
// Create a new instance of the Magick::Montage class
montage_obj = rm_montage_new();
if (rb_block_given_p())
{
// Run the block in the instance's context, allowing the app to modify the
// object's attributes.
(void) rb_obj_instance_eval(0, NULL, montage_obj);
}
Data_Get_Struct(montage_obj, Montage, montage);
images = images_from_imagelist(self);
// If app specified a non-default composition operator, use it for all images.
if (montage->compose != UndefinedCompositeOp)
{
Image *i;
for (i = images; i; i = GetNextImageInList(i))
{
i->compose = montage->compose;
}
}
exception = AcquireExceptionInfo();
// MontageImage can return more than one image.
new_images = MontageImages(images, montage->info, exception);
rm_split(images);
rm_check_exception(exception, new_images, DestroyOnError);
(void) DestroyExceptionInfo(exception);
rm_ensure_result(new_images);
return rm_imagelist_from_images(new_images);
}
|
#morph(nimages) ⇒ Object
Requires a minimum of two images. The first image is transformed into the second by a number of intervening images as specified by “number_images”.
Ruby usage:
- @verbatim ImageList#morph(number_images) @endverbatim
Notes:
- Sets \@scenes to 0
544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 |
# File 'ext/RMagick/rmilist.c', line 544
VALUE
ImageList_morph(VALUE self, VALUE nimages)
{
Image *images, *new_images;
ExceptionInfo *exception;
long number_images;
// Use a signed long so we can test for a negative argument.
number_images = NUM2LONG(nimages);
if (number_images <= 0)
{
rb_raise(rb_eArgError, "number of intervening images must be > 0");
}
exception = AcquireExceptionInfo();
images = images_from_imagelist(self);
new_images = MorphImages(images, (unsigned long)number_images, exception);
rm_split(images);
rm_check_exception(exception, new_images, DestroyOnError);
(void) DestroyExceptionInfo(exception);
rm_ensure_result(new_images);
return rm_imagelist_from_images(new_images);
}
|
#mosaic ⇒ Object
Merge all the images into a single image.
Ruby usage:
- @verbatim ImageList#mosaic @endverbatim
581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 |
# File 'ext/RMagick/rmilist.c', line 581
VALUE
ImageList_mosaic(VALUE self)
{
Image *images, *new_image;
ExceptionInfo *exception;
exception = AcquireExceptionInfo();
images = images_from_imagelist(self);
#if defined(HAVE_ENUM_MOSAICLAYER)
new_image = MergeImageLayers(images, MosaicLayer, exception);
#else
new_image = MosaicImages(images, exception);
#endif
rm_split(images);
rm_check_exception(exception, new_image, DestroyOnError);
(void) DestroyExceptionInfo(exception);
rm_ensure_result(new_image);
return rm_image_new(new_image);
}
|
#new_image(cols, rows, *fill, &info_blk) ⇒ Object
Create a new image and add it to the end
1704 1705 1706 |
# File 'lib/rmagick_internal.rb', line 1704 def new_image(cols, rows, *fill, &info_blk) self << Magick::Image.new(cols, rows, *fill, &info_blk) end |
#nitems ⇒ Object
1460 1461 1462 |
# File 'lib/rmagick_internal.rb', line 1460 def nitems() @images.nitems() end |
#optimize_layers(method) ⇒ Object
Equivalent to -layers option in ImageMagick 6.2.6.
Ruby usage:
- @verbatim ImageList#optimize_layers(method) @endverbatim
616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 |
# File 'ext/RMagick/rmilist.c', line 616
VALUE
ImageList_optimize_layers(VALUE self, VALUE method)
{
Image *images, *new_images, *new_images2;
LAYERMETHODTYPE mthd;
ExceptionInfo *exception;
QuantizeInfo quantize_info;
new_images2 = NULL; // defeat "unused variable" message
exception = AcquireExceptionInfo();
#if defined(HAVE_TYPE_IMAGELAYERMETHOD)
VALUE_TO_ENUM(method, mthd, ImageLayerMethod);
#else
VALUE_TO_ENUM(method, mthd, MagickLayerMethod);
#endif
images = images_from_imagelist(self);
switch (mthd)
{
case CoalesceLayer:
new_images = CoalesceImages(images, exception);
break;
case DisposeLayer:
new_images = DisposeImages(images, exception);
break;
case OptimizeTransLayer:
new_images = clone_imagelist(images);
OptimizeImageTransparency(new_images, exception);
break;
case RemoveDupsLayer:
new_images = clone_imagelist(images);
RemoveDuplicateLayers(&new_images, exception);
break;
case RemoveZeroLayer:
new_images = clone_imagelist(images);
RemoveZeroDelayLayers(&new_images, exception);
break;
case CompositeLayer:
rm_split(images);
rb_raise(rb_eNotImpError, "Magick::CompositeLayer is not supported. Use the composite_layers method instead.");
break;
// In 6.3.4-ish, OptimizeImageLayer replaced OptimizeLayer
case OptimizeImageLayer:
new_images = OptimizeImageLayers(images, exception);
break;
// and OptimizeLayer became a "General Purpose, GIF Animation Optimizer" (ref. mogrify.c)
case OptimizeLayer:
new_images = CoalesceImages(images, exception);
rm_split(images);
rm_check_exception(exception, new_images, DestroyOnError);
new_images2 = OptimizeImageLayers(new_images, exception);
DestroyImageList(new_images);
rm_check_exception(exception, new_images2, DestroyOnError);
new_images = new_images2;
OptimizeImageTransparency(new_images, exception);
rm_check_exception(exception, new_images, DestroyOnError);
// mogrify supports -dither here. We don't.
#if defined(HAVE_REMAPIMAGE)
GetQuantizeInfo(&quantize_info);
(void) RemapImages(&quantize_info, new_images, NULL);
#else
(void) MapImages(new_images, NULL, 0);
#endif
break;
case OptimizePlusLayer:
new_images = OptimizePlusImageLayers(images, exception);
break;
case CompareAnyLayer:
case CompareClearLayer:
case CompareOverlayLayer:
new_images = CompareImageLayers(images, mthd, exception);
break;
#if defined(HAVE_ENUM_MOSAICLAYER)
case MosaicLayer:
new_images = MergeImageLayers(images, mthd, exception);
break;
#endif
#if defined(HAVE_ENUM_FLATTENLAYER)
case FlattenLayer:
new_images = MergeImageLayers(images, mthd, exception);
break;
#endif
#if defined(HAVE_ENUM_MERGELAYER)
case MergeLayer:
new_images = MergeImageLayers(images, mthd, exception);
break;
#endif
#if defined(HAVE_ENUM_TRIMBOUNDSLAYER)
case TrimBoundsLayer:
new_images = MergeImageLayers(images, mthd, exception);
break;
#endif
default:
rm_split(images);
rb_raise(rb_eArgError, "undefined layer method");
break;
}
rm_split(images);
rm_check_exception(exception, new_images, DestroyOnError);
(void) DestroyExceptionInfo(exception);
rm_ensure_result(new_images);
return rm_imagelist_from_images(new_images);
}
|
#partition(&block) ⇒ Object
1708 1709 1710 1711 1712 1713 1714 1715 1716 1717 |
# File 'lib/rmagick_internal.rb', line 1708 def partition(&block) a = @images.partition(&block) t = self.class.new a[0].each { |img| t << img} t.set_current nil f = self.class.new a[1].each { |img| f << img} f.set_current nil [t, f] end |
#ping(*files, &block) ⇒ Object
Ping files and concatenate the new images
1720 1721 1722 1723 1724 1725 1726 1727 1728 1729 |
# File 'lib/rmagick_internal.rb', line 1720 def ping(*files, &block) if (files.length == 0) Kernel.raise ArgumentError, "no files given" end files.each { |f| Magick::Image.ping(f, &block).each { |n| @images << n } } @scene = length - 1 self end |
#pop ⇒ Object
1731 1732 1733 1734 1735 1736 |
# File 'lib/rmagick_internal.rb', line 1731 def pop current = get_current() a = @images.pop # can return nil set_current current return a end |
#push(*objs) ⇒ Object
1738 1739 1740 1741 1742 1743 1744 1745 |
# File 'lib/rmagick_internal.rb', line 1738 def push(*objs) objs.each do |image| is_an_image image @images << image end @scene = length - 1 self end |
#quantize(*args) ⇒ Object
Call QuantizeImages.
Ruby usage:
- @verbatim ImageList#quantize @endverbatim
- @verbatim ImageList#quantize(number_colors) @endverbatim
- @verbatim ImageList#quantize(number_colors, colorspace) @endverbatim
- @verbatim ImageList#quantize(number_colors, colorspace, dither) @endverbatim
- @verbatim ImageList#quantize(number_colors, colorspace, dither, tree_depth) @endverbatim
- @verbatim ImageList#quantize(number_colors, colorspace, dither, tree_depth, measure_error) @endverbatim
Notes:
- Default number_colors is 256
- Default coorspace is Magick::RGBColorsapce
- Default dither is true
- Default tree_depth is 0
- Default measure_error is false
- Sets \@scene to the same value as self.scene
938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 |
# File 'ext/RMagick/rmilist.c', line 938
VALUE
ImageList_quantize(int argc, VALUE *argv, VALUE self)
{
Image *images, *new_images;
Image *new_image;
QuantizeInfo quantize_info;
ExceptionInfo *exception;
volatile VALUE new_imagelist, scene;
GetQuantizeInfo(&quantize_info);
switch (argc)
{
case 5:
quantize_info.measure_error = (MagickBooleanType) RTEST(argv[4]);
case 4:
quantize_info.tree_depth = (unsigned long)NUM2INT(argv[3]);
case 3:
#if defined(HAVE_TYPE_DITHERMETHOD) && defined(HAVE_ENUM_NODITHERMETHOD)
if (rb_obj_is_kind_of(argv[2], Class_DitherMethod))
{
VALUE_TO_ENUM(argv[2], quantize_info.dither_method, DitherMethod);
quantize_info.dither = quantize_info.dither_method != NoDitherMethod;
}
#else
quantize_info.dither = (MagickBooleanType) RTEST(argv[2]);
#endif
case 2:
VALUE_TO_ENUM(argv[1], quantize_info.colorspace, ColorspaceType);
case 1:
quantize_info.number_colors = NUM2ULONG(argv[0]);
case 0:
break;
default:
rb_raise(rb_eArgError, "wrong number of arguments (%d for 0 to 5)", argc);
break;
}
// Convert image array to image sequence, clone image sequence.
exception = AcquireExceptionInfo();
images = images_from_imagelist(self);
new_images = CloneImageList(images, exception);
rm_split(images);
rm_check_exception(exception, new_images, DestroyOnError);
rm_ensure_result(new_images);
(void) QuantizeImages(&quantize_info, new_images);
rm_check_exception(exception, new_images, DestroyOnError);
(void) DestroyExceptionInfo(exception);
// Create new ImageList object, convert mapped image sequence to images,
// append to images array.
new_imagelist = ImageList_new();
while ((new_image = RemoveFirstImageFromList(&new_images)))
{
imagelist_push(new_imagelist, rm_image_new(new_image));
}
// Set @scene in new ImageList object to same value as in self.
scene = rb_iv_get(self, "@scene");
(void) rb_iv_set(new_imagelist, "@scene", scene);
return new_imagelist;
}
|
#read(*files, &block) ⇒ Object
Read files and concatenate the new images
1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 |
# File 'lib/rmagick_internal.rb', line 1748 def read(*files, &block) if (files.length == 0) Kernel.raise ArgumentError, "no files given" end files.each { |f| Magick::Image.read(f, &block).each { |n| @images << n } } @scene = length - 1 self end |
#reject(&block) ⇒ Object
override Enumerable’s reject
1760 1761 1762 1763 1764 1765 1766 1767 |
# File 'lib/rmagick_internal.rb', line 1760 def reject(&block) current = get_current() ilist = self.class.new a = @images.reject(&block) a.each {|image| ilist << image} ilist.set_current current return ilist end |
#reject!(&block) ⇒ Object
1769 1770 1771 1772 1773 1774 1775 |
# File 'lib/rmagick_internal.rb', line 1769 def reject!(&block) current = get_current() a = @images.reject!(&block) @images = a if !a.nil? set_current current return a.nil? ? nil : self end |
#remap(*args) ⇒ Object Also known as: affinity
Call RemapImages.
Ruby usage:
- @verbatim ImageList#remap @endverbatim
- @verbatim ImageList#remap(remap_image) @endverbatim
- @verbatim ImageList#remap(remap_image, dither_method) @endverbatim
Notes:
- Default remap_image is nil
- Default dither_method is RiemersmaDitherMethod
- Modifies images in-place.
1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 |
# File 'ext/RMagick/rmilist.c', line 1025
VALUE
ImageList_remap(int argc, VALUE *argv, VALUE self)
{
#if defined(HAVE_REMAPIMAGES) || defined(HAVE_AFFINITYIMAGES)
Image *images, *remap_image = NULL;
QuantizeInfo quantize_info;
if (argc > 0 && argv[0] != Qnil)
{
volatile VALUE t = rm_cur_image(argv[0]);
remap_image = rm_check_destroyed(t);
}
GetQuantizeInfo(&quantize_info);
if (argc > 1)
{
VALUE_TO_ENUM(argv[1], quantize_info.dither_method, DitherMethod);
quantize_info.dither = MagickTrue;
}
if (argc > 2)
{
rb_raise(rb_eArgError, "wrong number of arguments (%d for 1 or 2)", argc);
}
images = images_from_imagelist(self);
#if defined(HAVE_REMAPIMAGE)
(void) RemapImages(&quantize_info, images, remap_image);
#else
(void) AffinityImages(&quantize_info, images, remap_image);
#endif
rm_check_image_exception(images, RetainOnError);
rm_split(images);
return self;
#else
self = self;
argc = argc;
argv = argv;
rm_not_implemented();
return(VALUE)0;
#endif
}
|
#replace(other) ⇒ Object
1777 1778 1779 1780 1781 1782 1783 1784 1785 |
# File 'lib/rmagick_internal.rb', line 1777 def replace(other) is_an_image_array other current = get_current() @images.clear other.each {|image| @images << image} @scene = self.length == 0 ? nil : 0 set_current current self end |
#respond_to?(methID, priv = false) ⇒ Boolean
1789 1790 1791 1792 1793 1794 1795 1796 |
# File 'lib/rmagick_internal.rb', line 1789 def respond_to?(methID, priv=false) return true if __respond_to__?(methID, priv) if @scene @images[@scene].respond_to?(methID, priv) else super end end |
#reverse ⇒ Object
1798 1799 1800 1801 1802 1803 1804 |
# File 'lib/rmagick_internal.rb', line 1798 def reverse current = get_current() a = self.class.new @images.reverse_each {|image| a << image} a.set_current current return a end |
#reverse! ⇒ Object
1806 1807 1808 1809 1810 1811 |
# File 'lib/rmagick_internal.rb', line 1806 def reverse! current = get_current() @images.reverse! set_current current self end |
#reverse_each ⇒ Object
1813 1814 1815 1816 |
# File 'lib/rmagick_internal.rb', line 1813 def reverse_each @images.reverse_each {|image| yield(image)} self end |
#shift ⇒ Object
1818 1819 1820 1821 1822 1823 |
# File 'lib/rmagick_internal.rb', line 1818 def shift current = get_current() a = @images.shift set_current current return a end |
#slice(*args) ⇒ Object
1825 1826 1827 1828 1829 1830 1831 1832 1833 1834 1835 1836 1837 1838 1839 |
# File 'lib/rmagick_internal.rb', line 1825 def slice(*args) current = get_current() slice = @images.slice(*args) if slice ilist = self.class.new if slice.respond_to?(:each) then slice.each {|image| ilist << image} else ilist << slice end else ilist = nil end return ilist end |
#slice!(*args) ⇒ Object
1841 1842 1843 1844 1845 1846 |
# File 'lib/rmagick_internal.rb', line 1841 def slice!(*args) current = get_current() a = @images.slice!(*args) set_current current return a end |
#ticks_per_second=(t) ⇒ Object
1848 1849 1850 1851 1852 1853 |
# File 'lib/rmagick_internal.rb', line 1848 def ticks_per_second=(t) if Integer(t) < 0 Kernel.raise ArgumentError, "ticks_per_second must be greater than or equal to 0" end @images.each { |f| f.ticks_per_second = Integer(t) } end |
#to_a ⇒ Object
1855 1856 1857 1858 1859 |
# File 'lib/rmagick_internal.rb', line 1855 def to_a a = Array.new @images.each {|image| a << image} return a end |
#to_blob ⇒ Object
Return the imagelist as a blob (a String).
Ruby usage:
- @verbatim ImageList#to_blob @endverbatim
Notes:
- Runs an info parm block if present - the user can specify the image
format and depth
1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 |
# File 'ext/RMagick/rmilist.c', line 1085
VALUE
ImageList_to_blob(VALUE self)
{
Image *images, *image;
Info *info;
volatile VALUE info_obj;
volatile VALUE blob_str;
void *blob = NULL;
size_t length = 0;
ExceptionInfo *exception;
info_obj = rm_info_new();
Data_Get_Struct(info_obj, Info, info);
// Convert the images array to an images sequence.
images = images_from_imagelist(self);
exception = AcquireExceptionInfo();
(void) SetImageInfo(info, MagickTrue, exception);
rm_check_exception(exception, images, RetainOnError);
if (*info->magick != '\0')
{
Image *img;
for (img = images; img; img = GetNextImageInList(img))
{
strncpy(img->magick, info->magick, sizeof(info->magick)-1);
}
}
for (image = images; image; image = GetNextImageInList(image))
{
rm_sync_image_options(image, info);
}
// Unconditionally request multi-images support. The worst that
// can happen is that there's only one image or the format
// doesn't support multi-image files.
info->adjoin = MagickTrue;
blob = ImagesToBlob(info, images, &length, exception);
if (blob && exception->severity >= ErrorException)
{
magick_free((void*)blob);
blob = NULL;
length = 0;
}
rm_split(images);
CHECK_EXCEPTION()
(void) DestroyExceptionInfo(exception);
if (length == 0 || !blob)
{
return Qnil;
}
blob_str = rb_str_new(blob, (long)length);
magick_free((void*)blob);
return blob_str;
}
|
#uniq ⇒ Object
1861 1862 1863 1864 1865 1866 1867 |
# File 'lib/rmagick_internal.rb', line 1861 def uniq current = get_current() a = self.class.new @images.uniq.each {|image| a << image} a.set_current current return a end |
#uniq!(*args) ⇒ Object
1869 1870 1871 1872 1873 1874 |
# File 'lib/rmagick_internal.rb', line 1869 def uniq!(*args) current = get_current() a = @images.uniq! set_current current return a.nil? ? nil : self end |
#unshift(obj) ⇒ Object
1877 1878 1879 1880 1881 1882 |
# File 'lib/rmagick_internal.rb', line 1877 def unshift(obj) is_an_image obj @images.unshift(obj) @scene = 0 self end |
#values_at(*args) ⇒ Object Also known as: indexes, indices
1884 1885 1886 1887 1888 1889 1890 |
# File 'lib/rmagick_internal.rb', line 1884 def values_at(*args) a = @images.values_at(*args) a = self.class.new @images.values_at(*args).each {|image| a << image} a.scene = a.length - 1 return a end |
#write(file) ⇒ Object
Write all the images to the specified file. If the file format supports multi-image files, and the ‘images’ array contains more than one image, then the images will be written as a single multi-image file. Otherwise each image will be written to a separate file.
Ruby usage:
- @verbatim ImageList#write(file) @endverbatim
1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234 |
# File 'ext/RMagick/rmilist.c', line 1161
VALUE
ImageList_write(VALUE self, VALUE file)
{
Image *images, *img;
Info *info;
const MagickInfo *m;
volatile VALUE info_obj;
unsigned long scene;
ExceptionInfo *exception;
info_obj = rm_info_new();
Data_Get_Struct(info_obj, Info, info);
if (TYPE(file) == T_FILE)
{
OpenFile *fptr;
// Ensure file is open - raise error if not
GetOpenFile(file, fptr);
#if defined(_WIN32)
add_format_prefix(info, fptr->pathv);
SetImageInfoFile(info, NULL);
#else
SetImageInfoFile(info, GetReadFile(fptr));
#endif
}
else
{
add_format_prefix(info, file);
SetImageInfoFile(info, NULL);
}
// Convert the images array to an images sequence.
images = images_from_imagelist(self);
// Copy the filename into each image. Set a scene number to be used if
// writing multiple files. (Ref: ImageMagick's utilities/convert.c
for (scene = 0, img = images; img; img = GetNextImageInList(img))
{
img->scene = scene++;
strcpy(img->filename, info->filename);
}
// Find out if the format supports multi-images files.
exception = AcquireExceptionInfo();
(void) SetImageInfo(info, MagickTrue, exception);
rm_check_exception(exception, images, RetainOnError);
m = GetMagickInfo(info->magick, exception);
rm_check_exception(exception, images, RetainOnError);
(void) DestroyExceptionInfo(exception);
// Tell WriteImage if we want a multi-images file.
if (imagelist_length(self) > 1L && m->adjoin)
{
info->adjoin = MagickTrue;
}
for (img = images; img; img = GetNextImageInList(img))
{
rm_sync_image_options(img, info);
(void) WriteImage(info, img);
// images will be split before raising an exception
rm_check_image_exception(images, RetainOnError);
if (info->adjoin)
{
break;
}
}
rm_split(images);
return self;
}
|