Delice – Learn How to Use

Delice allows you to keep your image references in centralized location. Once you added the image to the app you should not worry about the subdirectory where it is kept. All you need to to do is to assign a tags to that image and use the search feature to acquire the image.

Decide where images will be kept

One of the most crucial aspect of the app is the first time configuration. This is a one time decision where to put your images. Under hood, Delice uses the root directory in your file system to keep all images in one place and also store the database to keep track of all the images, tags and other metadata if needed.

To start using you should configure this path at the start. It is recommended to set the path the location that is outside the system directory.

Use menu Settings – Configure. Click Change button to set your Database Root. Restart the app. You need to restart the application only when changing the database root. All other settings are applied immediately.

Neat property of the way Delice stores the data is that you can now setup any backup system on top of this directory and all your references will be safe. In order to recover Delice back to your root directory all you need is to recover the backup and set the path to unzipped directory.

Main Window

The main window is the place where you navigate through your image refences. The window is split into four areas. The area marked by number on contains all the widgets related to search. The area marked by number two is for displaying Tag List. The area marked by number three is for previewing all the images returned by search. The area marked by number 4 is to navigate images if the search is large enough.

Search

The search bar is used for search images by tags. The search is relatively simple. Just list all the tags you are interested in by coma and all relevant images will be displayed.

If you leave the search bar empty then by clicking Search button all the images that have no tags will be displayed.

By setting asterisk ‘*’ as a search criteria, all images will be displayed.

To search by tag just enter the tag name. Keep in mind that tag name should match exactly as you specified it when tagging the image in order to get the results. You also can list the tags by comma, then all the images that have either of the tag will be displayed in the search result.

There are multiple buttons on the search bar. The button with the “X” sign will clear the search box and activate search for you. This equivalent to search the images without tags.

Three other buttons are tied to search bar, meaning whatever is entered into search bar will control the windows activated by each button. The button Search will activate the search. The button Board will trigger Mood Board generation. The Practice button will activate the Deliberate Practice mode.

Available Tags

The Left side of the main window marked by number two displays the list of all tags that have been used in all of the images in your database so far. A small search bar let’s you look up for some particular tag to clarify whether you have it or not. This is handy when you have hundreds of tags.

Each tag comes with two buttons next to it. The triangle pointing up will add the selected tag to search bar and activate search. The triangle pointing to the right will replace search bar with current tag and activate the search.

The sorting order of the tags can be configured via Settings menu. There are two options for sorting. Rating and Alphabetical. The Rating sorting will place the tag higher up on the list depending on the frequency of the tag used on images. The Alphabetical order will order the tags alphabetically, as the name suggests.

Thumbnails Preview

The Right side of the main window marked by the number three displays small preview of images returned by the search.

Clicking the thumbnail will open Image view window. Right click on the thumbnail will trigger a pop up with context menu. The context menu has the following operations. Copy to clipboard, lets you copy the image to clipboard for further pasting into your image editing software. Tagging, will trigger tagging window for this particular image. Edit, will trigger editing window. Remove, will trigger image removal operation.

Once the application is started the thumbnail preview area will be empty. It is possible to configure that behavior with the Settings menu. There are five options to choose from. Empty, Random, All, Tag and Without Tag.

Empty will leave the area empty. Random will search for all images but display them in random order. All will just search for all the images. Tag lets you specify the specific tag in case you want to see the images of particular set. Without Tag will display the images that have no tags assigned, this is good if you like to give some attention to couple of images on the start.

Add/Remove Images

There are two ways to add images to the database. First, is to add it by navigating the directory by using menu Image – Add from Directory. Notice that this way of adding allows you only select files in the directory but not the directories itself. Second, is to paste the images from clipboard. This way is much better comparing to the first one given that you can select directories and files together, Delice will search directories recursively and add all supported images to the database. To add the images this way use the menu Image – Add from Clipboard.

At this point Delice supports the following image formats: png, jpg, jpeg. To add other formats, please convert the files first.

Once the image added to the app it will get a unique name and placed in internal directory structure (Root Directory specified in the settings). Be aware that the app will not track any duplications while adding images. That means you can add the same images multiple times and they will be all added to the database.

Be advised that renaming, moving or removing files in the Root directory will cause the application work improperly.

To remove the image Right Click on the thumbnail. On the popup window select Remove action. This will trigger Yes/No popup. By clicking Yes, the image will be removed from the database.

Adding Tags to the Image

The tagging system is the core functionality that enables full power of the application. The tags can be assigned as to images as well as to particular regions on the image. We call this regions Regions of Interest (ROI for short). The assigned tags to images or regions then used for Search, Board view and Practice mode.

Image tagging window is accessed by right clicking on the image thumbnail and choosing Tagging option.

The tagging window is separated into two regions. The first region (labeled by number one) is the list of assigned tags. The second region (labeled by number 2) is ROI editor. There are two types of ROIs – the invisible Global region and visible regions created by artist. By default adding the the tags by using input (region labeled by letter A) will assign tags to the entire image. By drawing the rectangle within ROI editor a new ROI will added. The ROI is depicted by orange rectangle (see example in the region F). The corresponding entries will be added to the assigned tag section (area D in our example). By clicking Activate button or clicking on the region the region is switched to “activated” state. It means that by adding tags with the input (area A), the tags will be assigned to this particular region. The active state of the ROI is emphasized by the white color (area E) and the rectangle around the tags list (area C).

Clicking the X button next to the tag will remove the tag from the image or region.

The global invisible region is active when non of the regions is selected or ROI without a number is activated (area B in out example)

The region can be removed by activating it by clicking Activate box or selecting within ROI editor area and calling context menu by right click bout. The button Remove will remove the region. All the tags assigned to the region will also removed from the image.

Modify the Image

For cases when only a part of the image is important or the image is rotated (common for pictures made by mobile phone) you can do a basic editing.

There are two main operations you can do with image. First, rotate the image in any way. The buttons are pretty self explanatory. The second, is the crop.

To crop the image hold left mouse button and drag it over the canvas, it will draw a rectangle. This rectangle is depicting the image that will left after you click the button Crop.

You need to press Save button in order to apply the changes. Little popup on the left bottom of the window will inform you about changes applied.

You also might notice that there is no Undo/Redo buttons. Delice is image referencing software, the image editing capabilities are limited. If you cropped the image to much, just simply close the editor and start over.

Mood Board Window

The purpose of the Mood Board view is to display the set of references in the single window.

Main area of the window is the canvas with the images.

The board view can be regenerated by using Regenerate button. The checkbox Individual ROI controls whether to use ROI or not. In other words if the area of the face in the picture of human was selected and board with tag “face” is generated – only the area of the face will be placed on the board, instead of entire image.

The way it works, Delice will search for the images in the database by given condition. Then it will sample certain amount of images and generate the Board view by given strategy. The number of items put on the canvas is configured by Board Images Count within Configure window. Keep in mind that the higher the number the longer it will take to generate the board. For layouts of images, there are two strategies: Random Flower, Fit Grid.

Random Flower will take images as it is and place them into a circular pattern similar to flower, where the larger images will be placed closer to a center.

Fit Grid strategy will fit all images into a box of the size of HD image and then place these images into a grid. If multiple images can fit into a single HD box, then they will be combined into a single image. The example image above showcases the Fit Grid strategy.

This strategy can be configured in the Board View Layout section of Configure window.

Deliberate Practice

Deliberate Practice window is used for daily training. Enter the name of the tag you want to practice and click Practice button.

The Practice window has two areas. First area is the settings for the practice. You can set the time (in seconds) for single image by setting the number in the input highlighted by area B. Once you click Start button (area C) the counter (area A) will count down to zero. Once the counter reaches zero the next image will be displayed within the area on the right (labeled by number 2). If you want to skip the image just click the Next Image button. Notice that you can use this button to cycle through images without starting the time. Click Stop button (the area C, active only if you started practicing) to stop practicing.

Keep in mind that the maximum number of seconds per image is 90.

Configuration

The configuration window can be invoked by using menu command Settings – Configure.

There are multiple aspect of the application that can be configured.

Database Root. The main place where all the files will be stored.

Board Images Count. The number of images sampled to be displayed on the board view.

All Tags Sorting. The strategy on how the list of all available tags will be displayed on the main window.

Starting Page. Controls what kind of thumbnails will be displayed on the main window.

Board View Layout. The way the images will be aligned on Board View.

Troubleshoot

Delice also comes with the small helper window that helps monitoring what is going on in the application. You can see the history of most of the actions by opening the window Help – Troubleshoot. If something weird going to with the application, please consult to this window. Most of incorrect things will be marked by ERROR prefix.

Should you encounter any errors that should not have happened, please reach us out so that we can fix it.

You can also validate the database for broken records by using menu Help – Database. This is helpful if some error happened when adding images or some of the images were broken on your file system.