Adobe 65011817 Extended User Guide - Page 256

ElementMask object

Page 256 highlights

Last updated 12/8/2009 EXTENDING FIREWORKS 252 Objects within Fireworks documents Property textRuns textureOffset transformMode rawTop rawLeft rawWidth rawHeight Data type object point string float float float float Notes TextRuns object (for more information, see "TextRuns object" on page 268). If the text has a textured brush or fill, specifies the offset of the texture's origin. Acceptable values are "paths" and "pixels". Top space occupied by the pixels (not the top location of the bounding box). Leftmost space occupied by the pixels (not the left location of the bounding box). Width of the area occupied by the pixels (not the area of the bounding box). Height of the area occupied by the pixels (not the area of the bounding box). Texture object The Texture object has the following read-only property. Property (read-only) name Data type string Notes The name that appears in the Brush or Fill panels. ElementMask object The following table lists the properties of the ElementMask object, along with their data types and, where appropriate, acceptable values and notes. Property autoExpandImages element enabled linked Data type Boolean object Boolean Boolean Notes If set to true, and the element mask is an image, the image is automatically expanded to fill the entire document, with areas "outside" the image showing through. If set to false (or if the element mask is not an image), areas "outside" the element mask are knocked out. Element object (for more information, see "Element object" on page 247). If set to true, the mask applies to the element. If set to false, the mask remains present but does not visually affect the element in any way. Default value is true. If set to true, moving the mask moves the element that owns it, and vice versa. If set to false, moving the mask does not affect the element that owns it (and moving the element does not affect the mask). Default value is true.

  • 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

252
EXTENDING FIREWORKS
Objects within Fireworks documents
Las
t
up
d
a
ted
12/8/2009
Texture object
The Texture object has the following read-only property.
ElementMask object
The following table lists the properties of the ElementMask object, along with their data types and, where appropriate,
acceptable values and notes.
textRuns
object
TextRuns object (for more information, see “
TextRuns object
on page
268).
textureOffset
point
If the text has a textured brush or fill, specifies the offset of the
texture’s origin.
transformMode
string
Acceptable values are
"paths"
and
"pixels"
.
rawTop
float
Top space occupied by the pixels (not the top location of the
bounding box).
rawLeft
float
Leftmost space occupied by the pixels (not the left location of
the bounding box).
rawWidth
float
Width of the area occupied by the pixels (not the area of the
bounding box).
rawHeight
float
Height of the area occupied by the pixels (not the area of the
bounding box).
Property (read-only)
Data type
Notes
name
string
The name that appears in the Brush or Fill panels.
Property
Data type
Notes
autoExpandImages
Boolean
If set to
true
, and the element mask is an image, the image is
automatically expanded to fill the entire document, with areas
“outside” the image showing through. If set to
false
(or if the
element mask is not an image), areas “outside” the element
mask are knocked out.
element
object
Element object (for more information, see “
Element object
” on
page
247).
enabled
Boolean
If set to
true
, the mask applies to the element. If set to
false
,
the mask remains present but does not visually affect the
element in any way. Default value is
true
.
linked
Boolean
If set to
true
, moving the mask moves the element that owns
it, and vice versa. If set to
false
, moving the mask does not
affect the element that owns it (and moving the element does
not affect the mask). Default value is
true
.
Property
Data type
Notes