# plugins.finalcutpro.timeline.titles

Controls Final Cut Pro's Titles.

# API Overview

Functions - API calls offered directly by the extension


Signature	`plugins.finalcutpro.timeline.titles.apply(action) -> boolean`
Type	Function
Description	Applies the specified action as a title.
Parameters	`action` - A table with the name/category/theme for the title to apply, or a string with just the name.
Returns	`true` if a matching title 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 title 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/titles.lua line 30