StillManager#

class pybmd.toolkits.StillManager(project: Project, timeline_framerate=24)[source]

Bases: object

all about stills from timeline

Methods

__init__(project[, timeline_framerate])

clean_and_rename_stills(still_file_path[, ...])

Normalize exported still names and optionally clean up DRX files.

export_stills(export_base_path[, ...])

export stills to given path

grab_all_still([timeline, grab_sleep_time, ...])

Grab a still for each clip in the first video track and store metadata.

grab_still_from_timeline_markers([timeline, ...])

Grab stills at each marker location on the requested timeline.

Attributes

STILL_NAME_WILDCARD_MAPPING

Parameters:

project (Project)

grab_still_from_timeline_markers(timeline: Timeline = None, grab_sleep_time: float = 0.5) → List[MarkerStill][source]

Grab stills at each marker location on the requested timeline.

Parameters:

  • timeline (Timeline, optional) – Timeline to evaluate. Defaults to the manager timeline.

  • grab_sleep_time (float, optional) – Seconds to sleep between grabs, allowing Resolve to update the gallery.

Returns:

Still metadata accumulated so far.

Return type:

List[MarkerStill]

grab_all_still(timeline: Timeline = None, grab_sleep_time: float = 0.5, still_position: float = 0.5)[source]

Grab a still for each clip in the first video track and store metadata.

Parameters:

  • timeline (Timeline, optional) – Timeline to scan; defaults to the manager’s current timeline.

  • grab_sleep_time (float, optional) – Delay inserted after each grab so Resolve can finish writing the still.

  • still_position (float, optional) – Normalized position within each clip (0=start, 1=end); values outside the range are clamped.

Returns:

Still metadata accumulated so far.

Return type:

List[MarkerStill]

export_stills(export_base_path: str, file_name_format: str = '$file_name$_$clip_frame_tc$', format: StillFormat = StillFormat.TIF, clean_drx: bool = True, clean_still_album: bool = False, use_subfolder: bool = False, subfolder: str = '')[source]

export stills to given path

Parameters:

  • export_path (str) – stills export path

  • file_name_format (str, optional) – file name format. accept $file_name$,$reel_name$,$reel_number$,$frames$,$clip_frame_tc$ and all clip property keys show at Davinci Resolve GUI as wildcard. Defaults to “$file_name$_$clip_frame_tc$”.

  • format (StillFormat, optional) – exported stills format. Defaults to StillFormat.TIF.

  • clean_drx (bool, optional) – clean drx files after stills exported. Defaults to True.

  • clean_still_album (bool, optional) – clean still album after stills exported. Defaults to True.

  • use_subfolder (bool, optional) – use subfolder to export stills. Defaults to False.

  • subfolder (str, optional) – subfolder name to export stills. Defaults to “”.

  • export_base_path (str)

clean_and_rename_stills(still_file_path: str, clean_drx: bool = True, export_folder_exist_file_list: Iterable[str] | None = None)[source]

Normalize exported still names and optionally clean up DRX files.

Parameters:

  • still_file_path (str)

  • clean_drx (bool)

  • export_folder_exist_file_list (Iterable[str] | None)

This Page