Lua Opens the world of Fractal Scripting


Fractal Architect 5 includes Lua scripting support for the creation and tweaking a fractals. FA has an embedded Lua v 5.2.3 interpreter.

FA Lua scripting is compatible with Lua scripts written for the Oxidizer app. (Oxidizer pioneered the usage of Lua scripting for fractal creation.)

We are planning to create a public GitHub repository for Fractal Architect Lua scripts in the near future. This will be a great way to make potentially thousands of scripts available to the FA community. If you create some great scripts, this repository lets you share those scipts with the world.

Lua Scripted Random Fractals

Create brand new fractals using Lua scripts. Enjoy some fine scripts included in the app or write your own.

New Lua Scripting Related Features


There have been so many Lua Scripting new features added to FA 5. This version of FA now has so much scripting power.
Other app's scripted fractals get boring and repetitous. Not true with FA !

Many New Lua Scripts

FA 5 now includes:

  • 40 Main random fractal scripts
  • 96 Variant tweak scripts.

Term Definitions

  • Lua is powerful embedded scripting language used by many applications
  • Main random fractal scripts creates new random fractals.
  • Variant tweak scripts modify an input fractal and creates new variant fractals from it.
  • Varpars is a property bundle instance made up a variation type name, its weight range, and all of its variation parameter value ranges.

Lua Script Lists

In FA, you can create a Lua Script List which is a list of Lua scripts + all their input parameters.

  • You can save the Lua script list as a new named Lua script.

Saving Make New Fractal's Setup as a Script

Since FA 2, Fractal Architect included a Make New Random Fractal window on the Home Page. Sometimes you might find a combination of settings that make a lot of great looking fractals.

Now those settings can be saved a a new Main random fractal Lua script.

In fact, this release of FA includes a lot of new Main random fractal scripts created using this same feature !

The Fractal Architect Experience !!

  • Lua Scripting
  • Variant fractals
  • Keyframe Delta Super Variants

With Fractal Architect you have unparalleled productivity creating exciting new fractals

Lua Scripts Now Support Input Parameters

  • Lua Scripts can be either a fixed value or a Lua expression that is "late evaluated".

  • Late evaluation is important with Lua expressions that generate random value ranges, so each created fractal does not have the same input parameter value.

  • The GUI has a popover that lets you specify the script's parameter values.

General Pre/Post/Normal Varpar Scripts

These scripts randomly embed new variation instances into the fractal's transforms.

They can be embedded into the normal, pre or post variation groups.

These scripts have special input parameters called varpars, that specify which variation type to insert, its random weight range, and random parameter value ranges.

You can specify one or more variation instances using any variation type.

These scripts are powerful, simple, and flexible.

  • The GUI has a popover that lets you specify the script's varpar settings.

Save any Fractal as a Lua Script

Any fractal can now be saved as a new Main Lua script.

Why would you want to do that?

See the next new feature.

Lua Scripts Can Call other Lua Scripts

The Splicing and Sub-flames scripts all need "another" fractal to do their magic.

So those scripts can call another Main random fractal creation script to create the "other" fractal.

The "other" script defaults to "simil3.lua", but can be any script. The script input parameter tells these scripts which "other" script to use.

So if you saved a fractal as a new Lua script, you can invoke it here.

The GUI popover for setting up script input parameters has 2 buttons to make specifying the "other" script easy.

Stacks Image 1753

Lua Tweak Scripts

So Easy - So Fun - So Trivial to Use

Lua Tweak Scripts are SO USEFUL. It is amazing how great the fractals are when created by tweaking a fractal with a Tweak script.

Lua Tweak Scripts are supported by both the Lua Scripted and Legacy Random Generators. Both Standard and Super Variants Editors support them too.

Lua's Module Architecture

Lua Modules are libraries of reusable Lua functions. FA includes a couple that are easy to use from tweak scripts.

Lua Scripts Github Repository

This repository holds both Factory and My Scripts Lua scripts compatible with FA and are licensed with GNU Public License version 3.

This repository is intended to be a community supported repository. So as you create new scripts or port scripts from either Apophysis or JWildfire, they can be added to this repository if you like. That way the entire community can enjoy your scripts, (as pioneered by the DeviantArt community for Apophysis).

Factory scripts are shipped with the app and subject to change with future app updates. (The app does not allow you to edit them.) You can copy them to the My Scripts folder and edit them there with your own changes.

The My Scripts folder in the repository contains a handful of ported Apophysis scripts. They are useful examples on how to port Apophysis scripts to Lua.

Porting Scripts Written for Other Apps to Lua


There are some great scripts out there written for other fractal apps. Rewriting them as Lua scripts is straight forward.

Apophysis Scripts

Even though Apophysis 7X no longer has scripting support, there are so many nice scripts available for older Apophysis versions.

Porting scripts from Apophysis Pascal to Lua is easy and you will get the same output on FA as you would from Apophysis.

JWildfire Scripts

JWildfire scripts are written in Java and can be ported to Lua. FA includes several scripts from JWildfire as examples on how to port them to Lua.

Oxidizer Scripts

Oxidizer scripts are already written in Lua. Ralf Flicker's outstanding simil3 and simil4 scripts have been tweaked for FA and are included in the app.

Stacks Image 1755

Lua Script Editor

FA has a builtin editor allowing you to edit Lua scripts. OR You can use your own favorite editor to edit them.

Factory versus Your Own Scripts

The app segregates the builtin "factory" scripts from your own script folder. That way we won't accidentally overwrite your custom scripts from app updates. All factory scripts are treated as read only, but you can copy them into your script folder and tweak them as much as you like there.

© 2011-2020 Centcom Inc. Contact Me