MyBox: Easy Tools Set

User Guide – Image Tools

Author: Mara

Version: 6.5.9

Date: 2022-8-31

Contents

1 Introduction	4

1.1 Main Interface	4

1.2 Resources Addresses	5

1.3 Documents	6

1.4 Menu of Tools	6

2 View Image	7

3 Browse Images	8

4 Analyse Image	9

5 Play Images	11

6 Image Manufacture	12

6.1 Copy	13

6.2 Crop	14

6.3 Clipboard	15

6.4 Scale	16

6.5 Margins	17

6.6 Color	18

6.7 Effect	19

6.8 Enhancement	20

6.9 Text	21

6.10 Pen	23

6.11 Transform	24

6.12 Round corner	25

6.13 Shadow	26

6.14 Editing Histories	27

6.15 Scope	28

6.16 Pop current image	29

6.17 "Visible As Need"	29

6.18 Demo	29

7 Image Manufacture in batch	30

8 Edit Images	31

9 Splice images	32

10 Add Alpha channel	33

11 Split image	34

12 Subsample image	35

13 Extract Alpha channel	36

14 Image Conversion	37

15 Recognize Texts in Image	38

16 Color Management	40

16.1 Manage color palettes:	40

16.2 Add colors	41

16.3 Query color	42

17 Color Space	43

17.1 Draw Chromaticity Diagram	43

17.2 Edit ICC profile	44

17.3 RGB Color Space:	45

17.4 Transform Matrices between Linear RGB and XYZ	45

17.5 Transform Matrices between Linear RGB and Linear RGB:	45

17.6 Illuminants	45

17.7 Chromatic Adaptation Matrices	45

18 Images in System Clipboard	46

18.1 Options	46

18.2 Conditions to Stop	47

18.3 Sources of Images in System Clipborad	47

19 Images in MyBox Clipboard	48

20 Pixels calculator	49

21 Convolution Kernels Manager	50

22 Convert image to base64	51

23 Big Image	52

Introduction

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

Main Interface

Resources Addresses

Contents	Link
Project Main Page	https://github.com/Mararsh/MyBox/
Source Codes and Compiled Packages	https://github.com/Mararsh/MyBox/releases
Submit Software Requirements and Problem Reports	https://github.com/Mararsh/MyBox/issues
Data	https://github.com/Mararsh/MyBox_data
Documents	https://github.com/Mararsh/MyBox_documents
Mirror Site	https://sourceforge.net/projects/mara-mybox/files/
Cloud Storage	https://pan.baidu.com/s/1fWMRzym_jh075OCX0D8y8A#list/path=%2F

Documents

Name	Version	Time	English	Chinese
Development Logs	6.5.9	2022-8-31	html	html
Shortcuts	6.5.6	2022-6-11	html	html
Packing Steps	6.3.3	2020-9-27	html	html
Development Guide	2.1	2020-8-27	PDF	PDF
User Guide - Overview	6.5.9	2022-8-31	html PDF odt	html PDF odt
User Guide – Document Tools	6.5.9	2022-8-31	html PDF odt	html PDF odt
User Guide - Image Tools	6.5.9	2022-8-31	html PDF odt	html PDF odt
User Guide - File Tools	6.5.9	2022-8-31	html PDF odt	html PDF odt
User Guide - Network Tools	6.5.9	2022-8-31	html PDF odt	html PDF odt
User Guide - Data Tools	6.5.9	2022-8-31	html PDF odt	html PDF odt
User Guide - Media Tools	6.5.9	2022-8-31	html PDF odt	html PDF odt
User Guide - Development Tools	6.5.9	2022-8-31	html PDF odt	html PDF odt

Menu of Tools

View Image

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

"Select Mode".

Rotation can be saved.

Recover, Rename, Delete.

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

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

Navigation of images under same directory.

Context menu.

Option about whether handle selected area or whole image.

Redering parameters when save or modify image.

Browse Images

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

Rotation can be saved.

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

Thumbnails List Mode.

Files List Mode.

Rename and Delete.

Analyse Image

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

Channels of histograms can be selected.

Statistic against selected area.

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.

Image data can be saved as html file.

Play Images

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.

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.

Images are displayed frame by frame:

Set intervals and speed times

Pause/Continue

Select a frame

Previous/Next frame

Options "Loop" and "Reverse"

Image Manufacture

Copy

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

Whether cut margins, whether copy to system clipboard.

Set background color.

Crop

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

Whether cut margins, whether copy to system clipboard.

Set background color.

Clipboard

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

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

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.

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

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

Scale

By dargging anchors

By setting scale

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

Margins

Blur margins with option of whether apply Premultiplied Alpha

Drag anchors to adjust margins

Add margins by width

Cut margins by width.

Cut margins by color.

Color

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

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

Scope.

Premultiplied Alpha is supported for setting opacity.

Effect

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

Algorithms and parameters can be set.

Scope.

Enhancement

Contrast, smooth, sharpen, convolution.

Algorithms and parameters can be set.

Text

Input texts in multiple lines.

Set location.

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

Outline, veritical, right-to-left.

Borders.

Pen

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

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

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

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

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

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

Transform

Shear, mirror, and rotate.

Round corner

Arc and background color can be set.

Shadow

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

Editing Histories

Each modification will be recorded as image histories.

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

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

Scope

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

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

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

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

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

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

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

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

Pop current image

Option: Whether always on top.

"Visible As Need"

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

Vertical accordion menus

Overlaying tabs to switch

Show/Hide controls as functions

Demo

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

Image Manufacture in batch

Edit Images

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.

Move images to set their orders.

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

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

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).

Splice images

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

Add Alpha channel

Split image

By number, by size, or by customizing.

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

Subsample image

Options like sample region and sample ratio.

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.

Extract Alpha channel

Image Conversion

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

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

Color space based on external ICC profile.

Option to embed ICC profile.

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

Options of compression types and quality.

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

Conversion in batch.

Recognize Texts in Image

Preprocess image:

Algorithms of image maunfacture

Scale ratio

Binary threshold

Rotation angle

whether deskew automatically

Whether invert colors

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

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.

When recognize in batch, options:

Whether generate html or PDF

Whether merge recognized texts

OCR engine:

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

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

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.

Color Management

Manage color palettes:

Add/Delete/Rename/Copy.

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

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

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.

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.

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

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

Add colors

Get colors from color-picker.

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)

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

Query color

Web Colors

Color Space

Draw Chromaticity Diagram

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.

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

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.

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

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

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.

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.

Edit ICC profile

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.

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

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

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

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

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

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

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

RGB Color Space:

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.

Decimal scale can be set.

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

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.

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

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

Transform Matrices between Linear RGB and XYZ

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.

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.

Transform Matrices between Linear RGB and Linear RGB:

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..

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

Illuminants

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..

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

Chromatic Adaptation Matrices

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

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

Images in System Clipboard

Options

Load/Refresh/Delete image in System Clipboard:

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

Monitor interval can be set.

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

Width of saved image can be set.

Options of files.

Options of images.

Conditions to Stop

The monitoring stops when one of following happens：

User clicks button "Stop"

MyBox exits.

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

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.

Images in MyBox Clipboard

Add/Delete/View images in MyBox Clipboard.

Examples are provided.

Image in System Clipboard can be added.

Selected image can be copyed in System Clipboard.

Pixels calculator

Convolution Kernels Manager

Convert image to base64

Big Image

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

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.

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

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

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

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>