Initialization And Termination Functions For The Plug-In Manager - Adobe 65007312 - Photoshop Lightroom Programmer's Manual

C 2: Writing a Lightroom Plug-in
HAPTER
Item
sectionsForTopOfDialog
sectionsForBottomOfDialog
LrInitPlugin
initialize values in your plug-in's global function environment, which are protected from garbage
collection. When the plug-in is reloaded, a new environment is created. All previous values are
discarded and this function is executed again.
LrShutdownPlugin
private data.
LrPluginInfoUrl
plug-in. This URL is displayed in the Status section of the Plug-in Manager dialog when your plug-in is
loaded and selected. The URL is also displayed as part of the error message if your plug-in fails to load
properly or cannot be found.
LrEnablePlugin
or disabled in the Plug-in Manager dialog.
For example:
return {
LrSdkVersion = 3.0,
LrSdkMinimumVersion = 2.0, -- minimum SDK version required by this plug-in
LrToolkitIdentifier = 'com.adobe.lightroom.sample.plug-in-info',
LrPluginName = LOC "$$$/PluginInfo/Name=Plug-in Info Sample",
LrPluginInfoProvider = 'PluginInfoProvider.lua',
LrInitPlugin = 'PluginInit.lua',
LrPluginInfoUrl = 'http://www.mycompany.com/lrplugin_info.html',
}

Initialization and termination functions for the Plug-in Manager

In addition to the
provide functions to be called when your plug-in is selected or deselected. To do so, the service definition
script for your Plug-in Info Provider should return these table entries, which contain the function
definitions:
startDialog = function( propertyTable ) ... end,
endDialog = function( propertyTable ) ... end,
When the functions are defined in a Plug-in Info Provider:
The
startDialog
The
endDialog
N : These same entries can be supplied by an Export Service Provider, although the definitions are
OTE
slightly different. Functions defined in an Export Service Provider are executed only when the plug-in is
Description
Definitions for one or more new sections to display in the Plug-in
Manager dialog when your plug-in is selected in the dialog.
The same items can be defined in an Export Service Provider or
Export Filter Provider to customize the Export dialog when the
service or filter is selected or deselected there; see
sections to the Plug-in Manager" on page 32
points to a script that runs when the plug-in is loaded or reloaded. You can use this to
is a function runs when the plug-in is unloaded. You can use this to clean up
gives the URL of your web site, or a page that provides information about your
and
LrDisablePlugin
and
LrInitPlugin LrShutdownPlugin
function is called whenever your plug-in is selected in the Plug-in Manager.
function is called when the user deselects the plug-in in the Plug-in Manager.
provide functions to be called when your plug-in is enabled
scripts that are run on load and unload, you can
Customizing plug-in load behavior 31
"Adding custom
for details.