MyBox: Easy Tools Set

User Guide – Image Tools

Author: Mara

Version: 6.7.1

Date: 2023-3-13

1 Introduction

This is desktop application based on JavaFx to provide simple and easy functions. It's free and open sources.

1.1 Main Interface

1.2 Resources Addresses

1.3 Documents

1.4 Menu of Tools

2 View Image

1. "Load Width". Read image file with "Original Size" or with defined width.

2. "Select Mode".

3. Rotation can be saved.

4. Recover, Rename, Delete.

5. Select whether display Corodinate, X/Y Rulers, Data.

6. Image attributes and image meta. ICC profile embedded in image can be decoded.

7. Navigation of images under same directory.

8. Context menu.

9. Option about whether handle selected area or whole image.

10. Redering parameters when save or modify image.

3 Browse Images

1. Display multiple images in same screen. Rotation and zoomming can be separated or synchronized.

2. Rotation can be saved.

3. Grid Mode. Files number, columns number, and load width can be set.

4. Thumbnails List Mode.

5. Files List Mode.

6. Rename and Delete.

4 Analyse Image

1. Statistic and visualization of image data, including average, variance, skewness, median, mode, minimum, maximum of occurance of each color channel, and their histograms.

2. Channels of histograms can be selected.

3. Statistic against selected area.

4. Count dominant colors:

• Calculate mostly different colors in image by K-Means Clustering.

• Calculate mostly occurred colors in image by Popularity Quantization.

• Results can be imported in Color Palette.

5. Image data can be saved as html file.

5 Play Images

1. Following types of files can be played:

• Dynamical gif file

• Multiple-frames tif file

• PDF file

• PPT file

Each page of PPT/PDF file is converted as an image to display.

2. In this version, all required images are loaded in memory.

To avoid out of memory:

• Set frames range to display.

• Set width of images to load.

• Set dpi for images in PDF.

3. Images are displayed frame by frame:

• Set intervals and speed times

• Pause/Continue

• Select a frame

• Previous/Next frame

• Options "Loop" and "Reverse"

6 Image Manufacture

6.1 Copy

1. Copy part inside current scope, part outside of current scope, or whole image.

2. Whether cut margins, whether copy to system clipboard.

3. Set background color.

6.2 Crop

1. Crop part inside current scope, or part outside of current scope.

2. Whether cut margins, whether copy to system clipboard.

3. Set background color.

6.3 Clipboard

1. Clip sources:

• "Copy"(CTRL+c) against whole image or selected part of image

• Cutted part of image

• System clipboard

• Image files in system

• Example clips

2. Manage clips list: Add, Delete, Clear, Set maximum number of list.

3. Click button "Paste"(CTRL+v) anytime while editing image, to paste the first image in clipboard onto current edited image. Or double click item in the clipboard to paste it.

4. Drag and move pasted clip on current edited image, to adjust clip's size and location.

5. Options to paste: whether clip on top, whether keep aspect ratio, blending mode, opacity, rotation angle.

6.4 Scale

1. By dargging anchors

2. By setting scale

3. By inputting pixel values with 4 types of keeping aspect ratio.

6.5 Margins

1. Blur margins with option of whether apply Premultiplied Alpha

2. Drag anchors to adjust margins

3. Add margins by width

4. Cut margins by width.

5. Cut margins by color.

6.6 Color

1. Object: Red/Green/Blue/Yellow/Cyan/Magenta channel, saturaion, brightness, hue, RGB itself, or opacity.

2. Operations: Increase, decrease, set, filter, or invert.

3. Scope.

4. Premultiplied Alpha is supported for setting opacity.

6.7 Effect

1. Posterize(reduce colors), thresholding, gray, black-white, Sepia, emboss, edges detect.

2. Algorithms and parameters can be set.

3. Scope.

6.8 Enhancement

1. Contrast, smooth, sharpen, convolution.

2. Algorithms and parameters can be set.

6.9 Text

1. Input texts in multiple lines.

2. Set location.

3. Style: like font family, style, size, color, blend modes, shadow, angle.

4. Outline, veritical, right-to-left.

5. Borders.

6.10 Pen

1. Polyline: One line by multiple drawing. Options: stroke width, color, whether dotted, blend modes.

2. Lines: One line by one drawing. Options: stroke width, color, whether dotted, blend modes.

3. Eraser: One line by one drawing. Always transparent. Option: stroke width.

4. Frosted Class: One dot by one drawing. Options: stroke width, intensity, shape(Rectangle or circle).

5. Mosaic: One dot by one drwaing. Options: stroke width, intensity, shape(Rectangle or circle).

6. Shape: Rectangle, Circle, Ellipse, Polygon. Options: stroke width, color, whether dotted, blend modes, whether fill-in, color of fill-in.

6.11 Transform

Shear, mirror, and rotate.

6.12 Round corner

Arc and background color can be set.

6.13 Shadow

Options: background color, shadow size, whether apply Premultiplied Alpha.

6.14 Editing Histories

1. Each modification will be recorded as image histories.

2. Manage histories: Delete, Clear, Recover selected history as current editing image, Set maximum number of histories.

3. Undo(CTRL+z) and redo(CTRL+y) previous modification. Recover to original image(CTRL+r) at any time. Either select one history to recover.

6.15 Scope

1. Rulers to limit pixels to operate, including area rulers, color matching rulers, or rulers mixed by both types.

2. Define area: Rectangle, Circle, Ellipse, Polygon. Can be excluded.

3. Define colors list. Can pick colors directly from image by Color Palette.

4. Select object for color matching, including Red/Green/Blue channel, saturaion, brightness, hue, RGB, with distance defined. Can be excluded.

5. Matting: Match pixels around current pixel, and spread results with same matching rulers. Result is the collection of pixels matched by multiple points.

6. Outline: Extract outline of image which has transparent background, as the scope of operation.

7. Scope can be applied against Copy, Crop, Color, Effect, Convolution.

8. Scopes can be saved with names. User can manage them: Add, Delete, Clear, Edit, Use selected item in scopes list.

6.16 Pop current image

Option: Whether always on top.

6.17 "Visible As Need"

1. Show/Hide left pane(F4), show/hide right pane(F5)

2. Vertical accordion menus

3. Overlaying tabs to switch

4. Show/Hide controls as functions

6.18 Demo

One clicking to diaplay examples of kinds of image manufacture about "Color", "Effect", "Enhancement", and blend modes.

7 Image Manufacture in batch

8 Edit Images

1. Add following：

• Animated gif file. All frames are added into list.

• Multiple-frames tif file. All frames are added into list.

• PDF file. All pages are converted as images and added into list.

• PPT file. All pages are converted as images and added into list.

• Image in system clipboard.

• Any supported image files.

2. Move images to set their orders.

3. Set durations of images, which work for playing list and animated gif file.

4. Play the list. Select some images by CTRL/SELECT to play, or select none to play whole list.

5. Save the list:：

• Select some images by CTRL/SELECT to save, or select none to save whole list.

• Save each item as a supported image file.

• Splice images.

• Merge items as a multipleg-frames tif file.

• Merge items as an animated gif file.

• Merge items as a PDF file.

• Merge items as a PPT file.

• Merge items as a video file(need ffmpeg).

9 Splice images

Options like array ordering, background color, interval, margins, and size.

10 Add Alpha channel

11 Repeat/Tile Image

This tool helps to make background/texture image:

1. Select an image, and set part or whole of it as source cell.

2. Set width and height to scale the source cell.

3. Make the target image:

• Repeat the cell with horizontal number and vertical number.

• Tile the cell into width and height of canvas.

• Set interval between cells. Negative value may make effect of interleave.

• Set margins of target image.

12 Split image

1. By number, by size, or by customizing.

2. Results can be saved as image files, multiple frames Tiff file, or PDF file.

13 Subsample image

1. Options like sample region and sample ratio.

2. When image file includes too many pixels and loaded as sampled image, splitting and subsampling handle the original image in file instead of the loaded image in memory.

14 Extract Alpha channel

15 Image Conversion

1. Formats of image file: png, jpg, bmp, tif, gif, ico, wbmp, pnm, pcx, raw.

2. Color spaces: sRGB, Linear sRGB, ECI RGB, Adobe RGB, Apple RGB, Color Match RGB, ECI CMYK, Adobe CMYK(several), Gray, Binary

3. Color space based on external ICC profile.

4. Option to embed ICC profile.

5. Options to handle transparent channel, including keep, delete, premultiply and delete, premultiply and keep.

6. Options of compression types and quality.

7. For binary, algorithms can be choiced: OTSU, default or threshold. And option of dithering.

8. Conversion in batch.

16 Recognize Texts in Image

1. Preprocess image:

• Algorithms of image maunfacture

• Scale ratio

• Binary threshold

• Rotation angle

• whether deskew automatically

• Whether invert colors

2. Recognization Options:

• Languages list and their order

• whether generate data of "Regions" and level can be set

• whether generate data of "Words" and level can be set

3. When recognize single image:

• Preprocessed image can be saved and loaded

• Rectangle can be set to define the area to do OCR.

• Display preprocessed image, original image, recognized texts and html.

• Display data of Regions and Words in html which can be saved.

• Demo: One clicking to show examples of image enhancement.

4. When recognize in batch, options:

• Whether generate html or PDF

• Whether merge recognized texts

5. OCR engine:

• For win, both embedded and installed tesseract can be selected.

• For linux and mac, only installed tesseract can be used.

6. OCR data files path:

• Can be set as any path which can be read. If tesseract is installed, suggest to set as its subdirectory "tessdata".

• MyBox includes "fast" data files of English and Chinese, and will copy them to this path if it has not them.

• Notice: When use embedded engine, it is better that name of file/path is pure English to avoid failure.

17 Color Management

17.1 Manage color palettes:

1. Add/Delete/Rename/Copy.

2. Examples: "Common web color", "Traditional Chinese colors", "Traditional Japanese Colors", and "Colors from colorhexa.com".

3. Manage colors in palettes: Add/delete/Copy/Name/Order/Import/Export.

4. Display colors:

• Data in table in simple/all columns. Or display colors in merged/separated columns.

• Color is shown in a small rectangle. Its name(if has), hexidecimal value, rgb values, opacity, cmyk values, and cie values are popped when mouse is moved upon it.

5. Change colors:

• Color name can be empty and duplicated. Same color can have different names in different palettes.

• Color order can be any float. Same color can have order numbers in different palettes.

• Click button to trim order numbers in step 1.

• Drag-drop colors to adjust their orders in palette.

6. Export colors: current page, all, or selected rows as html or csv file.

7. Import color file in CSV format:

• File encoding is UTF-8 or ASCII.

• The first line defines data headers which are delimited by English commas.

• Followed each line defines one data row. Data fields are delimited by English commas.

• Following fields are necessary: rgba or rgb

• Following fields are optional: name

17.2 Add colors

1. Get colors from color-picker.

2. Input colors list. Examples are provided. Valid color values are like:

orange

0xff668840

0xff6688

#ff6688

#f68

rgb(255,102,136)

rgb(100%,50%,50%)

rgba(255,102,136,0.25)

rgba(255,50%,50%,0.25)

hsl(240,100%,100%)

hsla(120,0%,0%,0.25)

3. Click button "Pick Color" in intefaces of image viewer/manufactor.

17.3 Query color

Web Colors

18 Color Space

18.1 Draw Chromaticity Diagram

1. Outlines of standard data, including CIE 1931 2 Degree Observer(D50), CIE 1964 10 Degree Observer(D50), CIE RGB Gamut, ECI RGB Gamut, sRGB Gamut, Adobe RGB Gamut, Apple RGB Gamut, PAL RGB Gamut, NTSC RGB Gamut, ColorMath ProPhoto RGB Gamut, SMPTE-C RGB Gamut.

2. Standard illuminants(White points), including A, C, D50, D55, D65, E.

3. User can fill in tristimulus values or color coordinate or select color, and the tool will calculate values in kinds of color space and display the calculated color in the chromaticity diagram.

4. User can input or import spectral data, and the tool will filter special characters and display the spectral values in the chromaticity diagram.

5. User can select to show or hide the items of above data in the chromaticity diagram.

6. User can select the background color of the chromaticity diagram as transparent, white, or black. Dot size or line size can be selected for outlines. Grid and wave values can be selected to show or hide too.

7. Table and texts are shown for standard data, including CIE 1931 2 Degree Observer 1nm, CIE 1931 2 Degree Observer 5nm, CIE 1964 10 Degree Observer 1nm, CIE 1964 10 Degree Observer 5nm. Data texts can be exported.

18.2 Edit ICC profile

1. Predefined standard ICC profiles, including Java Embeded ICC like sRGB/XYZ/PYCC/GRAY/LINEAR_RGB, files from ECI like ECI_CMYK/ECI_RGB_v2, and files from Adobe like Adobe_RGB/Apple_RGB/CMYK.

2. All fields in header can be edited. "Profile id" is calculated as MD5 digest automatically when ICC profile is saved.

3. Tags table shows fields of tag, name, type, offset, size, description, decoded data, and raw data of bytes in hexadeciaml.

4. Editable tag types include: Text, MultiLocalizedUnicode, Signature, DateTime, XYZ, Curve, ViewingConditions, Measurement, S15Fixed16Array.

Tag type "LUT" is not editable in this version.

5. Option "Normalize data of LUT in range of 0~1".

6. Whole ICC profile is read as XML and can be exported. Data not decodes are shown as bytes in hexadeciaml.

7. Loaded ICC data can be modified and saved as new ICC profile.

18.3 RGB Color Space:

1. User select or input RGB color space(Primaries and white), select or input reference white, and the tool will calculate the adapted primaries values automatically and show the calculation procedure.

2. Decimal scale can be set.

3. Adaption algorithm can be selected from Bradford, XYZ Scaling, and Von Kries.

4. Predefined standard RGB color spaces include CIE RGB, ECI RGB, sRGB, Adobe RGB, Apple RGB, PAL RGB, NTSC RGB, ColorMath ProPhoto RGB, SMPTE-C RGB.

5. Predefined illuminants include A, B, C, D50, D55, D65, D75, E, F1~F12 of CIE 1931 and CIE 1964.

6. Table and texts are shown for adapted primaries by different RGB color spaces, different illuminants, and different algorithms. Data texts can be exported.

18.4 Transform Matrices between Linear RGB and XYZ

1. User select or input RGB color space(Primaries and white), select or input reference white of XYZ color space, and the tool will calculate the transform matrix between the linear RGB and XYZ automatically and show the calculation procedure.

2. Table and texts are shown for transform matrices by different RGB color spaces, different reference whites of XYZ, and different algorithms. Data texts can be exported.

18.5 Transform Matrices between Linear RGB and Linear RGB:

1. User select or input source and target RGB color spaces(Primaries and white), and the tool will calculate the transform matrix between the 2 linear RGB color spaces automatically and show the calculation procedure..

2. Table and texts are shown for transform matrices by different RGB color spaces and different algorithms. Data texts can be exported.

18.6 Illuminants

1. User input source color(relative/tristimulus/coordinate), select or input source white and target white, and the tool will calculate the adapted color automatically and show the calculation procedure..

2. Table and texts are shown for standard illuminants list including color values, color temperature, and description. Data texts can be exported.

18.7 Chromatic Adaptation Matrices

1. User select or input source white and target white, and the tool will calculate the chromatic adaptation matrix automatically and show the calculation procedure..

2. Table and texts are shown for chromatic adaptation matrices by different standard illuminants and different algorithms. Data texts can be exported.

19 Images in System Clipboard

19.1 Options

Load/Refresh/Delete image in System Clipboard:

1. After button is clicked, new images in System Clipboard are monitored.

2. Monitor interval can be set.

3. Monitored images can be saved as files, or copyed in Mybox Clipboard.

4. Width of saved image can be set.

5. Options of files.

6. Options of images.

19.2 Conditions to Stop

The monitoring stops when one of following happens：

1. User clicks button "Stop"

2. MyBox exits.

3. All of following are satisfied:

• "Copy to MyBox Clipboard" is not checked

• "Save as Files" is not checked or target path is invalid

• This interface is closed

19.3 Sources of Images in System Clipborad

Images in system clipboard come from screenshots or pictures generated by softwares like operation "CTRL+c".

On Windows, shortcuts to make screenshots:

"PrintScreen" Make snapshot of full screen.

"Alt+PrintScreen" Make snapshot of current active window.

On Linux, shortcuts to make screenshots:

"Ctrl+PrintScreen" Make snapshot of full screen.

"Ctrl+Alt+PrintScreen" Make snapshot of current active window.

"Shift+Ctrl+PrintScreen" Make snapshot of selected area.

On Mac, shortcuts to make screenshots:

"Command+Control+Shift+3" Make snapshot of full screen.

"Command+Control+Shift+4" Make snapshot of selected area.

"Command+Control+Shift+4+Spacebar" Make snapshot of current active window.

20 Images in MyBox Clipboard

1. Add/Delete/View images in MyBox Clipboard.

2. Examples are provided.

3. Image in System Clipboard can be added.

4. Selected image can be copyed in System Clipboard.

21 Pixels calculator

22 Convolution Kernels Manager

23 Convert image to base64

24 Big Image

1. Evaulate the required memory for whole image, and judge whether load all data in memory.

2. If enough memory is available to load whole image, read all data for next operations. Try best to operate in memory and avoid file I/O.

3. If memory may be out, subsample the image for next operations.

4. The sample ratio is determined by following rule: Make sure the sampled image is good enough while the sampled data occupy limited memory.

5. The sampled image is mainly for displaying, and not suitable for operations against whole image and images merging.

6. Some operations, like splitting and subsampling, can be handled by reading part of image data and writing-while-reading, so they are suitable for big images. Sampled image is displayed while original image is handled.

<End of Document>