summaryrefslogtreecommitdiff
path: root/src/README.txt
diff options
context:
space:
mode:
Diffstat (limited to 'src/README.txt')
-rw-r--r--src/README.txt820
1 files changed, 820 insertions, 0 deletions
diff --git a/src/README.txt b/src/README.txt
new file mode 100644
index 0000000..2e02bdd
--- /dev/null
+++ b/src/README.txt
@@ -0,0 +1,820 @@
+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
+
+say
+
+ set dtime=5
+ set prefix=foo.
+ set in=test.flame
+ flam3-animate
+
+As usual, to configure, build, and install:
+
+ ./configure
+ make
+ sudo make install
+
+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)
+
+New in 2.8:
+
+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.
+
+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
+
+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:
+
+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 parameter to output backwards compatible genomes.
+ - 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.