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,141 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* ------------------------------------------------------------------------
|
|
3
|
+
* 名称:sb2000-disk.h
|
|
4
|
+
* 说明:SB-DOS 程序的软驱底层服务:按面、磁道、扇区读写,成批读写,扫描坏扇区,格式化磁道,空闲空间。
|
|
5
|
+
* 作者:sungbin
|
|
6
|
+
* 邮箱:sungbin@3578.cn
|
|
7
|
+
* 日期:2026-11-11
|
|
8
|
+
* 备注:由 sb2000.h 引入,程序不必单独包含。软驱是 1.44MB:2 个面、80 个磁道、每道 18 个扇区,扇区 512 字节;
|
|
9
|
+
* 面从 0 起,磁道从 0 起,扇区号从 1 起。直接读写扇区会绕过文件系统,写错位置会破坏磁盘上的文件,
|
|
10
|
+
* 要读写文件请用 sb2000-file.h。所有函数返回软驱状态码,0 表示成功(常见的有 SB_ERR_BAD_DISK_PARAM 参数超出范围、
|
|
11
|
+
* SB_ERR_WRITE_PROTECT 写保护、SB_ERR_NOT_READY 驱动器未准备好、SB_ERR_CRC 校验错、SB_ERR_NO_DISK 没有磁盘、SB_ERR_UNKNOWN_DISK 未知磁盘类型)。
|
|
12
|
+
* 缓冲区指针必须在程序窗口 $8000-$BFFF 里;成批读写的数据放在扩展 RAM 页里(页用 sb_page_alloc 申请,用 sb_far_read、sb_far_write 存取)。
|
|
13
|
+
* ------------------------------------------------------------------------
|
|
14
|
+
*/
|
|
15
|
+
#ifndef SB2000_DISK_H
|
|
16
|
+
#define SB2000_DISK_H
|
|
17
|
+
|
|
18
|
+
/** 一个扇区的字节数。 */
|
|
19
|
+
#define SB_DISK_SECTOR_SIZE 512
|
|
20
|
+
/** 每道的扇区数。 */
|
|
21
|
+
#define SB_DISK_SECTORS_PER_TRACK 18
|
|
22
|
+
/** 磁头(面)数。 */
|
|
23
|
+
#define SB_DISK_HEADS 2
|
|
24
|
+
/** 磁道数。 */
|
|
25
|
+
#define SB_DISK_TRACKS 80
|
|
26
|
+
|
|
27
|
+
/** 成批读写时遇到出错的扇区立即返回,状态码是该扇区的出错码。 */
|
|
28
|
+
#define SB_DISK_STOP_ON_ERROR 0x80
|
|
29
|
+
/** 成批读写时跳过出错的扇区继续,最后状态码为 0,没读到的扇区缓冲保持原样(出错被吞掉)。 */
|
|
30
|
+
#define SB_DISK_SKIP_ERRORS 0x00
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* 启动软驱并复位到 0 磁道,读出状态后停转。可用来检查驱动器是否就绪。
|
|
34
|
+
*
|
|
35
|
+
* @syscall $80/$00
|
|
36
|
+
* @return 0 成功;SB_ERR_NOT_READY 驱动器没有响应。
|
|
37
|
+
*/
|
|
38
|
+
unsigned char sb_disk_init(void);
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* 启动软驱。文件服务会自己启动与停转软驱,只有直接读写扇区时才需要。
|
|
42
|
+
*
|
|
43
|
+
* @syscall $80/$06
|
|
44
|
+
* @return 0 成功;SB_ERR_NOT_READY 驱动器未准备好。
|
|
45
|
+
*/
|
|
46
|
+
unsigned char sb_disk_start(void);
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* 让软驱停转。直接读写扇区之后调用,文件服务每次操作之后都会自己调用。
|
|
50
|
+
*
|
|
51
|
+
* @syscall $80/$07
|
|
52
|
+
*/
|
|
53
|
+
void sb_disk_stop(void);
|
|
54
|
+
|
|
55
|
+
/**
|
|
56
|
+
* 读一个扇区,先检测盘片。
|
|
57
|
+
*
|
|
58
|
+
* @syscall $80/$02
|
|
59
|
+
* @param head 面,0 或 1。
|
|
60
|
+
* @param track 磁道,0 到 79。
|
|
61
|
+
* @param sector 扇区号,1 到 18。
|
|
62
|
+
* @param dest 接收 512 字节的缓冲区,在程序窗口里。
|
|
63
|
+
* @return 0 成功;SB_ERR_NO_DISK 驱动器中没有磁盘;SB_ERR_UNKNOWN_DISK 未知磁盘类型;SB_ERR_CRC 扇区校验错。
|
|
64
|
+
*/
|
|
65
|
+
unsigned char sb_disk_read_sector(unsigned char head, unsigned char track, unsigned char sector, void *dest);
|
|
66
|
+
|
|
67
|
+
/**
|
|
68
|
+
* 写一个扇区,先检测盘片。
|
|
69
|
+
*
|
|
70
|
+
* @syscall $80/$03
|
|
71
|
+
* @param head 面,0 或 1。
|
|
72
|
+
* @param track 磁道,0 到 79。
|
|
73
|
+
* @param sector 扇区号,1 到 18。
|
|
74
|
+
* @param src 要写入的 512 字节,在程序窗口里。
|
|
75
|
+
* @return 0 成功;SB_ERR_WRITE_PROTECT 磁盘写保护;SB_ERR_NO_DISK 驱动器中没有磁盘;SB_ERR_UNKNOWN_DISK 未知磁盘类型。
|
|
76
|
+
*/
|
|
77
|
+
unsigned char sb_disk_write_sector(unsigned char head, unsigned char track, unsigned char sector, const void *src);
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* 从起始扇区连续读若干扇区到扩展 RAM 页里,扇区号递增,满 18 换面,两面满换磁道。先检测盘片。
|
|
81
|
+
*
|
|
82
|
+
* @syscall $80/$04
|
|
83
|
+
* @param head 起始面,0 或 1。
|
|
84
|
+
* @param track 起始磁道,0 到 79。
|
|
85
|
+
* @param sector 起始扇区号,1 到 18。
|
|
86
|
+
* @param page 接收数据的扩展 RAM 页号。
|
|
87
|
+
* @param page_sector 数据从页内第几个 512 字节开始放,0 到 7;每页放 8 个扇区,页要有足够的连续页。
|
|
88
|
+
* @param count 扇区数。
|
|
89
|
+
* @param mode SB_DISK_STOP_ON_ERROR 或 SB_DISK_SKIP_ERRORS,见这两个常量的说明。
|
|
90
|
+
* @return 0 成功;SB_ERR_NO_DISK 驱动器中没有磁盘;SB_ERR_CRC 等扇区出错码(mode 为 SB_DISK_STOP_ON_ERROR 时)。
|
|
91
|
+
*/
|
|
92
|
+
unsigned char sb_disk_read_sectors(unsigned char head, unsigned char track, unsigned char sector,
|
|
93
|
+
unsigned char page, unsigned char page_sector, unsigned int count, unsigned char mode);
|
|
94
|
+
|
|
95
|
+
/**
|
|
96
|
+
* 把扩展 RAM 页里的数据连续写到若干扇区,扇区号递增的规则同 sb_disk_read_sectors。先检测盘片,写保护时立即停止。
|
|
97
|
+
*
|
|
98
|
+
* @syscall $80/$05
|
|
99
|
+
* @param head 起始面,0 或 1。
|
|
100
|
+
* @param track 起始磁道,0 到 79。
|
|
101
|
+
* @param sector 起始扇区号,1 到 18。
|
|
102
|
+
* @param page 数据所在的扩展 RAM 页号。
|
|
103
|
+
* @param page_sector 数据从页内第几个 512 字节开始,0 到 7。
|
|
104
|
+
* @param count 扇区数。
|
|
105
|
+
* @param mode SB_DISK_STOP_ON_ERROR 或 SB_DISK_SKIP_ERRORS。
|
|
106
|
+
* @return 0 成功;SB_ERR_WRITE_PROTECT 磁盘写保护;SB_ERR_NO_DISK 驱动器中没有磁盘。
|
|
107
|
+
*/
|
|
108
|
+
unsigned char sb_disk_write_sectors(unsigned char head, unsigned char track, unsigned char sector,
|
|
109
|
+
unsigned char page, unsigned char page_sector, unsigned int count, unsigned char mode);
|
|
110
|
+
|
|
111
|
+
/**
|
|
112
|
+
* 逐个读一个磁道的 18 个扇区,读不出的在位图里置位。不检测盘片,直接读每个扇区。
|
|
113
|
+
*
|
|
114
|
+
* @syscall $80/$08
|
|
115
|
+
* @param head 面,0 或 1。
|
|
116
|
+
* @param track 磁道,0 到 79。
|
|
117
|
+
* @param bad_map 返回 3 字节位图:第 0 字节的位 7 到位 0 依次对应扇区 1 到 8,第 1 字节对应扇区 9 到 16,第 2 字节的位 7、位 6 对应扇区 17、18;置位表示读不出。
|
|
118
|
+
* @return 0 成功;SB_ERR_BAD_DISK_PARAM 面或磁道超出范围。
|
|
119
|
+
*/
|
|
120
|
+
unsigned char sb_disk_scan_track(unsigned char head, unsigned char track, unsigned char *bad_map);
|
|
121
|
+
|
|
122
|
+
/**
|
|
123
|
+
* 格式化一个磁道:磁道 0 的 18 个扇区填 $00,其他磁道填 $F6。先检测盘片。会清掉这个磁道上的全部数据。
|
|
124
|
+
*
|
|
125
|
+
* @syscall $80/$01
|
|
126
|
+
* @param head 面,0 或 1。
|
|
127
|
+
* @param track 磁道,0 到 79。
|
|
128
|
+
* @return 0 成功;SB_ERR_BAD_DISK_PARAM 面或磁道超出范围;SB_ERR_WRITE_PROTECT 磁盘写保护;SB_ERR_NO_DISK 驱动器中没有磁盘。
|
|
129
|
+
*/
|
|
130
|
+
unsigned char sb_disk_format_track(unsigned char head, unsigned char track);
|
|
131
|
+
|
|
132
|
+
/**
|
|
133
|
+
* 取磁盘上的空闲字节数(空闲簇数乘每簇字节数)。
|
|
134
|
+
*
|
|
135
|
+
* @syscall $7B/$01、$7B/$06
|
|
136
|
+
* @param bytes 返回空闲字节数。
|
|
137
|
+
* @return 0 成功;其他是读 FAT 时的磁盘出错码。
|
|
138
|
+
*/
|
|
139
|
+
unsigned char sb_disk_free_bytes(unsigned long *bytes);
|
|
140
|
+
|
|
141
|
+
#endif
|
|
@@ -0,0 +1,352 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* ------------------------------------------------------------------------
|
|
3
|
+
* 名称:sb2000-display.h
|
|
4
|
+
* 说明:SB-DOS 程序的显示服务:屏幕单元(名称表缓冲)的读写与清屏、文字显示、字模查询、窗口保存与还原、调色板、显存 DMA 与填充、图片解压与显示。
|
|
5
|
+
* 作者:sungbin
|
|
6
|
+
* 邮箱:sungbin@3578.cn
|
|
7
|
+
* 日期:2026-11-11
|
|
8
|
+
* 备注:由 sb2000.h 引入,程序不必单独包含。屏幕是 32 列 × 30 行的单元,每个单元 2 字节(低字节在前,高 4 位是调色板),一行 64 字节;
|
|
9
|
+
* 名称表缓冲在扩展 RAM 页 $FA(表 0、1,偏移 $000、$800)与页 $FB(表 2、3),写缓冲后再经 DMA 刷新到显存,所以屏幕要等刷新才变。
|
|
10
|
+
* 字符串与图片数据的位置:带 group 的函数用“页组 + 窗口地址”表示(约定同 sb_call_banked);不带 group 的函数要求数据在程序自己的窗口里。
|
|
11
|
+
* 这些服务换页后程序窗口里放的是别的页,函数内部已用“页组 + 窗口地址”的方式把数据带给系统,调用者只需保证数据在程序窗口里。
|
|
12
|
+
* 显示字模写进显存的图块区时,不要覆盖 DOS 屏幕正在用的图块(DOS 文字区从图块 0 起),程序要自己选用不冲突的图块号(如 $0300 以后)。
|
|
13
|
+
* ------------------------------------------------------------------------
|
|
14
|
+
*/
|
|
15
|
+
#ifndef SB2000_DISPLAY_H
|
|
16
|
+
#define SB2000_DISPLAY_H
|
|
17
|
+
|
|
18
|
+
/** 屏幕的列数。 */
|
|
19
|
+
#define SB_SCREEN_COLUMNS 32
|
|
20
|
+
/** 屏幕的行数。 */
|
|
21
|
+
#define SB_SCREEN_ROWS 30
|
|
22
|
+
|
|
23
|
+
/** 窗口保存失败:坐标超出屏幕或右下角小于左上角。 */
|
|
24
|
+
#define SB_WINDOW_BAD_RECT 0xFD
|
|
25
|
+
/** 窗口保存失败:30 个窗口已用完。 */
|
|
26
|
+
#define SB_WINDOW_TOO_MANY 0xFE
|
|
27
|
+
/** 窗口保存失败:保存区装不下。 */
|
|
28
|
+
#define SB_WINDOW_NO_ROOM 0xFF
|
|
29
|
+
|
|
30
|
+
/** 映射流与铺满矩形的参数。 */
|
|
31
|
+
typedef struct {
|
|
32
|
+
/** 名称表号,0 到 3。 */
|
|
33
|
+
unsigned char table;
|
|
34
|
+
/** 矩形左上角的列。 */
|
|
35
|
+
unsigned char col;
|
|
36
|
+
/** 矩形左上角的行。 */
|
|
37
|
+
unsigned char row;
|
|
38
|
+
/** 矩形宽,列数。 */
|
|
39
|
+
unsigned char width;
|
|
40
|
+
/** 矩形高,行数。 */
|
|
41
|
+
unsigned char height;
|
|
42
|
+
/** 效果号 0 到 8:0 逐行向下、1 逐列向右、2 逐列向左、3 逐行向下(带等待)、4 逐行向上、5 边框收缩后向外扩展、6 边框向内、7 从中线向两边、8 从两边向中线。 */
|
|
43
|
+
unsigned char effect;
|
|
44
|
+
/** 速度:不小于 5 时每步刷新并等 speed-5 帧,小于 5 时每 6-speed 步刷新一次。 */
|
|
45
|
+
unsigned char speed;
|
|
46
|
+
/** 调色板号 0 到 15。 */
|
|
47
|
+
unsigned char palette;
|
|
48
|
+
/** 单元基础值(图块号),映射流里的值加上它。 */
|
|
49
|
+
unsigned int base;
|
|
50
|
+
} sb_map_t;
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* 从指定位置起线性地(先列后行,到行尾接下一行)把 count 个单元写成同一个值,写完刷新一次名称表到显存。
|
|
54
|
+
*
|
|
55
|
+
* @syscall $40
|
|
56
|
+
* @param table 名称表号,0 到 3。
|
|
57
|
+
* @param col 起点列,0 到 31。
|
|
58
|
+
* @param row 起点行,0 到 29。
|
|
59
|
+
* @param count 单元个数,不要超过名称表里剩下的单元数;0 会被当作 65536,不要用。
|
|
60
|
+
* @param cell 单元值,低 12 位是图块号,高 4 位被调色板号替换。
|
|
61
|
+
* @param palette 调色板号,0 到 15。
|
|
62
|
+
*/
|
|
63
|
+
void sb_cells_fill(unsigned char table, unsigned char col, unsigned char row, unsigned int count, unsigned int cell, unsigned char palette);
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* 把一个矩形区域的单元写成同一个值,每行刷新一次。
|
|
67
|
+
*
|
|
68
|
+
* @syscall $40
|
|
69
|
+
* @param table 名称表号,0 到 3。
|
|
70
|
+
* @param col 左上角列。
|
|
71
|
+
* @param row 左上角行。
|
|
72
|
+
* @param width 宽,列数,列加宽不超过 32。
|
|
73
|
+
* @param height 高,行数,行加高不超过 30。
|
|
74
|
+
* @param cell 单元值,低 12 位是图块号。
|
|
75
|
+
* @param palette 调色板号,0 到 15。
|
|
76
|
+
*/
|
|
77
|
+
void sb_cells_rect(unsigned char table, unsigned char col, unsigned char row, unsigned char width, unsigned char height, unsigned int cell, unsigned char palette);
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* 把程序窗口里的一块单元数据逐行复制到屏幕,写完刷新一次名称表。
|
|
81
|
+
*
|
|
82
|
+
* @syscall $40
|
|
83
|
+
* @param table 名称表号,0 到 3。
|
|
84
|
+
* @param col 左上角列。
|
|
85
|
+
* @param row 左上角行。
|
|
86
|
+
* @param width 宽,列数。
|
|
87
|
+
* @param height 高,行数。
|
|
88
|
+
* @param cells 单元数据,width × height 个,按行排列,在程序窗口里;单元值原样写入,不替换调色板位。
|
|
89
|
+
*/
|
|
90
|
+
void sb_cells_copy(unsigned char table, unsigned char col, unsigned char row, unsigned char width, unsigned char height, const unsigned int *cells);
|
|
91
|
+
|
|
92
|
+
/**
|
|
93
|
+
* 清屏:把屏幕缓冲里指定名称表的全部单元填成同一个值(只写缓冲,不刷新显存)。
|
|
94
|
+
*
|
|
95
|
+
* @syscall $30/$0A
|
|
96
|
+
* @param tables 位掩码,位 0 到 3 依次对应名称表 0 到 3(缓冲里的名称表 4 到 7)。
|
|
97
|
+
* @param cell 单元值。
|
|
98
|
+
*/
|
|
99
|
+
void sb_screen_clear(unsigned char tables, unsigned int cell);
|
|
100
|
+
|
|
101
|
+
/**
|
|
102
|
+
* 把一张名称表缓冲经 DMA 写到显存,并等一帧。
|
|
103
|
+
*
|
|
104
|
+
* @syscall $30/$00-$03
|
|
105
|
+
* @param table 名称表号,0 到 3。
|
|
106
|
+
*/
|
|
107
|
+
void sb_screen_flush(unsigned char table);
|
|
108
|
+
|
|
109
|
+
/**
|
|
110
|
+
* 求屏幕缓冲里一个单元的远地址,可以交给 sb_far_read、sb_far_write 读写。
|
|
111
|
+
*
|
|
112
|
+
* @syscall $30/$04-$07
|
|
113
|
+
* @param table 名称表号,0 到 3。
|
|
114
|
+
* @param col 列。
|
|
115
|
+
* @param row 行。
|
|
116
|
+
* @param page 返回页号。
|
|
117
|
+
* @param offset 返回页内偏移。
|
|
118
|
+
*/
|
|
119
|
+
void sb_cell_address(unsigned char table, unsigned char col, unsigned char row, unsigned char *page, unsigned int *offset);
|
|
120
|
+
|
|
121
|
+
/**
|
|
122
|
+
* 在屏幕上显示一行文字(可混排汉字与西文):把字符串画成点阵写进显存的图块,再把上下两行单元写进名称表缓冲并刷新。
|
|
123
|
+
* 汉字占 2 列;宽度限制在 32 列以内,汉字起点离右边界不足 2 列时不画。
|
|
124
|
+
* 二平面模式下,上行第 k 列的单元值是 cell + 2k,下行再加 1。
|
|
125
|
+
*
|
|
126
|
+
* @syscall $45
|
|
127
|
+
* @param table 名称表号,0 到 3。
|
|
128
|
+
* @param col 起点列。
|
|
129
|
+
* @param row 起点行,文字占上下两行。
|
|
130
|
+
* @param text 以 0 结尾的字符串,在程序窗口里。
|
|
131
|
+
* @param cell 起始图块号(单元值的低 12 位),文字的字模写进显存从它起的图块。
|
|
132
|
+
* @param palette 调色板号,0 到 15。
|
|
133
|
+
* @param color 前景色 0 到 15:每一位决定一个平面里字模是否出现。
|
|
134
|
+
*/
|
|
135
|
+
void sb_text_field(unsigned char table, unsigned char col, unsigned char row, const char *text, unsigned int cell, unsigned char palette, unsigned char color);
|
|
136
|
+
|
|
137
|
+
/**
|
|
138
|
+
* 同 sb_text_field,但只处理单字节字符,不补空白图块,只写一行单元:第 i 列的单元值是 cell + 步长 × i;步长在大字体(8×16 字模,DOS 的默认)下是 2,小字体下是 1。
|
|
139
|
+
*
|
|
140
|
+
* @syscall $46
|
|
141
|
+
* @param table 名称表号,0 到 3。
|
|
142
|
+
* @param col 起点列。
|
|
143
|
+
* @param row 行。
|
|
144
|
+
* @param text 以 0 结尾的字符串,在程序窗口里。
|
|
145
|
+
* @param cell 起始图块号。
|
|
146
|
+
* @param palette 调色板号,0 到 15。
|
|
147
|
+
* @param color 前景色 0 到 15。
|
|
148
|
+
*/
|
|
149
|
+
void sb_text_field_ascii(unsigned char table, unsigned char col, unsigned char row, const char *text, unsigned int cell, unsigned char palette, unsigned char color);
|
|
150
|
+
|
|
151
|
+
/**
|
|
152
|
+
* 把字符串画成点阵图块,经 DMA 写进显存的图块区(目的地址 = 图块号 × 16),不写名称表。
|
|
153
|
+
* 返回后 $064C/$064D 被换算成字节地址(图块号 × 16)。
|
|
154
|
+
*
|
|
155
|
+
* @syscall $3C、$3D、$3E、$3F
|
|
156
|
+
* @param tile 起始图块号。
|
|
157
|
+
* @param text 字符串,在程序窗口里。
|
|
158
|
+
* @param terminator 结束符,读到该字节为止。
|
|
159
|
+
* @param color 前景色 0 到 15:每一位决定一个平面里字模是否出现。
|
|
160
|
+
* @param four_planes 0 画二平面图块(每个 16 字节),非 0 画四平面图块(每个 32 字节)。
|
|
161
|
+
* @param ascii_only 0 处理汉字与西文,非 0 只处理单字节字符。
|
|
162
|
+
*/
|
|
163
|
+
void sb_text_draw(unsigned int tile, const char *text, unsigned char terminator, unsigned char color, unsigned char four_planes, unsigned char ascii_only);
|
|
164
|
+
|
|
165
|
+
/**
|
|
166
|
+
* 把字符串画成点阵图块,写进调用者指定的扩展 RAM 地址(不经显存)。每个图块二平面 16 字节、四平面 32 字节,按平面顺序各 8 字节;
|
|
167
|
+
* 汉字占两个图块宽。目的区装不下下一个字符时在该字符之前停止。目的区跨 4KB 页时窗口 2、3 的映射随之后移,输出线性连续。
|
|
168
|
+
*
|
|
169
|
+
* @syscall $47、$48
|
|
170
|
+
* @param text 字符串,在程序窗口里。
|
|
171
|
+
* @param terminator 结束符,读到该字节为止(汉字比较第一个字节)。
|
|
172
|
+
* @param group 目的页组的首页号。
|
|
173
|
+
* @param address 目的窗口地址($8000 到 $FFFF,高 4 位选页,低 12 位是页内偏移),页号 = (高 4 位) - 8 + group。
|
|
174
|
+
* @param capacity 目的区还能容纳的字节数。
|
|
175
|
+
* @param four_planes 0 画二平面图块,非 0 画四平面图块。
|
|
176
|
+
* @param color 前景色 0 到 15。
|
|
177
|
+
* @param ascii_only 0 处理汉字与西文,非 0 只处理单字节字符。
|
|
178
|
+
* @return 实际写入的字节数。
|
|
179
|
+
*/
|
|
180
|
+
unsigned int sb_text_to_memory(const char *text, unsigned char terminator, unsigned char group, unsigned int address, unsigned int capacity, unsigned char four_planes, unsigned char color, unsigned char ascii_only);
|
|
181
|
+
|
|
182
|
+
/**
|
|
183
|
+
* 设置显示模式(显示模式影子 $0638 的高 2 位,决定文字字库区域的取法),低 6 位不变。
|
|
184
|
+
*
|
|
185
|
+
* @syscall $11/$00-$03
|
|
186
|
+
* @param mode 显示模式 0 到 3,对应高 2 位 $00、$40、$80、$C0。
|
|
187
|
+
*/
|
|
188
|
+
void sb_display_mode(unsigned char mode);
|
|
189
|
+
|
|
190
|
+
/**
|
|
191
|
+
* 查字符码对应的字模所在的页与页内地址,不绘制。字符码高字节为 0 时 $20 到 $7F 取西文字模(8×8 或 8×16,由显示模式决定),
|
|
192
|
+
* 高字节不小于 $A1 时按 GB2312 区位处理:$A1 到 $A9 区是符号,$B0 到 $F7 区是汉字(32 字节,前 16 字节是每行左半边,后 16 字节是右半边)。
|
|
193
|
+
*
|
|
194
|
+
* @syscall $3B
|
|
195
|
+
* @param code 字符码,西文放低字节,汉字是 GB2312 内码。
|
|
196
|
+
* @param page 返回字模所在的页。
|
|
197
|
+
* @param offset 返回字模在页内的偏移。
|
|
198
|
+
* @param shape 返回字模形式(低 3 位)。
|
|
199
|
+
* @return 0 成功;$FF 字符码不合法。
|
|
200
|
+
*/
|
|
201
|
+
unsigned char sb_glyph_address(unsigned int code, unsigned char *page, unsigned int *offset, unsigned char *shape);
|
|
202
|
+
|
|
203
|
+
/**
|
|
204
|
+
* 初始化窗口管理:30 个窗口号全部空闲,保存区末尾回到 $8060。程序开始用窗口之前调用一次。
|
|
205
|
+
*
|
|
206
|
+
* @syscall $59/$06
|
|
207
|
+
*/
|
|
208
|
+
void sb_window_init(void);
|
|
209
|
+
|
|
210
|
+
/**
|
|
211
|
+
* 把名称表缓冲里的一个矩形保存起来,以后用 sb_window_restore 原样写回。只保存缓冲,不碰显存。
|
|
212
|
+
*
|
|
213
|
+
* @syscall $59/$00-$03
|
|
214
|
+
* @param table 名称表号,0 到 3。
|
|
215
|
+
* @param left 左上角列。
|
|
216
|
+
* @param top 左上角行。
|
|
217
|
+
* @param right 右下角列(含),小于 32。
|
|
218
|
+
* @param bottom 右下角行(含),小于 30。
|
|
219
|
+
* @return 窗口号 1 到 30;SB_WINDOW_BAD_RECT 坐标不合法;SB_WINDOW_TOO_MANY 窗口用完;SB_WINDOW_NO_ROOM 保存区装不下,出错时窗口表与保存区不变。
|
|
220
|
+
*/
|
|
221
|
+
unsigned char sb_window_save(unsigned char table, unsigned char left, unsigned char top, unsigned char right, unsigned char bottom);
|
|
222
|
+
|
|
223
|
+
/**
|
|
224
|
+
* 把保存的窗口内容写回名称表缓冲并释放窗口号。只写缓冲,不刷新显存,要用 sb_screen_flush 刷新。
|
|
225
|
+
* 窗口号不小于 $1F 或表里没有时什么都不做。只有释放的是表里最后一项时才回收保存区,否则留下空洞,要用 sb_window_compact 整理。
|
|
226
|
+
*
|
|
227
|
+
* @syscall $59/$04
|
|
228
|
+
* @param id 窗口号。
|
|
229
|
+
*/
|
|
230
|
+
void sb_window_restore(unsigned char id);
|
|
231
|
+
|
|
232
|
+
/**
|
|
233
|
+
* 整理窗口保存区:没有窗口时末尾回到 $8060,否则把后面的数据前移填掉空洞。
|
|
234
|
+
* 注意:第一个窗口之后的空洞,系统修正表项的方式只在空洞大小恰等于前一个窗口长度时才正确,其他情况会让表项指向乱数据,不要在窗口之间有空洞时使用。
|
|
235
|
+
*
|
|
236
|
+
* @syscall $59/$05
|
|
237
|
+
*/
|
|
238
|
+
void sb_window_compact(void);
|
|
239
|
+
|
|
240
|
+
/**
|
|
241
|
+
* 把一组颜色写进调色板,从调色板第 offset 项起。显示开着且 NMI 开着时由 NMI 处理程序写入。
|
|
242
|
+
*
|
|
243
|
+
* @syscall $5D
|
|
244
|
+
* @param offset 起始项,调色板共 64 项。
|
|
245
|
+
* @param colors 颜色字节,在程序窗口里。
|
|
246
|
+
* @param count 个数,0 什么都不做。
|
|
247
|
+
*/
|
|
248
|
+
void sb_palette_write(unsigned char offset, const unsigned char *colors, unsigned char count);
|
|
249
|
+
|
|
250
|
+
/**
|
|
251
|
+
* 用一个字节填充显存的一段。长度为 0 什么都不做。
|
|
252
|
+
*
|
|
253
|
+
* @syscall $32
|
|
254
|
+
* @param address 显存起始地址。
|
|
255
|
+
* @param length 长度,字节。
|
|
256
|
+
* @param value 填充值。
|
|
257
|
+
*/
|
|
258
|
+
void sb_vram_fill(unsigned int address, unsigned int length, unsigned char value);
|
|
259
|
+
|
|
260
|
+
/**
|
|
261
|
+
* 把扩展 RAM 里的一段数据经 DMA 写进显存。长度为 0 什么都不做。
|
|
262
|
+
*
|
|
263
|
+
* @syscall $33
|
|
264
|
+
* @param page 源数据所在的扩展 RAM 页。
|
|
265
|
+
* @param offset 源数据在页内的偏移。
|
|
266
|
+
* @param address 显存目的地址。
|
|
267
|
+
* @param length 长度,字节。
|
|
268
|
+
*/
|
|
269
|
+
void sb_vram_load(unsigned char page, unsigned int offset, unsigned int address, unsigned int length);
|
|
270
|
+
|
|
271
|
+
/**
|
|
272
|
+
* 设置显存 bank 寄存器($4300)。
|
|
273
|
+
*
|
|
274
|
+
* @syscall $2A
|
|
275
|
+
* @param bank 要写入的值。
|
|
276
|
+
*/
|
|
277
|
+
void sb_vram_bank(unsigned char bank);
|
|
278
|
+
|
|
279
|
+
/**
|
|
280
|
+
* 不解压,直接把一段图案数据经 DMA 写进显存的图块区(目的地址 = 图块号 × 16),再等垂直消隐。长度为 0 直接返回。
|
|
281
|
+
*
|
|
282
|
+
* @syscall $5A
|
|
283
|
+
* @param data 图案数据,在程序窗口里。
|
|
284
|
+
* @param length 长度,字节。
|
|
285
|
+
* @param tile 起始图块号。
|
|
286
|
+
*/
|
|
287
|
+
void sb_image_load_raw(const void *data, unsigned int length, unsigned int tile);
|
|
288
|
+
|
|
289
|
+
/**
|
|
290
|
+
* 解压图案流并经 DMA 写进显存的图块区。流的格式:16 字节字典加指令流,指令字节 $00 结束;
|
|
291
|
+
* 指令字节高 4 位 H、低 4 位 L:H 为 1 到 12 把字典第 L 项重复 H 次,H=$D 后跟 L 个原样字节,H=$E 后跟 1 个字节重复 L 次,H=$F 后跟起始字节输出 L 个递增字节。
|
|
292
|
+
*
|
|
293
|
+
* @syscall $5B
|
|
294
|
+
* @param stream 图案流,在程序窗口里。
|
|
295
|
+
* @param tile 起始图块号。
|
|
296
|
+
*/
|
|
297
|
+
void sb_image_unpack_tiles(const void *stream, unsigned int tile);
|
|
298
|
+
|
|
299
|
+
/**
|
|
300
|
+
* 解压映射流并按效果写进屏幕:流里的单元值加上 map->base 与调色板位,再按效果把矩形写进名称表缓冲并刷新到显存。
|
|
301
|
+
* 指令字节高 3 位 T、低 5 位 N:$00 结束;T=0 取一个 16 位值填 N 个;T=1 取一个值,N 个单元依次加 1;T=2 取 N 个 16 位值;T=3 先取一个高字节再取 N 个低字节;T 不小于 4 取一个值,N 个单元依次加 2。
|
|
302
|
+
* 矩形限制在 32×32 内,起点列或行不小于 32 或宽高为 0 时什么都不写。
|
|
303
|
+
*
|
|
304
|
+
* @syscall $5C
|
|
305
|
+
* @param stream 映射流,在程序窗口里。
|
|
306
|
+
* @param map 写到屏幕的位置、效果与速度。
|
|
307
|
+
*/
|
|
308
|
+
void sb_image_unpack_map(const void *stream, const sb_map_t *map);
|
|
309
|
+
|
|
310
|
+
/**
|
|
311
|
+
* 用与 sb_image_unpack_map 相同的效果把一个单元值(map->base)铺满矩形,不加调色板位。
|
|
312
|
+
*
|
|
313
|
+
* @syscall $60
|
|
314
|
+
* @param map 矩形、效果与速度;base 是单元值。
|
|
315
|
+
*/
|
|
316
|
+
void sb_image_fill_rect(const sb_map_t *map);
|
|
317
|
+
|
|
318
|
+
/**
|
|
319
|
+
* 显示压缩图片:10 字节头 [宽、高、图案数(16 位)、调色板组数、每组色数、映射流偏移(16 位)、调色板偏移(16 位)](偏移相对头的起点),
|
|
320
|
+
* 先解压图案流(头后,图块号取 map->base),再写调色板(偏移 = 调色板组号 × 每组色数,长度 = 头里的组数 × 每组色数),最后按映射流、位置、效果与速度显示。
|
|
321
|
+
*
|
|
322
|
+
* @syscall $5F
|
|
323
|
+
* @param image 图片数据(头加图案流、映射流、调色板),在程序窗口里。
|
|
324
|
+
* @param map 位置、效果、速度;base 是图案的起始图块号。
|
|
325
|
+
* @param palette_group 调色板组号。
|
|
326
|
+
*/
|
|
327
|
+
void sb_image_show(const void *image, const sb_map_t *map, unsigned char palette_group);
|
|
328
|
+
|
|
329
|
+
/**
|
|
330
|
+
* 显示整屏图片:头格式同 sb_image_show;图案流解压到起始图块 tile,映射流直接按顺序解到名称表缓冲的开头(单元基础值是 tile,不加调色板位),
|
|
331
|
+
* 解完整张名称表 DMA 一次,调色板从第 0 项起写 $40 字节。
|
|
332
|
+
*
|
|
333
|
+
* @syscall $5E
|
|
334
|
+
* @param image 图片数据,在程序窗口里。
|
|
335
|
+
* @param tile 起始图块号。
|
|
336
|
+
* @param table 名称表号,0 到 3。
|
|
337
|
+
*/
|
|
338
|
+
void sb_image_show_full(const void *image, unsigned int tile, unsigned char table);
|
|
339
|
+
|
|
340
|
+
/**
|
|
341
|
+
* 把图案流解压到内存,格式同 sb_image_unpack_tiles。目的地址 address 是窗口地址($8000 到 $FFFF,高 4 位选页,低 12 位是页内偏移),
|
|
342
|
+
* 页号 = (address 高 4 位) - 8 + group;目的页与下一页映射到窗口 2、3,所以目的地址线性连续。
|
|
343
|
+
*
|
|
344
|
+
* @syscall $61
|
|
345
|
+
* @param stream 图案流,在程序窗口里。
|
|
346
|
+
* @param group 目的页组的首页号。
|
|
347
|
+
* @param address 目的窗口地址。
|
|
348
|
+
* @return 解出的字节数。
|
|
349
|
+
*/
|
|
350
|
+
unsigned int sb_image_unpack_to_memory(const void *stream, unsigned char group, unsigned int address);
|
|
351
|
+
|
|
352
|
+
#endif
|