flam3/README.txt

FLAM3 - cosmic recursive fractal flames
see the file COPYING for the license covering this software.

This is free software to render fractal flames as described on
http://flam3.com.  Flam3-animate makes animations, and flam3-render
makes still images.  Flam3-genome creates and manipulates genomes
(parameter sets).  A C library is also installed.

Note: the following instructions are written for Linux users.  Windows
users may install the cygwin package to get the "env" command or set
the envars in your windows command prompt manually.  That means
instead of a command like

    env dtime=5 prefix=foo. in=test.flame flam3-animate

use the following set of commands:

    set dtime=5
    set prefix=foo.
    set in=test.flame
    flam3-animate

As usual, to configure, build, and install:

    ./configure
    make
    sudo make install

If this has problems, you may need to re-generate some configuration
files.  Do the following steps:

    libtoolize
    aclocal
    automake
    autoconf

and then try to configure and install as above.

This package depends on development packages for libz, libpng,
libjpeg, and libxml2.

To test it, run

    flam3-render < test.flam3

and it should produce 00000.jpg and 00001.jpg, one image for each
<flame> element in the parameter file.  To make an animation run

    flam3-animate < test.flam3

and it should produce 100 files named 00000.jpg through 00099.jpg that
interpolate between the two <flame> elements.


envar           default         meaning
=====           =======         =======
prefix          (empty)         prefix names of output files with this string.
begin           j               time of first frame to render (j=first time in input file) (animate only)
end             n-1             time of last frame to render (n=last time specified in the input file) (animate only)
time            NA              time of first and last frame (ie do one frame) (animate only)
frame           NA              synonym for "time" (animate only)
in              stdin           name of input file
out             NA              name of output file (bad idea if rending more than one, use prefix instead)
template        NA              apply defaults based on this genome (genome only)
dtime           1               time between frames (animate only)
fields          0               if 1 then render fields, ie odd scanlines at time+0.5
nstrips         1               number of strips, ie render fractions of a frame at once (render only)
qs              1               quality scale, multiply quality of all frames by this
ss              1               size scale, multiply size (in pixels) of all frames by this
jpeg            NA              jpeg quality for compression, default is native jpeg default
format          png             "jpg" or "ppm" or "png"
pixel_aspect    1.0             aspect ratio of pixels (width over height), eg 0.90909 for NTSC
isaac_seed      random          string to be used in generating random seed.  defaults to time(0)
seed            random          integer seed for random numbers, defaults to time+pid.  deprecated.
nthreads        auto            number of threads to use (render and animate)
verbose         0               if non-zero then print progress meter on stderr
bits            33              also 32 or 64: sets bit-width of internal buffers (33 means 32-bit floating-point)
bpc             8               bits per channel of color: only png supports 16 (render/animate)
image           filename        replace palette with png, jpg, or ppm image
use_vars        -1              comma sep list of variation #'s to use when generating a random flame (genome only)
dont_use_vars   unset           comma sep list of variation #'s to NOT use when generating a random flame. (genome only)
cross0          NA              randomly select one genome from this file to genetically cross (genome only)
cross1          NA                with one genome from this file (genome only)
method          NA              method for genetic cross: alternate, interpolate, or union. (genome only)
mutate          NA              randomly mutate a random genome from this file (genome only)
symmetry        NA              set symmetry of result. (genome only)
clone           NA              clone random flame in input (genome only)
clone_all       NA              clones all flames in file.  useful for applying template to all flames (genome only)
animate         NA              interpolates between all flames in a file, using times specified in file (genome only)
sequence        NA              360 degree rotation 'loops' times of each control point plus rotating transitions (genome only)
loops           NA              number of times to rotate each control point in sequence (genome only)
tries           50              number of tries to make to find a good genome. (genome only)
strip           NA              strip input, frame and nframes control which one. (genome only)
transparency    0               make bknd transparent, if format supports it (render/animate)
name_enable     0               use 'name' attr in <flame> to name image output if present (render only)
nick            ""              nickname to use in <edit> tags / img comments
url             ""              url to use in <edit> tags / img comments
id              ""              ID  to use in <edit> tags / img comments
comment         ""              comment string for <edit> tags (genome only)
use_mem         auto            floating point number of bytes of memory to use (render only)
noedits         unset           omit edit tags from output (genome only)
write_genome    0               write out genome associated with center of motion blur window (animate only)
print_edit_depth 0              depth to truncate <edit> tag structure.  0 prints all <edit> tags (genome only)
intpalette      unset           round palette entries for importing into older Apophysis versions (genome only)
insert_palette  unset           insert the palette into the image.
enable_jpeg_comments  1         enables comments in the jpeg header (render and animate)
enable_png_comments   1         enables comments in the png header (render and animate)

earlyclip       0               enables the early clipping of rgb values for better antialiasing and resizing
                                defaults to 0 for backwards compatibility
flam27          0               flam3 2.7 compatibility mode; ensures generated genomes can be used by flam3 2.7.18
stagger         0               affects simultaneity of xform interpolation during genome interpolation.
                                represents how 'separate' the xforms are interpolated.  set to 1 for each
                                xform to be interpolated individually, fractions control interp overlap.
apo_palette     0               set this to 1 to use only the first 255 elements of the palette (apophysis compatibility)

for example:

    env dtime=5 prefix=foo. in=test.flam3 flam3-animate

means to render every 5th frame of parameter file foo.flam3, and store
the results in files named foo.XXXX.jpg.

the flam3-convert program reads from stdin the old format created by
the GIMP and writes to stdout the new xml format.

the flam3-genome program creates random parameter files. it also mutates,
rotates, and interpolates existing parameter files.  for example to
create 10 wholly new control points and render them at normal quality:

    env template=vidres.flam3 repeat=10 flam3-genome > new.flam3
    flam3-render < new.flam3

if you left out the "template=vidres.flam3" part then the size,
quality, etc parameters would be their default (small) values.  you
can set the symmetry group:

    env template=vidres.flam3 symmetry=3 flam3-genome > new3.flam3
    env template=vidres.flam3 symmetry=-2 flam3-genome > new-2.flam3
    flam3-render < new3.flam3
    flam3-render < new-2.flam3

Mutation is done by giving an input flame file to alter:

    env template=vidres.flam3 flam3-genome > parent.flam3
    env prefix=parent. flam3-render < parent.flam3
    env template=vidres.flam3 mutate=parent.flam3 repeat=10 flam3-genome > mutation.flam3
    flam3-render < mutation.flam3

Normally one wouldn't use the same file for the template and the file
to mutate.  Crossover is handled similarly:

    env template=vidres.flam3 flam3-genome > parent0.flam3
    env prefix=parent0. flam3-render < parent0.flam3
    env template=vidres.flam3 flam3-genome > parent1.flam3
    env prefix=parent1. flam3-render < parent1.flam3
    env template=vidres.flam3 cross0=parent0.flam3 cross1=parent1.flam3 flam3-genome > crossover.flam3
    flam3-render < crossover.flam3

flam3-genome has 3 ways to produce parameter files for animation in
the style of electric sheep.  the highest level and most useful from
the command line is the sequence method.  it takes a collection of
control points and makes an animation that has each flame do fractal
rotation for 360 degrees, then make a smooth transition to the next.
for example:

    env sequence=test.flam3 nframes=20 flam3-genome > seq.flam3
    flam3-animate < seq.flam3

creates and renders a 60 frame animation.  there are two flames in
test.flam3, so the animation consists three stages: the first one
rotating, then a transition, then the second one rotating.  each stage
has 20 frames as specified on the command line.  if you want to
render only some fraction of a whole animation file, specify the begin
and end times:

    env begin=20 end=40 flam3-animate < seq.flam3

the other two methods are harder to use because they produce files that
are only good for one frame of animation.  the output consists of 3
control points, one for the time requested, one before and one after.
that allows proper motion blur.  for example:

    env template=vidres.flam3 flam3-genome > rotme.flam3
    env rotate=rotme.flam3 frame=10 nframes=20 flam3-genome > rot10.flam3
    env frame=10 flam3-animate < rot10.flam3

the file rot10.flam3 specifies the animation for just one frame, in
this case 10 out of 20 frames in the complete animation.  C1
continuous electric sheep genetic crossfades are created like this:

    env inter=test.flam3 frame=10 nframes=20 flam3-genome > inter10.flam3
    env frame=10 flam3-animate < inter10.flam3

see http://flam3.com/flame.pdf for descriptions & formulas, and
see http://electricsheep.wikispaces.com/Variations for updates.

The complete list of variations:

   0. linear
   1. sinusoidal
   2. spherical
   3. swirl
   4. horseshoe
   5. polar
   6. handkerchief
   7. heart
   8. disc
   9. spiral
  10. hyperbolic
  11. diamond
  12. ex
  13. julia
  14. bent
  15. waves
  16. fisheye
  17. popcorn
  18. exponential
  19. power
  20. cosine
  21. rings
  22. fan
  23. blob
  24. pdj
  25. fan2
  26. rings2
  27. eyefish
  28. bubble
  29. cylinder
  30. perspective
  31. noise
  32. julian
  33. juliascope
  34. blur
  35. gaussian_blur
  36. radial_blur
  37. pie
  38. ngon
  39. curl
  40. rectangles
  41. arch
  42. tangent
  43. square
  44. rays
  45. blade
  46. secant2
  47. twintrian
  48. cross
  49. disc2
  50. super_shape
  51. flower
  52. conic
  53. parabola
  54. bent2
  55. bipolar
  56. boarders
  57. butterfly
  58. cell
  59. cpow
  60. curve
  61. edisc
  62. elliptic
  63. escher
  64. foci
  65. lazysusan
  66. loonie
  67. pre_blur
  68. modulus
  69. oscilloscope
  70. polar2
  71. popcorn2
  72. scry
  73. separation
  74. split
  75. splits
  76. stripes
  77. wedge
  78. wedge_julia
  79. wedge_sph
  80. whorl
  81. waves2
  82. exp
  83. log
  84. sin
  85. cos
  86. tan
  87. sec
  88. csc
  89. cot
  90. sinh
  91. cosh
  92. tanh
  93. sech
  94. csch
  95. coth
  96. auger
  97. flux
  
see http://flam3.com/flame.pdf for descriptions & formulas for each of
these.  note that, by default, if a random flame is requested and neither
'use_vars' or 'dont_use_vars' are specified, the following variations are
not used: noise, blur, gaussian_blur, radial_blur, ngon, square, rays, 
and cross.

note: these variations do not use the variation weight to scale their
contributions, and so will not be implemented in flam3:
circlize


======================================

todo:  eliminate all static storage.

======================================

changelog:

5/17/15 Added hsv_circular and hsv_rgb_palette_blend.  Improved
   edit history of genetic algorithm.  Release as 3.0.2.

12/29/10 Added --version option to flam3-genome.  fixed bug in 16 bpc
   png image writing when using strips.  xform opacity now affects
   calculated width of density estimation filters.  Release as 3.0.1.

10/05/10 Small tweaks.  Fuse iterations default to 15 but increase to
   100 when using earlyclip. flux variation added. Release as 3.0.

12/20/09 Highlight power now interpolates smoothly from old behavior
    (-1) to new behavior.  flam3-genome 'split' mode was broken, fixed
    (thanks Exper.)  Die gracefully instead of segfault when very small
    estimator_curve values are specified.  Version attribute added to
    flame tag.  Number of iterations used to fuse attractor increased to
    100.  Release as 2.8beta7.

11/24/09 Potential speedup of 5% over prior versions.  Many threading
    issues identified and resolved when using flam3 shared library as
    back end for user interfaces.  14 complex plane variations added.
    auger variation added.  new flam3_make_strip library function to
    generate stripped genomes for external ui strip renders.  bug fix:
    when rendering strips, use the same random context for each strip
    to prevent edge effects where strips butt against each other. flam3 
    will now linearly interpolate missing colors in the colormap.
    Release as 2.8beta6.

10/16/09 Non-threadsafe progress tracking code in main iteration thread
    replaced with per-render progress storage.  Fixed bug where pausing
    render during density estimation stage terminated render.  Waves2
    variation fixed (thx Joel F). Release as 2.8beta5.

10/07/09 Fixed bug affecting 'animate' mode with flam3-genome.  Changed
    estimate_bounding_box to increase discarded iterations if numerous
    badvals were encountered during iterations.  Exported a few more
    functions for Windows DLL.  Release as 2.8beta4.

10/03/09 Changed color_speed range from 0 (no color change) to 1
    (use new xform color).  Animate attribute is now 0 for no motion,
    1 for motion.  Removed final xform from stagger algorithm.  'oscope'
    parameters are now called 'oscilloscope' to match the rest of the
    parametric variations (backwards compatible, so old genomes can be
    read.) Stagger now affects morphing as well as sheep rotation, but
    only using flam3-genome (not flam3-animate).  Release as 2.8beta3.

03/18/09 Major upgrade :
    - 28 variations added, mostly from the sourceforge plugins pack
    - significant speed optimization of variations
    - setting earlyclip env var on commandline will enable an alternate
      calculation of color values, resulting in better antialiasing
    - 'highlight_power' flame element controls the white highlights in
      dense areas, eliminating the hue shift bug
    - Apophysis chaos and solo xform/plotmode features have been
      implemented.  solo/plotmode are promoted to floating point
      'opacity'.  opacity and chaos are both interpolatable.
    - <motion> tag now available for xforms...allows cyclic variation
      of any regular xform parameter/coef/post.
    - env var 'stagger' affects the simultaneity of xform interpolation
      when morphing from one flame to another.  set to 0 for existing
      behaviour, set to 1 to make each xform interpolate individually
    - symmetry has been broken out into color_speed and animate tags
      with the same sense (which is confusing and will be fixed in a
      future release).
    - set the flam27 env var to output backwards compatible genomes
      (when possible.)
    - passes the consistency test where rendering an image at double
      size and filtering it down produces the same results as the
      original (modulo quality).

03/17/09 Added fuzz testing with zzuf to the regression tests.  'Strip'
    mode and genomes with the zoom parameter used now break into pieces
    properly.  insert_palette fixed (broken a few versions ago.)  fixed
    twintrian variation when small weights are used.  various rare
    segfaults and memory leaks fixed.  'palette_mode' attribute added to
    flame element for smoother palette interpolation in slow animations;
    possible values are 'step' and 'linear' ('step' mode is default and 
    matches previous behaviour.)  Release as 2.7.18.

11/11/08 Add error checking on the numbers in the input genome.  Do
    not exit on read errors, fail gracefully. Changed sin/cos = tan in
    the tangent variation. Added polar to list of variations that use
    the inverted linear identity. Bugfix: temporal_filter_exp was not
    set properly in template. Apply interpolation attribute in
    templates. Add/publish datarootdir with pkg-config so the palette
    file is easy to find (for qosmic). Copyright by Spotworks LLC
    instead of Spot and Erik.  Add fuzz checks to the regression
    suite.  include LNX/OSX/WIN in the version string.  In
    flam3-genome animate command, added one to last flame time, so the
    end time is inclusive.  Release as 2.7.17.

09/06/08 Added 'clone_all' to flam3_genome to allow application of 
    template to all flames in a file at once, and 'animate' to write
    a full sequence of interpolations out.  'animate' is similar to 
    'sequence' except that no control point rotation is performed.  
    Fixed non-functional 'write_genome' env var for flam3_animate.  
    Two bugs associated with interpolating from a log interpolation_type
    to a non-log interpolation_type fixed (rotate angle reduction and 
    special inverted identity).  when using flam3_rotate in 'spin_inter'
    the interp type of the first genome is now used rather than the
    current genome's interp type.  Enforced upper and lower bounds for
    xform color and upper bound for interpolated colormap values
    as "smooth" interpolation led to values out of range.  If "smooth"
    interpolation is specified for all flames in a file, the first and
    second-to-last genome is switched to "linear" with a warning.
    spatial filters with non-box-filter window functions fixed.
    Release as 2.7.16.
    

08/25/08 Added new interpolation types 'old' and 'older', for use in 
    recreating old animations.  'linear' mode now does not rotate padded
    xforms (results in prettier symmetric singularities). switched to
    using a 'padding' flag instead of a 'just initialized' flag; padding 
    flag used for implementation of 'old' and 'older' types.  
    interpolation_space now deprecated, instead use interpolation_type. 
    flam3_align is now idempotent (multiple applications do not change
    the control points.)  Default number of temporal samples bumped to 
    1000.  Removed CVS headers from source code (now using SVN).
    Default interpolation mode now log. Removed 'move' and 'split' vars.
    changes to flam3-genome: sequence mode now returns linear 
    interpolation mode for all control points except first/last of edges 
    - these cps will use the original interpolation mode;  inter and 
    rotate modes will now return padded genomes for all control points,
    all with linear interpolation specified.  instead of centering 
    sometimes reframe by golden mean plus noise. Release as 2.7.15.

07/21/08 Add configuration option for atomic-ops.  bug fix: do not
    truncate floating point palettes.  new motion blur features: add
    temporal_filter_type, can be "box" (default) or "gaussian" or
    "exp".  Temporal_filter_width and temporal_filter_exp are parms to
    it.  'blur' env var no longer used.  Small bug fix: iteration
    count depends only on the size of the output image, not the padded
    image (the gutter).  When interpolating, only do -pi/pi adjustment
    for non-asymmetric cases.  Julian/juliascope variations use the
    alternate inverted identity for interpolation (reduces wedge
    effect).  Add python script for regression and consistency
    checking. Add svn revision number to version string (in the
    software not of the package). Release as 2.7.14.

05/28/08 Restored upper limit on particle coordinates.  Release as
    2.7.13.

05/16/08 Added man pages.  Removed upper limit on particle
    coordinates.  fixed FSF address in comments.  update to automake
    1.10.1.  added eps to denom of perspective fraction to avoid
    infinities (thanks fred).  Put contents of 'id' env var in png/jpg
    comment block.  Release as 2.7.12.

04/05/08 Added 16 bit per channel support to PNG via bpc envar.
    isaac.h is now installed with the flam3 headers.  Strip indexing
    now done with size_t's to fix bug in large images (thanks Paul).
    Progress callback now returns ETA, and per-thread verbose flag
    functionality fixed.  Enumerated spatial filter types now used in
    flam3.h, taking the place of function pointers (simplifies the
    API).  Fix bug by moving precalculation of variation variables to
    flam3_iterate (thanks david).  Release as 2.7.11.

03/15/08 fixed interpolation bug when magnitude of rotation/scaling
    component of affine transform is 0.  replaced secant variation
    with more flame-friendly secant2 (eliminates gap in y direction,
    scales y-coordinate by weight).  warning message now printed when 
    unrecognized variation is present in an xform.  fixed bad 
    inequality when checking for -pi/pi discontinuity during complex 
    interpolation.  release as 2.7.10.

02/08/08 non-zero weights for final xforms no longer allowed, and now 
    have no effect.  recompiled windows exes with mingw gcc 4.1 to 
    take advantage of scalability improvements in flam3 2.7.8 (was 
    compiling with mingw gcc 3.4 until now). for fedora package 
    compliance, flam3.pc.in patched by ian weller and moved use of 
    config.h to c files only. release as 2.7.9.

01/26/08 better scalability across multiple CPUs by using compare and
    swap (from Tim Hockin).  fix bug in large images (>2GB).  add
    flam3_srandom and flam3_malloc/free to better support wrapping
    with python on windows, which links with a different C
    runtime. add --enable-shared option to configure script (from
    Bobby R Ward). release as 2.7.8.

12/16/07 fixed bug (rare random crash) identified by david burnett.
    initialize new xforms with better defaults for parametric
    variations (based on interpolated-against xforms).  add id envar,
    like nick/url.  add clone_action envar.  return to xform
    interpolation based on complex logs, but make consistent decisions
    about counter/clockwise rotation across the sheep edges.
    interpolation_space attribute to flame element can be set to
    "linear" to go back to the simpler method, or "log" to use this
    new (default) method. release as 2.7.7

10/20/07 fixed action string overflow when many xforms are present.
    added 'print_edit_depth' env var to control how many levels of
    <edit> tags are saved when using flam3-genome.  Fixed wrong
    placement of random improve_colors code in flam3-genome.  go to
    five digit filenames.  fixed bug in supershape variation.  API
    cleanup, thanks to david bitseff.  release 2.7.6.

08/14/07 various code updates to assist with compiling under msvc++.
    now can specify --disable-pthread or --enable-pthread to configure
    to better control compilation.  fixed bug preventing renders of
    flames with more than 128 xforms.  release 2.7.5.

07/12/07 fixed bug in split variation, now compatible with both
    versions of Apo.  added insert_palette option.  switched density
    estimation kernel from Epanichnikov to Gaussian.  genetic cross
    now crosses palettes rather than selecting one of the parent 
    palettes.  remove noisy variations from random generation if 
    use_vars or dont_use_vars not specified.  fixed metrics calculated
    on small test render for genetic operations.  reduced memory 
    requirements for density estimation filters.  64-bit linux distros
    now supported.  release 2.7.4.


06/21/07 flam3 version, rendered genome, some render statistics and
    optionally nick/url stored in jpeg/png headers.  fixed two bugs
    in isaac rng code (strongly affected temporal blur).  prevent 
    final xform rotation for sheep animation.  fixed interpolation 
    when only one flame has final xform.  added Supershape, Flower, 
    Conic, Parabola, Move and Split variations.  Shape combined with 
    Supershape via 'rnd' parameter.  flam3-genome now writes 'name' 
    attribute for rotate and sequence modes. oversample attribute 
    deprecated; supersample now preferred. new build process for 
    windows exes using MinGW/MSYS.  added 'intpalette' env var to 
    round floating point palettes to allow older versions of Apophysis 
    to read them. default image type is now PNG, transparency off.  
    density estimation code revised to be more consistent between 
    different supersample levels, which required change to default 
    de params.  limit number of de filters to conserve memory.  fixed 
    julia variation dependency on non-thread-safe random bit function.
    removed random number storage for radial blur variation.
    release 2.7.3.
    07/26/08: Note, incompat. change made to direction of cp->rotate
    (as of 2.7.3, rotates shortest distance instead of clockwise) 

02/09/07 use isaac random number generator to avoid differences
	 between mac/pc/linux.  use multiple threads to take advantage
	 of multiple CPUs or cores.  new variations: disc2, Arch,
	 Tangent, Square, Rays, Blade, Secant, Twintrian, Cross.
	 fixed bug reading hex color format - must remove \n prior to
	 start of colors if present.  use EPS in spiral, hyperbolic
	 and spherical to eliminate black spots.  fix numbering of
	 disc2, change parameter to estimate_bounding_box.  made blur
	 kernel type templatable.  removed extraneous 'enabled="1"' in
	 writing out final xform information (no longer needed).
	 release 2.7.2.

12/31/06 fixed bug in waves precalculation code.  curl and rectangles
	 variations from joel faber.  remove visibility of
	 rotation_center attribute, fix strips operator to handle
	 rotation without it.  added motion exponent and gamma lin
	 thresh to flam3_print. list of variations in the docstring
	 automatically generated.  flam3-genome: envar noedits
	 suppresses output of edit history. release 2.7.1.

09/27/06 print out palette as floating point with up to 6 digits
	 rather than integers (for very slow smooth transitions).
	 Added optimization to only recalculate the xform distrib
	 array when necessary (Thanks Joel Faber).  Added settable
	 kernel for downrez.  Added XML reading code for new <palette>
	 format for gradients.  Functionalized hex gradient read.
	 Removed color shift experimental feature.  New
	 'motion_exponent' attribute controls fade of temporal steps.
	 added gaussian_blur and radial_blur vars from apo.  added pie
	 and ngon variations from joel faber.  add rotation_center
	 attribute. added but disabled image variation from joel.
	 release as 2.7.

06/26/06 use new libpng api, handle libpng errors properly (from nix
	 at esperi.org.uk).  print out palette as floating point with
	 6 digits rather than integers (for very slow smooth
	 transitions).

06/11/06 disable density estimation for 16 and 32 bit buffers because
	 it doesn't work.  Apo team removed "enabled" from final xform
	 specification, so now it defaults to on.  make default
	 temporal samples be 60 so that motion blur is the default,
	 but explicitly ignore temporal samples when rendering still
	 frames.  add strip genetic operator to flam3-genome for
	 breaking a flame into strips for parallel rendering.  add
	 subpixel offsets for antialiasing by averaging multiple
	 images.  release as 2.7b8.

05/25/06 change attribute name "batches" to "passes" because many old
         genomes have it set, and with density estimation it is
         harmful.

04/28/06 remove debugging code, release as 2.7b7.

04/28/06 add attribute interpolation="smooth" for catmull-rom
         interpolation.  known bug: some frames come out dark.
         release as 2.7b6.

04/15/06 rename XML attribute "estimator" to "estimator_radius".  fix
         the progress callback.  add use_mem envar.  move palette
         database to external file.  cleanup namespace.  add new
         variations blur, julian, and juliascope.  fix flam3-convert.
         add experimental color shifting via "shift" envar.  supports
         finalxform.  can read hex palette format. avoids the "square"
         that appears from NaNs.  release as 2.7b5.

01/11/06 unlimited number of xforms per flame.  new variations
	 cylinder and perspective.  rename rename de_max_filter to
	 estimator, de_min_filter to estimator_minimum, de_alpha
	 to estimator_curve, and jitters to temporal_samples.
	 release as 2.7b4.

11/28/05 performance optimization, fix symmetry singularities, added
	 bubble variation, fixed handkerchief variation, templates
	 apply to sequence and rotate flam3-genome commands, added
	 envar "name_enable" to render filenames specified in the
	 "name" attribute of the flame element, small bugfixes,
	 release as 2.7b3.

11/04/05 verbose on by default.  Added 'transparency' envar for png
         renders without transparency channel.  Fixed non-black
         background jpeg renders.  add improve_colors mutation,
         rewrite most of estimate_bounding_box.  added new variations
         blob pdjd fan2 rings2 eyefish.  added '33bit' method for
         32-bit floats.  <edit> tags track history.  alter the gamma
         curve to be linear near 0 to avoid singularity and reduce
         noise, set with gamma_threshold. release as v2.7b2.

09/24/05 new density estimator and temporal jitter code from Erik
         Reckase (note removal of todo items above :).  allow gamma,
         vibrancy, contrast, pixels_per_unit, and brightness to vary
         as part of the genome rather than as part of the rendering
         parameters.  flam3-genome does not retry when cloning.  ditch
         2nd color coordinates.  release as v2.7b1.

06/27/05 in flam3_dimension, give up and return NaN if 90% or more of
	 the samples are being clipped.  release v2.6.

06/22/05 add envar to control the number of tries.

06/06/05 add new form of mutation that introduces post xforms.

05/20/05 fix memory trashing bug resulting from xform overflow.  put
	 regular xforms before symmetry in printed genomes.  enforce
	 weights non-negative & at least one xform.  remove
	 nan-protection from popcorn variation.  truncate xforms with
	 very small weight.

05/13/05 fix bug reported by erik reckase where fan variation could
         blow up to NaN because the domain of atan2 was not protected.
         remove protection from all atan2 calls and instead detect NaN
         results and replace them with noise.  count really large
         values as bad too to prevent blowing up to infinity.  enforce
         0<=hue<1, release v2.6b1.

05/05/05 report choices made during genome generation in notes
	 attribute.  flam3_dimension no longer hangs when most of the
	 attractor is outside the camera.  limit number of variations
	 produced by genetic operators to 5.  reduce rate of
	 interpolation method of crossover.

03/17/05 put cloning back in (found by James Rantanen).

03/08/05 change sawtooth variation (incompatible!).  add fan
	 variation.  rename sawtooth to rings.  release as v2.5.

03/01/05 fix rotation when nstrips > 1.  add flam3_dimension().  minor
	 bugfixes.  release as v2.4.

01/25/05 release as v2.3.

01/18/05 support post xforms (idea from eric nguyen).  support camera
	 rotation. 

12/28/04 release as v2.2.

12/27/04 preview implementation of image fractalization by adding a
         color coordinate.  changed how random/default color
         coordinates are selected (they alternate 0 and 1 instead of
         being distributed between 0 and 1).  WARNING: incompatible
         format change to samples argument of flam3_iterate.

12/20/04 allow mutation and crossover from files with multiple
         genomes.  a random genome is selected for each repetition.

12/11/04 fix bug printing out interpolated non-built-in palettes.
	 warn if any images sizes in animation do not match.

12/01/04 remove debugging code left in flam3-convert, thanks to Paul
	 Fishwick for reporting this.  add cosine variation.  add
	 sawtooth variation.  handle nstrips that do not divide the
	 height.  write partial results as strips are computed.  fix
	 old bug where in 32 bit mode one of the terms appeared to be
	 calculated at 16 bits.  release as v2.1.

10/28/04 fix docstring bug. release as v2.0.1.

10/28/04 renaming, cleanup, and modularization.  now exports
         libflam3.a and flam3.h, all names prefixed with flam3_.
         binaries named with flam3- prefix, genome files use flam3
	 suffix.  create and install a flam3.pc pkg-config file.
	 release as v2.0.

09/21/04 fix bug where code for integer rounding was left in 64-bit
	 floating point version.  round remaining time up so we do not
	 say ETA in 0 seconds.  do not use static allocation to hold
	 onto memory, just malloc and free what we need every frame.
	 enforce positive oversampling.  fix bug in hqi on sequences
	 of images of different sizes.  release as v1.15.

09/17/04 change name of envar to control jpeg compression quality from
	 "quality" to "jpeg".  check for bad nbatches values.  release
	 as v1.14.

08/23/04 add about 600 cmaps from Jackie, Pat Phillips, Classylady,
         and BTomchek.  use 64-bit (double) sized buffers.  remove
	 white_level. add new variations: exponential & power.  fix
	 bug where hue_rotation was left uninitialized.  add clone
	 option to pick-flame which just applies template to the input
	 without modifying genome.  random_control_point can now put
	 multiple variations in one xform.  remove altivec code because
	 it is incompatible with 64-bit buffers.  verbose (progress bar
	 on stderr) from Jon Morton.  control random number seeds via
	 seed envar.  support buffer sizes 16, 32, or 64 bits with
	 three versions of rect.c included into libifs.c.

03/28/04 fix bug interpolating between flames with different numbers
	 of xforms introduced by the new de/parsing.  add modified
	 version of the popcorn variation from apophysis.  fix small
	 bug in waves variation.  make distribution of variations
	 even.  add altivec code from R.J. Berry of warwick.ac.uk.
	 release as v1.13.

03/26/04 add wave variation.  allow negative variational coefs.  do
	 not truncate filter width to an integer.  add fisheye
	 variation.  make variations print by name instead of using a
	 vector, that is say spherical="1" instead of var="0 0 1" or
	 var1="2".  it should still read the old format.

03/07/04 fix bug printing out result of interpolating between
	 symmetries. release as v1.11.

03/03/04 add new means of crossover: a random point between the
	 parents as defined by linear interpolation.  in all kinds of
	 crossover, reset the color coordinates to make sure they are 
	 spread out well.  somehow lost part of the extra_attributes
	 patch, so put it in again.  add pixel_aspect_ratio envar.
	 decrease filter cutoff threshold.  the edges of the filter
	 were almost zeros, so making the filter smaller saves time
	 with almost no effect on the results.  do not print out the
	 attributes of control points that have default values.
	 release as v1.10. 

02/26/04 remove prefix argument to print_control_point, and add
	 extra_attributes.  allow any value for vibrancy parameter.
	 allow variation blending coefs to have any values.  do not
	 normalize them.  on windows nstrips is computated
	 automatically to fit within memory (leaves at least 20%
	 unused).  support png image format and if output is png then
	 compute & output alpha channel. release as v1.9.

02/01/04 add julia variation, and put bent variation back in.  change
         how colors are computed in presense of symmetry: xforms that
         come from a symmetry do not change the color index.  this
         prevents the colors from washing out.  since an xform may be
         interpolated between a symmetry and not, this this is a
         blending factor.  add more documentation.  add function to
         compute lyapunov coefs. allow control over symmetries
         produced by pick-flame.  release as v1.8.

07/20/03 cleanup, update documentation, release as v1.7.

07/15/03 fix bug in interpolation where in last frame when going from
	 non-symmetric to symmetric it left out some xforms.  drop
	 support for "cmap_inter".  add var1 as a abbreviation to var
	 in xml output, and do not print trailing 0s in var string.

07/09/03 change matrix interpolation to be linear rather than complex
	 log to avoid the discontinuity at 180 degrees.  this was
	 causing jumpiness in the C1 continuous algorithm.  this means
	 that rotation has to be handled with pick-flame.  put direct
	 support for symmetries in the de/parser to make control
	 points smaller and easier to understand.  support
	 combinations of bilateral & rotational symmetry.

06/22/03 bug in colormap interpolation.  release as v1.6.

06/20/03 fix some bugs, in particular remove sorting of the xforms
	 when control points are read.  they are only sorted when they
	 are generated.  updated dates on copyright notices.  added
	 time parameter to anim, shorthand for begin & end being the
	 same. added a fairly terrible hack to allow palettes to be
	 specified as blending of two basic palettes.  this requires
	 much less bandwidth than sending 256 rgb triples.  in
	 pick-flame change default to be enclosed xml output.

06/09/03 add C1 continuous interpolation to pick-flame (suggested by
	 Cassidy Curtis).  added new variations from Ultra Fractal
	 version by Mark Townsend.  added symmetry xforms.

06/02/03 add convert-flame which reads the old file format and writes 
	 the new one. release as v1.5.

03/22/03 fix bug in hqi & anim.  somewhere along the way (prolly jpeg)
	 nstrips was broken.  add qs and ss params to hqi.
	 discontinue strips for anim because the implementation is a
	 bit problematic (animating zoom??).  bump version to 1.4.

03/05/03 add pick-flame.c to the project, and extend it with mutation
	 and crossover capability.  add parse_control_points_from_file
	 (and use it). rename non-xml variants of de/parsers to *_old
	 and rename xml variants to remove _xml.  add
	 rotate_control_point.  bump version to 1.3.

02/10/03 increase CHOOSE_XFORM_GRAIN by 10x and use chars instead of
         ints.  remove extra -ljpeg from Makefile.  lose hack that
         ignored density xforms after interpolation.  what was that
         for??  it makes a difference, and just makes interpolation
         less smooth as far as i can tell.  bump version to 1.2.

01/17/03 release as v1.1.

01/16/03 support output in jpeg format; this is the default.  support
	 win32.

01/08/03 by default don't render the last frame so that animations
	 dove-tail and loop

01/06/03 fix how too many xforms are detected so that one more xform
	 is allowed.

12/22/02 first release as independent package.  release as v1.0.