2018-12-15-v4 5mybox-userguide-4 5-overview-en_W

1、MyBox User Guide - OverviewMyBox: Easy Tools SetUser Guide - OverviewAuthor: MaraDate: 2018-12-15Page 1 / Total 39MyBox User Guide - OverviewContents 1 Resource Addresses4 2 Documents5 3 Installation and Execution5 4 Development5 5 Current version7 6 Common Functions10 6.1 Main Interface10 6.2 Main

2、Menu Bar10 6.3 Switch Language11 6.4 Open in Interface11 7 Example: Making icon for MyBox with MyBox12 7.1 Crop Image12 7.2 Check colors13 7.3 Save as PNG14 7.4 Filter: Black-White(Binarization)15 7.5 Set Scope16 7.6 Replace color: change background color17 7.7 Change pixels size18 7.8 Make the icon

3、 with texture19 7.9 Apply the new icon20 7.10 Watermark: Write comments on pictures21 8 About Interface Resolution(dpi-aware)22 9 Settings23 9.1 Menu Settings23 9.2 Setting Window24 9.3 Shortcuts25 9.4 Temporary files path25 9.5 Maximum main memory for PDF25 9.6 Updating histories of image25 9.7 Max

4、imum width to display sampled image25 9.8 Interface Styles26 10 Helps30 10.1 Image Meta Data30 10.2 About Java Image I/O Technology31 10.3 About Multiple Frames Image File31 10.4 About Tiff/Tif32 10.5 About Animated Gif32 10.6 About Big Image32 10.7 About Image Sampling33 10.8 How to extend maximum

5、memory of JVM33 10.9 Image Grayscale33 10.10 Color Distance33 10.11 How to get sepia image34Page 2 / Total 39MyBox User Guide - Overview 10.12 Image Blending34 10.13 How to use Java 2D34 10.14 Convolution34 10.15 Flood-Fill34 10.16 About Charset and Encoding34 10.17 How to package execution program3

6、4 11 Development logs35Page 3 / Total 39MyBox User Guide - Overview1 Resource AddressesThis is GUI(Graphic User Interface) program developed in JavaFx, whose target is to provide simple and easy tools . It is free and open sources, and its main page is following:/Mararsh/MyBoxSource

7、 codes, compilered packages, and documents are under Releases directory: /Mararsh/MyBox/releasesWelcome to submit software requirements and problem reports online: /Mararsh/MyBox/issuesCloud storage:/s/1fWMRzym_jh075OCX0D8y8A#list/path=%2FPage 4

8、/ Total 39MyBox User Guide - Overview2DocumentsThis document introduces major features of MyBox. It can be download from following address:/Mararsh/MyBox/releases/download/v4.5/MyBox-UserGuide-4.5-Overview-en.pdfEach type of tools are introduced in seperated user guides: “MyBox User

9、 Guide PDF Tools”/Mararsh/MyBox/releases/download/v3.9/MyBox-UserGuide-3.9-PdfTools-en.pdf “MyBox User Guide Image Tools” /Mararsh/MyBox/releases/download/v4.5/MyBox-UserGuide-4.5-ImageTools-en.pdf “MyBox User Guide Desktop Tools” /Mararsh/MyBox/rel

10、eases/download/v4.5/MyBox-UserGuide-4.5-DesktopTools-en.pdf “MyBox User Guide Network Tools”/Mararsh/MyBox/releases/download/v3.9/MyBox-UserGuide-3.9-NetworkTools-en.pdf3Installation and ExecutionExe package can be download and run without installation and without Java envrionment:

11、/Mararsh/MyBox/releases/download/v4.5/MyBox-4.5-exe.zipSince Java is installed by default in Linux env and Mac env, the installation images are not made for the2 platfroms.MyBox can be run on Java 8/9/10. Following Jar package can be download when JRE/JDK is ready:

12、/Mararsh/MyBox/releases/download/v4.5/MyBox-4.5-jar.zipAnd run following command to launch the progrem:java -jar MyBox-4.5.jar4 DevelopmentMyBox is developed with Netbeans8.2 and JavaFX Scene Builder 2.0: //technetwork/java/javafxscenebuilder-1x-archive-219938

13、4.htmlBased on following open sources softwares/libraries:JavaFx/javafx/2/ PdfBox/ jai-imageio/jai-imageio/jai-imageio-corePage 5 / Total 39MyBox User Guide - Overviewjavazoom/index.shtml log4jhttps:/logging.apache.

14、org/log4j/2.x/ Derby:/derby/ GifDecoder:/DhyanB/Open-Imaging EncodingDetect:/ChurchYim/p/8427373.htmlExcept for GifDecoder and EncodingDetect, all dependencies are imported through maven:Page 6 / Total 39MyBox User Guide - Overview5Current ve

15、rsionCurrent version is 4.5. Following features have been implemented:1. PDF Tools:A. Convert each page of PDF file as a image, with options like density, color model, format, compression, quality, color conversion, etc.B. Combine multiple images into PDF file, with options like compression, page si

16、ze, margins, page header, author, etc. Support Chinese and program can locate system font files. User can input the ttf font file path too.C. Compress images in PDF file, with options like JPEG quality or black-white threshold.D. Merge multiple PDF files.E. Split PDF file into multiple PDF files, by

17、 pages number, files number, or start-end list.F. Extract images from PDF file. Can define the page range.G. Extract texts from PDF file. Can customize the deviding lines.H. Handle PDF files in batch way.I. Set the Maximum main memory of PDF handling.2. Image Tools:A. Image Manufacture1) Adjust size

18、: Scale by ratio, or set pixels with 4 types of keeping aspect ratio.2) Adjust color: Increase, decrease, set, filter, or invert value of saturaion, brightness, hue, Red/Green/Blue/Yellow/Cyan/Magenta channel, or RGB itself.3) Make effects: Blur, clarity, sharpen, emboss, edges detect, posterize(red

19、uce colors), thresholding, gray, black-white, Sepia. Convolution can be defined and referred to make more effects4) Other operations: Crop, text, cover(Mosaic/Frosted/Picture ), arc, shadow, shear, mirror, rotate, cut margins, add margins. Options can be set.5) “Scope”:All, Matting, Rectangle, Circl

20、e, Color Matching, Color Matching in Rectrangle, Color Matching in Circle. Color Matching can be against saturaion, brightness, hue, RGB, or Red/Green/Blue channel. Scope can be applied for Color Adjustment, Effects, and Convolution. Scope can be determined by simply clicking image. Parameters like

21、points set of matting and colors list of color matching can be set easily. All scope can be set as Excluded.6) “Undo” and “Redo” of previous operation. Original image can be recoverred at any time. Updated histories can be saved automatically and set back. Number of updated histories can be set.7) B

22、rowse images under same directory.8) Select whether show reference image. Can select other pictures as the reference image.B. Image Manufacture in batch way.C. Multiple frames image file.1)2)3)View/Extract images in the file. Create/Edit multiple frames Tiff/Tif file.View/Extract/Create/Edit animate

23、d Gif file. Interval, whether loop, and images size canPage 7 / Total 39MyBox User Guide - Overviewbe set.D. Merge images.1) Blend images. Support options like defining the intersected area, and multiple famous blending modes2) Combine images. Support options like array ordering, background color, i

24、nterval, margins, and size.3) Combine images in PDF file.E.Part image.1) Split image. Support splitting by number, splitting by size, and customized splitting. Save results as multiple image files, multiple frames Tiff file, or PDF file.2) Subsample image. Options like sample region and sample ratio

25、. Handle 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 nex

26、t 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 to display the image, and not suitable for operations against whole image and images merging.6) Some operations, li

27、ke splitting and subsampling, can be handled by reading part of image data and writing-while-reading, so they are suitable for big images.F.G. Copy image or selected part of image in system clipboard(Ctrl-c).H. View the image meta-data and image attributes.I. View multiple images in same screen. Sup

28、port rotating and zooming at same time. Support browsing.J. Convert image into other format, with options like color model, size, compression, quality, etc.K. Color paletteL. Pixels calculator M.Convolution Kernels ManagerN. Shortcuts3.Desktop Tools:A.Rename Files/Directories, with options of files

29、name and ordering. Renamed files can be recovered as original names in all or in part.Sychronize directories, with options like whether copy sub-directories or new files, whether only copy modified files after specific date time, whether keep attributes of original files, or whther delete non-existe

30、d files/directories under original directory.Arrange files and reorganize them under new directories by modifed time. This tool can be used to handle lots of files which need be archived according to time, like photoes,B.C.Page 8 / Total 39MyBox User Guide - Overviewscreenshots of games, or system l

31、ogs.D. Text Encoding. File charset can be either detected automatically or set manually. Target file charset can be selected to implement encoding conversion. BOM setting is supported. Hexadecimal codes can be viewed and selected synchronously. Line numbers are shown.E. Alarm clocks, including optio

32、ns of time and music. Support rings of “Meow”, wav files, and mp3. Can run in background.Network Tools:4.A.Html Editora. Edit local web pages or online pages in rich text.b. Code Editor can be sychronized with Html Editor.c. Web browser can be sychronized with contents of Editors, or load the online

33、 page. Support history browsing, font zooming 、 and snapshoting of the whole page as a image or a PDF file.Weibo Snaping Toola. Save Weibo pages of any months of any Weibo accounts automatically.b. Set the months range.c. Make sure whole page contents loaded. Can expand the comments and pictures in

34、the pages.d. Save the pages as local html files which can not be loaded normally due to dynamic loading of WeiBo contents. They can be used to extract texts in the pages.e. Save the pages snapshots as PDF files, with options like page size, margins, author, images format, etc.f. Save all original si

35、ze pictures in the pages.g. Display progress information in time.h. Stop the progress at any time. The interrupted month will be record and input as start month for next execution.i. Set the retry times of failure.B.5.6.Supported image format: png,jpg,bmp,tif,gif,wbmp,pnm,pcx.Settings of languages,

36、whether show comments, PDF options, image options, whether close alarm clocks when exit program, clearing settings, and more parameters.Multiple interface styles.Internationalization. Switch languages in time. Current supported languages include Chinese and English. More lanaguages can be supported

37、by editing new resource files.7.8.Page 9 / Total 39MyBox User Guide - Overview6 Common Functions6.1 Main InterfaceThe main interface will be shown when program is launched. Click icons to pop the menus.6.2 Main Menu BarThe main Menu bar is shown in interface of all tools. Select the menu item to ent

38、er other tools.Page 10 / Total 39MyBox User Guide - Overview6.3 Switch LanguageClick Language icon to select one of the languages and the interface will be shown in the selected language.6.4 Open in InterfaceTo keep current interface while open other tool, click menu item “Window”-”Home” and select

39、the tool in the newly opened main interface:Page 11 / Total 39MyBox User Guide - Overview7 Example: Making icon for MyBox with MyBox7.1Crop ImagePage 12 / Total 39MyBox User Guide - Overview7.2Check colorsPage 13 / Total 39MyBox User Guide - Overview7.3Save as PNGPage 14 / Total 39MyBox User Guide -

40、 Overview7.4Filter: Black-White(Binarization)Page 15 / Total 39MyBox User Guide - Overview7.5Set ScopePage 16 / Total 39MyBox User Guide - Overview7.6Replace color: change background colorPage 17 / Total 39MyBox User Guide - Overview7.7Change pixels sizePage 18 / Total 39MyBox User Guide - Overview7

41、.8Make the icon with texturePage 19 / Total 39MyBox User Guide - Overview7.9Apply the new iconPage 20 / Total 39MyBox User Guide - Overview7.10Watermark: Write comments on picturesPage 21 / Total 39MyBox User Guide - Overview8 About Interface Resolution(dpi-aware)Traditional screen resolution is 96

42、dpi, and other resolutions are rarely concerned in operating systems and applications. Now more and more high resolutions monitors are used and current operating systems are already dpi-aware that is displaying the interface according to the actual resultion of the screen. Jaba 8 has implemented dpi

43、-aware in part but dpi can not be changed dynamically by program.MyBox is based on Java 8, and the interface is not well when OS resolution is changed in users env. A tyical scenario is that the windows are larger, controllers are blurer and font size is smaller when I set the monitors display scale

44、 as 125% which causes resolution become 72 dpi.Since verson 3.1, MyBox forces the interface font size as 15px. But user need set the programs attribute as following to avoid lower resolution due to system dpi change:/questions/988379/how-do-i-run-java-apps-upscaled-on-a-high-dpi-

45、displayPage 22 / Total 39MyBox User Guide - Overview9 Settings9.1 Menu SettingsFollowing can be set directly by clicking the menu items:1)2)3)4)5)6)Switch language Whether show commentsHow to save alpha channel Maximum main memory for PDFWhether stop alarm clocks when exit programClear personal sett

46、ingsPage 23 / Total 39MyBox User Guide - Overview9.2 Setting WindowOpen the settings window by clicking menu item “Settings”-”Settings.”:Page 24 / Total 39MyBox User Guide - Overview9.3 ShortcutsPut mouse upon a button, its shortcut will be popped if has.Currently MyBox has following common shortcut

47、s : In most of interface, click “ctrl-m” to open/close comments.Every interface may have their special shortcuts. Example, “ctrl-s” for “Save” in Image Manufacture window. Please refer User Guides of tools.9.4 Temporary files pathThis is the diectory used by MyBox tools to save temporary files.9.5 M

48、aximum main memory for PDFWhen limited quato is reached, temprary files will be used as extended memory.If not limit main memory usage, Out of Memory may happen for large PDF files.9.6 Updating histories of imageUpdating histories of image can be record to return to former status.User can set whethe

49、r record the histories or set the number of updating histories.9.7 Maximum width to display sampled imageWhen pixels number of image is very large, available memory may not be enough to load and display it. MyBox should evaluate this situation and judge whether subsample the image to display it.This

50、 parameter is to limit the maximum width to subsample image to display. It does not affect other operation. Example, when split image or subsample image, pixels of original image but not pixels of sampled image are read.Page 25 / Total 39MyBox User Guide - Overview9.8 Interface StylesThere are multi

51、ple interface styles can be selected:Page 26 / Total 39MyBox User Guide - OverviewPage 27 / Total 39MyBox User Guide - OverviewPage 28 / Total 39MyBox User Guide - OverviewPage 29 / Total 39MyBox User Guide - Overview10HelpsHelp pages can be viewed with embedded browser or with external browser.10.1

52、Image Meta DataPlease refer following:/javase/10/docs/api/javax/imageio/metadata/doc-files/standard_metadata.html /javase/10/docs/api/javax/imageio/metadata/doc-files/gif_metadata.html /javase/10/docs/api/javax/imageio/metadata/doc-fi

53、les/jpeg_metadata.html /javase/10/docs/api/javax/imageio/metadata/doc-files/png_metadata.html/javase/10/docs/api/javax/imageio/metadata/doc-files/tiff_metadata.htmlPage 30 / Total 39MyBox User Guide - Overview10.2About Java Image I/O TechnologyPlease refer

54、 following: /javase/8/docs/technotes/guides/imageio//javase/8/docs/technotes/guides/imageio/spec/imageio_guideTOC.fm.html/javase/tutorial/2d/index.html /article/2076764/java-se/image-processing-with-java-2d.htm

55、l10.3About Multiple Frames Image FileIt is a file which includes multiple independant images.Currently MyBox supports multiple frames image files in formats of animated gif and tiff/tif.Page 31 / Total 39MyBox User Guide - Overview10.4About Tiff/TifPlease refer following: /wik

56、i/TIFF /wiki/GeoTIFFhttps:/www.adobe.io/open/standards/TIFF.html10.5About Animated GifPlease refer following: /whatsinagif/index.html /p/df52f1511cf8/questions/22259714/arrayindexoutofboundsexception-409

57、6-while-reading-gif-file/DhyanB/Open-Imaging/python-examples/com.sun.media.imageioimpl.plugins.gif.GIFImageWriterSpi/10.6About Big ImageBig image is a picture that includes too many pixels to be loaded and displayed under limitation of current memory usage. For all operations which use image as i