# plugins.finalcutpro.timeline.transitions

Controls Final Cut Pro's Transitions.

# API Overview

Functions - API calls offered directly by the extension


Signature	`plugins.finalcutpro.timeline.transitions(action) -> boolean`
Type	Function
Description	Applies the specified action as a transition.
Parameters	`action` - A table with the name/category/theme for the transition to apply, or a string with just the name.
Returns	`true` if a matching transition 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 transition with that name. Alternatively, you can also supply a string with just the name.
Examples	None
Source	src/plugins/finalcutpro/timeline/transitions.lua line 18