Factory Functions for Image Classes

PixelLive SDK provides the following factory classes for the purpose of manipulating images. To use these functions, you should include pxl_imageutils.h and specify Celartem::ImageUtils namespace explicitly or use use namespace directive.
Each Image instance created by the functions listed below can be chained to another Image instance. For more information, see Image Chain Basics.

• Scale
  This factory creates an Image instance that rescales the input Image.

• SmoothScale
  This factory creates an Image instance that rescales the input Image with PixelLive technology.

• GFScale
  This factory creates an Image instance that rescales the input Image with the scaling technology known as Genuine Fractals. This function is provided by PixelLive SDK GF Add-in (not included in PixelLive SDK).

  See also:

  gf-addin

• Crop
  This factory creates an Image instance that extracts a portion of the input Image. You had better not insert Crop in the middle of the image chain since the cropped image behaves as if it were a static image (it doesn't accept any Image::setParam parameters.).

• Overlay
  This factory creates an Image instance that overlays an Image instance on another Image instance.

• PhotometricTransform
  This factory creates an Image instance that change the colormetric (colorspace, channel layout, ...) of the input Image.

• ToSRGB
  This factory creates an Image instance that converts the input Image to sRGB. This function is an interface for PhotometricTransform.

• ImageCache
  This factory creates an Image instance that caches the raw image from the input Image. It is useful if the input Image instance is slow and you want to keep the response of generating raw images.

• ExtraMargin
  This factory creates an Image instance that add margins to the input Image. This function is useful if the user of the Image requires the area of out of the image dimensions. For instance, if the user requires the raw image of 100x100 from (-50,-50), the Image instance created by ExtraMargin generates the raw image of (-50,-50) 100x50 and (-50, 0) 50x50 and only requires the input Image to load (0,0) 50x50.

• CallbackImage
  This function creates a new Image instance that periodically calls the specified ProcessCallback instance during the process of ImageLock::read function.

• ImageFromRawData
  This function creates a new Image instance from a raw image on the specified buffer. This is useful when you want to manipulate the image already loaded on some existing buffer.

• ImageBuffer(1)
  This function creates a new ImageWritable instance based on specified metrics. You can do read/write on the instance.

• ImageBuffer(2)
  This function creates an ImageWritable instance from the raw data ripped from the specified Image instance. The function is useful when you want to manually modify the output image from some Image chain.

• ImageMultiThread
  This function enables you to render the image with multiple threads. The image passed to this function is automatically processed with multiple threads without any complex configurations.
  With the current version, MrSID/JPEG 2000 images cannot be used with this function. This restriction will be fixed in the future releases.

• Sharpness_4
  This function creates a new Image instance that applies the 4 neighbor sharpness filter.

• Sharpness_8
  This function creates a new Image instance that applies the 9 neighbor sharpness filter.

• UniformFilter
  This function creates a new Image instance that applies a filter to the specified Image instance.
  

• ApplyToneFunction
  This function creates a new Image instance that applies a pixel translation function to the specified Image instance.
  

• ApplyGamma
  This function creates a new Image instance that applies a gamma to the specified Image instance.
  

• CutOffOutOfRangeValuesParam
  This function creates a new Image instance that applies a min/max value filter to the specified Image instance.
  

See also:

Image, ImageParam, Image Parameter Structures, ImageUtils

---

This document is automatically generated using doxygen 1.5.4 at Fri Jun 27 18:22:54 2008.