fcdev 0.1.0 → 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/README.md +3 -2
- package/package.json +3 -3
- package/src/api/header-parser.mjs +78 -0
- package/src/api/index.mjs +128 -0
- package/src/build/bank-link-config.mjs +74 -0
- package/src/build/index.mjs +1 -0
- package/src/build/program-builder.mjs +5 -2
- package/src/cli/commands/api-command.mjs +62 -0
- package/src/cli/index.mjs +3 -0
- package/src/targets/target-registry.mjs +38 -0
- package/targets/nes/lib/fcnes.lib +0 -0
- package/targets/nes/lib/nes-font.o +0 -0
- package/targets/sb2000/api-reference.md +3295 -0
- package/targets/sb2000/api-unwrapped.json +36 -0
- package/targets/sb2000/asminc/sb2000.inc +203 -1
- package/targets/sb2000/include/sb2000-bank.h +74 -0
- package/targets/sb2000/include/sb2000-clock.h +68 -0
- package/targets/sb2000/include/sb2000-disk.h +141 -0
- package/targets/sb2000/include/sb2000-display.h +352 -0
- package/targets/sb2000/include/sb2000-file.h +273 -0
- package/targets/sb2000/include/sb2000-ime.h +158 -0
- package/targets/sb2000/include/sb2000-input.h +192 -0
- package/targets/sb2000/include/sb2000-math.h +228 -0
- package/targets/sb2000/include/sb2000-memory.h +115 -0
- package/targets/sb2000/include/sb2000-printer.h +116 -0
- package/targets/sb2000/include/sb2000-sound.h +134 -0
- package/targets/sb2000/include/sb2000-symbols.h +397 -1
- package/targets/sb2000/include/sb2000-system.h +219 -0
- package/targets/sb2000/include/sb2000-text.h +99 -0
- package/targets/sb2000/include/sb2000.h +13 -20
- package/targets/sb2000/lib/crt0.o +0 -0
- package/targets/sb2000/lib/sb2000.lib +0 -0
- package/targets/sb2000/lib-build.json +1 -1
- package/targets/sb2000/link-banked.cfg +42 -0
- package/targets/sb2000/src/crt0.s +89 -4
- package/targets/sb2000/src/lib/bank/sb-bank-current.c +18 -0
- package/targets/sb2000/src/lib/bank/sb-bank-select.c +21 -0
- package/targets/sb2000/src/lib/bank/sbi-bank-trampoline.s +46 -0
- package/targets/sb2000/src/lib/clock/sb-clock-get-date.c +17 -0
- package/targets/sb2000/src/lib/clock/sb-clock-get-time.c +17 -0
- package/targets/sb2000/src/lib/clock/sb-clock-set-date.c +21 -0
- package/targets/sb2000/src/lib/clock/sb-clock-set-time.c +17 -0
- package/targets/sb2000/src/lib/clock/sbi-date-from-fat.c +20 -0
- package/targets/sb2000/src/lib/clock/sbi-date-to-fat.c +24 -0
- package/targets/sb2000/src/lib/clock/sbi-time-from-fat.c +20 -0
- package/targets/sb2000/src/lib/clock/sbi-time-to-fat.c +19 -0
- package/targets/sb2000/src/lib/disk/sb-disk-format-track.c +18 -0
- package/targets/sb2000/src/lib/disk/sb-disk-free-bytes.c +38 -0
- package/targets/sb2000/src/lib/disk/sb-disk-init.c +16 -0
- package/targets/sb2000/src/lib/disk/sb-disk-read-sector.c +24 -0
- package/targets/sb2000/src/lib/disk/sb-disk-read-sectors.c +17 -0
- package/targets/sb2000/src/lib/disk/sb-disk-scan-track.c +27 -0
- package/targets/sb2000/src/lib/disk/sb-disk-start.c +16 -0
- package/targets/sb2000/src/lib/disk/sb-disk-stop.c +16 -0
- package/targets/sb2000/src/lib/disk/sb-disk-write-sector.c +19 -0
- package/targets/sb2000/src/lib/disk/sb-disk-write-sectors.c +17 -0
- package/targets/sb2000/src/lib/disk/sbi-disk-batch.c +23 -0
- package/targets/sb2000/src/lib/disk/sbi-disk-call.c +17 -0
- package/targets/sb2000/src/lib/disk/sbi-disk-set-position.c +18 -0
- package/targets/sb2000/src/lib/display/sb-cell-address.c +20 -0
- package/targets/sb2000/src/lib/display/sb-cells-copy.c +27 -0
- package/targets/sb2000/src/lib/display/sb-cells-fill.c +25 -0
- package/targets/sb2000/src/lib/display/sb-cells-rect.c +20 -0
- package/targets/sb2000/src/lib/display/sb-display-mode.c +16 -0
- package/targets/sb2000/src/lib/display/sb-glyph-address.c +28 -0
- package/targets/sb2000/src/lib/display/sb-image-fill-rect.c +26 -0
- package/targets/sb2000/src/lib/display/sb-image-load-raw.c +22 -0
- package/targets/sb2000/src/lib/display/sb-image-show-full.c +20 -0
- package/targets/sb2000/src/lib/display/sb-image-show.c +25 -0
- package/targets/sb2000/src/lib/display/sb-image-unpack-map.c +28 -0
- package/targets/sb2000/src/lib/display/sb-image-unpack-tiles.c +20 -0
- package/targets/sb2000/src/lib/display/sb-image-unpack-to-memory.c +22 -0
- package/targets/sb2000/src/lib/display/sb-palette-write.c +20 -0
- package/targets/sb2000/src/lib/display/sb-screen-clear.c +19 -0
- package/targets/sb2000/src/lib/display/sb-screen-flush.c +16 -0
- package/targets/sb2000/src/lib/display/sb-text-draw.c +22 -0
- package/targets/sb2000/src/lib/display/sb-text-field-ascii.c +25 -0
- package/targets/sb2000/src/lib/display/sb-text-field.c +25 -0
- package/targets/sb2000/src/lib/display/sb-text-to-memory.c +27 -0
- package/targets/sb2000/src/lib/display/sb-vram-bank.c +17 -0
- package/targets/sb2000/src/lib/display/sb-vram-fill.c +21 -0
- package/targets/sb2000/src/lib/display/sb-vram-load.c +21 -0
- package/targets/sb2000/src/lib/display/sb-window-compact.c +16 -0
- package/targets/sb2000/src/lib/display/sb-window-init.c +16 -0
- package/targets/sb2000/src/lib/display/sb-window-restore.c +17 -0
- package/targets/sb2000/src/lib/display/sb-window-save.c +21 -0
- package/targets/sb2000/src/lib/file/sb-dir-change.c +21 -0
- package/targets/sb2000/src/lib/file/sb-dir-current.c +27 -0
- package/targets/sb2000/src/lib/file/sb-dir-make.c +21 -0
- package/targets/sb2000/src/lib/file/sb-dir-open.c +61 -0
- package/targets/sb2000/src/lib/file/sb-dir-read.c +87 -0
- package/targets/sb2000/src/lib/file/sb-dir-remove.c +21 -0
- package/targets/sb2000/src/lib/file/sb-file-close.c +21 -0
- package/targets/sb2000/src/lib/file/sb-file-delete.c +21 -0
- package/targets/sb2000/src/lib/file/sb-file-get-attr.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-get-date.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-get-time.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-load.c +50 -0
- package/targets/sb2000/src/lib/file/sb-file-open.c +26 -0
- package/targets/sb2000/src/lib/file/sb-file-read.c +52 -0
- package/targets/sb2000/src/lib/file/sb-file-rename.c +30 -0
- package/targets/sb2000/src/lib/file/sb-file-save.c +31 -0
- package/targets/sb2000/src/lib/file/sb-file-set-attr.c +22 -0
- package/targets/sb2000/src/lib/file/sb-file-set-date.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-set-time.c +22 -0
- package/targets/sb2000/src/lib/file/sb-file-size.c +27 -0
- package/targets/sb2000/src/lib/file/sb-file-write-all.c +32 -0
- package/targets/sb2000/src/lib/file/sb-file-write.c +60 -0
- package/targets/sb2000/src/lib/file/sbi-dir-state.c +15 -0
- package/targets/sb2000/src/lib/file/sbi-dos-call.c +17 -0
- package/targets/sb2000/src/lib/file/sbi-load-sector.c +18 -0
- package/targets/sb2000/src/lib/file/sbi-select-handle.c +20 -0
- package/targets/sb2000/src/lib/file/sbi-set-path.c +26 -0
- package/targets/sb2000/src/lib/ime/sb-ime-get-method.c +17 -0
- package/targets/sb2000/src/lib/ime/sb-ime-get-state.c +18 -0
- package/targets/sb2000/src/lib/ime/sb-ime-hex.c +20 -0
- package/targets/sb2000/src/lib/ime/sb-ime-init.c +26 -0
- package/targets/sb2000/src/lib/ime/sb-ime-key-wait.c +19 -0
- package/targets/sb2000/src/lib/ime/sb-ime-key.c +19 -0
- package/targets/sb2000/src/lib/ime/sb-ime-parse.c +23 -0
- package/targets/sb2000/src/lib/ime/sb-ime-resume.c +16 -0
- package/targets/sb2000/src/lib/ime/sb-ime-select.c +19 -0
- package/targets/sb2000/src/lib/ime/sb-ime-set-state.c +18 -0
- package/targets/sb2000/src/lib/ime/sb-ime-set-width.c +16 -0
- package/targets/sb2000/src/lib/ime/sb-ime-suspend.c +16 -0
- package/targets/sb2000/src/lib/input/sb-break-disable.c +16 -0
- package/targets/sb2000/src/lib/input/sb-break-enable.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-count.c +17 -0
- package/targets/sb2000/src/lib/input/sb-key-flush.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-init.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-modifiers.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-poll.c +17 -0
- package/targets/sb2000/src/lib/input/sb-key-wait.c +17 -0
- package/targets/sb2000/src/lib/input/sb-keyboard-reset.c +17 -0
- package/targets/sb2000/src/lib/input/sb-mouse-buttons.c +21 -0
- package/targets/sb2000/src/lib/input/sb-mouse-position.c +18 -0
- package/targets/sb2000/src/lib/input/sb-mouse-reset.c +17 -0
- package/targets/sb2000/src/lib/input/sb-mouse-set-double-click.c +17 -0
- package/targets/sb2000/src/lib/input/sb-mouse-set-limits.c +26 -0
- package/targets/sb2000/src/lib/input/sb-mouse-set-position.c +18 -0
- package/targets/sb2000/src/lib/input/sb-pad-init.c +17 -0
- package/targets/sb2000/src/lib/input/sb-pad-poll.c +17 -0
- package/targets/sb2000/src/lib/input/sb-pad-state.c +16 -0
- package/targets/sb2000/src/lib/input/sb-pad-wait.c +17 -0
- package/targets/sb2000/src/lib/math/sb-float-add.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-div.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-from-text.c +18 -0
- package/targets/sb2000/src/lib/math/sb-float-mul.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-sub.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-to-text.c +19 -0
- package/targets/sb2000/src/lib/math/sb-int24-add.c +21 -0
- package/targets/sb2000/src/lib/math/sb-int24-div.c +26 -0
- package/targets/sb2000/src/lib/math/sb-int24-mul.c +20 -0
- package/targets/sb2000/src/lib/math/sb-int24-sub.c +21 -0
- package/targets/sb2000/src/lib/math/sb-int40-from-text.c +19 -0
- package/targets/sb2000/src/lib/math/sb-int40-to-text.c +27 -0
- package/targets/sb2000/src/lib/math/sb-line-step.c +21 -0
- package/targets/sb2000/src/lib/math/sb-math-div16.c +27 -0
- package/targets/sb2000/src/lib/math/sb-math-time-text.c +21 -0
- package/targets/sb2000/src/lib/math/sb-random-next.c +20 -0
- package/targets/sb2000/src/lib/math/sb-random-seed.c +19 -0
- package/targets/sb2000/src/lib/math/sb-random-warm-up.c +16 -0
- package/targets/sb2000/src/lib/math/sbi-peek.c +20 -0
- package/targets/sb2000/src/lib/math/sbi-poke.c +20 -0
- package/targets/sb2000/src/lib/memory/sb-address-to-far.c +20 -0
- package/targets/sb2000/src/lib/memory/sb-far-read-byte.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-far-read.c +36 -0
- package/targets/sb2000/src/lib/memory/sb-far-write-byte.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-far-write.c +36 -0
- package/targets/sb2000/src/lib/memory/sb-page-alloc.c +19 -0
- package/targets/sb2000/src/lib/memory/sb-page-free.c +19 -0
- package/targets/sb2000/src/lib/memory/sb-page-largest-free.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-window-map-group.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-window-map.c +18 -0
- package/targets/sb2000/src/lib/memory/sbi-far-copy-in.s +17 -0
- package/targets/sb2000/src/lib/memory/sbi-far-copy-out.s +17 -0
- package/targets/sb2000/src/lib/memory/sbi-far-read-byte.s +19 -0
- package/targets/sb2000/src/lib/memory/sbi-far-write-byte.s +17 -0
- package/targets/sb2000/src/lib/printer/sb-printer-carriage-return.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-feed.c +17 -0
- package/targets/sb2000/src/lib/printer/sb-printer-graphics-mode.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-home.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-init-port.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-page-left.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-page-length.c +17 -0
- package/targets/sb2000/src/lib/printer/sb-printer-position.c +18 -0
- package/targets/sb2000/src/lib/printer/sb-printer-reset.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-send-byte.c +18 -0
- package/targets/sb2000/src/lib/printer/sb-printer-text.c +29 -0
- package/targets/sb2000/src/lib/sb-internal.h +111 -0
- package/targets/sb2000/src/lib/sound/sb-sound-effect-from.c +19 -0
- package/targets/sb2000/src/lib/sound/sb-sound-play-from.c +18 -0
- package/targets/sb2000/src/lib/sound/sb-sound-play-wav-from.c +18 -0
- package/targets/sb2000/src/lib/sound/sb-sound-play-wav.c +16 -0
- package/targets/sb2000/src/lib/sound/sb-sound-repeat-wav-from.c +19 -0
- package/targets/sb2000/src/lib/sound/sb-sound-status.c +17 -0
- package/targets/sb2000/src/lib/sound/sb-sound-stop.c +16 -0
- package/targets/sb2000/src/lib/sound/sb-sound-tempo.c +17 -0
- package/targets/sb2000/src/lib/sound/sb-sound-transpose.c +17 -0
- package/targets/sb2000/src/lib/sound/sb-speech-off.c +16 -0
- package/targets/sb2000/src/lib/sound/sb-speech-send-entry-from.c +21 -0
- package/targets/sb2000/src/lib/sound/sb-speech-send-from.c +19 -0
- package/targets/sb2000/src/lib/sound/sb-speech-send.c +16 -0
- package/targets/sb2000/src/lib/system/sb-call-banked.c +19 -0
- package/targets/sb2000/src/lib/system/sb-context-restore.c +16 -0
- package/targets/sb2000/src/lib/system/sb-context-save.c +19 -0
- package/targets/sb2000/src/lib/system/sb-display-off.c +16 -0
- package/targets/sb2000/src/lib/system/sb-display-on.c +16 -0
- package/targets/sb2000/src/lib/system/sb-display-option.c +18 -0
- package/targets/sb2000/src/lib/system/sb-exec.c +22 -0
- package/targets/sb2000/src/lib/system/sb-irq-enable.c +19 -0
- package/targets/sb2000/src/lib/system/sb-irq-hook-reset.c +20 -0
- package/targets/sb2000/src/lib/system/sb-irq-hook-set.c +39 -0
- package/targets/sb2000/src/lib/system/sb-irq-mask.c +19 -0
- package/targets/sb2000/src/lib/system/sb-jump-banked.s +25 -0
- package/targets/sb2000/src/lib/system/sb-nmi-disable.c +16 -0
- package/targets/sb2000/src/lib/system/sb-nmi-enable.c +16 -0
- package/targets/sb2000/src/lib/system/sb-nmi-hook-reset.c +20 -0
- package/targets/sb2000/src/lib/system/sb-nmi-hook-set.c +33 -0
- package/targets/sb2000/src/lib/system/sb-nmi-service.c +19 -0
- package/targets/sb2000/src/lib/system/sb-stack-pointer.s +18 -0
- package/targets/sb2000/src/lib/system/sb-system-init.c +16 -0
- package/targets/sb2000/src/lib/system/sb-system-state.c +20 -0
- package/targets/sb2000/src/lib/system/sb-wait-frames.s +19 -0
- package/targets/sb2000/src/lib/system/sbi-exec-run.s +43 -0
- package/targets/sb2000/src/lib/system/sbi-interrupts-off.s +19 -0
- package/targets/sb2000/src/lib/system/sbi-interrupts-restore.s +17 -0
- package/targets/sb2000/src/lib/text/sb-beep.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-column.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-left.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-right.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-row.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-set-column.c +18 -0
- package/targets/sb2000/src/lib/text/sb-cursor-up.c +16 -0
- package/targets/sb2000/src/lib/text/sb-print-hex.c +22 -0
- package/targets/sb2000/src/lib/text/sb-print-uint.c +25 -0
- package/targets/sb2000/src/lib/text/sb-print.c +35 -0
- package/targets/sb2000/src/lib/text/sb-putc.c +26 -0
- package/targets/sb2000/src/sb2000.s +0 -3
- package/targets/sb2000/target.json +14 -0
|
@@ -0,0 +1,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
|
|
@@ -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
|