Flam3 - The Flame Algorithm

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 (keep track of generation). Add find_parents operator to flam3-genome. Release as 3.1.1. 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.