全局基础设置

简介

全局基础设置支持KUI的一些基础功能,例如:

APP的唯一标识设置NC软件版本页面尺寸和标题栏APP的快捷入口APP显示的名称APP所在目录名称APP的默认进入页面设置页面内默认选项

APP的唯一标识

UUID(Universally Unique Identifier,通用唯一识别码)是一种128位(16字节)的数字标识符,作为APP在系统内部的唯一标识。

两个不同的APP需设置不同的uuid。在程序开头设置set_uuid("")并执行程序后,终端自动生成一个可用的uuid,需手动添加到程序开头。一般一个APP设置一个固定的uuid,无需重复设置。

set_uuid('j6Hr5QQXmxs3yLELrKL7Qq_076d')  # uuid作为app在系统的唯一标识符

注意:系统通过识别uuid去判断该APP是否是同一个APP。若两个APP使用同一个uuid,则导入系统中会覆盖之前存在的相同uuid的APP。

设置NC软件版本

KUI和CNC软件在同步开发和更新,所以每一个版本的KUI都要配合相应版本的系统软件才能实现所有的功能。

KUI开发人员总是使用最新的KUI开发包,为了避免生成旧版CNC无法加载的APP,应使用sys_version("")函数指定目标CNC系统版本。

开发APP前,先找到使用APP的数控系统的版本(系列号_BUILD号)作为sys_version("") 函数的参数,此函数能自动识别此版本的系统软件不支持的功能,在运行Python文件时报错。如果开发者需要使用报错的功能,则必须将系统软件升级到支持的版本或者最新版本。

sys_version("V7.0.00c_58728")  # 可以识别V5.1.00c_18728版本的系统软件不支持的功能进行报错

应将此函数写在所有页面定义之前,有关KUI和CNC的兼容性问题,参见 兼容性

页面尺寸和标题栏

应将此函数写在所有页面定义之前
–10.4寸屏分辨率为800x600
–15寸屏分辨率为1024x768 (v3.4新增)

set_size(width, height, title=False)
  • width:CNC显示屏宽度方向的像素数,默认为800。
  • height:CNC显示屏高度方向的像素数,默认为600。
  • title:是否显示CNC标题栏,取值可以为TrueFalse(默认为False)
    • False时APP显示标题栏;
    • True时不显示标题栏,界面最大化。
set_size(800, 600, title=False)  # 显示屏尺寸为800×600,显示标题栏
set_size(title=True)  # 显示屏尺寸为默认值800×600,不显示标题栏
set_size(1024, 768, title=True)  # 15寸屏使用,不显示标题栏

不同尺寸屏幕标题栏和菜单栏高度以及有、无标题栏对应自定义页面布局尺寸推荐如下:

分 辨 率 题 栏 高 度 中 间 高 度 菜单栏和状态栏高度 有标题栏布局尺寸 无标题栏布局尺寸
640×480 44 372 64 640×372 640×416
800×480 36 376 68 800×376 800×412
800×600 56 456 88 800×456 800×512
1024×768 64 590 114 1024×590 1024×654

以800x600分辨率为例:下图左侧为显示标题栏的界面,右侧为不显示标题栏的界面。

有标题栏 无标题栏
with-title without-title

APP的快捷入口

使用函数shortcut_id(位置)指定此APP在数控系统中的快捷入口的位置,可取值如下(中英文都支持):

  • 位置 (ShortcutId.pos)
  • 程序 (ShortcutId.prog)
  • 刀补1 (ShortcutId.ofs1)
  • 刀补2 (ShortcutId.ofs2)
  • 设置1 (ShortcutId.set1)
  • 机床调试1 (ShortcutId.debug1)
  • 机床调试2 (ShortcutId.debug2)
  • 诊断 (ShortcutId.dgn)

例如:指定此APP在数控系统中快捷入口在位置页面下的软按键。

shortcut_id(位置)  # 此APP显示在数控系统的位置页面下

KHC系统需要添加快捷入口为“位置”,否则将开机无法自动进入该页面。

APP显示的名称

使用函数set_name("")指定此APP在系统应用中的名称,若使用快捷入口,该名称也是对应软按键的名称。

  • name: 分类名称
  • weight: 分类权重

例如:APP在应用中显示的名称为"简单示例",权重为20。其中权重值越大,该显示的位置越靠前。

APP所在目录名称

使用函数set_category("")指定此APP在系统应用中目录的名称。

  • name: 分类名称
  • weight: 分类权重

例如:APP在应用中分类显示的目录名称为"示例目录",权重为10。其中权重值越大,该显示的位置越靠前。

set_category("示例目录", weight=10)  # 此APP在数控系统中所在应用目录中显示的名称
set_name("简单示例", weight=20)  # 此APP在数控系统中显示的名称

APP的默认进入页面

每个APP都有一个默认页面,也就是首页,为防止进入页面混乱需定义一个APP的默认页面。使用函数set_default_page("")指定该应用默认进入的页面,类似之前版本的根目录,需在("")中填写默认页面的id。

例如:默认进入的页面为id=“main"的页面。

set_default_page("main")

应将此函数需写在所有页面page定义之前。

设置页面内默认选项

这一部分函数为APP中若干个页面的控件设定一些默认值,包括控件颜色、字体大小和对齐方式,如果控件和页面中没有设定参数的值将采用默认值。下面函数的作用范围从函数调用处开始到再一次调用或文件结尾为止。可用来为n个相邻的页面定义同一默认值。

合理的默认值可以简化代码的书写

  • 设置n个相邻的页面所有控件默认颜色字体大小对齐方式
    default_attr(白色, f24x16, 左对齐)  #设置n个相邻的页面所有控件默认颜色为白色,字体大小为f24x16,对齐方式为左对齐
    
  • 设置n个相邻的页面文本默认颜色字体大小对齐方式
    default_text_attr(红色, f24x12, 居中)  # 表示n个相邻的页面所有静态文本默认颜色为红色,字体大小为f24x12,对齐方式为居中
    
  • 设置n个相邻的页面数据值默认颜色字体大小
    default_data_attr(黄色, f20x10)   #表示n个相邻的页面所有数据的默认颜色为黄色,字体为f20x10