# plugins.finalcutpro.timeline.titles

Controls Final Cut Pro's Titles.


# API Overview

Functions - API calls offered directly by the extension

  • apply

# API Documentation

# Functions

# apply

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