From 221c2e9b4737b6a51cb1543341a91478d64b6339 Mon Sep 17 00:00:00 2001 From: Keavon Chambers Date: Fri, 28 Nov 2025 02:58:45 -0800 Subject: [PATCH] Update the user manual's most outdated parts and improve its table styling --- .../menu_bar/menu_bar_message_handler.rs | 2 +- website/content/features.md | 156 +++++++++--------- website/content/learn/interface/_index.md | 27 +-- .../content/learn/interface/document-panel.md | 22 ++- website/content/learn/interface/menu-bar.md | 155 +++++++++-------- .../introduction/features-and-limitations.md | 41 +---- .../volunteer/guide/graphene/_index.md | 8 +- website/sass/base.scss | 37 ++++- 8 files changed, 235 insertions(+), 213 deletions(-) diff --git a/editor/src/messages/portfolio/menu_bar/menu_bar_message_handler.rs b/editor/src/messages/portfolio/menu_bar/menu_bar_message_handler.rs index 9b86761d..d2f9696f 100644 --- a/editor/src/messages/portfolio/menu_bar/menu_bar_message_handler.rs +++ b/editor/src/messages/portfolio/menu_bar/menu_bar_message_handler.rs @@ -394,7 +394,7 @@ impl LayoutHolder for MenuBarMessageHandler { action: MenuBarEntry::no_action(), disabled: no_active_document || !has_selected_layers, children: MenuBarEntryChildren(vec![{ - [(FlipAxis::X, "FlipHorizontal", "Horizontal"), (FlipAxis::Y, "FlipVertical", "Vertical")] + [(FlipAxis::X, "FlipHorizontal", "Flip Horizontal"), (FlipAxis::Y, "FlipVertical", "Flip Vertical")] .into_iter() .map(|(flip_axis, icon, name)| MenuBarEntry { label: name.into(), diff --git a/website/content/features.md b/website/content/features.md index 5ac66b35..927cbaa2 100644 --- a/website/content/features.md +++ b/website/content/features.md @@ -77,7 +77,7 @@ Marrying vector and raster under one roof enables both art forms to complement e

— Pre-Alpha —

- + Editor systems; basic vector art tools
@@ -85,7 +85,7 @@ Marrying vector and raster under one roof enables both art forms to complement e

— Alpha 1 —

- + Better tools; node graph prototyping
@@ -93,7 +93,7 @@ Marrying vector and raster under one roof enables both art forms to complement e

— Alpha 2 —

- + Node graph integration in documents
@@ -101,7 +101,7 @@ Marrying vector and raster under one roof enables both art forms to complement e

— Alpha 3 —

- + Procedural vector editing and usability
@@ -109,63 +109,63 @@ Marrying vector and raster under one roof enables both art forms to complement e

— Alpha 4 —

- + Parametric animation
- + Instancer nodes for looped generation
- + Enhanced Pen, Path, and Shape tools
- + Table-based graphical data format
- + Data panel for graphical introspection
- + Layer clipping masks
- + All-around performance optimizations
- + + Blend tool to morph between shapes +
+
+ Desktop app (Windows, Mac, Linux)
- + GPU-accelerated raster rendering
- + Expanded imaging model data format
-
- - Automatic image trace vectorization -
- + Context menus throughout the editor
- + Simplified main properties panel
- + Node version management
- + Stable document format
@@ -173,67 +173,71 @@ Marrying vector and raster under one roof enables both art forms to complement e

— Beta 1 —

- + Local fonts access
- + Saving over local files (web version)
- + Timeline panel for animation curves
- + Nested documents as custom nodes
- + Variables and color swatches
- + Custom attributes for table data
- + Physical measurement units
- + Text-on-path tool support
- + Per-glyph text style controls
- + Robust vector mesh editing/rendering
- + Nondestructive shape builder tool
- + + Automatic image trace vectorization +
+
+ Broader SVG support including filters
- + Parametric art standalone export
- + New and improved brush tool
- + Stylus and touch interaction
- + MIDI and audio-reactive visualization
@@ -241,59 +245,59 @@ Marrying vector and raster under one roof enables both art forms to complement e

— Beta 2 —

- + Dockable and multi-window panels
- + Command palette
- + Onion skinning mode for animation
- + Animatable deformation meshes/rigs
- + Simulation domains
- + Signed distance field rendering
- + Procedural PBR material generation
- + Code editor for custom nodes
- + Asset libraries and node marketplace
- + Automation/batch processing tools
- + Select mode (marquee masking)
- + Raster adjustments, filters, and effects
- + Liquify and warp transforms
- + Raw photo processing
@@ -301,99 +305,99 @@ Marrying vector and raster under one roof enables both art forms to complement e

— LTS Releases —

- + Advanced typesetting features
- + PDF, EPS, AI, DXF, PSD, and TIFF
- + CMYK, spot color, and ICC profiles
- + HDR and WCG color handling
- + Outliner panel (node graph tree view)
- + Document history management
- + Offline edit resolution with CRDTs
- + History brush and clone stamp tools
- + Internationalization and accessibility
- + AI nodes and tools (e.g. magic wand)
- + Procedural styling of paint brushes
- + Infinite generative vector patterns
- + Geometric constraint system solver
- + Responsive design layout solver
- + Authoring animated SVGs, Lottie, etc.
- + Live video stream compositing
- + Tablet app and keyboard-free controls
- + Media collection manager/browser
- + Cloud document storage/device sync
- + Multiplayer collaborative editing
- + Predictive graph rendering/caching
- + Multi-device distributed rendering
- + Hosted rendering accelerator service
- + …and that's all just the beginning…
diff --git a/website/content/learn/interface/_index.md b/website/content/learn/interface/_index.md index 2fce2aed..82ef0450 100644 --- a/website/content/learn/interface/_index.md +++ b/website/content/learn/interface/_index.md @@ -13,27 +13,28 @@ This chapter formally introduces the concepts and terminology for the user inter The bar running across the top of the editor is called the **title bar**. In the (forthcoming) desktop release of Graphite, this acts as the draggable window frame. -

The title bar

+ ### Menu bar On the left, the [**menu bar**](./menu-bar) provides quick access to many editor, document, and artwork related controls. Its functions are covered in detail on the next page. -

The menu bar

+ ### Window buttons -On the right, the **window buttons** provide platform-specific controls for the application. +On the right (and on Mac, the left), the **window buttons** provide platform-specific controls for the application. | | | |-|-| -| **Web** |

A button to enter fullscreen mode is displayed.

Some shortcut keys like CtrlN (macOS: ⌘N) are reserved by the web browser and can only be used in fullscreen mode. (Alternative to going fullscreen: include Alt in the shortcut combinations for browser-reserved hotkeys.)

Fullscreen button

| - - +| **Web** |

Fullscreen:

Fullscreen button

| +| **Windows** |

Minimize, maximize/restore down, close:

Minimize/maximize/close window buttons

| +| **Linux** |

Minimize, maximize/unmaximize, close:

Minimize/maximize/close window buttons

| +| **macOS** |

Close, minimize, fullscreen:

Close/minimize/fullscreen window buttons

| ## Workspace @@ -55,7 +56,7 @@ Beneath the panel header, the **panel content** displays the content for its pan The bar running across the bottom of the editor is called the **status bar**. -

Status bar

+

Status bar

### Input hints @@ -63,17 +64,17 @@ The **input hints** are presently the only occupant of the status bar. They indi Hints with a **`+`** mean that adding the indicated modifier key will change the base action. For example: in the following action, dragging with left-click held down will zoom the canvas; then additionally holding the Ctrl key will make the zoom action snap to whole increments. -

Example hint

+

Example hint

Hints with a **`/`** mean that either indicated input combination can be used to trigger the same action. For example: in the following action, either holding the space bar while dragging with the left mouse button held down, or just dragging with the middle mouse button held down, will both pan around the document in the viewport. -

Example hint

+

Example hint

The following chart describes each icon representing the mouse inputs you can perform so a hint's prescribed action occurs. | | Clicks | Drags | Others | |-|:-:|:-:|:-:| -| | | Drag icon
Drag | Mouse kept stationary icon
Stationary | -| **Left
mouse
button** | Left click icon
Left click | Left click drag icon
Left click drag | Left double-click icon
Left double-click | -| **Right
mouse
button** | Right click icon
Right click | Right click drag icon
Right click drag | Right double-click icon
Right double-click | -| **Middle
mouse
button** | Middle click icon
Middle click | Middle click drag icon
Middle click drag | Scroll up/down icons
Scroll up/down | +| **Left
mouse
button** | Left click icon

Left click | Left click drag icon

Left click drag | Left double-click icon

Left double-click | +| **Right
mouse
button** | Right click icon

Right click | Right click drag icon

Right click drag | Right double-click icon

Right double-click | +| **Middle
mouse
button** | Middle click icon

Middle click | Middle click drag icon

Middle click drag | Scroll up/down icons

Scroll up/down | +| **No
mouse
button** | | Drag icon

Drag | | diff --git a/website/content/learn/interface/document-panel.md b/website/content/learn/interface/document-panel.md index 57d71fd4..905667ca 100644 --- a/website/content/learn/interface/document-panel.md +++ b/website/content/learn/interface/document-panel.md @@ -71,19 +71,29 @@ This narrow bar runs vertically down the left side of the Document panel beside ### Tools -Located at the top of the tool shelf area, the **tool shelf** provides a selection of **tools** for interactively editing the artwork. +The tool shelf + +Located at the top of the tool shelf area, the **tool shelf** provides a selection of **tools** for interactively editing the artwork. It is composed of three sections: + +
| | | |-|-| -| The tool shelf |

The tool shelf is split into three sections: the **general tools** (gray icons), **vector tools** (blue icons), and **raster tools** (orange icons).

| +| **General tools** | (Gray icons) Used for assorted editing tasks within the viewport. | +| **Vector tools** | (Blue icons) Used for drawing and editing vector shapes, paths, and text. | +| **Raster tools** | (Orange icons) Used for drawing and editing raster image content. The grayed out icons are placeholders for upcoming tools. | + +
+ +
### Working colors -The **working colors** are the two colors used by the active tool. +The working colors -| | | -|-|-| -| The working colors |

The upper circle is the **primary color**. The lower circle is the **secondary color**.

There are two buttons located underneath: **Swap** which reverses the current color choices, and **Reset** which restores the primary color to black and the secondary color to white.

| +The **working colors** are the two colors used by the active tool. The upper circle is the **primary color**. The lower circle is the **secondary color**. + +There are two buttons located underneath: **Swap** which reverses the current color choices, and **Reset** which restores the primary color to black and the secondary color to white. The tool controls (above the viewport) for some of the tools offer choices for using the primary and secondary colors. For example, the vector drawing tools have **Fill** and **Stroke** options that use the current secondary and primary colors, respectively, as defaults: diff --git a/website/content/learn/interface/menu-bar.md b/website/content/learn/interface/menu-bar.md index a48caa55..fe5d0286 100644 --- a/website/content/learn/interface/menu-bar.md +++ b/website/content/learn/interface/menu-bar.md @@ -7,112 +7,131 @@ order = 1 The **menu bar** is the series of menus running across the top left of the editor's [**title bar**](../#title-bar). It provides organized access to many actions which are described on this page. -

The menu bar

+Clicking **File**, **Edit**, **Layer**, **Select**, **View**, **Window**, and **Help** opens a dropdown menu with clickable actions. Pay attention to the keyboard shortcut listed on the right of each row in the dropdown menus. Learning to use them can help speed up your workflow. -Clicking **File**, **Edit**, **Layer**, **Document**, **View**, and **Help** opens a dropdown menu with clickable actions. Pay attention to the keyboard shortcut listed on the right of each row in the dropdown menus. Learning to use them can help speed up your workflow. +## Menu actions reference The rest of this page is intended as a reference resource. Skip ahead to the next page if this is your first read-through of the manual. -## App button +### App button -

The app button

+The **app button** appears as the Graphite [logo](/logo). Clicking it opens the website [home page](/). -The **app button** shows the [Graphite logo](/logo). Clicking it opens the Graphite website [home page](/). - -## File - -

The File menu

+### File The **File menu** lists actions related to file handling: | | | |-|-| -| New… |

Opens the **New Document** dialog for creating a blank canvas in a new editor tab.

The 'New Document' dialog

| -| Open… |

Opens the operating system file picker dialog for selecting a `.graphite` file from disk to be opened in a new editor tab.

| -| Open Demo Artwork… |

Opens the **Demo Artwork** dialog for loading a choice of premade sample artwork files provided for you to explore. Click the button below each image to open it.

The 'Demo Artwork' dialog

| -| Close |

Closes the active document. If it has unsaved changes (denoted by the `*` after the file name), you will be asked to save or discard the changes.

| -| Close All |

Closes all open documents. To avoid accidentally losing unsaved work, you will be asked to confirm that you want to proceed which will discard the unsaved changes in all open documents.

| -| Save |

Saves the active document by writing the `.graphite` file to disk. An operating system file download dialog may appear asking where to place it. That dialog will provide an opportunity to save over a previous version of the file, if you wish, by picking the identical name instead of saving another instance with a number after it.

| -| Import… |

Opens the operating system file picker dialog for selecting an image file from disk to be placed as a new bitmap image layer or SVG content into the active document.

| -| Export… |

Opens the **Export** dialog for saving the artwork as a *File Type* of *PNG*, *JPG*, or *SVG*. *Scale Factor* multiplies the content's document scale, so a value of 2 would export 300x400 content as 600x800 pixels. *Bounds* picks what area to render: *All Artwork* uses the bounding box of all layers, *Selection* uses the bounding box of the currently selected layers, and an *Artboard: \[Name\]* uses the bounds of that artboard. *Transparency* exports PNG or SVG files with transparency instead of the artboard background color.

The 'Export' dialog

| -| Preferences… |

Opens the **Editor Preferences** dialog for configuring Graphite's settings.

The 'Editor Preferences' dialog

| +| **New…** |

Opens the **New Document** dialog for creating a blank canvas in a new editor tab.

The 'New Document' dialog

| +| **Open…** |

Opens the operating system file picker dialog for selecting a `.graphite` file from disk to be opened in a new editor tab.

| +| **Open Demo Artwork…** |

Opens the **Demo Artwork** dialog for loading a choice of premade sample artwork files provided for you to explore. Click the button below each image to open it.

The 'Demo Artwork' dialog

| +| **Close** |

Closes the active document. If it has unsaved changes (denoted by the `*` after the file name), you will be asked to save or discard the changes.

| +| **Close All** |

Closes all open documents. To avoid accidentally losing unsaved work, you will be asked to confirm that you want to proceed which will discard the unsaved changes in all open documents.

| +| **Save** |

Saves the active document by writing the `.graphite` file to disk. An operating system file download dialog may appear asking where to place it. That dialog will provide an opportunity to save over a previous version of the file, if you wish, by picking the identical name instead of saving another instance with a number after it.

| +| **Import…** |

Opens the operating system file picker dialog for selecting an image file from disk to be placed as a new bitmap image layer or SVG content into the active document.

| +| **Export…** |

Opens the **Export** dialog for saving the artwork as a *File Type* of *PNG*, *JPG*, or *SVG*. *Scale Factor* multiplies the content's document scale, so a value of 2 would export 300x400 content as 600x800 pixels. *Bounds* picks what area to render: *All Artwork* uses the bounding box of all layers, *Selection* uses the bounding box of the currently selected layers, and an *Artboard: \[Name\]* uses the bounds of that artboard. *Transparency* exports PNG or SVG files with transparency instead of the artboard background color.

The 'Export' dialog

| +| **Preferences…** |

Opens the **Editor Preferences** dialog for configuring Graphite's settings.

The 'Editor Preferences' dialog

| -## Edit - -

The Edit menu

+### Edit The **Edit menu** lists actions related to the editing workflow: | | | |-|-| -| Undo |

Steps back in the history of changes in the active document.

| -| Redo |

Steps forward in the history of changes in the active document.

| -| Cut |

Copies the selected layer(s) to the clipboard, then deletes them.

| -| Copy |

Copies the selected layer(s) to the clipboard.

| -| Paste |

Pastes the copied layer(s) from the clipboard into the document. It will end up directly above the selected layer, or otherwise at the base of the folder structure.

In the web version of Graphite, your browser will ask for permission to read from your clipboard which you must grant; alternatively, using the hotkey CtrlV (macOS: ⌘V) works without the browser needing this permission.

| +| **Undo** |

Steps back in the history of changes in the active document.

| +| **Redo** |

Steps forward in the history of changes in the active document.

| +| **Cut** |

Copies the selected layer(s) to the clipboard, then deletes them.

| +| **Copy** |

Copies the selected layer(s) to the clipboard.

| +| **Paste** |

Pastes the copied layer(s) from the clipboard into the document. It will end up directly above the selected layer, or otherwise at the base of the folder structure.

In the web version of Graphite, your browser will ask for permission to read from your clipboard which you must grant; alternatively, using the hotkey CtrlV (macOS: ⌘V) works without the browser needing this permission.

| +| **Duplicate** |

Creates a copy of the selected layer(s) directly above their original(s) in the layer stack.

| +| **Delete** |

Removes all selected layers and folders.

| +| **Convert to Infinite Canvas** |

Replaces all artboards in the document with standard layers. With no artboards present, the document becomes an infinite canvas.

| -## Layer - -

The Layer menu

+### Layer The **Layer menu** lists actions related to the layers within a document: | | | |-|-| -| New |

Creates a new layer in the active document. It will end up directly above the selected layer, or otherwise at the base of the folder structure.

| -| Select All |

Selects all layers and folders in the document.

| -| Deselect All |

Deselects everything in the document.

| -| Previous Selection |

Goes back to the previously selected set of layers/nodes in the selection history.

If the side of your mouse has navigation buttons, you can use the back button as a shortcut (not supported in Firefox).

| -| Next Selection |

Goes forward to the next selected set of layers/nodes in the selection history.

If the side of your mouse has navigation buttons, you can use the forward button as a shortcut (not supported in Firefox).

| -| Group Selected |

Creates a new folder in place of the selected layer(s), then moves them into that folder.

| -| Delete Selected |

Removes all selected layers and folders.

| -| Grab Selected |

Begin grabbing the selected layer(s) to translate (move) them around with your cursor's movement. Lock to an axis with X or Y then use the number keys to type a pixel distance value. Confirm with a left click or Enter. Cancel with a right click or Esc.

| -| Rotate Selected |

Begin rotating the selected layer(s) around their pivot point with your cursor's movement. Use the number keys to type an angle value in degrees. Confirm with a left click or Enter. Cancel with a right click or Esc.

| -| Scale Selected |

Begin scaling the selected layer(s) around their pivot point with your cursor's movement. Lock to an axis with X or Y. Use the number keys to type a scale multiplier value. Confirm with a left click or Enter. Cancel with a right click or Esc.

| -| Order >
Raise to Front |

Reorders the selected layer(s) above all others within their same folder(s), so they appear in the layer stack and render above those other layers.

| -| Order >
Raise |

Reorders the selected layers(s) up by one in the layer stack, so any layer that was immediately above the selected layer(s) ends up immediately below.

| -| Order >
Lower |

Reorders the selected layers(s) down by one in the layer stack, so any layer that was immediately below the selected layer(s) ends up immediately above.

| -| Order >
Lower to Back |

Reorders the selected layer(s) below all others within their same folder(s), so they appear in the layer stack and render below those other layers.

| +| **New** |

Creates a new layer in the active document. It will end up directly above the selected layer, or otherwise at the base of the folder structure.

| +| **Group** |

Creates a new folder in place of the selected layer(s), then moves them into that folder.

| +| **Ungroup** |

Removes the selected folder(s), moving their contents up one level in the layer stack.

| +| **Hide/Show** |

Toggles visibility of the selected layer(s), including or excluding them from rendering as part of the artwork.

| +| **Lock/Unlock** |

Toggles the locked state of the selected layer(s), preventing them from being selected by tools in the viewport.

| +| **Grab** |

Begin grabbing the selected layer(s) to translate (move) them around with your cursor's movement. Lock to an axis with X or Y then use the number keys to type a pixel distance value. Confirm with a left click or Enter. Cancel with a right click or Esc.

| +| **Rotate** |

Begin rotating the selected layer(s) around their pivot point with your cursor's movement. Use the number keys to type an angle value in degrees. Confirm with a left click or Enter. Cancel with a right click or Esc.

| +| **Scale** |

Begin scaling the selected layer(s) around their pivot point with your cursor's movement. Lock to an axis with X or Y. Use the number keys to type a scale multiplier value. Confirm with a left click or Enter. Cancel with a right click or Esc.

| +| **Arrange >
Raise to Front** |

Reorders the selected layer(s) above all others within their same folder(s), so they appear in the layer stack and render above those other layers.

| +| **Arrange >
Raise** |

Reorders the selected layers(s) up by one in the layer stack, so any layer that was immediately above the selected layer(s) ends up immediately below.

| +| **Arrange >
Lower** |

Reorders the selected layers(s) down by one in the layer stack, so any layer that was immediately below the selected layer(s) ends up immediately above.

| +| **Arrange >
Lower to Back** |

Reorders the selected layer(s) below all others within their same folder(s), so they appear in the layer stack and render below those other layers.

| +| **Arrange >
Reverse** |

Reorders the selected layers by swapping their positions from top to bottom. Reversal applies amongst each set of selected sibling layers (those with a shared parent).

| +| **Align >
Align Left** |

Moves the selected layer(s) so their left edges line up with the leftmost edge of the selection's bounding box.

| +| **Align >
Align Horizontal Center** |

Moves the selected layer(s) so their horizontal centers line up with the horizontal center of the selection's bounding box.

| +| **Align >
Align Right** |

Moves the selected layer(s) so their right edges line up with the rightmost edge of the selection's bounding box.

| +| **Align >
Align Top** |

Moves the selected layer(s) so their top edges line up with the topmost edge of the selection's bounding box.

| +| **Align >
Align Vertical Center** |

Moves the selected layer(s) so their vertical centers line up with the vertical center of the selection's bounding box.

| +| **Align >
Align Bottom** |

Moves the selected layer(s) so their bottom edges line up with the bottommost edge of the selection's bounding box.

| +| **Flip >
Flip Horizontal** |

Reflects the selected layer(s) horizontally within the selection's bounding box.

| +| **Flip >
Flip Vertical** |

Reflects the selected layer(s) vertically within the selection's bounding box.

| +| **Turn >
Turn -90°** |

Rotates the selected layer(s) a quarter turn counterclockwise about the selection's bounding box center.

| +| **Turn >
Turn 90°** |

Rotates the selected layer(s) a quarter turn clockwise about the selection's bounding box center.

| +| **Boolean >
Union** |

Combines all paths of the selected vector layer(s) while cutting out overlapping areas (even the interiors of a single path) +| **Boolean >
Subtract Front** |

Cuts overlapping areas out from the last of the selected vector layers.

| +| **Boolean >
Subtract Back** |

Cuts overlapping areas out from the first of the selected vector layers.

| +| **Boolean >
Intersect** |

Cuts away all but the overlapping areas shared by every path of the selected vector layer(s).

| +| **Boolean >
Difference** |

Cuts away the overlapping areas shared by every path of the selected vector layer(s), leaving only the non-overlapping areas.

| +| **Make Path Editable** |

Applies a path edit operation (the **Path node**) to the selected vector layer, capturing the geometry after other nondestructive operations to enable its direct modification by the **Path** and **Pen** tools.

| -## Document +### Select -

The Document menu

- -The **Document menu** lists actions related to the document and artwork: +The **Select menu** lists actions related to the selection of layers within a document: | | | |-|-| -| Clear Artboards |

Removes all artboards from the document, resulting in an infinite canvas.

| +| **Select All** |

Selects all layers and folders in the document.

| +| **Deselect All** |

Deselects everything in the document.

| +| **Select Parent** |

Selects the parent folder(s) of the currently selected layer(s).

| +| **Previous Selection** |

Goes back to the previously selected set of layers or nodes in the selection history.

If the side of your mouse has navigation buttons, you can use the back button as a shortcut (not supported in Firefox).

| +| **Next Selection** |

Goes forward to the next selected set of layers or nodes in the selection history.

If the side of your mouse has navigation buttons, you can use the forward button as a shortcut (not supported in Firefox).

| -## View - -

The View menu

+### View The **View menu** lists actions related to the view of the canvas within the viewport: | | | |-|-| -| Tilt |

Begins tilting the viewport angle based on your mouse movements.

While tilting, hold Shift to snap to 15° increments. Confirm with a left click or Enter. Cancel with a right click or Esc.

| -| Reset Tilt |

Sets the viewport tilt angle back to 0°.

| -| Zoom In |

Narrows the view to the next whole zoom increment, such as:

25%, 33.33%, 40%, 50%, 66.67%, 80%, 100%, 125%, 160%, 200%, 250%, 320%, 400%, 500%

| -| Zoom Out |

Widens the view to the next whole zoom increment, such as above.

| -| Zoom to Selection |

Zooms and frames the viewport to the bounding box of the selected layer(s).

| -| Zoom to Fit |

Zooms and frames the viewport to fit all artboards, or all artwork if using infinite canvas.

| -| Zoom to 100% |

Zooms the viewport in or out to 100% scale, making the document and viewport scales match 1:1.

| -| Zoom to 200% |

Zooms the viewport in or out to 200% scale, displaying the artwork at twice the actual size.

| -| Flip |

Mirrors the viewport horizontally, flipping the view of the artwork until deactivated.

| -| Rulers |

Toggles visibility of the rulers along the top/left edges of the viewport.

| +| **Tilt** |

Begins tilting the viewport angle based on your mouse movements.

While tilting, hold Shift to snap to 15° increments. Confirm with a left click or Enter. Cancel with a right click or Esc.

| +| **Reset Tilt** |

Sets the viewport tilt angle back to 0°.

| +| **Zoom In** |

Narrows the view to the next whole zoom increment, such as:

25%, 33.33%, 40%, 50%, 66.67%, 80%, 100%, 125%, 160%, 200%, 250%, 320%, 400%, 500%

| +| **Zoom Out** |

Widens the view to the next whole zoom increment, such as above.

| +| **Zoom to Selection** |

Zooms and frames the viewport to the bounding box of the selected layer(s).

| +| **Zoom to Fit** |

Zooms and frames the viewport to fit all artboards, or all artwork if using infinite canvas.

| +| **Zoom to 100%** |

Zooms the viewport in or out to 100% scale, making the document and viewport scales match 1:1.

| +| **Zoom to 200%** |

Zooms the viewport in or out to 200% scale, displaying the artwork at twice the actual size.

| +| **Flip** |

Mirrors the viewport horizontally, flipping the view of the artwork until deactivated.

| +| **Rulers** |

Toggles visibility of the rulers along the top/left edges of the viewport.

| -## Help +### Window -

The Help menu

+The **Window menu** lists actions related to the visibility of workspace panels within the application window: + +| | | +|-|-| +| **Properties** |

Toggles visibility of the **Properties panel** on the upper-right side of the workspace. It is used to inspect and edit the values of graphics operation (node) parameters. Selected layers or nodes display their parametric controls in this panel.

| +| **Layers** |

Toggles visibility of the **Layers panel** on the lower-right side of the workspace. It is used to organize and select the artboards and layers that form the structure of a document.

| +| **Data** |

Toggles visibility of the **Data panel** on the lower-left side of the workspace. It is used to introspect data flow from the output of a selected node for technical debugging of content generated within the node graph.

| + +### Help The **Help menu** lists actions related to information about Graphite: | | | |-|-| -| About Graphite… |

Opens the **About Graphite** dialog for displaying release and license information. You can check it for the release date of the current editor version.

| -| User Manual |

Opens this [user manual](./learn).

| -| Report a Bug |

Opens a page to file a [new GitHub issue](https://github.com/GraphiteEditor/Graphite/issues/new).

| -| Visit on GitHub |

Opens the [Graphite GitHub repository](https://github.com/GraphiteEditor/Graphite).

| -| *Debug section* |

Developer-only actions. Users should ignore these.

| +| **About Graphite…** |

Opens the **About Graphite** dialog for displaying release and license information. You can check it for the release date of the current editor version.

| +| **User Manual** |

Opens this [user manual](./learn).

| +| **Donate to Graphite** |

Opens the Graphite [development fund](/donate) page where you can contribute financially to support ongoing development of the project.

| +| **Report a Bug** |

Opens a page to file a [new GitHub issue](https://github.com/GraphiteEditor/Graphite/issues/new).

| +| **Visit on GitHub** |

Opens the [Graphite GitHub repository](https://github.com/GraphiteEditor/Graphite).

| +| **Developer Debug** |

A section with developer-only actions. Users should ignore these.

| diff --git a/website/content/learn/introduction/features-and-limitations.md b/website/content/learn/introduction/features-and-limitations.md index 533dc771..aa85c700 100644 --- a/website/content/learn/introduction/features-and-limitations.md +++ b/website/content/learn/introduction/features-and-limitations.md @@ -13,9 +13,9 @@ A lot is planned on the future [roadmap](/features#roadmap), but here's an overv ### Vector illustration and graphic design -| | | -|-|-| -|

Vector editing is the core competency of the Graphite editor at this stage in its development. That means you can create shape-based vector artwork and designs with the available tools.

Primitive geometry like rectangles and ellipses can be drawn and, as desired, modified into more complex shapes using the Path tool. Fully organic shapes may also be created from scratch with the Pen tool. They can then be given colors and gradients to add visual style. This cactus is an example of the style of artwork you can create with vector graphics.

| Example vector artwork of a potted cactus | +Example vector artwork of a potted cactus + +Vector editing is the core competency of the Graphite editor at this stage in its development. That means you can create shape-based vector artwork and designs with the available tools.

Primitive geometry like rectangles and ellipses can be drawn and, as desired, modified into more complex shapes using the Path tool. Fully organic shapes may also be created from scratch with the Pen tool. They can then be given colors and gradients to add visual style. This cactus is an example of the style of artwork you can create with vector graphics. ### Procedural design @@ -32,18 +32,13 @@ Starting from the left, the Circular Repeat node which has several parameters you can modify and get different output data based on your choices, like in these examples: | | | -|-|-| +|:-:|:-:| | | | | | | | | | @@ -57,31 +52,3 @@ The node's properties offer controls over settings like *Angle Offset* (what ang Raster image editing is a growing capability that will develop over time into the central focus of Graphite. Raster imagery is composed of pixels which are grids of color that can represent anything visual, like paintings and photographs. The current feature set lets you import images, manipulate them using the node-based compositor, and apply nondestructive global effects like color adjustment filters. A prototype Brush tool exists letting you draw simple doodles and sketches. However it is very limited in its capabilities and there are multiple bugs and performance issues with the feature. It can be used in a basic capacity, but don't expect to paint anything too impressive using raster brushes quite yet. The tool will be fully rewritten in the future. - -## Status and limitations - -Please make yourself aware of these factors to better understand and work around the rough edges in today's Graphite editor. - -### Evolving document format - -Saved documents will eventually fail to render in future versions of the Graphite editor because of code changes. Since node implementations and other systems are in flux, file format stability isn't possible yet during this alpha stage of development. If a file opens but there's a rendering error, you may need to open the node graph and replace outdated nodes by creating new ones near the site of an error. Later in the development roadmap, a redesigned file format with a `.gdd` (Graphite Design Document) extension will replace `.graphite` files and it will be built with seamless backwards-compatability in mind. - -### Limited raster tooling - -While you can import bitmap images, apply image effects in the node graph, and draw brush strokes, there is not much tooling yet to make the overall raster workflow that useful. Marquee selection is an upcoming feature slated for later in 2025 which will significantly improve the utility of raster editing in Graphite. - -Hardware accelerated rendering, to offload pixel processing from the CPU to GPU, is also planned for 2025. It will drastically improve the performance of working with millions of pixels. - -### Performance bottlenecks - -Graphite has several temporary performance bottlenecks that currently yield poor responsiveness when working with raster content, complex vector artwork, and large procedural node graphs. This is especially impactful for raster content. It also currently applies to large volumes of vector data, such as paragraphs worth of text (which is represented as vector paths). - -Each of these limitations will be resolved by finishing the implementations of incomplete systems that impose slowdowns in their current forms. For example, certain opportunities for node graph caching are not operational and GPU-accelerated rendering isn't enabled yet. - -Performance will be a high-priority focus throughout 2025. - -### Best-effort Safari support - -Old versions of Safari lack support for the web standards Graphite is built upon. The latest version of the browser still won't run Graphite as well as Chrome and you may encounter extra bugs because we have limited resources to regularly test for Safari issues. Feel free to file issues only if you're using the latest Safari version and find a bug that isn't present in Chrome. - -The latest Chrome, Edge, or Opera browser is recommended for the best-supported experience. Firefox works reasonably well, with only some minor loss of quality-of-life features. Brave is likely to encounter issues due to its aggressive degradation of web standards. diff --git a/website/content/volunteer/guide/graphene/_index.md b/website/content/volunteer/guide/graphene/_index.md index 3ca8f5d0..5667bf35 100644 --- a/website/content/volunteer/guide/graphene/_index.md +++ b/website/content/volunteer/guide/graphene/_index.md @@ -46,11 +46,11 @@ This sliding scale of latency/performance concerns maps directly to programming We designed Graphene to operate in all three regimes: -| Regime | Usage | -|:------------|:----------------------------------------------------------------------| +| Regime | Usage | +|-|-| | Interpreted | While editing. Simple and currently the only mode that's implemented. | -| JIT | While editing. Dynamically bridges the gap between both other regimes by selectively substituting branches of the graph with interpreted and compiled nodes to keep latency low and work towards higher execution performance. | -| Compiled | When exported. The entire graph is compiled as a standalone program. | +| JIT | While editing. Dynamically bridges the gap between both other regimes by selectively substituting branches of the graph with interpreted and compiled nodes to keep latency low and work towards higher execution performance. | +| Compiled | When exported. The entire graph is compiled as a standalone program. | ### Building upon the Rust compiler diff --git a/website/sass/base.scss b/website/sass/base.scss index 786f22d3..75bbe2a1 100644 --- a/website/sass/base.scss +++ b/website/sass/base.scss @@ -483,23 +483,44 @@ img { } table { - margin: 20px -20px; - width: calc(100% + 40px); + margin: 40px -10px; + width: calc(100% + 20px); + font-size: 16px; + border-collapse: collapse; th, td { - border: 20px solid transparent; + border: solid var(--color-fog); + border-width: 1px 0; vertical-align: top; margin: 0; - padding: 0; + padding: 20px; + + &:first-child { + padding-left: 10px; + } + + &:last-child { + padding-right: 10px; + } + + &:not(:first-child) img { + max-width: 100%; + } } - th:not(:first-child) img, - td:not(:first-child) img { - max-width: 100%; + thead:not(:has(tr th:not(:empty))) { + th { + padding: 0; + } + + + tbody tr:first-child td { + border: none; + } } - th:empty { + tr th, + tr:last-child td { border: none; }