﻿README.DIZ.TXT

A quick .DIZ for Masakari, revision 8.1+

Masakari is a free and open-source tool with simplistic GUI, aiming at sidekicking browsing textual/.tar files in Linux/Windows command prompts.

New releases and announcements at twitter.com/Sanmayce

New features:
- Thanks to VileR (https://int10h.org), the superb Japanese 6x12 font was added - it allows beautiful 300x80 textual matrix in FHD;
- Creating the unseen x-gram (better defined than n-gram) tree - called PAGODA - by mere clicking Left Mouse Button + Right Mouse button, over a word;
- Added three searching (via keyboard) modes - F3, Lshift+F3, LAlt+F3;
- Automatically switches to the excellent Toshiba unicode 16x32px font, in 4K, otherwise using its 8x16px variant in 1366x768, 1680x1050 and FHD modes;
- Allows browsing Bulgarian/Russian texts, either in Windows-1251 or UTF-8 encoding;
- Scrollwise, refined bigtime, ability to scroll with mouse-keyboard combos or just with mouse alone;
- Source code in form of a .PDF booklet - specially done for QB64 community and coders wanting to help/learn/improve;
- 2021-Jun-08, fixed wrapping bug in r.8+++, also added functionality of wrapping the Current/INVERSE line, by releasing 'Enter';
- 2021-Jul-21, fixed F3 modes combos, fixed mouse handling;
- 2021-Jul-27, introduced Gesch codepage, added F2 (Russian Phonetic) mode, some fixes.

This is how it looks like in the prompt:

```
E:\MASAKARI_r8.1>MASAKARI_Vanilla.exe -h
___  ___                    _                 _                       _____      __
|  \/  |                   | |               (_)                     |  _  |    /  |
| .  . |  __ _  ___   __ _ | | __ __ _  _ __  _    _ __  ___ __   __  \ V /    /_/ |     _
| |\/| | / _` |/ __| / _` || |/ // _` || '__|| |  | '__|/ _ \\ \ / /  / _ \      | |   _| |_
| |  | || (_| |\__ \| (_| ||   <| (_| || |   | |  | |  |  __/ \ V /_ | |_| | _ __| |__|_   _|
\_|  |_/ \__,_||___/ \__,_||_|\_\\__,_||_|   |_|  |_|   \___|  \_/(_)\_____/(_)\_____/  |_|

Masakari, revision 8.1+_Vanilla, written in QB64 by Kaze, source code downloadable at https://www.qb64.org/forum
Usage: Masakari [filename]|[/help][-ascii[_gesch]]
Note: The 'filename' could be a filelist, i.e. a list of filenames (see Space and Double-Left-Click).

Mouse:
   Button 1 - sets the cursor and the inverse line to the chosen position; hold (without moving for 4 seconds) to quit
   Button 2 - [when holded] Draws
   Button 3 - Burst PgDn
   Wheel Up/Dn - Up/Dn
   Button 2 + Wheel Up/Dn - going to the top/bottom left position
   Button 1 + Button 2 - creating PAGODA file for the Current_Word, the loaded file must be in Current Directory!
   Button 2 + dragging (sideways) for at least 100 columns/cells (within 2 seconds) - same as Alt+X, Alt+Q
   Button 2 + dragging (from top to bottom) for at least 5 lines/cells (within 2 seconds) - same as PgUp
   Button 2 + dragging (from bottom to top) for at least 5 lines/cells (within 2 seconds) - same as PgDn
   Button 1 + Button 1 (within 0.33 seconds) - Double-Left-Click - PgUp or loads the inverse line (if it is a valid file)
   Button 2 + Button 2 (within 0.33 seconds) - Double-Right-Click - PgDn
   LShift + Button 1/2 - Burst Up/Dn
   LCtrl + Button 1/2 - Burst PgUp/PgDn
   LAlt + Button 1/2 = LCtrl+Home - going to the top left position / LCtrl+End - going to the bottom left position
Keyboard:
   F1 - this help panel; Enter (released) - opens the current/INVERSE line, WRAPPED, into a new scroll window
   Up/Dn/PgUp/PgDn
   Left/Right - still no sideways scroll
   LCtrl+Home/End - going to the top/bottom left position
   Alt+X or Alt+Q - quit to the system, without demanding keypress
   Space - loads the highlighted line (if it is an actual filename)
   RCtrl|RShift - (can hold it) highlighting all unfamiliar words to masakari.wrd file/wordlist
   LCtrl+F3 - Search Panel, Kazahana (with 16 threads) searches Externally the file, currently displayed
   LAlt+F3 released - Non-Interactive search for Current_Word, from the line below the INVERSE one, downward
   LShift+F3 released - Non-Interactive search for CLIPBOARD, from the line below the INVERSE one, downward
   F2/F3 released - Search Panel, Interactive search for User_Input, from the line below the INVERSE one, downward
Benchmarking:
       LAlt+RAlt - Reporting (in the status line in red color) the time for load
       LCtrl+RCtrl - Reporting (in the status line in red color) the time for PgDn-ing (page-by-page) the entire file
       LShift+RShift - Reporting (in the status line in red color) the time for Down-ing (line-by-line) the entire file
       Esc - Stops the auto-scrolling started with LCtrl+RCtrl or LShift+RShift
Note1: During the LShift+RShift auto-scroll, you can still press/hold RCtrl, during the LCtrl+RCtrl, you cannot.
Note2: During the auto-scroll, you can still press PgUp, PgDn, LCtrl+Home, LCtrl+End, Esc.
Note3: The 'Vanilla' sub-variant loads textual files without wrapping the lines.
Note4: The 'Wrapper' sub-variant makes the text file viewable without side/lateral scroll.
       If unwrappable lines exist then those lines are dumped to filename+".unwrappable",
       otherwise, the wrapped lines are dumped to filename+".wrapped", and auto-loaded.
       If wrapped file exists during start then it is used, not re-created.

E:\MASAKARI_r8.1>
```

' This is the layout for Russian Phonetic - transparently accessible via F2 search control panel:
'   +--+                                              +--+ +---------+
'   |~Ё|                                              |+Ъ| |Backspace|
'   |`ё|                                              |=ъ| |         |
'   +--+                                              +--+ +---------+
'     +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ 
'     |QЯ| |WШ| |EЕ| |RР| |TТ| |YЫ| |UУ| |IИ| |OО| |PП| |{Ю| |}Щ| ||Э| 
'     |qя| |wш| |eе| |rр| |tт| |yы| |uу| |iи| |oо| |pп| |[ю| |]щ| |\э| 
'     +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ 
'       +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ +-----+
'       |AА| |SС| |DД| |FФ| |GГ| |HЧ| |JЙ| |KК| |LЛ| |:Ь| |"Ж| |Enter|
'       |aа| |sс| |dд| |fф| |gг| |hч| |jй| |kк| |lл| |;ь| |'ж| |     |
'       +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ +--+ +-----+
'         +--+ +--+ +--+ +--+ +--+ +--+ +--+
'         |ZЗ| |XХ| |CЦ| |VВ| |BБ| |NН| |MМ|
'         |zз| |xх| |cц| |vв| |bб| |nн| |mм|
'         +--+ +--+ +--+ +--+ +--+ +--+ +--+

Some explanations:

05/15/2021  09:09 PM         1,472,368 1251toGesch                                   ! 64bit ELF !
05/15/2021  09:09 PM             5,784 1251toGesch.bas                               ! Convertor from 1251 codepage to Gesch codepage ! Allowing reading Bulgarian/Russian !
05/15/2021  09:09 PM         1,724,416 1251toGesch.exe                               ! 32bit EXE !

05/15/2021  09:09 PM             8,789 UTF8toGesch.bas                               ! Convertor from UTF-8 codepage to Gesch codepage ! Allowing reading Bulgarian/Russian !
05/15/2021  09:09 PM         1,724,928 UTF8toGesch.exe                               ! 32bit EXE !

05/15/2021  09:09 PM           484,124 kazahana                                      ! 64bit ELF !
05/15/2021  09:09 PM           111,118 Kazahana.exe                                  ! 32bit EXE !
05/15/2021  09:09 PM           109,582 Kazahana_Hexadecad_GCC_102_32bit.exe          ! 32bit EXE, just newest GCC was used !
05/25/2021  04:58 AM         1,380,693 Kazahana_sources_binaries.7z                  ! The binaries and source of fastest scalar fulltext searcheress !

05/15/2021  09:09 PM            96,256 TetraNyotengu.exe                             ! 32bit EXE !
05/15/2021  09:09 PM         1,042,360 libiomp5md.dll                                ! TetraNyotengu needs this Intel OpenMP .DLL!
05/25/2021  04:58 AM         2,222,075 NyoTengu.7z                                   ! The binaries and source of fastest vector fulltext searcheress !

05/15/2021  09:09 PM           135,680 Leprechaun_x-leton_32bit_Intel_01_001p.exe    ! 32bit and 64bit Windows binaries/compiles of fastest x-gram ripper !
05/15/2021  09:09 PM           134,144 Leprechaun_x-leton_32bit_Intel_01_008p.exe
05/15/2021  09:09 PM           134,144 Leprechaun_x-leton_32bit_Intel_01_512p.exe
05/15/2021  09:09 PM           139,264 Leprechaun_x-leton_32bit_Intel_02_001p.exe
05/15/2021  09:09 PM           137,728 Leprechaun_x-leton_32bit_Intel_02_008p.exe
05/15/2021  09:09 PM           137,728 Leprechaun_x-leton_32bit_Intel_02_512p.exe
05/15/2021  09:09 PM           139,264 Leprechaun_x-leton_32bit_Intel_03_001p.exe
05/15/2021  09:09 PM           137,728 Leprechaun_x-leton_32bit_Intel_03_008p.exe
05/15/2021  09:09 PM           137,728 Leprechaun_x-leton_32bit_Intel_03_512p.exe
05/15/2021  09:09 PM           138,240 Leprechaun_x-leton_32bit_Intel_04_001p.exe
05/15/2021  09:09 PM           136,704 Leprechaun_x-leton_32bit_Intel_04_008p.exe
05/15/2021  09:09 PM           136,704 Leprechaun_x-leton_32bit_Intel_04_512p.exe
05/15/2021  09:09 PM           139,776 Leprechaun_x-leton_32bit_Intel_05_001p.exe
05/15/2021  09:09 PM           138,240 Leprechaun_x-leton_32bit_Intel_05_008p.exe
05/15/2021  09:09 PM           138,240 Leprechaun_x-leton_32bit_Intel_05_512p.exe
05/15/2021  09:09 PM           148,480 Leprechaun_x-leton_64bit_Intel_01_001p.exe
05/15/2021  09:09 PM           147,456 Leprechaun_x-leton_64bit_Intel_01_008p.exe
05/15/2021  09:09 PM           147,456 Leprechaun_x-leton_64bit_Intel_01_512p.exe
05/15/2021  09:09 PM           152,576 Leprechaun_x-leton_64bit_Intel_02_001p.exe
05/15/2021  09:09 PM           152,064 Leprechaun_x-leton_64bit_Intel_02_008p.exe
05/15/2021  09:09 PM           152,064 Leprechaun_x-leton_64bit_Intel_02_512p.exe
05/15/2021  09:09 PM           152,576 Leprechaun_x-leton_64bit_Intel_03_001p.exe
05/15/2021  09:09 PM           152,064 Leprechaun_x-leton_64bit_Intel_03_008p.exe
05/15/2021  09:09 PM           152,064 Leprechaun_x-leton_64bit_Intel_03_512p.exe
05/15/2021  09:09 PM           151,552 Leprechaun_x-leton_64bit_Intel_04_001p.exe
05/15/2021  09:09 PM           151,040 Leprechaun_x-leton_64bit_Intel_04_008p.exe
05/15/2021  09:09 PM           151,040 Leprechaun_x-leton_64bit_Intel_04_512p.exe
05/15/2021  09:09 PM           153,600 Leprechaun_x-leton_64bit_Intel_05_001p.exe
05/15/2021  09:09 PM           153,088 Leprechaun_x-leton_64bit_Intel_05_008p.exe
05/15/2021  09:09 PM           153,088 Leprechaun_x-leton_64bit_Intel_05_512p.exe
05/15/2021  09:09 PM           695,925 Leprechaun_x-leton_r17tag.7z                  ! Source Code of fastest x-gram ripper, Windows and Linux compilable !

05/15/2021  09:09 PM            96,993 LineJustify_PAGODAo5.c
05/15/2021  09:09 PM            73,728 LineJustify_PAGODAo5.exe                      ! Needed for creation of PAGODA !

05/15/2021  09:09 PM        10,229,600 masakari.ind                                  ! Needed by RCtrl or RShift in Masakari - highlights the unfamiliar to masakari.wrd words !
05/15/2021  09:09 PM         3,903,143 masakari.wrd                                  ! Kaze's unigram English corpus i.e. spell-check wordlist !

05/24/2021  03:47 AM         9,148,416 Masakari_source_MatrixPrinter.doc
05/24/2021  03:41 AM         4,880,008 Masakari_source_MatrixPrinter.pdf             ! The Masakari source code in printable form, using the very same Toshiba font used in the GUI !

05/25/2021  02:48 AM         2,576,112 MASAKARI_Vanilla                              ! 64bit ELF !
05/24/2021  02:57 AM           158,618 MASAKARI_Vanilla.BAS
05/25/2021  01:35 AM         4,902,912 MASAKARI_Vanilla.exe                          ! 64bit EXE !
05/24/2021  02:58 AM         4,359,680 MASAKARI_Vanilla_32bit.exe
05/25/2021  02:48 AM         2,576,112 MASAKARI_Vanilla_NEC                          ! 64bit ELF !
05/24/2021  02:58 AM           158,618 MASAKARI_Vanilla_NEC.BAS
05/25/2021  01:35 AM         4,902,400 MASAKARI_Vanilla_NEC.exe                      ! 64bit EXE !
05/24/2021  02:58 AM         4,359,168 MASAKARI_Vanilla_NEC_32bit.exe
05/25/2021  02:49 AM         2,576,112 MASAKARI_Wrapper                              ! 64bit ELF !
05/24/2021  02:58 AM           158,618 MASAKARI_Wrapper.BAS
05/25/2021  01:35 AM         4,902,912 MASAKARI_Wrapper.exe                          ! 64bit EXE !
05/24/2021  02:58 AM         4,359,680 MASAKARI_Wrapper_32bit.exe
05/15/2021  09:09 PM             2,991 MEM.H                                         ! Needed for Windows compilation of Masakari !

05/15/2021  09:09 PM               418 m.bat
05/15/2021  09:09 PM                47 mGesch.bat
05/15/2021  09:09 PM                51 mGesch.sh                                     ! In *nix, converts codepage 1251 to Gesch and loads wrapped file in Masakari !
05/15/2021  09:09 PM                98 m1.sh                                         ! In *nix, allows to choose-n-load a file from the the shown filelist !
05/15/2021  09:09 PM                98 ml.sh                                         ! In *nix, this script gives 'ls -l' in a scrollable list !

05/15/2021  09:09 PM           115,068 lucon.ttf
05/15/2021  09:09 PM           146,744 MxPlus_ToshibaTxL2_8x16.ttf                   ! Used by MASAKARI_Vanilla, Kaze's font-of-choice, many thanks go to VileR, https://int10h.org/oldschool-pc-fonts/ !
05/15/2021  09:09 PM            25,960 Px437_DOS-V_re_JPN12.ttf                      ! Used by MASAKARI_Vanilla_NEC, Kaze's font-of-choice, many thanks go to VileR, https://int10h.org/oldschool-pc-fonts/ !

05/15/2021  09:09 PM             6,375 XGRAM_PAGODA5_32bit.bat                       ! Invoked by Masakari !
05/15/2021  09:09 PM             6,393 XGRAM_PAGODA5_64bit.bat                       ! Invoked by Masakari !

05/15/2021  09:09 PM             1,633 MokujIN JADE 217 prompt.lnk                   ! Kaze's Windows Terminal i.e. Command Prompt !

05/25/2021  04:21 AM            12,722 README.DIZ.TXT                                ! This very file !

Enfun!

Kaze,
2021-Jul-28
