cp.apple.finalcutpro.main.GeneratorsBrowser

Generators Browser Module.


API Overview

Constants - Useful values which cannot be changed

  • TITLE

Variables - Configurable values

  • isShowing

Constructors - API calls which return an object, typically one that offers API methods

  • GeneratorsBrowser

Fields - Variables which can only be accessed from an object returned by a constructor

  • contents
  • group
  • mainGroupUI
  • search
  • sidebar

Methods - API calls which can only be made on an object returned by a constructor

  • applyItem
  • currentItemsUI
  • getCurrentTitles
  • getGeneratorsRowLabel
  • getTitlesRowLabel
  • hide
  • itemIsSelected
  • loadLayout
  • saveLayout
  • selectedItemsUI
  • show
  • showAllGenerators
  • showAllTitles
  • showGeneratorsCategory
  • showInstalledGenerators
  • showInstalledTitles
  • showSidebar
  • showTitlesCategory
  • topCategoriesUI

API Documentation

Constants

TITLE

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser.TITLE -> string
Type Constant
Description Titles & Generators Title.
Notes None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 37

Variables

isShowing

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser.isShowing <cp.prop: boolean>
Type Variable
Description Is the Generators Browser showing?
Notes None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 68

Constructors

GeneratorsBrowser

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser(parent) -> GeneratorsBrowser
Type Constructor
Description Creates a new GeneratorsBrowser instance.
Parameters
  • app - The cp.apple.finalcutpro object.
Returns
  • A new GeneratorsBrowser object.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 42

Fields

contents

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser.contents <cp.ui.ScrollArea>
Type Field
Description The Generators Browser Contents.
Notes None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 152

group

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser.group <cp.ui.PopUpButton>
Type Field
Description The group.
Notes None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 164

mainGroupUI

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser.mainGroupUI <cp.prop: axuielementObject>
Type Field
Description Main Group UI.
Notes None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 130

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser.search <cp.ui.TextField>
Type Field
Description Gets the Search TextField object.
Notes None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 173

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser.sidebar <cp.ui.OldTable>
Type Field
Description The sidebar object.
Notes None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 143

Methods

applyItem

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:applyItem(itemUI) -> GeneratorsBrowser
Type Method
Description Applies an item by double clicking on it.
Parameters
  • itemUI - The axuielementObject of the item you want to apply.
Returns
  • The GeneratorsBrowser object.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 380

currentItemsUI

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:currentItemsUI() -> axuielementObject
Type Method
Description Gets the current items UI.
Parameters
  • None
Returns
  • axuielementObject object.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 333

getCurrentTitles

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:getCurrentTitles() -> table
Type Method
Description Returns the list of titles for all generators currently visible.
Parameters
  • None
Returns
  • A table
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 399

getGeneratorsRowLabel

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:getGeneratorsRowLabel() -> string
Type Method
Description Gets a Generators Row Label.
Parameters
  • None
Returns
  • The Generators Row Label as string.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 287

getTitlesRowLabel

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:getTitlesRowLabel() -> string
Type Method
Description Returns the label of the 'Titles' row in the current language.
Parameters
  • None
Returns
  • The 'Titles' label.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 241

hide

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:hide() -> GeneratorsBrowser
Type Method
Description Hides the Generators Browser.
Parameters
  • None
Returns
  • The GeneratorsBrowser instance.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 105

itemIsSelected

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:itemIsSelected(itemUI) -> boolean
Type Method
Description Checks to see if an item is selected.
Parameters
  • itemUI - A axuielementObject to check.
Returns
  • true if the item is selected, otherwise false.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 359

loadLayout

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:loadLayout(layout) -> none
Type Method
Description Loads a Generators Browser layout.
Parameters
  • layout - A table containing the Generators Browser layout settings - created using cp.apple.finalcutpro.main.GeneratorsBrowser:saveLayout().
Returns
  • None
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 444

saveLayout

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:saveLayout() -> table
Type Method
Description Saves the current Generators Browser layout to a table.
Parameters
  • None
Returns
  • A table containing the current Effects Browser Layout.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 424

selectedItemsUI

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:selectedItemsUI() -> axuielementObject
Type Method
Description Gets the selected items UI.
Parameters
  • None
Returns
  • axuielementObject object.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 346

show

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:show() -> GeneratorsBrowser
Type Method
Description Shows the Generators Browser.
Parameters
  • None
Returns
  • The GeneratorsBrowser instance.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 78

showAllGenerators

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:showAllGenerators() -> GeneratorsBrowser
Type Method
Description Show All Generators.
Parameters
  • None
Returns
  • The GeneratorsBrowser object.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 300

showAllTitles

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:showAllTitles() -> GeneratorsBrowser
Type Method
Description Ensures the sidebar is showing in the Generators & Titles panel, focused on all 'Titles'.
Parameters
  • None
Returns
  • The GeneratorsBrowser object.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 254

showGeneratorsCategory

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:showGeneratorsCategory(name) -> GeneratorsBrowser
Type Method
Description Show a specific Generators Category.
Parameters
  • name - The name of the Generators Category to show.
Returns
  • The GeneratorsBrowser object.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 318

showInstalledGenerators

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:showInstalledGenerators() -> GeneratorsBrowser
Type Method
Description Ensures that the browser is showing 'Installed Generators'.
Parameters
  • None
Returns
  • The GeneratorsBrowser object.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 227

showInstalledTitles

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:showInstalledTitles() -> GeneratorsBrowser
Type Method
Description Ensures that the browser is showing 'Installed Titles'.
Parameters
  • None
Returns
  • The GeneratorsBrowser object.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 213

showSidebar

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:showSidebar() -> GeneratorsBrowser
Type Method
Description Ensures the sidebar is showing in the Generators & Titles panel.
Parameters
  • None
Returns
  • The GeneratorsBrowser object.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 182

showTitlesCategory

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:showTitlesCategory(name) -> self
Type Method
Description Ensures the sidebar is showing and that the selected 'Titles' category is selected, if available.
Parameters
  • name - The category name, in the current language.
Returns
  • The Generators Browser.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 272

topCategoriesUI

   
Signature cp.apple.finalcutpro.main.GeneratorsBrowser:topCategoriesUI() -> table
Type Method
Description Returns an array of the top-level categories in the sidebar.
Parameters
  • None
Returns
  • The array of category rows.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/main/GeneratorsBrowser.lua line 198