TODO

   1                          *** TODO ***
   2
   3
   4 Iolayer:
   5 - Add scalar/mmap to iolayer
   6 - Add close() code to iolayer for fakeseek sources.
   7 - Merge callback interface into iolayer
   8 - and raw
   9 - Implment the maxread threshold (Indicates how much can
  10   be read from a source before it stops reading from its
  11   underlying source.  For making sure only the relevant
  12   data is read from a socket for example.
  13
  14
  15 Enhanched internal structure:
  16
  17 MultiImage & metadata support:
  18 - Figure what interface should be between C and perl?
  19 - How to store data in the C interface for tags/metadata?
  20   Support tiff's madness, i.e. tags and options.
  21 - Error handling, make a general i_errstr object and arrange
  22   such that each image has an i_errstr object to hold its
  23   local errors?
  24 - SEE design/represent.txt for proposed new structure and
  25   interface design that takes these factors into account.
  26 - define common i_* tags for specifying attribute common among images
  27   like spatial resolution (implement for other image types, especially
  28   TIFF)  (Spatial resolution is supported for all types that support
  29   it - are there any other common properties we can add?)
  30 - implement the i_incomplete tag for other formats
  31
  32 New Features:
  33 - Add mng support, pcx and aalib support.
  34   - Windows icon files (.ico)
  35   - ILBM (Amiga) images
  36   - photoshop files (I think I've seen docs)
  37   - XBM
  38   - FITS
  39   - WMF (extract bitmap data on read)
  40   - gzip or bzip2 compressed raw
  41   - postscript for output
  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
  92 - compose channels - build a new image based on channels from several
  93   images
  94
  95 - arc outlines
  96
  97 - complex lines/curves:
  98   - thick lines:
  99     - dotted/dashed lines
 100     - doubled lines?
 101     - end-point controls (butt-end, square-end, round-end, pointy, arrows)
 102   - brush-lines (as with the Gimp, or Photoshop)
 103     - more complex with multiple strokes and various randomness as with
 104       Fractal Design Painter (or later versions of Corel Photo Paint)
 105   - complex line shapes:
 106     - lines
 107     - general curves (cubic or bezier, whichever is more general)
 108     - easy access to general curves:
 109       - points to make a nice curve from
 110       - various circular curves (centre, radii, start/end angles,
 111         direction)
 112   - Complex thick lines are probably more useful than brush-lines for
 113     the things I expect Imager to be used for.
 114   - http://www.develop-help.com/imager/strokes.png (.jpg for smaller version)
 115
 116 Clean up:
 117 - Make sure everything is doable with the OO interface
 118   i_flood_fill() for example.
 119   - include low-level functions like gsamp() and so on
 120
 121 - Compile with memory debugging enabled and fix all leaks
 122
 123 - Add mycalloc() memory allocation wrappers.
 124
 125 - should we overload <=> or cmp for Imager::Color objects?
 126   too many worms, leave it out
 127
 128 - should the interlace option for reading raw images have
 129   symbolic names in the OO interface?
 130
 131 - improve consistency in the interfaces, both in trying to use named
 132   parameters where possible but also in using consistent names, eg.
 133   (tx, ty) vs (left, top) in rubthrough() vs paste().  Do we want a (simple)
 134   standard for this (suggested names)?  Remember to preserve the old
 135   interface where possible.
 136
 137 - try to clean up the inconsistencies between font types:
 138   - utf8 (even if we just treat characters over 0xFF as missing for T1)
 139     (done for FT2, FT1)
 140   - transformations (done for FT2)
 141   - has_char() method (done for FT2, FT1)
 142
 143 Format specific issues:
 144 - provide patches for libgif and libungif that fix their bugs
 145   and give a useful extension interface.  Probe for the
 146   installation of the patches in Makefile.PL to let gif.c
 147   know what features it can use.
 148
 149 - Add options for pnm writer to save in any of the p1..P6
 150   formats.  Even if the input has 1 channel, write 3 and such
 151   cases.  Also allow ascii mode.  Need to be able to write
 152   pbm images which needs ties to the quantization code.
 153
 154 - save paletted images as paletted where that's supported.  Done
 155   for gif/tga/bmp/tiff.  Not done for png yet.
 156
 157 - read other format paletted images as paletted images.  This has
 158   been done for gif/tga/bmp/tiff formats but not for png.
 159
 160 - read/write 16-bit/sample images as such for tiff
 161
 162 - read more metadata from images, esp tiff tags, EXIF format information
 163   from TIFF and JPEG.
 164
 165 Documentation:
 166 - Add to the documentation
 167 - Write a tutorial?
 168 - sample code and Imager/Samples.pod describing them
 169 - Imager/Cookbook.pod
 170 - Write a guide to installing the helper libraries
 171 - Go through the entire project and add comments in pod
 172   so doco.perl can be used to read them.
 173 - see the IRC log in design/doclayout.txt
 174 - method index?
 175 - concept index?