TODO

   1                          *** TODO ***
   2
   3 Iolayer:
   4 - Add scalar/mmap to iolayer
   5 - Add close() code to iolayer for fakeseek sources.
   6 - Merge callback interface into iolayer
   7 - and raw
   8 - Implment the maxread threshold (Indicates how much can
   9   be read from a source before it stops reading from its
  10   underlying source.  For making sure only the relevant
  11   data is read from a socket for example.
  12
  13
  14 Enhanched internal structure:
  15
  16 MultiImage & metadata support:
  17 - Figure what interface should be between C and perl?
  18 - How to store data in the C interface for tags/metadata?
  19   Support tiff's madness, i.e. tags and options.
  20 - Error handling, make a general i_errstr object and arrange
  21   such that each image has an i_errstr object to hold its
  22   local errors?
  23 - SEE design/represent.txt for proposed new structure and
  24   interface design that takes these factors into account.
  25 - define common i_* tags for specifying attribute common among images
  26   like spatial resolution (implement for other image types, especially
  27   TIFF)  (Spatial resolution is supported for all types that support
  28   it - are there any other common properties we can add?)
  29 - implement the i_incomplete tag for other formats
  30
  31 New Features:
  32 - Add mng support, pcx and aalib support.
  33   - Windows icon files (.ico)
  34   - ILBM (Amiga) images
  35   - photoshop files (I think I've seen docs)
  36   - XBM
  37   - FITS
  38   - WMF (extract bitmap data on read)
  39   - gzip or bzip2 compressed raw
  40   - postscript for output
  41   - PAM file support (man pam in recent PNM tools)
  42
  43 - Transforms, interpolated multidimensional lookup tables.
  44   Usefull for CMYK <-> RGB table lookup.
  45
  46 - advanced font layout (spacing, kerning, alignment) (Artur?)
  47
  48 - ways to check if characters are present in a font, eg. checking if
  49   ligatures are present (done for FreeType2)
  50
  51 - font synthesis - synthesize a bold or slanted font from a normal font
  52   (or even from an existing bold or slanted font)
  53
  54 - utf8 support for text output
  55   (available for FT1, freetype2, should be easy for Win32)
  56
  57 - easy interfaces for text output:
  58   - align text around point, including:
  59     - left, center, right horizontal alignment
  60     - top, center, baseline, bottom alignment
  61     - choose whether to base alignment upon character cells or font
  62       metrics to avoid spacing problems between lines
  63   - fill a box from text, with newline handling
  64     - an option to just return the information that would be used to
  65       output the text, so it can be used for sizing calculations
  66     - how much text fit in the box/how much space is left in the box
  67   - fill a box with rich text (size and font changes)
  68     - as above
  69     - wrapping around boxes/images
  70   - pod2Imager :)
  71
  72 - tools to get more information about fonts/characters:
  73   - name of font "Arial Bold Italic" vs "arialbi.ttf"
  74   - ABC widths for characters (currently the only way to get the C width
  75     for a character is to get the width with a following space and without
  76     and then compare)
  77   - character names
  78
  79 - encodings for text output (maybe using the Encode module to work
  80   between encodings)
  81
  82 - image rotation, 3 ways of doing rotation:
  83   - rotation by shearing, which produces makes lengths in the image larger,
  84     but could be useful
  85   (2 of the 3 have been done)
  86
  87 - read_multi() needs to handle other multi-image types,
  88    (handles TIFF and GIF)
  89
  90 - write_multi() to save other multi-image types, (handles TIFF and GIF)
  91   - pnm binary formats support multiple images per file
  92
  93 - compose channels - build a new image based on channels from several
  94   images
  95
  96 - arc outlines
  97
  98 - complex lines/curves:
  99   - thick lines:
 100     - dotted/dashed lines
 101     - doubled lines?
 102     - end-point controls (butt-end, square-end, round-end, pointy, arrows)
 103   - brush-lines (as with the Gimp, or Photoshop)
 104     - more complex with multiple strokes and various randomness as with
 105       Fractal Design Painter (or later versions of Corel Photo Paint)
 106   - complex line shapes:
 107     - lines
 108     - general curves (cubic or bezier, whichever is more general)
 109     - easy access to general curves:
 110       - points to make a nice curve from
 111       - various circular curves (centre, radii, start/end angles,
 112         direction)
 113   - Complex thick lines are probably more useful than brush-lines for
 114     the things I expect Imager to be used for.
 115   - http://www.develop-help.com/imager/strokes.png (.jpg for smaller version)
 116
 117 - have Imager::Color{::Float}? use Graphics::ColorNames if present.
 118
 119 Clean up:
 120 - Make sure everything is doable with the OO interface
 121   i_flood_fill() for example.
 122   - include low-level functions like gsamp() and so on
 123
 124 - Compile with memory debugging enabled and fix all leaks
 125
 126 - Add mycalloc() memory allocation wrappers.
 127
 128 - should we overload <=> or cmp for Imager::Color objects?
 129   too many worms, leave it out
 130
 131 - should the interlace option for reading raw images have
 132   symbolic names in the OO interface?
 133
 134 - improve consistency in the interfaces, both in trying to use named
 135   parameters where possible but also in using consistent names, eg.
 136   (tx, ty) vs (left, top) in rubthrough() vs paste().  Do we want a (simple)
 137   standard for this (suggested names)?  Remember to preserve the old
 138   interface where possible.
 139
 140 - try to clean up the inconsistencies between font types:
 141   - utf8 (even if we just treat characters over 0xFF as missing for T1)
 142     (done for FT2, FT1, T1)
 143   - transformations (done for FT2)
 144   - has_char() method (done for FT2, FT1, T1)
 145
 146 Format specific issues:
 147 - provide patches for libgif and libungif that fix their bugs
 148   and give a useful extension interface.  Probe for the
 149   installation of the patches in Makefile.PL to let gif.c
 150   know what features it can use.
 151
 152 - Add options for pnm writer to save in any of the p1..P6
 153   formats.  Even if the input has 1 channel, write 3 and such
 154   cases.  Also allow ascii mode.  Need to be able to write
 155   pbm images which needs ties to the quantization code.
 156
 157 - save paletted images as paletted where that's supported.  Done
 158   for gif/tga/bmp/tiff.  Not done for png yet.
 159
 160 - read other format paletted images as paletted images.  This has
 161   been done for gif/tga/bmp/tiff formats but not for png.
 162
 163 - read/write 16-bit/sample images as such for tiff
 164
 165 - read more metadata from images, esp tiff tags, EXIF format information
 166   from TIFF and JPEG.
 167
 168 - handle 16-bit/sample pgm/ppm files
 169
 170 Documentation:
 171 - Add to the documentation
 172 - Write a tutorial?
 173 - sample code and Imager/Samples.pod describing them
 174 - Imager/Cookbook.pod
 175 - Write a guide to installing the helper libraries
 176 - Go through the entire project and add comments in pod
 177   so doco.perl can be used to read them.
 178 - see the IRC log in design/doclayout.txt
 179 - method index?
 180 - concept index?
 181
 182 Build/configure:
 183 - use prompt() (from ExtUtils::MakeMaker) for questions in Makefile.PL
 184 - use the library's mechanism's to find the library if needed, for
 185   example, freetype-config for FT2
 186 - the freetype2 library is built as "freetype.lib" on Win32 and needs
 187   to be renamed to be found by the configuration process and included
 188   with -lfreetype.  Try to work around that.
 189 - freetype2 and freetype1 tend to be installed in /usr/include/freetype2
 190   and /usr/include/freetype directories, or similarly named (somedir/freetype
 191   for example), instead of putting these directly into the search path
 192   search for the freetype{2}?/someheader and then add the subdirectory if
 193   we find the file in that directory.
 194 - switch to Test::More