Adobe 12040118 Using Help - Page 110

LayerCollection, LayerCollection add() method

Page 110 highlights

Help Using Help Reference Back 110 LayerCollection app.project.item(index).lcoll Description The Layer Collection represents a collection of layers. Each CompItem object contains one LayerCollection. The LayerCollection attributes and methods provide access to and the ability to add new layers. Attributes length the number of objects in the collection (applies to all collections) Methods Method [] add() addNull() addSolid() a d d Tex t ( ) addCamera() addLight() byName() precompose() Reference Description (no cross-reference) retrieves an object or objects in the collection via its index number see "LayerCollection add() method" on creates a new AVLayer containing the given page 110 AVItem and adds it to the CompItem see "LayerCollection addNull() method" layer returned is a newly created layer in the on page 112 Comp that owns the LayerCollection see "LayerCollection addSolid() method" on page 112 creates a new FootageItem that has a SolidSource according to the specified parameters, and adds it to the project see "LayerCollection addText() method" creates a new Text layer with the specified on page 113 source text see "LayerCollection addCamera() method" on page 111 creates a new Camera layer with the specified name and center point see "LayerCollection addLight() method" on page 111 creates a new Light layer with the specified name and center point see "LayerCollection byName() method" returns the first layer found with the given on page 113 name see "LayerCollection precompose() method" on page 113 collects the layers referred to by the indices given in layerIndices, and puts them into a new CompItem with the given name Example Given that the first item in the project is a CompItem and the second item in the project is an AVItem, the following code shows how to display the number of layers in the CompItem's layer collection, add a new layer based on an AVItem in the project, and then display the new number of layers in the layer collection. var firstComp = app.project.item(1); var layerCollection = firstComp.layers; alert( "number of layers before is " + layerCollection.length); var anAVItem = app. project.item(2); l ayer Co l l e c t i o n . a d d ( a n AV Item ) ; alert( "number of layers after is " + layerCollection.length); LayerCollection add() method app.project.item(index).lcoll.add(item, duration) Using Help Back 110

  • 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

U
sing H
elp
B
ack
110
Help
Reference
U
sing H
elp
B
ack
110
LayerCollection
app.project.item(index).
lcoll
Description
The Layer Collection represents a collection of layers. Each CompItem object contains one LayerCollection.
The LayerCollection attributes and methods provide access to and the ability to add new layers.
Attributes
Methods
Example
Given that the first item in the project is a CompItem and the second item in the project is an AVItem, the
following code shows how to display the number of layers in the CompItem's layer collection, add a new layer
based on an AVItem in the project, and then display the new number of layers in the layer collection.
var firstComp = app.project.item(1);
var layerCollection = firstComp.layers;
alert( "number of layers before is " + layerCollection.length);
var anAVItem = app.project.item(2);
layerCollection.add(anAVItem);
alert( "number of layers after is " + layerCollection.length);
LayerCollection add() method
app.project.item(index).lcoll
.add(
item, duration
)
length
the number of objects in the collection (applies to all collections)
Method
Reference
Description
[]
(no cross-reference)
retrieves an object or objects in the collection
via its index number
add()
see “LayerCollection add() method” on
page 110
creates a new AVLayer containing the given
AVItem and adds it to the CompItem
addNull()
see “LayerCollection addNull() method”
on page 112
layer returned is a newly created layer in the
Comp that owns the LayerCollection
addSolid()
see “LayerCollection addSolid()
method” on page 112
creates a new FootageItem that has a Solid-
Source according to the specified parameters,
and adds it to the project
addText()
see “LayerCollection addText() method”
on page 113
creates a new Text layer with the specified
source text
addCamera()
see “LayerCollection addCamera()
method” on page 111
creates a new Camera layer with the specified
name and center point
addLight()
see “LayerCollection addLight()
method” on page 111
creates a new Light layer with the specified
name and center point
byName()
see “LayerCollection byName() method”
on page 113
returns the first layer found with the given
name
precompose()
see “LayerCollection precompose()
method” on page 113
collects the layers referred to by the indices
given in layerIndices, and puts them into a new
CompItem with the given name