diff --git a/assets/documentation/ui/ui_all.png b/assets/documentation/ui/ui_all.png new file mode 100644 index 0000000..da11c13 Binary files /dev/null and b/assets/documentation/ui/ui_all.png differ diff --git a/assets/documentation/ui/ui_rearrange-buttons.png b/assets/documentation/ui/ui_rearrange-buttons.png new file mode 100644 index 0000000..7fb8715 Binary files /dev/null and b/assets/documentation/ui/ui_rearrange-buttons.png differ diff --git a/assets/documentation/ui/ui_timeline-splitting-panel.png b/assets/documentation/ui/ui_timeline-splitting-panel.png new file mode 100644 index 0000000..e4c3ca7 Binary files /dev/null and b/assets/documentation/ui/ui_timeline-splitting-panel.png differ diff --git a/documentation/userinterface.md b/documentation/userinterface.md index 206da7c..99035ce 100644 --- a/documentation/userinterface.md +++ b/documentation/userinterface.md @@ -9,22 +9,128 @@ permalink: documentation/userinterface.html * table of contents {:toc} -## Menu +![Default interface](/assets/documentation/ui/ui_all.png) -## Toolbar +## Panels layout -## Viewer +Some panels are rearrangable by pressing their left-right-up-down buttons: -## Tools +![Rearrangement buttons](/assets/documentation/ui/ui_rearrange-buttons.png) -## Timeline +The Timeline can be splitted horizontally or vertically to allow better parameter keyframe editing: -## Properties +![Rearrangement buttons](/assets/documentation/ui/ui_timeline-splitting-panel.png) -## Assets -## Queue +## 1. Main Toolbar -## Fill and Stroke +The main toolbar provides fast access to the most used commands related to creating/saving projects and importing and exporting assets into the active project. -## Preferences +... expand on the right-click menu ... + +## 2. Color Toolbar + +The color toolbar provides fast access to edit colors, types (none, flat or gradient) and other parameters of selected shapes or the scene background: + +- **Fill**: Allows users to set the interior color, gradient or "no color" of selected shapes. Users can choose between solid colors (flat), linear or radial gradients. + +- **Stroke**: Controls the outline of shapes, including its color, width, and style. Users can define other parameters such as width, join and cap styles. + +- **Background**: Sets the background color of the canvas or scene. This option ensures consistency in visual presentation across the workspace. + +Mouse actions on hover is supported: + +- `scroll` = change hue +- `scroll` + `shift` = change value +- `scroll` + `ctrl/cmd` = change saturation +- `click` = open fill/stroke widget + +... expand on the right-click menu ... + +## 3. Viewer + +The Viewer is the central workspace where users can visualize and interact with their projects, it can also be called **Canvas**. It displays the active composition or animation and allows for real-time previews and adjustments. + +The Canvas can be zoomed in and out or fitted in some ways or even reset to default size. Check `Menu > View > Zoom` for a full list of options. + +On Windows and Linux the mouse wheel can zoom in/out, on macOS add the `option` key when using the mouse wheel. Gestures for pan, zoom and smart zoom is supported on macOS. + +- `Shift + Ctrl/Cmd` + `+` = Zoom in (We should change this to not include shift!) +- `Shift + Ctrl/Cmd` + `-` = Zoom Out (We should change this to not include shift!) +- `Ctrl/Cmd` + `1` = Reset zoom +- `Ctrl/Cmd` + `0` = Fit to canvas +- `Ctrl/Cmd` + `9` = Fit to canvas width + +## 4. Tools + +The Toolbar contains a set of tools to create shapes, helpers and some others to edit already created objects. + +- **Object selection mode**: Allows users to select and manipulate entire objects on the canvas. This mode is essential for positioning, scaling, and rotating objects. + +- **Point selection mode**: Enables users to select and modify individual points or vertices of an object, offering fine control over shapes and paths. + +- **Path**: Creates precise vector paths by placing anchor points and defining curves. Ideal for drawing custom shapes and lines. + +- **Hand-drawn Path**: Allows freehand drawing of paths, giving users more flexibility and a natural drawing experience. + +- **Circle**: Draws perfect circles or ellipses. Users can define dimensions and position on the canvas. + +- **Rectangle**: Creates rectangular or square shapes. Useful for building structured layouts and designs. + +- **Text**: Adds text elements to the canvas. Users can adjust font, size, alignment, and other typographical properties. + +- **Null object**: Adds an invisible reference object that can be used to group or control other elements in the composition. + +- **Color picker**: Enables users to sample and apply colors directly from the canvas or predefined palettes. + +- **Global/Local Pivot Toggle**: Switches between global and local pivot points, allowing more precise control over transformations and rotations. + +... expand on the right-click menu ... + +## 5. Timeline + +The Timeline is where animations and keyframes are managed. Users can control timing, easing, curves of every object parameter. All the hierarchy of shapes, layers, groups, helpers, etc. are displayed using the "layer concept", that is, objects on top of the list lay in the canvas on top of other objects that lay below. + +There is an option to filter the hierarchy to edit the objects that are listed. + +## 6. Properties + +By default the Properties panel displays the attributes of just the selected object, layer, group, etc. + +In the case of selecting a Text object, then a panel with text parameters are shown. + +At the bottom of the Properties panel there are a few options to easily align objects in the canvas relative to the canvas itself or other shapes. + +## 7. Assets + +The Assets panel manages **linked** files, images, audio, and other resources used in the project. By clicking the secondary mouse button in an asset it is possible to: + +- **Reload**: reads the file again from source. + +- **Replace**: it lets the user select another file to replace the already linked one. + +- **Remove**: it completely removes the object from the project. + +## 8. Queue + +The Queue section manages rendering tasks and export jobs. Users can monitor the progress of ongoing processes and manage output settings. + +## 9. Fill and Stroke + +The Fill and Stroke panel allows users to control the color, gradient, and outline properties of objects. It provides precise control over visual styles. + +### Fill + +... + +### Stroke + +... + +### Gradient(s) + +... + +## 10. Preferences + +The Preferences menu contains settings for customizing scenes, preview resolution and layouts.