ck
Class ChangeFormula_AfterNIterations

Object
  common:Generic
      common:Formula
          ck:ckFormulaObject
              ck:ChangeFormula_AfterNIterations

class 
ckFormulaObject:ChangeFormula_AfterNIterations

This Formula allows you to choose a second formula to be taken at a certain iteration deepness christian kleinhuis 2008 visit: fractalforums.com fractalmovies.com

Ultra Fractal Source

Toggle UF Source Code Display

 class ChangeFormula_AfterNIterations(ck.ulb:ckFormulaObject) {
 ;
 ; This Formula allows you to choose a second formula to be taken at a certain iteration deepness
 ; christian kleinhuis 2008
 ; visit:
 ; fractalforums.com
 ; fractalmovies.com
 ;
 public:
   import "Common.ulb"
   import "Standard.ulb"
   complex func Init(complex pz)
     count=0
     f[0]=new @formulaClass1(this)
     f[1]=new @formulaClass2(this)
     f[1].Init(pz);
     atIteration=@atIteration;
     return f[0].Init(pz);
   endfunc
 
   complex func Iterate(complex pz)
       count=count+1
       return  getCurrentFormula().Iterate(pz)
   endfunc
 
    complex func GetPrimaryExponent()
   e1=f[0].GetPrimaryExponent()
   e2=f[1].GetPrimaryExponent()
   
     if cabs(e1)>cabs(e2)
        return e1
     else
         return e2
     endif
   endfunc
   bool func IsBailedOut(complex pz)
     return f[count%2].IsBailedOut(pz)
   endfunc
 
 private:
   int count;
   Formula f[2];
   
   Formula func getCurrentFormula()
           if(count<  @atIteration)
                      return f[0];
           endif
 
           return f[1];
   endfunc
 
 default:
   title = "Change Formula"
   rating = recommended
   Formula param formulaClass1
     caption = "First Formula"
     default = Standard_Mandelbrot
   endparam
 Formula param formulaClass2
     caption = "Second Formula"
     default = Standard_Mandelbrot
   endparam
 
 int param atIteration
     caption = "At Iteration"
     default = 0
   endparam
 
 }
 

Constructor Summary

ChangeFormula_AfterNIterations()

Method Summary

complex	GetPrimaryExponent() Determine the primary exponent.
complex	Init(complex pz) Set up for a sequence of values
boolean	IsBailedOut(complex pz) Test whether the formula has bailed out (i.e.
complex	Iterate(complex pz) Produce the next value in the sequence

Methods inherited from class common:Formula

GetLowerBailout, GetUpperBailout

Methods inherited from class common:Generic

GetParent

Methods inherited from class Object

Constructor Detail

ChangeFormula_AfterNIterations

public ChangeFormula_AfterNIterations()

Method Detail

Init

public complex Init(complex pz)

Description copied from class: Formula

Set up for a sequence of values

This function will be called at the beginning of each sequence of values (e.g. at the beginning of each fractal orbit).

Overrides:

Init in class Formula

Parameters:

pz - seed value for the sequence; for a normal fractal formula, this will be #pixel

Returns:

first value in the sequence; this corresponds to #z in a fractal formula

Iterate

public complex Iterate(complex pz)

Description copied from class: Formula

Produce the next value in the sequence

As long as the sequence has not bailed out, this function will be continually called to produce sequence values.

Overrides:

Iterate in class Formula

Parameters:

pz - previous value in the sequence; corresponds to #z in a fractal formula. Note that you should always use this value for computing the next iteration, rather than a saved value, as the calling code may modify the returned value before passing it back to the next Iterate() call.

Returns:

the next value in the sequence

GetPrimaryExponent

public complex GetPrimaryExponent()

Description copied from class: Formula

Determine the primary exponent.

Many fractals can be characterized by an exponent value that is useful to other formulas, so we provide that here. If your formula does not need or use this value, override the p_power parameter and make it hidden.

Overrides:

GetPrimaryExponent in class Formula

Returns:

the primary exponent parameter

IsBailedOut

public boolean IsBailedOut(complex pz)

Description copied from class: Formula

Test whether the formula has bailed out (i.e. the sequence is complete)

This is typically called once per iteration to test whether the sequence has completed. If producing this result is difficult to do separately from the Iterate() processing, you should produce the result in Iterate() and set the m_BailedOut flag appropriately, and leave IsBailedOut() unimplemented in your class to inherit this behavior.

Note that this test is the OPPOSITE sense of the bailout: section in UF's fractal formulas. A bailout: section returns TRUE to continue iterating. IsBailedOut() must return FALSE to continue iterating.

Overrides:

IsBailedOut in class Formula

Parameters:

pz - last sequence value to test; this should be the value returned from the previous Iterate() call. Note that it is acceptable to ignore pz and use m_BailedOut, but any code calling IsBailedOut() should pass in the correct pz for Formula classes which do not use m_BailedOut.

Returns:

true if the sequence has bailed out (i.e. should be terminated)