Adobe Photoshop Lightroom SDK 4 Programmers Guide

3y ago
15 Views
2 Downloads
6.81 MB
207 Pages
Last View : 1m ago
Last Download : 3m ago
Upload by : Noelle Grant
Transcription

LIGHTROOM CLASSICPROGRAMMERS GUIDE

Copyright 2020 Adobe Inc. All rights reserved.Adobe Photoshop Lightroom Classic SDK Programmers GuideIf this guide is distributed with software that includes an end user agreement, this guide, as well as the softwaredescribed in it, is furnished under license and may be used or copied only in accordance with the terms of such license.Except as permitted by any such license, no part of this guide may be reproduced, stored in a retrieval system, ortransmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior writtenpermission of Adobe Inc. Please note that the content in this guide is protected under copyright law even if it is notdistributed with software that includes an end user license agreement.The content of this guide is furnished for informational use only, is subject to change without notice, and should not beconstrued as a commitment by Adobe Inc. Adobe Inc assumes no responsibility or liability for any errors or inaccuraciesthat may appear in the informational content contained in this guide.Please remember that existing artwork or images that you may want to include in your project may be protected undercopyright law. The unauthorized incorporation of such material into your new work could be a violation of the rights ofthe copyright owner. Please be sure to obtain any permission required from the copyright owner.Any references to company names in sample templates are for demonstration purposes only and are not intended torefer to any actual organization.Adobe, the Adobe logo, Photoshop, Lightroom, and Flash are either registered trademarks or trademarks of Adobe Incin the United States and/or other countries.Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United Statesand/or other countries. Apple, Mac, Mac OS, and Macintosh are trademarks of Apple Computer, Incorporated, registeredin the United States and other countries. Sun and Java are trademarks or registered trademarks of Sun Microsystems,Incorporated in the United States and other countries. UNIX is a registered trademark of The Open Group in the US andother countries.All other trademarks are the property of their respective owners.Adobe Inc, 345 Park Avenue, San Jose, California 95110, USA. Notice to U.S. Government End Users. The Software andDocumentation are “Commercial Items,” as that term is defined at 48 C.F.R. §2.101, consisting of“Commercial Computer Software” and “Commercial Computer Software Documentation,” as such terms are used in 48C.F.R. §12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §§227.7202-1 through227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation arebeing licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights as are grantedto all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyrightlaws of the United States. Adobe Inc, 345 Park Avenue, San Jose, CA 95110-2704, USA. For U.S. Government End Users,Adobe agrees to comply with all applicable equal opportunity laws including, if appropriate, the provisions of ExecutiveOrder 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment Assistance Act of 1974 (38 USC 4212),and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 60-1 through 60-60,60-250, and 60-741. The affirmative action clause and regulations contained in the preceding sentence shall beincorporated by reference.

ContentsPreface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8The Lightroom SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8The Lua language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9About this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Conventions used in this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Using the Lightroom SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Writing plug-ins for Lightroom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11The Lightroom SDK scripting environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Namespaces, classes, and objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Defining function contexts and tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Including scripts with require() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Lua syntax notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21212202021Writing a Lightroom Plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Writing standard plug-ins for Lightroom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Declaring the contents of a plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Delivering a standard plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Debugging standard plug-ins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23232932Customizing plug-in load behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Initialization and termination functions for the Plug-in Manager . . . . . . . . . . . . . . . . . . . . . . 34Adding custom sections to the Plug-in Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Defining menu items for a plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353Creating Export and Publish Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Creating an export or publish service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Defining an export service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Initialization and termination functions for services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Defining a publish service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Publish service options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Adding an export post-process action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Inserting and removing actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Action dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Declaring export post-process actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Defining a post-process action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Removing photos from the export operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Defining post-processing of rendered photos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .How post-process actions are executed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4343454647484850Final processing of rendered photos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Customizing the Export and Publishing Manager dialogs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Customizing the export destination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553

4ContentsAdding custom sections to the Export or Publishing Manager dialog . . . . . . . . . . . . . . . . . 56Restricting existing service functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58Remembering user choices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Export presets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Settings for publish services and post-process actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Lightroom built-in property keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Export Location section properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .File Naming section properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .File Settings section properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Image Sizing section properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Output Sharpening section properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Metadata section properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Video section properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Watermarking section properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Post-Processing Filter section properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .General export properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Publish Service properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4616262666768686969697070Working with Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Adding custom metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Declaring a Metadata Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Defining metadata fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Adding custom metadata tagsets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Defining a metadata tagset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Searching for photos by metadata values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Combining search criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Creating searches interactively . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 835Creating a User Interface for Your Plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Adding custom dialog views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Using dialog boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Displaying predefined dialog boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Creating custom dialog boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87User interface elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Containers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .View properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87878893Binding UI values to data values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97Specifying bindings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Creating observable property tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100Bindings for selection controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Complex bindings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Determining layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110Relative placement of sibling nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Placement within the parent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Factory functions for obtaining layout values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112Layout examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

5Contents6Writing a Web-engine Plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118Creating a web-engine plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118Folder contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118Defining the data model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119GalleryInfo top-level entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120Data model entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121Defining a UI for your model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123Creating a dynamic data model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127Creating a preview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128Web SDK manifest API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130LuaPage syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136Environment variables available to LuaPages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136LuaPage data types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137Web SDK tagsets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138Defining custom tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138Using custom tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139Lightroom built-in tagset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140Web HTML Live Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142Defining messages from Lightroom to a previewed page . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143Defining messages from a previewed page to Lightroom . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1457Using ZStrings for Localization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148ZString format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148ZString characters and escape sequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149The LOC function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150Localization dictionary files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151Localization dictionary file format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151Example dictionary file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152Supported languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1528SDK Sample Plug-ins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153The FTP Upload sample plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154Bring up the FTP plug-in . . . . . . . . . . .

Adobe Photoshop Lightroom Classic SDK Programmers Guide If this guide is distributed with software that includes an end user agreement, this guide, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license.

Related Documents:

adobe photoshop lightroom 5 - quick start guide www.lightroomqueen.comlrquickstart 3 table of contents 3 introduction 4 before you start 5 basic lightroom workflow 8 installing lightroom 10 getting photos into lightroom 15 backing up lightroom 23 the lightroom workspace 26 viewing your photos in lightroom 30 selecting the best photos 38

Adobe Photoshop Lightroom CC 6.5.1 Multilingual SadeemPC serial . COM IS THE BEST WAY TO FIND CRACKS, SERIAL NUMBERS, KEYGENs. Play and trim clips, extract still images from them or adjust clips with the Quick Develop tool. Adobe Photoshop Lightroom Classic Crack. Adobe Lightroom CC . Adobe Lightroom CC 6.10 Crack Serial Number 2017 .

photos. Lightroom underwent some pretty major changes in those early stages as the team tried out different workflow ideas, until eventually we ended up with the Lightroom program you see now. The Adobe Photoshop Lightroom CC / Lightroom 6 Book represents the culmina-tion of more than nine years’ work in which I have been involved with Lightroom.

does not launch automatically, double- click DVD Volume: Lightroom 4\Install Lightroom 4 (Windows) or Adobe Photoshop Lightroom 4.pkg (Mac OS) at the root level of your disk to start the installation process. 2. If you downloaded the software from the web, open the folder and double- click Adobe Photoshop Lightroom (Windows or Mac OS), and then .

The Lightroom 3 catalog upgrade process does not erase or remove your previous Lightroom catalogs. If you wish to try the Lightroom 3 30-day trial by upgrading your existing catalog, you may always return to earlier versions of Lightroom and continue . 6 . Working with Lightroom 3 and Adobe Photoshop Camera Raw

4 Choose Lightroom Preferences Presets (Mac OS) or Edit Preferences Presets (Windows). 5 Select Show Lightroom Presets Folder, and open the selected Lightroom folder. 6 Copy the config.lua file into the Lightroom folder. 7 Quit Lightroom, then restart Lightroom. config.lua.zip (Optional) Determine if the file is installed correctly. 1 .

The Lightroom 5 upgrade process detects the Mac App Store version of Lightroom 4 installed on your computer, and requests the upgrade serial number. After Lightroom 5 is installed, you can uninstall Lightroom 4. See this TechNote for assistance in uninstalling Lightroom. Upgrading from Mac App Store Lightroom 4 to version 6 The steps above do .

Lightroom 4 Lightroom 4-Handbuch (PDF) Lightroom 3 Lightroom 3-Handbuch (PDF) Lightroom 2 Lightroom 2-Handbuch (PDF) Workflows Ein Teil des Inhalts, zu dem von dieser Seite verlinkt wird, wird u. U. nur auf Englisch angezeigt. Importieren von Fotos in Lightroom: Grundlegender Workflow