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,273 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* ------------------------------------------------------------------------
|
|
3
|
+
* 名称:sb2000-file.h
|
|
4
|
+
* 说明:SB-DOS 程序的文件与目录服务:打开、关闭、读写、整个文件加载与保存、删除、改名、属性、目录。
|
|
5
|
+
* 作者:sungbin
|
|
6
|
+
* 邮箱:sungbin@3578.cn
|
|
7
|
+
* 日期:2026-11-11
|
|
8
|
+
* 备注:由 sb2000.h 引入,程序不必单独包含。磁盘是 1.44MB 的 FAT12 软盘,文件名是 8.3 格式(大写),
|
|
9
|
+
* 路径最长 28 个字符,可带驱动器 A: 与反斜杠,目录只支持一级子目录;同时最多打开 4 个文件,句柄号 0 到 3。
|
|
10
|
+
* 所有函数返回 DOS 出错码,0 表示成功,结果经指针参数带回。路径字符串必须在程序窗口 $8000-$BFFF 里。
|
|
11
|
+
* 文件数据在扩展 RAM 页里中转:sb_file_read、sb_file_write 内部临时借用 1 页,sb_file_load、sb_file_save 的数据直接放在页里。
|
|
12
|
+
* ------------------------------------------------------------------------
|
|
13
|
+
*/
|
|
14
|
+
#ifndef SB2000_FILE_H
|
|
15
|
+
#define SB2000_FILE_H
|
|
16
|
+
|
|
17
|
+
/** 文件属性:只读。 */
|
|
18
|
+
#define SB_ATTR_READONLY 0x01
|
|
19
|
+
/** 文件属性:隐藏。 */
|
|
20
|
+
#define SB_ATTR_HIDDEN 0x02
|
|
21
|
+
/** 文件属性:系统。 */
|
|
22
|
+
#define SB_ATTR_SYSTEM 0x04
|
|
23
|
+
/** 文件属性:卷标。 */
|
|
24
|
+
#define SB_ATTR_VOLUME 0x08
|
|
25
|
+
/** 文件属性:目录。 */
|
|
26
|
+
#define SB_ATTR_DIRECTORY 0x10
|
|
27
|
+
/** 文件属性:存档。 */
|
|
28
|
+
#define SB_ATTR_ARCHIVE 0x20
|
|
29
|
+
|
|
30
|
+
/** sb_dir_read 返回它表示已经没有更多的项。 */
|
|
31
|
+
#define SB_DIR_END 0xFF
|
|
32
|
+
|
|
33
|
+
/** 目录项。 */
|
|
34
|
+
typedef struct {
|
|
35
|
+
/** 名称,格式 NAME.EXT,没有扩展名时没有点,零结尾。 */
|
|
36
|
+
char name[13];
|
|
37
|
+
/** 属性,SB_ATTR_ 开头的常量按位组合。 */
|
|
38
|
+
unsigned char attr;
|
|
39
|
+
/** 修改日期。 */
|
|
40
|
+
sb_date_t date;
|
|
41
|
+
/** 修改时间。 */
|
|
42
|
+
sb_time_t time;
|
|
43
|
+
/** 文件大小,字节。 */
|
|
44
|
+
unsigned long size;
|
|
45
|
+
} sb_dir_entry_t;
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* 打开文件或目录项。打开方式用 SB_MODE_ 开头的常量:
|
|
49
|
+
* SB_MODE_OPEN 打开已有文件(只读);SB_MODE_CREATE 创建文件,已存在则覆盖;
|
|
50
|
+
* SB_MODE_UPDATE 打开已有文件,可按偏移写,关闭时写回目录项;SB_MODE_ENTRY 取得根目录或子目录的目录项。
|
|
51
|
+
* 相对路径在当前目录里找。
|
|
52
|
+
*
|
|
53
|
+
* @syscall $7B/$09
|
|
54
|
+
* @param path 路径,零结尾,最长 28 个字符。
|
|
55
|
+
* @param mode 打开方式。
|
|
56
|
+
* @param handle 返回句柄号,0 到 3。
|
|
57
|
+
* @return 0 成功;SB_ERR_FILE_NOT_FOUND 文件不存在;SB_ERR_PATH_NOT_FOUND 目录不存在;SB_ERR_TOO_MANY_FILES 4 个句柄都在用;
|
|
58
|
+
* SB_ERR_BAD_NAME 名称含非法字符或路径过长;SB_ERR_BAD_OPEN_MODE 打开方式不合法;SB_ERR_ACCESS_DENIED 名称与卷标同名。
|
|
59
|
+
*/
|
|
60
|
+
unsigned char sb_file_open(const char *path, unsigned char mode, unsigned char *handle);
|
|
61
|
+
|
|
62
|
+
/**
|
|
63
|
+
* 关闭文件,写回目录项,并让软驱停转。关闭空闲的句柄什么都不做,也不出错。
|
|
64
|
+
*
|
|
65
|
+
* @syscall $7C/$02
|
|
66
|
+
* @param handle 句柄号。
|
|
67
|
+
* @return 0 成功;SB_ERR_BAD_PARAMETER 句柄号超出 0-3。
|
|
68
|
+
*/
|
|
69
|
+
unsigned char sb_file_close(unsigned char handle);
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* 取文件大小。
|
|
73
|
+
*
|
|
74
|
+
* @syscall $7C/$0D
|
|
75
|
+
* @param handle 句柄号。
|
|
76
|
+
* @param size 返回文件大小,字节。
|
|
77
|
+
* @return 0 成功。
|
|
78
|
+
*/
|
|
79
|
+
unsigned char sb_file_size(unsigned char handle, unsigned long *size);
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* 从文件的指定位置读数据到内存,长度不限(内部分块读)。
|
|
83
|
+
*
|
|
84
|
+
* @syscall $7C/$05
|
|
85
|
+
* @param handle 句柄号,打开方式要是 SB_MODE_OPEN、SB_MODE_CREATE 或 SB_MODE_UPDATE。
|
|
86
|
+
* @param offset 文件内偏移。
|
|
87
|
+
* @param dest 目的地,必须在程序窗口 $8000-$BFFF 内,且不在窗口 3($B000-$BFFF)。
|
|
88
|
+
* @param length 字节数;偏移不小于文件大小或偏移加长度超过文件大小时出错,数据不会被截短读入。
|
|
89
|
+
* @return 0 成功;$14 读写位置超出文件;SB_ERR_BAD_OPEN_MODE 打开方式不允许读;SB_ERR_NO_MEMORY 没有空闲页做中转。
|
|
90
|
+
*/
|
|
91
|
+
unsigned char sb_file_read(unsigned char handle, unsigned long offset, void *dest, unsigned int length);
|
|
92
|
+
|
|
93
|
+
/**
|
|
94
|
+
* 改写文件里已有的一段数据,文件大小不变(内部分块写)。不能用它扩大文件或新建文件,那些用 sb_file_write_all 或 sb_file_save。
|
|
95
|
+
*
|
|
96
|
+
* @syscall $7C/$06
|
|
97
|
+
* @param handle 句柄号,打开方式要是 SB_MODE_CREATE 或 SB_MODE_UPDATE。
|
|
98
|
+
* @param offset 文件内偏移。
|
|
99
|
+
* @param src 数据来源,位置的要求同 sb_file_read 的 dest。
|
|
100
|
+
* @param length 字节数。
|
|
101
|
+
* @return 0 成功;$14 写入范围超出文件当前大小;SB_ERR_BAD_OPEN_MODE 打开方式不允许写;SB_ERR_NO_MEMORY 没有空闲页做中转。
|
|
102
|
+
*/
|
|
103
|
+
unsigned char sb_file_write(unsigned char handle, unsigned long offset, const void *src, unsigned int length);
|
|
104
|
+
|
|
105
|
+
/**
|
|
106
|
+
* 把内存里的数据写成一个文件(已存在则覆盖),文件大小就是数据长度。数据先放进临时分配的扩展 RAM 页,再整个写出。
|
|
107
|
+
*
|
|
108
|
+
* @syscall $7C/$10
|
|
109
|
+
* @param path 路径。
|
|
110
|
+
* @param data 数据,位置的要求同 sb_file_read 的 dest。
|
|
111
|
+
* @param length 字节数,0 只创建空文件。
|
|
112
|
+
* @return 0 成功;SB_ERR_NO_MEMORY 没有足够的页;SB_ERR_NO_SPACE 磁盘空间不够;其他是创建与写入的出错码。
|
|
113
|
+
*/
|
|
114
|
+
unsigned char sb_file_write_all(const char *path, const void *data, unsigned int length);
|
|
115
|
+
|
|
116
|
+
/**
|
|
117
|
+
* 把整个文件读入新分配的扩展 RAM 页,适合比内存大的文件:数据在页里,用 sb_far_read 按需取出。
|
|
118
|
+
* 用完要用 sb_page_free 释放页。空文件不分配页,页号返回 0。
|
|
119
|
+
*
|
|
120
|
+
* @syscall $7C/$0F
|
|
121
|
+
* @param path 路径。
|
|
122
|
+
* @param first_page 返回第一个页号。
|
|
123
|
+
* @param size 返回文件大小,字节。
|
|
124
|
+
* @return 0 成功;SB_ERR_NO_MEMORY 没有足够的连续空闲页;其他是打开与读取的出错码。
|
|
125
|
+
*/
|
|
126
|
+
unsigned char sb_file_load(const char *path, unsigned char *first_page, unsigned long *size);
|
|
127
|
+
|
|
128
|
+
/**
|
|
129
|
+
* 把扩展 RAM 页里的数据整个写成一个文件(已存在则覆盖)。数据长度为 0 时只创建空文件。
|
|
130
|
+
*
|
|
131
|
+
* @syscall $7C/$10
|
|
132
|
+
* @param path 路径。
|
|
133
|
+
* @param first_page 数据的第一个页号。
|
|
134
|
+
* @param size 数据长度,字节,不超过 16777215。
|
|
135
|
+
* @return 0 成功;SB_ERR_NO_SPACE 磁盘空间不够,已写入的其他文件完好;其他是创建与写入的出错码。
|
|
136
|
+
*/
|
|
137
|
+
unsigned char sb_file_save(const char *path, unsigned char first_page, unsigned long size);
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
* 删除文件:目录项标为已删除并释放空间,之后软驱停转。
|
|
141
|
+
*
|
|
142
|
+
* @syscall $7C/$03
|
|
143
|
+
* @param path 路径。
|
|
144
|
+
* @return 0 成功;SB_ERR_ACCESS_DENIED 文件是只读的;SB_ERR_FILE_NOT_FOUND 文件不存在。
|
|
145
|
+
*/
|
|
146
|
+
unsigned char sb_file_delete(const char *path);
|
|
147
|
+
|
|
148
|
+
/**
|
|
149
|
+
* 给文件改名。新名称是 NAME.EXT 格式,不含目录。
|
|
150
|
+
*
|
|
151
|
+
* @syscall $7C/$04
|
|
152
|
+
* @param path 原路径。
|
|
153
|
+
* @param new_name 新名称。
|
|
154
|
+
* @return 0 成功;SB_ERR_FILE_EXISTS 新名称已存在;SB_ERR_BAD_NAME 新名称含非法字符。
|
|
155
|
+
*/
|
|
156
|
+
unsigned char sb_file_rename(const char *path, const char *new_name);
|
|
157
|
+
|
|
158
|
+
/**
|
|
159
|
+
* 取已打开文件的修改日期。
|
|
160
|
+
*
|
|
161
|
+
* @syscall $7C/$08
|
|
162
|
+
* @param handle 句柄号。
|
|
163
|
+
* @param date 返回日期。
|
|
164
|
+
* @return 0 成功。
|
|
165
|
+
*/
|
|
166
|
+
unsigned char sb_file_get_date(unsigned char handle, sb_date_t *date);
|
|
167
|
+
|
|
168
|
+
/**
|
|
169
|
+
* 设置已打开文件的修改日期,关闭时写回目录项(方式 SB_MODE_CREATE、SB_MODE_UPDATE)。
|
|
170
|
+
*
|
|
171
|
+
* @syscall $7C/$07
|
|
172
|
+
* @param handle 句柄号。
|
|
173
|
+
* @param date 新日期。
|
|
174
|
+
* @return 0 成功;SB_ERR_BAD_PARAMETER 日期不合法。
|
|
175
|
+
*/
|
|
176
|
+
unsigned char sb_file_set_date(unsigned char handle, const sb_date_t *date);
|
|
177
|
+
|
|
178
|
+
/**
|
|
179
|
+
* 取已打开文件的修改时间。
|
|
180
|
+
*
|
|
181
|
+
* @syscall $7C/$0A
|
|
182
|
+
* @param handle 句柄号。
|
|
183
|
+
* @param time 返回时间。
|
|
184
|
+
* @return 0 成功。
|
|
185
|
+
*/
|
|
186
|
+
unsigned char sb_file_get_time(unsigned char handle, sb_time_t *time);
|
|
187
|
+
|
|
188
|
+
/**
|
|
189
|
+
* 设置已打开文件的修改时间,关闭时写回目录项(方式 SB_MODE_CREATE、SB_MODE_UPDATE)。
|
|
190
|
+
*
|
|
191
|
+
* @syscall $7C/$09
|
|
192
|
+
* @param handle 句柄号。
|
|
193
|
+
* @param time 新时间。
|
|
194
|
+
* @return 0 成功;SB_ERR_BAD_PARAMETER 时间不合法。
|
|
195
|
+
*/
|
|
196
|
+
unsigned char sb_file_set_time(unsigned char handle, const sb_time_t *time);
|
|
197
|
+
|
|
198
|
+
/**
|
|
199
|
+
* 取已打开文件的属性。
|
|
200
|
+
*
|
|
201
|
+
* @syscall $7C/$0C
|
|
202
|
+
* @param handle 句柄号。
|
|
203
|
+
* @param attr 返回属性,SB_ATTR_ 开头的常量按位组合。
|
|
204
|
+
* @return 0 成功。
|
|
205
|
+
*/
|
|
206
|
+
unsigned char sb_file_get_attr(unsigned char handle, unsigned char *attr);
|
|
207
|
+
|
|
208
|
+
/**
|
|
209
|
+
* 设置已打开文件的属性,关闭时写回目录项(方式 SB_MODE_CREATE、SB_MODE_UPDATE)。
|
|
210
|
+
* 属性大于 $3F 或带卷标位时出错。只读文件不能删除,方式 SB_MODE_CREATE 打开则直接覆盖并恢复成存档属性。
|
|
211
|
+
*
|
|
212
|
+
* @syscall $7C/$0B
|
|
213
|
+
* @param handle 句柄号。
|
|
214
|
+
* @param attr 新属性。
|
|
215
|
+
* @return 0 成功;SB_ERR_BAD_PARAMETER 属性不合法。
|
|
216
|
+
*/
|
|
217
|
+
unsigned char sb_file_set_attr(unsigned char handle, unsigned char attr);
|
|
218
|
+
|
|
219
|
+
/**
|
|
220
|
+
* 创建子目录。只支持一级子目录,在子目录里再建目录出错。
|
|
221
|
+
*
|
|
222
|
+
* @syscall $7D/$02
|
|
223
|
+
* @param path 路径。
|
|
224
|
+
* @return 0 成功;SB_ERR_DIR_EXISTS 目录已存在;SB_ERR_DUPLICATE_NAME 同名文件已存在;SB_ERR_PATH_NOT_FOUND 父目录不存在;SB_ERR_DIR_TOO_DEEP 目录嵌套层数过多。
|
|
225
|
+
*/
|
|
226
|
+
unsigned char sb_dir_make(const char *path);
|
|
227
|
+
|
|
228
|
+
/**
|
|
229
|
+
* 删除空的子目录。
|
|
230
|
+
*
|
|
231
|
+
* @syscall $7D/$03
|
|
232
|
+
* @param path 路径。
|
|
233
|
+
* @return 0 成功;SB_ERR_DIR_NOT_EMPTY 目录非空;SB_ERR_ACCESS_DENIED 目录是只读的;SB_ERR_DUPLICATE_NAME 路径是文件;SB_ERR_PATH_NOT_FOUND 路径不存在。
|
|
234
|
+
*/
|
|
235
|
+
unsigned char sb_dir_remove(const char *path);
|
|
236
|
+
|
|
237
|
+
/**
|
|
238
|
+
* 设置当前目录,相对路径都以它为起点。
|
|
239
|
+
*
|
|
240
|
+
* @syscall $7B/$0B
|
|
241
|
+
* @param path 路径,根目录写 "\"。
|
|
242
|
+
* @return 0 成功;SB_ERR_PATH_NOT_FOUND 路径不存在或是文件,当前目录不变。
|
|
243
|
+
*/
|
|
244
|
+
unsigned char sb_dir_change(const char *path);
|
|
245
|
+
|
|
246
|
+
/**
|
|
247
|
+
* 取当前目录自己的名称,格式 \NAME.EXT,根目录是 \。
|
|
248
|
+
*
|
|
249
|
+
* @syscall $7D/$01
|
|
250
|
+
* @param name 返回名称,缓冲区至少 16 个字节。
|
|
251
|
+
* @return 0 成功。
|
|
252
|
+
*/
|
|
253
|
+
unsigned char sb_dir_current(char *name);
|
|
254
|
+
|
|
255
|
+
/**
|
|
256
|
+
* 开始遍历一个目录。遍历期间不要做其他磁盘操作,它们会占用同一个扇区缓冲。
|
|
257
|
+
*
|
|
258
|
+
* @syscall $7B/$01、$7B/$03、$7B/$09
|
|
259
|
+
* @param path 目录路径;写 NULL 或空字符串表示当前目录,"\" 表示根目录。
|
|
260
|
+
* @return 0 成功;SB_ERR_PATH_NOT_FOUND 目录不存在;其他是磁盘出错码。
|
|
261
|
+
*/
|
|
262
|
+
unsigned char sb_dir_open(const char *path);
|
|
263
|
+
|
|
264
|
+
/**
|
|
265
|
+
* 取下一个目录项,跳过已删除的项;卷标和子目录也会返回,用属性区分。
|
|
266
|
+
*
|
|
267
|
+
* @syscall $7B/$00、$7B/$01
|
|
268
|
+
* @param entry 返回目录项。
|
|
269
|
+
* @return 0 取到一项;SB_DIR_END 已经没有更多的项;其他是磁盘出错码。
|
|
270
|
+
*/
|
|
271
|
+
unsigned char sb_dir_read(sb_dir_entry_t *entry);
|
|
272
|
+
|
|
273
|
+
#endif
|
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* ------------------------------------------------------------------------
|
|
3
|
+
* 名称:sb2000-ime.h
|
|
4
|
+
* 说明:SB-DOS 程序的中文输入法服务:初始化与选择输入法、状态与全半角、处理按键得到汉字、十六进制与区位码转换。
|
|
5
|
+
* 作者:sungbin
|
|
6
|
+
* 邮箱:sungbin@3578.cn
|
|
7
|
+
* 日期:2026-11-11
|
|
8
|
+
* 备注:由 sb2000.h 引入,程序不必单独包含。输入法状态放在 ERAM $6900 起,状态行画在屏幕上(调用显示服务 $45)。
|
|
9
|
+
* 输入法序号:0 区位、1 全拼、2 双拼、3 五笔、4 表形、5 认知、6 自定义、7 扩充、8 图形、9 英文;3-6 需要外挂模块,7 不可选。
|
|
10
|
+
* 处理按键的结果在 sb_ime_result_t 里:flag 为 0 无输出、2 输出汉字内码(output 里每个汉字 2 个字节)、$82 按键原样传回。
|
|
11
|
+
* ------------------------------------------------------------------------
|
|
12
|
+
*/
|
|
13
|
+
#ifndef SB2000_IME_H
|
|
14
|
+
#define SB2000_IME_H
|
|
15
|
+
|
|
16
|
+
/** 输入法序号:区位。 */
|
|
17
|
+
#define SB_IME_QUWEI 0
|
|
18
|
+
/** 输入法序号:全拼。 */
|
|
19
|
+
#define SB_IME_PINYIN 1
|
|
20
|
+
/** 输入法序号:双拼。 */
|
|
21
|
+
#define SB_IME_SHUANGPIN 2
|
|
22
|
+
/** 输入法序号:英文。 */
|
|
23
|
+
#define SB_IME_ENGLISH 9
|
|
24
|
+
/** sb_ime_select 的 flags:同时核对 ERAM 里的允许位。 */
|
|
25
|
+
#define SB_IME_CHECK_ALLOWED 0x80
|
|
26
|
+
|
|
27
|
+
/** 初始化参数。 */
|
|
28
|
+
typedef struct {
|
|
29
|
+
/** 状态行所在的行号。 */
|
|
30
|
+
unsigned char row;
|
|
31
|
+
/** 状态行的图块基数,16 位。 */
|
|
32
|
+
unsigned int tile;
|
|
33
|
+
/** 状态行显示用的子功能号(选名称表等)。 */
|
|
34
|
+
unsigned char subfunction;
|
|
35
|
+
/** 状态行颜色。 */
|
|
36
|
+
unsigned char color;
|
|
37
|
+
/** 初始输入法序号,0 到 9。 */
|
|
38
|
+
unsigned char method;
|
|
39
|
+
/** 允许位(ERAM $6901)。 */
|
|
40
|
+
unsigned char allow;
|
|
41
|
+
/** 标志位(ERAM $6902)。 */
|
|
42
|
+
unsigned char flags;
|
|
43
|
+
} sb_ime_config_t;
|
|
44
|
+
|
|
45
|
+
/** 处理一个键的结果。 */
|
|
46
|
+
typedef struct {
|
|
47
|
+
/** 结果标志:0 无输出、2 输出汉字内码、$82 按键原样传回。 */
|
|
48
|
+
unsigned char flag;
|
|
49
|
+
/** 输出的内容,每个汉字 2 个字节(GB2312)。 */
|
|
50
|
+
unsigned char output[16];
|
|
51
|
+
} sb_ime_result_t;
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* 初始化输入法:记下状态行的位置与颜色,选择初始输入法,登记说明文字。
|
|
55
|
+
*
|
|
56
|
+
* @syscall $6D/$00
|
|
57
|
+
* @param config 初始化参数。
|
|
58
|
+
* @return 0 成功;1 输入法序号不小于 10、没有权限或不可选,其余参数已写入。
|
|
59
|
+
*/
|
|
60
|
+
unsigned char sb_ime_init(const sb_ime_config_t *config);
|
|
61
|
+
|
|
62
|
+
/**
|
|
63
|
+
* 选择输入法。成功时清按键队列与输入缓冲,状态行换成该输入法的名称。
|
|
64
|
+
*
|
|
65
|
+
* @syscall $6D/$01
|
|
66
|
+
* @param method 输入法序号 0 到 9;序号 3 到 6 要 ERAM $0392 里对应的位允许,7 不可选。
|
|
67
|
+
* @param flags 0,或 SB_IME_CHECK_ALLOWED 表示同时核对允许位。
|
|
68
|
+
* @return 0 成功;1 失败,状态不变。
|
|
69
|
+
*/
|
|
70
|
+
unsigned char sb_ime_select(unsigned char method, unsigned char flags);
|
|
71
|
+
|
|
72
|
+
/**
|
|
73
|
+
* 设置输入法状态:允许位与标志位(只取低 7 位,位 7 保留)。
|
|
74
|
+
*
|
|
75
|
+
* @syscall $6D/$02
|
|
76
|
+
* @param allow 允许位。
|
|
77
|
+
* @param flags 标志位。
|
|
78
|
+
*/
|
|
79
|
+
void sb_ime_set_state(unsigned char allow, unsigned char flags);
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* 取输入法状态。
|
|
83
|
+
*
|
|
84
|
+
* @syscall $6D/$08
|
|
85
|
+
* @param allow 返回允许位。
|
|
86
|
+
* @param flags 返回标志位的低 7 位。
|
|
87
|
+
*/
|
|
88
|
+
void sb_ime_get_state(unsigned char *allow, unsigned char *flags);
|
|
89
|
+
|
|
90
|
+
/**
|
|
91
|
+
* 取当前输入法序号。
|
|
92
|
+
*
|
|
93
|
+
* @syscall $6D/$07
|
|
94
|
+
* @return 序号 0 到 9。
|
|
95
|
+
*/
|
|
96
|
+
unsigned char sb_ime_get_method(void);
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* 恢复被暂停的输入法:暂停标志置位时清除它并刷新状态行,否则什么都不做。
|
|
100
|
+
*
|
|
101
|
+
* @syscall $6D/$03
|
|
102
|
+
*/
|
|
103
|
+
void sb_ime_resume(void);
|
|
104
|
+
|
|
105
|
+
/**
|
|
106
|
+
* 暂停输入法:清候选字,状态行清为空,暂停标志置位。已经暂停时什么都不做。暂停期间按键原样传回。
|
|
107
|
+
*
|
|
108
|
+
* @syscall $6D/$04
|
|
109
|
+
*/
|
|
110
|
+
void sb_ime_suspend(void);
|
|
111
|
+
|
|
112
|
+
/**
|
|
113
|
+
* 设置半角或全角:状态行文字换成“半角”或“全角”,标志位里的全角位相应清除或置位。全角时输出的半角符号会换成全角内码。
|
|
114
|
+
*
|
|
115
|
+
* @syscall $6D/$05、$6D/$06
|
|
116
|
+
* @param full 0 半角,非 0 全角。
|
|
117
|
+
*/
|
|
118
|
+
void sb_ime_set_width(unsigned char full);
|
|
119
|
+
|
|
120
|
+
/**
|
|
121
|
+
* 处理一个按键(不等待):从键盘队列取一个键交给输入法,没有键时直接返回。
|
|
122
|
+
* 输入法的热键:Alt+F1 到 Alt+F10 选输入法 0 到 9,Ctrl+F1 暂停与恢复,Ctrl+F8、Ctrl+F9 切换全角半角,数字键 1 到 5 与空格选候选字。
|
|
123
|
+
*
|
|
124
|
+
* @syscall $6D/$0B
|
|
125
|
+
* @param result 返回处理结果。
|
|
126
|
+
* @return 结果标志,同 result->flag:0 无输出,2 输出汉字内码,$82 按键原样传回。
|
|
127
|
+
*/
|
|
128
|
+
unsigned char sb_ime_key(sb_ime_result_t *result);
|
|
129
|
+
|
|
130
|
+
/**
|
|
131
|
+
* 等待并处理按键,直到输入法有结果(结果标志不为 0)才返回,没有键时一直等下去。
|
|
132
|
+
*
|
|
133
|
+
* @syscall $6D/$0A
|
|
134
|
+
* @param result 返回处理结果。
|
|
135
|
+
* @return 结果标志,同 result->flag。
|
|
136
|
+
*/
|
|
137
|
+
unsigned char sb_ime_key_wait(sb_ime_result_t *result);
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
* 把一个 16 位内码转成 4 个小写十六进制字符。
|
|
141
|
+
*
|
|
142
|
+
* @syscall $6D/$0E
|
|
143
|
+
* @param code 内码。
|
|
144
|
+
* @param text 返回 4 个字符与结尾的 0,要有 5 字节空间。
|
|
145
|
+
*/
|
|
146
|
+
void sb_ime_hex(unsigned int code, char *text);
|
|
147
|
+
|
|
148
|
+
/**
|
|
149
|
+
* 把 4 个输入字符转成汉字内码:全是数字当区位码(4 位十进制),第一个字符是 a 到 f 当 4 位十六进制内码。
|
|
150
|
+
*
|
|
151
|
+
* @syscall $6D/$0D
|
|
152
|
+
* @param chars 4 个输入字符。
|
|
153
|
+
* @param code 返回内码。
|
|
154
|
+
* @return 0 成功;1 不合法。
|
|
155
|
+
*/
|
|
156
|
+
unsigned char sb_ime_parse(const char *chars, unsigned int *code);
|
|
157
|
+
|
|
158
|
+
#endif
|
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* ------------------------------------------------------------------------
|
|
3
|
+
* 名称:sb2000-input.h
|
|
4
|
+
* 说明:SB-DOS 程序的输入:键盘、手柄、鼠标。
|
|
5
|
+
* 作者:sungbin
|
|
6
|
+
* 邮箱:sungbin@3578.cn
|
|
7
|
+
* 日期:2026-11-11
|
|
8
|
+
* 备注:由 sb2000.h 引入,程序不必单独包含。
|
|
9
|
+
* 键盘:系统把按键放进 5 个按键容量的队列(超过的丢弃),每个按键有 ASCII 码和扫描码(IBM 扫描码集 1),
|
|
10
|
+
* 功能键、方向键等没有字符的键 ASCII 码为 0;按键组合下的结果与标准 IBM 美式键盘一致。
|
|
11
|
+
* 手柄:由 NMI 每帧读取,所以 NMI 要开着;键码 $FF 表示没有键,1 号手柄 $0F(A)、$0E(B)、$0D(选择)、$0C(开始)、
|
|
12
|
+
* $0B(上)、$0A(下)、$09(左)、$08(右),2 号手柄同序为 $07-$00,同时按下多个键时取最高位的。
|
|
13
|
+
* 鼠标:模拟器与真机都把鼠标当成串口鼠标,数据在中断里解析,程序只读坐标与按键状态。
|
|
14
|
+
* ------------------------------------------------------------------------
|
|
15
|
+
*/
|
|
16
|
+
#ifndef SB2000_INPUT_H
|
|
17
|
+
#define SB2000_INPUT_H
|
|
18
|
+
|
|
19
|
+
/** 两个鼠标键的状态,下标 0 是按键 1,下标 1 是按键 2。 */
|
|
20
|
+
typedef struct {
|
|
21
|
+
/** 状态:0 没按,1 按住,2 刚松开。 */
|
|
22
|
+
unsigned char state[2];
|
|
23
|
+
/** 双击:1 表示发生了双击,读走即清。 */
|
|
24
|
+
unsigned char double_click[2];
|
|
25
|
+
/** 单击:1 表示按下后松开过,读走即清;拖动后松开不算单击。 */
|
|
26
|
+
unsigned char click[2];
|
|
27
|
+
/** 拖动:1 表示按住并移动。 */
|
|
28
|
+
unsigned char drag[2];
|
|
29
|
+
} sb_mouse_buttons_t;
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* 等待按键并返回它的 ASCII 码。
|
|
33
|
+
*
|
|
34
|
+
* @return 按键的 ASCII 码;没有字符的键(如功能键)为 0。
|
|
35
|
+
*/
|
|
36
|
+
unsigned char sb_getkey(void);
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* 等到有按键,取出它的 ASCII 码与扫描码。
|
|
40
|
+
*
|
|
41
|
+
* @syscall $6B/$04
|
|
42
|
+
* @return 低字节是 ASCII 码,高字节是扫描码。
|
|
43
|
+
*/
|
|
44
|
+
unsigned int sb_key_wait(void);
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* 不等待,取出队列里的一个按键。
|
|
48
|
+
*
|
|
49
|
+
* @syscall $6B/$03
|
|
50
|
+
* @return 低字节是 ASCII 码,高字节是扫描码;队列为空时为 0。
|
|
51
|
+
*/
|
|
52
|
+
unsigned int sb_key_poll(void);
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* 按键队列里的按键数。
|
|
56
|
+
*
|
|
57
|
+
* @syscall $6B/$06
|
|
58
|
+
* @return 按键数,0 到 5。
|
|
59
|
+
*/
|
|
60
|
+
unsigned char sb_key_count(void);
|
|
61
|
+
|
|
62
|
+
/**
|
|
63
|
+
* 清空按键队列。
|
|
64
|
+
*
|
|
65
|
+
* @syscall $6B/$05
|
|
66
|
+
*/
|
|
67
|
+
void sb_key_flush(void);
|
|
68
|
+
|
|
69
|
+
/**
|
|
70
|
+
* 复位键盘与鼠标,清空按键队列。约需几十帧。
|
|
71
|
+
*
|
|
72
|
+
* @syscall $6B/$00
|
|
73
|
+
*/
|
|
74
|
+
void sb_key_init(void);
|
|
75
|
+
|
|
76
|
+
/**
|
|
77
|
+
* 打开按 ESC 中断程序:之后按 ESC,系统取出上下文栈顶的恢复点(sb_context_save 保存的)并跳转过去。
|
|
78
|
+
*
|
|
79
|
+
* @syscall $6B/$01
|
|
80
|
+
*/
|
|
81
|
+
void sb_break_enable(void);
|
|
82
|
+
|
|
83
|
+
/**
|
|
84
|
+
* 关闭按 ESC 中断程序。
|
|
85
|
+
*
|
|
86
|
+
* @syscall $6B/$02
|
|
87
|
+
*/
|
|
88
|
+
void sb_break_disable(void);
|
|
89
|
+
|
|
90
|
+
/**
|
|
91
|
+
* 修饰键状态:位 0 右 Shift,位 1 左 Shift,位 2 Ctrl,位 3 Alt,位 4 ScrollLock,位 5 NumLock,位 6 CapsLock,位 7 Insert。
|
|
92
|
+
*
|
|
93
|
+
* @return 修饰键状态。
|
|
94
|
+
*/
|
|
95
|
+
unsigned char sb_key_modifiers(void);
|
|
96
|
+
|
|
97
|
+
/**
|
|
98
|
+
* 复位并识别键盘。复位后键盘不再上报按键,需要再调用 sb_key_init 才恢复,一般用 sb_key_init 即可。
|
|
99
|
+
*
|
|
100
|
+
* @syscall $17
|
|
101
|
+
* @return 1 通过,0 失败。
|
|
102
|
+
*/
|
|
103
|
+
unsigned char sb_keyboard_reset(void);
|
|
104
|
+
|
|
105
|
+
/**
|
|
106
|
+
* 初始化手柄状态,并打开 NMI 里读手柄的服务。
|
|
107
|
+
*
|
|
108
|
+
* @syscall $12/$85、$6A/$00
|
|
109
|
+
*/
|
|
110
|
+
void sb_pad_init(void);
|
|
111
|
+
|
|
112
|
+
/**
|
|
113
|
+
* 不等待,取一个按下的手柄键。
|
|
114
|
+
*
|
|
115
|
+
* @syscall $6A/$01
|
|
116
|
+
* @return 键码,$FF 表示没有键。
|
|
117
|
+
*/
|
|
118
|
+
unsigned char sb_pad_poll(void);
|
|
119
|
+
|
|
120
|
+
/**
|
|
121
|
+
* 等到有手柄键按下。
|
|
122
|
+
*
|
|
123
|
+
* @syscall $6A/$02
|
|
124
|
+
* @return 键码。
|
|
125
|
+
*/
|
|
126
|
+
unsigned char sb_pad_wait(void);
|
|
127
|
+
|
|
128
|
+
/**
|
|
129
|
+
* 取一个手柄的原始按键状态,由 sb_pad_poll、sb_pad_wait 更新:位 7 是 A,位 6 是 B,位 5 选择,位 4 开始,
|
|
130
|
+
* 位 3 上,位 2 下,位 1 左,位 0 右。
|
|
131
|
+
*
|
|
132
|
+
* @param pad 手柄号,0 是 1 号手柄,其他是 2 号手柄。
|
|
133
|
+
* @return 原始状态。
|
|
134
|
+
*/
|
|
135
|
+
unsigned char sb_pad_state(unsigned char pad);
|
|
136
|
+
|
|
137
|
+
/**
|
|
138
|
+
* 复位鼠标,返回鼠标是否接入。复位要尝试多次,约需几十帧;之后要用 sb_irq_enable(SB_IRQ_SOURCE_MOUSE) 允许鼠标中断,
|
|
139
|
+
* 再设置坐标范围与初始坐标。
|
|
140
|
+
*
|
|
141
|
+
* @syscall $14
|
|
142
|
+
* @return 非 0 表示鼠标已接入,0 表示没有鼠标。
|
|
143
|
+
*/
|
|
144
|
+
unsigned char sb_mouse_reset(void);
|
|
145
|
+
|
|
146
|
+
/**
|
|
147
|
+
* 设置鼠标光标坐标的范围,原有的双击间隔不变。
|
|
148
|
+
*
|
|
149
|
+
* @syscall $6C/$00
|
|
150
|
+
* @param x_min X 下限。
|
|
151
|
+
* @param y_min Y 下限。
|
|
152
|
+
* @param x_max X 上限。
|
|
153
|
+
* @param y_max Y 上限。
|
|
154
|
+
*/
|
|
155
|
+
void sb_mouse_set_limits(unsigned char x_min, unsigned char y_min, unsigned char x_max, unsigned char y_max);
|
|
156
|
+
|
|
157
|
+
/**
|
|
158
|
+
* 设置鼠标光标的坐标。
|
|
159
|
+
*
|
|
160
|
+
* @syscall $6C/$04
|
|
161
|
+
* @param x X 坐标。
|
|
162
|
+
* @param y Y 坐标。
|
|
163
|
+
*/
|
|
164
|
+
void sb_mouse_set_position(unsigned char x, unsigned char y);
|
|
165
|
+
|
|
166
|
+
/**
|
|
167
|
+
* 取鼠标光标的坐标。每收到一个数据包,坐标就加上位移,并限制在设置的范围内。
|
|
168
|
+
*
|
|
169
|
+
* @syscall $6C/$02
|
|
170
|
+
* @param x 返回 X 坐标。
|
|
171
|
+
* @param y 返回 Y 坐标。
|
|
172
|
+
*/
|
|
173
|
+
void sb_mouse_position(unsigned char *x, unsigned char *y);
|
|
174
|
+
|
|
175
|
+
/**
|
|
176
|
+
* 取两个鼠标键的状态。单击、双击读走即清。
|
|
177
|
+
*
|
|
178
|
+
* @syscall $6C/$03
|
|
179
|
+
* @param buttons 返回按键状态。
|
|
180
|
+
*/
|
|
181
|
+
void sb_mouse_buttons(sb_mouse_buttons_t *buttons);
|
|
182
|
+
|
|
183
|
+
/**
|
|
184
|
+
* 设置鼠标双击的间隔:按下后在这个间隔内再次按下算双击,间隔由定时器中断计时,默认 10。
|
|
185
|
+
* 间隔为 0 时不产生双击。
|
|
186
|
+
*
|
|
187
|
+
* @syscall $6C/$01
|
|
188
|
+
* @param interval 间隔,单位是定时器中断的次数。
|
|
189
|
+
*/
|
|
190
|
+
void sb_mouse_set_double_click(unsigned char interval);
|
|
191
|
+
|
|
192
|
+
#endif
|