PictureEffectsRaw Xojo Plugin

BarrelDistortEffectRaw Class (console safe)

A class to do Barrel Distortion on pictures.



Barrel distortion comes from a lens effect which causes images to be spherised or inflated. Barrel distortion is often associated with wide angle lenses and typically occurs at the wide end of a zoom lens. The use of converters often amplifies the effect. Barrel distortion is most visible in images with perfectly straight lines, especially when they are close to the edge of the image frame.

This class is meant to fix images that suffer from Barrel Distortion, though it can also be used to create extreme barrel distortion for stylish design purposes.

Special thanks to Nick Loveday for all the ground work on this effect.

Supports:
  • 8 bit per channel bitmaps

  • 16 bit per channel bitmaps

  • RGB color spaces

  • Gray color spaces

  • CMYK color spaces

  • Synchronous and asynchronous modes supported


    • This class supports use of multiple CPU cores.

    MPImageFilterRaw
       BarrelDistortEffectRaw

    class BarrelDistortEffectRaw implements

    IRawBitmapProcessor

    IRawBitmapProcessorAsync

    Properties

    AsyncCompleted (Inherited) (console safe) Returns true if asynchronous execution has completed, else false.
    AsyncResult (Inherited) (console safe) Returns the result bitmap of asynchronous execution.
    BackColor (console safe) The backcolor to fill empty areas of the image with.
    CPUCoreCount (Inherited) (console safe) Returns number of detected CPU cores on the running machine.
    Canceled (Inherited) (console safe) If this one returns true then the effects execution was canceled by a Progress handler.
    Distortion (console safe) Defines how much the image should be distorted.
    ErrorCode (Inherited) (console safe) Returns error code after applying the effect. This value is a Constant defined in the PictureEffectsRawError module.
    ForceThreads (Inherited) (console safe) Forces use of thread when set to true even when using only one CPU core.
    HorizontalKeystone (console safe) Sets or gets the value of the Horizontal Keystone.
    Interpolate (console safe) Enables or disables interpolation.
    MaximumCPUCores (Inherited) (console safe) Read only property where each effect can report maximum CPU cores it supports.
    MultiprocessingHint (Inherited) (console safe) 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) (console safe) 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.
    VerticalKeystone (console safe) Sets or gets the value of the Vertical Keystone.

    Methods

    Apply (console safe) Applies the effect on a RawBitmap image with parameters that have been set on the class instance.
    ApplyAsync (console safe) Applies the effect asynchronously on a RawBitmap image with parameters that have been set on the class instance.
    Cancel (Inherited) (console safe) Cancels processing and waits for threads to come to full stop when in asynchronous execution.

    Constants

    CPU_USE_MACHINE_CORE_COUNT = -1 (Inherited)
    CPU_USE_AUTOMATIC = 0 (Inherited)
    CPU_USE_1_CORE = 1 (Inherited)
    CPU_USE_2_CORES = 2 (Inherited)
    CPU_USE_3_CORES = 3 (Inherited)
    CPU_USE_4_CORES = 4 (Inherited)
    CPU_USE_5_CORES = 5 (Inherited)
    CPU_USE_6_CORES = 6 (Inherited)
    CPU_USE_7_CORES = 7 (Inherited)
    CPU_USE_8_CORES = 8 (Inherited)

    Supported Platforms:

  • macOS Intel 64 bit
  • macOS Apple Silicon
  • Windows 32 bit
  • Windows 64 bit
  • Windows ARM 64 bit
  • Linux 32 bit
  • Linux 64 bit
  • Linux ARM 32 bit
  • Linux ARM 64 bit
  • iOS