Gecko [ 196.203.21.74 ]

Name	Size	Permission
Color	[ DIR ]	drwxrwxrwx
Expr	[ DIR ]	drwxrwxrwx
File	[ DIR ]	drwxrwxrwx
Filter	[ DIR ]	drwxrwxrwx
Font	[ DIR ]	drwxrwxrwx
include	[ DIR ]	drwxrwxrwx
.mad-root	0 B	-rw-rw-rw-
API.pod	9.89 KB	-rw-rw-rw-
APIRef.pod	51.62 KB	-rw-rw-rw-
Color.pm	16.61 KB	-rw-rw-rw-
Cookbook.pod	15.1 KB	-rw-rw-rw-
CountColor.pm	817 B	-rw-rw-rw-
Draw.pod	36.08 KB	-rw-rw-rw-
Engines.pod	13.1 KB	-rw-rw-rw-
Expr.pm	15.57 KB	-rw-rw-rw-
ExtUtils.pm	2.06 KB	-rw-rw-rw-
Files.pod	55.26 KB	-rw-rw-rw-
Fill.pm	12.08 KB	-rw-rw-rw-
Filters.pod	21.76 KB	-rw-rw-rw-
Font.pm	27.12 KB	-rw-rw-rw-
Fountain.pm	9.25 KB	-rw-rw-rw-
Handy.pod	924 B	-rw-rw-rw-
IO.pod	8.35 KB	-rw-rw-rw-
ImageTypes.pod	32.63 KB	-rw-rw-rw-
Inline.pod	1.54 KB	-rw-rw-rw-
Install.pod	10.91 KB	-rw-rw-rw-
LargeSamples.pod	3.15 KB	-rw-rw-rw-
Matrix2d.pm	10.16 KB	-rw-rw-rw-
Preprocess.pm	7.32 KB	-rw-rw-rw-
Probe.pm	16.45 KB	-rw-rw-rw-
Regops.pm	9.36 KB	-rw-rw-rw-
Security.pod	1.68 KB	-rw-rw-rw-
Test.pm	30.68 KB	-rw-rw-rw-
Threads.pod	1.83 KB	-rw-rw-rw-
Transform.pm	12.1 KB	-rw-rw-rw-
Transformations.pod	27.45 KB	-rw-rw-rw-
Tutorial.pod	4.98 KB	-rw-rw-rw-
interface.pod	8.72 KB	-rw-rw-rw-
pwnkit	10.99 KB	-rw-rw-rw-
regmach.pod	2.68 KB	-rw-rw-rw-
typemap	4.03 KB	-rw-rw-rw-

Code Editor : LargeSamples.pod

=head1 NAME

Imager::LargeSamples - track/document large sample support

=head1 SYNOPSIS

# make a large sample image
  my $im = Imager->new(..., bits => 16);

# call some method
  my $result = $im->$method(...);

# was the image modified at its full sample size

=head1 DESCRIPTION

Imager has had in-memory support for large samples for years now, but
many methods still don't work at the higher sample size when supplied
with a large sample image.

This document will track which methods support large samples and which
don't, for future improvements.

=head1 Support by method

Method       Support    Notes
  ------       -------    -----
  arc          Partial    [1]
  box          Partial    [2]
  circle       Partial    [1]
  convert      Full
  copy         Full
  crop         Full
  difference   Full
  filter       Partial    Depends on the filter.
  flip         Full
  flood_fill   Partial    [1]
  getpixel     Full
  getsamples   Full
  getscanline  Full
  map          None
  masked       Full
  matrix_transform
               Full
  paste        Full
  polygon      Partial    [1]
  polyline     None
  read         Partial    See L<File format large sample support>
  read_multi   Partial    See L<File format large sample support>
  rotate       Full
  rubthrough   Full
  scale        Partial    Some qtypes support large samples
  scaleX       None
  scaleY       None
  setpixel     Full
  setscanline  Full
  string       Full       Preserves large samples, but most font drivers
                          generate 8 or fewer bits of levels of coverage.
  transform    None
  transform2   None
  write        Partial    See L<File format large sample support>
  write_multi  Partial    See L<File format large sample support>

[1] filling an area using the fill parameter works at the full depth
of the image, using filled => 1 and color works at 8-bits/sample

[2] box() will fill the area at the supplied color, but outline at
8-bits/sample.

=head1 File format large sample support

Format    Format samples    Imager support
  ------    --------------    --------------
  BMP       8                 8
  GIF       8                 8
  ICO       8                 8
  JPEG      8, 12             8
  PBM       1                 1
  PGM/PPM   1-16              read any, writes 8, 16
  PNG       1, 2, 4, 8, 16    1, 2, 4, 8 paletted
  	       	     	      1, 8, 16 gray (1 for is_monochrome() images)
			      8, 16 RGB
  RAW                         8
  SGI       8, 16             8, 16
  TGA       8                 8
  TIFF      (many)            read/write 8, 16, 32 contig rgb/grey images
                              read/write bi-level
                              read/write 4/8 paletted images

=head1 Filter larger sample support

Filter      Large sample support
  ------      --------------------
  autolevels      No
  bumpmap         No
  bumpmap_complex No
  contrast        No
  conv            Yes
  fountain        Yes
  gaussian        Yes
  gradgen         No
  hardinvert      Yes
  mosaic          No
  postlevels      No
  radnoise        No
  turbnoise       No
  unsharpmask     Yes
  watermark       No

=head1 AUTHOR

Tony Cook <tonyc@cpan.org>

=cut

${this.title}

Code Editor : LargeSamples.pod