/// <summary>
/// 更新 grid 中的某一列。此方法會自動視需要斷行，讓指定的列拆成兩列。
/// </summary>
/// <param name="row">Grid 列索引。</param>
private void ReformatRow(int row)
{
row = GetBrailleRowIndex(row); // 修正列索引為點字列所在的索引。
int lineIndex = GetBrailleLineIndex(row);
int lineCnt = BrailleProcessor.GetInstance().FormatLine(m_BrDoc, lineIndex, null);
if (lineCnt > 1) // 有斷行?
{
// 換上新列
RecreateRow(row);
FillRow(m_BrDoc[lineIndex], row, true);
// 插入新列
GridInsertRowAt(row + 3);
FillRow(m_BrDoc[lineIndex + 1], row + 3, true);
// 重新填列號
RefreshRowNumbers();
}
else
{
// 換上新列
RecreateRow(row);
FillRow(m_BrDoc[lineIndex], row, true);
}
}
public void ConvertLineTest()
{
BrailleProcessor target = BrailleProcessor.GetInstance();
ConvertLineTestChinese(target);
ConvertLineTestEnglish(target);
}
public void PreprocessTagsTest()
{
BrailleProcessor target = BrailleProcessor.GetInstance();
string line = "<書名號>哈利波特</書名號>, <書名號>地下室手記</書名號>";
string expected = "﹏﹏哈利波特 , ﹏﹏地下室手記 ";
string actual = target.PreprocessTagsForLine(line);
Assert.AreEqual(expected, actual, "BrailleProcesser.PreprocessTags 測試失敗!");
}
private void MainForm_Load(object sender, EventArgs e)
{
// 只需設定一次，且必須最早進行的初始化動作：建立點字轉換器物件，並指定點字對應表物件。
string filePath = StrHelper.AppendSlash(Application.StartupPath);
ChineseWordConverter chtCvt = new ChineseWordConverter(filePath + "ChineseBrailleTable.xml");
EnglishWordConverter engCvt = new EnglishWordConverter(filePath + "EnglishBrailleTable.xml");
m_Processer = new BrailleProcessor();
m_Processer.AddWordConverter(chtCvt);
m_Processer.AddWordConverter(engCvt);
}
public void LoadTest()
{
BrailleProcessor processor =
BrailleProcessor.GetInstance(
new ZhuyinReverseConverter(
new ZhuyinReverseConversionProvider()));
string filename = Shared.TestDataPath + "TestData_Braille.txt";
BrailleDocument brDoc = new BrailleDocument(filename, processor, 32);
brDoc.LoadAndConvert();
}
public EditCellForm()
{
InitializeComponent();
Mode = EditCellMode.Edit;
m_BrWord = new BrailleWord();
// 以下動作不可移到 Form_Load 做，因為某些用到以下變數的事件會比它更早觸發。
m_BrProcessor = BrailleProcessor.GetInstance();
m_ChtWordCvt = m_BrProcessor.ChineseConverter;
Debug.Assert(m_ChtWordCvt != null);
}
public BrailleConverter()
{
_zhuyinConverter = CreateZhuyinConverter(AppGlobals.Config.PreferIFELanguage);
_processor = BrailleProcessor.GetInstance(_zhuyinConverter);
_doc = new BrailleDocument(_processor);
_processor.ConvertionFailed += new ConvertionFailedEventHandler(BrailleProcessor_ConvertionFailed);
_processor.TextConverted += new TextConvertedEventHandler(BrailleProcessor_TextConverted);
//m_Processor.ChineseConverter = null; // 保護
m_CvtResultFileName = Path.Combine(AppGlobals.TempPath, Constant.Files.CvtResultFileName);
m_CvtErrorCharFileName = Path.Combine(AppGlobals.TempPath + Constant.Files.CvtErrorCharFileName);
_verboseMode = false;
LoadPhraseFiles();
// TODO: 還需要這個嗎？
ZhuyinQueryHelper.Initialize(); // 初始化注音字根查詢器（載入注音字根表）。
}
/// <summary>
/// 判斷傳入的列是否為原書頁碼，如果是，則設定起始或終止原書頁碼。
/// </summary>
/// <param name="brLine"></param>
/// <param name="isFirstLineOfPage">是否為該頁的第一列。</param>
private void SetOrgPageNumber(BrailleLine brLine, bool isFirstLineOfPage)
{
string line = brLine.ToString();
int orgPageNum = BrailleProcessor.GetOrgPageNumber(line);
if (orgPageNum < 0)
{
return;
}
if (m_BeginOrgPageNumber < 0)
{
m_BeginOrgPageNumber = orgPageNum;
}
if (isFirstLineOfPage) // 如果該頁的第一列就是原書頁碼
{
m_BeginOrgPageNumber = orgPageNum; // 則起始原書頁碼應該直接使用此頁碼。
}
m_EndOrgPageNumber = orgPageNum;
}
public void ConvertLineTestChinese(BrailleProcessor target)
{
string msg = "BrailleProcesser.ConvertLine 測試失敗: ";
// 測試明眼字內含注音符號、冒號後面跟著"我"、以及引號、句號。
string line = "ㄅˇ你說：我是誰？ 我說：「我是神。」";
string expected = "ㄅˇ你說： 我是誰？ 我說：「我是神。」";
BrailleLine brLine = target.ConvertLine(line);
string actual = brLine.ToString();
Assert.AreEqual(expected, actual, msg + line);
// 測試破折號和刪節號。
line = "第一種破折號：─，第二種破折號：－，連續破折號：──，－－。";
expected = "第一種破折號：─，第二種破折號：－，連續破折號：──，－－。";
brLine = target.ConvertLine(line);
actual = brLine.ToString();
Assert.AreEqual(expected, actual, msg + line);
// 測試刪節號。
line = "單：…，雙：……";
expected = "單：…，雙：……";
brLine = target.ConvertLine(line);
actual = brLine.ToString();
Assert.AreEqual(expected, actual, msg + line);
// 測試連續多個全形空白：保留空白。
line = "空 白 ";
expected = "空 白 ";
brLine = target.ConvertLine(line);
actual = brLine.ToString();
Assert.AreEqual(expected, actual, msg + line);
// 測試私名號、書名號。
line = "<私名號>蔡煥麟</私名號>，<書名號>倚天屠龍記</書名號>";
expected = "╴╴蔡煥麟 ，﹏﹏倚天屠龍記 ";
brLine = target.ConvertLine(line);
actual = brLine.ToString();
Assert.AreEqual(expected, actual, msg + line);
}
public void ConvertLineTestEnglish(BrailleProcessor target)
{
string msg = "BrailleProcesser.ConvertLine 測試失敗: ";
// 測試一個大寫字母。
string line = "Hello";
string expected = "Hello";
BrailleLine brLine = target.ConvertLine(line);
string actual = brLine.ToString();
Assert.AreEqual(expected, actual, msg + line);
bool isOk = (brLine[0].Cells[0].Value == (byte)BrailleCellCode.Capital) &&
(brLine[0].Cells[1].Value == 0x13);
Assert.IsTrue(isOk, msg + line);
// 測試兩個大寫字母。
line = "ABC";
expected = "ABC";
brLine = target.ConvertLine(line);
actual = brLine.ToString();
Assert.AreEqual(expected, actual, msg + line);
isOk = (brLine[0].Cells[0].Value == (byte)BrailleCellCode.Capital) &&
(brLine[0].Cells[1].Value == (byte)BrailleCellCode.Capital) &&
(brLine[0].Cells[2].Value == 0x01) && // 'A'
(brLine[1].Cells[0].Value == 0x03); // 'B'
Assert.IsTrue(isOk, msg + line);
// 測試數字。
line = "123,56 2006-09-29";
expected = "123,56 2006-09-29";
brLine = target.ConvertLine(line);
actual = brLine.ToString();
isOk = (brLine[0].Cells[0].Value == (byte)BrailleCellCode.Digit) &&
(brLine[4].Cells[0].Value != (byte)BrailleCellCode.Capital) && // 逗號視為數字的延續，不用額外加數字記號。
(brLine[7].Cells[0].Value == (byte)BrailleCellCode.Digit) &&
(brLine[12].Cells[0].Value != (byte)BrailleCellCode.Capital); // 連字號視為數字的延續，不用額外加數字記號。
Assert.IsTrue(isOk, msg + line);
// 測試編號。
line = "#1-2. 1";
expected = "1-2. 1";
brLine = target.ConvertLine(line);
actual = brLine.ToString();
isOk = (actual == expected) &&
(brLine[0].Cells[0].Value == (byte)BrailleCellCode.Digit) &&
(brLine[0].Cells[1].Value == 0x01) && // 數字 1 的上位點。
(brLine[1].Cells[0].Value == 0x24) && // '-'
(brLine[2].Cells[0].Value == 0x03) && // '2'
(brLine[3].Cells[0].Value == 0x32) && // '.'
(brLine[4].Cells[0].Value == 0x00) && // ' '
(brLine[5].Cells[0].Value == (byte)BrailleCellCode.Digit) &&
(brLine[5].Cells[1].Value == 0x02); // 數字 1 的下位點。
Assert.IsTrue(isOk, msg + line);
// 測試連續多個空白：保留空白。
line = "a b ";
expected = "a b ";
brLine = target.ConvertLine(line);
actual = brLine.ToString();
Assert.AreEqual(expected, actual, msg + line);
}
public void BreakLineTest()
{
string msg = "BrailleProcesser.BreakLine 測試失敗!";
BrailleProcessor target = BrailleProcessor.GetInstance();
ContextTagManager context = new ContextTagManager();
// 測試斷行：冒號+我。
string line = "一二三四：我";
BrailleLine brLine = target.ConvertLine(line); // 冒號後面會加一個空方
int cellsPerLine = 12; // 故意在空方之後斷行。
string expected = "一二三四：";
List <BrailleLine> brLines = target.BreakLine(brLine, cellsPerLine, context);
string actual = brLines[0].ToString();
Assert.AreEqual(expected, actual, msg);
brLines.Clear();
// 測試斷行：斷在句點。
line = "一二三四。";
brLine = target.ConvertLine(line);
cellsPerLine = 10; // 故意斷在句號處。
string expected1 = "一二三"; // 應該把最後一個字連同句號斷至下一行。
string expected2 = "四。";
brLines = target.BreakLine(brLine, cellsPerLine, context);
bool isOk = (brLines.Count == 2 &&
brLines[0].ToString() == expected1 && brLines[1].ToString() == expected2);
Assert.IsTrue(isOk, msg);
// 測試斷行：斷在英文字中間要加上連字號。
line = "this is a loooooong word.";
brLine = target.ConvertLine(line);
cellsPerLine = 12; // 故意斷在句號處。
expected1 = "this is a"; // 應該把最後一個字連同句號斷至下一行。
expected2 = "loooooong";
brLines = target.BreakLine(brLine, cellsPerLine, context);
isOk = (brLines.Count == 3 &&
brLines[0].ToString() == expected1 && brLines[1].ToString() == expected2);
Assert.IsTrue(isOk, msg);
// 測試斷行：連續的數字不可斷開。
line = "12345 6789";
brLine = target.ConvertLine(line);
cellsPerLine = 8;
brLines = target.BreakLine(brLine, cellsPerLine, context);
isOk = (brLines.Count == 2 &&
brLines[0].ToString() == "12345" &&
brLines[1].ToString() == "6789" &&
brLines[0][0].Cells[0].Value == (byte)BrailleCellCode.Digit &&
brLines[1][0].Cells[0].Value == (byte)BrailleCellCode.Digit);
Assert.IsTrue(isOk, msg);
// 測試斷行：斷在數字中間的逗號。
line = "abc 123,456";
brLine = target.ConvertLine(line);
cellsPerLine = 8; // 故意斷在逗號處。
expected1 = "abc";
expected2 = "123,456";
brLines = target.BreakLine(brLine, cellsPerLine, context);
isOk = (brLines.Count == 2 &&
brLines[0].ToString() == expected1 &&
brLines[1].ToString() == expected2 &&
brLines[1][0].Cells[0].Value == (byte)BrailleCellCode.Digit);
Assert.IsTrue(isOk, msg);
}
