ryOS ryOS / Docs
GitHub Launch

Paint

Paint is a versatile, canvas-based image editor for ryOS, enabling users to create original artwork, doodle, or make quick edits to existing images. It provides a familiar set of drawing tools and features within a lightweight and intuitive interface, perfect for both casual creativity and basic image manipulation.

Overview

Paint serves as ryOS's primary application for graphic creation and simple image editing. It offers a digital canvas where users can unleash their creativity using a variety of drawing instruments, apply visual effects, and fill areas with diverse patterns. Designed for ease of use, Paint is suitable for quick sketches, diagramming, basic photo touch-ups, and artistic expression directly within the ryOS environment. Its focus on accessibility and core functionality makes it an essential tool for many desktop tasks.

The application integrates seamlessly into the ryOS ecosystem, allowing users to save their creations locally or share them with other applications. With support for common image operations and a straightforward user interface, Paint empowers users to bring their visual ideas to life without requiring complex software.

Features

  • Diverse Drawing Tools: Utilize a comprehensive toolbar on the left side of the window to select from a variety of drawing instruments, including a pencil for fine lines, a brush for broader strokes, and tools for creating geometric shapes.
  • Adjustable Stroke Settings: Precisely control the appearance of your lines and shapes by adjusting the stroke width for tools like the pencil and brush using dedicated controls within the toolbar.
  • Rich Pattern Palette: Access a collection of predefined patterns from the bottom palette to fill shapes, backgrounds, or specific areas of your canvas, adding visual depth and texture to your artwork.
  • Image Filters & Effects: Enhance or transform your images by applying various filters available in the "Filters" menu, such as invert colors, grayscale conversion, and brightness adjustments.
  • Undo Functionality: Easily correct mistakes or experiment with changes using the "Undo" feature, which reverts your last action, ensuring a flexible and forgiving creative process.
  • File Saving & Management: Securely save your artwork to a file using the "File > Save" option, or create new versions with "File > Save As" to manage multiple iterations of your creations.

User Guide

Getting Started

To launch Paint, simply click its icon in the ryOS application launcher. A new, blank canvas will appear, ready for your creative endeavors. You can immediately begin drawing using the default pencil tool.

Key Actions

  • Selecting Tools: Click on any icon in the left-hand toolbar to choose a drawing tool, such as the pencil, brush, or shape tools.
  • Adjusting Stroke Width: After selecting a drawing tool like the pencil or brush, use the dedicated stroke width controls, typically found near the toolbar, to increase or decrease the line thickness.
  • Applying Patterns: Open the pattern palette at the bottom of the window and click on a pattern to select it. This pattern will then be used for filling shapes or areas with the appropriate tool.
  • Using Filters: To apply an effect, go to the "Filters" menu in the menu bar and select an option like "Invert," "Grayscale," or "Brightness" to instantly transform your entire canvas.
  • Undoing Actions: If you make a mistake or want to revert a change, navigate to "Edit > Undo" in the menu bar, or use the keyboard shortcut ⌘Z.
  • Saving Your Work: To save your current artwork, go to "File > Save." If you want to save it under a new name or in a different location, choose "File > Save As."

Tips & Shortcuts

  • Quick Undo: The fastest way to undo your last action is to press ⌘Z.
  • Experiment with Patterns: Don't forget to explore the pattern palette; it can dramatically change the look of your fills and backgrounds.
  • Filters for Quick Effects: Filters offer a quick way to give your artwork a different mood or style without complex manual adjustments.

Technical Details

Window Configuration

  • Default size: 713×480px
  • Minimum size: 400×400px
  • Maximum size: 713×535px

Component Architecture

The app consists of 8 component file(s):

Hooks & Utilities

Custom Hooks:

State Management

The Paint app primarily manages its state using the usePaintLogic custom hook. This hook encapsulates and orchestrates various aspects of the application's state, including the currently selected drawing tool, stroke width, active pattern, canvas content, undo/redo history, file save status, and the visibility of various dialogs (help, about, confirm, save). This approach centralizes the application's logic and state, providing a clear separation of concerns from the UI components.

Related Apps

Paint integrates well with the Files app for saving and opening image files, and images created in Paint can be easily viewed or used as wallpapers via the Settings app.