the cookbook said we couldn't limit image sizes, but we can now. Fix

[imager.git] / Imager.pm
diff --git a/Imager.pm b/Imager.pm

index fb3d026f8bb19d30b71313734fa9749f6665e8bc..1c2f11e15d13d70b8030ac78ed99fc879161cf46 100644 (file)
--- a/Imager.pm
+++ b/Imager.pm
@@ -35,7 +35,7 @@ use Imager::Font;
                 i_img_setmask
                 i_img_getmask
  
                 i_img_setmask
                 i_img_getmask
  
-               i_draw
+               i_line
                 i_line_aa
                 i_box
                 i_box_filled
                 i_line_aa
                 i_box
                 i_box_filled
@@ -143,13 +143,28 @@ use Imager::Font;
                   unload_plugin
                  )]);
  
                   unload_plugin
                  )]);
  
+# registered file readers
+my %readers;
+
+# registered file writers
+my %writers;
+
+# modules we attempted to autoload
+my %attempted_to_load;
+
  BEGIN {
    require Exporter;
  BEGIN {
    require Exporter;
-  require DynaLoader;
-
-  $VERSION = '0.39';
-  @ISA = qw(Exporter DynaLoader);
-  bootstrap Imager $VERSION;
+  @ISA = qw(Exporter);
+  $VERSION = '0.51_02';
+  eval {
+    require XSLoader;
+    XSLoader::load(Imager => $VERSION);
+    1;
+  } or do {
+    require DynaLoader;
+    push @ISA, 'DynaLoader';
+    bootstrap Imager $VERSION;
+  }
  }
  
  BEGIN {
  }
  
  BEGIN {
@@ -221,17 +236,40 @@ BEGIN {
                        callsub => sub { my %hsh=@_; i_conv($hsh{image},$hsh{coef}); }
                       };
  
                        callsub => sub { my %hsh=@_; i_conv($hsh{image},$hsh{coef}); }
                       };
  
-  $filters{gradgen} ={
-                      callseq => ['image', 'xo', 'yo', 'colors', 'dist'],
-                      defaults => { },
-                      callsub => sub { my %hsh=@_; i_gradgen($hsh{image}, $hsh{xo}, $hsh{yo}, $hsh{colors}, $hsh{dist}); }
-                     };
+  $filters{gradgen} =
+    {
+     callseq => ['image', 'xo', 'yo', 'colors', 'dist'],
+     defaults => { dist => 0 },
+     callsub => 
+     sub { 
+       my %hsh=@_;
+       my @colors = @{$hsh{colors}};
+       $_ = _color($_)
+         for @colors;
+       i_gradgen($hsh{image}, $hsh{xo}, $hsh{yo}, \@colors, $hsh{dist});
+     }
+    };
  
  
-  $filters{nearest_color} ={
-                           callseq => ['image', 'xo', 'yo', 'colors', 'dist'],
-                           defaults => { },
-                           callsub => sub { my %hsh=@_; i_nearest_color($hsh{image}, $hsh{xo}, $hsh{yo}, $hsh{colors}, $hsh{dist}); }
-                          };
+  $filters{nearest_color} =
+    {
+     callseq => ['image', 'xo', 'yo', 'colors', 'dist'],
+     defaults => { },
+     callsub => 
+     sub { 
+       my %hsh=@_; 
+       # make sure the segments are specified with colors
+       my @colors;
+       for my $color (@{$hsh{colors}}) {
+         my $new_color = _color($color) 
+           or die $Imager::ERRSTR."\n";
+         push @colors, $new_color;
+       }
+
+       i_nearest_color($hsh{image}, $hsh{xo}, $hsh{yo}, \@colors, 
+                       $hsh{dist})
+         or die Imager->_error_as_msg() . "\n";
+     },
+    };
    $filters{gaussian} = {
                          callseq => [ 'image', 'stddev' ],
                          defaults => { },
    $filters{gaussian} = {
                          callseq => [ 'image', 'stddev' ],
                          defaults => { },
@@ -346,9 +384,20 @@ BEGIN {
       callsub  => 
       sub {
         my %hsh = @_;
       callsub  => 
       sub {
         my %hsh = @_;
+
+       # make sure the segments are specified with colors
+       my @segments;
+       for my $segment (@{$hsh{segments}}) {
+         my @new_segment = @$segment;
+         
+         $_ = _color($_) or die $Imager::ERRSTR."\n" for @new_segment[3,4];
+         push @segments, \@new_segment;
+       }
+
         i_fountain($hsh{image}, $hsh{xa}, $hsh{ya}, $hsh{xb}, $hsh{yb},
                    $hsh{ftype}, $hsh{repeat}, $hsh{combine}, $hsh{super_sample},
         i_fountain($hsh{image}, $hsh{xa}, $hsh{ya}, $hsh{xb}, $hsh{yb},
                    $hsh{ftype}, $hsh{repeat}, $hsh{combine}, $hsh{super_sample},
-                  $hsh{ssample_param}, $hsh{segments});
+                  $hsh{ssample_param}, \@segments)
+         or die Imager->_error_as_msg() . "\n";
       },
      };
    $filters{unsharpmask} =
       },
      };
    $filters{unsharpmask} =
@@ -382,11 +431,18 @@ BEGIN {
  #  print Dumper(@_);
  #}
  
  #  print Dumper(@_);
  #}
  
+sub init_log {
+  i_init_log($_[0],$_[1]);
+  i_log_entry("Imager $VERSION starting\n", 1);
+}
+
+
  sub init {
    my %parms=(loglevel=>1,@_);
    if ($parms{'log'}) {
      init_log($parms{'log'},$parms{'loglevel'});
    }
  sub init {
    my %parms=(loglevel=>1,@_);
    if ($parms{'log'}) {
      init_log($parms{'log'},$parms{'loglevel'});
    }
+
    if (exists $parms{'warn_obsolete'}) {
      $warn_obsolete = $parms{'warn_obsolete'};
    }
    if (exists $parms{'warn_obsolete'}) {
      $warn_obsolete = $parms{'warn_obsolete'};
    }
@@ -396,6 +452,9 @@ sub init {
  #      i_init_fonts();
  #      $fontstate='ok';
  #    }
  #      i_init_fonts();
  #      $fontstate='ok';
  #    }
+  if (exists $parms{'t1log'}) {
+    i_init_fonts($parms{'t1log'});
+  }
  }
  
  END {
  }
  
  END {
@@ -478,12 +537,7 @@ sub _color {
          $result = Imager::Color->new(%$arg);
        }
        elsif ($copy =~ /^ARRAY\(/) {
          $result = Imager::Color->new(%$arg);
        }
        elsif ($copy =~ /^ARRAY\(/) {
-        if (grep $_ > 1, @$arg) {
-          $result = Imager::Color->new(@$arg);
-        }
-        else {
-          $result = Imager::Color::Float->new(@$arg);
-        }
+       $result = Imager::Color->new(@$arg);
        }
        else {
          $Imager::ERRSTR = "Not a color";
        }
        else {
          $Imager::ERRSTR = "Not a color";
@@ -516,7 +570,12 @@ sub new {
    $self->{ERRSTR}=undef; #
    $self->{DEBUG}=$DEBUG;
    $self->{DEBUG} && print "Initialized Imager\n";
    $self->{ERRSTR}=undef; #
    $self->{DEBUG}=$DEBUG;
    $self->{DEBUG} && print "Initialized Imager\n";
-  if ($hsh{xsize} && $hsh{ysize}) { $self->img_set(%hsh); }
+  if (defined $hsh{xsize} && defined $hsh{ysize}) { 
+    unless ($self->img_set(%hsh)) {
+      $Imager::ERRSTR = $self->{ERRSTR};
+      return;
+    }
+  }
    return $self;
  }
  
    return $self;
  }
  
@@ -527,9 +586,14 @@ sub copy {
    my $self = shift;
    unless ($self->{IMG}) { $self->{ERRSTR}='empty input image'; return undef; }
  
    my $self = shift;
    unless ($self->{IMG}) { $self->{ERRSTR}='empty input image'; return undef; }
  
+  unless (defined wantarray) {
+    my @caller = caller;
+    warn "copy() called in void context - copy() returns the copied image at $caller[1] line $caller[2]\n";
+    return;
+  }
+
    my $newcopy=Imager->new();
    my $newcopy=Imager->new();
-  $newcopy->{IMG}=i_img_new();
-  i_copy($newcopy->{IMG},$self->{IMG});
+  $newcopy->{IMG} = i_copy($self->{IMG});
    return $newcopy;
  }
  
    return $newcopy;
  }
  
@@ -537,19 +601,68 @@ sub copy {
  
  sub paste {
    my $self = shift;
  
  sub paste {
    my $self = shift;
-  unless ($self->{IMG}) { $self->{ERRSTR}='empty input image'; return undef; }
-  my %input=(left=>0, top=>0, @_);
-  unless($input{img}) {
-    $self->{ERRSTR}="no source image";
+
+  unless ($self->{IMG}) { 
+    $self->_set_error('empty input image');
+    return;
+  }
+  my %input=(left=>0, top=>0, src_minx => 0, src_miny => 0, @_);
+  my $src = $input{img} || $input{src};
+  unless($src) {
+    $self->_set_error("no source image");
      return;
    }
    $input{left}=0 if $input{left} <= 0;
    $input{top}=0 if $input{top} <= 0;
      return;
    }
    $input{left}=0 if $input{left} <= 0;
    $input{top}=0 if $input{top} <= 0;
-  my $src=$input{img};
+
    my($r,$b)=i_img_info($src->{IMG});
    my($r,$b)=i_img_info($src->{IMG});
+  my ($src_left, $src_top) = @input{qw/src_minx src_miny/};
+  my ($src_right, $src_bottom);
+  if ($input{src_coords}) {
+    ($src_left, $src_top, $src_right, $src_bottom) = @{$input{src_coords}}
+  }
+  else {
+    if (defined $input{src_maxx}) {
+      $src_right = $input{src_maxx};
+    }
+    elsif (defined $input{width}) {
+      if ($input{width} <= 0) {
+        $self->_set_error("paste: width must me positive");
+        return;
+      }
+      $src_right = $src_left + $input{width};
+    }
+    else {
+      $src_right = $r;
+    }
+    if (defined $input{src_maxy}) {
+      $src_bottom = $input{src_maxy};
+    }
+    elsif (defined $input{height}) {
+      if ($input{height} < 0) {
+        $self->_set_error("paste: height must be positive");
+        return;
+      }
+      $src_bottom = $src_top + $input{height};
+    }
+    else {
+      $src_bottom = $b;
+    }
+  }
+
+  $src_right > $r and $src_right = $r;
+  $src_bottom > $b and $src_bottom = $b;
+
+  if ($src_right <= $src_left
+      || $src_bottom < $src_top) {
+    $self->_set_error("nothing to paste");
+    return;
+  }
  
    i_copyto($self->{IMG}, $src->{IMG}, 
  
    i_copyto($self->{IMG}, $src->{IMG}, 
-          0,0, $r, $b, $input{left}, $input{top});
+          $src_left, $src_top, $src_right, $src_bottom, 
+           $input{left}, $input{top});
+
    return $self;  # What should go here??
  }
  
    return $self;  # What should go here??
  }
  
@@ -558,46 +671,111 @@ sub paste {
  sub crop {
    my $self=shift;
    unless ($self->{IMG}) { $self->{ERRSTR}='empty input image'; return undef; }
  sub crop {
    my $self=shift;
    unless ($self->{IMG}) { $self->{ERRSTR}='empty input image'; return undef; }
-  my %hsh=(left=>0,right=>0,top=>0,bottom=>0,@_);
+  
+  unless (defined wantarray) {
+    my @caller = caller;
+    warn "crop() called in void context - crop() returns the cropped image at $caller[1] line $caller[2]\n";
+    return;
+  }
  
  
-  my ($w,$h,$l,$r,$b,$t)=($self->getwidth(),$self->getheight(),
-                               @hsh{qw(left right bottom top)});
-  $l=0 if not defined $l;
-  $t=0 if not defined $t;
+  my %hsh=@_;
  
  
-  $r||=$l+delete $hsh{'width'}    if defined $l and exists $hsh{'width'};
-  $b||=$t+delete $hsh{'height'}   if defined $t and exists $hsh{'height'};
-  $l||=$r-delete $hsh{'width'}    if defined $r and exists $hsh{'width'};
-  $t||=$b-delete $hsh{'height'}   if defined $b and exists $hsh{'height'};
+  my ($w, $h, $l, $r, $b, $t) =
+    @hsh{qw(width height left right bottom top)};
  
  
-  $r=$self->getwidth if not defined $r;
-  $b=$self->getheight if not defined $b;
+  # work through the various possibilities
+  if (defined $l) {
+    if (defined $w) {
+      $r = $l + $w;
+    }
+    elsif (!defined $r) {
+      $r = $self->getwidth;
+    }
+  }
+  elsif (defined $r) {
+    if (defined $w) {
+      $l = $r - $w;
+    }
+    else {
+      $l = 0;
+    }
+  }
+  elsif (defined $w) {
+    $l = int(0.5+($self->getwidth()-$w)/2);
+    $r = $l + $w;
+  }
+  else {
+    $l = 0;
+    $r = $self->getwidth;
+  }
+  if (defined $t) {
+    if (defined $h) {
+      $b = $t + $h;
+    }
+    elsif (!defined $b) {
+      $b = $self->getheight;
+    }
+  }
+  elsif (defined $b) {
+    if (defined $h) {
+      $t = $b - $h;
+    }
+    else {
+      $t = 0;
+    }
+  }
+  elsif (defined $h) {
+    $t=int(0.5+($self->getheight()-$h)/2);
+    $b=$t+$h;
+  }
+  else {
+    $t = 0;
+    $b = $self->getheight;
+  }
  
    ($l,$r)=($r,$l) if $l>$r;
    ($t,$b)=($b,$t) if $t>$b;
  
  
    ($l,$r)=($r,$l) if $l>$r;
    ($t,$b)=($b,$t) if $t>$b;
  
-  if ($hsh{'width'}) {
-    $l=int(0.5+($w-$hsh{'width'})/2);
-    $r=$l+$hsh{'width'};
-  } else {
-    $hsh{'width'}=$r-$l;
-  }
-  if ($hsh{'height'}) {
-    $b=int(0.5+($h-$hsh{'height'})/2);
-    $t=$h+$hsh{'height'};
-  } else {
-    $hsh{'height'}=$b-$t;
-  }
+  $l < 0 and $l = 0;
+  $r > $self->getwidth and $r = $self->getwidth;
+  $t < 0 and $t = 0;
+  $b > $self->getheight and $b = $self->getheight;
  
  
-#    print "l=$l, r=$r, h=$hsh{'width'}\n";
-#    print "t=$t, b=$b, w=$hsh{'height'}\n";
+  if ($l == $r || $t == $b) {
+    $self->_set_error("resulting image would have no content");
+    return;
+  }
  
  
-  my $dst=Imager->new(xsize=>$hsh{'width'}, ysize=>$hsh{'height'}, channels=>$self->getchannels());
+  my $dst = $self->_sametype(xsize=>$r-$l, ysize=>$b-$t);
  
    i_copyto($dst->{IMG},$self->{IMG},$l,$t,$r,$b,0,0);
    return $dst;
  }
  
  
    i_copyto($dst->{IMG},$self->{IMG},$l,$t,$r,$b,0,0);
    return $dst;
  }
  
+sub _sametype {
+  my ($self, %opts) = @_;
+
+  $self->{IMG} or return $self->_set_error("Not a valid image");
+
+  my $x = $opts{xsize} || $self->getwidth;
+  my $y = $opts{ysize} || $self->getheight;
+  my $channels = $opts{channels} || $self->getchannels;
+  
+  my $out = Imager->new;
+  if ($channels == $self->getchannels) {
+    $out->{IMG} = i_sametype($self->{IMG}, $x, $y);
+  }
+  else {
+    $out->{IMG} = i_sametype_chans($self->{IMG}, $x, $y, $channels);
+  }
+  unless ($out->{IMG}) {
+    $self->{ERRSTR} = $self->_error_as_msg;
+    return;
+  }
+  
+  return $out;
+}
+
  # Sets an image to a certain size and channel number
  # if there was previously data in the image it is discarded
  
  # Sets an image to a certain size and channel number
  # if there was previously data in the image it is discarded
  
@@ -627,6 +805,13 @@ sub img_set {
      $self->{IMG}=Imager::ImgRaw::new($hsh{'xsize'}, $hsh{'ysize'},
                                       $hsh{'channels'});
    }
      $self->{IMG}=Imager::ImgRaw::new($hsh{'xsize'}, $hsh{'ysize'},
                                       $hsh{'channels'});
    }
+
+  unless ($self->{IMG}) {
+    $self->{ERRSTR} = Imager->_error_as_msg();
+    return;
+  }
+
+  $self;
  }
  
  # created a masked version of the current image
  }
  
  # created a masked version of the current image
@@ -663,14 +848,24 @@ sub to_paletted {
      $opts = shift;
    }
  
      $opts = shift;
    }
  
+  unless (defined wantarray) {
+    my @caller = caller;
+    warn "to_paletted() called in void context - to_paletted() returns the converted image at $caller[1] line $caller[2]\n";
+    return;
+  }
+
    my $result = Imager->new;
    $result->{IMG} = i_img_to_pal($self->{IMG}, $opts);
  
    #print "Type ", i_img_type($result->{IMG}), "\n";
  
    my $result = Imager->new;
    $result->{IMG} = i_img_to_pal($self->{IMG}, $opts);
  
    #print "Type ", i_img_type($result->{IMG}), "\n";
  
-  $result->{IMG} or undef $result;
-
-  return $result;
+  if ($result->{IMG}) {
+    return $result;
+  }
+  else {
+    $self->{ERRSTR} = $self->_error_as_msg;
+    return;
+  }
  }
  
  # convert a paletted (or any image) to an 8-bit/channel RGB images
  }
  
  # convert a paletted (or any image) to an 8-bit/channel RGB images
@@ -678,6 +873,12 @@ sub to_rgb8 {
    my $self = shift;
    my $result;
  
    my $self = shift;
    my $result;
  
+  unless (defined wantarray) {
+    my @caller = caller;
+    warn "to_rgb8() called in void context - to_rgb8() returns the cropped image at $caller[1] line $caller[2]\n";
+    return;
+  }
+
    if ($self->{IMG}) {
      $result = Imager->new;
      $result->{IMG} = i_img_to_rgb($self->{IMG})
    if ($self->{IMG}) {
      $result = Imager->new;
      $result->{IMG} = i_img_to_rgb($self->{IMG})
@@ -691,17 +892,46 @@ sub addcolors {
    my $self = shift;
    my %opts = (colors=>[], @_);
  
    my $self = shift;
    my %opts = (colors=>[], @_);
  
-  @{$opts{colors}} or return undef;
+  unless ($self->{IMG}) {
+    $self->_set_error("empty input image");
+    return;
+  }
+
+  my @colors = @{$opts{colors}}
+    or return undef;
+
+  for my $color (@colors) {
+    $color = _color($color);
+    unless ($color) {
+      $self->_set_error($Imager::ERRSTR);
+      return;
+    }  
+  }
  
  
-  $self->{IMG} and i_addcolors($self->{IMG}, @{$opts{colors}});
+  return i_addcolors($self->{IMG}, @colors);
  }
  
  sub setcolors {
    my $self = shift;
    my %opts = (start=>0, colors=>[], @_);
  }
  
  sub setcolors {
    my $self = shift;
    my %opts = (start=>0, colors=>[], @_);
-  @{$opts{colors}} or return undef;
  
  
-  $self->{IMG} and i_setcolors($self->{IMG}, $opts{start}, @{$opts{colors}});
+  unless ($self->{IMG}) {
+    $self->_set_error("empty input image");
+    return;
+  }
+
+  my @colors = @{$opts{colors}}
+    or return undef;
+
+  for my $color (@colors) {
+    $color = _color($color);
+    unless ($color) {
+      $self->_set_error($Imager::ERRSTR);
+      return;
+    }  
+  }
+
+  return i_setcolors($self->{IMG}, $opts{start}, @colors);
  }
  
  sub getcolors {
  }
  
  sub getcolors {
@@ -880,14 +1110,14 @@ sub settag {
    }
  }
  
    }
  }
  
-my @needseekcb = qw/tiff/;
-my %needseekcb = map { $_, $_ } @needseekcb;
-
  
  sub _get_reader_io {
  
  sub _get_reader_io {
-  my ($self, $input, $type) = @_;
+  my ($self, $input) = @_;
  
  
-  if ($input->{fd}) {
+       if ($input->{io}) {
+               return $input->{io}, undef;
+       }
+  elsif ($input->{fd}) {
      return io_new_fd($input->{fd});
    }
    elsif ($input->{fh}) {
      return io_new_fd($input->{fd});
    }
    elsif ($input->{fh}) {
@@ -911,8 +1141,8 @@ sub _get_reader_io {
      return io_new_buffer($input->{data});
    }
    elsif ($input->{callback} || $input->{readcb}) {
      return io_new_buffer($input->{data});
    }
    elsif ($input->{callback} || $input->{readcb}) {
-    if ($needseekcb{$type} && !$input->{seekcb}) {
-      $self->_set_error("Format $type needs a seekcb parameter");
+    if (!$input->{seekcb}) {
+      $self->_set_error("Need a seekcb parameter");
      }
      if ($input->{maxbuffer}) {
        return io_new_cb($input->{writecb},
      }
      if ($input->{maxbuffer}) {
        return io_new_cb($input->{writecb},
@@ -995,207 +1225,259 @@ sub read {
      undef($self->{IMG});
    }
  
      undef($self->{IMG});
    }
  
-  # FIXME: Find the format here if not specified
-  # yes the code isn't here yet - next week maybe?
-  # Next week?  Are you high or something?  That comment
-  # has been there for half a year dude.
-  # Look, i just work here, ok?
+  my ($IO, $fh) = $self->_get_reader_io(\%input) or return;
  
  
-  if (!$input{'type'} and $input{file}) {
-    $input{'type'}=$FORMATGUESS->($input{file});
+  unless ($input{'type'}) {
+    $input{'type'} = i_test_format_probe($IO, -1);
    }
    }
+
    unless ($input{'type'}) {
    unless ($input{'type'}) {
-    $self->_set_error('type parameter missing and not possible to guess from extension'); 
+         $self->_set_error('type parameter missing and not possible to guess from extension'); 
      return undef;
    }
      return undef;
    }
-  if (!$formats{$input{'type'}}) {
-    $self->{ERRSTR}='format not supported'; return undef;
-  }
  
  
-  my %iolready=(jpeg=>1, png=>1, tiff=>1, pnm=>1, raw=>1, bmp=>1, tga=>1, rgb=>1, gif=>1);
+  _reader_autoload($input{type});
+
+  if ($readers{$input{type}} && $readers{$input{type}}{single}) {
+    return $readers{$input{type}}{single}->($self, $IO, %input);
+  }
  
  
-  if ($iolready{$input{'type'}}) {
-    # Setup data source
-    my ($IO, $fh) = $self->_get_reader_io(\%input, $input{'type'})
-      or return;
+  unless ($formats{$input{'type'}}) {
+    $self->_set_error("format '$input{'type'}' not supported");
+    return;
+  }
  
  
-    if ( $input{'type'} eq 'jpeg' ) {
-      ($self->{IMG},$self->{IPTCRAW})=i_readjpeg_wiol( $IO );
-      if ( !defined($self->{IMG}) ) {
-       $self->{ERRSTR}='unable to read jpeg image'; return undef;
-      }
-      $self->{DEBUG} && print "loading a jpeg file\n";
-      return $self;
+  # Setup data source
+  if ( $input{'type'} eq 'jpeg' ) {
+    ($self->{IMG},$self->{IPTCRAW}) = i_readjpeg_wiol( $IO );
+    if ( !defined($self->{IMG}) ) {
+      $self->{ERRSTR}=$self->_error_as_msg(); return undef;
      }
      }
+    $self->{DEBUG} && print "loading a jpeg file\n";
+    return $self;
+  }
  
  
-    if ( $input{'type'} eq 'tiff' ) {
-      $self->{IMG}=i_readtiff_wiol( $IO, -1 ); # Fixme, check if that length parameter is ever needed
-      if ( !defined($self->{IMG}) ) {
-       $self->{ERRSTR}=$self->_error_as_msg(); return undef;
-      }
-      $self->{DEBUG} && print "loading a tiff file\n";
-      return $self;
+  if ( $input{'type'} eq 'tiff' ) {
+    my $page = $input{'page'};
+    defined $page or $page = 0;
+    # Fixme, check if that length parameter is ever needed
+    $self->{IMG}=i_readtiff_wiol( $IO, -1, $page ); 
+    if ( !defined($self->{IMG}) ) {
+      $self->{ERRSTR}=$self->_error_as_msg(); return undef;
      }
      }
+    $self->{DEBUG} && print "loading a tiff file\n";
+    return $self;
+  }
  
  
-    if ( $input{'type'} eq 'pnm' ) {
-      $self->{IMG}=i_readpnm_wiol( $IO, -1 ); # Fixme, check if that length parameter is ever needed
-      if ( !defined($self->{IMG}) ) {
-       $self->{ERRSTR}='unable to read pnm image: '._error_as_msg(); return undef;
-      }
-      $self->{DEBUG} && print "loading a pnm file\n";
-      return $self;
+  if ( $input{'type'} eq 'pnm' ) {
+    $self->{IMG}=i_readpnm_wiol( $IO, -1 ); # Fixme, check if that length parameter is ever needed
+    if ( !defined($self->{IMG}) ) {
+      $self->{ERRSTR}='unable to read pnm image: '._error_as_msg(); 
+      return undef;
      }
      }
+    $self->{DEBUG} && print "loading a pnm file\n";
+    return $self;
+  }
  
  
-    if ( $input{'type'} eq 'png' ) {
-      $self->{IMG}=i_readpng_wiol( $IO, -1 ); # Fixme, check if that length parameter is ever needed
-      if ( !defined($self->{IMG}) ) {
-       $self->{ERRSTR}='unable to read png image';
-       return undef;
-      }
-      $self->{DEBUG} && print "loading a png file\n";
+  if ( $input{'type'} eq 'png' ) {
+    $self->{IMG}=i_readpng_wiol( $IO, -1 ); # Fixme, check if that length parameter is ever needed
+    if ( !defined($self->{IMG}) ) {
+      $self->{ERRSTR} = $self->_error_as_msg();
+      return undef;
      }
      }
+    $self->{DEBUG} && print "loading a png file\n";
+  }
  
  
-    if ( $input{'type'} eq 'bmp' ) {
-      $self->{IMG}=i_readbmp_wiol( $IO );
-      if ( !defined($self->{IMG}) ) {
-       $self->{ERRSTR}=$self->_error_as_msg();
-       return undef;
-      }
-      $self->{DEBUG} && print "loading a bmp file\n";
+  if ( $input{'type'} eq 'bmp' ) {
+    $self->{IMG}=i_readbmp_wiol( $IO );
+    if ( !defined($self->{IMG}) ) {
+      $self->{ERRSTR}=$self->_error_as_msg();
+      return undef;
      }
      }
+    $self->{DEBUG} && print "loading a bmp file\n";
+  }
  
  
-    if ( $input{'type'} eq 'gif' ) {
-      if ($input{colors} && !ref($input{colors})) {
-       # must be a reference to a scalar that accepts the colour map
-       $self->{ERRSTR} = "option 'colors' must be a scalar reference";
-       return undef;
-      }
+  if ( $input{'type'} eq 'gif' ) {
+    if ($input{colors} && !ref($input{colors})) {
+      # must be a reference to a scalar that accepts the colour map
+      $self->{ERRSTR} = "option 'colors' must be a scalar reference";
+      return undef;
+    }
+    if ($input{'gif_consolidate'}) {
        if ($input{colors}) {
        if ($input{colors}) {
-        my $colors;
-        ($self->{IMG}, $colors) =i_readgif_wiol( $IO );
-        if ($colors) {
-          ${ $input{colors} } = [ map { NC(@$_) } @$colors ];
-        }
+       my $colors;
+       ($self->{IMG}, $colors) =i_readgif_wiol( $IO );
+       if ($colors) {
+         ${ $input{colors} } = [ map { NC(@$_) } @$colors ];
+       }
        }
        else {
        }
        else {
-        $self->{IMG} =i_readgif_wiol( $IO );
+       $self->{IMG} =i_readgif_wiol( $IO );
        }
        }
-      if ( !defined($self->{IMG}) ) {
-       $self->{ERRSTR}=$self->_error_as_msg();
-       return undef;
+    }
+    else {
+      my $page = $input{'page'};
+      defined $page or $page = 0;
+      $self->{IMG} = i_readgif_single_wiol( $IO, $page );
+      if ($input{colors}) {
+       ${ $input{colors} } =
+         [ i_getcolors($self->{IMG}, 0, i_colorcount($self->{IMG})) ];
        }
        }
-      $self->{DEBUG} && print "loading a gif file\n";
      }
  
      }
  
-    if ( $input{'type'} eq 'tga' ) {
-      $self->{IMG}=i_readtga_wiol( $IO, -1 ); # Fixme, check if that length parameter is ever needed
-      if ( !defined($self->{IMG}) ) {
-       $self->{ERRSTR}=$self->_error_as_msg();
-       return undef;
-      }
-      $self->{DEBUG} && print "loading a tga file\n";
+    if ( !defined($self->{IMG}) ) {
+      $self->{ERRSTR}=$self->_error_as_msg();
+      return undef;
      }
      }
+    $self->{DEBUG} && print "loading a gif file\n";
+  }
  
  
-    if ( $input{'type'} eq 'rgb' ) {
-      $self->{IMG}=i_readrgb_wiol( $IO, -1 ); # Fixme, check if that length parameter is ever needed
-      if ( !defined($self->{IMG}) ) {
-       $self->{ERRSTR}=$self->_error_as_msg();
-       return undef;
-      }
-      $self->{DEBUG} && print "loading a tga file\n";
+  if ( $input{'type'} eq 'tga' ) {
+    $self->{IMG}=i_readtga_wiol( $IO, -1 ); # Fixme, check if that length parameter is ever needed
+    if ( !defined($self->{IMG}) ) {
+      $self->{ERRSTR}=$self->_error_as_msg();
+      return undef;
      }
      }
+    $self->{DEBUG} && print "loading a tga file\n";
+  }
  
  
+  if ( $input{'type'} eq 'rgb' ) {
+    $self->{IMG}=i_readrgb_wiol( $IO, -1 ); # Fixme, check if that length parameter is ever needed
+    if ( !defined($self->{IMG}) ) {
+      $self->{ERRSTR}=$self->_error_as_msg();
+      return undef;
+    }
+    $self->{DEBUG} && print "loading a tga file\n";
+  }
  
  
-    if ( $input{'type'} eq 'raw' ) {
-      my %params=(datachannels=>3,storechannels=>3,interleave=>1,%input);
  
  
-      if ( !($params{xsize} && $params{ysize}) ) {
-       $self->{ERRSTR}='missing xsize or ysize parameter for raw';
-       return undef;
-      }
+  if ( $input{'type'} eq 'raw' ) {
+    my %params=(datachannels=>3,storechannels=>3,interleave=>1,%input);
  
  
-      $self->{IMG} = i_readraw_wiol( $IO,
-                                    $params{xsize},
-                                    $params{ysize},
-                                    $params{datachannels},
-                                    $params{storechannels},
-                                    $params{interleave});
-      if ( !defined($self->{IMG}) ) {
-       $self->{ERRSTR}='unable to read raw image';
-       return undef;
-      }
-      $self->{DEBUG} && print "loading a raw file\n";
+    if ( !($params{xsize} && $params{ysize}) ) {
+      $self->{ERRSTR}='missing xsize or ysize parameter for raw';
+      return undef;
      }
  
      }
  
-  } else {
+    $self->{IMG} = i_readraw_wiol( $IO,
+                                  $params{xsize},
+                                  $params{ysize},
+                                  $params{datachannels},
+                                  $params{storechannels},
+                                  $params{interleave});
+    if ( !defined($self->{IMG}) ) {
+      $self->{ERRSTR}=$self->_error_as_msg();
+      return undef;
+    }
+    $self->{DEBUG} && print "loading a raw file\n";
+  }
  
  
-    # Old code for reference while changing the new stuff
+  return $self;
+}
  
  
-    if (!$input{'type'} and $input{file}) {
-      $input{'type'}=$FORMATGUESS->($input{file});
-    }
+sub register_reader {
+  my ($class, %opts) = @_;
  
  
-    if (!$input{'type'}) {
-      $self->{ERRSTR}='type parameter missing and not possible to guess from extension'; return undef;
-    }
+  defined $opts{type}
+    or die "register_reader called with no type parameter\n";
  
  
-    if (!$formats{$input{'type'}}) {
-      $self->{ERRSTR}='format not supported';
-      return undef;
-    }
+  my $type = $opts{type};
  
  
-    my ($fh, $fd);
-    if ($input{file}) {
-      $fh = new IO::File($input{file},"r");
-      if (!defined $fh) {
-       $self->{ERRSTR}='Could not open file';
-       return undef;
+  defined $opts{single} || defined $opts{multiple}
+    or die "register_reader called with no single or multiple parameter\n";
+
+  $readers{$type} = {  };
+  if ($opts{single}) {
+    $readers{$type}{single} = $opts{single};
+  }
+  if ($opts{multiple}) {
+    $readers{$type}{multiple} = $opts{multiple};
+  }
+
+  return 1;
+}
+
+sub register_writer {
+  my ($class, %opts) = @_;
+
+  defined $opts{type}
+    or die "register_writer called with no type parameter\n";
+
+  my $type = $opts{type};
+
+  defined $opts{single} || defined $opts{multiple}
+    or die "register_writer called with no single or multiple parameter\n";
+
+  $writers{$type} = {  };
+  if ($opts{single}) {
+    $writers{$type}{single} = $opts{single};
+  }
+  if ($opts{multiple}) {
+    $writers{$type}{multiple} = $opts{multiple};
+  }
+
+  return 1;
+}
+
+# probes for an Imager::File::whatever module
+sub _reader_autoload {
+  my $type = shift;
+
+  return if $formats{$type} || $readers{$type};
+
+  return unless $type =~ /^\w+$/;
+
+  my $file = "Imager/File/\U$type\E.pm";
+
+  unless ($attempted_to_load{$file}) {
+    eval {
+      ++$attempted_to_load{$file};
+      require $file;
+    };
+    if ($@) {
+      # try to get a reader specific module
+      my $file = "Imager/File/\U$type\EReader.pm";
+      unless ($attempted_to_load{$file}) {
+       eval {
+         ++$attempted_to_load{$file};
+         require $file;
+       };
        }
        }
-      binmode($fh);
-      $fd = $fh->fileno();
      }
      }
+  }
+}
  
  
-    if ($input{fd}) {
-      $fd=$input{fd};
-    }
+# probes for an Imager::File::whatever module
+sub _writer_autoload {
+  my $type = shift;
  
  
-    if ( $input{'type'} eq 'gif' ) {
-      my $colors;
-      if ($input{colors} && !ref($input{colors})) {
-       # must be a reference to a scalar that accepts the colour map
-       $self->{ERRSTR} = "option 'colors' must be a scalar reference";
-       return undef;
-      }
-      if (exists $input{data}) {
-       if ($input{colors}) {
-         ($self->{IMG}, $colors) = i_readgif_scalar($input{data});
-       } else {
-         $self->{IMG}=i_readgif_scalar($input{data});
-       }
-      } else {
-       if ($input{colors}) {
-         ($self->{IMG}, $colors) = i_readgif( $fd );
-       } else {
-         $self->{IMG} = i_readgif( $fd )
-       }
-      }
-      if ($colors) {
-       # we may or may not change i_readgif to return blessed objects...
-       ${ $input{colors} } = [ map { NC(@$_) } @$colors ];
-      }
-      if ( !defined($self->{IMG}) ) {
-       $self->{ERRSTR}= 'reading GIF:'._error_as_msg();
-       return undef;
+  return if $formats{$type} || $readers{$type};
+
+  return unless $type =~ /^\w+$/;
+
+  my $file = "Imager/File/\U$type\E.pm";
+
+  unless ($attempted_to_load{$file}) {
+    eval {
+      ++$attempted_to_load{$file};
+      require $file;
+    };
+    if ($@) {
+      # try to get a writer specific module
+      my $file = "Imager/File/\U$type\EWriter.pm";
+      unless ($attempted_to_load{$file}) {
+       eval {
+         ++$attempted_to_load{$file};
+         require $file;
+       };
        }
        }
-      $self->{DEBUG} && print "loading a gif file\n";
      }
    }
      }
    }
-  return $self;
  }
  
  sub _fix_gif_positions {
    my ($opts, $opt, $msg, @imgs) = @_;
  }
  
  sub _fix_gif_positions {
    my ($opts, $opt, $msg, @imgs) = @_;
-  
+
    my $positions = $opts->{'gif_positions'};
    my $index = 0;
    for my $pos (@$positions) {
    my $positions = $opts->{'gif_positions'};
    my $index = 0;
    for my $pos (@$positions) {
@@ -1284,9 +1566,9 @@ sub _set_opts {
  # Write an image to file
  sub write {
    my $self = shift;
  # Write an image to file
  sub write {
    my $self = shift;
-  my %input=(jpegquality=>75, 
-            gifquant=>'mc', 
-            lmdither=>6.0, 
+  my %input=(jpegquality=>75,
+            gifquant=>'mc',
+            lmdither=>6.0,
              lmfixed=>[],
              idstring=>"",
              compress=>1,
              lmfixed=>[],
              idstring=>"",
              compress=>1,
@@ -1297,9 +1579,6 @@ sub write {
    $self->_set_opts(\%input, "i_", $self)
      or return undef;
  
    $self->_set_opts(\%input, "i_", $self)
      or return undef;
  
-  my %iolready=( tiff=>1, raw=>1, png=>1, pnm=>1, bmp=>1, jpeg=>1, tga=>1, 
-                 gif=>1 ); # this will be SO MUCH BETTER once they are all in there
-
    unless ($self->{IMG}) { $self->{ERRSTR}='empty input image'; return undef; }
  
    if (!$input{'type'} and $input{file}) { 
    unless ($self->{IMG}) { $self->{ERRSTR}='empty input image'; return undef; }
  
    if (!$input{'type'} and $input{file}) { 
@@ -1310,53 +1589,64 @@ sub write {
      return undef;
    }
  
      return undef;
    }
  
-  if (!$formats{$input{'type'}}) { $self->{ERRSTR}='format not supported'; return undef; }
-
-  my ($IO, $fh) = $self->_get_writer_io(\%input, $input{'type'})
-    or return undef;
+  _writer_autoload($input{type});
  
  
-  # this conditional is probably obsolete
-  if ($iolready{$input{'type'}}) {
+  my ($IO, $fh);
+  if ($writers{$input{type}} && $writers{$input{type}}{single}) {
+    ($IO, $fh) = $self->_get_writer_io(\%input, $input{'type'})
+      or return undef;
  
  
+    $writers{$input{type}}{single}->($self, $IO, %input)
+      or return undef;
+  }
+  else {
+    if (!$formats{$input{'type'}}) { 
+      $self->{ERRSTR}='format not supported'; 
+      return undef;
+    }
+    
+    ($IO, $fh) = $self->_get_writer_io(\%input, $input{'type'})
+      or return undef;
+    
      if ($input{'type'} eq 'tiff') {
        $self->_set_opts(\%input, "tiff_", $self)
          or return undef;
        $self->_set_opts(\%input, "exif_", $self)
          or return undef;
      if ($input{'type'} eq 'tiff') {
        $self->_set_opts(\%input, "tiff_", $self)
          or return undef;
        $self->_set_opts(\%input, "exif_", $self)
          or return undef;
-
+      
        if (defined $input{class} && $input{class} eq 'fax') {
        if (defined $input{class} && $input{class} eq 'fax') {
-       if (!i_writetiff_wiol_faxable($self->{IMG}, $IO, $input{fax_fine})) {
-         $self->{ERRSTR}='Could not write to buffer';
-         return undef;
-       }
+        if (!i_writetiff_wiol_faxable($self->{IMG}, $IO, $input{fax_fine})) {
+          $self->{ERRSTR} = $self->_error_as_msg();
+          return undef;
+        }
        } else {
        } else {
-       if (!i_writetiff_wiol($self->{IMG}, $IO)) {
-         $self->{ERRSTR}='Could not write to buffer';
-         return undef;
-       }
+        if (!i_writetiff_wiol($self->{IMG}, $IO)) {
+          $self->{ERRSTR} = $self->_error_as_msg();
+          return undef;
+        }
        }
      } elsif ( $input{'type'} eq 'pnm' ) {
        $self->_set_opts(\%input, "pnm_", $self)
          or return undef;
        if ( ! i_writeppm_wiol($self->{IMG},$IO) ) {
        }
      } elsif ( $input{'type'} eq 'pnm' ) {
        $self->_set_opts(\%input, "pnm_", $self)
          or return undef;
        if ( ! i_writeppm_wiol($self->{IMG},$IO) ) {
-       $self->{ERRSTR}='unable to write pnm image';
-       return undef;
+        $self->{ERRSTR} = $self->_error_as_msg();
+        return undef;
        }
        $self->{DEBUG} && print "writing a pnm file\n";
      } elsif ( $input{'type'} eq 'raw' ) {
        $self->_set_opts(\%input, "raw_", $self)
          or return undef;
        if ( !i_writeraw_wiol($self->{IMG},$IO) ) {
        }
        $self->{DEBUG} && print "writing a pnm file\n";
      } elsif ( $input{'type'} eq 'raw' ) {
        $self->_set_opts(\%input, "raw_", $self)
          or return undef;
        if ( !i_writeraw_wiol($self->{IMG},$IO) ) {
-       $self->{ERRSTR}='unable to write raw image';
-       return undef;
+        $self->{ERRSTR} = $self->_error_as_msg();
+        return undef;
        }
        $self->{DEBUG} && print "writing a raw file\n";
      } elsif ( $input{'type'} eq 'png' ) {
        $self->_set_opts(\%input, "png_", $self)
          or return undef;
        if ( !i_writepng_wiol($self->{IMG}, $IO) ) {
        }
        $self->{DEBUG} && print "writing a raw file\n";
      } elsif ( $input{'type'} eq 'png' ) {
        $self->_set_opts(\%input, "png_", $self)
          or return undef;
        if ( !i_writepng_wiol($self->{IMG}, $IO) ) {
-       $self->{ERRSTR}='unable to write png image';
-       return undef;
+        $self->{ERRSTR}='unable to write png image';
+        return undef;
        }
        $self->{DEBUG} && print "writing a png file\n";
      } elsif ( $input{'type'} eq 'jpeg' ) {
        }
        $self->{DEBUG} && print "writing a png file\n";
      } elsif ( $input{'type'} eq 'jpeg' ) {
@@ -1366,24 +1656,24 @@ sub write {
          or return undef;
        if ( !i_writejpeg_wiol($self->{IMG}, $IO, $input{jpegquality})) {
          $self->{ERRSTR} = $self->_error_as_msg();
          or return undef;
        if ( !i_writejpeg_wiol($self->{IMG}, $IO, $input{jpegquality})) {
          $self->{ERRSTR} = $self->_error_as_msg();
-       return undef;
+        return undef;
        }
        $self->{DEBUG} && print "writing a jpeg file\n";
      } elsif ( $input{'type'} eq 'bmp' ) {
        $self->_set_opts(\%input, "bmp_", $self)
          or return undef;
        if ( !i_writebmp_wiol($self->{IMG}, $IO) ) {
        }
        $self->{DEBUG} && print "writing a jpeg file\n";
      } elsif ( $input{'type'} eq 'bmp' ) {
        $self->_set_opts(\%input, "bmp_", $self)
          or return undef;
        if ( !i_writebmp_wiol($self->{IMG}, $IO) ) {
-       $self->{ERRSTR}='unable to write bmp image';
-       return undef;
+        $self->{ERRSTR}='unable to write bmp image';
+        return undef;
        }
        $self->{DEBUG} && print "writing a bmp file\n";
      } elsif ( $input{'type'} eq 'tga' ) {
        $self->_set_opts(\%input, "tga_", $self)
          or return undef;
        }
        $self->{DEBUG} && print "writing a bmp file\n";
      } elsif ( $input{'type'} eq 'tga' ) {
        $self->_set_opts(\%input, "tga_", $self)
          or return undef;
-
+      
        if ( !i_writetga_wiol($self->{IMG}, $IO, $input{wierdpack}, $input{compress}, $input{idstring}) ) {
        if ( !i_writetga_wiol($self->{IMG}, $IO, $input{wierdpack}, $input{compress}, $input{idstring}) ) {
-       $self->{ERRSTR}=$self->_error_as_msg();
-       return undef;
+        $self->{ERRSTR}=$self->_error_as_msg();
+        return undef;
        }
        $self->{DEBUG} && print "writing a tga file\n";
      } elsif ( $input{'type'} eq 'gif' ) {
        }
        $self->{DEBUG} && print "writing a tga file\n";
      } elsif ( $input{'type'} eq 'gif' ) {
@@ -1400,30 +1690,33 @@ sub write {
          $input{make_colors} = 'webmap'; # ignored
          $input{translate} = 'giflib';
        }
          $input{make_colors} = 'webmap'; # ignored
          $input{translate} = 'giflib';
        }
-      $rc = i_writegif_wiol($IO, \%input, $self->{IMG});
-    }
-
-    if (exists $input{'data'}) {
-      my $data = io_slurp($IO);
-      if (!$data) {
-       $self->{ERRSTR}='Could not slurp from buffer';
-       return undef;
+      if (!i_writegif_wiol($IO, \%input, $self->{IMG})) {
+        $self->{ERRSTR} = $self->_error_as_msg;
+        return;
        }
        }
-      ${$input{data}} = $data;
      }
      }
-    return $self;
    }
  
    }
  
+  if (exists $input{'data'}) {
+    my $data = io_slurp($IO);
+    if (!$data) {
+      $self->{ERRSTR}='Could not slurp from buffer';
+      return undef;
+    }
+    ${$input{data}} = $data;
+  }
    return $self;
  }
  
  sub write_multi {
    my ($class, $opts, @images) = @_;
  
    return $self;
  }
  
  sub write_multi {
    my ($class, $opts, @images) = @_;
  
-  if (!$opts->{'type'} && $opts->{'file'}) {
-    $opts->{'type'} = $FORMATGUESS->($opts->{'file'});
+  my $type = $opts->{type};
+
+  if (!$type && $opts->{'file'}) {
+    $type = $FORMATGUESS->($opts->{'file'});
    }
    }
-  unless ($opts->{'type'}) {
+  unless ($type) {
      $class->_set_error('type parameter missing and not possible to guess from extension');
      return;
    }
      $class->_set_error('type parameter missing and not possible to guess from extension');
      return;
    }
@@ -1435,60 +1728,104 @@ sub write_multi {
    $class->_set_opts($opts, "i_", @images)
      or return;
    my @work = map $_->{IMG}, @images;
    $class->_set_opts($opts, "i_", @images)
      or return;
    my @work = map $_->{IMG}, @images;
-  my ($IO, $file) = $class->_get_writer_io($opts, $opts->{'type'})
-    or return undef;
-  if ($opts->{'type'} eq 'gif') {
-    $class->_set_opts($opts, "gif_", @images)
-      or return;
-    my $gif_delays = $opts->{gif_delays};
-    local $opts->{gif_delays} = $gif_delays;
-    if ($opts->{gif_delays} && !ref $opts->{gif_delays}) {
-      # assume the caller wants the same delay for each frame
-      $opts->{gif_delays} = [ ($gif_delays) x @images ];
-    }
-    my $res = i_writegif_wiol($IO, $opts, @work);
-    $res or $class->_set_error($class->_error_as_msg());
-    return $res;
-  }
-  elsif ($opts->{'type'} eq 'tiff') {
-    $class->_set_opts($opts, "tiff_", @images)
-      or return;
-    $class->_set_opts($opts, "exif_", @images)
-      or return;
-    my $res;
-    $opts->{fax_fine} = 1 unless exists $opts->{fax_fine};
-    if ($opts->{'class'} && $opts->{'class'} eq 'fax') {
-      $res = i_writetiff_multi_wiol_faxable($IO, $opts->{fax_fine}, @work);
+
+  _writer_autoload($type);
+
+  my ($IO, $file);
+  if ($writers{$type} && $writers{$type}{multiple}) {
+    ($IO, $file) = $class->_get_writer_io($opts, $type)
+      or return undef;
+
+    $writers{$type}{multiple}->($class, $IO, $opts, @images)
+      or return undef;
+  }
+  else {
+    if (!$formats{$type}) { 
+      $class->_set_error("format $type not supported"); 
+      return undef;
+    }
+    
+    ($IO, $file) = $class->_get_writer_io($opts, $type)
+      or return undef;
+    
+    if ($type eq 'gif') {
+      $class->_set_opts($opts, "gif_", @images)
+        or return;
+      my $gif_delays = $opts->{gif_delays};
+      local $opts->{gif_delays} = $gif_delays;
+      if ($opts->{gif_delays} && !ref $opts->{gif_delays}) {
+        # assume the caller wants the same delay for each frame
+        $opts->{gif_delays} = [ ($gif_delays) x @images ];
+      }
+      unless (i_writegif_wiol($IO, $opts, @work)) {
+        $class->_set_error($class->_error_as_msg());
+        return undef;
+      }
+    }
+    elsif ($type eq 'tiff') {
+      $class->_set_opts($opts, "tiff_", @images)
+        or return;
+      $class->_set_opts($opts, "exif_", @images)
+        or return;
+      my $res;
+      $opts->{fax_fine} = 1 unless exists $opts->{fax_fine};
+      if ($opts->{'class'} && $opts->{'class'} eq 'fax') {
+        $res = i_writetiff_multi_wiol_faxable($IO, $opts->{fax_fine}, @work);
+      }
+      else {
+        $res = i_writetiff_multi_wiol($IO, @work);
+      }
+      unless ($res) {
+        $class->_set_error($class->_error_as_msg());
+        return undef;
+      }
      }
      else {
      }
      else {
-      $res = i_writetiff_multi_wiol($IO, @work);
+      $ERRSTR = "Sorry, write_multi doesn't support $type yet";
+      return 0;
      }
      }
-    $res or $class->_set_error($class->_error_as_msg());
-    return $res;
    }
    }
-  else {
-    $ERRSTR = "Sorry, write_multi doesn't support $opts->{'type'} yet";
-    return 0;
+
+  if (exists $opts->{'data'}) {
+    my $data = io_slurp($IO);
+    if (!$data) {
+      Imager->_set_error('Could not slurp from buffer');
+      return undef;
+    }
+    ${$opts->{data}} = $data;
    }
    }
+  return 1;
  }
  
  # read multiple images from a file
  sub read_multi {
    my ($class, %opts) = @_;
  
  }
  
  # read multiple images from a file
  sub read_multi {
    my ($class, %opts) = @_;
  
-  if ($opts{file} && !exists $opts{'type'}) {
+  my ($IO, $file) = $class->_get_reader_io(\%opts, $opts{'type'})
+    or return;
+
+  my $type = $opts{'type'};
+  unless ($type) {
+    $type = i_test_format_probe($IO, -1);
+  }
+
+  if ($opts{file} && !$type) {
      # guess the type 
      # guess the type 
-    my $type = $FORMATGUESS->($opts{file});
-    $opts{'type'} = $type;
+    $type = $FORMATGUESS->($opts{file});
    }
    }
-  unless ($opts{'type'}) {
+
+  unless ($type) {
      $ERRSTR = "No type parameter supplied and it couldn't be guessed";
      return;
    }
  
      $ERRSTR = "No type parameter supplied and it couldn't be guessed";
      return;
    }
  
-  my ($IO, $file) = $class->_get_reader_io(\%opts, $opts{'type'})
-    or return;
-  if ($opts{'type'} eq 'gif') {
+  _reader_autoload($type);
+
+  if ($readers{$type} && $readers{$type}{multiple}) {
+    return $readers{$type}{multiple}->($IO, %opts);
+  }
+
+  if ($type eq 'gif') {
      my @imgs;
      @imgs = i_readgif_multi_wiol($IO);
      if (@imgs) {
      my @imgs;
      @imgs = i_readgif_multi_wiol($IO);
      if (@imgs) {
@@ -1501,7 +1838,7 @@ sub read_multi {
        return;
      }
    }
        return;
      }
    }
-  elsif ($opts{'type'} eq 'tiff') {
+  elsif ($type eq 'tiff') {
      my @imgs = i_readtiff_multi_wiol($IO, -1);
      if (@imgs) {
        return map { 
      my @imgs = i_readtiff_multi_wiol($IO, -1);
      if (@imgs) {
        return map { 
@@ -1514,7 +1851,7 @@ sub read_multi {
      }
    }
  
      }
    }
  
-  $ERRSTR = "Cannot read multiple images from $opts{'type'} files";
+  $ERRSTR = "Cannot read multiple images from $type files";
    return;
  }
  
    return;
  }
  
@@ -1559,9 +1896,14 @@ sub filter {
      }
    }
    if (defined($filters{$input{'type'}}{defaults})) {
      }
    }
    if (defined($filters{$input{'type'}}{defaults})) {
-    %hsh=('image',$self->{IMG},%{$filters{$input{'type'}}{defaults}},%input);
+    %hsh=( image => $self->{IMG},
+           imager => $self,
+           %{$filters{$input{'type'}}{defaults}},
+           %input );
    } else {
    } else {
-    %hsh=('image',$self->{IMG},%input);
+    %hsh=( image => $self->{IMG},
+           imager => $self,
+           %input );
    }
  
    my @cs=@{$filters{$input{'type'}}{callseq}};
    }
  
    my @cs=@{$filters{$input{'type'}}{callseq}};
@@ -1572,7 +1914,14 @@ sub filter {
      }
    }
  
      }
    }
  
-  &{$filters{$input{'type'}}{callsub}}(%hsh);
+  eval {
+    local $SIG{__DIE__}; # we don't want this processed by confess, etc
+    &{$filters{$input{'type'}}{callsub}}(%hsh);
+  };
+  if ($@) {
+    chomp($self->{ERRSTR} = $@);
+    return;
+  }
  
    my @b=keys %hsh;
  
  
    my @b=keys %hsh;
  
@@ -1582,6 +1931,25 @@ sub filter {
    return $self;
  }
  
    return $self;
  }
  
+sub register_filter {
+  my $class = shift;
+  my %hsh = ( defaults => {}, @_ );
+
+  defined $hsh{type}
+    or die "register_filter() with no type\n";
+  defined $hsh{callsub}
+    or die "register_filter() with no callsub\n";
+  defined $hsh{callseq}
+    or die "register_filter() with no callseq\n";
+
+  exists $filters{$hsh{type}}
+    and return;
+
+  $filters{$hsh{type}} = \%hsh;
+
+  return 1;
+}
+
  # Scale an image to requested size and return the scaled version
  
  sub scale {
  # Scale an image to requested size and return the scaled version
  
  sub scale {
@@ -1590,69 +1958,155 @@ sub scale {
    my $img = Imager->new();
    my $tmp = Imager->new();
  
    my $img = Imager->new();
    my $tmp = Imager->new();
  
-  unless ($self->{IMG}) { $self->{ERRSTR}='empty input image'; return undef; }
+  my $scalefactor = $opts{scalefactor};
+
+  unless (defined wantarray) {
+    my @caller = caller;
+    warn "scale() called in void context - scale() returns the scaled image at $caller[1] line $caller[2]\n";
+    return;
+  }
+
+  unless ($self->{IMG}) { 
+    $self->_set_error('empty input image'); 
+    return undef;
+  }
  
  
+  # work out the scaling
    if ($opts{xpixels} and $opts{ypixels} and $opts{'type'}) {
    if ($opts{xpixels} and $opts{ypixels} and $opts{'type'}) {
-    my ($xpix,$ypix)=( $opts{xpixels}/$self->getwidth() , $opts{ypixels}/$self->getheight() );
-    if ($opts{'type'} eq 'min') { $opts{scalefactor}=min($xpix,$ypix); }
-    if ($opts{'type'} eq 'max') { $opts{scalefactor}=max($xpix,$ypix); }
-  } elsif ($opts{xpixels}) { $opts{scalefactor}=$opts{xpixels}/$self->getwidth(); }
-  elsif ($opts{ypixels}) { $opts{scalefactor}=$opts{ypixels}/$self->getheight(); }
+    my ($xpix, $ypix)=( $opts{xpixels} / $self->getwidth() , 
+                       $opts{ypixels} / $self->getheight() );
+    if ($opts{'type'} eq 'min') { 
+      $scalefactor = _min($xpix,$ypix); 
+    }
+    elsif ($opts{'type'} eq 'max') {
+      $scalefactor = _max($xpix,$ypix);
+    }
+    else {
+      $self->_set_error('invalid value for type parameter');
+      return undef;
+    }
+  } elsif ($opts{xpixels}) { 
+    $scalefactor = $opts{xpixels} / $self->getwidth();
+  }
+  elsif ($opts{ypixels}) { 
+    $scalefactor = $opts{ypixels}/$self->getheight();
+  }
+  elsif ($opts{constrain} && ref $opts{constrain}
+        && $opts{constrain}->can('constrain')) {
+    # we've been passed an Image::Math::Constrain object or something
+    # that looks like one
+    (undef, undef, $scalefactor)
+      = $opts{constrain}->constrain($self->getwidth, $self->getheight);
+    unless ($scalefactor) {
+      $self->_set_error('constrain method failed on constrain parameter');
+      return undef;
+    }
+  }
  
    if ($opts{qtype} eq 'normal') {
  
    if ($opts{qtype} eq 'normal') {
-    $tmp->{IMG}=i_scaleaxis($self->{IMG},$opts{scalefactor},0);
-    if ( !defined($tmp->{IMG}) ) { $self->{ERRSTR}='unable to scale image'; return undef; }
-    $img->{IMG}=i_scaleaxis($tmp->{IMG},$opts{scalefactor},1);
-    if ( !defined($img->{IMG}) ) { $self->{ERRSTR}='unable to scale image'; return undef; }
+    $tmp->{IMG} = i_scaleaxis($self->{IMG}, $scalefactor, 0);
+    if ( !defined($tmp->{IMG}) ) { 
+      $self->{ERRSTR} = 'unable to scale image';
+      return undef;
+    }
+    $img->{IMG}=i_scaleaxis($tmp->{IMG}, $scalefactor, 1);
+    if ( !defined($img->{IMG}) ) { 
+      $self->{ERRSTR}='unable to scale image'; 
+      return undef;
+    }
+
      return $img;
    }
      return $img;
    }
-  if ($opts{'qtype'} eq 'preview') {
-    $img->{IMG}=i_scale_nn($self->{IMG},$opts{'scalefactor'},$opts{'scalefactor'}); 
-    if ( !defined($img->{IMG}) ) { $self->{ERRSTR}='unable to scale image'; return undef; }
+  elsif ($opts{'qtype'} eq 'preview') {
+    $img->{IMG} = i_scale_nn($self->{IMG}, $scalefactor, $scalefactor); 
+    if ( !defined($img->{IMG}) ) { 
+      $self->{ERRSTR}='unable to scale image'; 
+      return undef;
+    }
      return $img;
    }
      return $img;
    }
-  $self->{ERRSTR}='scale: invalid value for qtype'; return undef;
+  else {
+    $self->_set_error('invalid value for qtype parameter');
+    return undef;
+  }
  }
  
  # Scales only along the X axis
  
  sub scaleX {
  }
  
  # Scales only along the X axis
  
  sub scaleX {
-  my $self=shift;
-  my %opts=(scalefactor=>0.5,@_);
+  my $self = shift;
+  my %opts = ( scalefactor=>0.5, @_ );
  
  
-  unless ($self->{IMG}) { $self->{ERRSTR}='empty input image'; return undef; }
+  unless (defined wantarray) {
+    my @caller = caller;
+    warn "scaleX() called in void context - scaleX() returns the scaled image at $caller[1] line $caller[2]\n";
+    return;
+  }
+
+  unless ($self->{IMG}) { 
+    $self->{ERRSTR} = 'empty input image';
+    return undef;
+  }
  
    my $img = Imager->new();
  
  
    my $img = Imager->new();
  
-  if ($opts{pixels}) { $opts{scalefactor}=$opts{pixels}/$self->getwidth(); }
+  my $scalefactor = $opts{scalefactor};
  
  
-  unless ($self->{IMG}) { $self->{ERRSTR}='empty input image'; return undef; }
-  $img->{IMG}=i_scaleaxis($self->{IMG},$opts{scalefactor},0);
+  if ($opts{pixels}) { 
+    $scalefactor = $opts{pixels} / $self->getwidth();
+  }
+
+  unless ($self->{IMG}) { 
+    $self->{ERRSTR}='empty input image'; 
+    return undef;
+  }
+
+  $img->{IMG} = i_scaleaxis($self->{IMG}, $scalefactor, 0);
+
+  if ( !defined($img->{IMG}) ) { 
+    $self->{ERRSTR} = 'unable to scale image'; 
+    return undef;
+  }
  
  
-  if ( !defined($img->{IMG}) ) { $self->{ERRSTR}='unable to scale image'; return undef; }
    return $img;
  }
  
  # Scales only along the Y axis
  
  sub scaleY {
    return $img;
  }
  
  # Scales only along the Y axis
  
  sub scaleY {
-  my $self=shift;
-  my %opts=(scalefactor=>0.5,@_);
+  my $self = shift;
+  my %opts = ( scalefactor => 0.5, @_ );
+
+  unless (defined wantarray) {
+    my @caller = caller;
+    warn "scaleY() called in void context - scaleY() returns the scaled image at $caller[1] line $caller[2]\n";
+    return;
+  }
  
    unless ($self->{IMG}) { $self->{ERRSTR}='empty input image'; return undef; }
  
    my $img = Imager->new();
  
  
    unless ($self->{IMG}) { $self->{ERRSTR}='empty input image'; return undef; }
  
    my $img = Imager->new();
  
-  if ($opts{pixels}) { $opts{scalefactor}=$opts{pixels}/$self->getheight(); }
+  my $scalefactor = $opts{scalefactor};
  
  
-  unless ($self->{IMG}) { $self->{ERRSTR}='empty input image'; return undef; }
-  $img->{IMG}=i_scaleaxis($self->{IMG},$opts{scalefactor},1);
+  if ($opts{pixels}) { 
+    $scalefactor = $opts{pixels} / $self->getheight();
+  }
+
+  unless ($self->{IMG}) { 
+    $self->{ERRSTR} = 'empty input image'; 
+    return undef;
+  }
+  $img->{IMG}=i_scaleaxis($self->{IMG}, $scalefactor, 1);
+
+  if ( !defined($img->{IMG}) ) {
+    $self->{ERRSTR} = 'unable to scale image';
+    return undef;
+  }
  
  
-  if ( !defined($img->{IMG}) ) { $self->{ERRSTR}='unable to scale image'; return undef; }
    return $img;
  }
  
    return $img;
  }
  
-
  # Transform returns a spatial transformation of the input image
  # this moves pixels to a new location in the returned image.
  # NOTE - should make a utility function to check transforms for
  # Transform returns a spatial transformation of the input image
  # this moves pixels to a new location in the returned image.
  # NOTE - should make a utility function to check transforms for
@@ -1790,9 +2244,14 @@ sub transform2 {
      $Imager::ERRSTR = Imager::Expr::error();
      return;
    }
      $Imager::ERRSTR = Imager::Expr::error();
      return;
    }
+  my $channels = $opts->{channels} || 3;
+  unless ($channels >= 1 && $channels <= 4) {
+    return Imager->_set_error("channels must be an integer between 1 and 4");
+  }
  
    my $img = Imager->new();
  
    my $img = Imager->new();
-  $img->{IMG} = i_transform2($opts->{width}, $opts->{height}, $code->code(),
+  $img->{IMG} = i_transform2($opts->{width}, $opts->{height}, 
+                            $channels, $code->code(),
                               $code->nregs(), $code->cregs(),
                               [ map { $_->{IMG} } @imgs ]);
    if (!defined $img->{IMG}) {
                               $code->nregs(), $code->cregs(),
                               [ map { $_->{IMG} } @imgs ]);
    if (!defined $img->{IMG}) {
@@ -1805,13 +2264,27 @@ sub transform2 {
  
  sub rubthrough {
    my $self=shift;
  
  sub rubthrough {
    my $self=shift;
-  my %opts=(tx=>0,ty=>0,@_);
+  my %opts=(tx => 0,ty => 0, @_);
  
  
-  unless ($self->{IMG}) { $self->{ERRSTR}='empty input image'; return undef; }
-  unless ($opts{src} && $opts{src}->{IMG}) { $self->{ERRSTR}='empty input image for source'; return undef; }
+  unless ($self->{IMG}) { 
+    $self->{ERRSTR}='empty input image'; 
+    return undef;
+  }
+  unless ($opts{src} && $opts{src}->{IMG}) {
+    $self->{ERRSTR}='empty input image for src'; 
+    return undef;
+  }
  
  
-  unless (i_rubthru($self->{IMG}, $opts{src}->{IMG}, $opts{tx},$opts{ty})) {
-    $self->{ERRSTR} = $self->_error_as_msg();
+  %opts = (src_minx => 0,
+          src_miny => 0,
+          src_maxx => $opts{src}->getwidth(),
+          src_maxy => $opts{src}->getheight(),
+          %opts);
+
+  unless (i_rubthru($self->{IMG}, $opts{src}->{IMG}, $opts{tx}, $opts{ty},
+                    $opts{src_minx}, $opts{src_miny}, 
+                    $opts{src_maxx}, $opts{src_maxy})) {
+    $self->_set_error($self->_error_as_msg());
      return undef;
    }
    return $self;
      return undef;
    }
    return $self;
@@ -1832,6 +2305,13 @@ sub flip {
  sub rotate {
    my $self = shift;
    my %opts = @_;
  sub rotate {
    my $self = shift;
    my %opts = @_;
+
+  unless (defined wantarray) {
+    my @caller = caller;
+    warn "rotate() called in void context - rotate() returns the rotated image at $caller[1] line $caller[2]\n";
+    return;
+  }
+
    if (defined $opts{right}) {
      my $degrees = $opts{right};
      if ($degrees < 0) {
    if (defined $opts{right}) {
      my $degrees = $opts{right};
      if ($degrees < 0) {
@@ -1859,8 +2339,21 @@ sub rotate {
    elsif (defined $opts{radians} || defined $opts{degrees}) {
      my $amount = $opts{radians} || $opts{degrees} * 3.1415926535 / 180;
  
    elsif (defined $opts{radians} || defined $opts{degrees}) {
      my $amount = $opts{radians} || $opts{degrees} * 3.1415926535 / 180;
  
+    my $back = $opts{back};
      my $result = Imager->new;
      my $result = Imager->new;
-    if ($result->{IMG} = i_rotate_exact($self->{IMG}, $amount)) {
+    if ($back) {
+      $back = _color($back);
+      unless ($back) {
+        $self->_set_error(Imager->errstr);
+        return undef;
+      }
+
+      $result->{IMG} = i_rotate_exact($self->{IMG}, $amount, $back);
+    }
+    else {
+      $result->{IMG} = i_rotate_exact($self->{IMG}, $amount);
+    }
+    if ($result->{IMG}) {
        return $result;
      }
      else {
        return $result;
      }
      else {
@@ -1869,7 +2362,7 @@ sub rotate {
      }
    }
    else {
      }
    }
    else {
-    $self->{ERRSTR} = "Only the 'right' parameter is available";
+    $self->{ERRSTR} = "Only the 'right', 'radians' and 'degrees' parameters are available";
      return undef;
    }
  }
      return undef;
    }
  }
@@ -1878,14 +2371,27 @@ sub matrix_transform {
    my $self = shift;
    my %opts = @_;
  
    my $self = shift;
    my %opts = @_;
  
+  unless (defined wantarray) {
+    my @caller = caller;
+    warn "copy() called in void context - copy() returns the copied image at $caller[1] line $caller[2]\n";
+    return;
+  }
+
    if ($opts{matrix}) {
      my $xsize = $opts{xsize} || $self->getwidth;
      my $ysize = $opts{ysize} || $self->getheight;
  
      my $result = Imager->new;
    if ($opts{matrix}) {
      my $xsize = $opts{xsize} || $self->getwidth;
      my $ysize = $opts{ysize} || $self->getheight;
  
      my $result = Imager->new;
-    $result->{IMG} = i_matrix_transform($self->{IMG}, $xsize, $ysize, 
-                                        $opts{matrix})
-      or return undef;
+    if ($opts{back}) {
+      $result->{IMG} = i_matrix_transform($self->{IMG}, $xsize, $ysize, 
+                                         $opts{matrix}, $opts{back})
+       or return undef;
+    }
+    else {
+      $result->{IMG} = i_matrix_transform($self->{IMG}, $xsize, $ysize, 
+                                         $opts{matrix})
+       or return undef;
+    }
  
      return $result;
    }
  
      return $result;
    }
@@ -1916,10 +2422,10 @@ sub box {
    my %opts=(color=>$dflcl,xmin=>0,ymin=>0,xmax=>$self->getwidth()-1,ymax=>$self->getheight()-1,@_);
  
    if (exists $opts{'box'}) { 
    my %opts=(color=>$dflcl,xmin=>0,ymin=>0,xmax=>$self->getwidth()-1,ymax=>$self->getheight()-1,@_);
  
    if (exists $opts{'box'}) { 
-    $opts{'xmin'} = min($opts{'box'}->[0],$opts{'box'}->[2]);
-    $opts{'xmax'} = max($opts{'box'}->[0],$opts{'box'}->[2]);
-    $opts{'ymin'} = min($opts{'box'}->[1],$opts{'box'}->[3]);
-    $opts{'ymax'} = max($opts{'box'}->[1],$opts{'box'}->[3]);
+    $opts{'xmin'} = _min($opts{'box'}->[0],$opts{'box'}->[2]);
+    $opts{'xmax'} = _max($opts{'box'}->[0],$opts{'box'}->[2]);
+    $opts{'ymin'} = _min($opts{'box'}->[1],$opts{'box'}->[3]);
+    $opts{'ymax'} = _max($opts{'box'}->[1],$opts{'box'}->[3]);
    }
  
    if ($opts{filled}) { 
    }
  
    if ($opts{filled}) { 
@@ -1955,79 +2461,99 @@ sub box {
    return $self;
  }
  
    return $self;
  }
  
-# Draws an arc - this routine SUCKS and is buggy - it sometimes doesn't work when the arc is a convex polygon
-
  sub arc {
    my $self=shift;
    unless ($self->{IMG}) { $self->{ERRSTR}='empty input image'; return undef; }
    my $dflcl=i_color_new(255,255,255,255);
    my %opts=(color=>$dflcl,
  sub arc {
    my $self=shift;
    unless ($self->{IMG}) { $self->{ERRSTR}='empty input image'; return undef; }
    my $dflcl=i_color_new(255,255,255,255);
    my %opts=(color=>$dflcl,
-           'r'=>min($self->getwidth(),$self->getheight())/3,
+           'r'=>_min($self->getwidth(),$self->getheight())/3,
             'x'=>$self->getwidth()/2,
             'y'=>$self->getheight()/2,
             'd1'=>0, 'd2'=>361, @_);
             'x'=>$self->getwidth()/2,
             'y'=>$self->getheight()/2,
             'd1'=>0, 'd2'=>361, @_);
-  if ($opts{fill}) {
-    unless (UNIVERSAL::isa($opts{fill}, 'Imager::Fill')) {
-      # assume it's a hash ref
-      require 'Imager/Fill.pm';
-      unless ($opts{fill} = Imager::Fill->new(%{$opts{fill}})) {
-        $self->{ERRSTR} = $Imager::ERRSTR;
-        return;
+  if ($opts{aa}) {
+    if ($opts{fill}) {
+      unless (UNIVERSAL::isa($opts{fill}, 'Imager::Fill')) {
+       # assume it's a hash ref
+       require 'Imager/Fill.pm';
+       unless ($opts{fill} = Imager::Fill->new(%{$opts{fill}})) {
+         $self->{ERRSTR} = $Imager::ERRSTR;
+         return;
+       }
+      }
+      i_arc_aa_cfill($self->{IMG},$opts{'x'},$opts{'y'},$opts{'r'},$opts{'d1'},
+                    $opts{'d2'}, $opts{fill}{fill});
+    }
+    else {
+      my $color = _color($opts{'color'});
+      unless ($color) { 
+       $self->{ERRSTR} = $Imager::ERRSTR; 
+       return; 
+      }
+      if ($opts{d1} == 0 && $opts{d2} == 361 && $opts{aa}) {
+       i_circle_aa($self->{IMG}, $opts{'x'}, $opts{'y'}, $opts{'r'}, 
+                   $color);
+      }
+      else {
+       i_arc_aa($self->{IMG},$opts{'x'},$opts{'y'},$opts{'r'},
+                $opts{'d1'}, $opts{'d2'}, $color); 
        }
      }
        }
      }
-    i_arc_cfill($self->{IMG},$opts{'x'},$opts{'y'},$opts{'r'},$opts{'d1'},
-                $opts{'d2'}, $opts{fill}{fill});
    }
    else {
    }
    else {
-    my $color = _color($opts{'color'});
-    unless ($color) { 
-      $self->{ERRSTR} = $Imager::ERRSTR; 
-      return; 
-    }
-    if ($opts{d1} == 0 && $opts{d2} == 361 && $opts{aa}) {
-      i_circle_aa($self->{IMG}, $opts{'x'}, $opts{'y'}, $opts{'r'}, 
-                  $color);
+    if ($opts{fill}) {
+      unless (UNIVERSAL::isa($opts{fill}, 'Imager::Fill')) {
+       # assume it's a hash ref
+       require 'Imager/Fill.pm';
+       unless ($opts{fill} = Imager::Fill->new(%{$opts{fill}})) {
+         $self->{ERRSTR} = $Imager::ERRSTR;
+         return;
+       }
+      }
+      i_arc_cfill($self->{IMG},$opts{'x'},$opts{'y'},$opts{'r'},$opts{'d1'},
+                 $opts{'d2'}, $opts{fill}{fill});
      }
      else {
      }
      else {
-      if ($opts{'d1'} <= $opts{'d2'}) { 
-        i_arc($self->{IMG},$opts{'x'},$opts{'y'},$opts{'r'},
-              $opts{'d1'}, $opts{'d2'}, $color); 
-      }
-      else {
-        i_arc($self->{IMG},$opts{'x'},$opts{'y'},$opts{'r'},
-              $opts{'d1'}, 361,         $color);
-        i_arc($self->{IMG},$opts{'x'},$opts{'y'},$opts{'r'},
-              0,           $opts{'d2'}, $color); 
+      my $color = _color($opts{'color'});
+      unless ($color) { 
+       $self->{ERRSTR} = $Imager::ERRSTR; 
+       return; 
        }
        }
+      i_arc($self->{IMG},$opts{'x'},$opts{'y'},$opts{'r'},
+           $opts{'d1'}, $opts{'d2'}, $color); 
      }
    }
  
    return $self;
  }
  
      }
    }
  
    return $self;
  }
  
-# Draws a line from one point to (but not including) the destination point
+# Draws a line from one point to the other
+# the endpoint is set if the endp parameter is set which it is by default.
+# to turn of the endpoint being set use endp=>0 when calling line.
  
  sub line {
    my $self=shift;
    my $dflcl=i_color_new(0,0,0,0);
  
  sub line {
    my $self=shift;
    my $dflcl=i_color_new(0,0,0,0);
-  my %opts=(color=>$dflcl,@_);
+  my %opts=(color=>$dflcl,
+           endp => 1,
+           @_);
    unless ($self->{IMG}) { $self->{ERRSTR}='empty input image'; return undef; }
  
    unless (exists $opts{x1} and exists $opts{y1}) { $self->{ERRSTR}='missing begining coord'; return undef; }
    unless (exists $opts{x2} and exists $opts{y2}) { $self->{ERRSTR}='missing ending coord'; return undef; }
  
    my $color = _color($opts{'color'});
    unless ($self->{IMG}) { $self->{ERRSTR}='empty input image'; return undef; }
  
    unless (exists $opts{x1} and exists $opts{y1}) { $self->{ERRSTR}='missing begining coord'; return undef; }
    unless (exists $opts{x2} and exists $opts{y2}) { $self->{ERRSTR}='missing ending coord'; return undef; }
  
    my $color = _color($opts{'color'});
-  unless ($color) { 
-    $self->{ERRSTR} = $Imager::ERRSTR; 
-    return; 
+  unless ($color) {
+    $self->{ERRSTR} = $Imager::ERRSTR;
+    return;
    }
    }
+
    $opts{antialias} = $opts{aa} if defined $opts{aa};
    if ($opts{antialias}) {
    $opts{antialias} = $opts{aa} if defined $opts{aa};
    if ($opts{antialias}) {
-    i_line_aa($self->{IMG},$opts{x1}, $opts{y1}, $opts{x2}, $opts{y2}, 
-              $color);
+    i_line_aa($self->{IMG},$opts{x1}, $opts{y1}, $opts{x2}, $opts{y2},
+              $color, $opts{endp});
    } else {
    } else {
-    i_draw($self->{IMG},$opts{x1}, $opts{y1}, $opts{x2}, $opts{y2}, 
-           $color);
+    i_line($self->{IMG},$opts{x1}, $opts{y1}, $opts{x2}, $opts{y2},
+           $color, $opts{endp});
    }
    return $self;
  }
    }
    return $self;
  }
@@ -2059,14 +2585,14 @@ sub polyline {
    if ($opts{antialias}) {
      for $pt(@points) {
        if (defined($ls)) { 
    if ($opts{antialias}) {
      for $pt(@points) {
        if (defined($ls)) { 
-        i_line_aa($self->{IMG},$ls->[0],$ls->[1],$pt->[0],$pt->[1],$color);
+        i_line_aa($self->{IMG},$ls->[0],$ls->[1],$pt->[0],$pt->[1],$color, 1);
        }
        $ls=$pt;
      }
    } else {
      for $pt(@points) {
        if (defined($ls)) { 
        }
        $ls=$pt;
      }
    } else {
      for $pt(@points) {
        if (defined($ls)) { 
-        i_draw($self->{IMG},$ls->[0],$ls->[1],$pt->[0],$pt->[1],$color);
+        i_line($self->{IMG},$ls->[0],$ls->[1],$pt->[0],$pt->[1],$color,1);
        }
        $ls=$pt;
      }
        }
        $ls=$pt;
      }
@@ -2151,33 +2677,76 @@ sub polybezier {
  sub flood_fill {
    my $self = shift;
    my %opts = ( color=>Imager::Color->new(255, 255, 255), @_ );
  sub flood_fill {
    my $self = shift;
    my %opts = ( color=>Imager::Color->new(255, 255, 255), @_ );
+  my $rc;
  
    unless (exists $opts{'x'} && exists $opts{'y'}) {
      $self->{ERRSTR} = "missing seed x and y parameters";
      return undef;
    }
  
  
    unless (exists $opts{'x'} && exists $opts{'y'}) {
      $self->{ERRSTR} = "missing seed x and y parameters";
      return undef;
    }
  
-  if ($opts{fill}) {
-    unless (UNIVERSAL::isa($opts{fill}, 'Imager::Fill')) {
-      # assume it's a hash ref
-      require 'Imager/Fill.pm';
-      unless ($opts{fill} = Imager::Fill->new(%{$opts{fill}})) {
-        $self->{ERRSTR} = $Imager::ERRSTR;
-        return;
+  if ($opts{border}) {
+    my $border = _color($opts{border});
+    unless ($border) {
+      $self->_set_error($Imager::ERRSTR);
+      return;
+    }
+    if ($opts{fill}) {
+      unless (UNIVERSAL::isa($opts{fill}, 'Imager::Fill')) {
+       # assume it's a hash ref
+       require Imager::Fill;
+       unless ($opts{fill} = Imager::Fill->new(%{$opts{fill}})) {
+         $self->{ERRSTR} = $Imager::ERRSTR;
+         return;
+       }
        }
        }
+      $rc = i_flood_cfill_border($self->{IMG}, $opts{'x'}, $opts{'y'}, 
+                                $opts{fill}{fill}, $border);
+    }
+    else {
+      my $color = _color($opts{'color'});
+      unless ($color) {
+       $self->{ERRSTR} = $Imager::ERRSTR;
+       return;
+      }
+      $rc = i_flood_fill_border($self->{IMG}, $opts{'x'}, $opts{'y'}, 
+                               $color, $border);
+    }
+    if ($rc) { 
+      return $self; 
+    } 
+    else { 
+      $self->{ERRSTR} = $self->_error_as_msg(); 
+      return;
      }
      }
-    i_flood_cfill($self->{IMG}, $opts{'x'}, $opts{'y'}, $opts{fill}{fill});
    }
    else {
    }
    else {
-    my $color = _color($opts{'color'});
-    unless ($color) { 
-      $self->{ERRSTR} = $Imager::ERRSTR; 
-      return; 
+    if ($opts{fill}) {
+      unless (UNIVERSAL::isa($opts{fill}, 'Imager::Fill')) {
+       # assume it's a hash ref
+       require 'Imager/Fill.pm';
+       unless ($opts{fill} = Imager::Fill->new(%{$opts{fill}})) {
+         $self->{ERRSTR} = $Imager::ERRSTR;
+         return;
+       }
+      }
+      $rc = i_flood_cfill($self->{IMG}, $opts{'x'}, $opts{'y'}, $opts{fill}{fill});
      }
      }
-    i_flood_fill($self->{IMG}, $opts{'x'}, $opts{'y'}, $color);
-  }
-
-  $self;
+    else {
+      my $color = _color($opts{'color'});
+      unless ($color) {
+       $self->{ERRSTR} = $Imager::ERRSTR;
+       return;
+      }
+      $rc = i_flood_fill($self->{IMG}, $opts{'x'}, $opts{'y'}, $color);
+    }
+    if ($rc) { 
+      return $self; 
+    } 
+    else { 
+      $self->{ERRSTR} = $self->_error_as_msg(); 
+      return;
+    }
+  } 
  }
  
  sub setpixel {
  }
  
  sub setpixel {
@@ -2196,7 +2765,7 @@ sub setpixel {
      or return undef;
    if (ref $x && ref $y) {
      unless (@$x == @$y) {
      or return undef;
    if (ref $x && ref $y) {
      unless (@$x == @$y) {
-      $self->{ERRSTR} = 'length of x and y mistmatch';
+      $self->{ERRSTR} = 'length of x and y mismatch';
        return undef;
      }
      if ($color->isa('Imager::Color')) {
        return undef;
      }
      if ($color->isa('Imager::Color')) {
@@ -2225,7 +2794,7 @@ sub setpixel {
  sub getpixel {
    my $self = shift;
  
  sub getpixel {
    my $self = shift;
  
-  my %opts = ( type=>'8bit', @_);
+  my %opts = ( "type"=>'8bit', @_);
  
    unless (exists $opts{'x'} && exists $opts{'y'}) {
      $self->{ERRSTR} = 'missing x and y parameters';
  
    unless (exists $opts{'x'} && exists $opts{'y'}) {
      $self->{ERRSTR} = 'missing x and y parameters';
@@ -2240,7 +2809,7 @@ sub getpixel {
        return undef;
      }
      my @result;
        return undef;
      }
      my @result;
-    if ($opts{type} eq '8bit') {
+    if ($opts{"type"} eq '8bit') {
        for my $i (0..$#{$opts{'x'}}) {
          push(@result, i_get_pixel($self->{IMG}, $x->[$i], $y->[$i]));
        }
        for my $i (0..$#{$opts{'x'}}) {
          push(@result, i_get_pixel($self->{IMG}, $x->[$i], $y->[$i]));
        }
@@ -2253,7 +2822,7 @@ sub getpixel {
      return wantarray ? @result : \@result;
    }
    else {
      return wantarray ? @result : \@result;
    }
    else {
-    if ($opts{type} eq '8bit') {
+    if ($opts{"type"} eq '8bit') {
        return i_get_pixel($self->{IMG}, $x, $y);
      }
      else {
        return i_get_pixel($self->{IMG}, $x, $y);
      }
      else {
@@ -2264,6 +2833,111 @@ sub getpixel {
    $self;
  }
  
    $self;
  }
  
+sub getscanline {
+  my $self = shift;
+  my %opts = ( type => '8bit', x=>0, @_);
+
+  defined $opts{width} or $opts{width} = $self->getwidth - $opts{x};
+
+  unless (defined $opts{'y'}) {
+    $self->_set_error("missing y parameter");
+    return;
+  }
+
+  if ($opts{type} eq '8bit') {
+    return i_glin($self->{IMG}, $opts{x}, $opts{x}+$opts{width},
+                 $opts{y});
+  }
+  elsif ($opts{type} eq 'float') {
+    return i_glinf($self->{IMG}, $opts{x}, $opts{x}+$opts{width},
+                 $opts{y});
+  }
+  else {
+    $self->_set_error("invalid type parameter - must be '8bit' or 'float'");
+    return;
+  }
+}
+
+sub setscanline {
+  my $self = shift;
+  my %opts = ( x=>0, @_);
+
+  unless (defined $opts{'y'}) {
+    $self->_set_error("missing y parameter");
+    return;
+  }
+
+  if (!$opts{type}) {
+    if (ref $opts{pixels} && @{$opts{pixels}}) {
+      # try to guess the type
+      if ($opts{pixels}[0]->isa('Imager::Color')) {
+       $opts{type} = '8bit';
+      }
+      elsif ($opts{pixels}[0]->isa('Imager::Color::Float')) {
+       $opts{type} = 'float';
+      }
+      else {
+       $self->_set_error("missing type parameter and could not guess from pixels");
+       return;
+      }
+    }
+    else {
+      # default
+      $opts{type} = '8bit';
+    }
+  }
+
+  if ($opts{type} eq '8bit') {
+    if (ref $opts{pixels}) {
+      return i_plin($self->{IMG}, $opts{x}, $opts{'y'}, @{$opts{pixels}});
+    }
+    else {
+      return i_plin($self->{IMG}, $opts{x}, $opts{'y'}, $opts{pixels});
+    }
+  }
+  elsif ($opts{type} eq 'float') {
+    if (ref $opts{pixels}) {
+      return i_plinf($self->{IMG}, $opts{x}, $opts{'y'}, @{$opts{pixels}});
+    }
+    else {
+      return i_plinf($self->{IMG}, $opts{x}, $opts{'y'}, $opts{pixels});
+    }
+  }
+  else {
+    $self->_set_error("invalid type parameter - must be '8bit' or 'float'");
+    return;
+  }
+}
+
+sub getsamples {
+  my $self = shift;
+  my %opts = ( type => '8bit', x=>0, @_);
+
+  defined $opts{width} or $opts{width} = $self->getwidth - $opts{x};
+
+  unless (defined $opts{'y'}) {
+    $self->_set_error("missing y parameter");
+    return;
+  }
+  
+  unless ($opts{channels}) {
+    $opts{channels} = [ 0 .. $self->getchannels()-1 ];
+  }
+
+  if ($opts{type} eq '8bit') {
+    return i_gsamp($self->{IMG}, $opts{x}, $opts{x}+$opts{width},
+                  $opts{y}, @{$opts{channels}});
+  }
+  elsif ($opts{type} eq 'float') {
+    return i_gsampf($self->{IMG}, $opts{x}, $opts{x}+$opts{width},
+                   $opts{y}, @{$opts{channels}});
+  }
+  else {
+    $self->_set_error("invalid type parameter - must be '8bit' or 'float'");
+    return;
+  }
+}
+
  # make an identity matrix of the given size
  sub _identity {
    my ($size) = @_;
  # make an identity matrix of the given size
  sub _identity {
    my ($size) = @_;
@@ -2280,6 +2954,12 @@ sub convert {
    my ($self, %opts) = @_;
    my $matrix;
  
    my ($self, %opts) = @_;
    my $matrix;
  
+  unless (defined wantarray) {
+    my @caller = caller;
+    warn "convert() called in void context - convert() returns the converted image at $caller[1] line $caller[2]\n";
+    return;
+  }
+
    # the user can either specify a matrix or preset
    # the matrix overrides the preset
    if (!exists($opts{matrix})) {
    # the user can either specify a matrix or preset
    # the matrix overrides the preset
    if (!exists($opts{matrix})) {
@@ -2399,6 +3079,27 @@ sub map {
    return $self;
  }
  
    return $self;
  }
  
+sub difference {
+  my ($self, %opts) = @_;
+
+  defined $opts{mindist} or $opts{mindist} = 0;
+
+  defined $opts{other}
+    or return $self->_set_error("No 'other' parameter supplied");
+  defined $opts{other}{IMG}
+    or return $self->_set_error("No image data in 'other' image");
+
+  $self->{IMG}
+    or return $self->_set_error("No image data");
+
+  my $result = Imager->new;
+  $result->{IMG} = i_diff_image($self->{IMG}, $opts{other}{IMG}, 
+                                $opts{mindist})
+    or return $self->_set_error($self->_error_as_msg());
+
+  return $result;
+}
+
  # destructive border - image is shrunk by one pixel all around
  
  sub border {
  # destructive border - image is shrunk by one pixel all around
  
  sub border {
@@ -2445,8 +3146,17 @@ sub getmask {
  sub setmask {
    my $self = shift;
    my %opts = @_;
  sub setmask {
    my $self = shift;
    my %opts = @_;
-  if (!defined($self->{IMG})) { $self->{ERRSTR} = 'image is empty'; return undef; }
+  if (!defined($self->{IMG})) { 
+    $self->{ERRSTR} = 'image is empty';
+    return undef;
+  }
+  unless (defined $opts{mask}) {
+    $self->_set_error("mask parameter required");
+    return;
+  }
    i_img_setmask( $self->{IMG} , $opts{mask} );
    i_img_setmask( $self->{IMG} , $opts{mask} );
+
+  1;
  }
  
  # Get number of colors in an image
  }
  
  # Get number of colors in an image
@@ -2468,7 +3178,7 @@ sub string {
    my %input=('x'=>0, 'y'=>0, @_);
    $input{string}||=$input{text};
  
    my %input=('x'=>0, 'y'=>0, @_);
    $input{string}||=$input{text};
  
-  unless(exists $input{string}) {
+  unless(defined $input{string}) {
      $self->{ERRSTR}="missing required parameter 'string'";
      return;
    }
      $self->{ERRSTR}="missing required parameter 'string'";
      return;
    }
@@ -2479,13 +3189,74 @@ sub string {
    }
  
    unless ($input{font}->draw(image=>$self, %input)) {
    }
  
    unless ($input{font}->draw(image=>$self, %input)) {
-    $self->{ERRSTR} = $self->_error_as_msg();
      return;
    }
  
    return $self;
  }
  
      return;
    }
  
    return $self;
  }
  
+sub align_string {
+  my $self = shift;
+
+  my $img;
+  if (ref $self) {
+    unless ($self->{IMG}) { 
+      $self->{ERRSTR}='empty input image'; 
+      return;
+    }
+    $img = $self;
+  }
+  else {
+    $img = undef;
+  }
+
+  my %input=('x'=>0, 'y'=>0, @_);
+  $input{string}||=$input{text};
+
+  unless(exists $input{string}) {
+    $self->_set_error("missing required parameter 'string'");
+    return;
+  }
+
+  unless($input{font}) {
+    $self->_set_error("missing required parameter 'font'");
+    return;
+  }
+
+  my @result;
+  unless (@result = $input{font}->align(image=>$img, %input)) {
+    return;
+  }
+
+  return wantarray ? @result : $result[0];
+}
+
+my @file_limit_names = qw/width height bytes/;
+
+sub set_file_limits {
+  shift;
+
+  my %opts = @_;
+  my %values;
+  
+  if ($opts{reset}) {
+    @values{@file_limit_names} = (0) x @file_limit_names;
+  }
+  else {
+    @values{@file_limit_names} = i_get_image_file_limits();
+  }
+
+  for my $key (keys %values) {
+    defined $opts{$key} and $values{$key} = $opts{$key};
+  }
+
+  i_set_image_file_limits($values{width}, $values{height}, $values{bytes});
+}
+
+sub get_file_limits {
+  i_get_image_file_limits();
+}
+
  # Shortcuts that can be exported
  
  sub newcolor { Imager::Color->new(@_); }
  # Shortcuts that can be exported
  
  sub newcolor { Imager::Color->new(@_); }
@@ -2513,6 +3284,7 @@ sub _set_error {
    else {
      $ERRSTR = $msg;
    }
    else {
      $ERRSTR = $msg;
    }
+  return;
  }
  
  # Default guess for the type of an image from extension
  }
  
  # Default guess for the type of an image from extension
@@ -2530,12 +3302,13 @@ sub def_guess_type {
    return 'rgb'  if ($ext eq "rgb");
    return 'gif'  if ($ext eq "gif");
    return 'raw'  if ($ext eq "raw");
    return 'rgb'  if ($ext eq "rgb");
    return 'gif'  if ($ext eq "gif");
    return 'raw'  if ($ext eq "raw");
+  return lc $ext; # best guess
    return ();
  }
  
  # get the minimum of a list
  
    return ();
  }
  
  # get the minimum of a list
  
-sub min {
+sub _min {
    my $mx=shift;
    for(@_) { if ($_<$mx) { $mx=$_; }}
    return $mx;
    my $mx=shift;
    for(@_) { if ($_<$mx) { $mx=$_; }}
    return $mx;
@@ -2543,7 +3316,7 @@ sub min {
  
  # get the maximum of a list
  
  
  # get the maximum of a list
  
-sub max {
+sub _max {
    my $mx=shift;
    for(@_) { if ($_>$mx) { $mx=$_; }}
    return $mx;
    my $mx=shift;
    for(@_) { if ($_>$mx) { $mx=$_; }}
    return $mx;
@@ -2551,7 +3324,7 @@ sub max {
  
  # string stuff for iptc headers
  
  
  # string stuff for iptc headers
  
-sub clean {
+sub _clean {
    my($str)=$_[0];
    $str = substr($str,3);
    $str =~ s/[\n\r]//g;
    my($str)=$_[0];
    $str = substr($str,3);
    $str =~ s/[\n\r]//g;
@@ -2570,7 +3343,8 @@ sub parseiptc {
  
    my $str=$self->{IPTCRAW};
  
  
    my $str=$self->{IPTCRAW};
  
-  #print $str;
+  defined $str
+    or return;
  
    @ar=split(/8BIM/,$str);
  
  
    @ar=split(/8BIM/,$str);
  
@@ -2580,19 +3354,19 @@ sub parseiptc {
        @sar=split(/\034\002/);
        foreach $item (@sar) {
         if ($item =~ m/^x/) {
        @sar=split(/\034\002/);
        foreach $item (@sar) {
         if ($item =~ m/^x/) {
-         $caption=&clean($item);
+         $caption = _clean($item);
           $i++;
         }
         if ($item =~ m/^P/) {
           $i++;
         }
         if ($item =~ m/^P/) {
-         $photogr=&clean($item);
+         $photogr = _clean($item);
           $i++;
         }
         if ($item =~ m/^i/) {
           $i++;
         }
         if ($item =~ m/^i/) {
-         $headln=&clean($item);
+         $headln = _clean($item);
           $i++;
         }
         if ($item =~ m/^n/) {
           $i++;
         }
         if ($item =~ m/^n/) {
-         $credit=&clean($item);
+         $credit = _clean($item);
           $i++;
         }
        }
           $i++;
         }
        }
@@ -2601,7 +3375,15 @@ sub parseiptc {
    return (caption=>$caption,photogr=>$photogr,headln=>$headln,credit=>$credit);
  }
  
    return (caption=>$caption,photogr=>$photogr,headln=>$headln,credit=>$credit);
  }
  
-# Autoload methods go after =cut, and are processed by the autosplit program.
+sub Inline {
+  my ($lang) = @_;
+
+  $lang eq 'C'
+    or die "Only C language supported";
+
+  require Imager::ExtUtils;
+  return Imager::ExtUtils->inline_config;
+}
  
  1;
  __END__
  
  1;
  __END__
@@ -2625,11 +3407,13 @@ Imager - Perl extension for Generating 24 bit Images
    my $format;
  
    my $img = Imager->new();
    my $format;
  
    my $img = Imager->new();
-  $img->open(file=>$file) or die $img->errstr();
+  # see Imager::Files for information on the read() method
+  $img->read(file=>$file) or die $img->errstr();
  
    $file =~ s/\.[^.]*$//;
  
    # Create smaller version
  
    $file =~ s/\.[^.]*$//;
  
    # Create smaller version
+  # documented in Imager::Transformations
    my $thumb = $img->scale(scalefactor=>.3);
  
    # Autostretch individual channels
    my $thumb = $img->scale(scalefactor=>.3);
  
    # Autostretch individual channels
@@ -2643,17 +3427,13 @@ Imager - Perl extension for Generating 24 bit Images
      if ($Imager::formats{$format}) {
        $file.="_low.$format";
        print "Storing image as: $file\n";
      if ($Imager::formats{$format}) {
        $file.="_low.$format";
        print "Storing image as: $file\n";
+      # documented in Imager::Files
        $thumb->write(file=>$file) or
          die $thumb->errstr;
        last SAVE;
      }
    }
  
        $thumb->write(file=>$file) or
          die $thumb->errstr;
        last SAVE;
      }
    }
  
-
-  # Logo Generator Example
-
-
-
  =head1 DESCRIPTION
  
  Imager is a module for creating and altering images.  It can read and
  =head1 DESCRIPTION
  
  Imager is a module for creating and altering images.  It can read and
@@ -2665,65 +3445,94 @@ render text and more.
  
  =over
  
  
  =over
  
-=item Imager
+=item *
  
  
-This document - Synopsis Example, Table of Contents and Overview.
+Imager - This document - Synopsis, Example, Table of Contents and
+Overview.
  
  
-=item Imager::ImageTypes
+=item *
  
  
-Direct type/virtual images, RGB(A)/paletted images, 8/16/double
-bits/channel, color maps, channel masks, image tags, color
-quantization.
+L<Imager::Tutorial> - a brief introduction to Imager.
  
  
-=item Imager::Files
+=item *
  
  
-IO interaction, reading/writing images, format specific tags.
+L<Imager::Cookbook> - how to do various things with Imager.
  
  
-=item Imager::Draw
+=item *
  
  
-Drawing Primitives, lines, boxes, circles, arcs, flood fill.
+L<Imager::ImageTypes> - Basics of constructing image objects with
+C<new()>: Direct type/virtual images, RGB(A)/paletted images,
+8/16/double bits/channel, color maps, channel masks, image tags, color
+quantization.  Also discusses basic image information methods.
  
  
-=item Imager::Color
+=item *
  
  
-Color specification.
+L<Imager::Files> - IO interaction, reading/writing images, format
+specific tags.
  
  
-=item Imager::Fill
+=item *
  
  
-Fill pattern specification.
+L<Imager::Draw> - Drawing Primitives, lines, boxes, circles, arcs,
+flood fill.
  
  
-=item Imager::Font
+=item *
  
  
-General font rendering, bounding boxes and font metrics.
+L<Imager::Color> - Color specification.
  
  
-=item Imager::Transformations
+=item *
  
  
-Copying, scaling, cropping, flipping, blending, pasting, convert and
-map.
+L<Imager::Fill> - Fill pattern specification.
  
  
-=item Imager::Engines
+=item *
  
  
-Programmable transformations through C<transform()>, C<transform2()>
-and C<matrix_transform()>.
+L<Imager::Font> - General font rendering, bounding boxes and font
+metrics.
  
  
-=item Imager::Filters
+=item *
  
  
-Filters, sharpen, blur, noise, convolve etc. and filter plugins.
+L<Imager::Transformations> - Copying, scaling, cropping, flipping,
+blending, pasting, convert and map.
  
  
-=item Imager::Expr
+=item *
  
  
-Expressions for evaluation engine used by transform2().
+L<Imager::Engines> - Programmable transformations through
+C<transform()>, C<transform2()> and C<matrix_transform()>.
  
  
-=item Imager::Matrix2d
+=item *
  
  
-Helper class for affine transformations.
+L<Imager::Filters> - Filters, sharpen, blur, noise, convolve etc. and
+filter plugins.
  
  
-=item Imager::Fountain
+=item *
  
  
-Helper for making gradient profiles.
+L<Imager::Expr> - Expressions for evaluation engine used by
+transform2().
  
  
-=back
+=item *
+
+L<Imager::Matrix2d> - Helper class for affine transformations.
+
+=item *
+
+L<Imager::Fountain> - Helper for making gradient profiles.
  
  
+=item *
  
  
+L<Imager::API> - using Imager's C API
+
+=item *
+
+L<Imager::APIRef> - API function reference
+
+=item *
+
+L<Imager::Inline> - using Imager's C API from Inline::C
+
+=item *
+
+L<Imager::ExtUtils> - tools to get access to Imager's C API.
+
+=back
  
  =head2 Basic Overview
  
  
  =head2 Basic Overview
  
@@ -2731,7 +3540,7 @@ An Image object is created with C<$img = Imager-E<gt>new()>.
  Examples:
  
    $img=Imager->new();                         # create empty image
  Examples:
  
    $img=Imager->new();                         # create empty image
-  $img->open(file=>'lena.png',type=>'png') or # read image from file
+  $img->read(file=>'lena.png',type=>'png') or # read image from file
       die $img->errstr();                      # give an explanation
                                                # if something failed
  
       die $img->errstr();                      # give an explanation
                                                # if something failed
  
@@ -2742,18 +3551,349 @@ or if you want to create an empty image:
  This example creates a completely black image of width 400 and height
  300 and 4 channels.
  
  This example creates a completely black image of width 400 and height
  300 and 4 channels.
  
-When an operation fails which can be directly associated with an image
-the error message is stored can be retrieved with
-C<$img-E<gt>errstr()>.
+=head1 ERROR HANDLING
+
+In general a method will return false when it fails, if it does use the errstr() method to find out why:
+
+=over
+
+=item errstr
+
+Returns the last error message in that context.
+
+If the last error you received was from calling an object method, such
+as read, call errstr() as an object method to find out why:
+
+  my $image = Imager->new;
+  $image->read(file => 'somefile.gif')
+     or die $image->errstr;
+
+If it was a class method then call errstr() as a class method:
+
+  my @imgs = Imager->read_multi(file => 'somefile.gif')
+    or die Imager->errstr;
+
+Note that in some cases object methods are implemented in terms of
+class methods so a failing object method may set both.
+
+=back
+
+The C<Imager-E<gt>new> method is described in detail in
+L<Imager::ImageTypes>.
+
+=head1 METHOD INDEX
+
+Where to find information on methods for Imager class objects.
+
+addcolors() -  L<Imager::ImageTypes/addcolors>
+
+addtag() -  L<Imager::ImageTypes/addtag> - add image tags
+
+align_string() - L<Imager::Draw/align_string>
+
+arc() - L<Imager::Draw/arc>
+
+bits() - L<Imager::ImageTypes/bits> - number of bits per sample for the
+image
+
+box() - L<Imager::Draw/box>
+
+circle() - L<Imager::Draw/circle>
+
+colorcount() - L<Imager::Draw/colorcount>
+
+convert() - L<Imager::Transformations/"Color transformations"> -
+transform the color space
+
+copy() - L<Imager::Transformations/copy>
+
+crop() - L<Imager::Transformations/crop> - extract part of an image
+
+def_guess_type() - L<Imager::Files/def_guess_type>
+
+deltag() -  L<Imager::ImageTypes/deltag> - delete image tags
+
+difference() - L<Imager::Filters/"Image Difference">
+
+errstr() - L<"Basic Overview">
+
+filter() - L<Imager::Filters>
+
+findcolor() - L<Imager::ImageTypes/findcolor> - search the image palette, if it
+has one
+
+flip() - L<Imager::Transformations/flip>
+
+flood_fill() - L<Imager::Draw/flood_fill>
+
+getchannels() -  L<Imager::ImageTypes/getchannels>
+
+getcolorcount() -  L<Imager::ImageTypes/getcolorcount>
+
+getcolors() - L<Imager::ImageTypes/getcolors> - get colors from the image
+palette, if it has one
+
+get_file_limits() - L<Imager::Files/"Limiting the sizes of images you read">
+
+getheight() - L<Imager::ImageTypes/getwidth>
+
+getmask() - L<Imager::ImageTypes/getmask>
  
  
-In cases where no image object is associated with an operation
-C<$Imager::ERRSTR> is used to report errors not directly associated
-with an image object.
+getpixel() - L<Imager::Draw/getpixel>
+
+getsamples() - L<Imager::Draw/getsamples>
+
+getscanline() - L<Imager::Draw/getscanline>
+
+getwidth() - L<Imager::ImageTypes/getwidth>
+
+img_set() - L<Imager::ImageTypes/img_set>
+
+init() - L<Imager::ImageTypes/init>
+
+line() - L<Imager::Draw/line>
+
+load_plugin() - L<Imager::Filters/load_plugin>
+
+map() - L<Imager::Transformations/"Color Mappings"> - remap color
+channel values
+
+masked() -  L<Imager::ImageTypes/masked> - make a masked image
+
+matrix_transform() - L<Imager::Engines/matrix_transform>
+
+maxcolors() - L<Imager::ImageTypes/maxcolors>
+
+NC() - L<Imager::Handy/NC>
+
+new() - L<Imager::ImageTypes/new>
+
+newcolor() - L<Imager::Handy/newcolor>
+
+newcolour() - L<Imager::Handy/newcolour>
+
+newfont() - L<Imager::Handy/newfont>
+
+NF() - L<Imager::Handy/NF>
+
+open() - L<Imager::Files> - an alias for read()
+
+parseiptc() - L<Imager::Files/parseiptc> - parse IPTC data from a JPEG
+image
+
+paste() - L<Imager::Transformations/paste> - draw an image onto an image
+
+polygon() - L<Imager::Draw/polygon>
+
+polyline() - L<Imager::Draw/polyline>
+
+read() - L<Imager::Files> - read a single image from an image file
+
+read_multi() - L<Imager::Files> - read multiple images from an image
+file
+
+register_filter() - L<Imager::Filters/register_filter>
+
+register_reader() - L<Imager::Filters/register_reader>
+
+register_writer() - L<Imager::Filters/register_writer>
+
+rotate() - L<Imager::Transformations/rotate>
+
+rubthrough() - L<Imager::Transformations/rubthrough> - draw an image onto an
+image and use the alpha channel
+
+scale() - L<Imager::Transformations/scale>
+
+scaleX() - L<Imager::Transformations/scaleX>
+
+scaleY() - L<Imager::Transformations/scaleY>
+
+setcolors() - L<Imager::ImageTypes/setcolors> - set palette colors in
+a paletted image
+
+set_file_limits() - L<Imager::Files/"Limiting the sizes of images you read">
+
+setmask() - L<Imager::ImageTypes/setmask>
+
+setpixel() - L<Imager::Draw/setpixel>
+
+setscanline() - L<Imager::Draw/setscanline>
+
+settag() - L<Imager::ImageTypes/settag>
+
+string() - L<Imager::Draw/string> - draw text on an image
+
+tags() -  L<Imager::ImageTypes/tags> - fetch image tags
+
+to_paletted() -  L<Imager::ImageTypes/to_paletted>
+
+to_rgb8() - L<Imager::ImageTypes/to_rgb8>
+
+transform() - L<Imager::Engines/"transform">
+
+transform2() - L<Imager::Engines/"transform2">
+
+type() -  L<Imager::ImageTypes/type> - type of image (direct vs paletted)
+
+unload_plugin() - L<Imager::Filters/unload_plugin>
+
+virtual() - L<Imager::ImageTypes/virtual> - whether the image has it's own
+data
+
+write() - L<Imager::Files> - write an image to a file
+
+write_multi() - L<Imager::Files> - write multiple image to an image
+file.
+
+=head1 CONCEPT INDEX
+
+animated GIF - L<Imager::File/"Writing an animated GIF">
+
+aspect ratio - L<Imager::ImageTypes/i_xres>,
+L<Imager::ImageTypes/i_yres>, L<Imager::ImageTypes/i_aspect_only>
+
+blend - alpha blending one image onto another
+L<Imager::Transformations/rubthrough>
+
+blur - L<Imager::Filters/guassian>, L<Imager::Filters/conv>
+
+boxes, drawing - L<Imager::Draw/box>
+
+changes between image - L<Imager::Filter/"Image Difference">
+
+color - L<Imager::Color>
+
+color names - L<Imager::Color>, L<Imager::Color::Table>
+
+combine modes - L<Imager::Fill/combine>
+
+compare images - L<Imager::Filter/"Image Difference">
+
+contrast - L<Imager::Filter/contrast>, L<Imager::Filter/autolevels>
+
+convolution - L<Imager::Filter/conv>
+
+cropping - L<Imager::Transformations/crop>
+
+C<diff> images - L<Imager::Filter/"Image Difference">
+
+dpi - L<Imager::ImageTypes/i_xres>
+
+drawing boxes - L<Imager::Draw/box>
+
+drawing lines - L<Imager::Draw/line>
+
+drawing text - L<Imager::Font/string>, L<Imager::Font/align>
+
+error message - L<"Basic Overview">
+
+files, font - L<Imager::Font>
+
+files, image - L<Imager::Files>
+
+filling, types of fill - L<Imager::Fill>
+
+filling, boxes - L<Imager::Draw/box>
+
+filling, flood fill - L<Imager::Draw/flood_fill>
+
+flood fill - L<Imager::Draw/flood_fill>
+
+fonts - L<Imager::Font>
+
+fonts, drawing with - L<Imager::Font/string>, L<Imager::Font/align>,
+L<Imager::Font::Wrap>
+
+fonts, metrics - L<Imager::Font/bounding_box>, L<Imager::Font::BBox>
+
+fonts, multiple master - L<Imager::Font/"MULTIPLE MASTER FONTS">
+
+fountain fill - L<Imager::Fill/"Fountain fills">,
+L<Imager::Filters/fountain>, L<Imager::Fountain>,
+L<Imager::Filters/gradgen>
+
+GIF files - L<Imager::Files/"GIF">
+
+GIF files, animated - L<Imager::File/"Writing an animated GIF">
+
+gradient fill - L<Imager::Fill/"Fountain fills">,
+L<Imager::Filters/fountain>, L<Imager::Fountain>,
+L<Imager::Filters/gradgen>
+
+guassian blur - L<Imager::Filter/guassian>
+
+hatch fills - L<Imager::Fill/"Hatched fills">
+
+invert image - L<Imager::Filter/hardinvert>
+
+JPEG - L<Imager::Files/"JPEG">
+
+limiting image sizes - L<Imager::Files/"Limiting the sizes of images you read">
+
+lines, drawing - L<Imager::Draw/line>
+
+matrix - L<Imager::Matrix2d>, 
+L<Imager::Transformations/"Matrix Transformations">,
+L<Imager::Font/transform>
+
+metadata, image - L<Imager::ImageTypes/"Tags">
+
+mosaic - L<Imager::Filter/mosaic>
+
+noise, filter - L<Imager::Filter/noise>
+
+noise, rendered - L<Imager::Filter/turbnoise>,
+L<Imager::Filter/radnoise>
+
+paste - L<Imager::Transformations/paste>,
+L<Imager::Transformations/rubthrough>
+
+pseudo-color image - L<Imager::ImageTypes/to_paletted>,
+L<Imager::ImageTypes/new>
+
+posterize - L<Imager::Filter/postlevels>
+
+png files - L<Imager::Files>, L<Imager::Files/"PNG">
+
+pnm - L<Imager::Files/"PNM (Portable aNy Map)">
+
+rectangles, drawing - L<Imager::Draw/box>
+
+resizing an image - L<Imager::Transformations/scale>, 
+L<Imager::Transformations/crop>
+
+saving an image - L<Imager::Files>
+
+scaling - L<Imager::Transformations/scale>
+
+sharpen - L<Imager::Filters/unsharpmask>, L<Imager::Filters/conv>
+
+size, image - L<Imager::ImageTypes/getwidth>,
+L<Imager::ImageTypes/getheight>
+
+size, text - L<Imager::Font/bounding_box>
+
+tags, image metadata - L<Imager::ImageTypes/"Tags">
+
+text, drawing - L<Imager::Draw/string>, L<Imager::Draw/align_string>,
+L<Imager::Font::Wrap>
+
+text, wrapping text in an area - L<Imager::Font::Wrap>
+
+text, measuring - L<Imager::Font/bounding_box>, L<Imager::Font::BBox>
+
+tiles, color - L<Imager::Filter/mosaic>
+
+unsharp mask - L<Imager::Filter/unsharpmask>
+
+watermark - L<Imager::Filter/watermark>
+
+writing an image to a file - L<Imager::Files>
  
  =head1 SUPPORT
  
  
  =head1 SUPPORT
  
-You can ask for help, report bugs or express your undying love for
-Imager on the Imager-devel mailing list.
+The best place to get help with Imager is the mailing list.
  
  To subscribe send a message with C<subscribe> in the body to:
  
  
  To subscribe send a message with C<subscribe> in the body to:
  
@@ -2761,14 +3901,25 @@ To subscribe send a message with C<subscribe> in the body to:
  
  or use the form at:
  
  
  or use the form at:
  
-   http://www.molar.is/en/lists/imager-devel/
-   (annonymous is temporarily off due to spam)
+=over
+
+L<http://www.molar.is/en/lists/imager-devel/>
+
+=back
  
  where you can also find the mailing list archive.
  
  
  where you can also find the mailing list archive.
  
-If you're into IRC, you can typically find the developers in #Imager
-on irc.rhizomatic.net.  As with any IRC channel, the participants
-could be occupied or asleep, so please be patient.
+You can report bugs by pointing your browser at:
+
+=over
+
+L<https://rt.cpan.org/NoAuth/ReportBug.html?Queue=Imager>
+
+=back
+
+Please remember to include the versions of Imager, perl, supporting
+libraries, and any relevant code.  If you have specific images that
+cause the problems, please include those too.
  
  =head1 BUGS
  
  
  =head1 BUGS
  
@@ -2776,21 +3927,23 @@ Bugs are listed individually for relevant pod pages.
  
  =head1 AUTHOR
  
  
  =head1 AUTHOR
  
-Arnar M. Hrafnkelsson (addi@imager.perl.org) and Tony Cook
-(tony@imager.perl.org) See the README for a complete list.
+Arnar M. Hrafnkelsson and Tony Cook (tony@imager.perl.org) among
+others. See the README for a complete list.
  
  =head1 SEE ALSO
  
  
  =head1 SEE ALSO
  
-perl(1), Imager::ImageTypes(3), Imager::Files(3), Imager::Draw(3),
-Imager::Color(3), Imager::Fill(3), Imager::Font(3),
-Imager::Transformations(3), Imager::Engines(3), Imager::Filters(3),
-Imager::Expr(3), Imager::Matrix2d(3), Imager::Fountain(3)
+L<perl>(1), L<Imager::ImageTypes>(3), L<Imager::Files>(3),
+L<Imager::Draw>(3), L<Imager::Color>(3), L<Imager::Fill>(3),
+L<Imager::Font>(3), L<Imager::Transformations>(3),
+L<Imager::Engines>(3), L<Imager::Filters>(3), L<Imager::Expr>(3),
+L<Imager::Matrix2d>(3), L<Imager::Fountain>(3)
  
  
-Affix::Infix2Postfix(3), Parse::RecDescent(3)
-http://www.eecs.umich.edu/~addi/perl/Imager/
-
-=cut
+L<http://imager.perl.org/>
  
  
+L<Affix::Infix2Postfix>(3), L<Parse::RecDescent>(3)
  
  
+Other perl imaging modules include:
  
  
+L<GD>(3), L<Image::Magick>(3), L<Graphics::Magick>(3).
  
  
+=cut