Lua函数

add_txt #

在控制台输出文本信息

语法 #

add_txt(文本)
add_txt(文本, 是否警告)

参数 #

• 文本 – 要输出的内容(必填)
• 是否警告 – true 显示警告, false 普通消息(选填,默认 false)
  警告模式会让底部的 <设置> 按钮红色闪动,提示用户有新的信息输出

示例 #

-- 普通消息
add_txt("开始执行程序")

-- 警告消息
add_txt("温度过高!", true)

send_gcode #

发送G代码到命令队列(不等待执行完成)

语法 #

send_gcode(G代码)

参数 #

• G代码 – 要发送的G代码字符串(必填)

示例 #

-- 发送移动指令
send_gcode("G0 X10 Y20")

-- 发送多条指令(不等待)
send_gcode("G0 X0 Y0")
send_gcode("G1 Z-5 F100")
-- 程序会继续执行,不等待G代码完成

send_gcode_wait #

发送G代码并等待执行完成

语法 #

send_gcode_wait(G代码)

参数 #

• G代码 – 要发送的G代码字符串(必填)

示例 #

-- 发送移动指令并等待完成
send_gcode_wait("G0 X10 Y20")
add_txt("移动完成")  -- 等G代码执行完才会执行这句

-- 顺序执行多条指令
send_gcode_wait("G0 X0 Y0")   -- 等待完成
send_gcode_wait("G1 Z-5 F100") -- 等待完成
add_txt("所有指令执行完成")

get_language #

获取当前系统语言

语法 #

get_language()

参数 #

无参数

返回值 #

• “zh” – 中文
• “en” – 英文

示例 #

-- 获取当前语言
local lang = get_language()

-- 根据语言显示不同消息
if lang == "zh" then
    add_txt("这是中文提示")
elseif lang == "en" then
    add_txt("This is English message")
end

message_box #

显示消息对话框

语法 #

message_box(消息内容)
message_box(消息内容, 确认按钮文本)
result = message_box(消息内容, 确认按钮文本, 取消按钮文本)

参数 #

• 消息内容 – 对话框显示的主要信息(必填)
• 确认按钮文本 – 确认按钮的显示文字(选填,默认”确认”)
• 取消按钮文本 – 取消按钮的显示文字(选填,不填则只显示确认按钮)

返回值 #

• 1 – 用户点击了确认按钮
• 0 – 用户点击了取消按钮

示例 #

-- 简单提示
message_box("换刀完成!")

-- 确认对话框
local result = message_box("是否继续执行?", "是", "否")
if result == 1 then
    add_txt("用户选择继续")
else
    add_txt("用户选择取消")
end