fcdev 0.0.0-stage → 0.2.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/LICENSE +201 -0
- package/README.md +82 -2
- package/bin/fcdev.mjs +17 -0
- package/package.json +38 -4
- 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/build-plan.mjs +92 -0
- package/src/build/dependency-file.mjs +24 -0
- package/src/build/disk-builder.mjs +36 -0
- package/src/build/index.mjs +32 -0
- package/src/build/program-builder.mjs +212 -0
- package/src/build/source-collector.mjs +54 -0
- package/src/build/tool-arguments.mjs +83 -0
- package/src/cli/args-parser.mjs +84 -0
- package/src/cli/commands/api-command.mjs +62 -0
- package/src/cli/commands/build-command.mjs +34 -0
- package/src/cli/commands/debug-command.mjs +70 -0
- package/src/cli/commands/disasm-command.mjs +65 -0
- package/src/cli/commands/disk-command.mjs +34 -0
- package/src/cli/commands/info-command.mjs +33 -0
- package/src/cli/commands/project-info.mjs +57 -0
- package/src/cli/commands/run-command.mjs +68 -0
- package/src/cli/commands/sync-command.mjs +85 -0
- package/src/cli/index.mjs +103 -0
- package/src/config/config-loader.mjs +132 -0
- package/src/config/index.mjs +9 -0
- package/src/disasm/analysis.mjs +97 -0
- package/src/disasm/cdl.mjs +35 -0
- package/src/disasm/disassembler.mjs +114 -0
- package/src/disasm/index.mjs +16 -0
- package/src/disasm/info-writer.mjs +72 -0
- package/src/disasm/loaders.mjs +69 -0
- package/src/disasm/opcode-table.mjs +268 -0
- package/src/disasm/roundtrip.mjs +69 -0
- package/src/disasm/symbols.mjs +30 -0
- package/src/disasm/trace.mjs +25 -0
- package/src/emulator/debug-client.mjs +125 -0
- package/src/emulator/emulator-launcher.mjs +80 -0
- package/src/emulator/emulator-locator.mjs +62 -0
- package/src/emulator/index.mjs +11 -0
- package/src/packagers/fat-floppy.mjs +22 -0
- package/src/packagers/fat12-image.mjs +245 -0
- package/src/packagers/flat-binary.mjs +53 -0
- package/src/packagers/index.mjs +54 -0
- package/src/packagers/ines.mjs +38 -0
- package/src/shared/errors.mjs +25 -0
- package/src/shared/fs-utils.mjs +66 -0
- package/src/shared/index.mjs +11 -0
- package/src/shared/process.mjs +50 -0
- package/src/targets/index.mjs +17 -0
- package/src/targets/name-rules.mjs +33 -0
- package/src/targets/target-registry.mjs +225 -0
- package/src/toolchain/index.mjs +16 -0
- package/src/toolchain/toolchain-locator.mjs +104 -0
- package/targets/nes/asminc/fcnes.inc +16 -0
- package/targets/nes/chr/ascii-8x8.chr +0 -0
- package/targets/nes/chr/font8x8_basic.h +152 -0
- package/targets/nes/include/fcnes.h +45 -0
- package/targets/nes/lib/fcnes.lib +0 -0
- package/targets/nes/lib/nes-font.o +0 -0
- package/targets/nes/lib-build.json +9 -0
- package/targets/nes/src/fcnes.s +91 -0
- package/targets/nes/src/nes-font.s +12 -0
- package/targets/nes/target.json +27 -0
- package/targets/sb2000/api-reference.md +3295 -0
- package/targets/sb2000/api-unwrapped.json +36 -0
- package/targets/sb2000/asminc/sb2000.inc +418 -0
- 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 +776 -0
- package/targets/sb2000/include/sb2000-system.h +219 -0
- package/targets/sb2000/include/sb2000-text.h +99 -0
- package/targets/sb2000/include/sb2000.h +45 -0
- package/targets/sb2000/lib/crt0.o +0 -0
- package/targets/sb2000/lib/sb2000.lib +0 -0
- package/targets/sb2000/lib-build.json +8 -0
- package/targets/sb2000/link-banked.cfg +42 -0
- package/targets/sb2000/link.cfg +35 -0
- package/targets/sb2000/src/crt0.s +122 -0
- 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 +64 -0
- package/targets/sb2000/target.json +42 -0
|
@@ -0,0 +1,228 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* ------------------------------------------------------------------------
|
|
3
|
+
* 名称:sb2000-math.h
|
|
4
|
+
* 说明:SB-DOS 程序的数学服务:伪随机数、整数除法、时间文字、十进制文字与浮点数、直线步进、3 字节整数运算。
|
|
5
|
+
* 作者:sungbin
|
|
6
|
+
* 邮箱:sungbin@3578.cn
|
|
7
|
+
* 日期:2026-11-11
|
|
8
|
+
* 备注:由 sb2000.h 引入,程序不必单独包含。这些服务的参数区在 $069A-$06B3,函数帮你把数据放进去再取回来;指针参数必须在程序窗口 $8000-$BFFF 里。
|
|
9
|
+
* 浮点数是 7 个字节:阶码、符号($00 正、$FF 负)、5 字节尾数,值 = ±尾数 ÷ 2^40 × 2^阶码;十进制文字是 13 个字符:1 个符号字符(空格或 -)加 12 个带小数点的数字字符。
|
|
10
|
+
* ------------------------------------------------------------------------
|
|
11
|
+
*/
|
|
12
|
+
#ifndef SB2000_MATH_H
|
|
13
|
+
#define SB2000_MATH_H
|
|
14
|
+
|
|
15
|
+
/** 浮点数,7 个字节。值 = ±尾数 ÷ 2^40 × 2^阶码。 */
|
|
16
|
+
typedef struct {
|
|
17
|
+
/** 阶码。 */
|
|
18
|
+
unsigned char exponent;
|
|
19
|
+
/** 符号,$00 表示正,$FF 表示负。 */
|
|
20
|
+
unsigned char sign;
|
|
21
|
+
/** 尾数,5 个字节,高字节在前。 */
|
|
22
|
+
unsigned char mantissa[5];
|
|
23
|
+
} sb_float_t;
|
|
24
|
+
|
|
25
|
+
/** 3 字节整数:1 个符号字节加 3 个数值字节。 */
|
|
26
|
+
typedef struct {
|
|
27
|
+
/** 符号,$00 表示正,$FF 表示负。 */
|
|
28
|
+
unsigned char sign;
|
|
29
|
+
/** 数值,3 个字节,高字节在前。 */
|
|
30
|
+
unsigned char value[3];
|
|
31
|
+
} sb_int24_t;
|
|
32
|
+
|
|
33
|
+
/** 直线步进的参数块,共 18 个字节。 */
|
|
34
|
+
typedef struct {
|
|
35
|
+
/** 当前点的横坐标,每走一步更新。 */
|
|
36
|
+
unsigned char x;
|
|
37
|
+
/** 当前点的纵坐标,每走一步更新。 */
|
|
38
|
+
unsigned char y;
|
|
39
|
+
/** 终点的横坐标。 */
|
|
40
|
+
unsigned char end_x;
|
|
41
|
+
/** 终点的纵坐标。 */
|
|
42
|
+
unsigned char end_y;
|
|
43
|
+
/** 本次前进的步数,0 表示 256 步。 */
|
|
44
|
+
unsigned char steps;
|
|
45
|
+
/** 系统用来存两轴长度、方向、误差与中间量的工作区,不要改。 */
|
|
46
|
+
unsigned char work[13];
|
|
47
|
+
} sb_line_t;
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* 设置伪随机数寄存器。寄存器的两个高字节全为 0 时,下一次步进前系统先把次高字节置成 $FF,所以种子 0 也能用。
|
|
51
|
+
*
|
|
52
|
+
* @syscall 直接写 $0696-$0699
|
|
53
|
+
* @param seed 32 位种子。
|
|
54
|
+
*/
|
|
55
|
+
void sb_random_seed(unsigned long seed);
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* 把伪随机数寄存器步进一次,返回新的寄存器值。
|
|
59
|
+
*
|
|
60
|
+
* @syscall $4A/$01
|
|
61
|
+
* @return 步进后的 32 位寄存器值。
|
|
62
|
+
*/
|
|
63
|
+
unsigned long sb_random_next(void);
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* 把伪随机数寄存器连续步进 100 次,用来打散刚设置的种子。
|
|
67
|
+
*
|
|
68
|
+
* @syscall $4A/$00
|
|
69
|
+
*/
|
|
70
|
+
void sb_random_warm_up(void);
|
|
71
|
+
|
|
72
|
+
/**
|
|
73
|
+
* 16 位数除以 8 位数。
|
|
74
|
+
*
|
|
75
|
+
* @syscall $4B
|
|
76
|
+
* @param dividend 被除数。
|
|
77
|
+
* @param divisor 除数。
|
|
78
|
+
* @param quotient 返回商。
|
|
79
|
+
* @param remainder 返回余数。
|
|
80
|
+
* @return 0 成功;$FF 除数为 0,商与余数没有意义。
|
|
81
|
+
*/
|
|
82
|
+
unsigned char sb_math_div16(unsigned int dividend, unsigned char divisor, unsigned int *quotient, unsigned char *remainder);
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* 把时、分、秒转成 HH:MM:SS 文字。
|
|
86
|
+
*
|
|
87
|
+
* @syscall $4C
|
|
88
|
+
* @param hour 时。
|
|
89
|
+
* @param minute 分。
|
|
90
|
+
* @param second 秒。
|
|
91
|
+
* @param text 返回 8 个字符加结尾的 0,要有 9 字节空间。
|
|
92
|
+
*/
|
|
93
|
+
void sb_math_time_text(unsigned char hour, unsigned char minute, unsigned char second, char *text);
|
|
94
|
+
|
|
95
|
+
/**
|
|
96
|
+
* 十进制文字转浮点数。
|
|
97
|
+
*
|
|
98
|
+
* @syscall $4D/$00
|
|
99
|
+
* @param text 13 个字符:第 1 个是符号(空格或 -),后面 12 个是带小数点的数字。
|
|
100
|
+
* @param result 返回浮点数。
|
|
101
|
+
*/
|
|
102
|
+
void sb_float_from_text(const char *text, sb_float_t *result);
|
|
103
|
+
|
|
104
|
+
/**
|
|
105
|
+
* 浮点数转十进制文字。
|
|
106
|
+
*
|
|
107
|
+
* @syscall $4E/$00
|
|
108
|
+
* @param value 浮点数。
|
|
109
|
+
* @param text 返回 13 个字符(符号加 12 位带小数点的数字)与结尾的 0,要有 14 字节空间。
|
|
110
|
+
*/
|
|
111
|
+
void sb_float_to_text(const sb_float_t *value, char *text);
|
|
112
|
+
|
|
113
|
+
/**
|
|
114
|
+
* 浮点加法:a + b。
|
|
115
|
+
*
|
|
116
|
+
* @syscall $51
|
|
117
|
+
* @param a 第一个操作数。
|
|
118
|
+
* @param b 第二个操作数。
|
|
119
|
+
* @param result 返回结果,可以与 a 或 b 是同一个变量。
|
|
120
|
+
*/
|
|
121
|
+
void sb_float_add(const sb_float_t *a, const sb_float_t *b, sb_float_t *result);
|
|
122
|
+
|
|
123
|
+
/**
|
|
124
|
+
* 浮点减法:a - b。
|
|
125
|
+
*
|
|
126
|
+
* @syscall $52
|
|
127
|
+
* @param a 第一个操作数。
|
|
128
|
+
* @param b 第二个操作数。
|
|
129
|
+
* @param result 返回结果,可以与 a 或 b 是同一个变量。
|
|
130
|
+
*/
|
|
131
|
+
void sb_float_sub(const sb_float_t *a, const sb_float_t *b, sb_float_t *result);
|
|
132
|
+
|
|
133
|
+
/**
|
|
134
|
+
* 浮点乘法:a * b。
|
|
135
|
+
*
|
|
136
|
+
* @syscall $4F
|
|
137
|
+
* @param a 第一个操作数。
|
|
138
|
+
* @param b 第二个操作数。
|
|
139
|
+
* @param result 返回结果,可以与 a 或 b 是同一个变量。
|
|
140
|
+
*/
|
|
141
|
+
void sb_float_mul(const sb_float_t *a, const sb_float_t *b, sb_float_t *result);
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* 浮点除法:a / b。除数的尾数为 0 时结果的第 1 个字节(阶码)为 $80。
|
|
145
|
+
*
|
|
146
|
+
* @syscall $50
|
|
147
|
+
* @param a 第一个操作数。
|
|
148
|
+
* @param b 第二个操作数。
|
|
149
|
+
* @param result 返回结果,可以与 a 或 b 是同一个变量。
|
|
150
|
+
*/
|
|
151
|
+
void sb_float_div(const sb_float_t *a, const sb_float_t *b, sb_float_t *result);
|
|
152
|
+
|
|
153
|
+
/**
|
|
154
|
+
* 十进制数字文字转 40 位整数。前导空格当 0,超过 40 位时高位丢弃。
|
|
155
|
+
*
|
|
156
|
+
* @syscall $4D/$01
|
|
157
|
+
* @param digits 数字字符,不带符号与小数点。
|
|
158
|
+
* @param count 数字个数,0 到 12。
|
|
159
|
+
* @param value 返回 5 个字节的整数,高字节在前。
|
|
160
|
+
*/
|
|
161
|
+
void sb_int40_from_text(const char *digits, unsigned char count, unsigned char *value);
|
|
162
|
+
|
|
163
|
+
/**
|
|
164
|
+
* 40 位整数转十进制数字文字,数字左对齐、右边补字符 0。
|
|
165
|
+
*
|
|
166
|
+
* @syscall $4E/$01
|
|
167
|
+
* @param value 5 个字节的整数,高字节在前。
|
|
168
|
+
* @param digits 返回 13 个数字字符与结尾的 0,要有 14 字节空间。
|
|
169
|
+
* @param length 返回去掉前导 0 后的有效位数,至少为 1。
|
|
170
|
+
* @return 0 成功;$FF 数值不小于 10^12,放不下。
|
|
171
|
+
*/
|
|
172
|
+
unsigned char sb_int40_to_text(const unsigned char *value, char *digits, unsigned char *length);
|
|
173
|
+
|
|
174
|
+
/**
|
|
175
|
+
* 直线步进(布雷森汉姆算法):从当前点向终点前进指定的步数,落点写回 x、y。步数不小于主轴长度时直接落在终点。
|
|
176
|
+
*
|
|
177
|
+
* @syscall $53
|
|
178
|
+
* @param line 参数块,调用前填好 x、y、end_x、end_y;系统服务换页后程序窗口不可见,所以函数把它复制到 ERAM 里再调用,返回后复制回来。
|
|
179
|
+
* @param steps 前进的步数,0 表示 256 步。
|
|
180
|
+
*/
|
|
181
|
+
void sb_line_step(sb_line_t *line, unsigned char steps);
|
|
182
|
+
|
|
183
|
+
/**
|
|
184
|
+
* 3 字节整数加法:a + b,带符号。
|
|
185
|
+
*
|
|
186
|
+
* @syscall $54/$00
|
|
187
|
+
* @param a 第一个操作数。
|
|
188
|
+
* @param b 第二个操作数。
|
|
189
|
+
* @param result 返回结果。
|
|
190
|
+
* @return 0 没有溢出;1 结果超过 24 位,result 里是低 24 位。
|
|
191
|
+
*/
|
|
192
|
+
unsigned char sb_int24_add(const sb_int24_t *a, const sb_int24_t *b, sb_int24_t *result);
|
|
193
|
+
|
|
194
|
+
/**
|
|
195
|
+
* 3 字节整数减法:a - b,带符号。
|
|
196
|
+
*
|
|
197
|
+
* @syscall $54/$01
|
|
198
|
+
* @param a 第一个操作数。
|
|
199
|
+
* @param b 第二个操作数。
|
|
200
|
+
* @param result 返回结果。
|
|
201
|
+
* @return 0 没有溢出;1 结果超过 24 位,result 里是低 24 位。
|
|
202
|
+
*/
|
|
203
|
+
unsigned char sb_int24_sub(const sb_int24_t *a, const sb_int24_t *b, sb_int24_t *result);
|
|
204
|
+
|
|
205
|
+
/**
|
|
206
|
+
* 3 字节整数乘法:a * b,乘积最多 48 位。
|
|
207
|
+
*
|
|
208
|
+
* @syscall $54/$02
|
|
209
|
+
* @param a 第一个操作数。
|
|
210
|
+
* @param b 第二个操作数。
|
|
211
|
+
* @param sign 返回乘积的符号,$00 正、$FF 负。
|
|
212
|
+
* @param product 返回 6 个字节的乘积,高字节在前。
|
|
213
|
+
*/
|
|
214
|
+
void sb_int24_mul(const sb_int24_t *a, const sb_int24_t *b, unsigned char *sign, unsigned char *product);
|
|
215
|
+
|
|
216
|
+
/**
|
|
217
|
+
* 3 字节整数除法:a / b,得商与余数。
|
|
218
|
+
*
|
|
219
|
+
* @syscall $54/$03
|
|
220
|
+
* @param a 被除数。
|
|
221
|
+
* @param b 除数。
|
|
222
|
+
* @param quotient 返回商,符号是商的符号。
|
|
223
|
+
* @param remainder 返回余数的数值,符号字节与商相同。
|
|
224
|
+
* @return 0 成功;1 除数为 0,商与余数没有意义。
|
|
225
|
+
*/
|
|
226
|
+
unsigned char sb_int24_div(const sb_int24_t *a, const sb_int24_t *b, sb_int24_t *quotient, sb_int24_t *remainder);
|
|
227
|
+
|
|
228
|
+
#endif
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* ------------------------------------------------------------------------
|
|
3
|
+
* 名称:sb2000-memory.h
|
|
4
|
+
* 说明:SB-DOS 程序的内存服务:扩展 RAM 页的分配、跨页读写、窗口映射、窗口地址换算。
|
|
5
|
+
* 作者:sungbin
|
|
6
|
+
* 邮箱:sungbin@3578.cn
|
|
7
|
+
* 日期:2026-11-11
|
|
8
|
+
* 备注:由 sb2000.h 引入,程序不必单独包含。
|
|
9
|
+
* 程序装在 $8000-$BFFF 的 4 个窗口里(每窗口 4K,对应扩展 RAM 的一页);扩展 RAM 的页号从 $80 起,
|
|
10
|
+
* 读文件、放图片、放大块数据都在扩展 RAM 页里,CPU 不能直接访问,用 sb_far_read、sb_far_write 读写。
|
|
11
|
+
* 本文件的函数都假定调用者的数据在程序窗口 $8000-$BFFF 或 $6000-$7FFF 内;
|
|
12
|
+
* 窗口 3($B000-$BFFF)里有程序的软件栈,不要把别的页映射给它。
|
|
13
|
+
* ------------------------------------------------------------------------
|
|
14
|
+
*/
|
|
15
|
+
#ifndef SB2000_MEMORY_H
|
|
16
|
+
#define SB2000_MEMORY_H
|
|
17
|
+
|
|
18
|
+
/**
|
|
19
|
+
* 分配连续的扩展 RAM 页。页数为 0 时不分配,只返回第一个空闲页的页号。
|
|
20
|
+
*
|
|
21
|
+
* @syscall $7E/$00
|
|
22
|
+
* @param count 页数,每页 4K。
|
|
23
|
+
* @param first_page 返回分配到的第一个页号;失败时为 0。
|
|
24
|
+
* @return 0 成功;SB_ERR_NO_MEMORY 没有这么多连续的空闲页。
|
|
25
|
+
*/
|
|
26
|
+
unsigned char sb_page_alloc(unsigned char count, unsigned char *first_page);
|
|
27
|
+
|
|
28
|
+
/**
|
|
29
|
+
* 释放连续的扩展 RAM 页。
|
|
30
|
+
*
|
|
31
|
+
* @syscall $7E/$01
|
|
32
|
+
* @param first_page 第一个页号,必须不小于 $80 且小于 $F0。
|
|
33
|
+
* @param count 页数;这个服务不检查页号加页数是否越过 $F0。
|
|
34
|
+
* @return 0 成功;SB_ERR_BAD_ADDRESS 起始页号不合法,没有释放任何页。
|
|
35
|
+
*/
|
|
36
|
+
unsigned char sb_page_free(unsigned char first_page, unsigned char count);
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* 求最长的连续空闲页数。
|
|
40
|
+
*
|
|
41
|
+
* @syscall $7E/$02
|
|
42
|
+
* @return 页数;计数是 8 位,256 页全部空闲时回绕成 0。
|
|
43
|
+
*/
|
|
44
|
+
unsigned char sb_page_largest_free(void);
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* 读扩展 RAM 页里的一个字节。
|
|
48
|
+
*
|
|
49
|
+
* @param page 页号。
|
|
50
|
+
* @param offset 页内偏移,超过 $0FFF 时折算到后面的页。
|
|
51
|
+
* @return 读到的字节。
|
|
52
|
+
*/
|
|
53
|
+
unsigned char sb_far_read_byte(unsigned char page, unsigned int offset);
|
|
54
|
+
|
|
55
|
+
/**
|
|
56
|
+
* 写扩展 RAM 页里的一个字节。
|
|
57
|
+
*
|
|
58
|
+
* @param page 页号。
|
|
59
|
+
* @param offset 页内偏移,超过 $0FFF 时折算到后面的页。
|
|
60
|
+
* @param value 要写的字节。
|
|
61
|
+
*/
|
|
62
|
+
void sb_far_write_byte(unsigned char page, unsigned int offset, unsigned char value);
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* 把扩展 RAM 里的一段数据读到内存,可以跨页。数据经 $0700 缓冲中转,调用期间会改写 $0700-$07FF。
|
|
66
|
+
*
|
|
67
|
+
* @param page 起始页号。
|
|
68
|
+
* @param offset 页内偏移,超过 $0FFF 时折算到后面的页。
|
|
69
|
+
* @param dest 目的地,必须在程序窗口的前 3 个窗口($8000-$AFFF)、$6000-$7FFF 或内核 RAM 里,不能在窗口 3。
|
|
70
|
+
* @param length 字节数。
|
|
71
|
+
*/
|
|
72
|
+
void sb_far_read(unsigned char page, unsigned int offset, void *dest, unsigned int length);
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* 把内存里的一段数据写到扩展 RAM,可以跨页。数据经 $0700 缓冲中转,调用期间会改写 $0700-$07FF。
|
|
76
|
+
*
|
|
77
|
+
* @param page 起始页号。
|
|
78
|
+
* @param offset 页内偏移,超过 $0FFF 时折算到后面的页。
|
|
79
|
+
* @param src 数据来源,位置的要求同 sb_far_read 的 dest。
|
|
80
|
+
* @param length 字节数。
|
|
81
|
+
*/
|
|
82
|
+
void sb_far_write(unsigned char page, unsigned int offset, const void *src, unsigned int length);
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* 把窗口地址换算成远指针:页号 = 地址高 4 位 - 8 + 页组首页号(按 8 位回绕),页内偏移是地址的低 12 位。
|
|
86
|
+
*
|
|
87
|
+
* @syscall $2C
|
|
88
|
+
* @param group 页组的首页号。
|
|
89
|
+
* @param address 窗口地址,$8000-$FFFF。
|
|
90
|
+
* @param page 返回页号。
|
|
91
|
+
* @param offset 返回页内偏移。
|
|
92
|
+
*/
|
|
93
|
+
void sb_address_to_far(unsigned char group, unsigned int address, unsigned char *page, unsigned int *offset);
|
|
94
|
+
|
|
95
|
+
/**
|
|
96
|
+
* 把一个扩展 RAM 页映射到一个窗口。调用返回后映射保持,直到再次映射。
|
|
97
|
+
* 窗口 0-2 可以用来临时访问别的页;程序自己占用的窗口被换走后,里面的代码与数据在恢复前看不到。
|
|
98
|
+
* 窗口 3 里有程序的软件栈,不要映射。
|
|
99
|
+
*
|
|
100
|
+
* @syscall $29
|
|
101
|
+
* @param window 窗口号 0-3,0 是 $8000,1 是 $9000,2 是 $A000,3 是 $B000。
|
|
102
|
+
* @param page 页号。
|
|
103
|
+
*/
|
|
104
|
+
void sb_window_map(unsigned char window, unsigned char page);
|
|
105
|
+
|
|
106
|
+
/**
|
|
107
|
+
* 把页组的 4 个连续页映射到 4 个窗口($8000-$BFFF),调用返回后映射保持。
|
|
108
|
+
* 调用者本身的代码所在的窗口也会换掉,所以新页组里同一地址要有同样的代码。
|
|
109
|
+
*
|
|
110
|
+
* @syscall $27
|
|
111
|
+
* @param group 页组的首页号。
|
|
112
|
+
*/
|
|
113
|
+
void sb_window_map_group(unsigned char group);
|
|
114
|
+
|
|
115
|
+
#endif
|
|
@@ -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
|