Files

682 lines
28 KiB
Python

#!/usr/bin/env python3
""" Manages the widgets that hold the bottom 'control' area of the preview tool """
from __future__ import annotations
import gettext
import logging
import typing as T
import tkinter as tk
from tkinter import ttk
from configparser import ConfigParser
from lib.gui.custom_widgets import Tooltip
from lib.gui.control_helper import ControlPanel, ControlPanelOption
from lib.gui.utils import get_images
from plugins.plugin_loader import PluginLoader
from plugins.convert._config import Config
if T.TYPE_CHECKING:
from collections.abc import Callable
from .preview import Preview
logger = logging.getLogger(__name__)
# LOCALES
_LANG = gettext.translation("tools.preview", localedir="locales", fallback=True)
_ = _LANG.gettext
class ConfigTools():
""" Tools for loading, saving, setting and retrieving configuration file values.
Attributes
----------
tk_vars: dict
Global tkinter variables. `Refresh` and `Busy` :class:`tkinter.BooleanVar`
"""
def __init__(self) -> None:
self._config = Config(None)
self.tk_vars: dict[str, dict[str, tk.BooleanVar | tk.StringVar | tk.IntVar | tk.DoubleVar]
] = {}
self._config_dicts = self._get_config_dicts() # Holds currently saved config
@property
def config(self) -> Config:
""" :class:`plugins.convert._config.Config` The convert configuration """
return self._config
@property
def config_dicts(self) -> dict[str, T.Any]:
""" dict: The convert configuration options in dictionary form."""
return self._config_dicts
@property
def sections(self) -> list[str]:
""" list: The sorted section names that exist within the convert Configuration options. """
return sorted(set(plugin.split(".")[0] for plugin in self._config.config.sections()
if plugin.split(".")[0] != "writer"))
@property
def plugins_dict(self) -> dict[str, list[str]]:
""" dict: Dictionary of configuration option sections as key with a list of containing
plugins as the value """
return {section: sorted([plugin.split(".")[1] for plugin in self._config.config.sections()
if plugin.split(".")[0] == section])
for section in self.sections}
def update_config(self) -> None:
""" Update :attr:`config` with the currently selected values from the GUI. """
for section, items in self.tk_vars.items():
for item, value in items.items():
try:
new_value = str(value.get())
except tk.TclError as err:
# When manually filling in text fields, blank values will
# raise an error on numeric data types so return 0
logger.debug("Error getting value. Defaulting to 0. Error: %s", str(err))
new_value = str(0)
old_value = self._config.config[section][item]
if new_value != old_value:
logger.trace("Updating config: %s, %s from %s to %s", # type: ignore
section, item, old_value, new_value)
self._config.config[section][item] = new_value
def _get_config_dicts(self) -> dict[str, dict[str, T.Any]]:
""" Obtain a custom configuration dictionary for convert configuration items in use
by the preview tool formatted for control helper.
Returns
-------
dict
Each configuration section as keys, with the values as a dict of option:
:class:`lib.gui.control_helper.ControlOption` pairs. """
logger.debug("Formatting Config for GUI")
config_dicts: dict[str, dict[str, T.Any]] = {}
for section in self._config.config.sections():
if section.startswith("writer."):
continue
for key, val in self._config.defaults[section].items.items():
if key == "helptext":
config_dicts.setdefault(section, {})[key] = val
continue
cp_option = ControlPanelOption(title=key,
dtype=val.datatype,
group=val.group,
default=val.default,
initial_value=self._config.get(section, key),
choices=val.choices,
is_radio=val.gui_radio,
rounding=val.rounding,
min_max=val.min_max,
helptext=val.helptext)
self.tk_vars.setdefault(section, {})[key] = cp_option.tk_var
config_dicts.setdefault(section, {})[key] = cp_option
logger.debug("Formatted Config for GUI: %s", config_dicts)
return config_dicts
def reset_config_to_saved(self, section: str | None = None) -> None:
""" Reset the GUI parameters to their saved values within the configuration file.
Parameters
----------
section: str, optional
The configuration section to reset the values for, If ``None`` provided then all
sections are reset. Default: ``None``
"""
logger.debug("Resetting to saved config: %s", section)
sections = [section] if section is not None else list(self.tk_vars.keys())
for config_section in sections:
for item, options in self._config_dicts[config_section].items():
if item == "helptext":
continue
val = options.value
if val != self.tk_vars[config_section][item].get():
self.tk_vars[config_section][item].set(val)
logger.debug("Setting %s - %s to saved value %s", config_section, item, val)
logger.debug("Reset to saved config: %s", section)
def reset_config_to_default(self, section: str | None = None) -> None:
""" Reset the GUI parameters to their default configuration values.
Parameters
----------
section: str, optional
The configuration section to reset the values for, If ``None`` provided then all
sections are reset. Default: ``None``
"""
logger.debug("Resetting to default: %s", section)
sections = [section] if section is not None else list(self.tk_vars.keys())
for config_section in sections:
for item, options in self._config_dicts[config_section].items():
if item == "helptext":
continue
default = options.default
if default != self.tk_vars[config_section][item].get():
self.tk_vars[config_section][item].set(default)
logger.debug("Setting %s - %s to default value %s",
config_section, item, default)
logger.debug("Reset to default: %s", section)
def save_config(self, section: str | None = None) -> None:
""" Save the configuration ``.ini`` file with the currently stored values.
Notes
-----
We cannot edit the existing saved config as comments tend to get removed, so we create
a new config and populate that.
Parameters
----------
section: str, optional
The configuration section to save, If ``None`` provided then all sections are saved.
Default: ``None``
"""
logger.debug("Saving %s config", section)
new_config = ConfigParser(allow_no_value=True)
for section_name, sect in self._config.defaults.items():
logger.debug("Adding section: '%s')", section_name)
self._config.insert_config_section(section_name,
sect.helptext,
config=new_config)
for item, options in sect.items.items():
if item == "helptext":
continue # helptext already written at top
if ((section is not None and section_name != section)
or section_name not in self.tk_vars):
# retain saved values that have not been updated
new_opt = self._config.get(section_name, item)
logger.debug("Retaining option: (item: '%s', value: '%s')", item, new_opt)
else:
new_opt = self.tk_vars[section_name][item].get()
logger.debug("Setting option: (item: '%s', value: '%s')", item, new_opt)
# Set config_dicts value to new saved value
self._config_dicts[section_name][item].set_initial_value(new_opt)
helptext = self._config.format_help(options.helptext, is_section=False)
new_config.set(section_name, helptext)
new_config.set(section_name, item, str(new_opt))
self._config.config = new_config
self._config.save_config()
logger.info("Saved config: '%s'", self._config.configfile)
class BusyProgressBar():
""" An infinite progress bar for when a thread is running to swap/patch a group of samples """
def __init__(self, parent: ttk.Frame) -> None:
self._progress_bar = self._add_busy_indicator(parent)
def _add_busy_indicator(self, parent: ttk.Frame) -> ttk.Progressbar:
""" Place progress bar into bottom bar to indicate when processing.
Parameters
----------
parent: tkinter object
The tkinter object that holds the busy indicator
Returns
-------
ttk.Progressbar
A Progress bar to indicate that the Preview tool is busy
"""
logger.debug("Placing busy indicator")
pbar = ttk.Progressbar(parent, mode="indeterminate")
pbar.pack(side=tk.LEFT)
pbar.pack_forget()
return pbar
def stop(self) -> None:
""" Stop and hide progress bar """
logger.debug("Stopping busy indicator")
if not self._progress_bar.winfo_ismapped():
logger.debug("busy indicator already hidden")
return
self._progress_bar.stop()
self._progress_bar.pack_forget()
def start(self) -> None:
""" Start and display progress bar """
logger.debug("Starting busy indicator")
if self._progress_bar.winfo_ismapped():
logger.debug("busy indicator already started")
return
self._progress_bar.pack(side=tk.LEFT, padx=5, pady=(5, 10), fill=tk.X, expand=True)
self._progress_bar.start(25)
class ActionFrame(ttk.Frame): # pylint:disable=too-many-ancestors
""" Frame that holds the left hand side options panel containing the command line options.
Parameters
----------
app: :class:`Preview`
The main tkinter Preview app
parent: tkinter object
The parent tkinter object that holds the Action Frame
"""
def __init__(self, app: Preview, parent: ttk.Frame) -> None:
logger.debug("Initializing %s: (app: %s, parent: %s)",
self.__class__.__name__, app, parent)
self._app = app
super().__init__(parent)
self.pack(side=tk.LEFT, anchor=tk.N, fill=tk.Y)
self._tk_vars: dict[str, tk.StringVar] = {}
self._options = {
"color": app._patch.converter.cli_arguments.color_adjustment.replace("-", "_"),
"mask_type": app._patch.converter.cli_arguments.mask_type.replace("-", "_"),
"face_scale": app._patch.converter.cli_arguments.face_scale}
defaults = {opt: self._format_to_display(val) if opt != "face_scale" else val
for opt, val in self._options.items()}
self._busy_bar = self._build_frame(defaults,
app._samples.generate,
app._refresh,
app._samples.available_masks,
app._samples.predictor.has_predicted_mask)
@property
def convert_args(self) -> dict[str, T.Any]:
""" dict: Currently selected Command line arguments from the :class:`ActionFrame`. """
retval = {opt if opt != "color" else "color_adjustment":
self._format_from_display(self._tk_vars[opt].get())
for opt in self._options if opt != "face_scale"}
retval["face_scale"] = self._tk_vars["face_scale"].get()
return retval
@property
def busy_progress_bar(self) -> BusyProgressBar:
""" :class:`BusyProgressBar`: The progress bar that appears on the left hand side whilst a
swap/patch is being applied """
return self._busy_bar
@staticmethod
def _format_from_display(var: str) -> str:
""" Format a variable from the display version to the command line action version.
Parameters
----------
var: str
The variable name to format
Returns
-------
str
The formatted variable name
"""
return var.replace(" ", "_").lower()
@staticmethod
def _format_to_display(var: str) -> str:
""" Format a variable from the command line action version to the display version.
Parameters
----------
var: str
The variable name to format
Returns
-------
str
The formatted variable name
"""
return var.replace("_", " ").replace("-", " ").title()
def _build_frame(self,
defaults: dict[str, T.Any],
refresh_callback: Callable[[], None],
patch_callback: Callable[[], None],
available_masks: list[str],
has_predicted_mask: bool) -> BusyProgressBar:
""" Build the :class:`ActionFrame`.
Parameters
----------
defaults: dict
The default command line options
patch_callback: python function
The function to execute when a patch callback is received
refresh_callback: python function
The function to execute when a refresh callback is received
available_masks: list
The available masks that exist within the alignments file
has_predicted_mask: bool
Whether the model was trained with a mask
Returns
-------
ttk.Progressbar
A Progress bar to indicate that the Preview tool is busy
"""
logger.debug("Building Action frame")
bottom_frame = ttk.Frame(self)
bottom_frame.pack(side=tk.BOTTOM, fill=tk.X, anchor=tk.S)
top_frame = ttk.Frame(self)
top_frame.pack(side=tk.TOP, fill=tk.BOTH, anchor=tk.N, expand=True)
self._add_cli_choices(top_frame, defaults, available_masks, has_predicted_mask)
busy_indicator = BusyProgressBar(bottom_frame)
self._add_refresh_button(bottom_frame, refresh_callback)
self._add_patch_callback(patch_callback)
self._add_actions(bottom_frame)
logger.debug("Built Action frame")
return busy_indicator
def _add_cli_choices(self,
parent: ttk.Frame,
defaults: dict[str, T.Any],
available_masks: list[str],
has_predicted_mask: bool) -> None:
""" Create :class:`lib.gui.control_helper.ControlPanel` object for the command
line options.
parent: :class:`ttk.Frame`
The frame to hold the command line choices
defaults: dict
The default command line options
available_masks: list
The available masks that exist within the alignments file
has_predicted_mask: bool
Whether the model was trained with a mask
"""
cp_options = self._get_control_panel_options(defaults, available_masks, has_predicted_mask)
panel_kwargs = {"blank_nones": False, "label_width": 10, "style": "CPanel"}
ControlPanel(parent, cp_options, header_text=None, **panel_kwargs)
def _get_control_panel_options(self,
defaults: dict[str, T.Any],
available_masks: list[str],
has_predicted_mask: bool) -> list[ControlPanelOption]:
""" Create :class:`lib.gui.control_helper.ControlPanelOption` objects for the command
line options.
defaults: dict
The default command line options
available_masks: list
The available masks that exist within the alignments file
has_predicted_mask: bool
Whether the model was trained with a mask
Returns
-------
list
The list of `lib.gui.control_helper.ControlPanelOption` objects for the Action Frame
"""
cp_options: list[ControlPanelOption] = []
for opt in self._options:
if opt == "face_scale":
cp_option = ControlPanelOption(title=opt,
dtype=float,
default=0.0,
rounding=2,
min_max=(-10., 10.),
group="Command Line Choices")
else:
if opt == "mask_type":
choices = self._create_mask_choices(defaults,
available_masks,
has_predicted_mask)
else:
choices = PluginLoader.get_available_convert_plugins(opt, True)
cp_option = ControlPanelOption(title=opt,
dtype=str,
default=defaults[opt],
initial_value=defaults[opt],
choices=choices,
group="Command Line Choices",
is_radio=False)
self._tk_vars[opt] = cp_option.tk_var
cp_options.append(cp_option)
return cp_options
def _create_mask_choices(self,
defaults: dict[str, T.Any],
available_masks: list[str],
has_predicted_mask: bool) -> list[str]:
""" Set the mask choices and default mask based on available masks.
Parameters
----------
defaults: dict
The default command line options
available_masks: list
The available masks that exist within the alignments file
has_predicted_mask: bool
Whether the model was trained with a mask
Returns
-------
list
The masks that are available to use from the alignments file
"""
logger.debug("Initial mask choices: %s", available_masks)
if has_predicted_mask:
available_masks += ["predicted"]
if "none" not in available_masks:
available_masks += ["none"]
if self._format_from_display(defaults["mask_type"]) not in available_masks:
logger.debug("Setting default mask to first available: %s", available_masks[0])
defaults["mask_type"] = available_masks[0]
logger.debug("Final mask choices: %s", available_masks)
return available_masks
@classmethod
def _add_refresh_button(cls,
parent: ttk.Frame,
refresh_callback: Callable[[], None]) -> None:
""" Add a button to refresh the images.
Parameters
----------
refresh_callback: python function
The function to execute when the refresh button is pressed
"""
btn = ttk.Button(parent, text="Update Samples", command=refresh_callback)
btn.pack(padx=5, pady=5, side=tk.TOP, fill=tk.X, anchor=tk.N)
def _add_patch_callback(self, patch_callback: Callable[[], None]) -> None:
""" Add callback to re-patch images on action option change.
Parameters
----------
patch_callback: python function
The function to execute when the images require patching
"""
for tk_var in self._tk_vars.values():
tk_var.trace("w", patch_callback)
def _add_actions(self, parent: ttk.Frame) -> None:
""" Add Action Buttons to the :class:`ActionFrame`
Parameters
----------
parent: tkinter object
The tkinter object that holds the action buttons
"""
logger.debug("Adding util buttons")
frame = ttk.Frame(parent)
frame.pack(padx=5, pady=(5, 10), side=tk.RIGHT, fill=tk.X, anchor=tk.E)
for utl in ("save", "clear", "reload"):
logger.debug("Adding button: '%s'", utl)
img = get_images().icons[utl]
if utl == "save":
text = _("Save full config")
action = self._app.config_tools.save_config
elif utl == "clear":
text = _("Reset full config to default values")
action = self._app.config_tools.reset_config_to_default
elif utl == "reload":
text = _("Reset full config to saved values")
action = self._app.config_tools.reset_config_to_saved
btnutl = ttk.Button(frame,
image=img,
command=action)
btnutl.pack(padx=2, side=tk.RIGHT)
Tooltip(btnutl, text=text, wrap_length=200)
logger.debug("Added util buttons")
class OptionsBook(ttk.Notebook): # pylint:disable=too-many-ancestors
""" The notebook that holds the Convert configuration options.
Parameters
----------
parent: tkinter object
The parent tkinter object that holds the Options book
config_tools: :class:`ConfigTools`
Tools for loading and saving configuration files
patch_callback: python function
The function to execute when a patch callback is received
Attributes
----------
config_tools: :class:`ConfigTools`
Tools for loading and saving configuration files
"""
def __init__(self,
parent: ttk.Frame,
config_tools: ConfigTools,
patch_callback: Callable[[], None]) -> None:
logger.debug("Initializing %s: (parent: %s, config: %s)",
self.__class__.__name__, parent, config_tools)
super().__init__(parent)
self.pack(side=tk.RIGHT, anchor=tk.N, fill=tk.BOTH, expand=True)
self.config_tools = config_tools
self._tabs: dict[str, dict[str, ttk.Notebook | ConfigFrame]] = {}
self._build_tabs()
self._build_sub_tabs()
self._add_patch_callback(patch_callback)
logger.debug("Initialized %s", self.__class__.__name__)
def _build_tabs(self) -> None:
""" Build the notebook tabs for the each configuration section. """
logger.debug("Build Tabs")
for section in self.config_tools.sections:
tab = ttk.Notebook(self)
self._tabs[section] = {"tab": tab}
self.add(tab, text=section.replace("_", " ").title())
def _build_sub_tabs(self) -> None:
""" Build the notebook sub tabs for each convert section's plugin. """
for section, plugins in self.config_tools.plugins_dict.items():
for plugin in plugins:
config_key = ".".join((section, plugin))
config_dict = self.config_tools.config_dicts[config_key]
tab = ConfigFrame(self, config_key, config_dict)
self._tabs[section][plugin] = tab
text = plugin.replace("_", " ").title()
T.cast(ttk.Notebook, self._tabs[section]["tab"]).add(tab, text=text)
def _add_patch_callback(self, patch_callback: Callable[[], None]) -> None:
""" Add callback to re-patch images on configuration option change.
Parameters
----------
patch_callback: python function
The function to execute when the images require patching
"""
for plugins in self.config_tools.tk_vars.values():
for tk_var in plugins.values():
tk_var.trace("w", patch_callback)
class ConfigFrame(ttk.Frame): # pylint:disable=too-many-ancestors
""" Holds the configuration options for a convert plugin inside the :class:`OptionsBook`.
Parameters
----------
parent: tkinter object
The tkinter object that will hold this configuration frame
config_key: str
The section/plugin key for these configuration options
options: dict
The options for this section/plugin
"""
def __init__(self,
parent: OptionsBook,
config_key: str,
options: dict[str, T.Any]):
logger.debug("Initializing %s", self.__class__.__name__)
super().__init__(parent)
self.pack(side=tk.TOP, fill=tk.BOTH, expand=True)
self._options = options
self._action_frame = ttk.Frame(self)
self._action_frame.pack(padx=0, pady=(0, 5), side=tk.BOTTOM, fill=tk.X, anchor=tk.E)
self._add_frame_separator()
self._build_frame(parent, config_key)
logger.debug("Initialized %s", self.__class__.__name__)
def _build_frame(self, parent: OptionsBook, config_key: str) -> None:
""" Build the options frame for this command
Parameters
----------
parent: tkinter object
The tkinter object that will hold this configuration frame
config_key: str
The section/plugin key for these configuration options
"""
logger.debug("Add Config Frame")
panel_kwargs = {"columns": 2, "option_columns": 2, "blank_nones": False, "style": "CPanel"}
frame = ttk.Frame(self)
frame.pack(side=tk.TOP, fill=tk.BOTH, expand=True)
cp_options = [opt for key, opt in self._options.items() if key != "helptext"]
ControlPanel(frame, cp_options, header_text=None, **panel_kwargs)
self._add_actions(parent, config_key)
logger.debug("Added Config Frame")
def _add_frame_separator(self) -> None:
""" Add a separator between top and bottom frames. """
logger.debug("Add frame seperator")
sep = ttk.Frame(self._action_frame, height=2, relief=tk.RIDGE)
sep.pack(fill=tk.X, pady=5, side=tk.TOP)
logger.debug("Added frame seperator")
def _add_actions(self, parent: OptionsBook, config_key: str) -> None:
""" Add Action Buttons.
Parameters
----------
parent: tkinter object
The tkinter object that will hold this configuration frame
config_key: str
The section/plugin key for these configuration options
"""
logger.debug("Adding util buttons")
title = config_key.split(".")[1].replace("_", " ").title()
btn_frame = ttk.Frame(self._action_frame)
btn_frame.pack(padx=5, side=tk.BOTTOM, fill=tk.X)
for utl in ("save", "clear", "reload"):
logger.debug("Adding button: '%s'", utl)
img = get_images().icons[utl]
if utl == "save":
text = _(f"Save {title} config")
action = parent.config_tools.save_config
elif utl == "clear":
text = _(f"Reset {title} config to default values")
action = parent.config_tools.reset_config_to_default
elif utl == "reload":
text = _(f"Reset {title} config to saved values")
action = parent.config_tools.reset_config_to_saved
btnutl = ttk.Button(btn_frame,
image=img,
command=lambda cmd=action: cmd(config_key)) # type: ignore
btnutl.pack(padx=2, side=tk.RIGHT)
Tooltip(btnutl, text=text, wrap_length=200)
logger.debug("Added util buttons")