MediaWiki - User contributions [en]

Manual Installation

2016-02-27T17:06:28Z

Martin Flink: /* Unzip the Zip file. (OPTIONAL) */

=Installing Java and JWildfire=
'''The Definitive Guide to Fractal Awesomeness with JWildFire!'''
The few simple steps needed to get started on your JWildfire journey...
<br clear=all>

[[File:JWildfire Editor with Brainiac Fractal.jpg]]

==Checking Your Java version, Downloading and Installing Java==
'''Getting Started with JWildfire Fractal ART and Animation Software.'''

=== Checking what version of Java you have installed. ===

In this section we'll be taking you through the Installation of the Java Operating Environment Software (if you don't have it, or
need to update your current version).

Then we'll help you download and install the Freeware Fractal Art and Animation software
called '''JWildfire''' (JWF), created by '''Andreas Maschke'''.

By the time you finish reading through this part of the Manual...

We'll take you by the
hand and...

Very soon You'll be able to create Stunning Images in a few minutes just by clicking a couple of
buttons!

The best part is... You own the images you create and the copyright is yours...
You could even sell your fractal images and make some money.

Don't think that's possible huh?

Fair enough, just read on and let us help you prove it to
yourself...

J-WildFire runs on '''Windows, Mac and Linux''' computers and require '''Java version 6''',
''minimum'', (preferably '''version 8 - currently''') to be installed on your system.
In this part of the manual we will be illustrating how to set up a Windows system. If you
are on a Mac or Linux machine, further info can easily be obtained via Google for your
platform, if you have any questions.
'''To get started just go here:''' [http://java.com/en/download/installed.jsp?detect=jre&try=1 Check Your Java Version.]

Upon arrival, the website will check if you have the latest version of Java installed and if not, get you the free download.

If you know you don't yet have Java installed you can go here instead: [http://java.com/en/download/index.jsp Download Free Java Software.]

If you have any problems with the automated check etc. or are on Solaris or Linux you can go here: [http://java.com/en/download/manual.jsp Java Downloads for All Operating Systems.]

For Mac users: Apple supplies their own version of Java. Use the [http://support.apple.com/kb/HT1338?viewlocale=en_US Software Update] feature (available on the Apple menu) to check that you have the most up-to-date version of Java for your Mac.

<div class="figure">[[File:Verifying Java Version.jpg|frame|left|Verifying Your Java Version]]
</div>

<br clear=all>

=== Download Java ===

If you haven't got the latest version installed you'll get a message like this.

Click on '''"Download Java Now".'''

[[File:Verifying Java Result Newer Version Available.jpg|frame|left|The Screen You'll see if there's a Newer Version available]]

<br clear=all>
=== That brings you to the Download Page... ===

Click on: '''"Agree and Start your Free Download"'''.

[[File:Download New Java Version Start Download.jpg|frame|left|Start Download of Java]]

<br clear=all>
=== Click on Save File... ===

Save the file somewhere suitable on your system... this could be on your desktop or wherever you like.

[[File:Download Java Click on Save Button.jpg|frame|left|Click on "Save File"]]

<br clear=all>
=== Running the Installer. ===

Once you have finished downloading, just '''Double click on the downloaded file''' in the Download Manager window, or where you normally save download files.

You may have to '''''Confirm''''' that you want to '''"Run"''' the installer in order to start the installation. '''Then follow the instructions to Install.'''

'''NOTE:''' You may need to restart (close and re-open) your browser to enable the Java installation in your browser. (Once installed, Java runs both "Stand Alone" and in your Browser when needed).

[[File:Running the Java Installer.jpg|frame|left|Click on "Run" to start the installation]]

<br clear=all>

=== The Setup Progress will display... Followed by a Success Message when finished. ===

This process will not take more than a couple of minutes.

[[File:Java Installer Progress.jpg|frame|left|Java Installation Progress]]

<br clear=all>
=== Verify that everything is working fine... ===

This step isn't strictly necessary but I'm including the link for this in any case... just in case you have any problems.

Also, since the process only takes a couple of seconds, you might as well do it just to make sure!

[http://java.com/en/download/testjava.jsp Java Verification Test]

If you have any problems there are also some helpful links on that page.

[[File:Post Java Install Verification Test.jpg|frame|left|Success!]]

<br clear=all>

===Optional but IMPORTANT!===
IF you are running a 64 bit version of Windows (e.g. Windows 10) you must also download and install the 64 bit version of Java on your PC!
JWildfire will need this to run in 64 bit mode (huge speed difference etc.).

You still need the 32 bit version in order to stay compatible with 32 bit applications (e.g. certain browsers etc.), so you do need both versions of Java.

The Link to download this or Java for other Operating systems and hardware such as a Mac is here:

[http://java.com/en/download/manual.jsp Java Downloads for All Operating Systems]

<br clear=all>

[[File:64 bit Java installation.png|frame|left|Installing 64 bit Version of Java, as well as the 32 bit version!]]

<br clear=all>
'''That's It! Time to Install JWildfire'''

==Downloading and Installing JWildfire==
=== How to Download and Install JWildFire ===

Now it's time to Download and Install JWildFire... This is very simple...

Future updates are also easy to install by following the same download instructions!

Go to '''Andreas Maschke's Blog:''' [http://www.andreas-maschke.com/?page_id=351 JWildfire Downloads]

Select the topmost '''(IzPack installer) or (*.zip-archive)''' file link '''(the latest version)''' below the: '''"Available ZIP files for Java 6 (includes launcher)"''' heading... The (IzPack installer) is the self running option, which is the simplest method to use but we are also covering the '''Manual Unzip Option''' in detail further down, in case you prefer that.

Using the '''"Installer"''' a *.jar (Java application) file version of the zip files, is very very simple and covered below!

Feel Free to Use either method.

To download, just click on the correct link and '''Save the file''' to a suitable location on your Hard Disk.

[[File:The Official JWildfire Blog - Download Page.jpg|frame|left|The Official JWildfire Blog and the Download page]]

<br clear=all>

== Using the Installer (NOT CURRENTLY AVAILABLE! Please follow Instructions further down, for the Zip version). ==

The easiest way to install JWildfire these days, is to use the Java based izPack installer.
A hidden benefit using this is that since it uses Java, it will be a good test to check that Java is properly installed too.

Simply download the "IzPack installer" version. To start the installer just double click on the "jwildfire-installer-N.nn.jar" file.

'''The illustration below, covers all the following steps!'''

The first thing you'll see is a Language selector... This only affects the installation procedure! Select OK to continue.

Next you'll see a Welcome screen... Just Select "Next" to continue.

An Information box comes next... Again select "Next" to continue.

Now you need to select your Target Path... For simplicity, use the suggested one (that way upgrades will also be installed without fuss, to the same default folder) but if you want to, you can browse to a different location instead. Click on "Next".

If you don't have the directory already created, the installer will create it for you. On the other hand if you are upgrading an existing installation of JWildfire into the same directory, the installer will ask you to confirm that you want to overwrite existing files. If so select Yes.

Next you get to pick whether you want to install the optional JWildfire applet. This is a bit like a stand-alone and simplified version of the Interactive Render Module. It only has two Options "Create next" (to start rendering a new random flame) and "To Clipboard" which copies the parameters used in the current Flame to the text clipboard so that you can either open JWildfire and use the "From clipboard" option to import it... Or just paste it into a text document using Notepad or similar and save it with a ".flame" file extension instead of ".txt". That means that you can load it later into JWildfire.

When you click "Next" this time, the installation starts.

All that remains once the installation is finished is to create Shortcuts. Select what you need here and make sure to remember to create a desktop shortcut if you want one. (In the following section there's also a manual shortcut creation description, if you need it.)

Once that's all done... '''You're ready to Rock and Roll!'''

The process is illustrated below.

'''''You can skip the following sections, which covers manually unzipping and "installing" JWildfire.'''''

[[File:Using the installer.png|frame|left|Using the Izpack based Installer]]

<br clear=all>

== '''Unzip the Zip file. (CURRENTLY -Feb 2016- This is the standard way of "installing" JWildfire!)''' ==

When you unzip the archive you can just direct the files and folders to be created in a suitable folder on your system (or you can Unzip to a temporary directory and copy/move the files from there afterwards).

Below we're showing you how you can '''Navigate to'' for example: ''"C:\Program Files"''' and by adding a suitable folder name like '''"J-Wildfire"''' (note the "\" before the name of the folder I want to create and install the files in), to the end of the '''"Destination path",''' we're asking the Unzip program to create the folder called '''"J-Wildfire"''' for us and copy all files and folders into it.

You can call the JWildfire folder whatever you like and put it anywhere on your system.

'''Another option''' is to first Unzip the JWildfire software files to a separate "JWildfire downloads" folder, where you could keep the last few software updates (in separate folders) and other resources not directly needed to run the software. Once unzipped all you have to do is copy all files and folders from inside the newly created folder for the version you just unzipped. Then paste these files into a suitable program folder which you can create yourself... then follow along below. (This is also a very good way to '''apply upgrades''' to the software. - Note that you would have to answer "Yes" when the move/copy or unzip function asks you to confirm overwriting of old files with the same names in your JWildfire program folder).

[[File:Unzip the Zip file.jpg|frame|left|Unzip the Zip file]]

<br clear=all>
=== The J-Wildfire folder is created and files copied into it. ===

Once the files have been unzipped (a few seconds later) we're nearly done!

Since the software is not installed in a traditional way (no long winded installation routine)... there is no '''Start up Icon''' created on your Desktop! So we'll create a shortcut to the '''"JWildfire.exe"''' file and put that on the desktop. (The file is of the type "Application").

'''''N.B. If your system is set up to "Hide file extensions" the file will only show up as "JWildfire" since the file extension ".exe" will be hidden!'''''

''This process may be a bit different if you are using a non-Windows system! Please refer to google or your system manuals if you don't know how to get this done.''

Open your "File Manager", "My Computer" or "Explorer" and Navigate to the Folder you just created.

To create an Application Shortcut to JWildfire, begin by '''Right Click and Dragging''' the '''"JWildfire.exe" file (don't let go of the Right Mouse Button!)... Then Drag the icon of the file out of the File Manager onto the Desktop...'''

[[Image:Creating a Desktop Shortcut step 1.jpg|frame|left|Creating a Shortcut to JWildfire - Step 1]]

<br clear=all>
=== Creating the Shortcut. ===

When you have dragged the '''"JWildfire.exe"''' icon to a suitable location...
Let go of the Right Mouse Button!

Select the '''"Create Shortcuts Here"''' option.

The new Shortcut is ready!

[[Image:Creating a Desktop Shortcut step 2.jpg|frame|left|Creating a Shortcut to JWildfire - Step 2]]

<br clear=all>
=== Using The Shortcut. ===
Now you have created a shortcut to the '''"JWildfire.exe"''' file. This will be the icon we use
to start the software.

The '''"JWildfire.exe"''' icon is linked to the executable JWildfire Launcher and will start up
the software when double clicked.

So instead of having to go to the folder and double clicking on this program file every
time we want to start the software, we have just created a "Shortcut" on the desktop that
provides a direct link to the file instead.

[[Image:Creating a Desktop Shortcut step 3 - Done.jpg|frame|left|Shortcut Done!]]

<br clear=all>

'''Ta da!'''

'''We're ready to go have some serious FUN!'''

There you go... we're done messing about now...

It's time to go and find out how you can become a '''Serious Artist''' with just a couple of
clicks!

'''Double Click on the Icon''' you just created to start up JWildfire...

[[Image:Double Click your new JWildFire Icon on the Desktop.jpg|frame|left|Double Click to Start JWildfire!]]

Manual Installation

2016-02-27T17:04:11Z

Martin Flink: /* Using the Installer (INSTEAD of the Zip version). */

=Installing Java and JWildfire=
'''The Definitive Guide to Fractal Awesomeness with JWildFire!'''
The few simple steps needed to get started on your JWildfire journey...
<br clear=all>

[[File:JWildfire Editor with Brainiac Fractal.jpg]]

==Checking Your Java version, Downloading and Installing Java==
'''Getting Started with JWildfire Fractal ART and Animation Software.'''

=== Checking what version of Java you have installed. ===

In this section we'll be taking you through the Installation of the Java Operating Environment Software (if you don't have it, or
need to update your current version).

Then we'll help you download and install the Freeware Fractal Art and Animation software
called '''JWildfire''' (JWF), created by '''Andreas Maschke'''.

By the time you finish reading through this part of the Manual...

We'll take you by the
hand and...

Very soon You'll be able to create Stunning Images in a few minutes just by clicking a couple of
buttons!

The best part is... You own the images you create and the copyright is yours...
You could even sell your fractal images and make some money.

Don't think that's possible huh?

Fair enough, just read on and let us help you prove it to
yourself...

J-WildFire runs on '''Windows, Mac and Linux''' computers and require '''Java version 6''',
''minimum'', (preferably '''version 8 - currently''') to be installed on your system.
In this part of the manual we will be illustrating how to set up a Windows system. If you
are on a Mac or Linux machine, further info can easily be obtained via Google for your
platform, if you have any questions.
'''To get started just go here:''' [http://java.com/en/download/installed.jsp?detect=jre&try=1 Check Your Java Version.]

Upon arrival, the website will check if you have the latest version of Java installed and if not, get you the free download.

If you know you don't yet have Java installed you can go here instead: [http://java.com/en/download/index.jsp Download Free Java Software.]

If you have any problems with the automated check etc. or are on Solaris or Linux you can go here: [http://java.com/en/download/manual.jsp Java Downloads for All Operating Systems.]

For Mac users: Apple supplies their own version of Java. Use the [http://support.apple.com/kb/HT1338?viewlocale=en_US Software Update] feature (available on the Apple menu) to check that you have the most up-to-date version of Java for your Mac.

<div class="figure">[[File:Verifying Java Version.jpg|frame|left|Verifying Your Java Version]]
</div>

<br clear=all>

=== Download Java ===

If you haven't got the latest version installed you'll get a message like this.

Click on '''"Download Java Now".'''

[[File:Verifying Java Result Newer Version Available.jpg|frame|left|The Screen You'll see if there's a Newer Version available]]

<br clear=all>
=== That brings you to the Download Page... ===

Click on: '''"Agree and Start your Free Download"'''.

[[File:Download New Java Version Start Download.jpg|frame|left|Start Download of Java]]

<br clear=all>
=== Click on Save File... ===

Save the file somewhere suitable on your system... this could be on your desktop or wherever you like.

[[File:Download Java Click on Save Button.jpg|frame|left|Click on "Save File"]]

<br clear=all>
=== Running the Installer. ===

Once you have finished downloading, just '''Double click on the downloaded file''' in the Download Manager window, or where you normally save download files.

You may have to '''''Confirm''''' that you want to '''"Run"''' the installer in order to start the installation. '''Then follow the instructions to Install.'''

'''NOTE:''' You may need to restart (close and re-open) your browser to enable the Java installation in your browser. (Once installed, Java runs both "Stand Alone" and in your Browser when needed).

[[File:Running the Java Installer.jpg|frame|left|Click on "Run" to start the installation]]

<br clear=all>

=== The Setup Progress will display... Followed by a Success Message when finished. ===

This process will not take more than a couple of minutes.

[[File:Java Installer Progress.jpg|frame|left|Java Installation Progress]]

<br clear=all>
=== Verify that everything is working fine... ===

This step isn't strictly necessary but I'm including the link for this in any case... just in case you have any problems.

Also, since the process only takes a couple of seconds, you might as well do it just to make sure!

[http://java.com/en/download/testjava.jsp Java Verification Test]

If you have any problems there are also some helpful links on that page.

[[File:Post Java Install Verification Test.jpg|frame|left|Success!]]

<br clear=all>

===Optional but IMPORTANT!===
IF you are running a 64 bit version of Windows (e.g. Windows 10) you must also download and install the 64 bit version of Java on your PC!
JWildfire will need this to run in 64 bit mode (huge speed difference etc.).

You still need the 32 bit version in order to stay compatible with 32 bit applications (e.g. certain browsers etc.), so you do need both versions of Java.

The Link to download this or Java for other Operating systems and hardware such as a Mac is here:

[http://java.com/en/download/manual.jsp Java Downloads for All Operating Systems]

<br clear=all>

[[File:64 bit Java installation.png|frame|left|Installing 64 bit Version of Java, as well as the 32 bit version!]]

<br clear=all>
'''That's It! Time to Install JWildfire'''

==Downloading and Installing JWildfire==
=== How to Download and Install JWildFire ===

Now it's time to Download and Install JWildFire... This is very simple...

Future updates are also easy to install by following the same download instructions!

Go to '''Andreas Maschke's Blog:''' [http://www.andreas-maschke.com/?page_id=351 JWildfire Downloads]

Select the topmost '''(IzPack installer) or (*.zip-archive)''' file link '''(the latest version)''' below the: '''"Available ZIP files for Java 6 (includes launcher)"''' heading... The (IzPack installer) is the self running option, which is the simplest method to use but we are also covering the '''Manual Unzip Option''' in detail further down, in case you prefer that.

Using the '''"Installer"''' a *.jar (Java application) file version of the zip files, is very very simple and covered below!

Feel Free to Use either method.

To download, just click on the correct link and '''Save the file''' to a suitable location on your Hard Disk.

[[File:The Official JWildfire Blog - Download Page.jpg|frame|left|The Official JWildfire Blog and the Download page]]

<br clear=all>

== Using the Installer (NOT CURRENTLY AVAILABLE! Please follow Instructions further down, for the Zip version). ==

The easiest way to install JWildfire these days, is to use the Java based izPack installer.
A hidden benefit using this is that since it uses Java, it will be a good test to check that Java is properly installed too.

Simply download the "IzPack installer" version. To start the installer just double click on the "jwildfire-installer-N.nn.jar" file.

'''The illustration below, covers all the following steps!'''

The first thing you'll see is a Language selector... This only affects the installation procedure! Select OK to continue.

Next you'll see a Welcome screen... Just Select "Next" to continue.

An Information box comes next... Again select "Next" to continue.

Now you need to select your Target Path... For simplicity, use the suggested one (that way upgrades will also be installed without fuss, to the same default folder) but if you want to, you can browse to a different location instead. Click on "Next".

If you don't have the directory already created, the installer will create it for you. On the other hand if you are upgrading an existing installation of JWildfire into the same directory, the installer will ask you to confirm that you want to overwrite existing files. If so select Yes.

Next you get to pick whether you want to install the optional JWildfire applet. This is a bit like a stand-alone and simplified version of the Interactive Render Module. It only has two Options "Create next" (to start rendering a new random flame) and "To Clipboard" which copies the parameters used in the current Flame to the text clipboard so that you can either open JWildfire and use the "From clipboard" option to import it... Or just paste it into a text document using Notepad or similar and save it with a ".flame" file extension instead of ".txt". That means that you can load it later into JWildfire.

When you click "Next" this time, the installation starts.

All that remains once the installation is finished is to create Shortcuts. Select what you need here and make sure to remember to create a desktop shortcut if you want one. (In the following section there's also a manual shortcut creation description, if you need it.)

Once that's all done... '''You're ready to Rock and Roll!'''

The process is illustrated below.

'''''You can skip the following sections, which covers manually unzipping and "installing" JWildfire.'''''

[[File:Using the installer.png|frame|left|Using the Izpack based Installer]]

<br clear=all>

== '''Unzip the Zip file. (OPTIONAL)''' ==

When you unzip the archive you can just direct the files and folders to be created in a suitable folder on your system (or you can Unzip to a temporary directory and copy/move the files from there afterwards).

Below we're showing you how you can '''Navigate to'' for example: ''"C:\Program Files"''' and by adding a suitable folder name like '''"J-Wildfire"''' (note the "\" before the name of the folder I want to create and install the files in), to the end of the '''"Destination path",''' we're asking the Unzip program to create the folder called '''"J-Wildfire"''' for us and copy all files and folders into it.

You can call the JWildfire folder whatever you like and put it anywhere on your system.

'''Another option''' is to first Unzip the JWildfire software files to a separate "JWildfire downloads" folder, where you could keep the last few software updates (in separate folders) and other resources not directly needed to run the software. Once unzipped all you have to do is copy all files and folders from inside the newly created folder for the version you just unzipped. Then paste these files into a suitable program folder which you can create yourself... then follow along below. (This is also a very good way to '''apply upgrades''' to the software. - Note that you would have to answer "Yes" when the move/copy or unzip function asks you to confirm overwriting of old files with the same names in your JWildfire program folder).

[[File:Unzip the Zip file.jpg|frame|left|Unzip the Zip file]]

<br clear=all>
=== The J-Wildfire folder is created and files copied into it. ===

Once the files have been unzipped (a few seconds later) we're nearly done!

Since the software is not installed in a traditional way (no long winded installation routine)... there is no '''Start up Icon''' created on your Desktop! So we'll create a shortcut to the '''"JWildfire.exe"''' file and put that on the desktop. (The file is of the type "Application").

'''''N.B. If your system is set up to "Hide file extensions" the file will only show up as "JWildfire" since the file extension ".exe" will be hidden!'''''

''This process may be a bit different if you are using a non-Windows system! Please refer to google or your system manuals if you don't know how to get this done.''

Open your "File Manager", "My Computer" or "Explorer" and Navigate to the Folder you just created.

To create an Application Shortcut to JWildfire, begin by '''Right Click and Dragging''' the '''"JWildfire.exe" file (don't let go of the Right Mouse Button!)... Then Drag the icon of the file out of the File Manager onto the Desktop...'''

[[Image:Creating a Desktop Shortcut step 1.jpg|frame|left|Creating a Shortcut to JWildfire - Step 1]]

<br clear=all>
=== Creating the Shortcut. ===

When you have dragged the '''"JWildfire.exe"''' icon to a suitable location...
Let go of the Right Mouse Button!

Select the '''"Create Shortcuts Here"''' option.

The new Shortcut is ready!

[[Image:Creating a Desktop Shortcut step 2.jpg|frame|left|Creating a Shortcut to JWildfire - Step 2]]

<br clear=all>
=== Using The Shortcut. ===
Now you have created a shortcut to the '''"JWildfire.exe"''' file. This will be the icon we use
to start the software.

The '''"JWildfire.exe"''' icon is linked to the executable JWildfire Launcher and will start up
the software when double clicked.

So instead of having to go to the folder and double clicking on this program file every
time we want to start the software, we have just created a "Shortcut" on the desktop that
provides a direct link to the file instead.

[[Image:Creating a Desktop Shortcut step 3 - Done.jpg|frame|left|Shortcut Done!]]

<br clear=all>

'''Ta da!'''

'''We're ready to go have some serious FUN!'''

There you go... we're done messing about now...

It's time to go and find out how you can become a '''Serious Artist''' with just a couple of
clicks!

'''Double Click on the Icon''' you just created to start up JWildfire...

[[Image:Double Click your new JWildFire Icon on the Desktop.jpg|frame|left|Double Click to Start JWildfire!]]

Manual Installation

2016-02-27T17:01:02Z

2015-08-25T14:58:55Z

File:Catherine Tut1 pic2.png

2015-07-17T21:01:29Z

Martin Flink:

File:Catherine Tut1 pic1.png

2015-07-17T21:00:09Z

Martin Flink:

FlameFractalTutorial07

2015-07-17T20:58:03Z

Martin Flink: Created page with "=PHOENIX JULIA / PERSPECTIVE TUTORIAL= This is an easy tutorial that gives you a base flame from which you can learn about these two interesting variations and – even more..."

=PHOENIX JULIA / PERSPECTIVE TUTORIAL=

This is an easy tutorial that gives you a base flame from which you can learn about these two interesting variations and – even more important – what is possible starting with a very simple combination. Of course, they have to be not just any two variations, but the possibilities are many. MANY, like all things fractal.

Open JWildfire and click on "New from Scratch".

Go to the Gradient tab and choose a lighter gradient than the default one. This is only because I know from trying it that the default will produce a dark fractal that is hard to see.

Now go to the Camera tab and change Zoom from 1 to 2.

Next go to the Transformations tab and click on Add. This gives you your first transform. Change it from Linear3D to Phoenix_Julia by clicking on the down arrow to the right of Linear3D on the Nonlinear tab.

PIC1

Click Add again. Change this Linear3D to Perspective. The next image is what you should be seeing at this point.

PIC2

Now it’s playtime. Things to try:

• Change the variables of the Phoenix_Julia and the Perspective variations. You’ll find them in the drop down menu next to the word Params below each variation in the Non-Linear tab. Try giving Phoenix_Julia a power of three, for example. Be sure to try using negative numbers as well as positive numbers.

• Play with gradients. Different gradients and combinations within a gradient will highlight different elements of the flame. Warning: It can be hard to decide!

• Add different final transforms: Click on Add Final in the Transformations tab. Change the final transform from Linear3D the same way you changed the plain transforms to Phoenix_Julia and Perspective. You can also try using more than one final.

• Add in other variations on their own transforms. Or try adding additional variations to existing transforms. Sometimes they will work – sometimes not. With fractal art, when you try something you can get nothing, or mud... or magic!

• Experiment with each transform’s Weight (I set the Perspective transform to .75 rather than the default of .5 for examples below). You can even go into the Xaos tab, although I didn’t do that for this tutorial. Change the Xaos weight from 1 to 0, one transform at time – you’ll see some interesting things happen. Because this is such a simple flame, it’s easy to see what Xaos changes can do.

PIC3

Here are some examples.

PIC4

This has a Mobius final using the default Mobius variables, but try making changes to them. On this one, changing the Perspective angle and distance (in the drop down menu) is also interesting.

PIC5

This image has two final transforms, Spherical 3D and Perspective. That means there is a regular transform that is Perspective and also a Perspective final transform.

PIC6

Five Layerz of the same flame, which has a Polar final transform. Layerz is a wonderful feature of JWildfire, not covered in this tutorial.

PIC7

This one has a Loonie final transform. Not the way Loonie usually looks, right?

PIC8

Mobius final transform and five identical Layerz, moved around.

Don't forget to TWEAK PROPERLY before posting, if you decide to use a flame created from any tutorials you find online.
Also remember to give credit (preferably with a link so other may benefit)to the tutorial that helped you create something nice...
It's good Fractalizing manners and it keeps everyone happy!

Enjoy Experimenting!

Main Page

2015-07-17T20:41:46Z

Martin Flink:

{| style="padding: 12px 12px 20px; width: 100%; vertical-align: top;"
|- style="vertical-align: top;"
| class="single_linebreak"|

==Welcome to the JWildfire Wiki!==
{| style="padding: 12px 12px 20px; width: 100%; vertical-align: top;"
|+ Contents
|- style="vertical-align: top;"
| class="single_linebreak"|
{{ContentBox|User-Manual|
[[Manual Introduction|1. About JWildfire]]<br>
[[Manual Installation|2. Download and Installation]]<br>
[[Manual Launcher|3. Launching JWildfire and setting the memory to use]]<br>
[[Manual Preferences|4. JWildfire Preferences and Performance Tweaks]]<br>
[[Manual Operators|5. Image-processing using the Operators-Window]]<br>
[[Manual Flame Fractals|6. Creating Flame-Fractals]]<br>
[[Manual IFlames|7. Creating IFlames using the IFlames-Window]]<br>
[[Manual StructureGen|8. Creating 3D-Scenes using the Structure-Generator]]<br>
[[Manual ChaoticaIntegration|9. Chaotica integration]] {{new}}<br>
[[Manual LeapMotionIntegration|10. Leap Motion integration]] {{new}}<br>
}}
| class="single_linebreak"|
{{ContentBox|Tutorials|

{{ContentBox|For beginners|
[[FlameFractalTutorial01|1. Basic flame-editing]]<br>
[[FlameFractalTutorial02|2. Basic color-editing]]<br>
[[FlameFractalTutorial03|3. Basic formula-editing]]<br>
[[FlameFractalTutorial04|4. More on formula-editing]]<br>
[[FlameFractalTutorial05|5. Using Random-Flame-Generators]]<br>
[[FlameFractalTutorial06|6. Creating Gradients]]<br>
[[FlameFractalTutorial07|7. Phoenix Julia/Perspective Variations Tutorial]]<br>
}}

{{ContentBox|Advanced|
[[Creating Anim-Brushes from Flame-Fractals|1. Creating Anim-Brushes from Flame-Fractals]]<br>
[[List of formulas|2. List of included formulas ("variations")]]<br>
}}

}}
|- style="vertical-align: top;"
| class="single_linebreak"|
{{ContentBox|Contribute|
[[Wiki Team|The Wiki-Team]]<br>
[[Wiki Guide]]<br>
[[Formatting Guide]]<br>
[[Suggested features]]}}
| class="single_linebreak"|
{{ContentBox|Additional documentation|
[[FAQ]]<br>
[[Glossary]]<br>
[[Credits]]<br>
[[Trashcan]]<br>
}}
|}

[[File:UnderConstruction.jpg]]

[[Main_Page DE|German Version]]

[[Category:Main Menu]]

FlameFractalTutorial04

2015-03-26T14:29:52Z

Martin Flink: /* Changing formula params */

=Objective of this tutorial=
In this tutorial we want to show how to combine different formulas/variations and how to change parameters of formulas.
Please note, that there is '''no difference''' between '''formulas''' and '''variations''', but I prefer the term "formula" because it is more precise.

=Create a new empty fractal with a blurring formula=
To get started, create a new empty fractal by hitting the '''New from scratch'''-button. Have a look at the '''Gradient'''-tab, when you do not like the randomly created gradient, just hit the '''New from scratch''' again. And again if you are not satisfied yet...

Add a new transform by pressing the '''Add'''-button on the '''Transformations'''-tab.
Change the '''variation 1''' from "linear3D" to "circleblur", you should see a filled circle in the viewport.<br>
[[File:Flametut04_new_from_scratch.jpg]]

But, when you drag the controls around, you will see, that the shape does not change. But, why?
To understand this, we must look at formulas more close. There are different types.

==Types of formulas/variations==
There are two major categories of formulas:
#'''transforming formulas''': formulas which change an existing part of the fractal, where the detail of the original is not changed.
For example, a wave-transformation applied to an existing fractal will just make it "wavy", but not increase or decrease the detail very much.
I.e., a transforming formula contributes to the overall transform.

#'''blurring formulas''': formulas who completely ignore the existing fractal and create new shape.
For example, "circleblur" will always create a filled circle, and not transform the existing structure, it will replace it.
I.e., used in this simple scenario, a blurring formula overwrites the transforms, so that it is not a conventional transform anymore.

That also means that it isn't possible to create fractals by using only blurring formulas, because you need transforms to create the typical fractal (i. e. self-similar) structure.
You need some transform, which transforms some transformed stuff, which was transformed by ..., and so on.
But blurring formulas, when used at the right place, are really great for constructing flames from scratch.

=Add a second transform with a transforming formula=
Now add a second transform and change the '''variation 2''' from "linear3D" to "julian", you should not see much difference in the viewport yet.<br>
==Formulas with parameter==
The formula you chose is a formula with additional parameters. For such formulas you use the listbox below the listbox which show the name the of the formula to select a a parameter, and the edit-field
right of it to change the value of this parameter.<br>
Please note, that not all parameters are just numbers, some formulas even have complex structures like images as parameters, in this case you may find more controls right of this field.<br>
[[File:Flametut04_formula_params.jpg]]

Please change the value of the parameter '''power''' of the "julian"-formula to 2.
Then use your mouse to modify the seconds transform (the one with "julian"-formula on it). Enlarge the control, rotate it and move it in the viewport until you get something like this:<br>
[[File:Flametut04_add_2nd_transform.jpg]]

==Add color==
The fractal is still monochrome, to change this enter the '''Color'''-tab on the '''Transformations'''-tab, and modify the '''Color'''-slider<br>
[[File:Flametut04_add_color.jpg]]

==Changing formula params==
Now let's play again with the parameters of the "julian"-variation to show how small parameter-changes can cause huge differences in the final result.
Change "power" to 3, and "dist" to 1.76.

You have three choices for how to do this:
#Enter the value directly (which is only a choice if you know the value, i. e. not for playing around)
#Enter the field with the mouse, click and hold the left mouse-button and move the mouse to decrease/increase the value (best for playing around)
#Use the small arrow-buttons to slightly decrease/increase the value (best for fine-adjustments)

Your flame should look like this (if not you may compare your result with the flame-params which are supplied in the appendix):
[[File:Flametut04_change_params.jpg]]

===Fine adjustment of parameters===
Sometimes the parameter-changes done by using the mouse or the arrow-buttons are too large for, even if done carefully.
For this purpose you can activate the '''Fine'''-button at the top of the editor-area. All changes, you do now, are scaled down by a factor of approximately 10.<br>
[[File:Flametut04_fine_adjustments.jpg]]

=Conclusion=
We have learned how to use different formulas in one fractal, how to change formulas and that there two types of formula (transforming and blurring formula).
And we saw how to change parameters of formulas and that also small changes to parameters of formulas may have a large impact on the final image.

[[FlameFractalTutorial03|Previous tutorial]] | [[FlameFractalTutorial05|Next tutorial]]

=Appendix=
==Params of the final sample flame==
<source lang="xml">
<flame smooth_gradient="0" version="JWildfire 2.34 (22.02.2015)" size="643 362" center="0.0 0.0" scale="35.17734553722945" rotate="0.0" filter="0.0" filter_kernel="GAUSSIAN" quality="10.0" background="0.0 0.0 0.0" bg_transparency="0" brightness="4.0" saturation="1.0" gamma="4.0" gamma_threshold="0.01" vibrancy="1.0" contrast="1.0" white_level="220.0" temporal_samples="1.0" cam_zoom="1.0" cam_pitch="0.0" cam_yaw="0.0" cam_persp="0.0" cam_xfocus="0.0" cam_yfocus="0.0" cam_zfocus="0.0" cam_pos_x="0.0" cam_pos_y="0.0" cam_pos_z="0.0" cam_zpos="0.0" cam_dof="0.0" cam_dof_area="0.5" cam_dof_exponent="2.0" cam_dof_shape="BUBBLE" cam_dof_scale="1.0" cam_dof_rotate="0.0" cam_dof_fade="1.0" shading_shading="FLAT" antialias_amount="0.75" antialias_radius="0.36" post_symmetry_type="NONE" post_symmetry_order="3" post_symmetry_centre_x="0.0" post_symmetry_centre_y="0.0" post_symmetry_distance="1.25" post_symmetry_rotation="6.0" frame="1" frame_count="300" mixer_mode="OFF" >
<xform weight="0.5" color="0.0" mod_gamma="0.0" mod_gamma_speed="0.0" mod_contrast="0.0" mod_contrast_speed="0.0" mod_saturation="0.0" mod_saturation_speed="0.0" symmetry="0.0" circleblur="1.0" coefs="1.0 0.0 0.0 1.0 0.0 0.0" chaos="1.0 1.0" />
<xform weight="0.5" color="0.39" mod_gamma="0.0" mod_gamma_speed="0.0" mod_contrast="0.0" mod_contrast_speed="0.0" mod_saturation="0.0" mod_saturation_speed="0.0" symmetry="0.0" julian="1.0" julian_power="3" julian_dist="1.76" coefs="1.8747239284667137 1.1869473754012025 -1.1869473754012025 1.8747239284667137 3.3237513474667604 -0.8341460910630871" chaos="1.0 1.0" />
<palette count="256" format="RGB" >
F7883EF6873CF6863AF58538F48436F38334F38232F28130F1802DF07F2BF07D29EF7C27
EE7B25ED7A23ED7921EC781FEB771DEA761BEA7519E97417E87315E77213E77110E6700E
E56F0CE46E0AE46F0BE37511E27A16E1801CE18521E08B27DF912CDF9632DE9C37DDA13D
DCA742DCAC48DBB24DDAB753D9BD58D9C25ED8C863D7CE69D6D36ED6D974D5DE79D4E47F
D3E984D3EF8AD2F48FD1FA95D0F899D0F39DCFEFA1CEEBA5CDE7A9CCE2ADCCDEB1CBDAB5
CAD6B9C9D1BDC9CDC1C8C9C5C7C5C9C6C0CCC5BCD0C5B8D4C4B3D8C3AFDCC2ABE0C2A7E4
C1A2E8C09EECBF9AF0BE96F4BE91F8BD8DFBBA8AFBB887FBB584FBB381FBB17EFAAE7BFA
AC78FAA975FAA772FAA56FFAA26BFAA068FA9E65F99B62F9995FF9965CF99459F99256F9
8F53F98D50F98A4DF98849F88646F88343F88140F88141F28243E98446E08548D6874BCD
894DC38A50BA8C53B08D55A78F589E905A94925D8B935F8195627896656F986765996A5C
9B6C529C6F499E723F9F7436A1772DA27923A47C1AA57E10A78107A67E07A47B07A37807
A27507A072079F6E079E6B069C68069B65069A6206985F06975C06965906945606935306
925006904D068F49068E46068C43058B40058A3D05883A058737058634058332097E3112
79311B753024702F2D6B2F36662E3F612E485C2D51572C5A532C634E2B6C492B75442A7E
3F2A873A29903628993128A22C27AB2727B42226BD1D25C61925CF1424D80F24E10A23EA
1129EB1A31E92439E82D40E63748E54050E34A57E2535FE05D67DF666EDD7076DC797EDA
8386D98D8DD89695D6A09DD5A9A4D3B3ACD2BCB4D0C6BBCFCFC3CDD9CBCCE2D2CAECDAC9
F5E2C7FCE7C5F4E5BDEDE2B6E6DFAEDFDDA7D8DA9FD1D798CAD590C2D289BBCF81B4CD7A
ADCA72A6C76B9FC46397C25C90BF5489BC4D82BA457BB73E74B4366DB22F65AF275EAC20
57A91850A71149A4094AA30751A30858A2095FA20B66A20C6DA20D74A10E7BA11081A111
88A1128FA11396A0159DA016A4A017ABA018B29F1AB99F1BC09F1CC79F1DCE9E1FD49E20
DB9E21E29E22E99D24F09D25</palette>
</flame>
</source>

FlameFractalTutorial04

2015-03-26T14:27:59Z

Martin Flink: /* Types of formulas/variations */

=Objective of this tutorial=
In this tutorial we want to show how to combine different formulas/variations and how to change parameters of formulas.
Please note, that there is '''no difference''' between '''formulas''' and '''variations''', but I prefer the term "formula" because it is more precise.

=Create a new empty fractal with a blurring formula=
To get started, create a new empty fractal by hitting the '''New from scratch'''-button. Have a look at the '''Gradient'''-tab, when you do not like the randomly created gradient, just hit the '''New from scratch''' again. And again if you are not satisfied yet...

Add a new transform by pressing the '''Add'''-button on the '''Transformations'''-tab.
Change the '''variation 1''' from "linear3D" to "circleblur", you should see a filled circle in the viewport.<br>
[[File:Flametut04_new_from_scratch.jpg]]

But, when you drag the controls around, you will see, that the shape does not change. But, why?
To understand this, we must look at formulas more close. There are different types.

==Types of formulas/variations==
There are two major categories of formulas:
#'''transforming formulas''': formulas which change an existing part of the fractal, where the detail of the original is not changed.
For example, a wave-transformation applied to an existing fractal will just make it "wavy", but not increase or decrease the detail very much.
I.e., a transforming formula contributes to the overall transform.

#'''blurring formulas''': formulas who completely ignore the existing fractal and create new shape.
For example, "circleblur" will always create a filled circle, and not transform the existing structure, it will replace it.
I.e., used in this simple scenario, a blurring formula overwrites the transforms, so that it is not a conventional transform anymore.

That also means that it isn't possible to create fractals by using only blurring formulas, because you need transforms to create the typical fractal (i. e. self-similar) structure.
You need some transform, which transforms some transformed stuff, which was transformed by ..., and so on.
But blurring formulas, when used at the right place, are really great for constructing flames from scratch.

=Add a second transform with a transforming formula=
Now add a second transform and change the '''variation 2''' from "linear3D" to "julian", you should not see much difference in the viewport yet.<br>
==Formulas with parameter==
The formula you chose is a formula with additional parameters. For such formulas you use the listbox below the listbox which show the name the of the formula to select a a parameter, and the edit-field
right of it to change the value of this parameter.<br>
Please note, that not all parameters are just numbers, some formulas even have complex structures like images as parameters, in this case you may find more controls right of this field.<br>
[[File:Flametut04_formula_params.jpg]]

Please change the value of the parameter '''power''' of the "julian"-formula to 2.
Then use your mouse to modify the seconds transform (the one with "julian"-formula on it). Enlarge the control, rotate it and move it in the viewport until you get something like this:<br>
[[File:Flametut04_add_2nd_transform.jpg]]

==Add color==
The fractal is still monochrome, to change this enter the '''Color'''-tab on the '''Transformations'''-tab, and modify the '''Color'''-slider<br>
[[File:Flametut04_add_color.jpg]]

==Changing formula params==
Now let's play again with the parameters of the "julian"-variation to show how small parameter-changes can cause huge differences in the final result.
Change "power" to 3, and "dist" to 1.76.

You have three choices to to this:
#Enter the value directly (which is only a choice if you know the value, i. e. not for playing around)
#Enter the field with the mouse, hold the left mouse-button and move the mouse to decrease/increase the value (best for playing around)
#Use the small arrow-buttons to slightly decrease/increase the value (best for fine-adjustments)

Your flame should look like this (if not you may compare your result with the flame-params which are supplied in the appendix):
[[File:Flametut04_change_params.jpg]]

===Fine adjustment of parameters===
Sometimes the parameter-changes done by using the mouse or the arrow-buttons are too large for, even if done carefully.
For this purpose you can activate the '''Fine'''-button at the top of the editor-area. All changes, you do now, are scaled down by a factor of approximately 10.<br>
[[File:Flametut04_fine_adjustments.jpg]]

=Conclusion=
We have learned how to use different formulas in one fractal, how to change formulas and that there two types of formula (transforming and blurring formula).
And we saw how to change parameters of formulas and that also small changes to parameters of formulas may have a large impact on the final image.

[[FlameFractalTutorial03|Previous tutorial]] | [[FlameFractalTutorial05|Next tutorial]]

=Appendix=
==Params of the final sample flame==
<source lang="xml">
<flame smooth_gradient="0" version="JWildfire 2.34 (22.02.2015)" size="643 362" center="0.0 0.0" scale="35.17734553722945" rotate="0.0" filter="0.0" filter_kernel="GAUSSIAN" quality="10.0" background="0.0 0.0 0.0" bg_transparency="0" brightness="4.0" saturation="1.0" gamma="4.0" gamma_threshold="0.01" vibrancy="1.0" contrast="1.0" white_level="220.0" temporal_samples="1.0" cam_zoom="1.0" cam_pitch="0.0" cam_yaw="0.0" cam_persp="0.0" cam_xfocus="0.0" cam_yfocus="0.0" cam_zfocus="0.0" cam_pos_x="0.0" cam_pos_y="0.0" cam_pos_z="0.0" cam_zpos="0.0" cam_dof="0.0" cam_dof_area="0.5" cam_dof_exponent="2.0" cam_dof_shape="BUBBLE" cam_dof_scale="1.0" cam_dof_rotate="0.0" cam_dof_fade="1.0" shading_shading="FLAT" antialias_amount="0.75" antialias_radius="0.36" post_symmetry_type="NONE" post_symmetry_order="3" post_symmetry_centre_x="0.0" post_symmetry_centre_y="0.0" post_symmetry_distance="1.25" post_symmetry_rotation="6.0" frame="1" frame_count="300" mixer_mode="OFF" >
<xform weight="0.5" color="0.0" mod_gamma="0.0" mod_gamma_speed="0.0" mod_contrast="0.0" mod_contrast_speed="0.0" mod_saturation="0.0" mod_saturation_speed="0.0" symmetry="0.0" circleblur="1.0" coefs="1.0 0.0 0.0 1.0 0.0 0.0" chaos="1.0 1.0" />
<xform weight="0.5" color="0.39" mod_gamma="0.0" mod_gamma_speed="0.0" mod_contrast="0.0" mod_contrast_speed="0.0" mod_saturation="0.0" mod_saturation_speed="0.0" symmetry="0.0" julian="1.0" julian_power="3" julian_dist="1.76" coefs="1.8747239284667137 1.1869473754012025 -1.1869473754012025 1.8747239284667137 3.3237513474667604 -0.8341460910630871" chaos="1.0 1.0" />
<palette count="256" format="RGB" >
F7883EF6873CF6863AF58538F48436F38334F38232F28130F1802DF07F2BF07D29EF7C27
EE7B25ED7A23ED7921EC781FEB771DEA761BEA7519E97417E87315E77213E77110E6700E
E56F0CE46E0AE46F0BE37511E27A16E1801CE18521E08B27DF912CDF9632DE9C37DDA13D
DCA742DCAC48DBB24DDAB753D9BD58D9C25ED8C863D7CE69D6D36ED6D974D5DE79D4E47F
D3E984D3EF8AD2F48FD1FA95D0F899D0F39DCFEFA1CEEBA5CDE7A9CCE2ADCCDEB1CBDAB5
CAD6B9C9D1BDC9CDC1C8C9C5C7C5C9C6C0CCC5BCD0C5B8D4C4B3D8C3AFDCC2ABE0C2A7E4
C1A2E8C09EECBF9AF0BE96F4BE91F8BD8DFBBA8AFBB887FBB584FBB381FBB17EFAAE7BFA
AC78FAA975FAA772FAA56FFAA26BFAA068FA9E65F99B62F9995FF9965CF99459F99256F9
8F53F98D50F98A4DF98849F88646F88343F88140F88141F28243E98446E08548D6874BCD
894DC38A50BA8C53B08D55A78F589E905A94925D8B935F8195627896656F986765996A5C
9B6C529C6F499E723F9F7436A1772DA27923A47C1AA57E10A78107A67E07A47B07A37807
A27507A072079F6E079E6B069C68069B65069A6206985F06975C06965906945606935306
925006904D068F49068E46068C43058B40058A3D05883A058737058634058332097E3112
79311B753024702F2D6B2F36662E3F612E485C2D51572C5A532C634E2B6C492B75442A7E
3F2A873A29903628993128A22C27AB2727B42226BD1D25C61925CF1424D80F24E10A23EA
1129EB1A31E92439E82D40E63748E54050E34A57E2535FE05D67DF666EDD7076DC797EDA
8386D98D8DD89695D6A09DD5A9A4D3B3ACD2BCB4D0C6BBCFCFC3CDD9CBCCE2D2CAECDAC9
F5E2C7FCE7C5F4E5BDEDE2B6E6DFAEDFDDA7D8DA9FD1D798CAD590C2D289BBCF81B4CD7A
ADCA72A6C76B9FC46397C25C90BF5489BC4D82BA457BB73E74B4366DB22F65AF275EAC20
57A91850A71149A4094AA30751A30858A2095FA20B66A20C6DA20D74A10E7BA11081A111
88A1128FA11396A0159DA016A4A017ABA018B29F1AB99F1BC09F1CC79F1DCE9E1FD49E20
DB9E21E29E22E99D24F09D25</palette>
</flame>
</source>

Manual Launcher

2015-03-26T14:09:53Z

Martin Flink: /* More technical information about the launcher */

<br clear=all>
=Launching JWildfire=

== What you'll see when JWildFire starts ==

The first thing you'll notice when you start JWildFire is the initial "Welcome to JWildfire" (version No. and compiled date) window opening up...

This contains the Java Environment startup options, with a couple of optional settings..
JWildfire is just as happy working in 32bit mode as 64bit (optimal if your OS supports it).

When you are happy with your settings click on "Start"!

Shortly after this window disappears, you'll see the main "Welcome to JWildfire" window open with the main JWildFire interface behind it...

<div class="figure">[[File:What you see when JWildFire starts - Launcher Window.jpg]]
</div>

<br clear=all>

== Meet JWildFire! ==

Thanks for your patience... I know it may have seemed like a lot of steps to get here but you shouldn't have spent more than 5 minutes or so.

Now it's time to show you why it was worth it!

<div class="figure">[[File:What you see when JWildFire starts - Startup Splash Screen.jpg]]
</div>

<br clear=all>
== Alternative Ways of Starting JWildFire... ==

In the unlikely event that using the "'''JWildfire.exe'''" file isn't starting up the software properly, there are alternatives...

These alternatives are found in your JWildfire installation folder. The first option is using one of the supplied platform specific start-scripts available in your installation folder:

"'''start_windows.bat'''", "'''start_mac.command'''" or "'''start_linux.sh'''"

Alternatively you can use the "'''j-wildfire-launcher.jar'''" file instead.

If you use any of these alternative startup methods you could just create the shortcut,
as described [[Manual_Installation#The_J-Wildfire_folder_is_created_and_files_copied_into_it.|Here!]], for the alternative file instead of the "'''JWildfire.exe'''" file...

<div class="figure">[[File:alternative-ways-of-starting-jwildfire.jpg]]
</div>
<br clear=all>
== Support and Community Options ==
If you do have any trouble getting started, one of the best ways to get help is by '''joining our Official Facebook Group! '''You will find us by clicking on the "''''FB community" '''button on the welcome screen as seen [[Manual_Launcher#Meet JWildFire!| above]] or you can click here!:
[https://www.facebook.com/groups/JWildfireOpenGroup/ JWildfire Open Group]

'''Please Note!''' Technical Support Issues should first be checked '''(since most solutions already exist)''' over at the '''"Help & Support"''' Section in our Forum! [http://jwildfire.org/forum/viewforum.php?f=5&sid=911e50683f75e01159171e3ef09c3c84 Click here for the Tech Support Area]

If you can't find a solution for your problem in the Forum or by asking (nicely) in the Facebook Group...
Please Create a New Topic with a detailed explanation of your problem and your specific equipment, in the Forum. This makes it easier to keep track on any outstanding issues and it allows for easier searching for previously solved problems and their solutions.

Our growing Google+ Community can be found here: [https://plus.google.com/u/0/communities/118391398023168606746 Google+ JWildfire User's Group]

<div class="figure">[[File:support-and-community-options.jpg]]
</div>
<br clear=all>

== Onwards and Upwards! ==

That concludes this step-by-step JWildFire (and Java) installation Guide.

We hope you enjoyed getting ready... To '''PLAY''' and Have '''FUN!'''

See you in the next Module and on Facebook, G+ or the Forum!

=More technical information about the launcher=
===Try not to start the j-wildfire.jar directly===
Please always use the official launcher to start JWildfire.
The launcher can be executed by any Java runtime and can be started with any options.
The task of the launcher is to launch the main software with controlled options and to reserve enough memory.
#Your First Option is to use '''JWildfire.exe''' to start the launcher. Mainly because the executable file also contains a suitable Icon, which is used when you create a shortcut.
#'''Alternatively:'''
## under Windows use the '''start_windows.bat''' to start the launcher.
## under Mac OS use the '''start_mac.command''' to start the launcher.
## under Linux use the '''start_linux.sh''' to start the launcher.
If this doesn't work or if you have another operating system not listed here, just start/open the '''j-wildfire-launcher.jar''' directly.

<div class="figure">[[File:alternative-ways-of-starting-jwildfire.jpg]]
</div>
<br clear=all>
PLEASE DO NOT START THE '''j-wildfire.jar''' DIRECTLY!
If you start the '''j-wildfire.jar''' directly, then JWildfire is started with '''default Java options'''.
In most cases you cannot render large images with those settings because enough memory is not reserved at startup. So even if you have plenty of memory it can not be used for rendering this way. Additionally, the wrong settings may cause slower rendering.

==How the Launcher works==
The Launcher analyzes certain system settings to locate java runtimes on your system and automatically selects the most recent one.

You can override the automatically selected version by selecting another entry in the listbox.

If the scanner did not find a java runtime (probably on Macs as we have no way to test this) you can manually add it. You only have to do this once, of course.

The memory setting lets you specify the maximum amount of memory in megabytes to use.
This memory amount is only allocated if required but there is no way to allocate more memory than specified here, if JWildfire is already running.

So you must choose this value wisely.

Example: 6000 MB should work fine to render images in high-end quality for print.

==Troubleshooting==
The launcher works in two ways: regular and debug mode. In regular mode it just starts JWildfire and shuts down itself.
If you face any problems (i.e. JWildfire does not start) please activate the "Debug" checkbox. This forces a traced launch where log messages are recorded and displayed at the "Log messages" tab.
You can easily copy those messages into the clipboard by using the "To clipboard" button and then report them for further assistance.

File:What you see when JWildFire starts - Startup Splash Screen.jpg

2015-03-26T14:06:10Z

Martin Flink: Martin Flink uploaded a new version of File:What you see when JWildFire starts - Startup Splash Screen.jpg

Screenshot of What you see when JWildFire starts - Startup Splash Screen.

File:What you see when JWildFire starts - Startup Splash Screen.jpg

2015-03-26T13:56:33Z

Martin Flink: Martin Flink uploaded a new version of File:What you see when JWildFire starts - Startup Splash Screen.jpg

Screenshot of What you see when JWildFire starts - Startup Splash Screen.

Manual Installation

2015-03-26T13:20:30Z

Martin Flink: /* Using the Installer (INSTEAD of the Zip version). */

=Installing Java and JWildfire=
'''The Definitive Guide to Fractal Awesomeness with JWildFire!'''
The few simple steps needed to get started on your JWildfire journey...
[[File:JWildfire Editor with Brainiac Fractal.jpg]]

==Checking Your Java version, Downloading and Installing Java==
'''Getting Started with JWildfire Fractal ART and Animation Software.'''

=== Checking what version of Java you have installed. ===

In this section we'll be taking you through the Installation of the Java Operating Environment Software (if you don't have it, or
need to update your current version).

Then we'll help you download and install the Freeware Fractal Art and Animation software
called '''JWildfire''' (JWF), created by '''Andreas Maschke'''.

By the time you finish reading through this part of the Manual...

We'll take you by the
hand and...

Very soon You'll be able to create Stunning Images in a few minutes just by clicking a couple of
buttons!

The best part is... You own the images you create and the copyright is yours...
You could even sell your fractal images and make some money.

Don't think that's possible huh?

Fair enough, just read on and let us help you prove it to
yourself...

J-WildFire runs on '''Windows, Mac and Linux''' computers and require '''Java version 6''',
''minimum'', (preferably '''version 8 - currently''') to be installed on your system.
In this part of the manual we will be illustrating how to set up a Windows system. If you
are on a Mac or Linux machine, further info can easily be obtained via Google for your
platform, if you have any questions.
'''To get started just go here:''' [http://java.com/en/download/installed.jsp?detect=jre&try=1 Check Your Java Version.]

Upon arrival, the website will check if you have the latest version of Java installed and if not, get you the free download.

If you know you don't yet have Java installed you can go here instead: [http://java.com/en/download/index.jsp Download Free Java Software.]

If you have any problems with the automated check etc. or are on Solaris or Linux you can go here: [http://java.com/en/download/manual.jsp Java Downloads for All Operating Systems.]

For Mac users: Apple supplies their own version of Java. Use the [http://support.apple.com/kb/HT1338?viewlocale=en_US Software Update] feature (available on the Apple menu) to check that you have the most up-to-date version of Java for your Mac.

<div class="figure">[[File:Verifying Java Version.jpg|frame|left|Verifying Your Java Version]]
</div>

<br clear=all>

=== Download Java ===

If you haven't got the latest version installed you'll get a message like this.

Click on '''"Download Java Now".'''

[[File:Verifying Java Result Newer Version Available.jpg|frame|left|The Screen You'll see if there's a Newer Version available]]

<br clear=all>
=== That brings you to the Download Page... ===

Click on: '''"Agree and Start your Free Download"'''.

[[File:Download New Java Version Start Download.jpg|frame|left|Start Download of Java]]

<br clear=all>
=== Click on Save File... ===

Save the file somewhere suitable on your system... this could be on your desktop or wherever you like.

[[File:Download Java Click on Save Button.jpg|frame|left|Click on "Save File"]]

<br clear=all>
=== Running the Installer. ===

Once you have finished downloading, just '''Double click on the downloaded file''' in the Download Manager window, or where you normally save download files.

You may have to '''''Confirm''''' that you want to '''"Run"''' the installer in order to start the installation. '''Then follow the instructions to Install.'''

'''NOTE:''' You may need to restart (close and re-open) your browser to enable the Java installation in your browser. (Once installed, Java runs both "Stand Alone" and in your Browser when needed).

[[File:Running the Java Installer.jpg|frame|left|Click on "Run" to start the installation]]

<br clear=all>

=== The Setup Progress will display... Followed by a Success Message when finished. ===

This process will not take more than a couple of minutes.

[[File:Java Installer Progress.jpg|frame|left|Java Installation Progress]]

<br clear=all>
=== Verify that everything is working fine... ===

This step isn't strictly necessary but I'm including the link for this in any case... just in case you have any problems.

Also, since the process only takes a couple of seconds, you might as well do it just to make sure!

[http://java.com/en/download/testjava.jsp Java Verification Test]

If you have any problems there are also some helpful links on that page.

[[File:Post Java Install Verification Test.jpg|frame|left|Success!]]

<br clear=all>
'''That's It! Time to Install JWildfire'''

==Downloading and Installing JWildfire==
=== How to Download and Install JWildFire ===

Now it's time to Download and Install JWildFire... This is very simple...

Future updates are also easy to install by following the same download instructions!

Go to '''Andreas Maschke's Blog:''' [http://www.andreas-maschke.com/?page_id=351 JWildfire Downloads]

Select the topmost '''(IzPack installer) or (*.zip-archive)''' file link '''(the latest version)''' below the: '''"Available ZIP files for Java 6 (includes launcher)"''' heading... The (IzPack installer) is the self running option, which is the simplest method to use but we are also covering the '''Manual Unzip Option''' in detail further down, in case you prefer that.

Using the '''"Installer"''' a *.jar (Java application) file version of the zip files, is very very simple and covered below!

Feel Free to Use either method.

To download, just click on the correct link and '''Save the file''' to a suitable location on your Hard Disk.

[[File:The Official JWildfire Blog - Download Page.jpg|frame|left|The Official JWildfire Blog and the Download page]]

<br clear=all>

== Using the Installer (INSTEAD of the Zip version). ==

The easiest way to install JWildfire these days, is to use the Java based izPack installer.
A hidden benefit using this is that since it uses Java, it will be a good test to check that Java is properly installed too.

Simply download the "IzPack installer" version. To start the installer just double click on the "jwildfire-installer-N.nn.jar" file.

'''The illustration below, covers all the following steps!'''

The first thing you'll see is a Language selector... This only affects the installation procedure! Select OK to continue.

Next you'll see a Welcome screen... Just Select "Next" to continue.

An Information box comes next... Again select "Next" to continue.

Now you need to select your Target Path... For simplicity, use the suggested one (that way upgrades will also be installed without fuss, to the same default folder) but if you want to, you can browse to a different location instead. Click on "Next".

If you don't have the directory already created, the installer will create it for you. On the other hand if you are upgrading an existing installation of JWildfire into the same directory, the installer will ask you to confirm that you want to overwrite existing files. If so select Yes.

Next you get to pick whether you want to install the optional JWildfire applet. This is a bit like a stand-alone and simplified version of the Interactive Render Module. It only has two Options "Create next" (to start rendering a new random flame) and "To Clipboard" which copies the parameters used in the current Flame to the text clipboard so that you can either open JWildfire and use the "From clipboard" option to import it... Or just paste it into a text document using Notepad or similar and save it with a ".flame" file extension instead of ".txt". That means that you can load it later into JWildfire.

When you click "Next" this time, the installation starts.

All that remains once the installation is finished is to create Shortcuts. Select what you need here and make sure to remember to create a desktop shortcut if you want one. (In the following section there's also a manual shortcut creation description, if you need it.)

Once that's all done... '''You're ready to Rock and Roll!'''

The process is illustrated below.

'''''You can skip the following sections, which covers manually unzipping and "installing" JWildfire.'''''

[[File:Using the installer.png|frame|left|Using the Izpack based Installer]]

<br clear=all>

== '''Unzip the Zip file. (OPTIONAL)''' ==

When you unzip the archive you can just direct the files and folders to be created in a suitable folder on your system (or you can Unzip to a temporary directory and copy/move the files from there afterwards).

Below we're showing you how you can '''Navigate to'' for example: ''"C:\Program Files"''' and by adding a suitable folder name like '''"J-Wildfire"''' (note the "\" before the name of the folder I want to create and install the files in), to the end of the '''"Destination path",''' we're asking the Unzip program to create the folder called '''"J-Wildfire"''' for us and copy all files and folders into it.

You can call the JWildfire folder whatever you like and put it anywhere on your system.

'''Another option''' is to first Unzip the JWildfire software files to a separate "JWildfire downloads" folder, where you could keep the last few software updates (in separate folders) and other resources not directly needed to run the software. Once unzipped all you have to do is copy all files and folders from inside the newly created folder for the version you just unzipped. Then paste these files into a suitable program folder which you can create yourself... then follow along below. (This is also a very good way to '''apply upgrades''' to the software. - Note that you would have to answer "Yes" when the move/copy or unzip function asks you to confirm overwriting of old files with the same names in your JWildfire program folder).

[[File:Unzip the Zip file.jpg|frame|left|Unzip the Zip file]]

<br clear=all>
=== The J-Wildfire folder is created and files copied into it. ===

Once the files have been unzipped (a few seconds later) we're nearly done!

Since the software is not installed in a traditional way (no long winded installation routine)... there is no '''Start up Icon''' created on your Desktop! So we'll create a shortcut to the '''"JWildfire.exe"''' file and put that on the desktop. (The file is of the type "Application").

'''''N.B. If your system is set up to "Hide file extensions" the file will only show up as "JWildfire" since the file extension ".exe" will be hidden!'''''

''This process may be a bit different if you are using a non-Windows system! Please refer to google or your system manuals if you don't know how to get this done.''

Open your "File Manager", "My Computer" or "Explorer" and Navigate to the Folder you just created.

To create an Application Shortcut to JWildfire, begin by '''Right Click and Dragging''' the '''"JWildfire.exe" file (don't let go of the Right Mouse Button!)... Then Drag the icon of the file out of the File Manager onto the Desktop...'''

[[Image:Creating a Desktop Shortcut step 1.jpg|frame|left|Creating a Shortcut to JWildfire - Step 1]]

<br clear=all>
=== Creating the Shortcut. ===

When you have dragged the '''"JWildfire.exe"''' icon to a suitable location...
Let go of the Right Mouse Button!

Select the '''"Create Shortcuts Here"''' option.

The new Shortcut is ready!

[[Image:Creating a Desktop Shortcut step 2.jpg|frame|left|Creating a Shortcut to JWildfire - Step 2]]

<br clear=all>
=== Using The Shortcut. ===
Now you have created a shortcut to the '''"JWildfire.exe"''' file. This will be the icon we use
to start the software.

The '''"JWildfire.exe"''' icon is linked to the executable JWildfire Launcher and will start up
the software when double clicked.

So instead of having to go to the folder and double clicking on this program file every
time we want to start the software, we have just created a "Shortcut" on the desktop that
provides a direct link to the file instead.

[[Image:Creating a Desktop Shortcut step 3 - Done.jpg|frame|left|Shortcut Done!]]

<br clear=all>

'''Ta da!'''

'''We're ready to go have some serious FUN!'''

There you go... we're done messing about now...

It's time to go and find out how you can become a '''Serious Artist''' with just a couple of
clicks!

'''Double Click on the Icon''' you just created to start up JWildfire...

[[Image:Double Click your new JWildFire Icon on the Desktop.jpg|frame|left|Double Click to Start JWildfire!]]

Manual Installation

2015-03-26T13:16:00Z

Martin Flink: /* Using the Installer (INSTEAD of the Zip version). */

=Installing Java and JWildfire=
'''The Definitive Guide to Fractal Awesomeness with JWildFire!'''
The few simple steps needed to get started on your JWildfire journey...
[[File:JWildfire Editor with Brainiac Fractal.jpg]]

==Checking Your Java version, Downloading and Installing Java==
'''Getting Started with JWildfire Fractal ART and Animation Software.'''

=== Checking what version of Java you have installed. ===

In this section we'll be taking you through the Installation of the Java Operating Environment Software (if you don't have it, or
need to update your current version).

Then we'll help you download and install the Freeware Fractal Art and Animation software
called '''JWildfire''' (JWF), created by '''Andreas Maschke'''.

By the time you finish reading through this part of the Manual...

We'll take you by the
hand and...

Very soon You'll be able to create Stunning Images in a few minutes just by clicking a couple of
buttons!

The best part is... You own the images you create and the copyright is yours...
You could even sell your fractal images and make some money.

Don't think that's possible huh?

Fair enough, just read on and let us help you prove it to
yourself...

J-WildFire runs on '''Windows, Mac and Linux''' computers and require '''Java version 6''',
''minimum'', (preferably '''version 8 - currently''') to be installed on your system.
In this part of the manual we will be illustrating how to set up a Windows system. If you
are on a Mac or Linux machine, further info can easily be obtained via Google for your
platform, if you have any questions.
'''To get started just go here:''' [http://java.com/en/download/installed.jsp?detect=jre&try=1 Check Your Java Version.]

Upon arrival, the website will check if you have the latest version of Java installed and if not, get you the free download.

If you know you don't yet have Java installed you can go here instead: [http://java.com/en/download/index.jsp Download Free Java Software.]

If you have any problems with the automated check etc. or are on Solaris or Linux you can go here: [http://java.com/en/download/manual.jsp Java Downloads for All Operating Systems.]

For Mac users: Apple supplies their own version of Java. Use the [http://support.apple.com/kb/HT1338?viewlocale=en_US Software Update] feature (available on the Apple menu) to check that you have the most up-to-date version of Java for your Mac.

<div class="figure">[[File:Verifying Java Version.jpg|frame|left|Verifying Your Java Version]]
</div>

<br clear=all>

=== Download Java ===

If you haven't got the latest version installed you'll get a message like this.

Click on '''"Download Java Now".'''

[[File:Verifying Java Result Newer Version Available.jpg|frame|left|The Screen You'll see if there's a Newer Version available]]

<br clear=all>
=== That brings you to the Download Page... ===

Click on: '''"Agree and Start your Free Download"'''.

[[File:Download New Java Version Start Download.jpg|frame|left|Start Download of Java]]

<br clear=all>
=== Click on Save File... ===

Save the file somewhere suitable on your system... this could be on your desktop or wherever you like.

[[File:Download Java Click on Save Button.jpg|frame|left|Click on "Save File"]]

<br clear=all>
=== Running the Installer. ===

Once you have finished downloading, just '''Double click on the downloaded file''' in the Download Manager window, or where you normally save download files.

You may have to '''''Confirm''''' that you want to '''"Run"''' the installer in order to start the installation. '''Then follow the instructions to Install.'''

'''NOTE:''' You may need to restart (close and re-open) your browser to enable the Java installation in your browser. (Once installed, Java runs both "Stand Alone" and in your Browser when needed).

[[File:Running the Java Installer.jpg|frame|left|Click on "Run" to start the installation]]

<br clear=all>

=== The Setup Progress will display... Followed by a Success Message when finished. ===

This process will not take more than a couple of minutes.

[[File:Java Installer Progress.jpg|frame|left|Java Installation Progress]]

<br clear=all>
=== Verify that everything is working fine... ===

This step isn't strictly necessary but I'm including the link for this in any case... just in case you have any problems.

Also, since the process only takes a couple of seconds, you might as well do it just to make sure!

[http://java.com/en/download/testjava.jsp Java Verification Test]

If you have any problems there are also some helpful links on that page.

[[File:Post Java Install Verification Test.jpg|frame|left|Success!]]

<br clear=all>
'''That's It! Time to Install JWildfire'''

==Downloading and Installing JWildfire==
=== How to Download and Install JWildFire ===

Now it's time to Download and Install JWildFire... This is very simple...

Future updates are also easy to install by following the same download instructions!

Go to '''Andreas Maschke's Blog:''' [http://www.andreas-maschke.com/?page_id=351 JWildfire Downloads]

Select the topmost '''(IzPack installer) or (*.zip-archive)''' file link '''(the latest version)''' below the: '''"Available ZIP files for Java 6 (includes launcher)"''' heading... The (IzPack installer) is the self running option, which is the simplest method to use but we are also covering the '''Manual Unzip Option''' in detail further down, in case you prefer that.

Using the '''"Installer"''' a *.jar (Java application) file version of the zip files, is very very simple and covered below!

Feel Free to Use either method.

To download, just click on the correct link and '''Save the file''' to a suitable location on your Hard Disk.

[[File:The Official JWildfire Blog - Download Page.jpg|frame|left|The Official JWildfire Blog and the Download page]]

<br clear=all>

== Using the Installer (INSTEAD of the Zip version). ==

The easiest way to install JWildfire these days, is to use the Java based izPack installer.
A hidden benefit using this is that since it uses Java, it will be a good test to check that Java is properly installed too.

Simply download the "IzPack installer" version. To start the installer just double click on the "jwildfire-installer-N.nn.jar" file.

'''The illustration below, covers all the following steps!'''

The first thing you'll see is a Language selector... This only affects the installation procedure! Select OK to continue.

Next you'll see a Welcome screen... Just Select "Next" to continue.

An Information box comes next... Again select "Next" to continue.

Now you need to select your Target Path... For simplicity, use the suggested one (that way upgrades will also be installed without fuss, to the same default folder) but if you want to, you can browse to a different location instead. Click on "Next".

If you don't have the directory already created, the installer will create it for you. On the other hand if you are upgrading an existing installation of JWildfire into the same directory, the installer will ask you to confirm that you want to overwrite existing files. If so select Yes.

Next you get to pick whether you want to install the optional JWildfire applet. This is a bit like a stand-alone and simplified version of the Interactive Render Module. It only has two Options "Create next" (to start rendering a new random flame) and "To Clipboard" which copies the parameters used in the current Flame to the text clipboard so that you can either open JWildfire and use the "From clipboard" option to import it... Or just paste it into a text document using Notepad or similar and save it with a ".flame" file extension instead of ".txt". That means that you can load it later into JWildfire.

When you click "Next" this time, the installation starts.

All that remains once the installation is finished is to create Shortcuts. Select what you need here (make sure to remember to create a desktop shortcut if you want one. (In the following section there's also a manual shortcut creation description, if you need it.)

Once that's all done... You're ready to Rock and Roll!

The process is illustrated below.

You can skip the following sections, which covers manually unzipping and "installing" JWildfire.

[[File:Using the installer.png|frame|left|Using the Izpack based Installer]]

<br clear=all>

== '''Unzip the Zip file. (OPTIONAL)''' ==

When you unzip the archive you can just direct the files and folders to be created in a suitable folder on your system (or you can Unzip to a temporary directory and copy/move the files from there afterwards).

Below we're showing you how you can '''Navigate to'' for example: ''"C:\Program Files"''' and by adding a suitable folder name like '''"J-Wildfire"''' (note the "\" before the name of the folder I want to create and install the files in), to the end of the '''"Destination path",''' we're asking the Unzip program to create the folder called '''"J-Wildfire"''' for us and copy all files and folders into it.

You can call the JWildfire folder whatever you like and put it anywhere on your system.

'''Another option''' is to first Unzip the JWildfire software files to a separate "JWildfire downloads" folder, where you could keep the last few software updates (in separate folders) and other resources not directly needed to run the software. Once unzipped all you have to do is copy all files and folders from inside the newly created folder for the version you just unzipped. Then paste these files into a suitable program folder which you can create yourself... then follow along below. (This is also a very good way to '''apply upgrades''' to the software. - Note that you would have to answer "Yes" when the move/copy or unzip function asks you to confirm overwriting of old files with the same names in your JWildfire program folder).

[[File:Unzip the Zip file.jpg|frame|left|Unzip the Zip file]]

<br clear=all>
=== The J-Wildfire folder is created and files copied into it. ===

Once the files have been unzipped (a few seconds later) we're nearly done!

Since the software is not installed in a traditional way (no long winded installation routine)... there is no '''Start up Icon''' created on your Desktop! So we'll create a shortcut to the '''"JWildfire.exe"''' file and put that on the desktop. (The file is of the type "Application").

'''''N.B. If your system is set up to "Hide file extensions" the file will only show up as "JWildfire" since the file extension ".exe" will be hidden!'''''

''This process may be a bit different if you are using a non-Windows system! Please refer to google or your system manuals if you don't know how to get this done.''

Open your "File Manager", "My Computer" or "Explorer" and Navigate to the Folder you just created.

To create an Application Shortcut to JWildfire, begin by '''Right Click and Dragging''' the '''"JWildfire.exe" file (don't let go of the Right Mouse Button!)... Then Drag the icon of the file out of the File Manager onto the Desktop...'''

[[Image:Creating a Desktop Shortcut step 1.jpg|frame|left|Creating a Shortcut to JWildfire - Step 1]]

<br clear=all>
=== Creating the Shortcut. ===

When you have dragged the '''"JWildfire.exe"''' icon to a suitable location...
Let go of the Right Mouse Button!

Select the '''"Create Shortcuts Here"''' option.

The new Shortcut is ready!

[[Image:Creating a Desktop Shortcut step 2.jpg|frame|left|Creating a Shortcut to JWildfire - Step 2]]

<br clear=all>
=== Using The Shortcut. ===
Now you have created a shortcut to the '''"JWildfire.exe"''' file. This will be the icon we use
to start the software.

The '''"JWildfire.exe"''' icon is linked to the executable JWildfire Launcher and will start up
the software when double clicked.

So instead of having to go to the folder and double clicking on this program file every
time we want to start the software, we have just created a "Shortcut" on the desktop that
provides a direct link to the file instead.

[[Image:Creating a Desktop Shortcut step 3 - Done.jpg|frame|left|Shortcut Done!]]

<br clear=all>

'''Ta da!'''

'''We're ready to go have some serious FUN!'''

There you go... we're done messing about now...

It's time to go and find out how you can become a '''Serious Artist''' with just a couple of
clicks!

'''Double Click on the Icon''' you just created to start up JWildfire...

[[Image:Double Click your new JWildFire Icon on the Desktop.jpg|frame|left|Double Click to Start JWildfire!]]

Manual Installation

2015-03-26T13:13:22Z

Martin Flink: /* Downloading and Installing JWildfire */

=Installing Java and JWildfire=
'''The Definitive Guide to Fractal Awesomeness with JWildFire!'''
The few simple steps needed to get started on your JWildfire journey...
[[File:JWildfire Editor with Brainiac Fractal.jpg]]

==Checking Your Java version, Downloading and Installing Java==
'''Getting Started with JWildfire Fractal ART and Animation Software.'''

=== Checking what version of Java you have installed. ===

In this section we'll be taking you through the Installation of the Java Operating Environment Software (if you don't have it, or
need to update your current version).

Then we'll help you download and install the Freeware Fractal Art and Animation software
called '''JWildfire''' (JWF), created by '''Andreas Maschke'''.

By the time you finish reading through this part of the Manual...

We'll take you by the
hand and...

Very soon You'll be able to create Stunning Images in a few minutes just by clicking a couple of
buttons!

The best part is... You own the images you create and the copyright is yours...
You could even sell your fractal images and make some money.

Don't think that's possible huh?

Fair enough, just read on and let us help you prove it to
yourself...

J-WildFire runs on '''Windows, Mac and Linux''' computers and require '''Java version 6''',
''minimum'', (preferably '''version 8 - currently''') to be installed on your system.
In this part of the manual we will be illustrating how to set up a Windows system. If you
are on a Mac or Linux machine, further info can easily be obtained via Google for your
platform, if you have any questions.
'''To get started just go here:''' [http://java.com/en/download/installed.jsp?detect=jre&try=1 Check Your Java Version.]

Upon arrival, the website will check if you have the latest version of Java installed and if not, get you the free download.

If you know you don't yet have Java installed you can go here instead: [http://java.com/en/download/index.jsp Download Free Java Software.]

If you have any problems with the automated check etc. or are on Solaris or Linux you can go here: [http://java.com/en/download/manual.jsp Java Downloads for All Operating Systems.]

For Mac users: Apple supplies their own version of Java. Use the [http://support.apple.com/kb/HT1338?viewlocale=en_US Software Update] feature (available on the Apple menu) to check that you have the most up-to-date version of Java for your Mac.

<div class="figure">[[File:Verifying Java Version.jpg|frame|left|Verifying Your Java Version]]
</div>

<br clear=all>

=== Download Java ===

If you haven't got the latest version installed you'll get a message like this.

Click on '''"Download Java Now".'''

[[File:Verifying Java Result Newer Version Available.jpg|frame|left|The Screen You'll see if there's a Newer Version available]]

<br clear=all>
=== That brings you to the Download Page... ===

Click on: '''"Agree and Start your Free Download"'''.

[[File:Download New Java Version Start Download.jpg|frame|left|Start Download of Java]]

<br clear=all>
=== Click on Save File... ===

Save the file somewhere suitable on your system... this could be on your desktop or wherever you like.

[[File:Download Java Click on Save Button.jpg|frame|left|Click on "Save File"]]

<br clear=all>
=== Running the Installer. ===

Once you have finished downloading, just '''Double click on the downloaded file''' in the Download Manager window, or where you normally save download files.

You may have to '''''Confirm''''' that you want to '''"Run"''' the installer in order to start the installation. '''Then follow the instructions to Install.'''

'''NOTE:''' You may need to restart (close and re-open) your browser to enable the Java installation in your browser. (Once installed, Java runs both "Stand Alone" and in your Browser when needed).

[[File:Running the Java Installer.jpg|frame|left|Click on "Run" to start the installation]]

<br clear=all>

=== The Setup Progress will display... Followed by a Success Message when finished. ===

This process will not take more than a couple of minutes.

[[File:Java Installer Progress.jpg|frame|left|Java Installation Progress]]

<br clear=all>
=== Verify that everything is working fine... ===

This step isn't strictly necessary but I'm including the link for this in any case... just in case you have any problems.

Also, since the process only takes a couple of seconds, you might as well do it just to make sure!

[http://java.com/en/download/testjava.jsp Java Verification Test]

If you have any problems there are also some helpful links on that page.

[[File:Post Java Install Verification Test.jpg|frame|left|Success!]]

<br clear=all>
'''That's It! Time to Install JWildfire'''

==Downloading and Installing JWildfire==
=== How to Download and Install JWildFire ===

Now it's time to Download and Install JWildFire... This is very simple...

Future updates are also easy to install by following the same download instructions!

Go to '''Andreas Maschke's Blog:''' [http://www.andreas-maschke.com/?page_id=351 JWildfire Downloads]

Select the topmost '''(IzPack installer) or (*.zip-archive)''' file link '''(the latest version)''' below the: '''"Available ZIP files for Java 6 (includes launcher)"''' heading... The (IzPack installer) is the self running option, which is the simplest method to use but we are also covering the '''Manual Unzip Option''' in detail further down, in case you prefer that.

Using the '''"Installer"''' a *.jar (Java application) file version of the zip files, is very very simple and covered below!

Feel Free to Use either method.

To download, just click on the correct link and '''Save the file''' to a suitable location on your Hard Disk.

[[File:The Official JWildfire Blog - Download Page.jpg|frame|left|The Official JWildfire Blog and the Download page]]

<br clear=all>

== Using the Installer (INSTEAD of the Zip version). ==

The easiest way to install JWildfire these days, is to use the Java based izPack installer.
A hidden benefit using this is that since it uses Java, it will be a good test to check that Java is properly installed too.

Simply download the "IzPack installer" version. To start the installer just double click on the "jwildfire-installer-N.nn.jar" file.

'''The illustration below, covers all the following steps!'''

The first thing you'll see is a Language selector... This only affects the installation procedure! Select OK to continue.

Next you'll see a Welcome screen... Just Select "Next" to continue.

An Information box comes next... Again select "Next" to continue.

Now you need to select your Target Path... For simplicity, use the suggested one (that way upgrades will also be installed without fuss, to the same default folder) but if you want to, you can browse to a different location instead. Click on "Next".

If you don't have the directory already created, the installer will create it for you. On the other hand if you are upgrading an existing installation of JWildfire into the same directory, the installer will ask you to confirm that you want to overwrite existing files. If so select Yes.

Next you get to pick whether you want to install the optional JWildfire applet. This is a bit like a stand-alone and simplified version of the Interactive Render Module. It only has two Options "Create next" (to start rendering a new random flame) and "To Clipboard" which copies the parameters used in the current Flame to the text clipboard so that you can either open JWildfire and use the "From clipboard" option to import it... Or just paste it into a text document using Notepad or similar and save it with a ".flame" file extension instead of ".txt". That means that you can load it later into JWildfire.

When you click "Next" this time, the installation starts.

All that remains once the installation is finished is to create Shortcuts. Select what you need here (make sure to remember to create a desktop shortcut if you want one. (In the following section there's also a manual shortcut creation description, if you need it.)

Once that's all done... You're ready to Rock and Roll!

The process is illustrated below.

You can skip the following sections, which covers manually unzipping and "installing" JWildfire.

[[File:Using the Installer.png|frame|left|Using the Izpack based Installer]]

<br clear=all>

== '''Unzip the Zip file. (OPTIONAL)''' ==

When you unzip the archive you can just direct the files and folders to be created in a suitable folder on your system (or you can Unzip to a temporary directory and copy/move the files from there afterwards).

Below we're showing you how you can '''Navigate to'' for example: ''"C:\Program Files"''' and by adding a suitable folder name like '''"J-Wildfire"''' (note the "\" before the name of the folder I want to create and install the files in), to the end of the '''"Destination path",''' we're asking the Unzip program to create the folder called '''"J-Wildfire"''' for us and copy all files and folders into it.

You can call the JWildfire folder whatever you like and put it anywhere on your system.

'''Another option''' is to first Unzip the JWildfire software files to a separate "JWildfire downloads" folder, where you could keep the last few software updates (in separate folders) and other resources not directly needed to run the software. Once unzipped all you have to do is copy all files and folders from inside the newly created folder for the version you just unzipped. Then paste these files into a suitable program folder which you can create yourself... then follow along below. (This is also a very good way to '''apply upgrades''' to the software. - Note that you would have to answer "Yes" when the move/copy or unzip function asks you to confirm overwriting of old files with the same names in your JWildfire program folder).

[[File:Unzip the Zip file.jpg|frame|left|Unzip the Zip file]]

<br clear=all>
=== The J-Wildfire folder is created and files copied into it. ===

Once the files have been unzipped (a few seconds later) we're nearly done!

Since the software is not installed in a traditional way (no long winded installation routine)... there is no '''Start up Icon''' created on your Desktop! So we'll create a shortcut to the '''"JWildfire.exe"''' file and put that on the desktop. (The file is of the type "Application").

'''''N.B. If your system is set up to "Hide file extensions" the file will only show up as "JWildfire" since the file extension ".exe" will be hidden!'''''

''This process may be a bit different if you are using a non-Windows system! Please refer to google or your system manuals if you don't know how to get this done.''

Open your "File Manager", "My Computer" or "Explorer" and Navigate to the Folder you just created.

To create an Application Shortcut to JWildfire, begin by '''Right Click and Dragging''' the '''"JWildfire.exe" file (don't let go of the Right Mouse Button!)... Then Drag the icon of the file out of the File Manager onto the Desktop...'''

[[Image:Creating a Desktop Shortcut step 1.jpg|frame|left|Creating a Shortcut to JWildfire - Step 1]]

<br clear=all>
=== Creating the Shortcut. ===

When you have dragged the '''"JWildfire.exe"''' icon to a suitable location...
Let go of the Right Mouse Button!

Select the '''"Create Shortcuts Here"''' option.

The new Shortcut is ready!

[[Image:Creating a Desktop Shortcut step 2.jpg|frame|left|Creating a Shortcut to JWildfire - Step 2]]

<br clear=all>
=== Using The Shortcut. ===
Now you have created a shortcut to the '''"JWildfire.exe"''' file. This will be the icon we use
to start the software.

The '''"JWildfire.exe"''' icon is linked to the executable JWildfire Launcher and will start up
the software when double clicked.

So instead of having to go to the folder and double clicking on this program file every
time we want to start the software, we have just created a "Shortcut" on the desktop that
provides a direct link to the file instead.

[[Image:Creating a Desktop Shortcut step 3 - Done.jpg|frame|left|Shortcut Done!]]

<br clear=all>

'''Ta da!'''

'''We're ready to go have some serious FUN!'''

There you go... we're done messing about now...

It's time to go and find out how you can become a '''Serious Artist''' with just a couple of
clicks!

'''Double Click on the Icon''' you just created to start up JWildfire...

[[Image:Double Click your new JWildFire Icon on the Desktop.jpg|frame|left|Double Click to Start JWildfire!]]

2015-03-04T04:36:23Z

Martin Flink:

<br clear=all>
=JWildfire Preferences=

== List of Preferences and their functions ==

<div class="figure">[[File:list-of-preferences.png]]
</div>

<br clear=all>

== Tweaking JWildfire's Performance ==

File:List-of-preferences.png

2015-03-04T04:31:40Z

Martin Flink:

Manual Preferences

2015-03-04T04:31:02Z

Martin Flink: Created page with "<br clear=all> =JWildfire Preferences= == List of Preferences and their functions == <div class="figure">File:list-of-preferences.png </div> <br clear=all>"

<br clear=all>
=JWildfire Preferences=

== List of Preferences and their functions ==

<div class="figure">[[File:list-of-preferences.png]]
</div>

<br clear=all>

Main Page

2015-03-04T02:51:34Z

Martin Flink:

Main Page

2015-03-04T02:05:46Z

Martin Flink: /* Welcome to the JWildfire Wiki! */

Manual Launcher

2015-03-04T01:58:36Z

Martin Flink: /* What you'll see when JWildFire starts */

<br clear=all>
=Launching JWildfire=

== What you'll see when JWildFire starts ==

The first thing you'll notice when you start JWildFire is an initial "Welcome to JWildfire" (version No. and compiled date) Window opening up...

This contains the Java Environment startup options, with a couple of optional settings..
JWildfire is just as happy working in 32bit mode as 64bit (optimal if your OS supports it).

When you are happy with your settings click on "Start"!

Shortly after this window disappears, you'll see the main "Welcome to JWildfire" window open with the main JWildFire interface behind it...

<div class="figure">[[File:What you see when JWildFire starts - Launcher Window.jpg]]
</div>

<br clear=all>

== Meet JWildFire! ==

Thanks for your patience... I know it may have seemed like a lot of steps to get here but you shouldn't have spent more than 5 minutes or so.

Now it's time to show you why it was worth it!

<div class="figure">[[File:What you see when JWildFire starts - Startup Splash Screen.jpg]]
</div>

<br clear=all>
== Alternative Ways of Starting JWildFire... ==

In the unlikely event that using the "'''JWildfire.exe'''" file isn't starting up the software properly, there are alternatives...

These alternatives are found in your JWildfire installation folder. The first option is using one of the supplied platform specific start-scripts available in your installation folder:

"'''start_windows.bat'''", "'''start_mac.command'''" or "'''start_linux.sh'''"

Alternatively you can use the "'''j-wildfire-launcher.jar'''" file instead.

If you use any of these alternative startup methods you could just create the shortcut,
as described [[Manual_Installation#The_J-Wildfire_folder_is_created_and_files_copied_into_it.|Here!]], for the alternative file instead of the "'''JWildfire.exe'''" file...

<div class="figure">[[File:alternative-ways-of-starting-jwildfire.jpg]]
</div>
<br clear=all>
== Support and Community Options ==
If you do have any trouble getting started, one of the best ways to get help is by '''joining our Official Facebook Group! '''You will find us by clicking on the "''''FB community" '''button on the welcome screen as seen [[Manual_Launcher#Meet JWildFire!| above]] or you can click here!:
[https://www.facebook.com/groups/JWildfireOpenGroup/ JWildfire Open Group]

'''Please Note!''' Technical Support Issues should first be checked '''(since most solutions already exist)''' over at the '''"Help & Support"''' Section in our Forum! [http://jwildfire.org/forum/viewforum.php?f=5&sid=911e50683f75e01159171e3ef09c3c84 Click here for the Tech Support Area]

If you can't find a solution for your problem in the Forum or by asking (nicely) in the Facebook Group...
Please Create a New Topic with a detailed explanation of your problem and your specific equipment, in the Forum. This makes it easier to keep track on any outstanding issues and it allows for easier searching for previously solved problems and their solutions.

Our growing Google+ Community can be found here: [https://plus.google.com/u/0/communities/118391398023168606746 Google+ JWildfire User's Group]

<div class="figure">[[File:support-and-community-options.jpg]]
</div>
<br clear=all>

== Onwards and Upwards! ==

That concludes this step-by-step JWildFire (and Java) installation Guide.

We hope you enjoyed getting ready... To '''PLAY''' and Have '''FUN!'''

See you in the next Module and on Facebook, G+ or the Forum!

=More technical information about the launcher=
==Try not to start the j-wildfire.jar directly==
Please always use the official launcher to start JWildfire.
The launcher can be executed by any Java runtime and can be started with any options.
The task of the launcher is to launch the main software with controlled options and to reserve enough memory.
#Your First Option is to use '''JWildfire.exe''' to start the launcher. Mainly because the executable file also contains a suitable Icon, which is used when you create a shortcut.
#'''Alternatively:'''
## under Windows use the '''start_windows.bat''' to start the launcher.
## under Mac OS use the '''start_mac.command''' to start the launcher.
## under Linux use the '''start_linux.sh''' to start the launcher.
If this doesn't work or if you have another operating system not listed here, just start/open the '''j-wildfire-launcher.jar''' directly.

<div class="figure">[[File:alternative-ways-of-starting-jwildfire.jpg]]
</div>
<br clear=all>
PLEASE DO NOT START THE '''j-wildfire.jar''' DIRECTLY!
If you start the '''j-wildfire.jar''' directly then JWildfire is started with '''default Java options'''.
In most cases you cannot render large images with those settings because enough memory is not reserved at startup. So even if you have plenty of memory it can not be used for rendering this way. Additionally, the wrong settings may cause slower rendering.

==How the Launcher works==
The Launcher analyzes certain system settings to locate java runtimes on your system and automatically selects the most recent one.

You can override the automatically selected version by selecting another entry in the listbox.

If the scanner did not find a java runtime (probably on Macs as we have no way to test this) you can manually add it. You only have to do this once, of course.

The memory setting lets you specify the maximum amount of memory in megabytes to use.
This memory amount is only allocated if required but there is no way to allocate more memory than specified here, if JWildfire is already running.

So you must choose this value wisely.

Example: 6000 MB should work fine to render images in high-end quality for print.

==Troubleshooting==
The launcher works in two ways: regular and debug mode. In regular mode it just starts JWildfire and shuts down itself.
If you face any problems (i.e. JWildfire does not start) please activate the "Debug" checkbox. This forces a traced launch where log messages are recorded and displayed at the "Log messages" tab.
You can easily copy those messages into the clipboard by using the "To clipboard" button and then report them for further assistance.