Adobe 65007312 Programming Guide - Page 43

Action dependencies, An Export Service Provider that performs an FTP upload

Page 43 highlights

CHAPTER 3: Creating Export and Publish Services Adding an export post-process action 43 Action dependencies You can set up a dependency among a set of actions, such that one action actually performs the photo processing, and other actions in the set are used to determine the parameters for that operation. The one that performs the rendition is typically the only one that defines a filterRenderedPhotos() function. This main action is required by the others in the set. To declare the dependency, make the ID of the main action the value of the requiresFilter option for the dependent actions. Each post-process action can define a single section for the Export dialog. When the user selects an action, that action's dialog section is shown, along with that of the required filter, if there is one. For example, suppose your plug-in has defined: 1. MyAction, the main action that performs the filtering operation 2. Color, which allows the user to choose a color to be used by MyAction 3. Lines, which allows a user to choose line widths to be used by MyAction 4. An Export Service Provider that performs an FTP upload When the user chooses the FTP-upload export destination and clicks Export, the service provider requests an export rendition for each photo that is active at the time. If the user does not choose any actions, the request is satisfied directly by Lightroom using LrExportRendition. If the user inserts Color, the dialog shows both the section for defining a border, and the section for MyAction, which is required by Color. After making all the necessary choices for the chosen actions, the

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204

C
HAPTER
3: Creating Export and Publish Services
Adding an export post-process action
43
Action dependencies
You can set up a dependency among a set of actions, such that one action actually performs the photo
processing, and other actions in the set are used to determine the parameters for that operation. The one
that performs the rendition is typically the only one that defines a
filterRenderedPhotos()
function.
This main action is
required
by the others in the set. To declare the dependency, make the ID of the main
action the value of the
requiresFilter
option for the dependent actions.
Each post-process action can define a single section for the Export dialog. When the user selects an action,
that action’s dialog section is shown, along with that of the required filter, if there is one.
For example, suppose your plug-in has defined:
1.
MyAction, the main action that performs the filtering operation
2.
Color, which allows the user to choose a color to be used by MyAction
3.
Lines, which allows a user to choose line widths to be used by MyAction
4.
An Export Service Provider that performs an FTP upload
When the user chooses the FTP-upload export destination and clicks
Export
, the service provider requests
an export rendition for each photo that is active at the time. If the user does not choose any actions, the
request is satisfied directly by Lightroom using
LrExportRendition
.
If the user inserts Color, the dialog shows both the section for defining a border, and the section for
MyAction, which is required by Color. After making all the necessary choices for the chosen actions, the