Luce packages
LuceLuce BaseLuciaOS

dymokomi/luced-2d

Source of release 0.5.1

0.5.1 / src / actions.luc

## One Command instance per action, as in luced: the menus, the tool rail and
## the keyboard all present the same command, so a shortcut shows beside its
## menu item and disabling an action disables it everywhere at once.
from adjustments import adjustments, applies_at_once
from luce_ui import ui
from luce_ui.ui import Command, Shortcut
from luce_window.input import Key
from workspace import Workspace
from luce_image.canvas import Canvas
from tools import tools
from units import unit_ids, unit_label
from panel_list import panel_entries
from align import align_modes, align_title
import platform

pub class Actions:
    # File
    pub let new_document: Command
    pub let open_document: Command
    ## File › Import Images…: pictures placed as new layers, one each.
    pub let import_image: Command
    pub let save: Command
    pub let save_as: Command
    pub let close_document: Command
    ## File › Script Editor…: write and run scripts over these commands.
    pub let script_editor: Command
    pub let next_document: Command
    pub let previous_document: Command
    ## File › Exit (Quit on macOS): asks about unsaved documents, then ends the run.
    pub let exit_app: Command
    ## Window › each panel, ticked while it is open (panel_list.luc's order).
    pub let windows: list[Command]
    ## Layer › Align and Distribute, in align.luc's order (align_modes).
    pub let aligns: list[Command]
    ## Window › Reset Layout: the panels as they first were.
    pub let reset_layout: Command
    # Edit
    pub let undo: Command
    pub let redo: Command
    ## The system clipboard: the selected pixels of the layer (or, Copy Merged,
    ## of the whole picture) as an image; Paste makes a new layer. With no
    ## pixels selected, Copy and Cut take the selected layers whole
    ## (layer_transfer.luc); Paste in Place keeps where they were.
    pub let cut: Command
    pub let copy: Command
    pub let copy_merged: Command
    pub let paste: Command
    pub let paste_in_place: Command
    pub let fill: Command
    ## Edit › Define Brush Preset…: the selected pixels as a new brush's tip.
    pub let define_brush: Command
    pub let fill_background: Command
    ## The fills on Delete as well as Backspace, as Photoshop has them on
    ## Windows keyboards: a command has one shortcut, so each is its own.
    pub let fill_delete: Command
    ## Redo on Ctrl+Y too, which Windows users expect beside Ctrl+Shift+Z.
    pub let redo_y: Command
    ## Next and previous document on Ctrl+Tab and Ctrl+Shift+Tab too, as Photoshop.
    pub let next_document_tab: Command
    pub let previous_document_tab: Command
    pub let fill_background_delete: Command
    pub let clear: Command
    pub let swap_colors: Command
    pub let reset_colors: Command
    pub let export_png: Command
    pub let export_jpeg: Command
    pub let free_transform: Command
    ## Edit › Transform's modes of the free-transform box, Warp and Puppet Warp.
    pub let transform_skew: Command
    pub let transform_distort: Command
    pub let transform_perspective: Command
    pub let transform_warp: Command
    pub let puppet_warp: Command
    pub let commit_text: Command
    pub let flip_horizontal: Command
    pub let flip_vertical: Command
    pub let settings: Command
    # Select
    pub let select_all: Command
    ## Select › Subject and Object in Selection; Layer › Remove Background.
    pub let color_range: Command
    pub let replace_color: Command
    pub let deselect: Command
    pub let inverse: Command
    pub let expand: Command
    pub let contract: Command
    pub let feather: Command
    pub let border: Command
    pub let smooth: Command
    pub let grow: Command
    pub let similar: Command
    pub let transform_selection: Command
    pub let quick_mask: Command
    pub let select_mask: Command
    ## Select › Load Selection… and Save Selection…: alpha channels (channel_dialogs.luc).
    pub let load_selection: Command
    pub let save_selection: Command
    # Image
    pub let crop: Command
    pub let flip_canvas_horizontal: Command
    pub let flip_canvas_vertical: Command
    pub let canvas_size: Command
    pub let reveal_all: Command
    pub let image_size: Command
    pub let trim: Command
    # Adjust, one per luce-image adjustment kind, and Filter
    pub let adjustments: list[Command]
    ## One per adjustment an adjustment layer can hold: a new one of that kind.
    pub let adjustment_layers: list[Command]
    pub let blur: Command
    ## Filter menu: luce-image's filters by number (Motion Blur, Lens
    ## Correction, Bloom, Tonal Contrast).
    pub let filters: list[Command]
    pub let add_noise: Command
    # Layer
    pub let add_layer: Command
    pub let add_vector_layer: Command
    pub let duplicate_layer: Command
    ## Cmd-J and Shift-Cmd-J: a new layer of the selected pixels, copied or cut.
    pub let layer_via_copy: Command
    pub let layer_via_cut: Command
    pub let layer_up: Command
    pub let layer_down: Command
    pub let merge_down: Command
    pub let delete_layer: Command
    pub let group_layers: Command
    pub let ungroup: Command
    pub let move_out_of_folder: Command
    pub let toggle_mask: Command
    pub let hide_all_mask: Command
    pub let toggle_mask_enabled: Command
    pub let toggle_mask_link: Command
    pub let copy_mask: Command
    ## An adjustment dialog's Preview, on and off.
    pub let toggle_preview: Command
    pub let paste_mask: Command
    pub let load_transparency: Command
    pub let toggle_mask_editing: Command
    pub let toggle_clipped: Command
    pub let toggle_visibility: Command
    pub let layer_style: Command
    pub let rename_layer: Command
    pub let blends: list[Command]
    ## Shift + and Shift -: the selected layer's blend mode, one step through Photoshop's list.
    pub let next_blend: Command
    pub let previous_blend: Command
    # View
    pub let fit: Command
    pub let show_rulers: Command
    pub let show_transform_controls: Command
    pub let show_guides: Command
    pub let snap: Command
    pub let lock_guides: Command
    pub let clear_guides: Command
    pub let show_grid: Command
    ## Rulers and sizes in pixels, millimeters or inches.
    pub let units: list[Command]
    pub let document_settings: Command
    pub let actual_size: Command
    pub let zoom_in: Command
    pub let zoom_out: Command
    ## One command per tool, in `tools()` order; the command id is the tool's id.
    pub let tools: list[Command]
    pub let bigger: Command
    pub let smaller: Command
    ## Shift ] and Shift [: the brush's hardness by a quarter.
    pub let harder: Command
    pub let softer: Command
    pub let all: list[Command]

    pub func init(self) -> unit!:
        self.new_document = Command("New…", Shortcut(Key.n, primary = true), id = "new")
        self.open_document = Command("Open…", Shortcut(Key.o, primary = true), id = "open")
        self.import_image = Command("Import Images…", id = "import_image")
        self.save = Command("Save", Shortcut(Key.s, primary = true), id = "save")
        self.save_as = Command("Save As…", Shortcut(Key.s, primary = true, shift = true), id = "save_as")
        self.close_document = Command("Close", Shortcut(Key.w, primary = true), id = "close_document")
        self.script_editor = Command("Script Editor…", Shortcut(Key.e, primary = true, alt = true), id = "script_editor")
        self.next_document = Command("Next Document", Shortcut(Key.right_bracket, primary = true, alt = true), id = "next_document")
        self.previous_document = Command("Previous Document", Shortcut(Key.left_bracket, primary = true, alt = true), id = "previous_document")
        self.next_document_tab = Command("Next Document (Tab)", Shortcut(Key.tab, primary = true), id = "next_document_tab")
        self.previous_document_tab = Command("Previous Document (Tab)", Shortcut(Key.tab, primary = true, shift = true), id = "previous_document_tab")
        self.undo = Command("Undo", Shortcut(Key.z, primary = true), id = "undo")
        self.redo = Command("Redo", Shortcut(Key.z, primary = true, shift = true), id = "redo")
        self.redo_y = Command("Redo (Y)", Shortcut(Key.y, primary = true), id = "redo_y")
        self.cut = Command("Cut", Shortcut(Key.x, primary = true), id = "cut")
        self.copy = Command("Copy", Shortcut(Key.c, primary = true), id = "copy")
        self.copy_merged = Command("Copy Merged", Shortcut(Key.c, primary = true, shift = true), id = "copy_merged")
        self.paste = Command("Paste", Shortcut(Key.v, primary = true), id = "paste")
        self.paste_in_place = Command("Paste in Place", Shortcut(Key.v, primary = true, shift = true), id = "paste_in_place")
        self.fill = Command("Fill Selection with Color", Shortcut(Key.backspace, alt = true), id = "fill")
        self.clear = Command("Clear Selection", Shortcut(ui.clear_key()), id = "clear")
        self.define_brush = Command("Define Brush Preset…", id = "define_brush")
        self.fill_background = Command("Fill Selection with Background", Shortcut(Key.backspace, primary = true), id = "fill_background")
        self.fill_delete = Command("Fill Selection with Color (Delete)", Shortcut(Key.delete, alt = true), id = "fill_delete")
        self.fill_background_delete = Command("Fill Selection with Background (Delete)", Shortcut(Key.delete, primary = true), id = "fill_background_delete")
        self.swap_colors = Command("Swap Colors", Shortcut(Key.x), id = "swap_colors")
        self.reset_colors = Command("Default Colors", Shortcut(Key.d), id = "reset_colors")
        self.export_png = Command("Export PNG…", Shortcut(Key.e, primary = true, shift = true), id = "export_png")
        self.export_jpeg = Command("Export JPEG…", Shortcut(Key.s, primary = true, shift = true, alt = true), id = "export_jpeg")
        self.free_transform = Command("Free Transform", Shortcut(Key.t, primary = true), id = "free_transform")
        self.transform_skew = Command("Transform › Skew", id = "transform_skew")
        self.transform_distort = Command("Transform › Distort", id = "transform_distort")
        self.transform_perspective = Command("Transform › Perspective", id = "transform_perspective")
        self.transform_warp = Command("Transform › Warp", id = "transform_warp")
        self.puppet_warp = Command("Puppet Warp", id = "puppet_warp")
        self.commit_text = Command("Commit Text", Shortcut(Key.enter, primary = true), id = "commit_text")
        self.flip_horizontal = Command("Flip Horizontal", id = "flip_horizontal")
        self.flip_vertical = Command("Flip Vertical", id = "flip_vertical")
        self.settings = Command("Settings…", Shortcut(Key.comma, primary = true), id = "settings")
        self.select_all = Command("All", Shortcut(Key.a, primary = true), id = "select_all")
        self.color_range = Command("Color Range…", id = "color_range")
        self.replace_color = Command("Replace Color…", id = "replace_color")
        self.deselect = Command("Deselect", Shortcut(Key.d, primary = true), id = "deselect")
        self.inverse = Command("Inverse", Shortcut(Key.i, primary = true, shift = true), id = "inverse")
        self.expand = Command("Expand…", id = "expand")
        self.contract = Command("Contract…", id = "contract")
        self.feather = Command("Feather…", id = "feather")
        self.border = Command("Border…", id = "border")
        self.smooth = Command("Smooth…", id = "smooth")
        self.grow = Command("Grow", id = "grow")
        self.similar = Command("Similar", id = "similar")
        self.transform_selection = Command("Transform Selection", id = "transform_selection")
        self.quick_mask = Command("Edit in Quick Mask Mode", Shortcut(Key.q), id = "quick_mask")
        self.select_mask = Command("Select and Mask…", Shortcut(Key.r, primary = true, alt = true), id = "select_mask")
        self.load_selection = Command("Load Selection…", id = "load_selection")
        self.save_selection = Command("Save Selection…", id = "save_selection")
        self.crop = Command("Crop to Selection", id = "crop")
        self.flip_canvas_horizontal = Command("Flip Canvas Horizontal", id = "flip_canvas_horizontal")
        self.flip_canvas_vertical = Command("Flip Canvas Vertical", id = "flip_canvas_vertical")
        self.canvas_size = Command("Canvas Size…", Shortcut(Key.c, primary = true, alt = true), id = "canvas_size")
        self.reveal_all = Command("Reveal All", id = "reveal_all")
        self.image_size = Command("Image Size…", Shortcut(Key.i, primary = true, alt = true), id = "image_size")
        self.trim = Command("Trim…", id = "trim")
        # The Adjust menu's upper half changes the pixels; the lower adds adjustment layers.
        self.adjustments = []
        self.adjustment_layers = []
        for adjustment in adjustments():
            let dots = "" if applies_at_once(adjustment.kind) else "…"
            self.adjustments.append(Command(adjustment.name + dots, adjustment_shortcut(adjustment.kind), id = f"adjust_{adjustment.kind}"))
            if adjustment.layerable:
                self.adjustment_layers.append(Command(f"New {adjustment.name} Layer", id = f"adjust_layer_{adjustment.kind}"))
        self.add_noise = Command("Add Noise…", id = "add_noise")
        self.blur = Command("Gaussian Blur…", id = "blur")
        self.filters = [Command("Motion Blur…", id = "motion_blur"), Command("Lens Correction…", Shortcut(Key.r, primary = true, shift = true), id = "lens_correction"),
                        Command("Bloom…", id = "bloom"), Command("Tonal Contrast…", id = "tonal_contrast")]
        self.add_layer = Command("New Layer", Shortcut(Key.n, primary = true, shift = true), id = "add_layer")
        self.add_vector_layer = Command("New Vector Layer", id = "add_vector_layer")
        self.duplicate_layer = Command("Duplicate Layer", id = "duplicate_layer")
        self.layer_via_copy = Command("Layer via Copy", Shortcut(Key.j, primary = true), id = "layer_via_copy")
        self.layer_via_cut = Command("Layer via Cut", Shortcut(Key.j, primary = true, shift = true), id = "layer_via_cut")
        self.layer_up = Command("Move Layer Up", Shortcut(Key.right_bracket, primary = true), id = "layer_up")
        self.layer_down = Command("Move Layer Down", Shortcut(Key.left_bracket, primary = true), id = "layer_down")
        self.merge_down = Command("Merge Down", Shortcut(Key.e, primary = true), id = "merge_down")
        self.delete_layer = Command("Delete Layer", Shortcut(Key.delete, primary = true, shift = true), id = "delete_layer")
        self.group_layers = Command("Group Layers", Shortcut(Key.g, primary = true), id = "group_layers")
        self.ungroup = Command("Ungroup Layers", Shortcut(Key.g, primary = true, shift = true), id = "ungroup")
        self.move_out_of_folder = Command("Move Out of Folder", id = "move_out_of_folder")
        self.toggle_mask = Command("Add / Remove Mask", id = "toggle_mask")
        self.hide_all_mask = Command("Add Mask Hiding All", id = "hide_all_mask")
        self.toggle_mask_enabled = Command("Disable / Enable Mask", id = "toggle_mask_enabled")
        self.toggle_mask_link = Command("Unlink / Link Mask", id = "toggle_mask_link")
        self.copy_mask = Command("Copy Mask", id = "copy_mask")
        self.toggle_preview = Command("Preview On / Off", Shortcut(Key.p, alt = true), id = "toggle_preview")
        self.paste_mask = Command("Paste Mask", id = "paste_mask")
        self.load_transparency = Command("Load Layer Transparency", id = "load_transparency")
        self.toggle_mask_editing = Command("Edit Mask / Pixels", Shortcut(Key.backslash), id = "toggle_mask_editing")
        self.toggle_clipped = Command("Clip to Below / Release", Shortcut(Key.g, primary = true, alt = true), id = "toggle_clipped")
        self.toggle_visibility = Command("Hide / Show", Shortcut(Key.h, primary = true, shift = true), id = "toggle_visibility")
        self.layer_style = Command("Layer Style…", id = "layer_style")
        self.rename_layer = Command("Rename Layer…", id = "rename_layer")
        self.blends = []
        var mode = 0
        while mode < Canvas.blend_mode_count():
            self.blends.append(Command(Canvas.blend_mode_name(mode), id = f"blend_{mode}"))
            mode += 1
        self.next_blend = Command("Next Blend Mode", Shortcut(Key.equal, shift = true), id = "next_blend")
        self.previous_blend = Command("Previous Blend Mode", Shortcut(Key.minus, shift = true), id = "previous_blend")
        self.fit = Command("Fit", Shortcut(Key.digit_0, primary = true), id = "fit")
        self.show_rulers = Command("Show Rulers", Shortcut(Key.r, primary = true), id = "show_rulers")
        self.show_transform_controls = Command("Show Transform Controls", Shortcut(Key.h, primary = true), id = "show_transform_controls")
        self.show_guides = Command("Show Guides", Shortcut(Key.semicolon, primary = true), id = "show_guides")
        self.snap = Command("Snap", Shortcut(Key.semicolon, primary = true, shift = true), id = "snap")
        self.lock_guides = Command("Lock Guides", Shortcut(Key.semicolon, primary = true, alt = true), id = "lock_guides")
        self.clear_guides = Command("Clear Guides", id = "clear_guides")
        self.show_grid = Command("Show Grid", Shortcut(Key.apostrophe, primary = true), id = "show_grid")
        self.units = []
        for unit_id in unit_ids():
            self.units.append(Command(unit_label(unit_id), id = f"units_{unit_id}"))
        self.document_settings = Command("Document Settings…", id = "document_settings")
        self.actual_size = Command("Actual Size", Shortcut(Key.digit_1, primary = true), id = "actual_size")
        self.zoom_in = Command("Zoom In", Shortcut(Key.equal, primary = true), id = "zoom_in")
        self.zoom_out = Command("Zoom Out", Shortcut(Key.minus, primary = true), id = "zoom_out")
        self.tools = []
        for tool in tools():
            let shortcut = Shortcut() if tool.key == Key.unknown else Shortcut(tool.key, shift = tool.shift)
            self.tools.append(Command(tool.name, shortcut, id = tool.id))
        self.exit_app = Command("Quit" if platform.macos else "Exit", Shortcut(Key.q, primary = true), id = "exit")
        self.windows = []
        for entry in panel_entries():
            self.windows.append(Command(entry.title, id = "window_" + entry.id))
        self.reset_layout = Command("Reset Layout", id = "reset_layout")
        self.aligns = []
        for each in align_modes():
            self.aligns.append(Command(align_title(each), id = "align_" + each))
        self.bigger = Command("Bigger Brush", Shortcut(Key.right_bracket), id = "bigger")
        self.smaller = Command("Smaller Brush", Shortcut(Key.left_bracket), id = "smaller")
        self.harder = Command("Harder Brush", Shortcut(Key.right_bracket, shift = true), id = "harder")
        self.softer = Command("Softer Brush", Shortcut(Key.left_bracket, shift = true), id = "softer")
        self.all = [self.new_document, self.open_document, self.import_image, self.save, self.save_as, self.export_png, self.export_jpeg, self.close_document, self.script_editor, self.next_document, self.previous_document, self.next_document_tab, self.previous_document_tab, self.undo, self.redo, self.redo_y, self.cut, self.copy, self.copy_merged, self.paste, self.paste_in_place, self.fill, self.define_brush, self.color_range, self.replace_color, self.fill_background, self.fill_delete, self.fill_background_delete, self.clear, self.swap_colors, self.reset_colors, self.free_transform, self.transform_skew, self.transform_distort, self.transform_perspective, self.transform_warp, self.puppet_warp, self.commit_text, self.flip_horizontal, self.flip_vertical, self.settings,
                    self.select_all, self.deselect, self.inverse, self.expand, self.contract, self.feather, self.border, self.smooth, self.grow, self.similar, self.transform_selection, self.quick_mask, self.select_mask, self.load_selection, self.save_selection,
                    self.crop, self.flip_canvas_horizontal, self.flip_canvas_vertical, self.canvas_size, self.reveal_all, self.image_size, self.trim, self.blur, self.add_noise,
                    self.add_layer, self.add_vector_layer, self.duplicate_layer, self.layer_via_copy, self.layer_via_cut, self.layer_up, self.layer_down, self.merge_down, self.delete_layer,
                    self.group_layers, self.ungroup, self.move_out_of_folder, self.hide_all_mask, self.toggle_mask_enabled, self.toggle_mask_link, self.copy_mask, self.paste_mask, self.toggle_preview, self.load_transparency,
                    self.toggle_mask, self.toggle_mask_editing, self.toggle_clipped, self.toggle_visibility, self.layer_style, self.rename_layer,
                    self.fit, self.actual_size, self.zoom_in, self.zoom_out, self.show_rulers, self.show_grid, self.show_transform_controls, self.show_guides, self.snap, self.lock_guides, self.clear_guides, self.document_settings, self.bigger, self.smaller, self.harder, self.softer, self.next_blend, self.previous_blend, self.exit_app, self.reset_layout] + self.windows + self.aligns + self.adjustments + self.filters + self.adjustment_layers + self.blends + self.tools + self.units

    ## Enable what the document's state allows.
    pub func update(self, workspace: Workspace) -> unit!:
        let canvas = workspace.canvas
        # A picture still opening takes no edits yet, as a preview does not;
        # nor while Select and Mask's OK refines the selection.
        let previewing = canvas.previewing() or canvas.is_opening() or canvas.refine_keeping()
        let selection = canvas.has_selection()
        let layers = workspace.canvas.layer_count()
        self.undo.set_enabled(canvas.can_undo() and not previewing)
        self.redo.set_enabled(canvas.can_redo() and not previewing)
        self.redo_y.set_enabled(canvas.can_redo() and not previewing)
        # Fills, Clear and Paste change pixels: not while a picture opens or a preview shows.
        for command in [self.fill, self.fill_background, self.fill_delete, self.fill_background_delete, self.clear, self.paste, self.paste_in_place]:
            command.set_enabled(not previewing)
        # A place waits for a picture still opening; the menu does not offer it meanwhile.
        self.import_image.set_enabled(not canvas.is_opening())
        # The Edit menu says which step: "Undo Brush Stroke".
        self.undo.set_text("Undo " + canvas.undo_name() if canvas.can_undo() else "Undo")
        self.redo.set_text("Redo " + canvas.redo_name() if canvas.can_redo() else "Redo")
        self.deselect.set_enabled(selection)
        self.cut.set_enabled(selection and not previewing)
        self.layer_via_cut.set_enabled(selection and not previewing)
        self.inverse.set_enabled(selection)
        self.expand.set_enabled(selection)
        self.contract.set_enabled(selection)
        self.feather.set_enabled(selection)
        self.border.set_enabled(selection)
        self.smooth.set_enabled(selection)
        self.grow.set_enabled(selection and not previewing)
        self.similar.set_enabled(selection and not previewing)
        self.transform_selection.set_enabled(selection and not previewing and workspace.transforms.transform == none)
        self.quick_mask.set_enabled(not previewing and workspace.transforms.transform == none)
        self.select_mask.set_enabled(selection and not previewing and workspace.transforms.transform == none and not canvas.quick_mask())
        self.quick_mask.set_checked(canvas.quick_mask())
        self.load_selection.set_enabled(canvas.channel_count() > 0 and not previewing and not canvas.quick_mask())
        self.save_selection.set_enabled(selection and not previewing and not canvas.quick_mask())
        self.crop.set_enabled(selection)
        self.layer_up.set_enabled(workspace.layers.selected < layers - 1)
        self.layer_down.set_enabled(workspace.layers.selected > 0)
        self.delete_layer.set_enabled(layers > 1)
        # Merge and Duplicate follow the selection: the Layers panel fits them (layer_ops).
        let group = canvas.layer_is_group(workspace.layers.selected)
        self.toggle_mask_editing.set_enabled(canvas.layer_masked(workspace.layers.selected))
        self.toggle_mask_enabled.set_enabled(canvas.layer_masked(workspace.layers.selected))
        self.toggle_mask.set_enabled(not group)
        self.hide_all_mask.set_enabled(not group and not canvas.layer_masked(workspace.layers.selected))
        self.load_transparency.set_enabled(not group)
        self.ungroup.set_enabled(group)
        self.toggle_clipped.set_enabled(workspace.layers.selected > 0)
        for command in self.adjustments:
            command.set_enabled(not previewing)
        self.blur.set_enabled(not previewing and not group)
        self.add_noise.set_enabled(not previewing and not group)
        for command in self.filters:
            command.set_enabled(not previewing and not group)
        self.color_range.set_enabled(not previewing)
        self.replace_color.set_enabled(not previewing)
        for command in self.adjustment_layers:
            command.set_enabled(not previewing)
        # One transform at a time: the box, or a warp's mesh.
        let warping = workspace.transforms.mesh_warp != none
        self.free_transform.set_enabled(not previewing and not warping)
        for command in [self.transform_skew, self.transform_distort, self.transform_perspective]:
            command.set_enabled(not previewing and not warping)
        self.transform_warp.set_enabled(not previewing and not warping and workspace.transforms.transform == none and not group)
        self.puppet_warp.set_enabled(not previewing and not warping and workspace.transforms.transform == none and not group)
        self.flip_horizontal.set_enabled(not previewing)
        self.flip_vertical.set_enabled(not previewing)
        self.flip_canvas_horizontal.set_enabled(not previewing)
        self.flip_canvas_vertical.set_enabled(not previewing)
        self.layer_style.set_enabled(not previewing)
        # Aligning needs a selected layer, distributing three: counted, not measured.
        let chosen = workspace.layers.selected_ids().length
        for command in self.aligns:
            let spreads = command.id().starts_with("align_distribute")
            command.set_enabled(not previewing and chosen >= (3 if spreads else 1))

## Photoshop's keys for the adjustments that have one; none for the rest.
func adjustment_shortcut(kind: int) -> Shortcut:
    if kind == 1:
        return Shortcut(Key.u, primary = true)
    if kind == 2:
        return Shortcut(Key.i, primary = true)
    if kind == 3:
        return Shortcut(Key.l, primary = true)
    if kind == 4:
        return Shortcut(Key.u, primary = true, shift = true)
    if kind == 7:
        return Shortcut(Key.m, primary = true)
    if kind == 9:
        return Shortcut(Key.b, primary = true, shift = true, alt = true)
    if kind == 10:
        return Shortcut(Key.b, primary = true)
    if kind == 16:
        return Shortcut(Key.a, primary = true, shift = true)
    return Shortcut()