Text To Braille Version 5
Copyright 07/05/2023, New Braille System Corp.
Tsuneo Hoshika
EMail : hoshika@nbs.co.jp

        Update from Ver4

点訳辞書に多くの単語を追加登録しました。
Many additional words were added to the Braille dictionary.

翻訳向上のため、プログラムソースに変更を加えました。
Changes were made to the program source to improve translation.


        Purpose 

You convert Japanese text (UtF-16LT)　into Braille display for putput braille code. 

        file list
texttobrlver5.txt : Dis File

source(FOLDER) : 

MAIN.CPP : SAMPLE SOURCE
BRL_INFO.H : PARAMETER STRUCT Head File
tobrl.h : Head File
tobrl.o : Link File
ktoau.o : Link File

execute(FOLDER) : 

プログラムのテスト実行環境。
Test execution environment for the program.

6tenu.dat : 6Ten Kanji data file
8tenu.dat : kantenji data file
BTF.DAT : tenji data file
DETAIL.TXT : detail text file
kigou.txt : kigou text file
ktoa_u_hir.dic : hiragana dictionary file
ktoa_u_kat.dic : katakana dictionary file
ktoa_u_kwa.dic : kanji dictionary file
settouu.dic : settougo dictionary file
setubiu.dic : setsubigo dictionary file
suushiu.dic : suushi dictionary file
tan1u.dic : tan kanji dictionary file
tan2u.dic: tan kanji dictionary file
userdic.txt : users dictionary text file
testu.txt : sample text file
tobrl.exe : sample program file

How to use tobrl 

int Init(char *DataPath) :

Set data path in DataPath and initialize.
return :


0 : success
1 : ktoa_u_kwa.dic not open
2 : ktoa_u_kwa.dic not right
3 : ktoa_u_hir.dic not open
4 : ktoa_u_hir.dic not right
5 : ktoa_u_kat.dic not open
6 : ktoa_u_kat.dic not right
7 : setubiu.dic not open
8 : settouu.dic not open
9 : suushiu.dic not open
10 : tan1u.dic not open
11 : tan2u.dic not open
12 : kigou.txt not open
13 : kigou.txt not right
14 : kigou.txt not right
15 : 6tenu.dat not open
16 : 6tenu.dat not right
17 : 6tenu.dat not right
18 : 8tenu.dat not open
19 : 8tenu.dat not right
20 : 8tenu.dat not right
21 : btf.dat not open
22 : btf.dat not right
23 : detail.txt not open
24 : detail.txt not right
25 : detail.txt not right
26 : users.txt not open
27 : users.txt not right
28 : users.txt not right
100 : end of trial period 

int TextToBrl(BRL_INFO_MAP *Param) :
Convert 1 paragraph text to Braille Code.

return :


0 : success
1 : not initialize
2 : buffer full

BRL_INFO_MAP 

wchar_t *TextStr : 
Set text address.

At text end, you add 0x0d in line feed or add 0x0c in page feed, or add 0x01 in end mark.

unsigned short *BrlBuf : 
Set baille code address.

within max size 9600.
Stored in units of blocks specified by unsigned PinLen.
braille code is set at up 8bit.
1bit 1dot, 2bit 2dot ... 8bit 8dot up 
*
When up 9bit(0x0100) is on, it is cursor character.
When up 10bit(0x0200) is on, it is range character.

unsigned short *CurBuf :
Set Character position address.
within max size 9600.
Character position of original text is stored.

unsigned CurPosition;
Set the cursor position.
When you get the cursor position, the convert ends at this block.
when 0 is specified, the cursor is treated as if it were not there, and all character conversions are done.

unsigned RangeStart :
Set the beginning of range specification position.

unsigned RangeEnd :
Set the end of range specification position.

unsigned PinLen :
Set the number of Pin cell.

unsigned JapaneseMode :
Set Japanese convert mode.
0 : kana wakachi gaki 
1 : 6Ten Kanji 
2 : Kan tenji 

unsigned EnglishMode :
Set english convert mode.
	0 : grade 1
1 : grade 2
2 : NABCC 6
3 : NABCC 8
4 : programming braille

unsigned TabWide :
tab code is changed for space.
The number of the changed space is established at the reach of 4 from 1.

unsigned IsDetail :
0 : normal
1 : detail 
Using to display from potential kana to kanji. 

unsigned IsWordLap : 
0 : off
1 : on
It is always off, wnen Japanese Mode is 1 or 2, or English Mode is 4.

unsigned IsTenyaku;
0 : off
1 : on
It's the setting which is the special used in PcTalker,
so please always set it as off.

unsigned ReTotalBlock :
Converted TotalBlock value is set. 

unsigned ReDefaultBlock:
When cursor position is specified, the maximum block is specified. When cursor position is not specified, 0 is specified.  This block should be output in Braille.

unsigned ReNextBlockCurPosition :
When the cirsor position is specified, the first text character position of the next block is set.
When the right shift key of the Braille display is pressed, the cursor should be placed at that position.
In the last block, 0xffff is set.
Move cursor to the first of the next paragraph, e.g. in an editor.

unsigned RePreviousBlockCurPosition :
When a cursor position is specified, the last text character position of the previous block is set.
When the left shift movement key of the Braille display is pressed, the cursor should be placed at that position.
In the first block, 0 is set.
Move cursor to the end of the previous paragraph, e.g. in an editor.