Initialization And Termination Functions For Services - Adobe 65007312 - Photoshop Lightroom Programmer's Manual

C 3: Creating Export and Publish Services
HAPTER

Initialization and termination functions for services

You can provide functions to be called when a post-process action or export destination defined by your
plug-in is selected or deselected in the Export or Publishing Manager dialog. To do so, the service
definition script for your Export Filter Provider or Export Service Provider should return these table entries,
which contain the function definitions:
startDialog = function( propertyTable ) ... end,
endDialog = function( propertyTable, why ) ... end,
The
startDialog
provided by this plug-in in the Export dialog, or when the destination is already selected when the
dialog is invoked, remembered from the previous export operation.
The
endDialog
Export dialog, or dismisses the Export dialog.
N : Similar entries can be supplied by a Plug-in Info Provider, although the definitions are slightly
OTE
different. Functions defined in a Plug-in Info Provider are executed only when the plug-in is selected in the
Plug-in Manager dialog, never from the Export dialog. See
Plug-in Manager" on page
The propertyTable parameter for both functions is a table which contains the most recent settings for your
export plug-in, including both settings that you have defined and Lightroom-defined export settings (see
"Remembering user choices" on page
the property table contains additional values that tell you about the publishing status; see
properties" on page
When your plug-in is deactivated, Lightroom calls your
following string values:
changedServiceProvider
ok
cancel
These are blocking calls. If you need to start a long-running task (such as network access), create a task
using the
function is called when the user chooses a post-process action or export destination
function is called when the user deselects the action or export destination in the
31.
67.
A different Export Service Provider was chosen as the export or publish
destination. Your plug-in is no longer active.
The user clicked the "Export" or "Save" button. The Export or Publishing
Manager dialog has closed.
The user clicked the "Cancel" button and the Export or Publishing Manager
dialog has closed without initiating the operation.
namespace. See
LrTasks
57). When your plug-in is being used as a publish service provider,
endDialog
For an export service, Lightroom begins exporting images through
your plug-in. Do not attempt to start uploading photos at this point;
use the
processRenderedPhotos
"Customizing the Export and Publishing Manager dialogs" on page
For a publish service, Lightroom creates a new publish service in the
Publish Services panel that can be used later to publish images
through your plug-in.
"Defining function contexts and tasks" on page
Defining an export service 38
"Initialization and termination functions for the
function with why set to one of the
callback function to do that. See
"Publish Service
52.
20.