PictureEffects Xojo and Real Studio Plugin |
|
CrystallizeEffect Class
To crystallize a picture so that it looks like stained glass use the CrystalizeEffect class.


This class can crystalize using triangle, square, hexagon or big and small method. The result image can have edges separating the crystals or no edges. The crystals can be in perfect order or disordered.
This class supports use of multiple CPU cores on MacOS X, Windows and Linux systems.
Note that this class can get very CPU intensive especially if using the disorder feature on the effect.
MPImageFilter
CrystallizeEffect
Properties
Disorder | Sets the disorderedness of the crystallization |
EdgeColor | Sets the color of the edges. |
EdgeWidth | Sets the width or thickness of the edges. |
HideEdges | Hides the edges of the crystals. |
IgnoreAlpha | If set to true then the alpha channel of the source image will not be included in the destination image. |
Mask | Sets mask for the operation of the simple version of the Apply functions. |
Size | The size of the crystals |
Type | Defines the type of the crystallization. |
CPUCoreCount (Inherited) | Returns number of detected CPU cores on the running machine. |
ErrorCode (Inherited) | Returns error code after applying the effect. This value is a Constant defined in the PictureEffectsError module. |
MultiprocessingHint (Inherited) | Use this property to fine tune CPU usage for this algorithm. By default this property is set to zero (Automatic). This property accepts all constants that are defined in this class. |
ProgressHandler (Inherited) | Use this property to use a progress class to get progress feedback from this function. This class must be a class that Implements the IProgressHandler Interface which is defined in this plugin. |
Methods
Apply | Applies the effect on a given 32 bit source image with parameters that have been set on the class instance. |
Apply | Applies the effect on a given 32 bit source image with a given 32 bit mask and returns the result to a new image. |
Constants
TRIANGLE = 1 | A constant that defines triangular crystallization |
SQUARE = 2 | A constant that defines square crystallization |
HEXAGON = 3 | A constant that defines hexagon crystallization |
BIGANDSMALL = 4 | A constant that defines big and small crystallization |
CPU_USE_MACHINE_CORE_COUNT = -1 (Inherited) | Uses exactly the number of available CPU cores in the machine. (Available here means on-line CPU cores, some laptops can put CPU cores off line in low battery situations) |
CPU_USE_AUTOMATIC = 0 (Inherited) | Takes into account number of available CPU cores on the Machine and also tries to select the fastest way based on developer rating for each algorithm and picture size. (In simple algorithms then the fastest path is sometimes 2 or 3 CPU cores and not 4 CPU cores because of the overhead of managing multiple cores). In more complex algorithms then 3 or 4 cores are almost always faster than 2 cores. |
CPU_USE_1_CORE = 1 (Inherited) | Uses one CPU core. |
CPU_USE_2_CORES = 2 (Inherited) | Uses two CPU cores.
This setting will also work on machines with less than two CPU cores, but it will be slower or best case same speed as using the correct setting for such machine. |
CPU_USE_3_CORES = 3 (Inherited) | Uses three CPU cores.
This setting will also work on machines with less than three CPU cores, but it will be slower or best case same speed as using the correct setting for such machine. |
CPU_USE_4_CORES = 4 (Inherited) | Uses four CPU cores.
This setting will also work on machines with less than four CPU cores, but it will be slower or best case same speed as using the correct setting for such machine. |
CPU_USE_5_CORES = 5 (Inherited) | Uses five CPU cores.
This setting will also work on machines with less than four CPU cores, but it will be slower or best case same speed as using the correct setting for such machine. |
CPU_USE_6_CORES = 6 (Inherited) | Uses six CPU cores.
This setting will also work on machines with less than four CPU cores, but it will be slower or best case same speed as using the correct setting for such machine. |
CPU_USE_7_CORES = 7 (Inherited) | Uses seven CPU cores.
This setting will also work on machines with less than four CPU cores, but it will be slower or best case same speed as using the correct setting for such machine. |
CPU_USE_8_CORES = 8 (Inherited) | Uses eight CPU cores.
This setting will also work on machines with less than four CPU cores, but it will be slower or best case same speed as using the correct setting for such machine. |
Supported Platforms:
MacOS X CarbonMacOS X CocoaWin32 - WindowsLinux x86Unsupported Platforms: