高性能网站建设 pdf,网站换服务器有影响吗,佛山精品网站建设,莆田网站建设制作概述
导出变量的功能在3.x版本中也是有的#xff0c;但是4.0版本对其进行了语法上的改进。 导出变量在日常的游戏制作中提供节点的自定义参数化调节功能时非常有用#xff0c;除此之外还用于自定义资源。 本文是#xff08;Bilibili巽星石#xff09;在4.0官方文档《GDScr…概述
导出变量的功能在3.x版本中也是有的但是4.0版本对其进行了语法上的改进。 导出变量在日常的游戏制作中提供节点的自定义参数化调节功能时非常有用除此之外还用于自定义资源。 本文是Bilibili巽星石在4.0官方文档《GDScript的导出》一文基础上机翻和增补而来的。希望对大家学习4.0的语法有所帮助。
导出变量简介
Godot 4.0提供了改进版本的导出变量写法新的写法比原来3.X版本的更简单优雅实际上导出变量这部分基本是换汤不换药如果熟悉3.X版本的那么4.0的也就是改换下语法而已。 4.0将导出变量的语法纳入到了GDScript中和全局常量和函数放在一起你可以在官方文档或内置文档的GDScript中找到它们的说明。 和3.X一样导出变量修改后的值会被自动保存到场景文件.tscn或资源文件(.tres)中用于二次打开时复原。你可以在检视器面板自由的修改它们然后按一下CtrlS它们就自动随场景或资源文件保存了。 导出变量需要使用export语句来实现。基本上可以认为是在3.x的export关键字之前加了个。
export var number: int 5在上面的代码保存后当前节点的检视器面板就会出现一个自定义的属性number并且默认值为5。
此时你就可以直接在检视器面板上修改这个自定义属性的值了。比如这里改为7可以看到只要与默认值不一样属性输入框的前方就会出现一个环形箭头点击它可以快速将值恢复为默认值。 修改完自定义属性后按CtrlS保存当前场景它的值就会被保存到场景文件中了。
基本用法
关于申明和类型
如果给导出变量赋默认值GDScript将自动进行类型推断并在检视器面板显示相应的属性编辑控件。
export var number 5 # 根据给定的默认值5number将被推断为int类型
export var number2 5.0 # 根据给定的默认值5.0number2将被推断为float类型
export var string1 你好戈多4.0 # 根据给定的默认值你好戈多4.0string1将被推断为String类型也可只标明类型而不赋默认值。
export var number: int # 没有给定默认值则初始值为0以上两种方式你只能选其一要么赋初始值让GDScript自己去判断类型要么现实的申明类型只申明属性名称将会报错。
导出资源和节点类型
你也可以导出资源和节点类型的变量。
export var resource: Resource # 指定抽象的Resource资源类型
export var node: Node # 指定抽象的Node节点类型上面的代码导出了两个变量分别是Resource资源类型和Node节点类型。
区分Node和NodePath
注意Node节点类型和NodePath在检视器面板的属性编辑控件和行为几乎一模一样但是两者存储的数据是不同的。
export var node: Node # 指定抽象的Node节点类型
export var node_path: NodePath # 节点路径func _ready():print(node) # 输出btn1:Button#26407339008print(node_path) # 输出Window/btn1Node类型导出变量存储的是对节点的引用而NodePath类型导出变量存储的是节点的相对路径。 用NodePath类型变量获取节点路径后可以使用get_node()方法将路径转换为对节点的引用。
export var node_path: NodePath
var node get_node(node_path)如果要限制节点路径的节点类型可以使用export_node_path语句
export_node_path(Button) var some_button # 限制可以选择的节点类型为Button在检视器面板点击属性值编辑器的“指定…”后在弹出的对话框中可以看到除了Button类型的节点其余节点均处于不可选择的灰色状态。 当然你可以传入多个参数用于限定更多的可选节点类型。
export_node_path(Button,Label) var some_button # 限制可以选择的节点类型为Button、Label导出具体的资源类型
图片
图片是比较常用的一种资源我们可以使用preload()加载一张图片来作为导出属性的默认值。
export var face preload(res://icon.svg) # 图片这种加载的图片在3.x中类型为StreamTexture在4.0中叫做CompressedTexture2D。
export var face:CompressedTexture2D场景
指定场景也是导出变量很常用的方法只需要将导出变量的类型设定为PackedScene类型就可以。
export var scene2:PackedScene在脚本内部就可以使用变量scene2来实例化和动态加载外部的另一个场景了。 事实上导出变量允许的类型相当广泛包括所有的基本数据类型、内置节点以及资源类型自定义资源类型等。其中也有一些是特殊的用法比如字符串作为路径等。初学者建议先学习基本数据类型的导出和一些常用的特殊用法等到感觉需要深入学习一下时再进行专门的学习和练习。
字符串单行和多行文本
默认用export导出的String类型变量在检视器面板显示一个单行文本框作为属性值编辑器如果想要多行文本框则需要使用export_multiline进行申明。
export var text1:String # 默认单行文本
export_multiline var text2:String # 显示为多行文本字符串作为路径
字符串类型导出的特殊用法之一就是申明和保存路径。Godot会为其提供特殊的属性编辑控件来方便路径的引用和修改。 需要注意的一点是导出变量提供两种路径一种基于res://的相对路径或叫局部路径另一种是基于整个电脑也可以其他设备的全局路径。前者只提供资源目录下的视野而后者则可以在电脑的多个盘符之间游走。
局部路径
export_file var f_path # 文件路径基于res://
export_dir var current_dir # 文件夹路径基于res://export_file用于设置和保存一个基于res://的文件路径而export_dir可以设置和保存一个基于res://的文件夹路径。变量类型其实还是String类型只是特殊化的用于存储路径了。你可以显式的申明变量类型为String或赋默认值。
# 显式申明为字符串类型
export_file var f_path:String
export_dir var current_dir:String # 赋默认值
export_file var f_path res://22.tscn
export_dir var current_dir res://addons/export_file可以采用类似3.x的括号语法传入一个字符串参数用于筛选文件类型。
export_file(*.txt) var text # “*.txt”用于在文件对话框中过滤文件类型。全局路径
使用export_global_前缀的两个关键字就可以将导出变量申明为全局文件系统中的路径 但仅在工具模式下的脚本中起效。
export_global_file(*.png) var tool_image # 全局文件系统PNG图片类型
export_global_dir var tool_dir # 全局文件系统文件夹整数和浮点数限制属性值编辑器输入范围
默认情况下申明的整数和浮点数导出变量只会显示一个简单的SpinBox或只允许输入数值的单行文本框作为属性值编辑器。
export var num1 2 # 整数
export var num2 15.2 # 浮点数但是Godot允许在基础申明之上对数值的范围进行限制。 使用export_range将可以实现基本语法是export_range(min,max,step)三个参数分别为最小值、最大值和单次调整的最小步幅。
export_range(0, 20) var i:int # 允许0到20之间的整数值
export_range(-10, 20) var j:int # 允许-10到20之间的整数值export_range(-10, 20, 0.2) var k: float # 允许从-10到20的浮点数并将值捕捉为0.2的倍数以下部分未验证成功 只有添加提示“or_greater”和/或“or_lesser”时才能对滑块进行限制。
export_range(0, 100, 1, or_greater, or_lesser)带有缓动提示的浮动
用export_exp_easing申明一个浮点数导出变量将在检视器面板显示一个显示为缓动曲线的特殊属性值编辑器通过左右拖动可以改变数值和对应的曲线形状。显示ease()函数的可视化表示。
export_exp_easing var transition_speed颜色
日常使用直接用export申明并指定变量类型为Color类型即可下面的一些具体的用例。
export var bg_color:Color # 没有赋默认值则默认显示纯黑色
export var font_color Color(1.0,0.0,0.0) # RGB形式红色
export var font_border_color Color(1.0,0.0,0.0,0.5) # RGBA形式红色,50%不透明
export var border_color Color(green) # 颜色名形式无Alpha值绿色
export var border_color2 Color(green,0.4) # 颜色名Alpha值形式绿色,40%不透明度export var another_color1 Color.BLACK # 常量形式无Alpha值黑色
export var another_color2 Color(Color.RED) # 副本形式无Alpha值红色
export var another_color3 Color(Color.RED,0.4) # 副本Alpha值形式红色,40%不透明给定颜色值的方式是使用Color()类型的构造函数进行构造可以采用浮点数的RGB、RGBA形式带或不带Alpha值的颜色名形式还有Color类型的内置常量形式从一个颜色构造副本的形式等等。 也可以使用export_color_no_alpha申明一个Alpha值始终为1的颜色变量。
export_color_no_alpha var col: Color # 颜色将以RGB形式编辑和使用alpha值将始终为 1导出位标志bit flags 资料 bit flags在某些编程语言中也被叫做“位枚举”在Godot中大致可以理解为一种特殊的枚举类型它的特殊点在于它用于存储多个可选值的多选状态。底层是用位运算之类的实现的但是这都不重要重要的是每一种选择状态都会对应唯一的一个数值比如全不选对应0其他单个选择或多个选择状态下的值计算可能比较复杂但是其结果在整个选择中是对应唯一的一个整数值的。
我们要了解的是如何用它来判断一种复杂的选择状态。 用作位标志bit flags的整数可以在一个属性中存储多个true/false布尔值 值。通过export_flags可以将变量申明为位标志
export_flags(Fire, Water, Earth, Wind,Gold) var spell_elements 0其中每个字符串对应的数值为其位置从0开始的2的次方。
文本数值Fire20 1Water21 2Earth22 4Wind23 8Gold24 16…最大值2324294967296单选一个值的话最终结果就是该值对应的数值Fire的值为1Water为 2Earth为4Wind对应于值8。
如果是多选则为这些数值之间相加下面是spell_elements这个位枚举所对应的一些状态以及计算方法和最终结果。
选择计算最终值什么都不选00Fire201Water212Earth224Wind238Gold2416FireWater1 23FireWaterGold121619FireWaterEarthWindGold12481631
可以看到这种枚举方式在表示和判断多选状态时非常有用。
必须为每个标志提供字符串说明。在此示例中。通常应相应地定义常量例如const ELEMENT_WIND 8等等。 你也可以使用冒号显式的设定值
export_flags(Self:4, Allies:8, Foes:16) var spell_targets 0实际使用
基于张学徒的说明大致知道需要用如下的代码形式进行某种组合的判断但是对位运算相关的知识不太熟悉导致尚不能明白为何是如此做的。
enum Spell_Elements{Fire 1 0, Water 1 1, Earth 1 2, Wind 1 3,Gold 1 4
}export_flags(Fire, Water, Earth, Wind,Gold) var spell_elements 0func _ready():print(spell_elements Spell_Elements.Fire | Spell_Elements.Water)passSpell_Elements.Fire | Spell_Elements.Water判断是不是同时选择了Fire和Water。 允许的最低值为1而0表示未选择任何内容。 你也可以显示的申明每个值的数值注意只有2的次方才有效
export_flags(Self:4, Allies:8, Self and Allies:12, Foes:16) var spell_targets 0物理层、渲染和导航层
Godot4.0为项目设置中定义的物理层、渲染和导航层提供了导出注解
export_flags_2d_physics var layers_2d_physics
export_flags_2d_render var layers_2d_render
export_flags_2d_navigation var layers_2d_navigation
export_flags_3d_physics var layers_3d_physics
export_flags_3d_render var layers_3d_render
export_flags_3d_navigation var layers_3d_navigation使用位标志需要对按位运算有一定的了解。 如有疑问请改用布尔变量。
导出枚举
可以将导出属性的类型指定为一个已经申明的枚举类型比如下面这样
enum NamedEnum {THING_1, THING_2, ANOTHER_THING -1}
export var x: NamedEnumfunc _ready():print(x NamedEnum.THING_1)此时编辑器将在检视器中为导出变量x创建一个下拉选框将NamedEnum的可选值列举为为导出变量x的可选值。因为枚举本质上是多个整型常量所以导出变量x选择后也是返回相应的枚举常量值。 也可以使用export_enum将整数和字符串属性限制为特定的值列表。编辑将在检查器中创建一个小部件列举以下内容“Warrior”, “Magician和Thief”。该值将存储为整数对应于所选选项的索引(即0、1或2)。
export_enum(Warrior, Magician, Thief) var character_class: intfunc _ready():print(character_class 0)可以看到相比先申明枚举然后声明导出变量的形式export_enum无法提供优雅的代码提示和判断语句。 你也可以使用冒号添加显式值
export_enum(Slow:30, Average:60, Very Fast:200) var character_speed: int如果将导出变量类型申明为String则存储的值也是String类型。
export_enum(Warrior, Magician, Thief) var character_class: Stringfunc _ready():print(character_class Warrior)导出数组
导出的数组可以具有初始值设定项但它们必须是常量表达式。 如果导出的数组指定了从 Resource 继承的类型则该数组 可以通过拖放多个文件在检查器中设置值 立即从文件系统停靠站。 默认值必须是常量表达式。
export var a [1, 2, 3]导出的数组可以指定类型使用与以前相同的提示。
export var ints: Array[int] [1, 2, 3]
# 目前尚不支持Array[Array[float]]等嵌套类型数组。
export var two_dimensional: Array[Array] [[1.0, 2.0], [3.0, 4.0]]您可以省略缺省值但如果不赋值则该值将为null。
export var b: Array
export var scenes: Array[PackedScene]从资源继承的具有指定类型的数组可以通过以下方式设置从文件系统停靠站拖放多个文件。
export var textures: Array[Texture] []
export var scenes: Array[PackedScene] []Packed类型数组也可以工作但只初始化为空
export var vector3s PackedVector3Array()
export var strings PackedStringArray()对导出属性进行分组
可以用export_group(分组名称)语法在检查器中对导出的属性进行分组 。参数传入分组名称即可。此关键字之后的每个导出属性都将添加到该组直到另一个export_group(分组名称)语句的出现。
export_group(My Properties) # 创建属性分组
export var number 3 # 该属性将自动归于My Properties分组下export_group(My Properties2) # 创建另一个属性分组也就意为着上一个属性分组自动中断
export var number2 4 # 该属性将自动归于My Properties2分组下使用export_group()可以中断上一个分组之后的导出属性因为不再属于任何分组会直接出现在属性分类下。
export_group(My Properties) # 创建属性分组
export var number 3 # 该属性将自动归于My Properties分组下export_group() # 中断上一分组
export var number2 4 # 该属性将提升到所有组之前export_group还有第2个参数用于指定分组下属性的前缀 。
export_group(Prefixed Properties, prefix_) # 创建属性分组属性前缀为“prefix_”
# 以下3个属性都以“prefix_”作为前缀自动归入“Prefixed Properties”分组下
export var prefix_number 3
export var prefix_string
export var prefix_color Color(red)
# 出现一个不符合该分组前缀的导出属性则自动中断分组
export var aa 12
# 中断分组后出现“prefix_”前缀的导出属性则不会继续添加到组
export var prefix_color2 Color(green)可以看到在检视器上相同前缀的属性会自动隐藏统一的前缀让检视器面板看起来更简洁但是其实际对应的属性名是不变的。
创建属性子分组
属性分组不能嵌套但可以使用export_subgroup在属性分组内创建子分组。
# 分组
export_group(Prefixed Properties, prefix_)
export var prefix_number 3
export var prefix_string
export var prefix_color Color(red)
# 子分组
export_subgroup(Extra Properties)
export var string
export var flag false
export var aa 12
export var prefix_color2 Color(green)子分组也不支持嵌套也就是说在同一个export_group()之后下一个export_group()之前所有的export_subgroup()将始终是并列关系而不会出现从属关系。
# 分组
export_group(Prefixed Properties, prefix_)
export var prefix_number 3
export var prefix_string
export var prefix_color Color(red)
# 子分组2
export_subgroup(Extra Properties)
export var string
export var flag false
# 子分组2
export_subgroup(group2)
export var aa 12
export var prefix_color2 Color(green)同样可以使用export_subgroup()来中断子分组但是实际结果是直接中断了整个属性分组。之后的导出变量会提升到属性分类下。
# 分组
export_group(Prefixed Properties, prefix_)
export var prefix_number 3
export var prefix_string
export var prefix_color Color(red)
# 子分组
export_subgroup(Extra Properties)
export var string
export var flag falseexport_subgroup() # 中断子分组
export var aa 12
export var prefix_color2 Color(green)定义属性类别
默认情况下导出变量的属性分类名称是其所在代码文件的文件名。 使用export_category()可以自定义属性类别名称甚至你可以创建多个属性类别。
export_category(Main Category) # 定义属性分类
export var number 3
export var string export_category(Extra Category) # 定义属性分类2
export var flag false注意 默认检视器面板也就是属性列表是根据节点的类继承关系或称“继承链”显示属性的每个类型以属性分类的形式单独呈现由上到下首先是节点自身的类型然后是其继承的父类型然后是父类型的类型…以此类推。 而导出变量是在节点的脚本中定义的脚本继承自节点的类型所以可以算得上是该节点类型的一个子类型所以脚本变量又称“导出变量”或“导出属性”就会出现在节点类型之前。
虽然自定义属性分类很好用但是对于在某些情况下有可能干扰继承链的查看所以谨慎和收敛的使用是必要的。 从工具脚本设置导出的变量
在工具脚本模式下从脚本更改导出变量的值时检查器中的值不会自己更新。要更新它请在设置导出变量的值后调用 notify_property_list_changed()。
高级导出
不是每种类型的导出都可以在语言本身的级别上提供以避免不必要的设计复杂性。下面介绍一些或多或少可以用低级API实现的常见导出功能。 在进一步阅读之前您应该熟悉处理属性的方式以及如何使用_set()、_get()和_get_Property_list()方法自定义属性如从对象访问数据或逻辑中所述。
