Gecko [ www.vortexaion.com ]

Name	Size	Permission	Date
Color	[ DIR ]	drwxrwxrwx	2024-07-26 17:39
Expr	[ DIR ]	drwxrwxrwx	2024-07-26 17:39
File	[ DIR ]	drwxrwxrwx	2024-07-26 17:39
Filter	[ DIR ]	drwxrwxrwx	2024-07-26 17:39
Font	[ DIR ]	drwxrwxrwx	2024-07-26 17:39
include	[ DIR ]	drwxrwxrwx	2024-07-26 17:39
API.pod	9.89 KB	-rw-rw-rw-	2015-01-25 11:51
APIRef.pod	51.62 KB	-rw-rw-rw-	2021-01-24 17:46
Color.pm	16.61 KB	-rw-rw-rw-	2020-06-13 09:09
Cookbook.pod	15.1 KB	-rw-rw-rw-	2014-01-10 11:46
CountColor.pm	817 B	-rw-rw-rw-	2020-06-13 10:10
Draw.pod	36.08 KB	-rw-rw-rw-	2019-12-26 11:47
Engines.pod	13.1 KB	-rw-rw-rw-	2014-01-10 11:46
Expr.pm	15.57 KB	-rw-rw-rw-	2020-06-13 09:36
ExtUtils.pm	2.06 KB	-rw-rw-rw-	2020-06-13 09:37
Files.pod	55.26 KB	-rw-rw-rw-	2019-02-26 09:03
Fill.pm	12.08 KB	-rw-rw-rw-	2020-06-13 09:45
Filters.pod	21.76 KB	-rw-rw-rw-	2020-03-21 03:07
Font.pm	27.12 KB	-rw-rw-rw-	2020-06-13 09:11
Fountain.pm	9.25 KB	-rw-rw-rw-	2020-06-13 09:11
Handy.pod	924 B	-rw-rw-rw-	2014-01-10 11:46
IO.pod	8.35 KB	-rw-rw-rw-	2019-01-15 06:30
ImageTypes.pod	32.63 KB	-rw-rw-rw-	2015-11-09 11:01
Inline.pod	1.54 KB	-rw-rw-rw-	2014-01-10 11:46
Install.pod	10.91 KB	-rw-rw-rw-	2020-06-13 08:54
LargeSamples.pod	3.15 KB	-rw-rw-rw-	2014-01-10 11:46
Matrix2d.pm	10.16 KB	-rw-rw-rw-	2020-06-13 10:15
Preprocess.pm	7.32 KB	-rw-rw-rw-	2020-06-13 09:48
Probe.pm	16.45 KB	-rw-rw-rw-	2020-06-13 10:16
Regops.pm	9.36 KB	-rw-rw-rw-	2020-06-13 09:50
Security.pod	1.68 KB	-rw-rw-rw-	2014-01-10 11:46
Test.pm	30.68 KB	-rw-rw-rw-	2020-06-13 10:16
Threads.pod	1.83 KB	-rw-rw-rw-	2014-01-10 11:46
Transform.pm	12.1 KB	-rw-rw-rw-	2020-06-13 09:26
Transformations.pod	27.45 KB	-rw-rw-rw-	2018-09-14 04:56
Tutorial.pod	4.98 KB	-rw-rw-rw-	2014-01-10 11:46
interface.pod	8.72 KB	-rw-rw-rw-	2014-01-10 11:46
regmach.pod	2.68 KB	-rw-rw-rw-	2014-01-10 11:46
typemap	4.03 KB	-rw-rw-rw-	2019-01-15 06:30

Rename

=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