XTC eBook Viewer

Preview .xtc, .xtcz, and .xtch e-books, standalone .xtg and .xth page images, and XTEINK-compatible .xtf and .bin bitmap fonts directly in Visual Studio Code.

• Page navigation by toolbar, page number, keyboard, or table of contents
• Zoom controls and fit-to-window display
• Book title and author metadata
• Uncompressed 1-bit XTC pages
• LZ4-compressed XTCZ containers
• Four-level grayscale XTCH pages
• Standalone 1-bit XTG and four-level grayscale XTH images
• XTF/BIN font statistics, populated Unicode ranges, and cell dimensions
• Editable BIN font sample with standard and 90-degree-rotated views
• Virtualized font map for browsing every populated glyph or every Unicode slot

This is an unofficial compatibility tool. It is not affiliated with or endorsed by Xteink or any other device manufacturer. Product names are mentioned only to describe file compatibility.

Usage

Install from the Visual Studio Marketplace:

https://marketplace.visualstudio.com/items?itemName=cqa02303.xtc-ebook-viewer

Open an .xtc, .xtcz, .xtch, .xtg, .xth, .xtf, or .bin file in VS Code. If another editor is already associated with the file, use Reopen Editor With... and select XTC eBook Viewer or XTEINK Bitmap Font Viewer. A standalone XTG or XTH image is displayed as a one-page document.

The bitmap font viewer reports the number of non-empty glyphs and their contiguous Unicode ranges. Its sample text is editable and can be switched between the standard stored orientation and a 90-degree-rotated view. The font map can show only populated glyphs or every Unicode slot and supports direct U+3042-style jumps. XTF dimensions and proportional advances are read from the file header. Because raw BIN fonts have no dimension header, the filename must contain a cell size such as 24x24 or 24×24. The viewer reads that size directly and does not show a cell-size selector. Standard view displays the stored bitmap orientation directly. The Layout control does not reflow text: it only rotates the complete sample canvas 90 degrees clockwise. Standard view is the default, matching the stored left-rotated glyphs used by vertical-display fonts. The font map follows the same Layout selection.

Use Left/Right or PageUp/PageDown to change pages, Home/End to jump to the first or last page, and the table of contents to jump to a chapter. Over the page, scroll the mouse wheel down to move forward or up to move backward. Hold Ctrl while scrolling the mouse wheel to zoom the page in or out. The selected zoom level is preserved when changing pages.

To verify the supported formats without another book, open the Command Palette and run XTC: Open XTCZ Sample, XTC: Open XTCH Sample, XTC: Open XTG Sample, or XTC: Open XTH Sample. All bundled samples use original, redistributable text created for this extension.

Development

1. Open the xtc-ebook-viewer folder in VS Code.
2. Press F5 to start an Extension Development Host.
3. Open a supported e-book in the Development Host.

Run tests and create a VSIX package with:

npm test
npm run package

Visual Studio Code内で .xtc、.xtcz、.xtch 電子書籍、単一ページ画像の .xtg、.xth、XTEINK互換の.xtf・.binビットマップフォントを閲覧する拡張です。

• ツールバー、ページ番号、キーボード、目次によるページ移動
• 拡大・縮小とウィンドウ全体へのフィット
• 作品名・作者情報の表示
• 無圧縮1bit XTCページ
• LZ4圧縮XTCZコンテナ
• 4階調グレースケールXTCHページ
• 単一画像の1bit XTGおよび4階調グレースケールXTH
• XTF/BINフォントの収録字形数、Unicode連続範囲、セル寸法の表示
• 編集可能なサンプル文章と標準・90度回転表示の切り替え
• 収録字形または全Unicodeスロットを閲覧できる仮想スクロールマップ

この拡張は非公式の互換ツールです。Xteinkおよびその他のデバイスメーカーによる 公式・公認の製品ではなく、各社との提携関係もありません。製品名はファイル互換性を 説明する目的に限って記載しています。

使い方

Visual Studio Marketplaceからインストールできます。

https://marketplace.visualstudio.com/items?itemName=cqa02303.xtc-ebook-viewer

VS Codeで .xtc、.xtcz、.xtch、.xtg、.xth、.xtf、.bin を開きます。別のエディターが 関連付けられている場合は「エディターを再度開くアプリケーション」から 「XTC eBook Viewer」または「XTEINK Bitmap Font Viewer」を選びます。単一のXTG/XTH画像は 1ページ文書として表示します。

ビットマップフォントビューアでは、空でない収録字形の数とUnicode連続範囲を確認できます。 サンプル文章は自由に編集でき、格納方向そのままの標準表示と90度回転表示を切り替えられます。 フォントマップは 収録字形だけ、または全Unicodeスロットを仮想スクロールで表示し、U+3042形式で 目的の文字へ移動できます。XTFでは寸法とプロポーショナル文字幅をヘッダーから取得します。 生のBINには寸法ヘッダーがないため、ファイル名に24x24 または24×24のような文字サイズを含めてください。Viewerはその寸法を直接取得し、 セル寸法の選択欄は表示しません。標準表示ではBINに格納されたビットマップ方向をそのまま 表示します。Layoutは文章を組み直す機能ではなく、サンプルキャンバス全体を右へ90度回す だけの機能です。縦書き表示用に左90度倒して格納された字形を確認できる標準表示を既定とし、 フォントマップも同じLayout選択に追従します。

左右矢印またはPageUp/PageDownでページを移動し、Home/Endで先頭・末尾へ移動します。 サイドバーの目次から章の先頭へジャンプできます。 本文表示エリアでは、マウスホイールを下へ回すと次ページ、上へ回すと前ページへ移動します。 Ctrlキーを押しながらマウスホイールを回すと、ページ表示を拡大・縮小できます。 設定した拡大率はページを移動しても維持されます。

手元に書籍ファイルがなくても、コマンドパレットから XTC: Open XTCZ Sample / XTCZサンプルを開く、 XTC: Open XTCH Sample / XTCHサンプルを開く、または XTC: Open XTG Sample / XTGサンプルを開く、 XTC: Open XTH Sample / XTHサンプルを開くを実行して確認できます。 同梱サンプルには、この拡張用に作成した再配布可能なオリジナル本文だけを使用しています。

開発

1. VS Codeで xtc-ebook-viewer フォルダを開きます。
2. F5 を押してExtension Development Hostを起動します。
3. Development Host側で対応する電子書籍を開きます。

テストとVSIX作成：

npm test
npm run package