Skip to content
目录

界面 GUI

这类拼图用于加载通过GUI编辑器实现的用户界面,并操作界面中的控制器,实现交互。若使用了这类拼图,在发布时注意勾选GUI模块。

创建全屏UI gui_create_adt_for_fullscreen_ui

用于从包含UI信息的json文件创建用户界面。json数据可通过加载资产scene_load_asset拼图以二进制文件方式加载,然后通过获取加载资产scene_get_loaded_from_asset拼图获取json数据。整个场景中只能有一个全屏UI。

  • 视网膜屏幕 - 用于在视网膜屏幕或高ppi(pixels per inch)屏幕上让UI显示更加清晰

创建全屏UI create_adt_for_fullscreen_ui 弃用

用于从包含UI信息的json文件创建用户界面。json数据可通过加载资产scene_load_asset拼图以二进制文件方式加载,然后通过获取加载资产scene_get_loaded_from_asset拼图获取json数据。

  • 视网膜屏幕 - 用于在视网膜屏幕或高ppi(pixels per inch)屏幕上让UI显示更加清晰

创建网格纹理 create_adt_for_mesh_texture

以投射模式创建一个新的高级动态纹理(附着在网格上),但不会为网格创建一个新的材质。需手动连接该纹理。

参数:

  • 网格 - 要应用纹理的网格
  • 宽度 - 纹理宽度
  • 高度 - 纹理高度
  • 指针移动 - 是否纹理必须捕获指针移动事件
  • JSON - 包含纹理信息的json数据

设置UI图层蒙板 set_ui_layer_mask

定义图层蒙板用于将图层仅限于场景的某些相机。

销毁全屏UI gui_dispose_fullscreen_ui

销毁全屏UI。

获取控件 gui_get_control_by_name

通过名称获取UI中的控制器。控制器是用户创建的按钮、滑块等组件。

该拼图还可用于获取网格纹理上的控件。点击该拼图齿轮图标打开高级选项,勾选开启网格纹理输入即可支持此功能。

获取控件 gui_get_control 弃用

通过名称获取UI中的控制器。控制器是用户创建的按钮、滑块等组件。

控件属性 gui_control_properties_accessors

用于设置或获取控件属性或访问器。访问器是访问对象属性时触发的回调函数,用于设置或获取对象的内部数据,用法与属性相同,在拼图中表示为"属性*"。

属性:

  • 经过光标hoverCursor - 设置或获取当经过控件时使用的光标
  • 当指针点击时onPointerClick - 当指针点击时触发事件
  • 当指针按下时onPointerDown - 当指针按下时触发事件
  • 当指针移入时onPointerEnter - 当指针移入时触发事件
  • 当指针移动时onPointerMove - 当指针移动时触发事件
  • 当指针移出时onPointerOut - 当指针移出时触发事件
  • 当指针抬起时onPointerUp - 当指针抬起时触发事件
  • 当滚轮滚动时onWheel - 当滚轮滚动时触发事件

访问器:

  • alpha - 设置或获取控件的不透明度(1为不透明;0为完全透明)
  • 颜色color - 设置或获取前景色
  • 已勾选isChecked - 设置或获取单选框是否勾选
  • 已启用isEnabled - 设置或获取控件是否启用
  • 可点击isHitTestVisible - 设置或获取控件是否可通过指针事件点击
  • 可显示isVisible - 设置或获取控件是否可见
  • 阻止指针事件isPointerBlocker - 设置或获取控件是否阻止指针事件
  • 缩放XscaleX - 设置或获取控件在X轴的缩放比例
  • 缩放YscaleY - 设置或获取控件在Y轴的缩放比例
  • 源source - 设置或获取图片地址
  • 文本text - 设置或获取要显示的文本
  • 变换中心XtransformCenterX - 设置或获取X轴的变换中心点
  • 变换中心YtransformCenterY - 设置或获取Y轴的变换中心点
  • 值value - 设置或获取当前值

还可以使用object_member拼图直接控制任何属性。

获取控件子级 gui_get_child_controls

该拼图可以根据控制器类型获取某个控制器的子级控制器。

移动控件 gui_move_control_to_vector

使控制器绑定到场景中的某个点。可实现为三维物体添加标签的效果。