MyBox: Easy Tools Set

User Guide - Overview

Author: Mara

Version: 6.5.9

Date: 2022-8-31

1 Introduction

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

1.1 What's New

2022-8-31 v6.5.9

• Data. Simple Linear Regression – Combination. Multiple Linear Regression. Group by Equal Values. Sort By multiple columns. Save example data in suitable types. Data name can be set when create data. New options for Set Values. Options for invalid numbers.

• Codes. Seperate operations logic from data read/write.

• Documentation. ReadMe does not include mentions of tools. Update user guides for tools.

• Solved. Endless errors popped and user has to reboot computer when close window while “Play Images” is running(!! Sorry). Statistic for integer/long may fail. Some operations may fail when row filter includes statistic name. Offset one column when edit results of Simple Linear Regression. No results in Box-and-whisker chart when calculate by rows for all pages. File/Path should be null instead of saved value when input is empty. Auto-backup of files may be cancelled by itself.

Closed requirements/bugs in this version

1.2 Cross Platforms

MyBox is implemented in pure Java and only based on open sources, and it can run on platforms which support Java 18.
Versions before v5.3 are based on Java 8.

1.3 Personal

1. No register/login/DataCenter/Cloud.

2. No network if unnecessary.

3. Not read/write if unnecessary.

1.4 Data Compatible

4. Exported data are in common text formats, like txt/csv/xml/json/html.

5. Imported data are in common text format, like txt/csv。

6. At least one exported format can be imported.

7. Imported data are self-contain, that original data can be rebuilt without extra data.

1.5 Internationalized

1. All codes of MyBox are internationalized. Language can be switched in time.

2. Each langauge is defined in two resource files, like: "Messages_NAME.properties" and "TableMessages_NAME.properties"。

3. Support adding new languages online. Table is provided with English as comparison. New langauges take effects at once.
   Example, the new language is named as “aa”, and its resource files are Messages_aa.properties and TableMessages_aa.properties.

4. Translated languages can be shared with others: Put the files under "mybox_languages" of data path and MyBox is aware of them immediately.

5. Embed Chinese and English, whose files are under path MyBox/src/main/resources/bundles/.

Language	Resource file of interface	Resource file of data tables
Chinese	Messages_zh_CN.properties	TableMessages_zh_CN.properties
English	Messages_en.properties	TableMessages_en.properties

2 Resources Addresses

3 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

4 Download and Execution

Packages of each version have been uploaded at Releases directory now. You can find them by clicking releases tab in main page of this project.

4.1 Source Codes

MyBox-6.5.9-src.zip 52M-

About structure, editing, and building of source codes, please refer to Developement Guide and Packing Steps

4.2 Self-contain packages

Self-contain packages include all files and need not java env nor installation.

Platform	Link	Size	Launcher
win10 x64	MyBox-6.5.9-win10-x64.zip	220MB-	MyBox.exe
CentOS 7 x64	MyBox-6.5.9-CentOS7-x64.tar.gz	240MB-	bin/MyBox
mac	MyBox-6.5.9-mac.dmg	240MB-	MyBox-6.5.8.app

User can double click the launcher to start MyBox or run it by command line. The default “Open Method” of image/text/PDF files can be associated to MyBox and a file can be opened directly by MyBox by double clicking the file’s name.

4.3 Jar

When JRE or JDK(Oracle jdk or open jdk) is installed, jar can run:

Platform	Link	Size	Requirements
win	MyBox-6.5.9-win-jar.zip	160MB-	Java 18 or higher
linux	MyBox-6.5.9-linux-jar.zip	180MB-	Java 18 or higher
mac	MyBox-6.5.9-mac-jar.zip	170MB-	Java 18 or higher

Run following command to launch this program with Jar package:

     java   -jar   MyBox-6.5.8.jar

A file path can follow the command as argument to be opened directly by MyBox. Example, following command will open the image:

     java   -jar   MyBox-6.5.8.jar   /tmp/a1.jpg

4.4 Other addresses to download

Download from cloud storage: https://pan.baidu.com/s/1fWMRzym_jh075OCX0D8y8A#list/path=%2F
Download from sourceforge: https://sourceforge.net/projects/mara-mybox/files/

4.5 Limitation

• MyBox windows may often be blocked when some Input Method is running. Workaround is to disable/uninstall this Input Method.

4.6 Migration

1. Each version has itself’s configuration file. New version can copy parameters from existed versions.

2. Data handled in each version are under “Data Directory” referred by it. Multiple versions can refer to same data directory.

3. MyBox is backward compatibility: Later version can work on data of previous versions. While forward compatibility is not supported: Wrong may happen when old version handles data of new version.

4.7 Configuration

Configuration file is under “User Home”:

Add parameter “config="FilePath"” when run jar to change configuration file temporarily.
Function “Settings” can be used to change configuration values.

5 Implementation

MyBox is based on following open sources:

6 Common Functions in Interfaces

6.1 Main Interface

Main interface is shown after MyBox is launched. Move mouse over one icon to pop its menu. Then select a tool to start.

6.2 Interface Layout

1. Window title includes the object name being handled.

2. Main menu in top to open windows of functions.

3. Some interfaces include pagination toolbar which is generally in bottom.

4. Some interface include icon Fish. Hover mouse upon it to pop tips.

5. Some interfaces include left pane or right pane. If icon Rosefinch is there, hover mouse upon it to hide/show the pane.

6. To some buttons, checkbox, or icon, shortcut or tips will be popped when hover mouse upon them.

6.3 Set Font Size

1. Decrease font size by press key “CTRL” and key “-” at same time.

2. Increase font size by press key “CTRL” and key “=” at same time.

3. Select one font size of 12px, 15px, and17px by click menu item directly.

4. Set font size in Setting window.

6.4 Open New Stage

To open new window for new scene and keep current scene in current window, do not select menu item “Settings”-“Close current window when open new tool”.

6.5
Restore Scene Size

By selecting menu item “Settings”-“Record size and location of windows”, recent size and location of each stage will be saved and restored when it is opened again.

6.6 Recent Visited Files/Directories

When menu item “Settings”-“Pop recent visited files/directories” is selected, each access of files/directories will be record and list will be popped when mouse is moved upon the button of selection. Example:

6.7 Data Table

1. To select rows:

• Press key SHIFT and click rows to select multiple rows of a range.

• Press key CTRL and click rows to select multiple rows one by one.

• Click the checkboxs in head of rows.

2. To edit data:

• Header texts of editable columns are in blue (Editable primary keys are still in red).

• Click the editable cell, then its input field will be shown.

• When editable cell loses focus, its value will be checked and invalid data will be rejected.

3. To display/hide columns, click button "+" in right side of table header.

This operation does not affect data.

4. To adjust order of columns, click and drag column headers.

This operation does not affect data.

5. - To order rows:

• Click column header for ascending order by this column.

• Click column header again for descending order by this column.

• Click column header for thrid time to cancel ordering of this column.

• Press SHIFT and click more column headers to order by multiple columns.

This operation only affect current data in table.

6. Header texts of primary keys are in red and auto-increated keys are in orange.

6.8 Context Menu

1. This menu is popped when right click object like text, image, or table.

2. If interface includes button “Cloud”, context menu will be popped when click this button.

3. If interface includes checkbox “Cloud”:

• If this checkbox is not selected, the context menu is not popped when right click object.

• If this checkbox is selected, the context menu is popped when right click object.

• Checkbox “Cloud” does not affect button “Cloud”, which means context menu is always popped when click button “Cloud”.

6.9 Window “Examples”

Window “Examples” is popped when hover or click button “Examples”.

6.10 Window “Histories”

Hover or click button “Histories” to pop window “Histories”.

6.11 Color Block and Palette

1. Hover “Color Block” to pop color's information.

2. Hover or click button “Palette” to pop window Palette, and select or edit colors.

7 Settings

Select “Settings...”in main menu to open window Settings.

7.1 Interface

• Language, font size, icon size

• Control color, whether display control text, interface style

• Select hi-dpi icons(100x100) or common icons(40x40).

When screen resolution is not high than 120dpi, suggest to use common icons.

Hi-dpi icons may look blurred on low-resolution screen.

• Whether restore last size of each scene.

• Whether open new stage to display scene.

• Whether show/Hide splitted panes when mouse passing.

• Whether pop stage "Set Color" when mouse passing.

• Font size, color, duration of popped messages.

7.2 Base

1. Maximum memory usage of JVM

2. Network timeouts

7.3 Data

1. Data path

2. Derby driver mode

3. Whether pop recent visited files/directories. And the number.

4. Whether close alarm clocks when exit program.

7.4 PDF

Maximum main memory of PDF handling.

7.5 Image

1. Width and color of stroke and anchor. Whether anchors are solid.

2. Color to replace Alpha when Alpha is not supported. (Suggest as White)

3. Wdith of thumbnail

4. Maximum width to display sampled images

7.6 Map

Data keys of map

8 Window

1. Refresh/Reset/Full-screen/Top windows.

2. Close other windows.

3. Reboot MyBox.

4. Recent visited tools.

5. Snapshot of window/pane.

9 Shortcuts

Controls in interfaces, like buttons, checkboxs, images, may have their shortcuts:

1. When focus is in "Text Input" control, following keys work for this control:

Delete/Home/End/PageUp/PageDown/Enter/Ctrl-c/v/z/y/x

Or else shortcuts work for the interface.

2. When focus is not in "Text Input" control, Ctrl/Alt of combination keys can be omitted.

Example, if an image is currently foused, press "c" to copy and press "2" to set as pane size.

3. Move mouse upon control, its tooltip(if has) including shortcut may be popped.

<End of Document>