Apply the effect to an image.

[C#]
void Apply(PixMap pixMap)

[Visual Basic]
Sub Apply(pixMap As PixMap)


may throw Exception()

Apply the effect to an image specified as a PixMap.

Effects normally involve wholesale changes and so it may well be necessary to change the color space and depth in order to apply the effect. If the AutoRestore property is set then the PixMap will be restored to a similar color space after processing and it will be recompressed at an appropriate quality. This default is generally what is required.

If the AutoRestore property is not set then the final output may well have different characteristics such as color space and depth. In general the final image will be uncompressed eight bit RGB no matter what type of PixMap was supplied.

If you are relying on particular characteristics present in the original PixMap then you should set the AutoRestore property to false and then convert or recolor it after the effect has been applied. Since the final image will be left uncompressed you will likely want to recompress it using an appropriate schema.

None.