Adobe 65011817 Extended User Guide - Page 86

dom.fillSelectedPixels, dom.filterSelection

Page 86 highlights

Last updated 12/8/2009 EXTENDING FIREWORKS 82 The Document object dom.fillSelectedPixels() Availability Fireworks 3. Usage dom.fillSelectedPixels(clickPt, p1, p2, p3, bFillSelectionOnly, tolerance, edgemode, featherAmt) Arguments clickPt A point that specifies the x,y coordinates of the pixel to be filled or generated (see "Point data type" on page 8). p1, p2, and p3 Points that specify the fill-vector. These arguments are ignored if the current fill does not use a fillvector. bFillSelectionOnly If bFillSelectionOnly is true, the remaining arguments are ignored. If it is false, the current pixel selection is ignored, and a new one is generated using the values passed for tolerance, edgemode, and featherAmt. (This behavior is the same as if the Magic Wand tool were used at the clickPt location.) tolerance An integer between 0 and 255, inclusive, that specifies the tolerance for selecting pixels. edgemode Acceptable values are "hard edge", "antialias", and "feather". featherAmt An integer between 0 and 32,000, inclusive, that specifies the number of pixels to feather. This value is ignored if the value of edgemode is not "feather". Returns Nothing. Description When the selection is an image and Fireworks is in bitmap mode, this method fills the selected pixels with the current fill or generates a new pixel selection. Example The following command fills the selection with a hard edge, and the tolerance set to 32: fw.getDocumentDOM().fillSelectedPixels({x:207, y:199}, {x:207, y:199}, {x:207, y:199}, {x:207, y:199}, false, 32, "hard edge", 0); dom.filterSelection() Availability Fireworks 3. usage dom.filterSelection(LiveEffect) Arguments LiveEffect An Effect object (see "Effect object" on page 241).

  • 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
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328
  • 329
  • 330
  • 331
  • 332
  • 333
  • 334
  • 335
  • 336

82
EXTENDING FIREWORKS
The Document object
Las
t
up
d
a
ted
12/8/2009
dom.fillSelectedPixels()
Availability
Fireworks 3.
Usage
dom.fillSelectedPixels(
clickPt, p1, p2, p3, bFillSelectionOnly, tolerance, edgemode,
featherAmt)
Arguments
clickPt
A point that specifies the
x,y
coordinates of the pixel to be filled or generated (see “
Point data type
” on
page
8).
p1
,
p2
, and
p3
Points that specify the fill-vector. These arguments are ignored if the current fill does not use a fill-
vector.
bFillSelectionOnly
If
bFillSelectionOnly
is
true
, the remaining arguments are ignored. If it is
false
, the
current pixel selection is ignored, and a new one is generated using the values passed for
tolerance
,
edgemode
, and
featherAmt
. (This behavior is the same as if the Magic Wand tool were used at the
clickPt
location.)
tolerance
An integer between 0 and 255, inclusive, that specifies the tolerance for selecting pixels.
edgemode
Acceptable values are
"hard edge"
,
"antialias"
, and
"feather"
.
featherAmt
An integer between 0 and 32,000, inclusive, that specifies the number of pixels to feather. This value is
ignored if the value of
edgemode
is not
"feather"
.
Returns
Nothing.
Description
When the selection is an image and Fireworks is in bitmap mode, this method fills the selected pixels with the current
fill or generates a new pixel selection.
Example
The following command fills the selection with a hard edge, and the tolerance set to 32:
fw.getDocumentDOM().fillSelectedPixels({x:207, y:199}, {x:207, y:199}, {x:207, y:199},
{x:207, y:199}, false, 32, "hard edge", 0);
dom.filterSelection()
Availability
Fireworks 3.
usage
dom.filterSelection(
LiveEffect
)
Arguments
LiveEffect
An Effect object (see “
Effect object
” on page
241).