ItemCollection object
app.project.items
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.
Methods
| Method | Description |
|---|---|
| addComp() | Creates a new CompItem object and adds it to the collection. |
| addFolder() | Creates a new FolderItem object and adds it to the collection. |
Detailed Descriptions
addComp() method
app.project.items.addComp(name, width, height, pixelAspect, duration, frameRate)
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.
- width The width of the composition in pixels, an integer in the range [4..30000].
- height The height of the composition in pixels, an integer in the range [4..30000].
- pixelAspect The pixel aspect ratio of the composition, a floating-point value in the range [0.01..100.0].
- duration The duration of the composition in seconds, a floating-point value in the range [0.0..10800.0].
- frameRate The frame rate of the composition, a floating-point value in the range [1.0..99.0]
Returns CompItem object.
addFolder() method
app.project.items.addFolder(name)
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 object’s parentFolder attribute; see “Item parentFolder attribute” on page 80.
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
// compItem’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;
}