Resolve Scripting Essentials

#1

resolve-15-startup-splash-screen.png

Resolve 15 has added a new Fusion page to the video editing package. As part of this update Resolve also inherited Fusion's fuscript scripting system which allows you to write Lua, Python 2, and Python 3 based scripts that can run inside of Resolve 15.

Resolve's new scripting system is able to use the same UI Manager GUI building system as Fusion 9 does. This means the existing reference material on the WSL Thread "Building GUIs With Fusion's UI Manager" can be used in Resolve 15, too.

Fusion Console View

The easiest way to run is script you download from the internet is to drag a .lua or .py script file from your desktop into the Fusion page "Nodes" view. The script will be run automatically by Resolve. Any printed messages from the script will be shown in the Fusion page "Console" view.

You can display the Console window using the Fusion > Console menu.

resolve-fusion-console-menu.png

Edit: In Resolve v16+ the Console window is located under the Workspace > Console menu.

The Console window allows you to directly type in Lua or Python code using the input field at the bottom of the Console window. You can also paste in a block of code from your system's copy/paste clipboard buffer using the typical Command + V (macOS), or Control+V (Windows/Linux) hotkeys.

If you want to try out the Resolve 15 Fusion page scripting features for the first time you can type in the following Lua code to see details about the Fusion object, and the current composite:

Code: Select all

dump(fu:GetAttrs())
dump(comp:GetAttrs())

fusion-console-view.png

This results in the following text being output to the Console window:

Code: Select all

Lua> dump(fu:GetAttrs())
table: 0x0194f793f0
	FUSIONS_CLVendor = AMD
	FUSIONS_FileName = 
	FUSIONH_CurrentComp = Composition (0x0x199c8c400) [App: 'Fusion' on 127.0.0.1, UUID: ccd22b89-0324-4312-b054-0baf24b87e84]
	FUSIONI_PhysicalRAMTotalMB = 16384
	FUSIONS_CLVersion = OpenCL 1.2  1.2 (Mar 15 2018 21:59:57)
	FUSIONI_VersionLo = 7
	FUSIONS_MachineType = IA32
	FUSIONI_PhysicalRAMFreeMB = 7630
	FUSIONI_VersionHi = 983040
	FUSIONB_IsManager = false
	FUSIONS_Version = 15.0.0b.030
	FUSIONS_CLType = GPU
	FUSIONS_CLDevice = AMD Radeon R9 M370X Compute Engine
	FUSIONI_SerialHi = 0
	FUSIONI_VirtualRAMTotalMB = 18729
	FUSIONS_GLVendor = ATI Technologies Inc.
	FUSIONS_GLVersion = 2.1 ATI-1.66.31
	FUSIONI_VirtualRAMUsedMB = 11099
	FUSIONB_IsRenderNode = false
	FUSIONS_GLDevice = AMD Radeon R9 M370X OpenGL Engine
	FUSIONI_NumProcessors = 8
	FUSIONI_SerialLo = 0
	
Lua> dump(comp:GetAttrs())
table: 0x0194f7c5d0
	COMPN_LastFrameRendered = -2000000000
	COMPB_HiQ = true
	COMPI_RenderFlags = 131072
	COMPN_ElapsedTime = 0
	COMPN_AverageFrameTime = 0
	COMPB_Locked = false
	COMPB_Modified = false
	COMPN_TimeRemaining = 0
	COMPN_CurrentTime = 0
	COMPN_RenderEnd = 0
	COMPN_AudioOffset = 0
	COMPH_ActiveTool = Media In (0x0x1a2d2ce00) [App: 'Fusion' on 127.0.0.1, UUID: ccd22b89-0324-4312-b054-0baf24b87e84]
	COMPS_Name = 
	COMPN_GlobalStart = 0
	COMPI_RenderStep = 1
	COMPS_FileName = 
	COMPB_Rendering = false
	COMPN_RenderStartTime = 0
	COMPN_GlobalEnd = 0
	COMPN_RenderEndTime = 0
	COMPN_RenderStart = 0
	COMPN_LastFrameTime = 0
	COMPB_Proxy = false

Where I can run Lua and Python Scripts in Resolve?

You can run your own scripts in Resolve 15:

From the Console window
From the command prompt using the FuScript executable program
From the Scripts:/Comp folder using the Fusion > Scripts menu
From the Scripts:/Tool folder using the Nodes view right click > contextual menu
As intool scripts on nodes which is accessed in the Inspector view > Tools > Intool Script view
As Actions and Events that are stored inside of Config:/ PathMap based .fu files
As code inside of graphical fuses, or Console fuses

Resolve Local vs Network Scripting Access

If you open Resolve's System > Configuration section there is an External Scripting Using control that can be configured to allow remote systems to control and automate the Resolve GUI session using fuscript. You have the choice of selecting "None", "Local", or "Network" in this menu.

resolve-configuration-external-scripting-network.png

Resolve Command Line Scripting

Resolve 15's new scripting engine is implemented using the fuscript executable that was added by the addition of the new Fusion page. This fuscript program allow you to run a script via the command line that can control a Resolve graphical session either locally or remotely.

The fuscript executable can be found on Windows/Linux/MacOS systems. If you use fuscript frequently it can be handy to add the program to your system $PATH / %PATH% environment variable. This allows you to only have to type the words "fuscript" to launch the executable vs having to type the full absolute file path into the command line every time.

Here is a quick summary of the default location of FuScript on your Resolve 15 system:

/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Libraries/Fusion/fuscript
/Program Files/Blackmagic Design/DaVinci Resolve/fuscript.exe

fuscript-command-prompt.png

Code: Select all

Usage: fuscript [opts] <script> [args]
   -i                   - Enter interactive mode
   -v                   - Print version information
   -s                   - Run as script server
   -S                   - Run as script server with no timeout
   -p [appname]         - Ping script apps
   -P [appname]         - Ping script apps (longer timeout)
   -q                   - Be quiet
   -b                   - Run with commandline debugger
   -l <lang>            - Explicitly set language, from:
      lua
      py2 or python2
      py3 or python3
   -x <string>          - Execute string

Here is an macOS command line example that launches a Lua script in Resolve 15 via FuScript:

Code: Select all

'/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Libraries/Fusion/fuscript' -l lua  -x 'fusion = bmd.scriptapp("Fusion", "localhost");if fusion ~= nil then fu = fusion;app = fu;composition = fu.CurrentComp;comp = composition;SetActiveComp(comp) else print("[Error] Please open up the Fusion GUI before running this tool.") end;resolve = bmd.scriptapp("Resolve", "localhost");if resolve ~= nil then res = resolve;else print("[Error] Please open up the Fusion GUI before running this tool.") end; ' /Volumes/VFX/Resolve/Scripts/ListFiles.lua'

All of the extra code in this command prompt example is used to initialize the "fu:", "comp:", and "resolve:" objects in memory so external scripts can connect to the Resolve Project Manager, the Media Pool, the Fusion page composite session, and to be able to run UI Manager based GUIs. This FuScript based approach to running scripts allows you to quickly create new composites based upon external control.

#2

Zoom the Console Window Fontsize

If you are working with Resolve 15 on a large monitor it can help to zoom the text larger/smaller in the Console view. You can do this using the Command + Scroll Wheel (MacOS) hotkey. The Control + Scroll Wheel should work on Windows/Linux.

Scripting Resolve to Access the Media Pools

The following Resolve 15 Lua script snippets demonstrate how to automate the process of loading external media into the Media Pool, and interacting with the active Media Storage volumes.

ListVolumes

This Resolve 15 Fusion page based Lua script displays the active Media Storage volumes.

Code: [Select all] [Expand/Collapse] [Download] (ListVolumes.lua)

--[[
ListVolumes - v1 2018-04-09
By Andrew Hazelden <andrew@andrewhazelden.com>
 
This Resolve 15 Fusion page based Lua script displays the active Media Storage volumes.
 
Script Output:
 
[Media Storage Volumes]
table: 0x01fe96a8
    1 = /Users/andrew/Movies
    2 = /Volumes/BOOTCAMP
    3 = /Volumes/PineHD
--]]
 
-- Display the volumes attached to the system
function ListVolumes()
    local resolve = Resolve()
    local ms = resolve:GetMediaStorage()
    return ms:GetMountedVolumes()
end
 
function Main()
    -- Display the volumes attached to the system
    print('\n[Media Storage Volumes]')
    local vol = ListVolumes()
    dump(vol)
end
 
Main()
print('[Done]')
 

ListFiles

This Resolve 15 Fusion page based Lua script displays the active files in the Media Storage volumes.

Code: [Select all] [Expand/Collapse] [Download] (ListFiles.lua)

--[[
ListFiles - v1 2018-04-09
By Andrew Hazelden <andrew@andrewhazelden.com>
 
This Resolve 15 Fusion page based Lua script displays the active files in the Media Storage volumes.
 
Script Output:
 
[Media Storage Files]
table: 0x0d8103f8
    1 = /Users/andrew/Movies/Resolve 15.mp4
table: 0x0d77e138
table: 0x0d8150b8
    1 = /Volumes/PineHD/BTS.mp4
[Done]
--]]
 
-- Display the volumes attached to the system
function ListVolumes()
    local resolve = Resolve()
    local ms = resolve:GetMediaStorage()
    return ms:GetMountedVolumes()
end
 
-- Display the files in root of the current media storage folder
function ListFiles(index)
    local resolve = Resolve()
    local ms = resolve:GetMediaStorage()
    local vol = ListVolumes()
    return ms:GetFiles(vol[index])
end
 
function Main()
    -- The volumes attached to the system
    local vol = ListVolumes()
 
    -- Display the files in the attached filesystem
    print('\n[Media Storage Files]')
    for i,val in ipairs(vol) do
        local files = ListFiles(i)
        dump(files)
    end
end
 
Main()
print('[Done]')
 

ListSubfolder

This Resolve 15 Fusion page based Lua script displays the subfolders in the Media Storage volumes.

Code: [Select all] [Expand/Collapse] [Download] (ListSubfolder.lua)

--[[
ListSubfolders.lua - v1 2018-04-09
By Andrew Hazelden <andrew@andrewhazelden.com>
 
This Resolve 15 Fusion page based Lua script displays the subfolders in the Media Storage volumes.
 
Script Output:
 
[Media Storage Subfolders]
...
 
[Folder 3] /Volumes/PineHD  
table: 0x07ae7bf8
    1 = /Volumes/PineHD/Applications
    2 = /Volumes/PineHD/Library
    3 = /Volumes/PineHD/System
    4 = /Volumes/PineHD/Users
    5 = /Volumes/PineHD/Virtual Machines
    6 = /Volumes/PineHD/etc
    7 = /Volumes/PineHD/opt
    8 = /Volumes/PineHD/tmp
    9 = /Volumes/PineHD/var
    
--]]
 
-- Display the volumes attached to the system
function ListVolumes()
    local resolve = Resolve()
    local ms = resolve:GetMediaStorage()
    return ms:GetMountedVolumes()
end
 
-- Display the subfolders in the MediaStorage
function ListSubFolders(index)
    local resolve = Resolve()
    local ms = resolve:GetMediaStorage()
    local vol = ListVolumes()
    return ms:GetSubFolders(index)
end
 
function Main()
    -- The volumes attached to the system
    local vol = ListVolumes()
 
    -- Display the files in the attached filesystem
    print('\n[Media Storage Subfolders]')
    for i,val in ipairs(vol) do
        -- Display the subfolders in the Media Storage
        print('\n\n[Folder ' .. i .. '] ', val)
        local folders = ListSubFolders(val)
        dump(folders)
    end
end
 
Main()
print('[Done]')
 

Add Folder to Media Pool

adding-footage-to-the-media-pool.png

This Resolve 15 Fusion page based Lua script scans the contents of a user specified folder for a specific file type and then adds the content to the Media Pool.

Code: [Select all] [Expand/Collapse] [Download] (Add Folder to Media Pool.lua)

--[[
Add Folder to Media Pool - v1 2018-04-09
By Andrew Hazelden <andrew@andrewhazelden.com>
 
This Resolve 15 Fusion page based Lua script scans the contents of a user specified folder for a specific file type and then adds the content to the Media Pool.
 
Script Output:
 
[Media Storage Volumes]
table: 0x01fe96a8
    1 = /Users/andrew/Movies
    2 = /Volumes/BOOTCAMP
    3 = /Volumes/PineHD
--]]
 
-- Add to footage to Media Pool using an absolute filepath
function AddToMediaPool(filename)
    local resolve = Resolve()
    local ms = resolve:GetMediaStorage()
    return ms:AddItemsToMediaPool(fusion:MapPath(filename))
end
 
-- Add the footage from a folder to the Media Pool
function AddFolderToMediaPool(folder, ext)
    if folder and folder ~= '' then
        -- Scan the folder
        local path = fusion:MapPath(folder .. osSeparator .. '*.' .. ext)
        local dir = bmd.readdir(path)
        -- dump(dir)
    
        print('[Add Footage to Media Pool] ')
        for i,v in ipairs(dir) do
            if v.IsDir == false then
                filepath = folder .. osSeparator .. v.Name
 
                -- Add each of the files in the folder to the Media Pool
                result = AddToMediaPool(filepath)
                print('  [' .. i .. '] ' .. filepath)
            end
        end
    else
        print('[Filepath Error] Please specify a folder and run this function again.')
    end
end
 
-- Where the magic happens
function Main()
    -- Add the platform specific folder slash character
    osSeparator = package.config:sub(1,1)
 
    -- Scan a folder and add the footage to Media Pool using an absolute filepath
    AddFolderToMediaPool('/Production/VFX/Resolve/Nokia Ozo+ Video Stitch', 'mp4')
    
    -- Add a specific file to the Media Pool using an absolute filepath
    AddToMediaPool('/Production/VFX/Resolve/Nokia Ozo+ Video Stitch/Resolve-Stitched-Latlong-Stereo.0000.tif')
end
 
Main()
print('[Done]')
 

#3

The new Resolve 15 scripting system supports the UI Manager GUI building system that was recently added to Fusion. UI Manager allows you to create native cross-platform compatible GUI for your Lua and Python scripts. This GUI toolkit is based upon the QT window manager.

If you want to start learning how UI Manager works the best thing to do is check out the WSL Reactor "Scripts/Comp" category and install the "UI Manager Lua Examples" atom package. This will get you started quickly with 48+ scripting examples.

There is a companion "Building GUIs With Fusion's UI Manager" tutorial series available:
https://www.steakunderwater.com/wesuckl ... 463#p10463

#4

The Fusion page scripting system in Resolve 15 has an interesting help function in the Lua language that allows you to see a list of the main Resolve API functions. These same base Resolve functions are also accessible using Python. With these commands you can automate switching between Resolve pages, add footage to your Media Pool, and load/save Resolve projects in the Project Manager.

You can run this Lua script in the Fusion page Console:

Code: [Select all] [Expand/Collapse] [Download] (ResolveAPI Functions.lua)

-- List the Resolve API Features
resolve = Resolve()
dump(resolve:GetHelp('ResolveScriptable'))
dump(resolve:GetHelp('Timeline'))
dump(resolve:GetHelp('Timeline item'))
dump(resolve:GetHelp('Media pool item'))
dump(resolve:GetHelp('Folder'))
dump(resolve:GetHelp('MediaPool'))
dump(resolve:GetHelp('Project'))
dump(resolve:GetHelp('Resolve'))
dump(resolve:GetHelp('ProjectManager'))
dump(resolve:GetHelp('MediaStorage'))
dump(resolve:GetHelp('ScriptServer'))
dump(resolve:GetHelp('ScriptServerObject'))

resolve-console-api-help-text.png

Running the code resulted in the following Console output text:

Code: [Select all] [Expand/Collapse] [Download] (Resolve API Functions Output.txt)

ResolveScriptable Members:
  ResolveScriptable:Print()
  :GetApp()
  :GetAttrs()
  :GetHelp()
  :GetHelpRaw()
  :SetAttrs()
 
Resolve Members:
  Resolve:Fusion()
  Resolve:GetMediaStorage()
  Resolve:GetProjectManager()
  Resolve:OpenPage()
  ResolveScriptable:Print()
  :GetApp()
  :GetAttrs()
  :GetHelp()
  :GetHelpRaw()
  :SetAttrs()
 
ProjectManager Members:
  ProjectManager:CreateProject()
  ProjectManager:GetCurrentProject()
  ProjectManager:LoadProject()
  ProjectManager:SaveProject()
  ResolveScriptable:Print()
  :GetApp()
  :GetAttrs()
  :GetHelp()
  :GetHelpRaw()
  :SetAttrs()
 
MediaStorage Members:
  MediaStorage:AddItemsToMediaPool()
  MediaStorage:GetFiles()
  MediaStorage:GetMountedVolumes()
  MediaStorage:GetSubFolders()
  MediaStorage:RevealInStorage()
  ResolveScriptable:Print()
  :GetApp()
  :GetAttrs()
  :GetHelp()
  :GetHelpRaw()
  :SetAttrs()

FusionScript Help Browser

ui-manager-fusion-script-help-browser.png

If you are adventurous and want to go deeper into Resolve scripting, you can download the FusionScript Help Browser example from the WSL UI Manager thread. This script will let you visually use a GUI to browse the scriptable classes that are available in Resolve 15.

The FusionScript Help Browser Lua script is able to be run in Resolve 15 by dragging the script into the "Nodes" view. You could also adding it to the "Scripts:/Comp/ PathMap folder location and restart Resolve so it shows up in the "Fusion > Scripts > menu in the Fusion page.

You can search in this window for the following members:

Code: Select all

ResolveScriptable
Timeline
Timeline item
Media pool item
Folder
MediaPool
Project
Resolve
ProjectManager
MediaStorage
ScriptServer
ScriptServerObject

#5

placeholder

#6

Resolve 15 allows you to create macros that can be used as video title templates in the Edit page, or as Fusion page node based snippets that can be easily added to a composite using the Effects Library view:

resolve-effects-library.png

If you have any pre-existing macros or templates from earlier copies of Fusion you can add them to this view with a manual installation technique as long as the macro don't rely on Resolve 15 unsupported nodes like Loaders/Savers/Primatte.

Page 276 in the "DaVinci Resolve Manual.pdf" guide that is included with Resolve 15's Public Beta has a chapter with more details on using and making Resolve "Templates", and "Title Templates".

In this screenshot I placed several 3rd party Fusion macros into Resolve's Templates:/Edit/ and Templates:/Fusion/ PathMap folders. The next time Resolve was rebooted the custom macros were accessible in the Effects Library.

kartavr-effects-library-templates.png

Installing the Macros

If you have any pre-existing Macro .setting files from Fusion/Fusion studio that you would like to have show up in Resolve's Effects Library > Templates section you can do that by placing the content into a Templates:/ PathMap based sub-folder location like the following paths:

Windows Templates

Code: Select all

C:\ProgramData\Blackmagic Design\DaVinci Resolve\Fusion\Templates\Edit\
C:\ProgramData\Blackmagic Design\DaVinci Resolve\Fusion\Templates\Fusion\

or 

%appdata%\Blackmagic Design\Blackmagic Design\DaVinci Resolve\Fusion\Templates\Edit\
%appdata%\Blackmagic Design\Blackmagic Design\DaVinci Resolve\Fusion\Templates\ Fusion\

macOS Templates

Code: Select all

/Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Templates/Edit/
/Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Templates/Fusion/

or

$HOME/Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Templates/Edit/
$HOME/Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Templates/Fusion/

Linux Templates

Code: Select all

/var/BlackmagicDesign/DaVinci Resolve/Fusion/Templates/Edit/
/var/BlackmagicDesign/DaVinci Resolve/Fusion/Templates/Fusion/

#7

placeholder

#8

As a fun R&D note, Resolve uses Sqlite3 formatted databases to store a lot of its own internal settings and records for a video editing project. This detail means you you can use Sqlite3 from the command prompt or from a Lua/Python script to directly probe and read the Resolve project databases and other .db files without needing to even start up Resolve.

resolve-disk-database-folder-resolve-projects.png

With this approach you could go even lower level then Resolve's own scripting API provides if you wanted to delve into reading any setting that is saved into any of Resolve's locally stored .db files. This is something you would only want to do in a read only fashion as you could have database integrity errors if you tried modifying the database live while Resolve is running.

Sqlite3 is a cross-platform command line based database engine that is open source with a public domain license. Sqlite3 can be accessed from Lua using os.execute(), and from a Python script in Fusion. It is possible to use any number of Sqlite3 wrapper scripts for Lua and Python that can make it easier to use as part of a regular scripted workflow.

The free cross-platform "DB Browser for SQLite" tool is a good place to start if you are searching through the Resolve .db files for details:
http://sqlitebrowser.org

Sqlite3 Installation Notes

Sqlite3 Project
https://sqlite.org/

Sqlite3 Dccumentation
http://sqlite.org/docs.html

Sqlite3 Manual Installation

Windows Manual Install

You can manually download Sqlite3 from the "Precompiled Binaries for Windows" section:
http://sqlite.org/download.html

macOS Manual Install
Sqlite3 comes pre-installed with macOS.

Linux Manual Install
Linux users can install Sqlite3 using yum, apt-get, or pacman.

Ubuntu Manual Install

Code: Select all

sudo apt-get install sqlite3 libsqlite3-dev

Sqlite3 Usage Examples

These macOS based examples show how Sqlite3 can be used from a BASH command prompt to open Resolve Project.db files.

When you are researching new SQL commands it is helpful to have the ".header on" and ".mode column" tags added so you can get an idea of the data structure visually. Once you know the final search query to use you can remove those arguments from your queries to simplify the output.

Example 1 - List the Resolve Project Name and Timeline Video Clips

Code: Select all

sqlite3 "/Library/Application Support/Blackmagic Design/DaVinci Resolve/Resolve Disk Database/Resolve Projects/Users/guest/Projects/Ozo Stitch/Project.db" ".header on" ".mode column" "SELECT ProjectName FROM SM_Project;" "SELECT Name, MediaFilePath, Start, Duration FROM Sm2TiItem WHERE DbType = 'Sm2TiVideoClip';"

Example 1 Output:

Code: Select all

ProjectName
-----------
Ozo Stitch

Name        MediaFilePath                                             Start       Duration  
----------  --------------------------------------------------------  ----------  ----------
cam8.mp4    /Production/VFX/Resolve/Nokia Ozo+ Video Stitch/cam8.mp4  86400       268

Example 2 - List the Resolve Media Pool Video Clips

Code: Select all

sqlite3 "/Library/Application Support/Blackmagic Design/DaVinci Resolve/Resolve Disk Database/Resolve Projects/Users/guest/Projects/Ozo Stitch/Project.db" ".header on" ".mode column" "SELECT Name, DbType, UniqueMediaPoolItemId FROM Sm2MPMedia WHERE DbType = 'Sm2MpVideoClip';"

Example 2 Output:

Code: Select all

Name        DbType          UniqueMediaPoolItemId               
----------  --------------  ------------------------------------
cam3.mp4    Sm2MpVideoClip  2027c029-5a32-48be-9d94-9665090c37a5
cam6.mp4    Sm2MpVideoClip  c8017708-2d00-4a65-90dd-e33cd0408e88
cam2.mp4    Sm2MpVideoClip  fac1bcac-4fb7-4ca4-8e1d-2407bddf74f5
cam7.mp4    Sm2MpVideoClip  c2596427-2bd3-4ab5-996c-b97d3db93942
cam8.mp4    Sm2MpVideoClip  ad9b2904-c5a9-4e3a-a579-b8f5c3998c50
cam5.mp4    Sm2MpVideoClip  2d18b9c7-f1f1-4bae-b3e5-8dcbe6cc1d65
cam1.mp4    Sm2MpVideoClip  2d002633-2e23-4169-a938-d7291f7c15c3
cam4.mp4    Sm2MpVideoClip  97841817-6456-4784-9362-7455e835197b

Example 3 - Resolve Direct DB Media Access Script

resolve-console-reporting-sqlite3-db-output.png

You can also peek into the active Resolve project .db database file using Lua with a script like this (or you could also use lua sqlite3 bindings if you are fancy). This script has only been tested on macOS. Windows and Linux users might have to edit the filepaths to sqlite3 and change other aspects of the code.

Code: [Select all] [Expand/Collapse] [Download] (Resolve Direct DB Media Access.lua)

--[[--
[Resolve Direct DB Media Access]
[Created By] Andrew Hazelden <andrew@andrewhazelden.com>
 
## Script Usage ##
 
fuscript -l lua "$HOME/Desktop/Resolve Direct DB Media Access.lua"
 
## Example Output ##
 
[Fusion 3D System]
  [1] "autumn_sunrise.jpg" [UUID] 41134066-b91c-4bf5-9d5c-e12ecbe77283
 
 
[Ozo Stitch]
  [1] "cam3.mp4" [UUID] 2027c029-5a32-48be-9d94-9665090c37a5
  [2] "cam6.mp4" [UUID] c8017708-2d00-4a65-90dd-e33cd0408e88
  [3] "cam2.mp4" [UUID] fac1bcac-4fb7-4ca4-8e1d-2407bddf74f5
  [4] "cam7.mp4" [UUID] c2596427-2bd3-4ab5-996c-b97d3db93942
  [5] "cam8.mp4" [UUID] ad9b2904-c5a9-4e3a-a579-b8f5c3998c50
  [6] "cam5.mp4" [UUID] 2d18b9c7-f1f1-4bae-b3e5-8dcbe6cc1d65
  [7] "cam1.mp4" [UUID] 2d002633-2e23-4169-a938-d7291f7c15c3
  [8] "cam4.mp4" [UUID] 97841817-6456-4784-9362-7455e835197b
 
 
[Image Sequences]
  [1] "v54_p-90_y140.[1-20].jpg" [UUID] 2cc9cd8b-1cef-44bc-8be5-0558cc128578
 
 
## Install Notes ##
 
macOS:
sqlite3 is pre-installed
 
Linux:
sudo apt-get install sqlite3 libsqlite3-dev
 
Windows:
sqlite3 needs to be manually installed and added to the Windows %PATH% env var
 
--]]--
 
-- ------------------------------------------------------
-- Variables
 
_VERSION = 1.0
_AUTHOR = 'Andrew Hazelden <andrew@andrewhazelden.com>'
_DATE = '2018-03-29'
 
-- ------------------------------------------------------
-- Open the database and scan for media files
function ScanProjectDB(dbFile)
    dbFilepath = resolveProjectsFolder .. dbFile .. '/Project.db'
 
    -- Read the Resolve sqlite3 database
    dbCommand = [["]] ..dbProgram .. [[" "]] .. dbFilepath .. [[" ".header off" "SELECT Name, DbType, UniqueMediaPoolItemId FROM Sm2MPMedia WHERE DbType = 'Sm2MpVideoClip';"]]
    -- print('[Command] ' .. dbCommand)
 
    -- List the output
    print('[' .. dbFile .. ']')
    i = 0
    for files in io.popen(dbCommand):lines() do
        i = i + 1
        filename, format, uuid = string.match(files, '^(.*)|(.*)|(.*)$')
        print('  ['.. i  .. '] "'.. filename .. '" [UUID] ' .. uuid)
        -- Result: [1] "cam3.mp4" [UUID] 2027c029-5a32-48be-9d94-9665090c37a5
    end
    print('\n')
end
 
 
function Main()
    print('[Resolve Media Access] v' .. _VERSION .. ' ' .. _DATE)
    print('[Created By] ' .. _AUTHOR)
    print('---------------------------------------------------------\n')
 
    -- Find out the current Fusion host platform (Windows/Mac/Linux)
    platform = (FuPLATFORM_WINDOWS and "Windows") or (FuPLATFORM_MAC and "Mac") or (FuPLATFORM_LINUX and "Linux")
 
    if platform == "Windows" then
        -- Running on Windows
        resolvePrefsFolder = 'C:\\ProgramData\\Blackmagic Design\\DaVinci Resolve\\'
        resolveProjectsFolder = resolvePrefsFolder .. 'Support\\Resolve Disk Database\\Resolve Projects\\Users\\guest\\Projects\\'
        dbProgram = 'sqlite3'
    elseif platform == "Mac" then
        -- Running on Mac
        resolvePrefsFolder = '/Library/Application Support/Blackmagic Design/DaVinci Resolve/'
        resolveProjectsFolder = resolvePrefsFolder .. 'Resolve Disk Database/Resolve Projects/Users/guest/Projects/'
        dbProgram = '/usr/bin/sqlite3'
    elseif platform == "Linux" then
        -- Running on Linux
        resolvePrefsFolder = '/opt/resolve/'
        resolveProjectsFolder = resolvePrefsFolder .. 'Resolve Disk Database/Resolve Projects/Users/guest/Projects/'
        dbProgram = '/usr/bin/sqlite3'
    else
        print("[Error] There is an invalid Fusion platform detected\n")
        return
    end
 
    -- Scan the Resolve Projects folder
    local dirList = bmd.readdir(resolveProjectsFolder .. '*')
    -- dump(dirList)
 
    -- Extract the media details for each database
    for i, f in ipairs(dirList) do
        if f.IsDir == true then
            ScanProjectDB(f.Name)
        end
    end
end
 
Main()
print('[Done]')

Example 3 Output:

Code: Select all


[Fusion 3D System]
  [1] "autumn_sunrise.jpg" [UUID] 41134066-b91c-4bf5-9d5c-e12ecbe77283


[Ozo Stitch]
  [1] "cam3.mp4" [UUID] 2027c029-5a32-48be-9d94-9665090c37a5
  [2] "cam6.mp4" [UUID] c8017708-2d00-4a65-90dd-e33cd0408e88
  [3] "cam2.mp4" [UUID] fac1bcac-4fb7-4ca4-8e1d-2407bddf74f5
  [4] "cam7.mp4" [UUID] c2596427-2bd3-4ab5-996c-b97d3db93942
  [5] "cam8.mp4" [UUID] ad9b2904-c5a9-4e3a-a579-b8f5c3998c50
  [6] "cam5.mp4" [UUID] 2d18b9c7-f1f1-4bae-b3e5-8dcbe6cc1d65
  [7] "cam1.mp4" [UUID] 2d002633-2e23-4169-a938-d7291f7c15c3
  [8] "cam4.mp4" [UUID] 97841817-6456-4784-9362-7455e835197b


[Image Sequences]
  [1] "v54_p-90_y140.[1-20].jpg" [UUID] 2cc9cd8b-1cef-44bc-8be5-0558cc128578

YouTube · #9

Man!
Cool!
<speechless>

statixvfx · #10

Fantastic work brother! You're doing god's BMD's work !

#11

Awesome stuff Greg! Thanks for all the hard work. !
.. do you know if the UI Manager is now using Qt5 or still 4.8 ? the buttons suddenly look all rounded.

#12

Dunn wrote: ↑Wed Apr 11, 2018 2:14 amAwesome stuff Greg! Thanks for all the hard work. !
.. do you know if the UI Manager is now using Qt5 or still 4.8 ? the buttons suddenly look all rounded.

Hi Dunn.

UI Manager scripts that are run inside of Resolve automatically take on the same "themed" look as Resolve uses for it's own GUI controls. It's not really a QT version thing but merely the UX design of Resolve being applied to UI Manager based scripts.

In the private beta version of Resolve 15 the UI Manager created ui:Buttons were square originally with a very hard bevel. Then in the public beta version of Resolve we now get to have the same type of rounded buttons as you would find in the Resolve preferences window.

Here's a few UI screenshots to show what Lua script GUIs look like in Resolve 15:

Reactor Atomizer v1.4 Beta

reactor-atomizer-gui.png

Lua UI Manager Examples - FileDialogs.lua

lua-ui-manager-examples-filedialogs.png

Lua UI Manager Examples - Action Listener.lua

lua-ui-manager-examples-action-listener.png

Lua UI Manager Examples - OFX Blacklist Generator.lua

lua-ui-manager-examples-ofx-blacklist-generator.png

YouTube · #13

well done,great job

#14

If you are making a custom pipeline tool it can sometimes be handy to be able to guide the user on the next step to carry out.

This could be letting the user know they need to install an additional piece of software, showing the output folder where media has been exported to, opening up a log text file that was saved to disk by your script, opening up the related HTML or PDF documentation for your tool, or showing the final movie export / rendered image when a task completes.

In all of these cases you likely know the filepath or webpage URL that you want to open. What you might not have is the knowledge of how to do the URL/filepath launching action consistently on Windows/macOS/Linux. The typical Lua based approach in the past would be to use the Lua shell launching command "os.execute()" with your own concoction of custom file/folder/URL launching strings done uniquely for each of the supported host OS platforms were your script can be run from.

Thinking Cross-platform

Before we go into details on the actual scripts for opening files and URLs it is handy to know that you can get your Lua script to report the current operating system's native folder path "slash" direction using the following Lua command:

Slash Direction

Code: [Select all] [Expand/Collapse] [Download] (SlashDirection.lua)

-- Add the platform specific folder slash character
osSeparator = package.config:sub(1,1)
print('[Slash Direction] ' .. osSeparator .. '\n')
 

Finding out the active slash direction is handy if you want to build a custom filepath and need to keep the folder separators consistent. This saves having to use a Lua pattern based command later on to try and normalize the slashes so they are consistent.

SlashDirection.png

Platform

When using the Lua scripting system in Fusion 9 and Resolve 15 it can be helpful to check the current host operating system platform before running any code that might be OS specific:

Code: [Select all] [Expand/Collapse] [Download] (Platform.lua)

-- Check the current computer platform
local platform = (FuPLATFORM_WINDOWS and 'Windows') or (FuPLATFORM_MAC and 'Mac') or (FuPLATFORM_LINUX and 'Linux')
 
-- Add the platform specific folder slash character
osSeparator = package.config:sub(1,1)
 
-- Find the user's home folder location using the OS native environment variable on Windows/Mac/Linux
if platform == 'Windows' then
    homeFolder = tostring(os.getenv('USERPROFILE')) .. osSeparator
elseif platform == 'Mac' then
    homeFolder = tostring(os.getenv('HOME')) .. osSeparator
elseif platform  == 'Linux' then
    homeFolder = tostring(os.getenv('HOME')) .. osSeparator
end
 
print(homeFolder)
 

PathMap Lookups

If you want to take advantage of Fusion's PathMap based relative filepaths then the "MapPath" function comes in handy. You can run the PathMap conversion function in the current composite (comp:) or global (fusion:) scope. The composite scope means any custom settings defined in an individual Fusion 9 .comp file are utilized.

pathmap-comp-scope.png

Code: [Select all] [Expand/Collapse] [Download] (PathMap Comp Scope.lua)

-- Convert a PathMap using the global + comp based PathMap settings
path = comp:MapPath('Brushes:/smile.tga')
print(path)
 

or

Code: [Select all] [Expand/Collapse] [Download] (PathMap Global Scope.lua)

-- Convert a PathMap using just global PathMap settings
path = fusion:MapPath('Profile:/RenderNode.prefs')
print(path)
 

Active Composite Filepath

There are several ways to find out the filepath for the active composite. If you are gong to use this to discover the absolute filepath for a item in the same folder a PathMap lookup works well. In Fusion 9 this command would tell you where a file was relative to the current open Fusion composite:

Code: [Select all] [Expand/Collapse] [Download] (Active Composite Filepath.lua)

-- Find out the location of an asset relative to the active composite file on disk
dump(comp:MapPath('Comp:/Render/output.mp4'))
 

Note: In Resolve 15's Fusion page environment the "Comp:/" PathMap location is translated to:

Code: Select all

$HOME/Documents/Blackmagic Design/DaVinci Resolve/Fusion/

Open URLs

The Resolve API has added a new Lua script function that makes it easy to have a script open a webpage URL in the default web browser.

Code: [Select all] [Expand/Collapse] [Download] (OpenURL.lua)

-- Open a webpage URL in the default web browser
if bmd.openurl then
    url = 'https://www.steakunderwater.com'
    bmd.openurl(url)
    print('[Opening URL] ' .. url .. '\n')
end
 

OpenURL.png

Note: The new "bmd.openurl()" function is not present in Fusion 9. The "if" check in the code snippet is used to make sure legacy copies of the Fuscript API in Fusion 7-9 don't stop and abort running the rest of your Lua script code with an error message "[string "???"]:2: attempt to call field 'openurl' (a nil value)[/i" when this URL opening command is used.

Open Files Externally and Folders

The Resolve API and Fusion 9 both support a new "bmd.openfileexternal()" function that allows you to open files using their default handler program.

Code: [Select all] [Expand/Collapse] [Download] (OpenFile.lua)

-- Open a filepath in the default program
 
-- Convert the PathMap
path = comp:MapPath('Brushes:/smile.tga')
 
-- Open the folder view
if bmd.fileexists(path) then
    bmd.openfileexternal('Open', path)
    print('[Opening File] ' .. path .. '\n')
end
 

OpenFile.png

Open Folders Externally

If you specify a folder name when running the "bmd.openfileexternal()" function then a desktop folder view will be opened up using Explorer(Windows) / Finder(macOS) / Nautilius(Linux).

Code: [Select all] [Expand/Collapse] [Download] (OpenFolder.lua)

-- Open a folder using the desktop folder view
 
-- Add the platform specific folder slash character
osSeparator = package.config:sub(1,1)
 
-- Convert the PathMap and extract just the foldername from the filepath
path = comp:MapPath('Reactor:/Deploy/'):match('(.*' .. osSeparator .. ')')
 
-- Open the folder view
if bmd.fileexists(path) then
    bmd.openfileexternal('Open', path)
    print('[Opening Folder] ' .. path .. '\n')
end
 

OpenFolder.png

#15

Printing out the Fusion Functions

Just like the GetHelp command was able to be used to list the Resolve API commands, you can also use GetHelp to list the Fusion page API functions, too. Some of these commands reported would be undocumented internal functions used by Fusion, or were only described briefly in an old Eyeon era Fusion user manual / VFXpedia website archive / Fusion 6.4 - 7.7 bundled Lua script examples.

This Lua script is used to list the built-in "fusion:" and "comp:" pointer based functions:

Code: [Select all] [Expand/Collapse] [Download] (FusionAPI.lua)

dump(fusion:GetHelp('Fusion'))
dump(comp:GetHelp('Composition'))
 

The Console text that comes back lists all of the built-in Fusion functions you would need to interact with your Fusion page composite:

Code: [Select all] [Expand/Collapse] [Download] (FusionAPI Output.txt)

dump(comp:GetHelp("Composition"))
Composition Members:
  Composition:AbortRender()
  Composition:AbortRenderUI()
  Composition.ActiveTool [R]          - Represents the currently active tool on this comp
  Composition:AddSettingAction()      - Adds a .settings to the comp
  Composition:AddTool()               - Adds a tool to the comp at a given position
  Composition:AddToolAction()         - Adds a tool to the comp
  Composition:AskRenderSettings()
  Composition:AskUser()               - Present a custom dialog to the user, and return selected values
  Composition.AutoPos [RW]
  Composition:ChooseAction()          - Displays a dialog with a list of selectable actions
  Composition:ChooseTool()            - Displays a dialog with a list of selectable tools
  Composition:ClearUndo()             - Clears the Undo/Redo history
  Composition:Close()                 - Close the composition
  Composition:Copy()                  - Copy a list of tools to the Clipboard
  Composition:CopySettings()          - Copy a list of tools to a settings table
  Composition.CurrentFrame [R]        - Represents the currently active frame for this composition
  Composition.CurrentTime [RW]        - The current time position for this composition
  Composition:DisableSelectedTools()  - Pass-through the selected tools
  Composition:EndUndo()               - End an undo event
  Composition:Execute()
  Composition:ExpandZone()
  Composition:FindTool()              - Finds first tool by name
  Composition:FindToolByID()          - Finds tools of a given type
  Composition:GetCompPathMap()        - Returns a table of all Composition path maps
  Composition:GetConsoleHistory()
  Composition:GetData()               - Get custom persistent data
  Composition:GetFrameList()
  Composition:GetNextKeyTime()        - Gets the next key time
  Composition:GetPrefs()              - Retrieve a table of preferences
  Composition:GetPrevKeyTime()        - Gets the previous key time
  Composition:GetPreviewList()        - Retrieves a table of previews
  Composition:GetRedoStack()
  Composition:GetToolList()           - Returns a list of all tools, or selected tools, in the composition
  Composition:GetUndoStack()
  Composition:GetViewList()
  Composition:Heartbeat()
  Composition:IsLocked()
  Composition:IsPlaying()
  Composition:IsReadOnly()
  Composition:IsRendering()
  Composition:IsViewShowing()
  Composition:IsZoneExpanded()
  Composition:Lock()                  - Lock the composition from updating
  Composition:Loop()                  - Enables looping interactive playback
  Composition:MapPath()               - Expands path mappings in a path string
  Composition:MapPathSegments()       - Expands all path mappings in a multipath
  Composition:NetRenderAbort()
  Composition:NetRenderEnd()
  Composition:NetRenderStart()
  Composition:NetRenderTime()
  Composition:Paste()                 - Paste tools from the Clipboard
  Composition:Play()                  - Starts interactive playback
  Composition:Print()
  Composition:Redo()                  - Redo one or more changes to the composition
  Composition:Render()                - Start a render
  Composition:ReverseMapPath()        - Collapses a path into best-matching path map
  Composition:RunScript()             - Run a script
  Composition:Save()                  - Save the composition
  Composition:SaveAs()                - Save the composition
  Composition:SaveCopyAs()            - Save a copy of the composition
  Composition:SaveVersion()           - Save the composition
  Composition:SetActiveTool()         - Set the currently active tool
  Composition:SetData()               - Set custom persistent data
  Composition:SetPrefs()              - Set preferences from a table of attributes
  Composition:SetReadOnly()
  Composition:ShowView()
  Composition:StartUndo()             - Start an undo event
  Composition:Stop()                  - Stops interactive playback
  Composition:Undo()                  - Undo one or more changes to the composition
  Composition:Unlock()                - Unlock the composition
  Composition.UpdateMode [RW]
  Composition:UpdateViews()
  Composition.XPos [RW]
  Composition.YPos [RW]
  Composition:_Output_Error()
  Composition:_Output_Print()
  Composition:_Save()
  Composition:_SaveAs()               - Save the composition
  Composition:_SaveCopyAs()           - Save a copy of the composition
  Composition:_SetCurrentTime()
  Object:Comp()
  Object:Composition()
  Object:DoAction()
  Object:GetData()                    - Get custom persistent data
  Object:GetID()
  Object:GetReg()
  Object:QueueAction()
  Object:SetData()                    - Set custom persistent data
  Object:TriggerEvent()
  :GetApp()
  :GetAttrs()
  :GetHelp()
  :GetHelpRaw()
  :SetAttrs()
 
 
dump(fusion:GetHelp("Fusion"))
Fusion Members:
  Fusion.ActionManager [R]           - The Global Action Manager
  Fusion:AddConfig()
  Fusion:AllowNetwork()
  Fusion.BinManager [R]              - Bins
  Fusion.Bins [R]                    - Bins
  Fusion.Build [R]                   - The build number of Fusion.
 
  Fusion.CacheManager [R]            - The Global Cache Manager
  Fusion:ClearFileLog()
  Fusion:ClearRecentCompList()
  Fusion:Copy()
  Fusion:CreateFloatingView()
  Fusion:CreateMail()                - Create an empty Mail message object
  Fusion.CurrentComp [R]             - Represents the currently active composition
  Fusion.CurrentFrame [R]
  Fusion:CustomizeToolbars()
  Fusion:Cut()
  Fusion:Delete()
  Fusion:DumpCgObjects()             - Dumps Cg Objects
  Fusion:DumpGLObjects()             - Dumps OpenGL Objects
  Fusion:DumpGraphicsHardwareInfo()  - Dumps OpenGL Objects
  Fusion:DumpOpenCLDeviceInfo()      - Dumps OpenCL device info
  Fusion:EditScript()                - Edit Script
  Fusion:Execute()
  Fusion.FileLogging [RW]
  Fusion:FindReg()                   - Find a registry object by ID
  Fusion.FontManager [R]             - The Global Font Manager
  Fusion:GetActiveFrameIndex()
  Fusion:GetActiveWndIndex()
  Fusion:GetAppInfo()
  Fusion:GetArgs()                   - Get command line arguments
  Fusion:GetCPULoad()
  Fusion:GetClipboard()              - Retrieves the tool(s) on the clipboard, as tables and as ASCII text.
  Fusion:GetCompList()               - Retrieves a table of all compositions currently present
  Fusion:GetCurrentComp()            - Returns the currently active composition
  Fusion:GetData()                   - Get custom persistent data
  Fusion:GetEnv()                    - Retrieve the value of an environment variable
  Fusion:GetGlobalPathMap()          - Returns a table of all global path maps
  Fusion:GetMainWindow()
  Fusion:GetMousePos()
  Fusion:GetNumRecentFiles()
  Fusion:GetPrefs()                  - Retrieve a table of preferences
  Fusion:GetPreviewList()            - Retrieves a table of global previews
  Fusion:GetRecentCompList()
  Fusion:GetRecentFileName()
  Fusion:GetRegAttrs()               - Retrieve information about a registry ID
  Fusion:GetRegList()                - Retrieve a list of all registry objects known to the system
  Fusion:GetRegSummary()             - Retrieve a list of basic info for all registry objects known to the system
  Fusion:GetResolve()
  Fusion:GetToolIcon()
  Fusion:GetToolList()
  Fusion:GetVersion()
  Fusion.HotkeyManager [R]           - The Global Hotkey Manager
  Fusion:IsNetworkAllowed()
  Fusion:IsUIVisible()
  Fusion:IsUtilityOpen()
  Fusion:LoadComp()                  - Loads an existing composition
  Fusion:LoadPrefs()                 - Reloads all current global preferences
  Fusion:LoadRecentComp()            - Loads an composition from the recent file list
  Fusion:MapPath()                   - Expands path mappings in a path string
  Fusion:MapPathSegments()           - Expands all path mappings in a multipath
  Fusion.MenuManager [R]             - The Global Menu Manager
  Fusion.MouseX [R]
  Fusion.MouseY [R]
  Fusion:NewComp()                   - Creates a new composition
  Fusion:NewFloatFrame()
  Fusion:NewImageView()
  Fusion:NewTabbedFrame()
  Fusion:OpenFile()                  - Open a file
  Fusion:OpenLibrary()
  Fusion:OpenLibraryStudio()
  Fusion:Paste()
  Fusion:PasteSettings()
  Fusion:QueueComp()                 - Queue a composition to be rendered locally
  Fusion.QueueManager [R]            - The global render manager for this instance of Fusion
  Fusion:Quit()                      - Quit Fusion
  Fusion:RemoveConfig()
  Fusion.RenderManager [R]           - The global render manager for this instance of Fusion
  Fusion:ReverseMapPath()            - Collapses a path into best-matching path map
  Fusion:RunScript()                 - Run a script
  Fusion:SavePrefs()                 - Saves all current global preferences
  Fusion:SelectAll()
  Fusion:SetActiveFrameIndex()
  Fusion:SetActiveWndIndex()
  Fusion:SetBatch()
  Fusion:SetClipboard()              - Sets the clipboard to contain the tool(s) specifed by a table or as ASCII text.
  Fusion:SetData()                   - Set custom persistent data
  Fusion:SetFusionApp()
  Fusion:SetMasterApp()
  Fusion:SetOnlyActiveComp()
  Fusion:SetPrefs()                  - Set preferences from a table of attributes
  Fusion:ShowAbout()                 - Display the About dialog
  Fusion:ShowPrefs()                 - Display the Preferences dialog
  Fusion:ShowUI()
  Fusion:ShowWindow()                - Show or Hide main window
  Fusion:Sleep()
  Fusion:Test()
  Fusion:ToggleBins()                - Shows or hides the Bins window
  Fusion:ToggleRenderManager()       - Shows or hides the Render Manager
  Fusion:ToggleUtility()             - Shows or hides a Utility plugin
  Fusion.UIManager [R]
  Fusion.Version [R]                 - The version number of Fusion.
 
  Fusion:_Memory_Purge()
  Fusion:_NewComp()                  - Creates a new composition
  Object:Comp()
  Object:Composition()
  Object:DoAction()
  Object:GetData()                   - Get custom persistent data
  Object:GetID()
  Object:GetReg()
  Object:QueueAction()
  Object:SetData()                   - Set custom persistent data
  Object:TriggerEvent()
  :GetApp()
  :GetAttrs()
  :GetHelp()
  :GetHelpRaw()
  :SetAttrs()
 

Accessing the hidden Fusion "Import" Menu Functions

If you miss the previous Fusion Studio "File > Import > " menu items when you are in Resolve 15, you can still run those commands directly from the Console using the Lua based "fu:ToggleUtility()" function.

Keep in mind the underlying Fusion import functions that are called by "fu:ToggleUtility()" are hidden for a reason: They haven't been updated yet fully to work in Resolve so I they are not Resolve Media Pool aware and may have other issues. This means you can try running the commands if you are feeling brave but you shouldn't be surprised when you run the FBX or Alembic import commands if you don't get a full 3D scene import with the texture maps loaded in correctly too.

Note: There is a little bit of random crashyness on MacOS for Lua based file requester dialogs in Resolve 15's initial public beta. Make sure to save your project once before running any of the ToggleUtility functions.

Show the ABC import dialog:

Code: [Select all] [Expand/Collapse] [Download] (AbcImport.lua)

fu:ToggleUtility('AbcImport')

Show the FBX import dialog:

Code: [Select all] [Expand/Collapse] [Download] (FBXImport.lua)

fu:ToggleUtility('FBXImport')

Show the SVG import dialog:

Code: [Select all] [Expand/Collapse] [Download] (SVGImport.lua)

fu:ToggleUtility('SVGImport')

Show the Shapes import dialog:

Code: [Select all] [Expand/Collapse] [Download] (ShapeImport.lua)

fu:ToggleUtility('ShapeImport')

Show the Tracks import dialog:

Code: [Select all] [Expand/Collapse] [Download] (TrackImport.lua)

fu:ToggleUtility('TrackImport')

Printing out Your PathMap Table

You can see a print out of the active PathMaps that are present in the Resolve Fusion page using this Lua command:

Code: [Select all] [Expand/Collapse] [Download] (GetGlobalPathMap.lua)

dump(fu:GetGlobalPathMap())

The Console text that comes back from running this PathMap function is:

Code: [Select all] [Expand/Collapse] [Download] (GetGlobalPathMap output.txt)

table: 0x01e6d1b870
    Queues: = AllDocs:Queue
    Guides: = UserPaths:Guides
    Templates: = UserPaths:Templates
    Config: = UserPaths:Config
    ResolveDB: = /Library/Application Support/Blackmagic Design/DaVinci Resolve/Resolve Disk Database/Resolve Projects/Users/guest/Projects/
    EditTemplates: = Templates:Edit
    Comps: = UserDocs:
    Macros: = UserPaths:Macros
    AutoSaves: = Comps:Default AutoSaves
    UserPaths: = UserData:;AllData:;Fusion:;Reactor:Deploy
    Layouts: = UserPaths:Layouts
    Reactor: = /Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Reactor/
    Defaults: = UserPaths:Defaults
    Libraries: = UserPaths:Library
    FusionTemplates: = Templates:Fusion
    Thumbs: = Stamps:
    UserDocs: = /Users/StatixVFX/Documents/Blackmagic Design/DaVinci Resolve/Fusion
    LuaModules: = UserPaths:Modules/Lua
    FusionLibs: = /Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Libraries/Fusion
    LoaderCache: = Temp:DiskCache
    Bins: = UserData:Bins
    Comp: = Comps:
    Profile: = Profiles:Default/
    Brushes: = UserPaths:Brushes
    AllLUTs: = LUTs:;/Library/Application Support/Blackmagic Design/DaVinci Resolve/LUT
    Profiles: = UserData:Profiles/
    AllDocs: = /Users/StatixVFX/Documents/Blackmagic Design/DaVinci Resolve/Fusion
    Temp: = /var/folders/q_/j93d7rd953zbvfstpxpt7nk00000gn/T/
    FFmpeg: = Reactor:/Deploy/Bin/ffmpeg/bin/
    UserData: = /Users/StatixVFX/Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion
    Scripts: = UserPaths:Scripts;Reactor:System/Scripts
    Fuses: = UserPaths:Fuses
    Previews: = Temp:
    Filters: = UserPaths:Filters
    AllData: = /Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion
    Fusion: = /Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Libraries/Fusion/../../Resources/Fusion
    Programs: = /Applications/
    DiskCaches: = Temp:DiskCache
    Settings: = UserPaths:Settings
    Fonts: = $(HOME)/Library/Fonts;/System/Library/Fonts;/Library/Fonts;/Network/Library/Fonts
    Help: = Fusion:Help;Fusion:../../..
    LUTs: = UserPaths:LUTs
    Stamps: = UserData:Stamps
    Plugins: = UserPaths:Plugins

Printing out the Fusion Registry

And finally you can print out the raw Fusion page registry data to the Console to see all of the installed and supported Fuses, Plugins, macros, image formats, video formats, and 3D mesh formats that are active:

Code: [Select all] [Expand/Collapse] [Download] (GetRegistry.lua)

dump(fu:GetRegSummary())

Resolve Scripting Essentials

Resolve Scripting Essentials

Scripting Resolve Media Pools and Media Storage Volumes

Resolve 15 Supports UI Manager GUIs

Resolve API Scripting Help

Re: Resolve Scripting Essentials

Installing Effects Library Templates in Resolve

Re: Resolve Scripting Essentials

Resolve is just a GUI to an Sqlite3 Media Database

Re: Resolve Scripting Essentials

Re: Resolve Scripting Essentials

Re: Resolve Scripting Essentials

UI Manager GUI Controls in Resolve

Re: Resolve Scripting Essentials

Opening External URLs, Files, and Folders

Viewing the Fusion API Functions in Resolve