3. Items

Compositions

Here's how to create a basic 1280 x 720, 24 fps, square pixels comp with a black background.

comps:
  - name: The composition’s name
    width: 1280
    height: 720
    pixelAspect: 1
    duration: 10
    framerate: 24
    color: [0, 0, 0]

In the example above, the composition will be stored in your project structure and be available in your project panel. Now what if you want to stage your composition as a layer inside of another composition?

comps:
  - name: The master comp
  - name: The child comp
    parentComp: The master comp

As soon as the composition has a parentComp attribute, Hyle stages it inside of its parent.

The above example is really short and is missing most properties we stated previously. That's normal. There are default settings on which Hyle falls back if when a property isn't mentioned. Read more about defaults.

Folders

Folders were given a special shorthand syntax to simplify writing and improve elegance and readability.

folders:
  - folder 1
  - | folder 1.1
  - | | folder 1.1.1
  - | folder 1.2
  - folder 2
  - | folder 2.1
  - folder 3

Of course, the usual syntax will also work.

folders:
  - name: folder 1
  - name: folder 1.1
    parentFolder: folder 1
  - name: folder 1.1.1
    parentFolder: folder 1.1
  - name: folder 2
  - name: folder 2.1
    parentFolder: folder 2
  - name: folder 3

As seen above, parentFolder is used to specify the parent folder which value can be a name or an id (learn more about pointing to an item or layer).