Skip to content

Commit 4eaa98d

Browse files
committed
Update README.md
1 parent dd1fe6f commit 4eaa98d

1 file changed

Lines changed: 152 additions & 0 deletions

File tree

README.md

Lines changed: 152 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -237,6 +237,158 @@ You can customize various parameters by accessing the node's Properties panel in
237237
- Automatically adjusts dimensions to model requirements
238238
4. **Apply**: Dimensions are automatically updated
239239

240+
## 🎯 Advanced Preset Management
241+
242+
ResolutionMaster includes a powerful **Preset Manager** system for creating, organizing, and managing custom presets. Access it by clicking the **"⚙️ Manage Presets"** button in the Presets section.
243+
244+
### Preset Manager Features
245+
246+
#### 📋 List View
247+
The main view shows all your custom presets organized by category:
248+
249+
- **Statistics Header**: Displays total categories and preset count
250+
- **Category Sections**: Each category shows its presets with dimensions
251+
- **Bulk Operations**: Select multiple presets for batch deletion (Shift+Click for range selection)
252+
- **Empty State**: Helpful message when no custom presets exist
253+
254+
#### ➕ Add/Edit Preset View
255+
Create or modify presets with an intuitive interface:
256+
257+
- **Category Selection**: Choose target category from dropdown
258+
- **Rename Category**: Click the ✏️ button next to category name to rename
259+
- **Quick Add Form**:
260+
- Name field with real-time validation
261+
- Width and Height inputs (minimum 64px)
262+
- Live preview showing aspect ratio and shape visualization
263+
- Visual feedback for edit mode (green accents) vs add mode (blue accents)
264+
- **Preset Preview**: Grid view of all presets in selected category
265+
- Click any preset to load its values into the form for editing
266+
- Delete custom presets or hide/unhide built-in presets
267+
- Visual indicators for custom (⚙️ icon) and hidden presets
268+
269+
#### 🔄 Drag & Drop Operations
270+
271+
The Preset Manager supports advanced drag & drop with visual feedback:
272+
273+
##### Preset Reordering & Moving
274+
- **Drag Handle (left side)**: Drag presets to reorder within category or move between categories
275+
- **Visual Indicators**:
276+
- **Blue line**: Reordering within same category
277+
- **Orange line**: Moving to different category
278+
- **Red line**: Invalid drop (name conflict)
279+
- **Green line**: Duplicate/clone operation
280+
- **Modifier Keys**:
281+
- **Normal Drag**: Move preset to new position
282+
- **Drag by Clone Handle (⊕)**: Duplicate preset to new location
283+
284+
##### Category Reordering
285+
- **Drag Category Headers**: Reorder entire categories by dragging their headers
286+
- **Drop Zones**:
287+
- Above any category header
288+
- Below last category (in category section body)
289+
- At top (drop on statistics header)
290+
291+
#### 🔄 Clone/Duplicate Presets
292+
- **Clone Handle (⊕ icon)**: Drag this handle to duplicate a preset
293+
- **Auto-naming**: Automatically generates unique names (e.g., "Preset (1)", "Preset (2)")
294+
- **Cross-category Cloning**: Duplicate presets between different categories
295+
- **Smart Positioning**: Dropped preset appears at the exact position where you drop it
296+
297+
#### ✏️ Rename Functionality
298+
299+
##### Inline Renaming
300+
- **Double-click** on any preset or category name to rename in-place
301+
- **Enter**: Save changes
302+
- **Escape**: Cancel editing
303+
- **Auto-validation**: Prevents duplicate names, empty names
304+
- **Auto-unique naming** (categories): Adds suffix "(1)", "(2)" if name exists
305+
306+
##### Rename Dialog (Categories)
307+
- Click ✏️ button next to category name in Add view
308+
- Real-time validation with error messages
309+
- Shows current name for reference
310+
- Enter to apply, Escape to cancel
311+
312+
#### 📝 JSON Editor
313+
314+
Advanced users can directly edit the preset configuration as JSON:
315+
316+
- **Multiple Editor Modes**: Code, Tree, Form, Text, View, Preview
317+
- **Syntax Highlighting**: VS Code-style dark theme (Twilight)
318+
- **Real-time Validation**: Instant feedback on JSON syntax errors
319+
- **Drag & Drop**: Drop .json files directly into the editor to load them
320+
- **Full Editing**: Add, remove, or modify categories and presets
321+
- **Import/Export**:
322+
- Apply changes to replace current configuration
323+
- Export current configuration as JSON file
324+
- **All Features Available**: Sort, transform, search, and more
325+
326+
**Access**: Click **"{ } JSON Editor"** button in Preset Manager footer
327+
328+
**Use Cases**:
329+
- Bulk editing multiple presets
330+
- Importing preset collections from files
331+
- Creating complex preset structures
332+
- Backup and restore configurations
333+
- Sharing preset collections with others
334+
335+
#### 🗑️ Deletion Options
336+
337+
- **Individual Delete**: Click 🗑️ button on any custom preset
338+
- **Hide Built-in Presets**: Click 🗑️ on built-in presets to hide them (they remain in system)
339+
- **Unhide**: Click 🗑️ again on hidden presets to restore visibility
340+
- **Bulk Delete**:
341+
- Select multiple presets using checkboxes
342+
- Click **"Delete Selected"** button
343+
- Shift+Click for range selection
344+
- **Delete Empty Categories**: Option in footer to clean up categories with no presets
345+
346+
#### 🎨 Visual Feedback & Tooltips
347+
348+
- **Color-coded Indicators**: Different colors for different drag operations
349+
- **Interactive Tooltips**: Hover over buttons for helpful descriptions
350+
- **Mode Indicators**: Visual distinction between add and edit modes
351+
- **Real-time Validation**: Instant feedback on errors and conflicts
352+
- **Shape Preview**: Visual representation of aspect ratio in add/edit form
353+
354+
#### ⌨️ Keyboard Shortcuts & Interactions
355+
356+
- **Double-click**: Rename preset or category name
357+
- **Enter**: Apply rename or save changes
358+
- **Escape**: Cancel current operation or close dialog
359+
- **Shift+Click**: Select range of presets (bulk operations)
360+
- **Ctrl/Cmd+Drag**: Fine control for drag operations
361+
362+
### Import/Export Presets
363+
364+
#### Export
365+
1. Open Preset Manager
366+
2. Click **"📥 Export JSON"** button
367+
3. JSON file downloads with current preset configuration
368+
4. Share or backup your custom presets
369+
370+
#### Import
371+
1. Open Preset Manager
372+
2. Click **"📤 Import JSON"** button
373+
3. Choose merge or replace mode:
374+
- **Merge**: Add new presets, keep existing ones
375+
- **Replace**: Completely replace current configuration
376+
4. Select your .json file
377+
5. Presets are loaded instantly
378+
379+
**Alternative**: Use the JSON Editor's drag & drop feature to load preset files directly
380+
381+
### Preset Manager Tips
382+
383+
1. **Organize by Category**: Keep related presets together for easier management
384+
2. **Use Descriptive Names**: Clear names make presets easier to find and use
385+
3. **Clone for Variations**: Duplicate similar presets and adjust slightly
386+
4. **Regular Backups**: Export your presets periodically
387+
5. **Hide Unused Built-ins**: Declutter your preset list by hiding unused built-in presets
388+
6. **Keyboard Navigation**: Use double-click rename for quick adjustments
389+
7. **Visual Validation**: Watch the preview shape when creating presets to verify aspect ratio
390+
8. **Drag to Organize**: Quickly reorder presets and categories with drag & drop
391+
240392
### Scaling Workflow
241393
242394
The node provides three scaling methods that work together:

0 commit comments

Comments
 (0)