[rt #79989] setsamples() isn't 16-bit only
authorTony Cook <tony@develop-help.com>
Mon, 8 Oct 2012 08:46:05 +0000 (19:46 +1100)
committerTony Cook <tony@develop-help.com>
Mon, 8 Oct 2012 08:46:05 +0000 (19:46 +1100)
and hasn't been for a long while.

Other minor edits

lib/Imager/Draw.pod

index 4bf6773424e82571fc5e24403715878a2389d0e4..b06a2fe502b64fc14f3861e3042919d21b043e06 100644 (file)
@@ -880,14 +880,14 @@ color data.
 =item *
 
 C<type> - the type of pixel data supplied.  If you supply an array
-reference of object then this is determined automatically.  If you
-supply packed color data this defaults to C<'8bit'>, if your data is
-packed floating point color data then set this to C<'float'>.
+reference then this is determined automatically.  If you supply packed
+color data this defaults to C<'8bit'>, if your data is packed floating
+point color data then you need to set this to C<'float'>.
 
 You can use C<float> or C<8bit> samples with any image.
 
-If this is 'index' then pixels should be either an array of palette
-color indexes or a packed string of color indexes.
+If this is C<index> then C<pixels> should be either an array of
+palette color indexes or a packed string of color indexes.
 
 =back
 
@@ -1099,8 +1099,7 @@ Retrieve 16-bit samples:
 
 =item setsamples()
 
-This allows writing of samples back to some images.  Currently this is
-only supported for 16-bit/sample images.
+This allows writing of samples to an image.
 
 Parameters:
 
@@ -1205,6 +1204,10 @@ To produce packed double/sample pixels, use the pack C<d> template:
 
   my $packed_float_pixel = pack("dddd", $red, $blue, $green, $alpha);
 
+Note that double/sample data is always stored using the C C<double>
+type, never C<long double>, even if C<perl> is built with
+C<-Duselongdouble>.
+
 If you use a I<type> parameter of C<index> then the values are palette
 color indexes, not sample values: