Core Image Programming Guide: Loading Image Units

< Previous PageNext Page >

Hide TOC

Loading Image Units

The built-in filters supplied by Apple are loaded automatically. The only filters you need to load are third-party filters packaged as image units. An image unit, which is simply a bundle, can contain one or more image processing filters. If the image unit is installed in one of the locations shown in Table 2-1, then it can be used by any application that calls one of the load methods provided by the CIPlugin class and shown in Table 2-1. You need to load image units only once. For example, to load all globally installed image units, you could add the following line of code to an initialization routine in your application.

  [CIPlugIn loadAllPlugIns];

After calling the load method, you proceed the same as you would for using any of the image processing filters provided by Apple. Follow the instructions in the rest of this chapter.

**Table 2-1** Methods used to load image units
Method	Comment
`loadAllPlugIns`	Scans image unit directories (`/Library/Graphics/Image Units` and `~/Library/Graphics/Image Units`) for files that have the `.plugin` extension and then loads the image unit.
`loadNonExecutablePlugIns`	Scans image unit directories (`/Library/Graphics/Image Units` and `~/Library/Graphics/Image Units`) for files that have the `.plugin` extension and then loads only the kernels of the image unit. That is, it loads only those files that have the `.cikernel` extension. This call does not execute any of the image unit code.
`loadPlugIn:allowNonExecutable:`	Loads the image unit at the location specified by the `url` argument. Pass `true` for the `allowNonExecutable` argument if you want to load only the kernels of the image unit without executing any of the image unit code.

< Previous PageNext Page >

Hide TOC

Last updated: 2008-06-09

Did this document help you?
Yes: Tell us what works for you. It’s good, but: Report typos, inaccuracies, and so forth. It wasn’t helpful: Tell us what would have helped.




	Get information on Apple products. Visit the Apple Store online or at retail locations. 1-800-MY-APPLE Copyright © 2007 Apple Inc. All rights reserved. \| Terms of use \| Privacy Notice