common
Class PixelCoordinate

Object
  common:Generic
      common:Transform
          common:UtilityTransform
              common:PixelCoordinate

class 
UtilityTransform:PixelCoordinate

This is a utility transform which returns a pixel coordinate for a given complex number.

Ultra Fractal Source

Toggle UF Source Code Display

 class PixelCoordinate(UtilityTransform) {
   ; This is a utility transform which returns a pixel coordinate
   ; for a given complex number.
   
 public:
   func PixelCoordinate(Generic pparent)
     UtilityTransform.UtilityTransform(pparent)
 
     m_ScreenRelative = 0
     m_SinAngle = sin(#angle)
     m_CosAngle = cos(#angle)
 
     if (#width*3 <= #height*4)
       m_Distance = 4 / (#width*#magn)
     else
       m_Distance = 3 / (#height*#magn)
     endif
 
   endfunc
   
   func Init(complex pz)
     UtilityTransform.Init(pz)
   endfunc
   
   complex func Iterate(complex pz)
     UtilityTransform.Iterate(pz)
     
     float sx
     float sy
     complex cz
     
     ; note that in these calculations, we invert the y coordinate
     ; because Ultra Fractal reports #screenpixel with (0,0) in the
     ; upper left, not the lower left; complex numbers would place
     ; (0,0) in the lower left
 
     if (m_Screenrelative == 1)              ; screen-relative coordinates
       sx = real(pz) * #width
       sy = (1 - imag(pz)) * #height
 
     else                        ; normal coordinates
       cz = (pz - #center) / m_Distance
       sx = m_CosAngle*real(cz) + m_SinAngle*imag(cz)
       sy = m_CosAngle*imag(cz) - m_SinAngle*real(cz)
       sx = sx*#stretch + sy * tan(#skew)
       sx = sx + #width/2
       sy = -sy + #height/2
     endif
     
     return sx + flip(sy)
   endfunc
 
   ; set screen-relative style
   ; 0 = none, 1 = normal (0,0) .. (1,1), 2 = image (-1,-1) .. (1,1)
   func SetScreenRelative(int ptype)
     m_ScreenRelative = ptype
   endfunc
 
 protected:
   int m_ScreenRelative
   float m_SinAngle
   float m_CosAngle
   float m_Distance
   
 default:
   title = "Pixel Coordinate utility class"
 
   int param v_pixelcoordinate
     caption = "Version (PixelCoordinate)"
     default = 100
     hint = "This version parameter is used to detect when a change has been made to the formula that is incompatible with the previous version. When that happens, this field will reflect the old version number to alert you to the fact that an alternate rendering is being used."
     visible = @v_pixelcoordinate < 100
   endparam
 }
 

Constructor Summary

PixelCoordinate()

PixelCoordinate(Generic pparent)

Method Summary

void	Init(complex pz) Set up for a sequence of values
complex	Iterate(complex pz) Transform a single point within a sequence
void	SetScreenRelative(int ptype) set screen-relative style 0 = none, 1 = normal (0,0) ..

Methods inherited from class common:Transform

IsSolid, IterateSilent

Methods inherited from class common:Generic

GetParent

Methods inherited from class Object

Constructor Detail

PixelCoordinate

public PixelCoordinate(Generic pparent)

PixelCoordinate

public PixelCoordinate()

Method Detail

Init

public void Init(complex pz)

Description copied from class: Transform

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). It will be called even if only one value is being transformed (e.g. a normal transformation formula). Use this to perform any setup that is exactly the same for each value in the sequence being transformed.

Overrides:

Init in class Transform

Parameters:

pz - the value representing the sequence; for a normal transformation formula use, this will be #pixel. In some cases this may differ from the first value passed to Iterate() if the calling code applies some other transformations.

Iterate

public complex Iterate(complex pz)

Description copied from class: Transform

Transform a single point within a sequence

After a sequence has been set up with Init(), this function will be called once for each value in the sequence. Note that all values in the sequence must be processed in order (they cannot be processed out of order). If the sequence contains only one value, Init() will still be called and then Iterate() will be called just once.

Overrides:

Iterate in class Transform

Parameters:

pz - the complex value to be transformed

Returns:

the transformed value

SetScreenRelative

public void SetScreenRelative(int ptype)

set screen-relative style 0 = none, 1 = normal (0,0) .. (1,1), 2 = image (-1,-1) .. (1,1)