Skip to content

Commit

Permalink
simpler feature guide
Browse files Browse the repository at this point in the history
  • Loading branch information
script-fu committed Dec 2, 2024
1 parent 0858486 commit f991b9f
Show file tree
Hide file tree
Showing 14 changed files with 21 additions and 21 deletions.
2 changes: 1 addition & 1 deletion content/hub/feature-test/folder/Dynamic-Velocity-Output.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,6 @@ This merge request removes the velocity inversion in dynamics, simplifying the v
- The velocity is no longer inverted (`1.0 - coords->velocity` removed).
- `coords->velocity` is mapped directly, making the graph for velocity mapping more accurate.

### Benefit
### **Benefits**

- This change corrects the velocity mapping in dynamic features, helping users understand and control brush settings without dealing with inverted values.
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,6 @@ This MR fixes a GUI issue by restoring the previous tool after using a filter, p
- Added code to retrieve the previous tool from the context.
- After a filter dialog closes (whether committed or canceled), the previous tool is restored using `gimp_context_set_tool`.

### Benefit
### **Benefits**

- Ensures the user's previous tool is restored after using a filter, providing a more intuitive and seamless experience in the tool palette.
10 changes: 5 additions & 5 deletions content/hub/feature-test/folder/Paint-Tool.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,8 +25,8 @@ This MR improves the painting experience by refining brush cursor behavior and a
### Changes

1. **Easy Cursor Location**:
- Introduced a new function `gimp_draw_brush_cursor` that ensures a minimum cursor size, even when the brush is very small or not visible (e.g., zero-pressure).
- Defined constants `FINDER_SIZE` and `CORE_SIZE` to ensure a small 'filled' contact circle is always drawn, making the cursor easier to locate.
- Introduced a new function `gimp_draw_brush_cursor` that ensures a minimum cursor size, even when the brush is very small or not visible (e.g., zero-pressure).
- Defined constants `FINDER_SIZE` and `CORE_SIZE` to ensure a small 'filled' contact circle is always drawn, making the cursor easier to locate.
- If the brush outline is too small, `should_locate` triggers a fallback locator circle.

2. **Indicate Erase Mode**:
Expand All @@ -35,10 +35,10 @@ This MR improves the painting experience by refining brush cursor behavior and a
- A small filled circle is also drawn at the center to help users identify the brush's contact point.

3. **Simple Brush Boundary**:
- Added a new boolean option `brush_simple_boundary` in the Paintbrush Options GUI.
- In the `gimp_paint_tool_draw` function, the standard complex outline of the brush (derived from the image brush mask) is bypassed when this option is enabled.
- Added a new boolean option `brush_simple_boundary` in the Paintbrush Options GUI.
- In the `gimp_paint_tool_draw` function, the standard complex outline of the brush (derived from the image brush mask) is bypassed when this option is enabled.
- Instead, a simple circular boundary is drawn by the `draw_brush_circle` function, providing a cleaner, less noisy visual representation for large or complex brushes.

### Benefit
### **Benefits**

- These updates improve the visual clarity and feedback of the brush cursor during painting. The small contact circle ensures the cursor is always visible, the dashed circle gives clear feedback in erase mode, and the simple brush boundary reduces distractions from complex brush shapes.
2 changes: 1 addition & 1 deletion content/hub/feature-test/folder/Paintbrush-Options.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ This MR enhances the Paintbrush GUI in several ways, making it more intuitive an
8. **Pick Layer**:
- Added a new "Pick Layer" option in the **Additional Options** expander. This feature allows users to hold the <kbd>Alt</kbd> key to automatically select the layer under the brush cursor. This option simplifies workflows with complex layer stacks by enabling quick access to the correct layer without manually searching through the layers panel.

### Benefit
### **Benefits**

This set of changes significantly improves the usability and efficiency of the Paintbrush GUI. By reducing visual clutter, hiding advanced options behind expanders, and simplifying the interface, users can now navigate the Paintbrush settings more easily while still accessing the features they need.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ This update replaces the previous brush stroke smoothing and introduces new conf
- Slower strokes distribute weight evenly, leading to smoother transitions.
- The algorithm calculates weighted averages for brush coordinates (position, pressure, direction) and blends them with the current stroke, resulting in smoother, more controlled movements.

### Benefit
### **Benefits**

These updates significantly improve brush stroke handling in Artbox. The new smoothing options give artists greater control over brush behavior, providing more responsive fast strokes and smoother slow strokes. The updated algorithm and new testing tools simplify the process of refining stroke behavior, making the painting experience more predictable and enjoyable. Entirely new types of brush strokes can be created by using the `Pressure` and `Direction` sliders.

2 changes: 1 addition & 1 deletion content/hub/feature-test/folder/Path-Tool.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ This merge request refines snapping, visibility, movement, handle locking, and c
5. **Enter Key Path Commitment**:
- Updated the `Enter` key functionality to commit path edits without selecting the enclosed area, preventing unintended selections that could disrupt workflow, especially with linear paths.

### Benefit
### **Benefits**

- **Improved Snap Control**: Users can adjust snap distances independently for paths, providing more precise control based on element type (e.g., paths vs. grids).
- **Enhanced Workflow with Auto-Visibility**: Paths are automatically visible upon creation, improving user feedback and reducing manual toggling.
Expand Down
2 changes: 1 addition & 1 deletion content/hub/feature-test/folder/Presets-Restore.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,6 @@ This MR improves the usability of Tool Presets by allowing users to restore a pr
- Previously, clicking on an already active preset had no effect, requiring the user to select a different preset before selecting the desired one to restore its settings.
- The `gimp_container_icon_view_item_activated` function was updated to call `gimp_context_tool_preset_changed` when a preset is double-clicked, restoring the preset's tool options immediately.

### Benefit
### **Benefits**

- This change simplifies the process of restoring Tool Preset options, providing a more efficient workflow by eliminating unnecessary clicks. Now, double-clicking an active preset will quickly restore its saved settings, improving the overall user experience.
2 changes: 1 addition & 1 deletion content/hub/feature-test/folder/Resource-Control.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,6 +75,6 @@ This merge request improves the usability and data-saving mechanisms for resourc
10. **Tool Preset Name in Tool Options Title:**
- Added the active Tool Preset name after the Tool name in the Tool Options title. Tool Name | Tool Preset Name. We can see which Tool Preset is active from the Tool Options Title.

### Benefit
### **Benefits**

These changes aim to provide better control over resources and presets, allowing users to manage their assets more intuitively and prevent unintended modifications.
4 changes: 2 additions & 2 deletions content/hub/feature-test/folder/Script-Fu.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Extend Script-Fu to include additional functions that help the user.

## Key Concepts and Definitions

- **Script-Fu**: A scripting language based on Scheme
- **Script-Fu**: A scripting language based on Scheme

## Related Links

Expand All @@ -33,6 +33,6 @@ This MR extends Script-Fu by adding several additional functions to improve scri
- `(gimp-context-eraser-toggle)`: Toggles the active tool between the eraser and the previously active tool.
- `(gimp-items-set-visible)`: Allows setting the visibility of a vector list of items in bulk. This can help streamline visibility management for layers, paths, or other drawable items.

### Benefit
### **Benefits**

- These additional functions enhance the flexibility of Script-Fu, enabling users to toggle between tools, manage visibility across multiple items, and integrate display information into their scripts, leading to more powerful automation and customization.
2 changes: 1 addition & 1 deletion content/hub/feature-test/folder/Selection.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,6 @@ This MR improves the painting experience by introducing new features that allow
- Added an option to automatically deselect a selection after it has been auto-filled.
- This update enables a continuous workflow where users can effortlessly transition from selecting to filling and back to selecting again.

### Benefit
### **Benefits**

- These updates significantly enhance the usability and efficiency of the painting workflow. The `Auto Commit` feature ensures seamless transitions between selections, `Fill Selection` makes the workflow faster and more intuitive, and `Auto Deselect` reduces repetitive actions, allowing users to focus on creative tasks rather than manual steps.
2 changes: 1 addition & 1 deletion content/hub/feature-test/folder/Simple-Sliders.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Simplify the slider interaction and provide a less distracting slider cursor.
This MR improving slider usability for painters, interaction is simple.
It also changes the cursors from grabbing hands to sb_up_arrow and sb_h_double_arrow, up and side-to-side.

### Benefit
### **Benefits**

- Sliders will always slide on a single click, improving usability during tasks like painting.

Expand Down
2 changes: 1 addition & 1 deletion content/hub/feature-test/folder/Tool-Tips.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ This MR introduces a Preference option for tooltips, enabling users to manage to
2. **Tooltip Preference Integration**:
- Integrated the tooltip preference under `Preferences -> Interface -> Help System -> General -> Show tool tips`, allowing users to toggle tooltip visibility easily within the UI.

### Benefit
### **Benefits**

- The addition of the `show_tool_tips` option enhances user control over the interface, reducing UI clutter for users who prefer minimal tool guidance, while retaining tooltip functionality for those who rely on detailed tool descriptions. Though primarily a workaround to reduce tooltip distractions, a more granular solution could be implemented for further customization.

Expand Down
4 changes: 2 additions & 2 deletions content/hub/feature-test/folder/Toolbox.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ This MR enhances the usability of the Toolbox in Artbox by introducing options f

### Technical Details

- **toolbox_create_flexible_fg_bg**:
- **toolbox_create_flexible_fg_bg**:
- A new function introduced to allow the FG/BG widget to be positioned and scaled outside of the Flowbox, if the user opts to remove the Flowbox.

- **toolbox_create_flowbox**:
Expand All @@ -66,6 +66,6 @@ This MR enhances the usability of the Toolbox in Artbox by introducing options f
- **gimp_tool_palette_style_updated**:
- Adjustments made to handle scaling and positioning logic of the FG/BG widget based on user preferences, ensuring consistency across various layouts.

### Benefit
### **Benefits**

- These updates provide users with a choice between a simplified, compact Toolbox or the existing flexible layout, offering better control over the user interface. Scaling and positioning options make the Toolbox adaptable to different display sizes and user preferences, leading to a more efficient workflow.
4 changes: 2 additions & 2 deletions content/hub/feature-test/folder/Warp-Tool.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,12 +63,12 @@ This MR extends the Warp Transform Tool to support group warping, including opti
- This function checks if an item is in `tmp_expand_layers`, is content-locked, has a valid bounding box, and intersects with the warped area.
- Items are further examined using an enhanced `gimp_pickable_auto_shrink` function, allowing classification of items as empty, uniform, or containing non-black pixels to optimize warp applicability.

### Benefit
### **Benefits**

These updates provide extended control over complex layer group warping, improve visual feedback, and prevent boundary clipping during transformations. The ability to warp group masks improves consistency for multi-layer transformations, while the margin setting allows for flexibility with expanded areas within the canvas. Usability improvements—such as automatic commits on display switches, notifications for undo limits, and compatibility validation for warp items—enhance workflow efficiency and user experience. Artists who work in a non-destructive, layered format can now refine their work at any stage using the Warp Transform on nested Layer Groups.

### Known Issues

- **Undo/Redo Limitations**: Undo then Redo may fail due to an unknown issue with Layer Group mask handling. It’s advised to save before warping, and use autosave and incremental saving.
- **Undo/Redo Limitations**: Undo then Redo may fail due to an unknown issue with Layer Group mask handling. It’s advised to save before warping, and use autosave and incremental saving.
- **Experimental Freeze Feature**: Freezing the Layer Stack container to improve update speed and restrict GUI interaction causes erratic behavior in the Layer Stack post-warp. This experimental feature can be enabled via a code flag. Layer Group warping requires further testing and code review due to the complexity of the operation.

0 comments on commit f991b9f

Please sign in to comment.