diff scripts/image/imread.m @ 17118:c97a26408ee0

Implement PixelRegion option for imread(). * imread.m: document new option. * private/__imread__.m: parse new option and set defaults. * __magick_read__.cc (calculate region): new option to calculate the region to be read, shifts in memory required, and output image size. (read_indexed_images, read_images): implement reading of only specific regions of an image. (__magick_read__): get octave_scalar_map at start for simplicity.
author Carnë Draug <carandraug@octave.org>
date Wed, 31 Jul 2013 21:28:48 +0100
parents 3db796f89695
children d6499c14021c
line wrap: on
line diff
--- a/scripts/image/imread.m	Wed Jul 31 21:25:04 2013 +0200
+++ b/scripts/image/imread.m	Wed Jul 31 21:28:48 2013 +0100
@@ -65,6 +65,12 @@
 ## This option exists for @sc{Matlab} compatibility and has no effect.  For
 ## maximum performance while reading multiple images from a single file,
 ## use the Index option.
+##
+## @item "PixelRegion"
+## Controls the image region that is read.  Takes as value a cell array
+## with two arrays of 3 elements @code{@{@var{rows} @var{cols}@}}.  The
+## elements in the array are the start, increment and end pixel to be
+## read.  If the increment value is ommited, defaults to 1.
 ## @end table
 ##
 ## @seealso{imwrite, imfinfo, imformats}