fcdev 0.1.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +21 -2
- package/docs/01-/350/275/257/344/273/266/346/236/266/346/236/204/350/256/276/350/256/241.md +164 -0
- package/docs/02-/345/221/275/344/273/244/350/241/214/344/270/216/346/236/204/345/273/272.md +157 -0
- package/docs/03-/347/233/256/346/240/207/350/247/204/350/214/203.md +123 -0
- package/docs/04-cc65/345/267/245/345/205/267/351/223/276.md +51 -0
- package/docs/05-/346/250/241/346/213/237/345/231/250/344/270/216/350/260/203/350/257/225.md +100 -0
- package/docs/06-/345/217/215/346/261/207/347/274/226.md +103 -0
- package/docs/07-/345/210/233/345/273/272/345/214/205/344/270/216/346/250/241/346/235/277.md +74 -0
- package/docs/08-/346/265/213/350/257/225/344/270/216/351/252/214/350/257/201.md +72 -0
- package/docs/09-/345/217/221/345/270/203.md +67 -0
- package/docs/10-VS Code/346/211/251/345/261/225.md" +131 -0
- package/docs/nes/01-NES/347/233/256/346/240/207.md +52 -0
- package/docs/sb2000/01-/345/274/200/345/217/221/346/214/207/345/215/227.md +252 -0
- package/docs/sb2000/02-/347/263/273/347/273/237/350/260/203/347/224/250/346/211/213/345/206/214.md +797 -0
- package/docs/sb2000/03-/347/241/254/344/273/266/350/257/264/346/230/216.md +27 -0
- package/docs//345/276/205/345/212/236/345/244/207/345/277/230.md +46 -0
- package/docs//347/274/272/351/231/267/350/256/260/345/275/225.md +10 -0
- package/package.json +4 -3
- package/src/api/header-parser.mjs +78 -0
- package/src/api/index.mjs +128 -0
- package/src/build/bank-link-config.mjs +74 -0
- package/src/build/index.mjs +1 -0
- package/src/build/program-builder.mjs +5 -2
- package/src/cli/commands/api-command.mjs +62 -0
- package/src/cli/commands/docs-command.mjs +58 -0
- package/src/cli/index.mjs +6 -0
- package/src/docs/doc-index.mjs +101 -0
- package/src/docs/doc-topics.mjs +38 -0
- package/src/docs/index.mjs +10 -0
- package/src/targets/target-registry.mjs +38 -0
- package/targets/nes/lib/fcnes.lib +0 -0
- package/targets/nes/lib/nes-font.o +0 -0
- package/targets/sb2000/api-reference.md +3295 -0
- package/targets/sb2000/api-unwrapped.json +36 -0
- package/targets/sb2000/asminc/sb2000.inc +203 -1
- package/targets/sb2000/include/sb2000-bank.h +74 -0
- package/targets/sb2000/include/sb2000-clock.h +68 -0
- package/targets/sb2000/include/sb2000-disk.h +141 -0
- package/targets/sb2000/include/sb2000-display.h +352 -0
- package/targets/sb2000/include/sb2000-file.h +273 -0
- package/targets/sb2000/include/sb2000-ime.h +158 -0
- package/targets/sb2000/include/sb2000-input.h +192 -0
- package/targets/sb2000/include/sb2000-math.h +228 -0
- package/targets/sb2000/include/sb2000-memory.h +115 -0
- package/targets/sb2000/include/sb2000-printer.h +116 -0
- package/targets/sb2000/include/sb2000-sound.h +134 -0
- package/targets/sb2000/include/sb2000-symbols.h +397 -1
- package/targets/sb2000/include/sb2000-system.h +219 -0
- package/targets/sb2000/include/sb2000-text.h +99 -0
- package/targets/sb2000/include/sb2000.h +13 -20
- package/targets/sb2000/lib/crt0.o +0 -0
- package/targets/sb2000/lib/sb2000.lib +0 -0
- package/targets/sb2000/lib-build.json +1 -1
- package/targets/sb2000/link-banked.cfg +42 -0
- package/targets/sb2000/src/crt0.s +89 -4
- package/targets/sb2000/src/lib/bank/sb-bank-current.c +18 -0
- package/targets/sb2000/src/lib/bank/sb-bank-select.c +21 -0
- package/targets/sb2000/src/lib/bank/sbi-bank-trampoline.s +46 -0
- package/targets/sb2000/src/lib/clock/sb-clock-get-date.c +17 -0
- package/targets/sb2000/src/lib/clock/sb-clock-get-time.c +17 -0
- package/targets/sb2000/src/lib/clock/sb-clock-set-date.c +21 -0
- package/targets/sb2000/src/lib/clock/sb-clock-set-time.c +17 -0
- package/targets/sb2000/src/lib/clock/sbi-date-from-fat.c +20 -0
- package/targets/sb2000/src/lib/clock/sbi-date-to-fat.c +24 -0
- package/targets/sb2000/src/lib/clock/sbi-time-from-fat.c +20 -0
- package/targets/sb2000/src/lib/clock/sbi-time-to-fat.c +19 -0
- package/targets/sb2000/src/lib/disk/sb-disk-format-track.c +18 -0
- package/targets/sb2000/src/lib/disk/sb-disk-free-bytes.c +38 -0
- package/targets/sb2000/src/lib/disk/sb-disk-init.c +16 -0
- package/targets/sb2000/src/lib/disk/sb-disk-read-sector.c +24 -0
- package/targets/sb2000/src/lib/disk/sb-disk-read-sectors.c +17 -0
- package/targets/sb2000/src/lib/disk/sb-disk-scan-track.c +27 -0
- package/targets/sb2000/src/lib/disk/sb-disk-start.c +16 -0
- package/targets/sb2000/src/lib/disk/sb-disk-stop.c +16 -0
- package/targets/sb2000/src/lib/disk/sb-disk-write-sector.c +19 -0
- package/targets/sb2000/src/lib/disk/sb-disk-write-sectors.c +17 -0
- package/targets/sb2000/src/lib/disk/sbi-disk-batch.c +23 -0
- package/targets/sb2000/src/lib/disk/sbi-disk-call.c +17 -0
- package/targets/sb2000/src/lib/disk/sbi-disk-set-position.c +18 -0
- package/targets/sb2000/src/lib/display/sb-cell-address.c +20 -0
- package/targets/sb2000/src/lib/display/sb-cells-copy.c +27 -0
- package/targets/sb2000/src/lib/display/sb-cells-fill.c +25 -0
- package/targets/sb2000/src/lib/display/sb-cells-rect.c +20 -0
- package/targets/sb2000/src/lib/display/sb-display-mode.c +16 -0
- package/targets/sb2000/src/lib/display/sb-glyph-address.c +28 -0
- package/targets/sb2000/src/lib/display/sb-image-fill-rect.c +26 -0
- package/targets/sb2000/src/lib/display/sb-image-load-raw.c +22 -0
- package/targets/sb2000/src/lib/display/sb-image-show-full.c +20 -0
- package/targets/sb2000/src/lib/display/sb-image-show.c +25 -0
- package/targets/sb2000/src/lib/display/sb-image-unpack-map.c +28 -0
- package/targets/sb2000/src/lib/display/sb-image-unpack-tiles.c +20 -0
- package/targets/sb2000/src/lib/display/sb-image-unpack-to-memory.c +22 -0
- package/targets/sb2000/src/lib/display/sb-palette-write.c +20 -0
- package/targets/sb2000/src/lib/display/sb-screen-clear.c +19 -0
- package/targets/sb2000/src/lib/display/sb-screen-flush.c +16 -0
- package/targets/sb2000/src/lib/display/sb-text-draw.c +22 -0
- package/targets/sb2000/src/lib/display/sb-text-field-ascii.c +25 -0
- package/targets/sb2000/src/lib/display/sb-text-field.c +25 -0
- package/targets/sb2000/src/lib/display/sb-text-to-memory.c +27 -0
- package/targets/sb2000/src/lib/display/sb-vram-bank.c +17 -0
- package/targets/sb2000/src/lib/display/sb-vram-fill.c +21 -0
- package/targets/sb2000/src/lib/display/sb-vram-load.c +21 -0
- package/targets/sb2000/src/lib/display/sb-window-compact.c +16 -0
- package/targets/sb2000/src/lib/display/sb-window-init.c +16 -0
- package/targets/sb2000/src/lib/display/sb-window-restore.c +17 -0
- package/targets/sb2000/src/lib/display/sb-window-save.c +21 -0
- package/targets/sb2000/src/lib/file/sb-dir-change.c +21 -0
- package/targets/sb2000/src/lib/file/sb-dir-current.c +27 -0
- package/targets/sb2000/src/lib/file/sb-dir-make.c +21 -0
- package/targets/sb2000/src/lib/file/sb-dir-open.c +61 -0
- package/targets/sb2000/src/lib/file/sb-dir-read.c +87 -0
- package/targets/sb2000/src/lib/file/sb-dir-remove.c +21 -0
- package/targets/sb2000/src/lib/file/sb-file-close.c +21 -0
- package/targets/sb2000/src/lib/file/sb-file-delete.c +21 -0
- package/targets/sb2000/src/lib/file/sb-file-get-attr.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-get-date.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-get-time.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-load.c +50 -0
- package/targets/sb2000/src/lib/file/sb-file-open.c +26 -0
- package/targets/sb2000/src/lib/file/sb-file-read.c +52 -0
- package/targets/sb2000/src/lib/file/sb-file-rename.c +30 -0
- package/targets/sb2000/src/lib/file/sb-file-save.c +31 -0
- package/targets/sb2000/src/lib/file/sb-file-set-attr.c +22 -0
- package/targets/sb2000/src/lib/file/sb-file-set-date.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-set-time.c +22 -0
- package/targets/sb2000/src/lib/file/sb-file-size.c +27 -0
- package/targets/sb2000/src/lib/file/sb-file-write-all.c +32 -0
- package/targets/sb2000/src/lib/file/sb-file-write.c +60 -0
- package/targets/sb2000/src/lib/file/sbi-dir-state.c +15 -0
- package/targets/sb2000/src/lib/file/sbi-dos-call.c +17 -0
- package/targets/sb2000/src/lib/file/sbi-load-sector.c +18 -0
- package/targets/sb2000/src/lib/file/sbi-select-handle.c +20 -0
- package/targets/sb2000/src/lib/file/sbi-set-path.c +26 -0
- package/targets/sb2000/src/lib/ime/sb-ime-get-method.c +17 -0
- package/targets/sb2000/src/lib/ime/sb-ime-get-state.c +18 -0
- package/targets/sb2000/src/lib/ime/sb-ime-hex.c +20 -0
- package/targets/sb2000/src/lib/ime/sb-ime-init.c +26 -0
- package/targets/sb2000/src/lib/ime/sb-ime-key-wait.c +19 -0
- package/targets/sb2000/src/lib/ime/sb-ime-key.c +19 -0
- package/targets/sb2000/src/lib/ime/sb-ime-parse.c +23 -0
- package/targets/sb2000/src/lib/ime/sb-ime-resume.c +16 -0
- package/targets/sb2000/src/lib/ime/sb-ime-select.c +19 -0
- package/targets/sb2000/src/lib/ime/sb-ime-set-state.c +18 -0
- package/targets/sb2000/src/lib/ime/sb-ime-set-width.c +16 -0
- package/targets/sb2000/src/lib/ime/sb-ime-suspend.c +16 -0
- package/targets/sb2000/src/lib/input/sb-break-disable.c +16 -0
- package/targets/sb2000/src/lib/input/sb-break-enable.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-count.c +17 -0
- package/targets/sb2000/src/lib/input/sb-key-flush.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-init.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-modifiers.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-poll.c +17 -0
- package/targets/sb2000/src/lib/input/sb-key-wait.c +17 -0
- package/targets/sb2000/src/lib/input/sb-keyboard-reset.c +17 -0
- package/targets/sb2000/src/lib/input/sb-mouse-buttons.c +21 -0
- package/targets/sb2000/src/lib/input/sb-mouse-position.c +18 -0
- package/targets/sb2000/src/lib/input/sb-mouse-reset.c +17 -0
- package/targets/sb2000/src/lib/input/sb-mouse-set-double-click.c +17 -0
- package/targets/sb2000/src/lib/input/sb-mouse-set-limits.c +26 -0
- package/targets/sb2000/src/lib/input/sb-mouse-set-position.c +18 -0
- package/targets/sb2000/src/lib/input/sb-pad-init.c +17 -0
- package/targets/sb2000/src/lib/input/sb-pad-poll.c +17 -0
- package/targets/sb2000/src/lib/input/sb-pad-state.c +16 -0
- package/targets/sb2000/src/lib/input/sb-pad-wait.c +17 -0
- package/targets/sb2000/src/lib/math/sb-float-add.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-div.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-from-text.c +18 -0
- package/targets/sb2000/src/lib/math/sb-float-mul.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-sub.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-to-text.c +19 -0
- package/targets/sb2000/src/lib/math/sb-int24-add.c +21 -0
- package/targets/sb2000/src/lib/math/sb-int24-div.c +26 -0
- package/targets/sb2000/src/lib/math/sb-int24-mul.c +20 -0
- package/targets/sb2000/src/lib/math/sb-int24-sub.c +21 -0
- package/targets/sb2000/src/lib/math/sb-int40-from-text.c +19 -0
- package/targets/sb2000/src/lib/math/sb-int40-to-text.c +27 -0
- package/targets/sb2000/src/lib/math/sb-line-step.c +21 -0
- package/targets/sb2000/src/lib/math/sb-math-div16.c +27 -0
- package/targets/sb2000/src/lib/math/sb-math-time-text.c +21 -0
- package/targets/sb2000/src/lib/math/sb-random-next.c +20 -0
- package/targets/sb2000/src/lib/math/sb-random-seed.c +19 -0
- package/targets/sb2000/src/lib/math/sb-random-warm-up.c +16 -0
- package/targets/sb2000/src/lib/math/sbi-peek.c +20 -0
- package/targets/sb2000/src/lib/math/sbi-poke.c +20 -0
- package/targets/sb2000/src/lib/memory/sb-address-to-far.c +20 -0
- package/targets/sb2000/src/lib/memory/sb-far-read-byte.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-far-read.c +36 -0
- package/targets/sb2000/src/lib/memory/sb-far-write-byte.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-far-write.c +36 -0
- package/targets/sb2000/src/lib/memory/sb-page-alloc.c +19 -0
- package/targets/sb2000/src/lib/memory/sb-page-free.c +19 -0
- package/targets/sb2000/src/lib/memory/sb-page-largest-free.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-window-map-group.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-window-map.c +18 -0
- package/targets/sb2000/src/lib/memory/sbi-far-copy-in.s +17 -0
- package/targets/sb2000/src/lib/memory/sbi-far-copy-out.s +17 -0
- package/targets/sb2000/src/lib/memory/sbi-far-read-byte.s +19 -0
- package/targets/sb2000/src/lib/memory/sbi-far-write-byte.s +17 -0
- package/targets/sb2000/src/lib/printer/sb-printer-carriage-return.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-feed.c +17 -0
- package/targets/sb2000/src/lib/printer/sb-printer-graphics-mode.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-home.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-init-port.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-page-left.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-page-length.c +17 -0
- package/targets/sb2000/src/lib/printer/sb-printer-position.c +18 -0
- package/targets/sb2000/src/lib/printer/sb-printer-reset.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-send-byte.c +18 -0
- package/targets/sb2000/src/lib/printer/sb-printer-text.c +29 -0
- package/targets/sb2000/src/lib/sb-internal.h +111 -0
- package/targets/sb2000/src/lib/sound/sb-sound-effect-from.c +19 -0
- package/targets/sb2000/src/lib/sound/sb-sound-play-from.c +18 -0
- package/targets/sb2000/src/lib/sound/sb-sound-play-wav-from.c +18 -0
- package/targets/sb2000/src/lib/sound/sb-sound-play-wav.c +16 -0
- package/targets/sb2000/src/lib/sound/sb-sound-repeat-wav-from.c +19 -0
- package/targets/sb2000/src/lib/sound/sb-sound-status.c +17 -0
- package/targets/sb2000/src/lib/sound/sb-sound-stop.c +16 -0
- package/targets/sb2000/src/lib/sound/sb-sound-tempo.c +17 -0
- package/targets/sb2000/src/lib/sound/sb-sound-transpose.c +17 -0
- package/targets/sb2000/src/lib/sound/sb-speech-off.c +16 -0
- package/targets/sb2000/src/lib/sound/sb-speech-send-entry-from.c +21 -0
- package/targets/sb2000/src/lib/sound/sb-speech-send-from.c +19 -0
- package/targets/sb2000/src/lib/sound/sb-speech-send.c +16 -0
- package/targets/sb2000/src/lib/system/sb-call-banked.c +19 -0
- package/targets/sb2000/src/lib/system/sb-context-restore.c +16 -0
- package/targets/sb2000/src/lib/system/sb-context-save.c +19 -0
- package/targets/sb2000/src/lib/system/sb-display-off.c +16 -0
- package/targets/sb2000/src/lib/system/sb-display-on.c +16 -0
- package/targets/sb2000/src/lib/system/sb-display-option.c +18 -0
- package/targets/sb2000/src/lib/system/sb-exec.c +22 -0
- package/targets/sb2000/src/lib/system/sb-irq-enable.c +19 -0
- package/targets/sb2000/src/lib/system/sb-irq-hook-reset.c +20 -0
- package/targets/sb2000/src/lib/system/sb-irq-hook-set.c +39 -0
- package/targets/sb2000/src/lib/system/sb-irq-mask.c +19 -0
- package/targets/sb2000/src/lib/system/sb-jump-banked.s +25 -0
- package/targets/sb2000/src/lib/system/sb-nmi-disable.c +16 -0
- package/targets/sb2000/src/lib/system/sb-nmi-enable.c +16 -0
- package/targets/sb2000/src/lib/system/sb-nmi-hook-reset.c +20 -0
- package/targets/sb2000/src/lib/system/sb-nmi-hook-set.c +33 -0
- package/targets/sb2000/src/lib/system/sb-nmi-service.c +19 -0
- package/targets/sb2000/src/lib/system/sb-stack-pointer.s +18 -0
- package/targets/sb2000/src/lib/system/sb-system-init.c +16 -0
- package/targets/sb2000/src/lib/system/sb-system-state.c +20 -0
- package/targets/sb2000/src/lib/system/sb-wait-frames.s +19 -0
- package/targets/sb2000/src/lib/system/sbi-exec-run.s +43 -0
- package/targets/sb2000/src/lib/system/sbi-interrupts-off.s +19 -0
- package/targets/sb2000/src/lib/system/sbi-interrupts-restore.s +17 -0
- package/targets/sb2000/src/lib/text/sb-beep.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-column.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-left.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-right.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-row.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-set-column.c +18 -0
- package/targets/sb2000/src/lib/text/sb-cursor-up.c +16 -0
- package/targets/sb2000/src/lib/text/sb-print-hex.c +22 -0
- package/targets/sb2000/src/lib/text/sb-print-uint.c +25 -0
- package/targets/sb2000/src/lib/text/sb-print.c +35 -0
- package/targets/sb2000/src/lib/text/sb-putc.c +26 -0
- package/targets/sb2000/src/sb2000.s +0 -3
- package/targets/sb2000/target.json +14 -0
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* ------------------------------------------------------------------------
|
|
3
|
+
* 名称:sb2000-printer.h
|
|
4
|
+
* 说明:SB-DOS 程序的打印机服务:24 针点阵打印机(Epson ESC/P)的复位、走纸、定位、发送字节、页长、打印文字。
|
|
5
|
+
* 作者:sungbin
|
|
6
|
+
* 邮箱:sungbin@3578.cn
|
|
7
|
+
* 日期:2026-11-11
|
|
8
|
+
* 备注:由 sb2000.h 引入,程序不必单独包含。功能 $76-$7A 是同一个入口,函数统一用 $76。打印机经并口驱动,模拟器里是虚拟的 ESC/P 打印机。
|
|
9
|
+
* 文字打印按 GB2312:$20-$7E 是西文(8×16,宽 8 列),$A1 以上两个字节组成一个汉字(16×16,宽 16 列);
|
|
10
|
+
* 每行 1144 列,非位图模式每行打两遍。文字里可以夹控制码,见 sb_printer_text 的说明。
|
|
11
|
+
* ------------------------------------------------------------------------
|
|
12
|
+
*/
|
|
13
|
+
#ifndef SB2000_PRINTER_H
|
|
14
|
+
#define SB2000_PRINTER_H
|
|
15
|
+
|
|
16
|
+
/** 打印格式。 */
|
|
17
|
+
typedef struct {
|
|
18
|
+
/** 字宽倍率,0 到 5,每一列重复 1 到 6 次。 */
|
|
19
|
+
unsigned char width;
|
|
20
|
+
/** 点数模式:0 每个点上下各重复 2 次,1 每个点重复 3 次,2 位图模式(只打一遍)。 */
|
|
21
|
+
unsigned char dots;
|
|
22
|
+
/** 每个字符后附加的空白列数。 */
|
|
23
|
+
unsigned char gap;
|
|
24
|
+
/** 换行后的进纸量(ESC J 的 n,单位 1/216 英寸)。 */
|
|
25
|
+
unsigned char feed;
|
|
26
|
+
/** 发送变换模式,0 不变。 */
|
|
27
|
+
unsigned char transform;
|
|
28
|
+
} sb_printer_style_t;
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* 打印一段文字,到 0 结束。每行先发 ESC @ 与图形命令,再逐字符取字模发送,行满换行,行末进纸并让打印头回到左端。
|
|
32
|
+
* 文字里的控制码:$0D $0A 换行;$92 n 设置字宽与点数模式;$95 n 设置变换模式;$99 n 设置附加空白列;$9B n 设置换行后的进纸量,具体见系统调用手册(docs/sb2000/02-系统调用手册.md)5.11 节。
|
|
33
|
+
*
|
|
34
|
+
* @syscall $76/$00
|
|
35
|
+
* @param text 文字,零结尾,在程序窗口 $8000-$BFFF 里。
|
|
36
|
+
* @param style 打印格式;传 0 时用字宽 0、点数模式 0、无附加空白列、进纸量 $18。
|
|
37
|
+
*/
|
|
38
|
+
void sb_printer_text(const char *text, const sb_printer_style_t *style);
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* 发送复位命令 ESC @。
|
|
42
|
+
*
|
|
43
|
+
* @syscall $76/$01
|
|
44
|
+
*/
|
|
45
|
+
void sb_printer_reset(void);
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* 发送 ESC <,让打印头回到左端。
|
|
49
|
+
*
|
|
50
|
+
* @syscall $76/$02
|
|
51
|
+
*/
|
|
52
|
+
void sb_printer_home(void);
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* 复位打印机并发送回车。
|
|
56
|
+
*
|
|
57
|
+
* @syscall $76/$03
|
|
58
|
+
*/
|
|
59
|
+
void sb_printer_carriage_return(void);
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* 进纸,发送 ESC J n。
|
|
63
|
+
*
|
|
64
|
+
* @syscall $76/$04
|
|
65
|
+
* @param units 进纸量,单位 1/216 英寸。
|
|
66
|
+
*/
|
|
67
|
+
void sb_printer_feed(unsigned char units);
|
|
68
|
+
|
|
69
|
+
/**
|
|
70
|
+
* 横向定位:绝对定位发送 ESC $ 加两个字节,相对定位发送 ESC \ 加两个字节。
|
|
71
|
+
*
|
|
72
|
+
* @syscall $76/$05、$76/$06
|
|
73
|
+
* @param relative 0 绝对定位,非 0 相对定位。
|
|
74
|
+
* @param position 位置,单位 1/60 英寸(绝对)或 1/120 英寸(相对),16 位。
|
|
75
|
+
*/
|
|
76
|
+
void sb_printer_position(unsigned char relative, unsigned int position);
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* 把一个字节原样发给打印机,不做变换。
|
|
80
|
+
*
|
|
81
|
+
* @syscall $76/$07
|
|
82
|
+
* @param value 要发送的字节。
|
|
83
|
+
*/
|
|
84
|
+
void sb_printer_send_byte(unsigned char value);
|
|
85
|
+
|
|
86
|
+
/**
|
|
87
|
+
* 发送 ESC * 39 1144,进入 24 针三倍密度位图模式,每行 1144 列。
|
|
88
|
+
*
|
|
89
|
+
* @syscall $76/$08
|
|
90
|
+
*/
|
|
91
|
+
void sb_printer_graphics_mode(void);
|
|
92
|
+
|
|
93
|
+
/**
|
|
94
|
+
* 初始化并口并等待。只初始化一次,之后的调用什么都不做;其他打印机函数每次都会先调用它,所以一般不必单独调用。
|
|
95
|
+
*
|
|
96
|
+
* @syscall $76/$0E
|
|
97
|
+
*/
|
|
98
|
+
void sb_printer_init_port(void);
|
|
99
|
+
|
|
100
|
+
/**
|
|
101
|
+
* 按纸张类型设置页长计数(单位 1/216 英寸,进纸时从中扣除):0 是 1900,1 是 2523(11.68 英寸,A4),2 是 2106,3 是 1488,4 是 2077,5 是 1821;
|
|
102
|
+
* 6 以上只把参数存进计数的高字节。
|
|
103
|
+
*
|
|
104
|
+
* @syscall $76/$0F
|
|
105
|
+
* @param paper 纸张类型,0 到 5。
|
|
106
|
+
*/
|
|
107
|
+
void sb_printer_page_length(unsigned char paper);
|
|
108
|
+
|
|
109
|
+
/**
|
|
110
|
+
* 取本页剩余走纸量(单位 1/216 英寸)。剩余不足 $58 时打印文字会自动收尾进纸并按纸张类型重新装入页长。
|
|
111
|
+
*
|
|
112
|
+
* @return 剩余走纸量。
|
|
113
|
+
*/
|
|
114
|
+
unsigned int sb_printer_page_left(void);
|
|
115
|
+
|
|
116
|
+
#endif
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* ------------------------------------------------------------------------
|
|
3
|
+
* 名称:sb2000-sound.h
|
|
4
|
+
* 说明:SB-DOS 程序的声音与语音服务:播放曲子与音效、停止、调整移调与拍速、播放内存里的 WAV、发送语音数据。
|
|
5
|
+
* 作者:sungbin
|
|
6
|
+
* 邮箱:sungbin@3578.cn
|
|
7
|
+
* 日期:2026-11-11
|
|
8
|
+
* 备注:由 sb2000.h 引入,程序不必单独包含。曲子、WAV、语音数据的位置用“页组 + 窗口地址”表示,约定同 sb_call_banked:页组是连续 4 页的首页号,
|
|
9
|
+
* 这 4 页映射到 $8000-$BFFF,窗口地址是数据在窗口里的地址。WAV 与语音数据在程序自己的窗口里时可用不带 _from 的版本,函数自动用程序的起始页做页组。
|
|
10
|
+
* 曲子只提供带页组的版本:把曲子放进程序窗口里起播后,引擎在 NMI 里读曲子会读乱(实测),要把曲子放在 ROM 页,或自己申请的扩展 RAM 页里(用 sb_far_write 写入)。
|
|
11
|
+
* 曲子格式与音乐引擎见系统调用手册(docs/sb2000/02-系统调用手册.md)5.5 节;发声在 NMI 中断里更新,更新要求 NMI 开着(sb_nmi_enable)且 $0630 的声音位开着。
|
|
12
|
+
* ------------------------------------------------------------------------
|
|
13
|
+
*/
|
|
14
|
+
#ifndef SB2000_SOUND_H
|
|
15
|
+
#define SB2000_SOUND_H
|
|
16
|
+
|
|
17
|
+
/** 语音数据传送完时的结束帧(低 4 位全 1)。 */
|
|
18
|
+
#define SB_SPEECH_END_FRAME 0x0F
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* 载入并播放一首曲子(音乐格式或音效格式)。先关闭声音更新,复位发声状态,起播后再打开声音更新。
|
|
22
|
+
*
|
|
23
|
+
* @syscall $65/$00
|
|
24
|
+
* @param group 曲子所在页组的首页号。
|
|
25
|
+
* @param address 曲子在页组窗口里的地址。
|
|
26
|
+
*/
|
|
27
|
+
void sb_sound_play_from(unsigned char group, unsigned int address);
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* 停止播放:复位发声状态,关闭声音更新,播放状态变成 $FF。
|
|
31
|
+
*
|
|
32
|
+
* @syscall $65/$02
|
|
33
|
+
*/
|
|
34
|
+
void sb_sound_stop(void);
|
|
35
|
+
|
|
36
|
+
/**
|
|
37
|
+
* 取播放状态。
|
|
38
|
+
*
|
|
39
|
+
* @syscall $65/$03
|
|
40
|
+
* @return 播放状态,停止播放后是 $FF。
|
|
41
|
+
*/
|
|
42
|
+
unsigned char sb_sound_status(void);
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* 调整 4 个音乐声道的移调值:每个声道的移调值都加上 delta(8 位回绕)。
|
|
46
|
+
*
|
|
47
|
+
* @syscall $65/$04
|
|
48
|
+
* @param delta 要加的值,负数用补码。
|
|
49
|
+
*/
|
|
50
|
+
void sb_sound_transpose(unsigned char delta);
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* 调整拍速:拍速值加上 delta(8 位回绕),同步写进备份单元。
|
|
54
|
+
*
|
|
55
|
+
* @syscall $65/$05
|
|
56
|
+
* @param delta 要加的值,负数用补码。
|
|
57
|
+
*/
|
|
58
|
+
void sb_sound_tempo(unsigned char delta);
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* 复位后播放一首音效格式的曲子(音效声道 4-7)。音乐格式的曲子用它起不了播,要用 sb_sound_play_from。
|
|
62
|
+
*
|
|
63
|
+
* @syscall $65/$0B
|
|
64
|
+
* @param group 曲子所在页组的首页号。
|
|
65
|
+
* @param address 曲子在页组窗口里的地址。
|
|
66
|
+
*/
|
|
67
|
+
void sb_sound_effect_from(unsigned char group, unsigned int address);
|
|
68
|
+
|
|
69
|
+
/**
|
|
70
|
+
* 播放内存里的 WAV(8 位采样)。屏蔽中断播放,播完才返回。
|
|
71
|
+
* 采样率取文件头偏移 $18 的低字节:$44 是 44100 Hz,$22 是 22050 Hz,其他按 11025 Hz;采样长度取偏移 $28 的 4 个字节,跳过 44 字节文件头;
|
|
72
|
+
* 实际会多播一个采样(总数是长度加 1)。
|
|
73
|
+
*
|
|
74
|
+
* @syscall $65/$0C
|
|
75
|
+
* @param group WAV 所在页组的首页号。
|
|
76
|
+
* @param address WAV 文件头在页组窗口里的地址。
|
|
77
|
+
*/
|
|
78
|
+
void sb_sound_play_wav_from(unsigned char group, unsigned int address);
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* 播放程序自己窗口里的 WAV,规则同 sb_sound_play_wav_from。
|
|
82
|
+
*
|
|
83
|
+
* @syscall $65/$0C
|
|
84
|
+
* @param wav WAV 文件头的地址,在程序窗口 $8000-$BFFF 里。
|
|
85
|
+
*/
|
|
86
|
+
void sb_sound_play_wav(const void *wav);
|
|
87
|
+
|
|
88
|
+
/**
|
|
89
|
+
* 重复播放内存里的 WAV。次数不为 0 时先等 5 帧再开始;播完(含次数为 0)后声音寄存器恢复。
|
|
90
|
+
*
|
|
91
|
+
* @syscall $65/$0D
|
|
92
|
+
* @param group WAV 所在页组的首页号。
|
|
93
|
+
* @param address WAV 文件头在页组窗口里的地址。
|
|
94
|
+
* @param times 重复的遍数。
|
|
95
|
+
*/
|
|
96
|
+
void sb_sound_repeat_wav_from(unsigned char group, unsigned int address, unsigned char times);
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* 关闭语音:清语音芯片的使能位与语音控制标志的“已使用”位。
|
|
100
|
+
*
|
|
101
|
+
* @syscall $74/$00
|
|
102
|
+
*/
|
|
103
|
+
void sb_speech_off(void);
|
|
104
|
+
|
|
105
|
+
/**
|
|
106
|
+
* 同步发送一段语音数据(LPC 码流):先复位语音芯片,写命令字节 $0A,再把数据逐字节写给语音端口,读到结束帧后返回。
|
|
107
|
+
* 数据要以结束帧(SB_SPEECH_END_FRAME,低 4 位全 1)收尾,否则不会返回。
|
|
108
|
+
*
|
|
109
|
+
* @syscall $75/$00
|
|
110
|
+
* @param group 数据所在页组的首页号。
|
|
111
|
+
* @param address 数据在页组窗口里的地址。
|
|
112
|
+
*/
|
|
113
|
+
void sb_speech_send_from(unsigned char group, unsigned int address);
|
|
114
|
+
|
|
115
|
+
/**
|
|
116
|
+
* 同步发送程序自己窗口里的语音数据,规则同 sb_speech_send_from。
|
|
117
|
+
*
|
|
118
|
+
* @syscall $75/$00
|
|
119
|
+
* @param data 语音数据的地址,在程序窗口 $8000-$BFFF 里。
|
|
120
|
+
*/
|
|
121
|
+
void sb_speech_send(const void *data);
|
|
122
|
+
|
|
123
|
+
/**
|
|
124
|
+
* 按序号发送词条表里的一个词条。词条表头 2 字节是词条个数(低字节在前),之后每项 3 字节:页号增量、相对表起点的偏移低字节、偏移高字节。
|
|
125
|
+
* 序号不小于词条个数时什么都不发送。
|
|
126
|
+
*
|
|
127
|
+
* @syscall $75/$01
|
|
128
|
+
* @param group 词条表所在页组的首页号。
|
|
129
|
+
* @param table 词条表在页组窗口里的地址。
|
|
130
|
+
* @param index 词条序号,从 0 起。
|
|
131
|
+
*/
|
|
132
|
+
void sb_speech_send_entry_from(unsigned char group, unsigned int table, unsigned int index);
|
|
133
|
+
|
|
134
|
+
#endif
|