Klock Plus 是一个时钟App展示工具，可以运行在PC / CASIO fx-9860 / WinCE等平台上。
并且可以在PC上构建用户自定义的表盘。
此项目按照 BSD 协议开源。
在这里下载当前版本的 KlockPlus。包含可执行文件与构建好的样例表盘。
将KLOCKP.G1A安装在 Flash Mem，并将需要展示的表盘文件 *.kwf 放置在 Flash Mem 或者 SD Card，启动程序即可展示。
因为CE.1x并不支持 GetModuleFileName API。所以需要把所有KWF文件放在根目录下。在其他地方运行KlockP开头的exe即可。
在CE2.x下把exe与KWF文件放在同个目录下即可。
可以启动，但是文件不能被正确列出，请按照CE1.x的情况把KWF文件放在系统根目录下。
为了尽可能兼容更多的设备，KlockPlus在WinCE上使用了虚拟按键。实体按键的功能如下：
| 实体键 | 功能 |
|---|---|
| 方向键 上 / Enter / 确认 | 显示 / 隐藏虚拟按键 |
| 方向键 下 | 翻转屏幕方向（在竖屏的设备上） |
| Tab / Esc / 取消 | 退出 App |
| W, A, S, D | 对应方向：上，下，左，右 |
| K, L | 对应功能键 A，B |
用户可以自己编写 KBasic Script并且使用KlockPlus Builder来构建KWF格式的表盘。
KBasic 是一种表达绘制流程的简单脚本语言，使用Builder构建，编译为KRT字节码（一个简单的基于堆栈的虚拟机）。
表盘 App 加载后，会后循环执行KBasic的代码，并且传入时、分、秒、毫秒等信息来执行绘制表盘，绘制的速度大约是 12 FPS。
# 打印一句提示语
print(0, 0, "Basic Clock", 1)
# 拼接字符串，格式化时分秒
let str_time = zeropad(hh, 2) & ":" & zeropad(mm, 2) & ":" & zeropad(ss, 2)
# 打印时间字符串
print(8, 12, str_time, 0)
更多的样例请参考 samples/文件夹下的kbs文件。
-
假设上面的样例保存为文件
sample0-basic.kbs。 -
在命令行输入下面的命令来构建
# -i 输入脚本文件名字 # -o 输出二进制文件名 # -d 可选选项，附加之后会打印调试信息 klockbuilder build -i sample0-basic.kbs -o sample0.kwf -
输入以下的命令来预览
# -i 输入二进制文件名字 # -d 可选选项，附加之后会打印调试信息 klockbuilder preview -i sample0.kwf当然，也可以选择直接双击
klockbuilder.exe，会弹出选择文件的对话框，选择文件来预览。
KBasic 有五种指令：
| 指令 | 样例 | 功能 | 附注 | |
|---|---|---|---|---|
| 1 | image 指令 | image "bitmap_file_name.bmp" |
加载 bmp 格式的图片 | 只接受色深为 24bit 的 bmp |
| 2 | let 指令 | let var_name = expr |
将 expr 的计算结果赋值给变量 var_name | 请注意，如果没有let在行首，会被理解为使用=（等于）操作符的表达式，并不会报错 |
| 3 | 标签指令 | label_name: |
跳转标签 | |
| 4 | goto 指令 | goto label_name |
无条件跳转到指定标签 | |
| 5 | if 指令 | if expr goto label_name |
expr 计算结果不为0时跳转到指定标签 | |
| 6 | 表达式 | zeropad(hh, 2) & ":" & zeropad(mm, 2) 1+2/sin(ms) |
可以计算的表达式 |
| 变量名 | 功能 | 附注 |
|---|---|---|
hh |
当前时间的小时 | |
mm |
当前时间的的分钟 | |
ss |
当前时间的秒 | |
ms |
当前时间的毫秒 | 受到 fx-9860 RTC 功能的限制，毫秒的精度是基于1/128秒的，需要注意。 |
表达式可以有两种值，字符串 RVT_STRING 与 数值RVT_NUMBER
| 优先级 | 操作符 | 功能 | 样例 |
|---|---|---|---|
| 500 | - | 取负数 | -a -1.5 |
| 200 | * | 乘法 | a * b |
| 200 | / | 除法 | a / b |
| 200 | % | 取模 | a % b |
| 200 | \ | 整数除法 | a \ b |
| 100 | + | 加法 | a + b |
| 100 | - | 减法 | a - b |
| 90 | & | 字符串连接 | "hello " & "world & 2" |
| 60 | > | 大于 | a > b |
| 60 | < | 小于 | a < b |
| 60 | >= | 大于等于 | a >= b |
| 60 | <= | 小于等于 | a <= b |
| 50 | = | 等于 | a = b |
| 50 | <> | 不等于 | a <> b |
| 50 | ! | 逻辑非 | !a |
| 40 | && | 逻辑与 | a && b |
| 30 | || | 逻辑或 | `a |
| 函数标号 | 函数声明 | 返回值 | 附注 |
|---|---|---|---|
| 0 | sin(a) | RVT_NUMBER |
正弦 |
| 1 | cos(a) | RVT_NUMBER |
余弦 |
| 2 | tan(a) | RVT_NUMBER |
正切 |
| 3 | sqrt(a) | RVT_NUMBER |
平方根 |
| 4 | exp(a) | RVT_NUMBER |
指数 |
| 5 | abs(a) | RVT_NUMBER |
e为底的指数函数 |
| 6 | log(a) | RVT_NUMBER |
对数 |
| 7 | rand() | RVT_NUMBER |
范围在区间[0, 1)的随机数 |
| 8 | clr() | RVT_NUMBER |
清除屏幕内容。总是返回 0 |
| 9 | zeropad(num, digits) | RVT_STRING |
将数值转化为字符串，长度不足的时候在前方补充0 |
| 10 | printmini(x, y, str, rev) | RVT_NUMBER |
打印字符串，字体尺寸4x6。总是返回 0 |
| 11 | print(x, y, str, rev) | RVT_NUMBER |
打印字符串，字体尺寸6x8。总是返回 0 |
| 12 | gprint(x, y, str, image_index) | RVT_NUMBER |
将指定的图片当做包含字符:与字符0-9的字体，打印字符串总是返回 0 |
| 13 | line(x0, y0, x1, y1, dot) | RVT_NUMBER |
画线，dot为1是黑色，dot为0时白色。总是返回 0 |
| 14 | blt(x, y, image_index) | RVT_NUMBER |
在指定位置绘制图片。总是返回 0 |
| 15 | p(expr) | RVT_NUMBER |
在控制台输出参数的内容，只在pc上有效。总是返回 0 |
| 16 | gprintv(x, y, str, image_index) | RVT_NUMBER |
与gprint功能相同，但是打印方向是竖向。 总是返回 0 |
我为fx-9860GII设计了可以3D打印的表带：
可以真的把fx-9860当做手表戴在手腕上，稍后你可以在Thingiverse上找到它。
此项目的 KlockPlus Builder 使用了 SDL，并在分发时附带了 SDL.dll。如果想要自己修改、构建 KlockPlus Builder，需要在你的工具链中安装SDL 1.2。
此项目的字体使用了 Portfolio 6x8 与 Tom Thumb 4x6。
此项目的吉祥物：狗大哈 · Husky The Big。记得谢谢狗大哈！