Adobe 65007312 Programming Guide - Page 41

CHAPTER 3: Creating Export and Publish Services Adding an export post-process action 41 Provider; for details of how to define these items and what they do, see the API Reference documentation and the Flickr plug-in. Adding an export post-process action An Export Filter Provider is a script that allows you to modify a photo after Lightroom performs the initial rendering, but before it is passed to it final export destination, by defining a post-process action. A post-process action can modify the rendered images, or can suppress the export of certain photos, based on any criteria that you define. The script is identified by the LrExportFilterProvider entry in the plug-in's Info.lua file. A single SDK export plug-in can define one or more Export Filter Providers, one or more Export Service Providers, or both. In any given export session, there must be exactly one Export Service Provider, but there can be any number of post-process actions (or none). A single Export Filter Provider can define multiple actions. Post-process actions are executed in a specific sequence, partly determined by user choices. If you set up a dependency using the requiresFilter option, the sequence of execution honors that dependency. While Export Service Providers can add multiple sections at either the top or the bottom of the Export dialog, each post-process action can provide only one section for the dialog, which is always inserted after Lightroom's built-in sections, and before any "bottom" sections defined by the Export Service Provider. Export Filter Providers cannot define presets of their own, but can be included in an Export Service preset; see "Creating an export or publish service" on page 35. A post-process action is inserted between Lightroom's initial rendering of photos and the writing of the rendered image files to their destination (either the default destination, or one provided by a plug-in's export service). A post-process action (or set of actions) can be applied to photos that are being exported to any destination; that is, an Export Filter Provider does not need to be part of the same plug-in that provides the export service. For details, see "How post-process actions are executed" on page 47 Inserting and removing actions When any plug-in defining a post-process action is loaded, the action appears in the Post-Process Actions section of the Export dialog, on the left below the Presets section. When you open the plug-in, the individual actions defined by the plug-in appear as choices below it. When you select an action, the Insert button is enabled, allowing you to insert the action into the processing queue. (You can also insert an action by double-clicking it.)