# plugins.finalcutpro.timeline.generators

Controls Final Cut Pro's Generators.

# API Overview

Functions - API calls offered directly by the extension


Signature	`plugins.finalcutpro.timeline.generators.apply(action) -> boolean`
Type	Function
Description	Applies the specified action as a generator.
Parameters	`action` - A table with the name/category/theme for the generator to apply, or a string with just the name.
Returns	`true` if a matching generator was found and applied to the timeline.
Notes	Expects action to be a table with the following structure: `lua</li><li>{ name = "XXX", category = "YYY", theme = "ZZZ" }</li><li>` ...where `"XXX"`, `"YYY"` and `"ZZZ"` are in the current FCPX language. The `category` and `theme` are optional, but if they are known it's recommended to use them, or it will simply execute the first matching generator with that name. Alternatively, you can also supply a string with just the name. Actions will be cached each session, so that if the user applies the effect multiple times, only the first time will require GUI scripting - subsequent uses will just use the Pasteboard.
Examples	None
Source	src/plugins/finalcutpro/timeline/generators.lua line 27