You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -20,7 +21,7 @@ ImageAlchemy - A PyQT5-based image processing application offering a variety of
20
21
## Description
21
22
ImageAlchemy is a comprehensive image processing application developed using PyQT5, providing a range of powerful techniques including grayscale conversion, noise addition, various filters, edge detection, thresholding, equalization, active contouring using Snake Algorithm, hybrid image creation, and Hough transformations. Remarkably, all functionalities are implemented from scratch, avoiding dependency on external libraries like OpenCV or Scikit-Image, ensuring a lightweight and self-contained solution for digital image processing needs.
22
23
23
-
## Project Features
24
+
## Features
24
25
:white_check_mark:**3 Ways to add an image to the viewport**
25
26
-:heavy_check_mark: Using the import button in the **_File_** menu in the menu bar, or use the [shortcut](#shortcuts)
26
27
-:heavy_check_mark: Drag and drop an image from your system
@@ -62,25 +63,43 @@ ImageAlchemy is a comprehensive image processing application developed using PyQ
62
63
<divalign="center">
63
64
64
65
</div>
The provided image serves as a guide to understanding the various sections of our app's interface. Below, we'll delve into each section's functionality and elucidate how users can navigate and utilize the app effectively.
80
72
81
-
## App Flow
73
+
**`Menu Bar`**:
74
+
Contained within this bar are four distinct menus:
1.**File Menu**: Primarily responsible for importing images, saving options for edited image outputs, and exiting the application.
77
+
78
+
2.**Edit Menu**: Under development, intended for customizing the app interface's appearance. Presently, it has no visible impact on the app.
79
+
80
+
3.**Tools Menu**: This menu currently houses the image library and examples for users to experiment with different image processing techniques.
81
+
82
+
4.**Help Menu**: Provides options to access the application's documentation and a guide on app usage. These features are currently unavailable as the app is still in development.
83
+
84
+
**`Main Viewport`**:
85
+
86
+
The viewport serves the purpose of displaying both the imported input image and the output image post-application of various processing techniques. Essentially, it functions as a tab, offering developers the flexibility to incorporate additional tabs for specific steps or plots related to certain effects in the future.
87
+
88
+
**`Image Tree`**:
89
+
90
+
Designed to facilitate the seamless navigation between different images and their associated effects, the image tree displays imported images along with their respective effects. Users can simply double-click on an image name within the tree to revert to a previously opened image.
91
+
92
+
**`Effects to Add`**:
93
+
94
+
This section features buttons representing specific effects. Users can expand the menu to view the names of each effect and add them to the current image by double-clicking the desired effect.
95
+
96
+
**`Effects Tweaking Menu`**:
97
+
98
+
Tailored to accommodate the specific attributes and parameters of each image processing technique, this menu displays controllers for adjusting these parameters. By default, it showcases the parameters of all effects applied to all images, organized within group boxes. However, users have the flexibility to focus on specific effects by double-clicking on their names within the tree.
99
+
100
+
**`Added Effects Table`**:
101
+
102
+
Currently unavailable in the app version provided, this table is under development. It will showcase the effects added to the current image, allowing users to create cumulative outputs if desired. Users can manipulate the table to show or hide all effects, revert to the original imported image, or remove specific effects. Furthermore, they can adjust the order of applied effects in the cumulative pipeline by dragging rows. Double-clicking on an effect will open a new tab exclusively visualizing the output of that effect, including any intermediate steps typically hidden from users.
You can import an image in three ways: drag and drop, through the file menu, or by accessing the included image library within the app.
215
+
216
+
3.**Applying Effects**:
217
+
218
+
Simply **double-click** on the desired effect from the left sidebar. You can expand the sidebar to view the full names of each effect or hover over them to see a tooltip displaying their names.
219
+
220
+
3.**Fine-Tuning Effects**:
221
+
222
+
In the right-side panel, double-click on the effect's name from the tree. This will open a menu displaying all the parameters and controls. Adjust these to achieve the desired result.
223
+
224
+
5.**Navigating Images**:
225
+
226
+
Easily switch between different images by double-clicking their names in the image tree located in the right-side menu.
227
+
228
+
5.**Saving Output**:
229
+
230
+
To save the output image, simply press CTRL+S or access the save option from the File menu in the menu bar.
| Ctrl+S | Save the output image of the current image as PNG |
240
+
| Shift+Ctrl+S | Save the output image of the current image and specify the extension |
241
+
| Alt+S | Save all the output images of the opened images |
242
+
| Ctrl+Q | Exit the app |
243
+
| Ctrl+C | Show a guide on how to use the app (Currently unavailable) |
244
+
| Ctrl+H | Open the documentation of the app (Currently unavailable) |
245
+
246
+
</div>
247
+
191
248
## Future Updates
192
249
In upcoming releases, we are planning to introduce a significant enhancement to our application by implementing cumulative effects output. This feature will revolutionize the image processing workflow by seamlessly integrating multiple effects. Specifically, the output generated by the first applied effect will serve as the input for subsequent effects. Also, we are working now on enhancing the app's performance to suit Computationally weak devices. All that besides, new processing techniques are coming soon.
0 commit comments