docs: update
This commit is contained in:
parent
1182b7b55d
commit
0e31b146a3
2 changed files with 30 additions and 35 deletions
|
|
@ -14,22 +14,19 @@ This document describes the implemented and planned features of Noctua, a modern
|
||||||
- Real-time transformation preview
|
- Real-time transformation preview
|
||||||
- EXIF metadata extraction
|
- EXIF metadata extraction
|
||||||
|
|
||||||
#### Vector Graphics (Planned)
|
#### Vector Graphics (Implemented)
|
||||||
- **Formats**: SVG
|
- **Formats**: SVG
|
||||||
- **Status**: Code structure prepared, but rendering not yet implemented
|
- **Rendering**: High-quality rendering via `resvg` library
|
||||||
- **Planned capabilities**:
|
- **Capabilities**:
|
||||||
- High-quality rendering via `resvg`
|
- Scalable display at any zoom level without quality loss
|
||||||
- Scalable display without quality loss
|
|
||||||
- Metadata extraction
|
|
||||||
- Transformations (rotate, flip)
|
- Transformations (rotate, flip)
|
||||||
|
|
||||||
#### Portable Documents (Planned)
|
#### Portable Documents (Implemented)
|
||||||
- **Formats**: PDF
|
- **Formats**: PDF
|
||||||
- **Status**: Code structure prepared, but rendering not yet implemented
|
- **Rendering**: Full PDF rendering via poppler library
|
||||||
- **Planned capabilities**:
|
- **Multi-page navigation**: Browse through all pages of a document
|
||||||
- First page rendering
|
- **Page thumbnails**: Left sidebar shows page previews (generated on demand)
|
||||||
- Multi-page navigation
|
- **Transformations**: Rotate and flip on rendered pages
|
||||||
- Basic transformations on rendered pages
|
|
||||||
|
|
||||||
### Navigation
|
### Navigation
|
||||||
|
|
||||||
|
|
@ -91,9 +88,9 @@ This document describes the implemented and planned features of Noctua, a modern
|
||||||
- **Native COSMIC design**: Follows COSMIC desktop design language
|
- **Native COSMIC design**: Follows COSMIC desktop design language
|
||||||
- **Theme support**: Automatically adapts to system light/dark theme
|
- **Theme support**: Automatically adapts to system light/dark theme
|
||||||
- **Header toolbar**:
|
- **Header toolbar**:
|
||||||
- Navigation controls (Previous/Next)
|
- Left: Navigation controls (Previous/Next) and panel toggle
|
||||||
- Transformation buttons (Rotate, Flip)
|
- Center: Transformation buttons (Rotate, Flip) - horizontally centered
|
||||||
- Information panel toggle
|
- Right: Information panel toggle
|
||||||
- **Footer bar**:
|
- **Footer bar**:
|
||||||
- Zoom controls with buttons
|
- Zoom controls with buttons
|
||||||
- Current zoom level display
|
- Current zoom level display
|
||||||
|
|
@ -111,7 +108,8 @@ This document describes the implemented and planned features of Noctua, a modern
|
||||||
- Toggle with `i` key or toolbar button
|
- Toggle with `i` key or toolbar button
|
||||||
- **Navigation panel** (Left sidebar):
|
- **Navigation panel** (Left sidebar):
|
||||||
- Toggle with `n` key or toolbar button
|
- Toggle with `n` key or toolbar button
|
||||||
- Content not yet implemented
|
- For multi-page documents (PDF): Shows page thumbnails
|
||||||
|
- Click to navigate to specific page
|
||||||
|
|
||||||
#### Keyboard Shortcuts (Implemented)
|
#### Keyboard Shortcuts (Implemented)
|
||||||
Full keyboard-driven workflow:
|
Full keyboard-driven workflow:
|
||||||
|
|
@ -163,18 +161,6 @@ Full keyboard-driven workflow:
|
||||||
|
|
||||||
### High Priority
|
### High Priority
|
||||||
|
|
||||||
#### SVG Support
|
|
||||||
- Implement proper SVG parsing and rendering
|
|
||||||
- Integration with `resvg` library
|
|
||||||
- Scalable vector display
|
|
||||||
- Transformation support
|
|
||||||
|
|
||||||
#### PDF Support
|
|
||||||
- Implement PDF rendering backend
|
|
||||||
- First page display
|
|
||||||
- Multi-page navigation
|
|
||||||
- Page thumbnails
|
|
||||||
|
|
||||||
#### File Operations
|
#### File Operations
|
||||||
- File dialog integration (OpenPath message prepared)
|
- File dialog integration (OpenPath message prepared)
|
||||||
- Save transformed images
|
- Save transformed images
|
||||||
|
|
@ -184,8 +170,8 @@ Full keyboard-driven workflow:
|
||||||
### Medium Priority
|
### Medium Priority
|
||||||
|
|
||||||
#### Multi-format TIFF Support
|
#### Multi-format TIFF Support
|
||||||
- Multi-page TIFF navigation
|
- Multi-page TIFF navigation (infrastructure ready)
|
||||||
- Page thumbnails
|
- Page thumbnails for TIFF (same as PDF)
|
||||||
|
|
||||||
#### Metadata Editing
|
#### Metadata Editing
|
||||||
- EXIF data modification
|
- EXIF data modification
|
||||||
|
|
@ -200,7 +186,6 @@ Full keyboard-driven workflow:
|
||||||
- Basic color adjustments (brightness, contrast)
|
- Basic color adjustments (brightness, contrast)
|
||||||
|
|
||||||
#### Enhanced Navigation
|
#### Enhanced Navigation
|
||||||
- Thumbnail strip
|
|
||||||
- Grid view for folder contents
|
- Grid view for folder contents
|
||||||
- Quick jump to file
|
- Quick jump to file
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -14,8 +14,8 @@ When you open an image, Noctua automatically scans the folder and indexes all su
|
||||||
|
|
||||||
### Supported Formats
|
### Supported Formats
|
||||||
- **Raster Images**: PNG, JPEG, GIF, BMP, TIFF, WebP, and all formats supported by `image-rs`
|
- **Raster Images**: PNG, JPEG, GIF, BMP, TIFF, WebP, and all formats supported by `image-rs`
|
||||||
- **Vector Graphics**: SVG (planned, not yet implemented)
|
- **Vector Graphics**: SVG (with scalable rendering)
|
||||||
- **Portable Documents**: PDF (planned, not yet implemented)
|
- **Portable Documents**: PDF (with multi-page navigation and thumbnails)
|
||||||
|
|
||||||
## Keyboard Shortcuts
|
## Keyboard Shortcuts
|
||||||
|
|
||||||
|
|
@ -30,6 +30,10 @@ All keyboard shortcuts are case-insensitive unless otherwise noted.
|
||||||
|
|
||||||
The footer shows your current position (e.g., "3 / 42").
|
The footer shows your current position (e.g., "3 / 42").
|
||||||
|
|
||||||
|
For multi-page documents (PDF):
|
||||||
|
- Click thumbnails in the left sidebar to jump to a specific page
|
||||||
|
- Use `←` `→` to navigate between pages
|
||||||
|
|
||||||
### Zoom and View
|
### Zoom and View
|
||||||
|
|
||||||
| Key | Action | Description |
|
| Key | Action | Description |
|
||||||
|
|
@ -75,6 +79,9 @@ All transformations are lossless and show in real-time.
|
||||||
| `i` | Toggle properties | Show/hide the properties panel (metadata)|
|
| `i` | Toggle properties | Show/hide the properties panel (metadata)|
|
||||||
| `n` | Toggle navigation | Show/hide the navigation sidebar |
|
| `n` | Toggle navigation | Show/hide the navigation sidebar |
|
||||||
|
|
||||||
|
For multi-page documents (PDF), the navigation sidebar displays page thumbnails.
|
||||||
|
Click on a thumbnail to jump to that page.
|
||||||
|
|
||||||
### Actions
|
### Actions
|
||||||
|
|
||||||
| Key | Action | Description |
|
| Key | Action | Description |
|
||||||
|
|
@ -101,6 +108,8 @@ The header toolbar provides quick access to common operations:
|
||||||
### Left Side
|
### Left Side
|
||||||
- **Navigation toggle**: Show/hide the sidebar
|
- **Navigation toggle**: Show/hide the sidebar
|
||||||
- **Previous/Next buttons**: Navigate between images in the folder
|
- **Previous/Next buttons**: Navigate between images in the folder
|
||||||
|
|
||||||
|
### Center (Horizontally Centered)
|
||||||
- **Rotate buttons**: Rotate clockwise or counter-clockwise
|
- **Rotate buttons**: Rotate clockwise or counter-clockwise
|
||||||
- **Flip buttons**: Flip horizontally or vertically
|
- **Flip buttons**: Flip horizontally or vertically
|
||||||
|
|
||||||
|
|
@ -134,6 +143,8 @@ The footer displays useful information:
|
||||||
- **Image dimensions**: Width × Height in pixels
|
- **Image dimensions**: Width × Height in pixels
|
||||||
- **Navigation position**: Current image / Total images in folder
|
- **Navigation position**: Current image / Total images in folder
|
||||||
|
|
||||||
|
For PDFs, it also shows the current page number.
|
||||||
|
|
||||||
## Tips and Tricks
|
## Tips and Tricks
|
||||||
|
|
||||||
### Keyboard-Driven Workflow
|
### Keyboard-Driven Workflow
|
||||||
|
|
@ -173,8 +184,7 @@ The following features are prepared in code but not yet implemented:
|
||||||
- (Copy/Move/)Delete operations
|
- (Copy/Move/)Delete operations
|
||||||
|
|
||||||
### Document Support
|
### Document Support
|
||||||
- SVG rendering with `resvg`
|
- SVG rendering (implemented)
|
||||||
- PDF rendering with multi-page support
|
|
||||||
|
|
||||||
### Advanced Editing
|
### Advanced Editing
|
||||||
- Crop mode (`c` key prepared)
|
- Crop mode (`c` key prepared)
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue