javascript
app.project.items
Description
The ItemCollection object represents a collection of items. The ItemCollection belonging to a Project object contains all the Item objects for items in the project. The ItemCollection belonging to a FolderItem object contains all the Item objects for items in that folder.
ItemCollection is a subclass of
Collection
. All methods and attributes of Collection, in addition to those listed below, are available when working with ItemCollection.
app.project.items.addComp(name, width, height, pixelAspect, duration, frameRate)
Description
Creates a new composition. Creates and returns a new CompItem object and adds it to this collection. If the ItemCollection belongs to the project or the root folder, then the new item's parentFolder
is the root folder. If the ItemCollection belongs to any other folder, the new item's parentFolder
is that FolderItem
.
Parameters
name |
A string containing the name of the composition. |
|
The width of the composition in pixels, an integer in the range |
|
The height of the composition in pixels, an integer in the range |
|
The pixel aspect ratio of the composition, a floating-point value in the range |
|
The duration of the composition in seconds, a floating-point value in the range |
|
The frame rate of the composition, a floating-point value in the range |
Returns
CompItem object.
app.project.items.addFolder(name)
Description
Creates a new folder. Creates and returns a new FolderItem object and adds it to this collection. If the ItemCollection belongs to the project or the root folder, then the new folder's parentFolder
is the root folder. If the ItemCollection belongs to any other folder, the new folder's parentFolder
is that FolderItem
. To put items in the folder, set the item.parentFolder
attribute
Parameters
name |
A string containing the name of the folder. |
Returns
FolderItem object.
Example
This script creates a new FolderItem in the Project panel and moves compositions into it.
//create a new FolderItem in project, with name "comps"
var compFolder = app.project.items.addFolder("comps");
//move all compositions into new folder by setting
//comp Item's parentFolder to "comps" folder
for (var i = 1; i <= app.project.numItems; i++) {
if (app.project.item(i) instanceof CompItem) {
app.project.item(i).parentFolder = compFolder;
}
}