Home » Adobe Manuals » Computer Software » Adobe 65007312 » Manual Viewer

Adobe 65007312 Programming Guide - Page 50

Stage 4: Processing rendered photos, Defining post-processing, of rendered photos

UPC - 883919154398

Add to My Manuals
Save this manual to your list of manuals

Page 50 highlights

CHAPTER 3: Creating Export and Publish Services Adding an export post-process action 50 5. For each filter, if a postProcessRenderedPhotos() function is defined, it is called. The function is called only once, regardless of the number of photos being exported. This function should enter into a loop of the form: for sourceRendition, renditionToSatisfy in filterContext:renditions() do ... end Z The filter context object generates a new rendition request (LrExportRendition) for each of the renditions provided this filter. Z The renditions() iterator provides two values: sourceRendition (the new rendition to be satisfied by the upstream provider) and renditionToSatisfy (the corresponding rendition that this filter is expected to satisfy for its downstream consumer). ADVANCED: If the filter provider wishes to request a different file format than it is expected to satisfy, it can do so using the renditionOptions/filterSettings code snippet shown in "Defining post-processing of rendered photos" on page 46. This might be a good idea as a way to avoid re-encoding (and thus degrading) JPEG files. If you do this, you are still responsible for providing an output file in the exact format and location required by renditionToSatisfy. Z The filter must wait for each rendition to be completed by its upstream provider by calling sourceRendition:waitForRender(). (We will discuss the completion of this loop in Stage 4.) If there is no processRenderedPhotos() function defined by this filter, the filter is simply left out of the loop and all rendition requests instead go to the upstream provider. IMPORTANT: Each filter must generate a photo conforming exactly to the specifications provided to it. In particular, it must provide a suitable photo file in the specified format and at the exact path specified by the downstream consumer. If it cannot do so, it must use renditionToSatisfy:renditionIsDone( false, message ) to indicate why not. It must never provide a file of a different format than that requested. 6. After all of the filters have had an opportunity to intercept the rendition requests, the requests are finally passed to Lightroom's built-in rendering engine. Stage 4: Processing rendered photos As Lightroom completes each rendition request, it signals completion by allowing the corresponding rendition:waitForRender() call to complete. The rendering loops described in stage 3 then finish in top-to-bottom sequence for each photo. For each filter that defines the postProcessRenderedPhotos() function: 1. The waitForRender() call completes, meaning that the upstream provider has completed its attempt to render the photo. If that attempt was successful, a valid photo file conforming to the specifications requested by this filter is present at the path specified by the sourceRendition; that is, specified by this filter when it requested the rendition from its upstream provider. 2. The filter can now do whatever processing it needs to do on that file. This typically means invoking a third-party application using LrTasks.execute(). ADVANCED: If the filter has changed the file format or location on disk using renditionOptions, it must now perform the appropriate operations on the file to convert it so that it now satisfies the request as specified in renditionToSatisfy.

Section	Page
Lightroom SDK 3.0	1
Preface	8
The Lightroom SDK	8
The Lua language	9
About this document	9
Conventions used in this document	10
Using the Lightroom SDK	11
Writing plug-ins for Lightroom	11
The Lightroom SDK scripting environment	12
Namespaces, classes, and objects	12
Accessing namespace functions directly	12
Creating objects	14
Accessing object functions and properties	18
Using function contexts for error handling	18
Using built-in Lua features	19
Defining function contexts and tasks	20
Including scripts with require()	20
Lua syntax notes	21
Writing a Lightroom Plug-in	22
Writing standard plug-ins for Lightroom	22
Declaring the contents of a plug-in	22
The loader environment	26
Delivering a standard plug-in	27
Automatic plug-in loading	29
Debugging standard plug-ins	30
Customizing plug-in load behavior	30
Initialization and termination functions for the Plug-in Manager	31
Adding custom sections to the Plug-in Manager	32
Defining menu items for a plug-in	33
Creating Export and Publish Services	35
Creating an export or publish service	35
Defining an export service	35
Initialization and termination functions for services	38
Defining a publish service	39
Publish service options	40
Adding an export post-process action	41
Inserting and removing actions	41
Action dependencies	43
Declaring export post-process actions	44
Defining a post-process action	45
Removing photos from the export operation	46
Defining post-processing of rendered photos	46
How post-process actions are executed	47
Stage 1: Deciding how the photos should be rendered	49
Stage 2: Deciding what photos should be rendered	49
Stage 3: Requesting renditions	49
Stage 4: Processing rendered photos	50
Stage 5: Error reporting and clean up	51
Final processing of rendered photos	51
Customizing the Export and Publishing Manager dialogs	52
Customizing the export destination	52
Adding custom sections to the Export or Publishing Manager dialog	53
A custom section example	54
Restricting existing service functionality	55
Remembering user choices	57
Export presets	58
Settings for publish services and post-process actions	59
Lightroom built-in property keys	59
Export Location section properties	59
File Naming section properties	60
Token patterns	60
File Settings section properties	64
Image Sizing section properties	65
Output Sharpening section properties	66
Metadata section properties	66
Watermarking section properties	66
Post-Processing Filter section properties	67
General export properties	67
Publish Service properties	67
Working with Metadata	68
Adding custom metadata	68
Declaring a Metadata Provider	68
Defining metadata fields	69
Metadata field entries	70
Custom metadata example	71
Adding custom metadata tagsets	73
Defining a metadata tagset	74
Custom metadata tagset example	75
Searching for photos by metadata values	75
Combining search criteria	79
Creating searches interactively	80
Creating a User Interface for Your Plug-in	82
Adding custom dialog views	82
Using dialog boxes	83
Displaying predefined dialog boxes	83
Creating custom dialog boxes	84
User interface elements	84
Containers	84
Controls	85
View properties	90
General view properties	91
Control node view properties	92
Edit-field view properties	92
Text view properties	94
Binding UI values to data values	94
Specifying bindings	95
Simple bindings	96
Creating observable property tables	97
Adding observers to tables	97
Bindings for selection controls	98
Binding checkbox selections	98
Binding radio button selections	99
Binding pop-up menu selections	100
Binding combo box selections	101
Complex bindings	103
Transforming values	103
Binding multiple keys	105
Determining layout	107
Relative placement of sibling nodes	108
Placement within the parent	108
Factory functions for obtaining layout values	109
Layout examples	110
Building a basic dialog	110
Making labels line up	111
Changing the contents of a view dynamically	112
Writing a Web-engine Plug-in	115
Creating a web-engine plug-in	115
Folder contents	115
Defining the data model	116
GalleryInfo top-level entries	117
Data model entries	118
Defining a UI for your model	120
Using web view factories	122
Customizing per-image text	123
Localizing the UI	124
Creating a dynamic data model	124
Creating a preview	125
Creating the Flash movie	126
Web SDK manifest API	127
AddPage	127
AddResource	127
AddResources	128
AddPhotoPages	128
AddGridPages	129
AddCustomCSS	130
IdentityPlate	131
importTags()	132
LuaPage syntax	133
Environment variables available to LuaPages	133
LuaPage data types	134
Web SDK tagsets	135
Defining custom tags	135
Using custom tags	136
Custom tag example	136
Lightroom built-in tagset	137
Thumbnail grid tags	137
Pagination tags	138
Web HTML Live Update	139
Defining messages from Lightroom to a previewed page	140
Returning values from live-update functions	140
document.liveUpdate	141
document.liveUpdateImageSize	141
Example live-update implementation	142
Defining messages from a previewed page to Lightroom	142
Specifying in-place edit	143
Using ZStrings for Localization	145
ZString format	145
ZString characters and escape sequences	146
The LOC function	147
Localization dictionary files	148
Localization dictionary file format	148
Example dictionary file	149
Supported languages	149
SDK Sample Plug-ins	150
The FTP Upload sample plug-in	151
Bring up the FTP plug-in	151
Configure the connection	152
Establish the connection	154
The Flickr plug-in	155
The Flickr API	155
Flickr plug-in walkthrough	155
Add photos and publish the collection	157
Publish modified photos	159
Get feedback from viewers	160
Metadata and filtering samples	161
Custom metadata sample walkthrough	161
Metadata filter sample	162
Post-processing samples	164
Post-processing actions walkthrough	164
Web engine sample	166
Getting Started: A Tutorial Example	168
Creating an export plug-in	168
Create the information file	168
Create the service scripts	169
Displaying a dialog	169
Displaying a custom dialog	170
Create a properties table for program data	170
Create UI elements	171
Run the plug-in	172
Transforming data	173
Create multiple bindings to one key	173
Run the plug-in	175
Binding to multiple keys	175
Create multiple bindings to one key	175
Run the plug-in	178
Adding a data observer	180
Set up the dialog and table	180
Create an observer for a data property	181
Create the dialog contents	181
Run the plug-in	182
Debugging your plug-in	183
Specifying a log	183
Viewing trace information using log files	184
Viewing trace information in a platform console	184
Debugging in Windows WinDbg	184
Debugging in Mac OS Console	186
Defining Metadata: A Walkthrough	187
Adding custom metadata	187
Define metadata fields	187
Define a tagset	189
Using the plug-in	190
Customizing the Plug-in Manager	192
Web Gallery Plug-ins: A Tutorial Example	195
Creating a Web Gallery plug-in	195
Add descriptive files	195
Add HTML template files	196
Add subfolders	196
Defining a data model and functionality	197
Add a grid using built-in tags	198
Add pagination using built-in tags	198
Add another photo size	199
Add the “large” photo size	199
Add link functionality	200
Define the large-image frame template	200
Customizing the Web Gallery UI	201
Add a binding to a control	201
Add the title to the HTML template	202
Testing the plug-in	202
Adding a customized tagset	202
Define the tags	203

Match case Limit results 1 per page

HAPTER

3: Creating Export and Publish Services

Adding an export post-process action

For each filter, if a

postProcessRenderedPhotos()

function is defined, it is called. The function is

called only once, regardless of the number of photos being exported.

This function should enter into a loop of the form:

for sourceRendition, renditionToSatisfy in filterContext:renditions() do ... end

The filter context object generates a new rendition request (

LrExportRendition

) for each of the

renditions provided this filter.

The

renditions()

iterator provides two values:

sourceRendition

(the new rendition to be

satisfied by the upstream provider) and

renditionToSatisfy

(the corresponding rendition that

this filter is expected to satisfy for its downstream consumer).

DVANCED

If the filter provider wishes to request a different file format than it is expected to satisfy, it can

do so using the

renditionOptions/filterSettings

code snippet shown in

“Defining post-processing

of rendered photos” on page 46

. This might be a good idea as a way to avoid re-encoding (and thus

degrading) JPEG files. If you do this, you are still responsible for providing an output file in the exact format

and location required by

renditionToSatisfy

The filter must wait for each rendition to be completed by its upstream provider by calling

sourceRendition:waitForRender()

. (We will discuss the completion of this loop in Stage 4.)

If there is no

processRenderedPhotos()

function defined by this filter, the filter is simply left out of

the loop and all rendition requests instead go to the upstream provider.

MPORTANT

Each filter must generate a photo conforming exactly to the specifications provided to it. In

particular, it must provide a suitable photo file in the specified format and at the exact path specified by

the downstream consumer. If it cannot do so, it must use

renditionToSatisfy:renditionIsDone(

false,

message

)

to indicate why not. It must never provide a file of a different format than that

requested.

After all of the filters have had an opportunity to intercept the rendition requests, the requests are

finally passed to Lightroom's built-in rendering engine.

Stage 4: Processing rendered photos

As Lightroom completes each rendition request, it signals completion by allowing the corresponding

rendition:waitForRender()

call to complete.

The rendering loops described in stage 3 then finish in top-to-bottom sequence for each photo. For each

filter that defines the

postProcessRenderedPhotos()

function:

The

waitForRender()

call completes, meaning that the upstream provider has completed its attempt

to render the photo. If that attempt was successful, a valid photo file conforming to the specifications

requested by this filter is present at the path specified by the

sourceRendition

; that is, specified by

this filter when it requested the rendition from its upstream provider.

The filter can now do whatever processing it needs to do on that file. This typically means invoking a

third-party application using

LrTasks.execute()

DVANCED

If the filter has changed the file format or location on disk using

renditionOptions

, it must

now perform the appropriate operations on the file to convert it so that it now satisfies the request as

specified in

renditionToSatisfy