### QPx_FilterPicture

QPx_FilterPicture(pictVar; filterSettings):error
| pictVar | Picture | Picture variable
| filterSettings | BLOB | Filter settings
| error | Longint | Error result

Applies a filter to a picture.

The source picture is passed in the pictVar parameter. The source picture may be compressed or uncompressed. The filtered picture is also returned in the pictVar parameter and it is always uncompressed. If an error occurs, pictVar is set to an empty picture.

The filterSettings parameter specifies the filter to be applied and its associated settings. To let the user select a filter and retrieve the selected filter and settings, call the QPx_DoFilterSettingsDialog command.

To get information about all available QuickTime filters, call the QPx_GetFilterList command.

Note: The BLOB parameter must contain filter settings that has previously been obtained using the QPx_DoFilterSettingsDialog command. The structure of this BLOB is private to QuickTime and cannot be constructed or altered with 4D BLOB commands.

Example

``Displays the filter settings dialog and applies` ``the selected filter to a picture` `` `C_LONGINT($error)` `C_PICTURE($picture)` `C_STRING(4;$filterType)` `C_BLOB($settings)` `` `$picture:=[Images]Picture` `` `$error:=QPx_DoFilterSettingsDialog($settings;$filterType)` `` `If ($error=qpx_noErr)` `` `$error:=QPx_FilterPicture($picture;$settings)` `` `If ($error#qpx_noErr)` ``Handle the error` `End if` `` `End if` ``

Related commands

QPx_DoFilterSettingsDialog | Displays the standard filter dialog to the user
QPx_GetFilterList | Returns a list of available QuickTime filters
QPx_BrightnessContrastPicture | Applies the "Escape Brightness and Contrast" filter to a picture
QPx_SharpenPicture | Applies the "Sharpen" filter to a picture
QPx_BlurPicture | Applies the "Blur" filter to a picture
QPx_RGBBalancePicture | Applies the "RGB Balance" filter to a picture
QPx_HSLBalancePicture | Applies the "HSL Balance" filter to a picture

QPix © Escape
Generated by QDoc 2.8 on Wed, Feb 17, 2010 17:43:30