Documentation
Chapter 02

Interface and Workspaces

This chapter shows you how the main window is laid out, how to set up panels and workspaces the way you like, how to move around in the image, and where to change keyboard shortcuts and preferences.

The main window with menu bar, options bar, toolbar, canvas, panels and status bar
The main window: the menu bar and options bar at the top, the toolbar on the left, the canvas with the tabs in the middle, the panels on the right, the status bar at the bottom.

You will find all commands in ten menus. Many entries show their keyboard shortcut on the right; a triangle ▸ opens a submenu, a check mark ✔ shows options that are turned on. Grayed-out entries don't apply at the moment – Deselect, for example, when nothing is selected.

MenuContentsCovered in detail in
FileNew, Open, Place, Save, Export, File Info, Content Credentials, Print, Automate, ScriptsGetting Started, Export, Automation
EditUndo, clipboard, Fill, Content-Aware, AI Tools, Generative AI, Transform, Presets, PreferencesRetouching, AI on Your Computer, Generative AI
ImageAdjustments, Mode, Color Profile, Image Size, Canvas Size, Image Rotation, Calculations, Variables, AnalysisAdjustments, Color, Retouching
LayerNew layers, adjustment and fill layers, Smart Objects, Frames, Layer Style, masks, Arrange, AlignLayers
TypeType panels, orientation, OpenType, Warp Text, Match FontType, Shapes & Paths
SelectAll, Subject, Sky, Color Range, Select and Mask, Modify, saving and loading selectionsSelections
FilterFilter Gallery, Neural Filters, Liquify, Vanishing Point and all filter groupsFilters
ViewZoom, Proof, Pixel Aspect Ratio, Show, Guides and Grid, Displaythis chapter
WindowWorkspaces, Arrange, all panelsthis chapter
HelpKeyboard Shortcuts, Third-Party Licenses, About Chromatelierthis chapter
The open File menu
File menu
The open Edit menu
Edit menu
The open Image menu
Image menu
The open Layer menu
Layer menu
The open Type menu
Type menu
The open Select menu
Select menu
The open Filter menu
Filter menu
The open View menu
View menu
The open Window menu with the list of panels
Window menu
The open Help menu
Help menu

You can also run the command of any menu entry with a keyboard shortcut you define yourself – see Keyboard shortcuts.

The options bar

Below the menu bar, the options bar shows the name of the active tool on the left, followed by its settings – for the Brush, for example, Size, Hardness, Opacity, Flow, Spacing, Smoothing and Brush Settings…. The second line holds a short usage hint, for example “Shift+Click straight line”. The bar changes with every tool; the chapter Tools describes what the individual fields do.

Toolbar and tool groups

The toolbar on the left contains 20 buttons. Many of them are groups of several related tools; you can recognize them by the small triangle in the lower right corner. When you hover the mouse over a button, a tooltip shows its name and shortcut.

  • A click selects the tool the group is currently showing.
  • A right-click opens the list of all tools in the group with their shortcuts. The tool you choose then stays visible as the group's representative.
  • Shortcuts such as B (Brush) or V (Move) select a tool directly; with ⇧ you often get the next tool in the group, for example ⇧ M for the Elliptical Marquee.
Right-clicking a tool group shows Object Selection, Quick Selection and Magic Wand
Right-clicking the group of selection tools: Object Selection, Quick Selection and Magic Wand.

The chapter Tools describes all 58 tools and their options.

Foreground and background color

Below the tools are two color swatches: at the top left the foreground color (used by the Brush, text and shapes), behind it the background color (used, for example, by the Eraser on the background layer). Clicking a swatch opens a color picker. Below them, the double arrow swaps the two colors (X), and the small icon next to it resets them to black and white (D). To pick colors from the image, use the Eyedropper (I).

Panels

The right-hand column contains the panels. Each one is a card with a header: clicking the name expands or collapses the panel. In the Window menu you show or hide each panel; a check mark shows which ones are currently there. The common ones are directly in the menu, the type and information panels in the submenus Window › Text and Glyphs and Window › Information.

PanelShortcutWhat it's for
LayersF7Creating, ordering, showing and hiding layers and groups, blend mode and opacity, masks. See Layers.
PropertiesThe settings of whatever is selected: the sliders of an adjustment layer, mask density and feather, Smart Object, shape layer, frame.
ChannelsColor channels, saved selections (alpha channels) and spot channels. See Selections and Color.
PathsThe work path and saved paths, loading a path as a selection, fill, stroke. See Type, Shapes & Paths.
Layer CompsRemembering the visibility, position and style of layers as named variants and switching between them. See Layers.
HistoryAll the steps you took, jumping back, snapshots (New Snapshot) and the source of the History Brush. See Retouching.
ActionsRecording and playing back steps. See Automation.
ColorF6The foreground color in a color picker, with hex input.
SwatchesSaved colors. Click = foreground, ⌥-click = background, right-click = remove; + adds the foreground color.
BrushesChoosing, creating and loading brush presets (including .abr). See Tools.
StylesApplying saved layer styles with one click (including .asl). See Layers.
TimelineFrame animation and video timeline with keyframes. See Video & Animation.
Character, ParagraphFont, size, spacing, alignment and indents of the type layer.
Character Styles, Paragraph StylesNamed text styles for consistent typography.
GlyphsAll the characters of a font, inserted with a click. Type panels: see Type, Shapes & Paths.
InfoF8The color under the pointer (R, G, B, H, S, brightness, opacity), position X/Y, width and height of the selection, size, mode and bit depth of the document.
HistogramThe tonal distribution of the image for red, green and blue, continuously updated.
NavigatorA thumbnail of the image; the red rectangle shows the visible area. Clicking or dragging moves the visible area; the slider zooms (2 to 3200%).
Measurement Log⌘ ⇧ M recordsSaved measurements, with Record Measurements, Export… and Clear. See Retouching.
NotesThe notes you placed in the image with the Note tool: read, edit, browse and delete them.

Moving, docking and floating panels

The right-hand column has an upper and a lower area (the lower one holds, for example, Layers, Paths, Channels and History). This is how you rearrange the panels:

  • Dragging: Each header has a handle at the top right (“Drag to move the panel”). Drag it onto another panel to insert it in front of that panel – a line shows the spot. If you drop it over the canvas, it opens there in its own floating window.
  • Context menu: Right-clicking the header offers Move Up, Move Down, Move to the Lower Area or Move to the Upper Area, Float in a Window and Close.
  • Docking: A floating panel has a Dock button at the top; it puts the panel back into the right-hand column. The cross in the title bar hides it.
Context menu of the Swatches panel header
Right-clicking the “Swatches” header.
The Swatches panel floating in its own window over the canvas
Dragged onto the canvas: “Swatches” as a floating window with “Dock”.

Placing a panel in its own window next to the image

  1. Find the panel in the right-hand column, for example Swatches. If it isn't there, show it via Window › Swatches.
  2. Grab the handle at the top right of the header and drag it onto the canvas. Release the mouse button – the panel opens at that spot in its own window.
  3. Move the window by its title bar to wherever it doesn't get in your way.
  4. To bring it back into the column, click Dock in the window.

Workspaces

A workspace defines which panels are where and which ones are expanded. Under Window › Workspace you choose one of the five built-in ones:

WorkspaceShortcutPanels
Essentials⌘ ⌥ ⇧ 1All panels; Color, Swatches, Layers and History expanded. The default.
Photography⌘ ⌥ ⇧ 2Histogram, Navigator, Info, Properties, Color; below them Layers, Channels, Paths, History, Actions.
Painting⌘ ⌥ ⇧ 3Color, Swatches, Brushes, Navigator, Properties; below them Layers and History.
Typography⌘ ⌥ ⇧ 4Character, Paragraph, Character and Paragraph Styles, Properties, Color, Swatches; below them Layers and History.
Motion⌘ ⌥ ⇧ 5Timeline, Properties, Color, Navigator; below them Layers and History.
The Photography workspace with Histogram and Navigator
Photography workspace
The Painting workspace with the color picker
Painting workspace
The Typography workspace with the Character and Paragraph panels
Typography workspace
The Motion workspace with the Timeline
Motion workspace

Other commands in the same submenu:

  • Reset … (e.g. Reset Essentials) restores the current workspace to the way it was saved.
  • New Workspace saves the current arrangement as a workspace of your own (“Workspace 1”, “Workspace 2” …). It appears in the list below the built-in ones; it remembers any changes you make in it automatically.
  • Delete Workspace removes the current workspace of your own and switches to Essentials. Built-in workspaces can't be deleted.
The Window › Workspace submenu with the five workspaces
Window › Workspace

Window › Generative Workspace is a separate area for creating images from text; it is described in the chapter Generative AI.

Creating a workspace of your own

  1. As a starting point, choose a suitable workspace, for example Window › Workspace › Photography.
  2. Use the Window menu to hide what you don't need and show what's missing. Arrange the panels with their handles or the context menu and expand the ones you want.
  3. Choose Window › Workspace › New Workspace. The status bar reports the name it was saved under.
  4. From now on you can bring the arrangement back at any time via Window › Workspace.

Arranging several documents

Normally, documents lie on top of each other in tabs. Window › Arrange shows them side by side:

CommandEffect
Tile AllAll documents as tiles in a grid.
Tile All VerticallyEach document in its own column.
Consolidate All to TabsBack to tabs.
Match ZoomAll tiles get the zoom level of the active document.
Match LocationAll of them show the same part of the image as the active one.
Match AllZoom level and location at once.

You always edit the active document in its tile; clicking another tile makes that one active. If you drag a layer onto another tile with the Move tool, it is copied into that document.

The Window › Arrange submenu
Window › Arrange
Two documents side by side as tiles
Two documents with “Tile All”.

Status bar and Contextual Task Bar

The status bar at the bottom edge of the window shows, from the left: the zoom level, the image size in pixels, the pointer position with the color beneath it (RGBA and hex), the size of a selection and the latest message, such as “Opened street.jpg (1400×933, 1 layers)” or the name of the last step. Colored notices warn you when you are currently editing a mask, a channel, the Quick Mask view or the contents of a Smart Object.

The Contextual Task Bar is a small floating bar on the canvas with the most likely next steps. Without a selection it offers Select Subject, Remove Background and Generate Image. When there is a selection, it sits below the selection and offers an input field for Generative Fill… with Generate, as well as Mask, Invert, Select and Mask, Fill (content-aware) and Deselect. The ✕ hides it; you can show it again under View › Show › Contextual Task Bar.

WhatHow
Zoom In / Zoom OutView › Zoom In (⌘ +) and View › Zoom Out (⌘ -); ⌘ + mouse wheel or a two-finger pinch on the trackpad zooms at the pointer position.
Fit on ScreenView › Fit on Screen (⌘ 0) fits the image into the window.
Actual PixelsView › Actual Pixels (100%) (⌘ 1): one image pixel per screen pixel.
Zoom toolZ: a click zooms in, with ⌥ it zooms out.
PanningMouse wheel or two-finger swipe; the Hand tool (H); or, with any tool, hold down the Space bar and drag. The Navigator also moves the visible area.
Rotating the viewThe Rotate View tool (⇧ H, in the Hand group): dragging rotates the view, with ⇧ in 15° steps. In the options bar you set the exact Rotation Angle; Reset View or Esc straightens it again. The image itself stays unchanged.

Pixel aspect ratio

Video footage sometimes has non-square pixels. Under View › Pixel Aspect Ratio you choose Square Pixels or a video standard (D1/DV NTSC and PAL, each also widescreen, HDV 1080 / DVCPRO HD 720, DVCPRO HD 1080, Anamorphic 2:1), or you enter a value under Custom. With Pixel Aspect Ratio Correction the canvas shows the pixels as wide as they are meant to be. The image data doesn't change.

View › Show

Here you turn the canvas aids on and off: Rulers (⌘ R), Guides (⌘ ;), Grid (⌘ '), Pixel Grid (≥1000%), Notes, Contextual Task Bar, Pattern Preview (the image repeats all around, and painting continues across the edges – handy for seamless patterns) and Brush Settings (F5).

The View › Show submenu
View › Show
The View › Display submenu
View › Display

View › Display

GPU Compositing composites the canvas display on the graphics card (faster with many layers; if no suitable GPU is available, the entry is disabled and the CPU takes over). Use Monitor Profile shows the canvas in the colors of the monitor profile – the profile that was detected is shown in parentheses. You will also find Toggle Light/Dark UI and the Language here. The View › Proof item belongs to color management and is described in the chapter Color, RAW & HDR.

Rulers, guides and grid

Rulers (⌘ R) appear along the top and left of the canvas and show pixel coordinates.

Guides are non-printing lines for aligning things:

  • Drag a horizontal guide into the image from the top ruler, a vertical one from the left ruler.
  • With the Move tool (V) you move an existing guide; if you drag it back onto a ruler, it is deleted.
  • View › Guides and Grid › New Guide… places a guide precisely: Horizontal or Vertical and the Position in pixels.
  • Lock Guides (⌘ ⌥ ;) protects them from being moved accidentally, Clear Guides removes them all.

The grid (⌘ ') lays a grid over the image. You set the spacing of the main lines (Gridline every, 2 to 2000 px, default 64 px) and the Subdivisions (1 to 16, default 4) directly in the submenu or in the Preferences.

Snap (⌘ ⇧ ;) makes selections, layers, shapes and guides snap to guides, visible grid lines and the edges and center of the canvas while you drag. Hold down ⌘ while dragging to suspend snapping briefly.

Canvas with rulers, guides and grid
Rulers and guides.
Photo with the grid shown
The grid with 64 px spacing and four subdivisions.
The View › Guides and Grid submenu
View › Guides and Grid with Snap, Lock and the grid values.

For precise measuring there are the Ruler tool and the measurement scale – see Tools.

Keyboard shortcuts

Help › Keyboard Shortcuts… (⌘ ⌥ ⇧ K) lists every menu command with its path and its shortcut. The Search field helps you find a command quickly. Under Tools and other keys you'll find the fixed shortcuts for tools, brush size and so on.

The Keyboard Shortcuts dialog with the list of menu commands and their shortcuts
The “Keyboard Shortcuts” dialog.

Assigning a shortcut of your own

  1. Open Help › Keyboard Shortcuts….
  2. Type part of the command name into Search, for example “Gaussian”.
  3. In the command's row, click the shortcut field (a dash “—” means: no shortcut yet). It shows Press keys….
  4. Press the new combination. It must contain ⌘ or ⌥, or be a function key (F1–F12). Esc cancels.
  5. If the combination was already assigned, Chromatelier takes it away from the other command and reports this below the list (“… was taken from …”).
  6. The ✕ after a shortcut removes it. Reset to Defaults restores all shortcuts. Close closes the dialog; your changes stay saved.

The most important shortcuts

ShortcutCommand
⌘ N / O / S / WNew / Open / Save / Close
⌘ ⇧ S · ⌘ ⌥ SSave As · Save a Copy
⌘ ⌥ ⇧ W · ⌘ ⌥ ⇧ SExport As · Save for Web
⌘ Z · ⌘ ⇧ ZUndo · Redo
⌘ KPreferences
⌘ + / - / 0 / 1Zoom In / Zoom Out / Fit on Screen / 100%
⌘ R · ⌘ ; · ⌘ 'Rulers · Guides · Grid
F5 · F6 · F7 · F8Brush Settings · Color · Layers · Info
[ / ]Decrease / increase brush size
1 … 0Tool opacity 10 … 100%
D · XDefault colors · Swap colors
Hold SpaceTemporarily the Hand tool

Preferences

Edit › Preferences… (⌘ K) opens the program's settings. On the left you choose one of seven tabs; changes take effect after OK and stay saved for future starts. Cancel discards them.

General

  • Language: Deutsch, English, Français or Español.
  • Color Theme: Dark or Light.
  • UI Scaling: 50 to 300%.
Preferences, General tab
Preferences › General

Performance

  • History States: how many steps Undo remembers (2 to 1000, default 60). More steps need more memory.
  • GPU Compositing: composite the canvas display on the graphics card.
  • Use Monitor Profile: show the canvas in the colors of the monitor profile (color management for the display).
Preferences, Performance tab
Preferences › Performance

File Handling

  • JPEG quality (10 to 100): the quality for Quick Export and for saving as JPEG. The same slider is also under File › Export.
  • Content Credentials: sign exported JPEG, PNG, WebP and TIFF files with their origin and the AI that was used (see Content Credentials).
  • Video Codec (H.264): use OpenH264 for video layers and MP4/MOV. The codec is downloaded from Cisco when needed; the Download and Remove buttons control this, and below them you can see whether it is installed.
  • Automatically Save Recovery Information Every: 0 to 120 minutes (0 = off), see Getting Started.
  • Recent file list contains: 0 to 30 files.
Preferences, File Handling tab
Preferences › File Handling

Guides & Grid

  • Gridline every (2 to 2000 px) and Subdivisions (1 to 16).
  • Snap: turn snapping to guides, grid and edges on or off.
Preferences, Guides and Grid tab
Preferences › Guides & Grid

Generative AI, Local AI and AI Assistants

  • Generative AI: your OpenAI API key (stored only on this computer, with Test Key), the Model and the Quality (Automatic, Low, Medium, High). Covered in detail in the chapter Generative AI.
  • Local AI: the AI models that run on your computer, with size, license and status; Download or Remove them one by one. See AI on Your Computer.
  • AI Assistants: the MCP server through which AI assistants are allowed to control Chromatelier, with port and access token. See Automation.
Preferences, Generative AI tab
Preferences › Generative AI
Preferences, Local AI tab with the list of models
Preferences › Local AI