summaryrefslogtreecommitdiff
path: root/doc/translations/zh_Hans.po
diff options
context:
space:
mode:
Diffstat (limited to 'doc/translations/zh_Hans.po')
-rw-r--r--doc/translations/zh_Hans.po7008
1 files changed, 4050 insertions, 2958 deletions
diff --git a/doc/translations/zh_Hans.po b/doc/translations/zh_Hans.po
index 1ec73b260a..2e9d14c0d8 100644
--- a/doc/translations/zh_Hans.po
+++ b/doc/translations/zh_Hans.po
@@ -6,12 +6,16 @@
# Haoyu Qiu <timothyqiu32@gmail.com>, 2020.
# fangxvan <2661712415@qq.com>, 2020.
# yzt <834950797@qq.com>, 2020.
+# 懵逼Kitty <m1330586660@163.com>, 2020.
+# MintSoda <lionlxh@qq.com>, 2020.
+# Gardner Belgrade <hapenia@sina.com>, 2020.
+# WangYi13 <wyi13@outlook.com>, 2020.
msgid ""
msgstr ""
"Project-Id-Version: Godot Engine class reference\n"
"Report-Msgid-Bugs-To: https://github.com/godotengine/godot\n"
-"PO-Revision-Date: 2020-06-09 13:36+0000\n"
-"Last-Translator: yzt <834950797@qq.com>\n"
+"PO-Revision-Date: 2020-08-11 14:38+0000\n"
+"Last-Translator: WangYi13 <wyi13@outlook.com>\n"
"Language-Team: Chinese (Simplified) <https://hosted.weblate.org/projects/"
"godot-engine/godot-class-reference/zh_Hans/>\n"
"Language: zh_Hans\n"
@@ -19,7 +23,7 @@ msgstr ""
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8-bit\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
-"X-Generator: Weblate 4.1-dev\n"
+"X-Generator: Weblate 4.2-dev\n"
#: doc/tools/makerst.py
msgid "Description"
@@ -113,9 +117,10 @@ msgstr ""
"支持的颜色名称与[color]中定义的常量相同。"
#: modules/gdscript/doc_classes/@GDScript.xml:55
+#, fuzzy
msgid ""
-"Returns the absolute value of parameter [code]s[/code] (i.e. unsigned value, "
-"works for integer and float).\n"
+"Returns the absolute value of parameter [code]s[/code] (i.e. positive "
+"value).\n"
"[codeblock]\n"
"# a is 1\n"
"a = abs(-1)\n"
@@ -196,12 +201,13 @@ msgstr ""
"[/codeblock]"
#: modules/gdscript/doc_classes/@GDScript.xml:114
+#, fuzzy
msgid ""
"Returns the arc tangent of [code]s[/code] in radians. Use it to get the "
"angle from an angle's tangent in trigonometry: [code]atan(tan(angle)) == "
"angle[/code].\n"
"The method cannot know in which quadrant the angle should fall. See [method "
-"atan2] if you always want an exact angle.\n"
+"atan2] if you have both [code]y[/code] and [code]x[/code].\n"
"[codeblock]\n"
"a = atan(0.5) # a is 0.463648\n"
"[/codeblock]"
@@ -215,16 +221,23 @@ msgstr ""
"[/codeblock]"
#: modules/gdscript/doc_classes/@GDScript.xml:129
+#, fuzzy
msgid ""
"Returns the arc tangent of [code]y/x[/code] in radians. Use to get the angle "
"of tangent [code]y/x[/code]. To compute the value, the method takes into "
"account the sign of both arguments in order to determine the quadrant.\n"
+"Important note: The Y coordinate comes first, by convention.\n"
"[codeblock]\n"
"a = atan2(0, -1) # a is 3.141593\n"
"[/codeblock]"
msgstr ""
+"以弧度返回 [code]y/x[/code] 的反正切。用于获取 [code]y/x[/code] 的切角。为了"
+"求解该值,该方法计算会两个参数的符号以确定象限。\n"
+"[codeblock]\n"
+"a = atan2(0, -1) # a is 3.141593\n"
+"[/codeblock]"
-#: modules/gdscript/doc_classes/@GDScript.xml:143
+#: modules/gdscript/doc_classes/@GDScript.xml:144
msgid ""
"Decodes a byte array back to a value. When [code]allow_objects[/code] is "
"[code]true[/code] decoding objects is allowed.\n"
@@ -232,26 +245,38 @@ msgid ""
"not use this option if the serialized object comes from untrusted sources to "
"avoid potential security threats (remote code execution)."
msgstr ""
+"将字节数组解码回一个值。当 [code]allow_objects[/code] 为 [/code]true[code] "
+"时,允许解码对象。\n"
+"[b]警告:[/b]反序列化过的对象可以容纳可执行的代码。如果序列化的对象来自不受信"
+"任的来源,请不要激活此选项,以避免潜在的安全威胁(指远程执行代码)。"
-#: modules/gdscript/doc_classes/@GDScript.xml:155
+#: modules/gdscript/doc_classes/@GDScript.xml:156
#: modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml:145
msgid ""
"Converts a 2D point expressed in the cartesian coordinate system (X and Y "
"axis) to the polar coordinate system (a distance from the origin and an "
"angle)."
msgstr ""
+"将以直角坐标系(X和Y轴)表示的2D点转换为以极坐标系(距原点的距离和角度)表"
+"示。"
-#: modules/gdscript/doc_classes/@GDScript.xml:164
+#: modules/gdscript/doc_classes/@GDScript.xml:165
+#, fuzzy
msgid ""
-"Rounds [code]s[/code] upward, returning the smallest integral value that is "
-"not less than [code]s[/code].\n"
+"Rounds [code]s[/code] upward (towards positive infinity), returning the "
+"smallest whole number that is not less than [code]s[/code].\n"
"[codeblock]\n"
"i = ceil(1.45) # i is 2\n"
"i = ceil(1.001) # i is 2\n"
"[/codeblock]"
msgstr ""
+"向上舍入 [code]s[/code],返回不小于 [code]s[/code] 的最小整数值。\n"
+"[codeblock]\n"
+"i = ceil(1.45) # i is 2\n"
+"i = ceil(1.001) # i is 2\n"
+"[/codeblock]"
-#: modules/gdscript/doc_classes/@GDScript.xml:177
+#: modules/gdscript/doc_classes/@GDScript.xml:178
msgid ""
"Returns a character as a String of the given Unicode code point (which is "
"compatible with ASCII code).\n"
@@ -262,8 +287,15 @@ msgid ""
"[/codeblock]\n"
"This is the inverse of [method ord]."
msgstr ""
+"返回指定Unicode编码位置的字符为字符串(这个编码位置也可以是ASCII编码)。\n"
+"[codeblock]\n"
+"a = char(65) # a is \"A\"\n"
+"a = char(65 + 32) # a is \"a\"\n"
+"a = char(8364) # a is \"€\"\n"
+"[/codeblock]\n"
+"This is the inverse of [method ord]."
-#: modules/gdscript/doc_classes/@GDScript.xml:196
+#: modules/gdscript/doc_classes/@GDScript.xml:197
msgid ""
"Clamps [code]value[/code] and returns a value not less than [code]min[/code] "
"and not more than [code]max[/code].\n"
@@ -277,8 +309,19 @@ msgid ""
"a = clamp(speed, 1, 20)\n"
"[/codeblock]"
msgstr ""
+"Clamp (钳住) [code]value[/code],返回不低于 [code]min[/code] 且不高于 "
+"[code]max[/code]的值。\n"
+"[codeblock]\n"
+"speed = 1000\n"
+"# a is 20\n"
+"a = clamp(speed, 1, 20)\n"
+"\n"
+"speed = -10\n"
+"# a is 1\n"
+"a = clamp(speed, 1, 20)\n"
+"[/codeblock]"
-#: modules/gdscript/doc_classes/@GDScript.xml:216
+#: modules/gdscript/doc_classes/@GDScript.xml:217
msgid ""
"Converts from a type to another in the best way possible. The [code]type[/"
"code] parameter uses the [enum Variant.Type] values.\n"
@@ -291,8 +334,18 @@ msgid ""
"print(a.length())\n"
"[/codeblock]"
msgstr ""
+"尽可能以最佳方式将一种类型转换为另一种类型。[code]type[/code] 参数应使用 "
+"[enum Variant.Type] 作为值。\n"
+"[codeblock]\n"
+"a = Vector2(1, 0)\n"
+"# 打印出 1\n"
+"print(a.length())\n"
+"a = convert(a, TYPE_STRING)\n"
+"# 打印出 6 ,因为 \"(1, 0)\" 是6个字符\n"
+"print(a.length())\n"
+"[/codeblock]"
-#: modules/gdscript/doc_classes/@GDScript.xml:233
+#: modules/gdscript/doc_classes/@GDScript.xml:234
msgid ""
"Returns the cosine of angle [code]s[/code] in radians.\n"
"[codeblock]\n"
@@ -301,8 +354,14 @@ msgid ""
"print(cos(PI))\n"
"[/codeblock]"
msgstr ""
+"返回角度 [code]s[/code] 为弧度。\n"
+"[codeblock]\n"
+"# 打印出 1 ,然后 -1\n"
+"print(cos(PI * 2))\n"
+"print(cos(PI))\n"
+"[/codeblock]"
-#: modules/gdscript/doc_classes/@GDScript.xml:247
+#: modules/gdscript/doc_classes/@GDScript.xml:248
msgid ""
"Returns the hyperbolic cosine of [code]s[/code] in radians.\n"
"[codeblock]\n"
@@ -310,12 +369,17 @@ msgid ""
"print(cosh(1))\n"
"[/codeblock]"
msgstr ""
+"返回 [code]s[/code] 的双曲余弦值为弧度。\n"
+"[codeblock]\n"
+"# 打印出 1.543081\n"
+"print(cosh(1))\n"
+"[/codeblock]"
-#: modules/gdscript/doc_classes/@GDScript.xml:260
+#: modules/gdscript/doc_classes/@GDScript.xml:261
msgid "Converts from decibels to linear energy (audio)."
-msgstr ""
+msgstr "从分贝转换为线性能量,即电压增益(声学范畴的)。"
-#: modules/gdscript/doc_classes/@GDScript.xml:273
+#: modules/gdscript/doc_classes/@GDScript.xml:274
msgid ""
"Returns the result of [code]value[/code] decreased by [code]step[/code] * "
"[code]amount[/code].\n"
@@ -324,43 +388,69 @@ msgid ""
"a = dectime(60, 10, 0.1))\n"
"[/codeblock]"
msgstr ""
+"返回 [code]value[/code] 减少了 [code]step[/code] * [code]amount[/code] 之后的"
+"结果.\n"
+"[codeblock]\n"
+"# a = 59\n"
+"a = dectime(60, 10, 0.1))\n"
+"[/codeblock]"
-#: modules/gdscript/doc_classes/@GDScript.xml:286
+#: modules/gdscript/doc_classes/@GDScript.xml:287
+#, fuzzy
msgid ""
-"Returns degrees converted to radians.\n"
+"Converts an angle expressed in degrees to radians.\n"
"[codeblock]\n"
"# r is 3.141593\n"
"r = deg2rad(180)\n"
"[/codeblock]"
msgstr ""
+"将角度转换为弧度。\n"
+"[codeblock]\n"
+"# r 为 3.141593\n"
+"r = deg2rad(180)\n"
+"[/codeblock]"
-#: modules/gdscript/doc_classes/@GDScript.xml:299
+#: modules/gdscript/doc_classes/@GDScript.xml:300
msgid ""
"Converts a previously converted instance to a dictionary, back into an "
"instance. Useful for deserializing."
-msgstr ""
+msgstr "将 (由实例转化而来的) 字典转换回实例。用于反序列化。"
-#: modules/gdscript/doc_classes/@GDScript.xml:310
-#: modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml:90
+#: modules/gdscript/doc_classes/@GDScript.xml:311
+#, fuzzy
msgid ""
-"Easing function, based on exponent. 0 is constant, 1 is linear, 0 to 1 is "
-"ease-in, 1+ is ease out. Negative values are in-out/out in."
+"Easing function, based on exponent. The curve values are: 0 is constant, 1 "
+"is linear, 0 to 1 is ease-in, 1+ is ease out. Negative values are in-out/out "
+"in."
msgstr ""
+"缓动函数,基于指数。[code]s[/code]是函数的x值,[code]curve[/code]为0时,函数"
+"为常数函数,1是线性函数,0到1是缓入,1+是缓出。0到-1是缓出再缓入,低于-1是缓"
+"入再缓出。"
-#: modules/gdscript/doc_classes/@GDScript.xml:319
+#: modules/gdscript/doc_classes/@GDScript.xml:320
+#, fuzzy
msgid ""
"The natural exponential function. It raises the mathematical constant [b]e[/"
"b] to the power of [code]s[/code] and returns it.\n"
-"[b]e[/b] has an approximate value of 2.71828.\n"
+"[b]e[/b] has an approximate value of 2.71828, and can be obtained with "
+"[code]exp(1)[/code].\n"
"For exponents to other bases use the method [method pow].\n"
"[codeblock]\n"
"a = exp(2) # Approximately 7.39\n"
"[/codeblock]"
msgstr ""
+"自然指数函数。返回 [b]e[/b] 的 [b]s[/b] 次幂。\n"
+"[b]e[/b]的近似值为2.71828。\n"
+"以其他底数求指数,应使用方法 [method pow]。\n"
+"[codeblock]\n"
+"a = exp(2) # 约为 7.39\n"
+"[/codeblock]"
-#: modules/gdscript/doc_classes/@GDScript.xml:333
+#: modules/gdscript/doc_classes/@GDScript.xml:334
+#, fuzzy
msgid ""
-"Rounds [code]s[/code] to the closest smaller integer and returns it.\n"
+"Rounds [code]s[/code] downward (towards negative infinity), returning the "
+"largest whole number that is not more than [code]s[/code].\n"
"[codeblock]\n"
"# a is 2.0\n"
"a = floor(2.99)\n"
@@ -370,8 +460,17 @@ msgid ""
"[b]Note:[/b] This method returns a float. If you need an integer, you can "
"use [code]int(s)[/code] directly."
msgstr ""
+"返回不大于[code]s[/code] 的最大整数。\n"
+"[codeblock]\n"
+"a = floor(2.99)\n"
+"# a is 2.0\n"
+"a = floor(-2.99)\n"
+"# a is -3.0\n"
+"[/codeblock]\n"
+"[b]注:[/b] 这个方法返回一个浮点值,如果需要返回一个整数,可以直接使用"
+"[code]int(s)[/code] 。"
-#: modules/gdscript/doc_classes/@GDScript.xml:351
+#: modules/gdscript/doc_classes/@GDScript.xml:352
msgid ""
"Returns the floating-point remainder of [code]a/b[/code], keeping the sign "
"of [code]a[/code].\n"
@@ -381,8 +480,14 @@ msgid ""
"[/codeblock]\n"
"For the integer remainder operation, use the % operator."
msgstr ""
+"返回[code]a/b[/code]的浮点型余数, 符号与 [code]a[/code]一致。\n"
+"[codeblock]\n"
+"var remainder = fmod(7, 5.5)\n"
+"# Remainder is 1.5\n"
+"[/codeblock]\n"
+"如果对整数进行取余操作,请使用操作符 % 。"
-#: modules/gdscript/doc_classes/@GDScript.xml:367
+#: modules/gdscript/doc_classes/@GDScript.xml:368
msgid ""
"Returns the floating-point modulus of [code]a/b[/code] that wraps equally in "
"positive and negative.\n"
@@ -408,7 +513,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:398
+#: modules/gdscript/doc_classes/@GDScript.xml:399
msgid ""
"Returns a reference to the specified function [code]funcname[/code] in the "
"[code]instance[/code] node. As functions aren't first-class objects in "
@@ -422,8 +527,18 @@ msgid ""
"print(a.call_func()) # Prints bar\n"
"[/codeblock]"
msgstr ""
+"返回某一实例节点 [code]instance[/code]中指定函数 [code]funcname[/code]的引"
+"用。 由于函数在GDScript中不是一级对象,所以 使用 [code]funcref[/code] 将函数"
+"引用[FuncRef]存储在一个变量之中以在后续调用它 。\n"
+"[codeblock]\n"
+"func foo():\n"
+" return(\"bar\")\n"
+"\n"
+"a = funcref(self, \"foo\")\n"
+"print(a.call_func()) # 会打印出\"bar\"\n"
+"[/codeblock]"
-#: modules/gdscript/doc_classes/@GDScript.xml:412
+#: modules/gdscript/doc_classes/@GDScript.xml:413
msgid ""
"Returns an array of dictionaries representing the current call stack.\n"
"[codeblock]\n"
@@ -442,16 +557,36 @@ msgid ""
"source:res://script.gd}, {function:_ready, line:6, source:res://script.gd}]\n"
"[/codeblock]"
msgstr ""
+"返回一个数组,其元素为展示当前调用堆栈的字典。\n"
+"[codeblock]\n"
+"func _ready():\n"
+" foo()\n"
+"\n"
+"func foo():\n"
+" bar()\n"
+"\n"
+"func bar():\n"
+" print(get_stack())\n"
+"[/codeblock]\n"
+"输出:\n"
+"[codeblock]\n"
+"[{function:bar, line:12, source:res://script.gd}, {function:foo, line:9, "
+"source:res://script.gd}, {function:_ready, line:6, source:res://script.gd}]\n"
+"[/codeblock]"
-#: modules/gdscript/doc_classes/@GDScript.xml:435
+#: modules/gdscript/doc_classes/@GDScript.xml:436
msgid ""
"Returns the integer hash of the variable passed.\n"
"[codeblock]\n"
"print(hash(\"a\")) # Prints 177670\n"
"[/codeblock]"
msgstr ""
+"返回变量的整数哈希值\n"
+"[codeblock]\n"
+"print(hash(\"a\")) # 输出结果: 177670\n"
+"[/codeblock]"
-#: modules/gdscript/doc_classes/@GDScript.xml:447
+#: modules/gdscript/doc_classes/@GDScript.xml:448
msgid ""
"Returns the passed instance converted to a dictionary (useful for "
"serializing).\n"
@@ -469,7 +604,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:468
+#: modules/gdscript/doc_classes/@GDScript.xml:469
msgid ""
"Returns the Object that corresponds to [code]instance_id[/code]. All Objects "
"have a unique instance ID.\n"
@@ -481,8 +616,16 @@ msgid ""
" print(inst.foo) # Prints bar\n"
"[/codeblock]"
msgstr ""
+"返回id [code]instance_id[/code]所对应的对象。 所有对象都有独有的id。\n"
+"[codeblock]\n"
+"var foo = \"bar\"\n"
+"func _ready():\n"
+" var id = get_instance_id()\n"
+" var inst = instance_from_id(id)\n"
+" print(inst.foo) # 输出 bar\n"
+"[/codeblock]"
-#: modules/gdscript/doc_classes/@GDScript.xml:488
+#: modules/gdscript/doc_classes/@GDScript.xml:489
msgid ""
"Returns a normalized value considering the given range. This is the opposite "
"of [method lerp].\n"
@@ -495,34 +638,56 @@ msgid ""
"# `ratio` is now 0.75.\n"
"[/codeblock]"
msgstr ""
+"返回给定区间所决定的规范化系数, 是方法 [lerp]的反向过程。\n"
+"[codeblock]\n"
+"var middle = lerp(20, 30, 0.75)\n"
+"# `middle` 为 27.5.\n"
+"# 现在我们不知道系数0.75的值,但是知道归一化结果27.5,计算规范化系数:\n"
+"var ratio = inverse_lerp(20, 30, 27.5)\n"
+"# `ratio` 为 0.75.\n"
+"[/codeblock]"
-#: modules/gdscript/doc_classes/@GDScript.xml:506
+#: modules/gdscript/doc_classes/@GDScript.xml:507
msgid ""
"Returns [code]true[/code] if [code]a[/code] and [code]b[/code] are "
-"approximately equal to each other."
+"approximately equal to each other.\n"
+"Here, approximately equal means that [code]a[/code] and [code]b[/code] are "
+"within a small internal epsilon of each other, which scales with the "
+"magnitude of the numbers.\n"
+"Infinity values of the same sign are considered equal."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:515
+#: modules/gdscript/doc_classes/@GDScript.xml:518
msgid ""
"Returns whether [code]s[/code] is an infinity value (either positive "
"infinity or negative infinity)."
msgstr ""
+"判断[code]s[/code]是否为无穷大(包括正无穷和负无穷),是返回true,否返回"
+"false。"
-#: modules/gdscript/doc_classes/@GDScript.xml:524
+#: modules/gdscript/doc_classes/@GDScript.xml:527
msgid ""
"Returns whether [code]instance[/code] is a valid object (e.g. has not been "
"deleted from memory)."
msgstr ""
+"判断实例[code]instance[/code]是否为合法对象(如未从内存中删除),是返回true,"
+"否返回false。"
-#: modules/gdscript/doc_classes/@GDScript.xml:533
-msgid "Returns whether [code]s[/code] is a NaN (Not-A-Number) value."
-msgstr ""
+#: modules/gdscript/doc_classes/@GDScript.xml:536
+#, fuzzy
+msgid ""
+"Returns whether [code]s[/code] is a NaN (\"Not a Number\" or invalid) value."
+msgstr "返回[code]s[/code]是否为NaN(Not-A-Number,非数)值的判断结果。"
-#: modules/gdscript/doc_classes/@GDScript.xml:542
-msgid "Returns [code]true[/code] if [code]s[/code] is zero or almost zero."
-msgstr ""
+#: modules/gdscript/doc_classes/@GDScript.xml:545
+#, fuzzy
+msgid ""
+"Returns [code]true[/code] if [code]s[/code] is zero or almost zero.\n"
+"This method is faster than using [method is_equal_approx] with one value as "
+"zero."
+msgstr "如果[code]s[/code] 为0或者很接近0则返回[code]true[/code]。"
-#: modules/gdscript/doc_classes/@GDScript.xml:551
+#: modules/gdscript/doc_classes/@GDScript.xml:555
msgid ""
"Returns length of Variant [code]var[/code]. Length is the character count of "
"String, element count of Array, size of Dictionary, etc.\n"
@@ -532,8 +697,15 @@ msgid ""
"len(a) # Returns 4\n"
"[/codeblock]"
msgstr ""
+"返回变量[code]var[/code]的长度。 长度指字符串的字符数、数组的元素数、字典的大"
+"小等。\n"
+"[b]注:[/b] 变量无法提供可作为长度的值时会抛出错误。\n"
+"[codeblock]\n"
+"a = [1, 2, 3, 4]\n"
+"len(a) # 返回值:4\n"
+"[/codeblock]"
-#: modules/gdscript/doc_classes/@GDScript.xml:569
+#: modules/gdscript/doc_classes/@GDScript.xml:573
msgid ""
"Linearly interpolates between two values by a normalized value. This is the "
"opposite of [method inverse_lerp].\n"
@@ -547,8 +719,18 @@ msgid ""
"lerp(Vector2(1, 5), Vector2(3, 2), 0.5) # Returns Vector2(2, 3.5)\n"
"[/codeblock]"
msgstr ""
+"由规范化系数在两个数之间线性插值,是方法[method inverse_lerp]的反向过程。\n"
+"如果参数 [code]from[/code]、[code]to[/code]的类型为[int] 或 [float],返回值类"
+"型为[float]。\n"
+"如果参数 [code]from[/code]、[code]to[/code]的类型为同一类型的矢量"
+"([Vector2], [Vector3]或 [Color]),则返回值也是相同类型(此时[code]lerp[/"
+"code] 会调用矢量类型的[code]lerp[/code] 方法)。\n"
+"[codeblock]\n"
+"lerp(0, 4, 0.75) # Returns 3.0\n"
+"lerp(Vector2(1, 5), Vector2(3, 2), 0.5) # 返回值: Vector2(2, 3.5)\n"
+"[/codeblock]"
-#: modules/gdscript/doc_classes/@GDScript.xml:588
+#: modules/gdscript/doc_classes/@GDScript.xml:592
msgid ""
"Linearly interpolates between two angles (in radians) by a normalized "
"value.\n"
@@ -565,7 +747,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:607
+#: modules/gdscript/doc_classes/@GDScript.xml:611
msgid ""
"Converts from linear energy to decibels (audio). This can be used to "
"implement volume sliders that behave as expected (since volume isn't "
@@ -581,20 +763,28 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:622
+#: modules/gdscript/doc_classes/@GDScript.xml:626
msgid ""
-"Loads a resource from the filesystem located at [code]path[/code].\n"
+"Loads a resource from the filesystem located at [code]path[/code]. The "
+"resource is loaded on the method call (unless it's referenced already "
+"elsewhere, e.g. in another script or in the scene), which might cause slight "
+"delay, especially when loading scenes. To avoid unnecessary delays when "
+"loading something multiple times, either store the resource in a variable or "
+"use [method preload].\n"
"[b]Note:[/b] Resource paths can be obtained by right-clicking on a resource "
-"in the FileSystem dock and choosing [b]Copy Path[/b].\n"
+"in the FileSystem dock and choosing \"Copy Path\" or by dragging the file "
+"from the FileSystem dock into the script.\n"
"[codeblock]\n"
-"# Load a scene called main located in the root of the project directory.\n"
-"var main = load(\"res://main.tscn\")\n"
+"# Load a scene called main located in the root of the project directory and "
+"cache it in a variable.\n"
+"var main = load(\"res://main.tscn\") # main will contain a PackedScene "
+"resource.\n"
"[/codeblock]\n"
"[b]Important:[/b] The path must be absolute, a local path will just return "
"[code]null[/code]."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:637
+#: modules/gdscript/doc_classes/@GDScript.xml:641
msgid ""
"Natural logarithm. The amount of time needed to reach a certain level of "
"continuous growth.\n"
@@ -602,10 +792,12 @@ msgid ""
"calculators, which uses a base 10 logarithm.\n"
"[codeblock]\n"
"log(10) # Returns 2.302585\n"
-"[/codeblock]"
+"[/codeblock]\n"
+"[b]Note:[/b] The logarithm of [code]0[/code] returns [code]-inf[/code], "
+"while negative values return [code]-nan[/code]."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:652
+#: modules/gdscript/doc_classes/@GDScript.xml:657
msgid ""
"Returns the maximum of two values.\n"
"[codeblock]\n"
@@ -614,7 +806,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:667
+#: modules/gdscript/doc_classes/@GDScript.xml:672
msgid ""
"Returns the minimum of two values.\n"
"[codeblock]\n"
@@ -623,27 +815,39 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:684
+#: modules/gdscript/doc_classes/@GDScript.xml:689
msgid ""
"Moves [code]from[/code] toward [code]to[/code] by the [code]delta[/code] "
"value.\n"
"Use a negative [code]delta[/code] value to move away.\n"
"[codeblock]\n"
+"move_toward(5, 10, 4) # Returns 9\n"
"move_toward(10, 5, 4) # Returns 6\n"
+"move_toward(10, 5, -1.5) # Returns 11.5\n"
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:697
+#: modules/gdscript/doc_classes/@GDScript.xml:704
msgid ""
-"Returns the nearest larger power of 2 for integer [code]value[/code].\n"
+"Returns the nearest equal or larger power of 2 for integer [code]value[/"
+"code].\n"
+"In other words, returns the smallest value [code]a[/code] where [code]a = "
+"pow(2, n)[/code] such that [code]value <= a[/code] for some non-negative "
+"integer [code]n[/code].\n"
"[codeblock]\n"
"nearest_po2(3) # Returns 4\n"
"nearest_po2(4) # Returns 4\n"
"nearest_po2(5) # Returns 8\n"
-"[/codeblock]"
+"\n"
+"nearest_po2(0) # Returns 0 (this may not be what you expect)\n"
+"nearest_po2(-1) # Returns 0 (this may not be what you expect)\n"
+"[/codeblock]\n"
+"[b]WARNING:[/b] Due to the way it is implemented, this function returns "
+"[code]0[/code] rather than [code]1[/code] for non-positive values of "
+"[code]value[/code] (in reality, 1 is the smallest integer power of 2)."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:711
+#: modules/gdscript/doc_classes/@GDScript.xml:723
msgid ""
"Returns an integer representing the Unicode code point of the given Unicode "
"character [code]char[/code].\n"
@@ -655,27 +859,28 @@ msgid ""
"This is the inverse of [method char]."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:726
+#: modules/gdscript/doc_classes/@GDScript.xml:738
msgid ""
-"Parse JSON text to a Variant (use [method typeof] to check if it is what you "
-"expect).\n"
-"Be aware that the JSON specification does not define integer or float types, "
-"but only a number type. Therefore, parsing a JSON text will convert all "
-"numerical values to [float] types.\n"
-"Note that JSON objects do not preserve key order like Godot dictionaries, "
-"thus you should not rely on keys being in a certain order if a dictionary is "
-"constructed from JSON. In contrast, JSON arrays retain the order of their "
+"Parse JSON text to a Variant. (Use [method typeof] to check if the Variant's "
+"type is what you expect.)\n"
+"[b]Note:[/b] The JSON specification does not define integer or float types, "
+"but only a [i]number[/i] type. Therefore, parsing a JSON text will convert "
+"all numerical values to [float] types.\n"
+"[b]Note:[/b] JSON objects do not preserve key order like Godot dictionaries, "
+"thus, you should not rely on keys being in a certain order if a dictionary "
+"is constructed from JSON. In contrast, JSON arrays retain the order of their "
"elements:\n"
"[codeblock]\n"
-"p = parse_json('[\"a\", \"b\", \"c\"]')\n"
-"if typeof(p) == TYPE_ARRAY:\n"
-" print(p[0]) # Prints a\n"
+"var p = JSON.parse('[\"hello\", \"world\", \"!\"]')\n"
+"if typeof(p.result) == TYPE_ARRAY:\n"
+" print(p.result[0]) # Prints \"hello\"\n"
"else:\n"
-" print(\"unexpected results\")\n"
-"[/codeblock]"
+" push_error(\"Unexpected results.\")\n"
+"[/codeblock]\n"
+"See also [JSON] for an alternative way to parse JSON text."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:746
+#: modules/gdscript/doc_classes/@GDScript.xml:759
#: modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml:142
msgid ""
"Converts a 2D point expressed in the polar coordinate system (a distance "
@@ -683,7 +888,7 @@ msgid ""
"cartesian coordinate system (X and Y axis)."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:757
+#: modules/gdscript/doc_classes/@GDScript.xml:770
msgid ""
"Returns the integer modulus of [code]a/b[/code] that wraps equally in "
"positive and negative.\n"
@@ -709,7 +914,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:788
+#: modules/gdscript/doc_classes/@GDScript.xml:801
msgid ""
"Returns the result of [code]x[/code] raised to the power of [code]y[/code].\n"
"[codeblock]\n"
@@ -717,19 +922,23 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:800
+#: modules/gdscript/doc_classes/@GDScript.xml:813
msgid ""
-"Returns a resource from the filesystem that is loaded during script "
-"parsing.\n"
+"Returns a [Resource] from the filesystem located at [code]path[/code]. The "
+"resource is loaded during script parsing, i.e. is loaded with the script and "
+"[method preload] effectively acts as a reference to that resource. Note that "
+"the method requires a constant path. If you want to load a resource from a "
+"dynamic/variable path, use [method load].\n"
"[b]Note:[/b] Resource paths can be obtained by right clicking on a resource "
-"in the Assets Panel and choosing \"Copy Path\".\n"
+"in the Assets Panel and choosing \"Copy Path\" or by dragging the file from "
+"the FileSystem dock into the script.\n"
"[codeblock]\n"
-"# Load a scene called main located in the root of the project directory.\n"
-"var main = preload(\"res://main.tscn\")\n"
+"# Instance a scene.\n"
+"var diamond = preload(\"res://diamond.tscn\").instance()\n"
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:812
+#: modules/gdscript/doc_classes/@GDScript.xml:825
msgid ""
"Converts one or more arguments to strings in the best way possible and "
"prints them to the console.\n"
@@ -739,11 +948,11 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:823
+#: modules/gdscript/doc_classes/@GDScript.xml:836
msgid "Like [method print], but prints only when used in debug mode."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:830
+#: modules/gdscript/doc_classes/@GDScript.xml:843
msgid ""
"Prints a stack track at code location, only works when running with debugger "
"turned on.\n"
@@ -753,7 +962,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:841
+#: modules/gdscript/doc_classes/@GDScript.xml:854
msgid ""
"Prints one or more arguments to strings in the best way possible to standard "
"error line.\n"
@@ -762,7 +971,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:851
+#: modules/gdscript/doc_classes/@GDScript.xml:864
msgid ""
"Prints one or more arguments to strings in the best way possible to console. "
"No newline is added at the end.\n"
@@ -776,7 +985,7 @@ msgid ""
"method, such as [method print]."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:864
+#: modules/gdscript/doc_classes/@GDScript.xml:877
msgid ""
"Prints one or more arguments to the console with a space between each "
"argument.\n"
@@ -785,7 +994,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:874
+#: modules/gdscript/doc_classes/@GDScript.xml:887
msgid ""
"Prints one or more arguments to the console with a tab between each "
"argument.\n"
@@ -794,7 +1003,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:886
+#: modules/gdscript/doc_classes/@GDScript.xml:899
msgid ""
"Pushes an error message to Godot's built-in debugger and to the OS "
"terminal.\n"
@@ -804,7 +1013,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:898
+#: modules/gdscript/doc_classes/@GDScript.xml:911
msgid ""
"Pushes a warning message to Godot's built-in debugger and to the OS "
"terminal.\n"
@@ -814,15 +1023,15 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:910
+#: modules/gdscript/doc_classes/@GDScript.xml:923
msgid ""
-"Converts from radians to degrees.\n"
+"Converts an angle expressed in radians to degrees.\n"
"[codeblock]\n"
"rad2deg(0.523599) # Returns 30\n"
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:924
+#: modules/gdscript/doc_classes/@GDScript.xml:937
msgid ""
"Random range, any floating point value between [code]from[/code] and "
"[code]to[/code].\n"
@@ -831,7 +1040,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:936
+#: modules/gdscript/doc_classes/@GDScript.xml:949
msgid ""
"Random from seed: pass a [code]seed[/code], and an array with both number "
"and new seed is returned. \"Seed\" here refers to the internal state of the "
@@ -839,7 +1048,7 @@ msgid ""
"implementation is 64 bits."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:943
+#: modules/gdscript/doc_classes/@GDScript.xml:956
msgid ""
"Returns a random floating point value on the interval [code][0, 1][/code].\n"
"[codeblock]\n"
@@ -847,7 +1056,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:953
+#: modules/gdscript/doc_classes/@GDScript.xml:966
msgid ""
"Returns a random unsigned 32 bit integer. Use remainder to obtain a random "
"value in the interval [code][0, N - 1][/code] (where N is smaller than "
@@ -860,7 +1069,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:966
+#: modules/gdscript/doc_classes/@GDScript.xml:979
msgid ""
"Randomizes the seed (or the internal state) of the random number generator. "
"Current implementation reseeds using a number based on time.\n"
@@ -870,7 +1079,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:977
+#: modules/gdscript/doc_classes/@GDScript.xml:990
msgid ""
"Returns an array with the given range. Range can be 1 argument N (0 to N-1), "
"two arguments (initial, final-1) or three arguments (initial, final-1, "
@@ -900,7 +1109,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1017
+#: modules/gdscript/doc_classes/@GDScript.xml:1030
msgid ""
"Maps a [code]value[/code] from range [code][istart, istop][/code] to [code]"
"[ostart, ostop][/code].\n"
@@ -909,16 +1118,16 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1029
+#: modules/gdscript/doc_classes/@GDScript.xml:1042
msgid ""
-"Returns the integral value that is nearest to [code]s[/code], with halfway "
-"cases rounded away from zero.\n"
+"Rounds [code]s[/code] to the nearest whole number, with halfway cases "
+"rounded away from zero.\n"
"[codeblock]\n"
"round(2.6) # Returns 3\n"
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1041
+#: modules/gdscript/doc_classes/@GDScript.xml:1054
msgid ""
"Sets seed for the random number generator.\n"
"[codeblock]\n"
@@ -927,7 +1136,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1054
+#: modules/gdscript/doc_classes/@GDScript.xml:1067
msgid ""
"Returns the sign of [code]s[/code]: -1 or 1. Returns 0 if [code]s[/code] is "
"0.\n"
@@ -938,7 +1147,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1068
+#: modules/gdscript/doc_classes/@GDScript.xml:1081
msgid ""
"Returns the sine of angle [code]s[/code] in radians.\n"
"[codeblock]\n"
@@ -946,7 +1155,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1080
+#: modules/gdscript/doc_classes/@GDScript.xml:1093
msgid ""
"Returns the hyperbolic sine of [code]s[/code].\n"
"[codeblock]\n"
@@ -955,27 +1164,37 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1097
+#: modules/gdscript/doc_classes/@GDScript.xml:1110
msgid ""
-"Returns a number smoothly interpolated between the [code]from[/code] and "
-"[code]to[/code], based on the [code]weight[/code]. Similar to [method lerp], "
-"but interpolates faster at the beginning and slower at the end.\n"
+"Returns the result of smoothly interpolating the value of [code]s[/code] "
+"between [code]0[/code] and [code]1[/code], based on the where [code]s[/code] "
+"lies with respect to the edges [code]from[/code] and [code]to[/code].\n"
+"The return value is [code]0[/code] if [code]s <= from[/code], and [code]1[/"
+"code] if [code]s >= to[/code]. If [code]s[/code] lies between [code]from[/"
+"code] and [code]to[/code], the returned value follows an S-shaped curve that "
+"maps [code]s[/code] between [code]0[/code] and [code]1[/code].\n"
+"This S-shaped curve is the cubic Hermite interpolator, given by [code]f(s) = "
+"3*s^2 - 2*s^3[/code].\n"
"[codeblock]\n"
-"smoothstep(0, 2, 0.5) # Returns 0.15\n"
+"smoothstep(0, 2, -5.0) # Returns 0.0\n"
+"smoothstep(0, 2, 0.5) # Returns 0.15625\n"
"smoothstep(0, 2, 1.0) # Returns 0.5\n"
"smoothstep(0, 2, 2.0) # Returns 1.0\n"
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1111
+#: modules/gdscript/doc_classes/@GDScript.xml:1127
msgid ""
-"Returns the square root of [code]s[/code].\n"
+"Returns the square root of [code]s[/code], where [code]s[/code] is a non-"
+"negative number.\n"
"[codeblock]\n"
"sqrt(9) # Returns 3\n"
-"[/codeblock]"
+"[/codeblock]\n"
+"[b]Note:[/b]Negative values of [code]s[/code] return NaN. If you need "
+"negative inputs, use [code]System.Numerics.Complex[/code] in C#."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1123
+#: modules/gdscript/doc_classes/@GDScript.xml:1140
msgid ""
"Returns the position of the first non-zero digit, after the decimal point. "
"Note that the maximum return value is 10, which is a design decision in the "
@@ -990,7 +1209,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1142
+#: modules/gdscript/doc_classes/@GDScript.xml:1159
msgid ""
"Snaps float value [code]s[/code] to a given [code]step[/code]. This can also "
"be used to round a floating point number to an arbitrary number of "
@@ -1001,7 +1220,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1153
+#: modules/gdscript/doc_classes/@GDScript.xml:1170
msgid ""
"Converts one or more arguments to string in the best way possible.\n"
"[codeblock]\n"
@@ -1012,7 +1231,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1168
+#: modules/gdscript/doc_classes/@GDScript.xml:1185
msgid ""
"Converts a formatted string that was returned by [method var2str] to the "
"original value.\n"
@@ -1023,7 +1242,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1182
+#: modules/gdscript/doc_classes/@GDScript.xml:1199
msgid ""
"Returns the tangent of angle [code]s[/code] in radians.\n"
"[codeblock]\n"
@@ -1031,7 +1250,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1194
+#: modules/gdscript/doc_classes/@GDScript.xml:1211
msgid ""
"Returns the hyperbolic tangent of [code]s[/code].\n"
"[codeblock]\n"
@@ -1040,18 +1259,25 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1207
+#: modules/gdscript/doc_classes/@GDScript.xml:1224
msgid ""
-"Converts a Variant [code]var[/code] to JSON text and return the result. "
+"Converts a [Variant] [code]var[/code] to JSON text and return the result. "
"Useful for serializing data to store or send over the network.\n"
"[codeblock]\n"
+"# Both numbers below are integers.\n"
"a = { \"a\": 1, \"b\": 2 }\n"
"b = to_json(a)\n"
"print(b) # {\"a\":1, \"b\":2}\n"
-"[/codeblock]"
+"# Both numbers above are floats, even if they display without any decimal "
+"places.\n"
+"[/codeblock]\n"
+"[b]Note:[/b] The JSON specification does not define integer or float types, "
+"but only a [i]number[/i] type. Therefore, converting a [Variant] to JSON "
+"text will convert all numerical values to [float] types.\n"
+"See also [JSON] for an alternative way to convert a [Variant] to JSON text."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1221
+#: modules/gdscript/doc_classes/@GDScript.xml:1242
msgid ""
"Returns whether the given class exists in [ClassDB].\n"
"[codeblock]\n"
@@ -1060,7 +1286,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1234
+#: modules/gdscript/doc_classes/@GDScript.xml:1255
msgid ""
"Returns the internal type of the given Variant object, using the [enum "
"Variant.Type] values.\n"
@@ -1073,7 +1299,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1250
+#: modules/gdscript/doc_classes/@GDScript.xml:1271
msgid ""
"Checks that [code]json[/code] is valid JSON data. Returns an empty string if "
"valid, or an error message otherwise.\n"
@@ -1081,20 +1307,20 @@ msgid ""
"j = to_json([1, 2, 3])\n"
"v = validate_json(j)\n"
"if not v:\n"
-" print(\"valid\")\n"
+" print(\"Valid JSON.\")\n"
"else:\n"
-" prints(\"invalid\", v)\n"
+" push_error(\"Invalid JSON: \" + v)\n"
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1269
+#: modules/gdscript/doc_classes/@GDScript.xml:1290
msgid ""
"Encodes a variable value to a byte array. When [code]full_objects[/code] is "
"[code]true[/code] encoding objects is allowed (and can potentially include "
"code)."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1278
+#: modules/gdscript/doc_classes/@GDScript.xml:1299
msgid ""
"Converts a Variant [code]var[/code] to a formatted string that can later be "
"parsed using [method str2var].\n"
@@ -1111,7 +1337,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1298
+#: modules/gdscript/doc_classes/@GDScript.xml:1319
msgid ""
"Returns a weak reference to an object.\n"
"A weak reference to an object is not enough to keep the object alive: when "
@@ -1121,135 +1347,67 @@ msgid ""
"reference may return the object even if there are no strong references to it."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1312
+#: modules/gdscript/doc_classes/@GDScript.xml:1333
msgid ""
"Wraps float [code]value[/code] between [code]min[/code] and [code]max[/"
"code].\n"
"Usable for creating loop-alike behavior or infinite surfaces.\n"
"[codeblock]\n"
-"# a is 0.5\n"
-"a = wrapf(10.5, 0.0, 10.0)\n"
-"[/codeblock]\n"
-"[codeblock]\n"
-"# a is 9.5\n"
-"a = wrapf(-0.5, 0.0, 10.0)\n"
-"[/codeblock]\n"
-"[codeblock]\n"
-"# Infinite loop between 0.0 and 0.99\n"
-"f = wrapf(f + 0.1, 0.0, 1.0)\n"
+"# Infinite loop between 5.0 and 9.9\n"
+"value = wrapf(value + 0.1, 5.0, 10.0)\n"
"[/codeblock]\n"
"[codeblock]\n"
"# Infinite rotation (in radians)\n"
"angle = wrapf(angle + 0.1, 0.0, TAU)\n"
"[/codeblock]\n"
-"[b]Note:[/b] If you just want to wrap between 0.0 and [code]n[/code] (where "
-"[code]n[/code] is a positive floating-point value), it is better for "
-"performance to use the [method fmod] method like [code]fmod(number, n)[/"
-"code].\n"
-"[code]wrapf[/code] is more flexible than using the [method fmod] approach by "
-"giving the user a simple control over the minimum value. It also fully "
-"supports negative numbers, e.g.\n"
"[codeblock]\n"
"# Infinite rotation (in radians)\n"
"angle = wrapf(angle + 0.1, -PI, PI)\n"
-"[/codeblock]"
+"[/codeblock]\n"
+"[b]Note:[/b] If [code]min[/code] is [code]0[/code], this is equivalent to "
+"[method fposmod], so prefer using that instead.\n"
+"[code]wrapf[/code] is more flexible than using the [method fposmod] approach "
+"by giving the user control over the minimum value."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1348
+#: modules/gdscript/doc_classes/@GDScript.xml:1361
msgid ""
"Wraps integer [code]value[/code] between [code]min[/code] and [code]max[/"
"code].\n"
"Usable for creating loop-alike behavior or infinite surfaces.\n"
"[codeblock]\n"
-"# a is 0\n"
-"a = wrapi(10, 0, 10)\n"
-"[/codeblock]\n"
-"[codeblock]\n"
-"# a is 9\n"
-"a = wrapi(-1, 0, 10)\n"
+"# Infinite loop between 5 and 9\n"
+"frame = wrapi(frame + 1, 5, 10)\n"
"[/codeblock]\n"
"[codeblock]\n"
-"# Infinite loop between 0 and 9\n"
-"frame = wrapi(frame + 1, 0, 10)\n"
-"[/codeblock]\n"
-"[b]Note:[/b] If you just want to wrap between 0 and [code]n[/code] (where "
-"[code]n[/code] is a positive integer value), it is better for performance to "
-"use the modulo operator like [code]number % n[/code].\n"
-"[code]wrapi[/code] is more flexible than using the modulo approach by giving "
-"the user a simple control over the minimum value. It also fully supports "
-"negative numbers, e.g.\n"
-"[codeblock]\n"
"# result is -2\n"
"var result = wrapi(-6, -5, -1)\n"
-"[/codeblock]"
-msgstr ""
-
-#: modules/gdscript/doc_classes/@GDScript.xml:1378
-msgid ""
-"Stops the function execution and returns the current suspended state to the "
-"calling function.\n"
-"From the caller, call [method GDScriptFunctionState.resume] on the state to "
-"resume execution. This invalidates the state. Within the resumed function, "
-"[code]yield()[/code] returns whatever was passed to the [code]resume()[/"
-"code] function call.\n"
-"If passed an object and a signal, the execution is resumed when the object "
-"emits the given signal. In this case, [code]yield()[/code] returns the "
-"argument passed to [code]emit_signal()[/code] if the signal takes only one "
-"argument, or an array containing all the arguments passed to "
-"[code]emit_signal()[/code] if the signal takes multiple arguments.\n"
-"You can also use [code]yield[/code] to wait for a function to finish:\n"
-"[codeblock]\n"
-"func _ready():\n"
-" yield(countdown(), \"completed\") # waiting for the countdown() function "
-"to complete\n"
-" print('Ready')\n"
-"\n"
-"func countdown():\n"
-" yield(get_tree(), \"idle_frame\") # returns a GDScriptFunctionState "
-"object to _ready()\n"
-" print(3)\n"
-" yield(get_tree().create_timer(1.0), \"timeout\")\n"
-" print(2)\n"
-" yield(get_tree().create_timer(1.0), \"timeout\")\n"
-" print(1)\n"
-" yield(get_tree().create_timer(1.0), \"timeout\")\n"
-"\n"
-"# prints:\n"
-"# 3\n"
-"# 2\n"
-"# 1\n"
-"# Ready\n"
"[/codeblock]\n"
-"When yielding on a function, the [code]completed[/code] signal will be "
-"emitted automatically when the function returns. It can, therefore, be used "
-"as the [code]signal[/code] parameter of the [code]yield[/code] method to "
-"resume.\n"
-"In order to yield on a function, the resulting function should also return a "
-"[code]GDScriptFunctionState[/code]. Notice [code]yield(get_tree(), "
-"\"idle_frame\")[/code] from the above example."
+"[b]Note:[/b] If [code]min[/code] is [code]0[/code], this is equivalent to "
+"[method posmod], so prefer using that instead.\n"
+"[code]wrapi[/code] is more flexible than using the [method posmod] approach "
+"by giving the user control over the minimum value."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1409
+#: modules/gdscript/doc_classes/@GDScript.xml:1378
msgid ""
"Constant that represents how many times the diameter of a circle fits around "
-"its perimeter."
+"its perimeter. This is equivalent to [code]TAU / 2[/code]."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1412
-msgid "The circle constant, the circumference of the unit circle."
+#: modules/gdscript/doc_classes/@GDScript.xml:1381
+msgid "The circle constant, the circumference of the unit circle in radians."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1415
-msgid "A positive infinity. (For negative infinity, use -INF)."
+#: modules/gdscript/doc_classes/@GDScript.xml:1384
+msgid "Positive infinity. For negative infinity, use -INF."
msgstr ""
-#: modules/gdscript/doc_classes/@GDScript.xml:1418
+#: modules/gdscript/doc_classes/@GDScript.xml:1387
msgid ""
-"Macro constant that expands to an expression of type float that represents a "
-"NaN.\n"
-"The NaN values are used to identify undefined or non-representable values "
-"for floating-point elements, such as the square root of negative numbers or "
-"the result of 0/0."
+"\"Not a Number\", an invalid value. [code]NaN[/code] has special properties, "
+"including that it is not equal to itself. It is output by some invalid "
+"operations, such as dividing zero by zero."
msgstr ""
#: doc/classes/@GlobalScope.xml:4
@@ -3485,130 +3643,141 @@ msgid ""
msgstr ""
#: doc/classes/AABB.xml:10 doc/classes/Plane.xml:10 doc/classes/Rect2.xml:11
-#: doc/classes/Rect2i.xml:11 doc/classes/Transform.xml:10
+#: doc/classes/Rect2i.xml:11 doc/classes/Transform.xml:11
#: doc/classes/Vector2.xml:12 doc/classes/Vector2i.xml:12
#: doc/classes/Vector3.xml:12 doc/classes/Vector3i.xml:12
msgid "https://docs.godotengine.org/en/latest/tutorials/math/index.html"
msgstr ""
#: doc/classes/AABB.xml:21
-msgid "Optional constructor, accepts position and size."
+msgid "Constructs an [AABB] from a position and size."
msgstr ""
-#: doc/classes/AABB.xml:30
+#: doc/classes/AABB.xml:28
+msgid ""
+"Returns an AABB with equivalent position and size, modified so that the most-"
+"negative corner is the origin and the size is positive."
+msgstr ""
+
+#: doc/classes/AABB.xml:37
msgid ""
"Returns [code]true[/code] if this [AABB] completely encloses another one."
msgstr ""
-#: doc/classes/AABB.xml:39
+#: doc/classes/AABB.xml:46
msgid "Returns this [AABB] expanded to include a given point."
msgstr ""
-#: doc/classes/AABB.xml:46
+#: doc/classes/AABB.xml:53
msgid "Returns the volume of the [AABB]."
msgstr ""
-#: doc/classes/AABB.xml:55
+#: doc/classes/AABB.xml:62
msgid "Gets the position of the 8 endpoints of the [AABB] in space."
msgstr ""
-#: doc/classes/AABB.xml:62
+#: doc/classes/AABB.xml:69
msgid "Returns the normalized longest axis of the [AABB]."
msgstr ""
-#: doc/classes/AABB.xml:69
+#: doc/classes/AABB.xml:76
msgid ""
"Returns the index of the longest axis of the [AABB] (according to "
"[Vector3]'s [code]AXIS_*[/code] constants)."
msgstr ""
-#: doc/classes/AABB.xml:76
+#: doc/classes/AABB.xml:83
msgid "Returns the scalar length of the longest axis of the [AABB]."
msgstr ""
-#: doc/classes/AABB.xml:83
+#: doc/classes/AABB.xml:90
msgid "Returns the normalized shortest axis of the [AABB]."
msgstr ""
-#: doc/classes/AABB.xml:90
+#: doc/classes/AABB.xml:97
msgid ""
"Returns the index of the shortest axis of the [AABB] (according to "
"[Vector3]::AXIS* enum)."
msgstr ""
-#: doc/classes/AABB.xml:97
+#: doc/classes/AABB.xml:104
msgid "Returns the scalar length of the shortest axis of the [AABB]."
msgstr ""
-#: doc/classes/AABB.xml:106
+#: doc/classes/AABB.xml:113
msgid ""
"Returns the support point in a given direction. This is useful for collision "
"detection algorithms."
msgstr ""
-#: doc/classes/AABB.xml:115
+#: doc/classes/AABB.xml:122
msgid ""
"Returns a copy of the [AABB] grown a given amount of units towards all the "
"sides."
msgstr ""
-#: doc/classes/AABB.xml:122
+#: doc/classes/AABB.xml:129
msgid "Returns [code]true[/code] if the [AABB] is flat or empty."
msgstr ""
-#: doc/classes/AABB.xml:129
+#: doc/classes/AABB.xml:136
msgid "Returns [code]true[/code] if the [AABB] is empty."
msgstr ""
-#: doc/classes/AABB.xml:138
+#: doc/classes/AABB.xml:145
msgid "Returns [code]true[/code] if the [AABB] contains a point."
msgstr ""
-#: doc/classes/AABB.xml:147
+#: doc/classes/AABB.xml:154
msgid ""
"Returns the intersection between two [AABB]. An empty AABB (size 0,0,0) is "
"returned on failure."
msgstr ""
-#: doc/classes/AABB.xml:156
+#: doc/classes/AABB.xml:163
msgid "Returns [code]true[/code] if the [AABB] overlaps with another."
msgstr ""
-#: doc/classes/AABB.xml:165
+#: doc/classes/AABB.xml:172
msgid "Returns [code]true[/code] if the [AABB] is on both sides of a plane."
msgstr ""
-#: doc/classes/AABB.xml:176
+#: doc/classes/AABB.xml:183
msgid ""
"Returns [code]true[/code] if the [AABB] intersects the line segment between "
"[code]from[/code] and [code]to[/code]."
msgstr ""
-#: doc/classes/AABB.xml:185
+#: doc/classes/AABB.xml:192
msgid ""
"Returns [code]true[/code] if this [AABB] and [code]aabb[/code] are "
"approximately equal, by calling [method @GDScript.is_equal_approx] on each "
"component."
msgstr ""
-#: doc/classes/AABB.xml:194
+#: doc/classes/AABB.xml:201
msgid ""
"Returns a larger [AABB] that contains both this [AABB] and [code]with[/code]."
msgstr ""
-#: doc/classes/AABB.xml:200
+#: doc/classes/AABB.xml:207 doc/classes/Rect2.xml:174
+#: doc/classes/Rect2i.xml:163
msgid ""
-"Ending corner. This is calculated as [code]position + size[/code]. Changing "
-"this property changes [member size] accordingly."
+"Ending corner. This is calculated as [code]position + size[/code]. Setting "
+"this value will change the size."
msgstr ""
-#: doc/classes/AABB.xml:203
-msgid "Beginning corner."
+#: doc/classes/AABB.xml:210 doc/classes/Rect2.xml:177
+#: doc/classes/Rect2i.xml:166
+msgid "Beginning corner. Typically has values lower than [member end]."
msgstr ""
-#: doc/classes/AABB.xml:206 doc/classes/Rect2.xml:180
+#: doc/classes/AABB.xml:213 doc/classes/Rect2.xml:180
#: doc/classes/Rect2i.xml:169
-msgid "Size from position to end."
+msgid ""
+"Size from [member position] to [member end]. Typically all components are "
+"positive.\n"
+"If the size is negative, you can use [method abs] to fix it."
msgstr ""
#: doc/classes/AcceptDialog.xml:4
@@ -3672,11 +3841,11 @@ msgstr ""
msgid "The text displayed by the dialog."
msgstr ""
-#: doc/classes/AcceptDialog.xml:82
+#: doc/classes/AcceptDialog.xml:83
msgid "Emitted when the dialog is accepted, i.e. the OK button is pressed."
msgstr ""
-#: doc/classes/AcceptDialog.xml:89
+#: doc/classes/AcceptDialog.xml:90
msgid "Emitted when a custom button is pressed. See [method add_button]."
msgstr ""
@@ -3729,7 +3898,7 @@ msgstr ""
#: doc/classes/AESContext.xml:54
msgid ""
"Get the current IV state for this context (IV gets updated when calling "
-"[method update]). You normally don't need this funciton.\n"
+"[method update]). You normally don't need this function.\n"
"Note: This function only makes sense when the context is started with "
"[constant MODE_CBC_ENCRYPT] or [constant MODE_CBC_DECRYPT]."
msgstr ""
@@ -3807,12 +3976,14 @@ msgid "If [code]true[/code], texture will be centered."
msgstr ""
#: doc/classes/AnimatedSprite2D.xml:46 doc/classes/Sprite2D.xml:41
-#: doc/classes/SpriteBase3D.xml:61 doc/classes/TextureRect.xml:18
+#: doc/classes/SpriteBase3D.xml:61 doc/classes/TextureButton.xml:19
+#: doc/classes/TextureRect.xml:18
msgid "If [code]true[/code], texture is flipped horizontally."
msgstr ""
#: doc/classes/AnimatedSprite2D.xml:49 doc/classes/Sprite2D.xml:44
-#: doc/classes/SpriteBase3D.xml:64 doc/classes/TextureRect.xml:21
+#: doc/classes/SpriteBase3D.xml:64 doc/classes/TextureButton.xml:22
+#: doc/classes/TextureRect.xml:21
msgid "If [code]true[/code], texture is flipped vertically."
msgstr ""
@@ -3979,10 +4150,10 @@ msgid ""
"[codeblock]\n"
"# This creates an animation that makes the node \"Enemy\" move to the right "
"by\n"
-"# 100 pixels in 1 second.\n"
+"# 100 pixels in 0.5 seconds.\n"
"var animation = Animation.new()\n"
"var track_index = animation.add_track(Animation.TYPE_VALUE)\n"
-"animation.track_set_path(track_index, \"Enemy:position.x\")\n"
+"animation.track_set_path(track_index, \"Enemy:position:x\")\n"
"animation.track_insert_key(track_index, 0.0, 0)\n"
"animation.track_insert_key(track_index, 0.5, 100)\n"
"[/codeblock]\n"
@@ -6110,10 +6281,10 @@ msgstr ""
msgid ""
"Returns [code]true[/code] if the array contains the given value.\n"
"[codeblock]\n"
-"[\"inside\", 7].has(\"inside\") == true\n"
-"[\"inside\", 7].has(\"outside\") == false\n"
-"[\"inside\", 7].has(7) == true\n"
-"[\"inside\", 7].has(\"7\") == false\n"
+"print([\"inside\", 7].has(\"inside\")) # True\n"
+"print([\"inside\", 7].has(\"outside\")) # False\n"
+"print([\"inside\", 7].has(7)) # True\n"
+"print([\"inside\", 7].has(\"7\")) # False\n"
"[/codeblock]\n"
"[b]Note:[/b] This is equivalent to using the [code]in[/code] operator as "
"follows:\n"
@@ -6134,11 +6305,11 @@ msgid ""
"valid, or at the end of the array ([code]pos == size()[/code])."
msgstr ""
-#: doc/classes/Array.xml:265 doc/classes/PackedByteArray.xml:107
-#: doc/classes/PackedColorArray.xml:62 doc/classes/PackedFloat32Array.xml:63
-#: doc/classes/PackedFloat64Array.xml:63 doc/classes/PackedInt32Array.xml:63
-#: doc/classes/PackedInt64Array.xml:63 doc/classes/PackedStringArray.xml:62
-#: doc/classes/PackedVector2Array.xml:62 doc/classes/PackedVector3Array.xml:62
+#: doc/classes/Array.xml:265 doc/classes/PackedByteArray.xml:116
+#: doc/classes/PackedColorArray.xml:71 doc/classes/PackedFloat32Array.xml:72
+#: doc/classes/PackedFloat64Array.xml:72 doc/classes/PackedInt32Array.xml:72
+#: doc/classes/PackedInt64Array.xml:72 doc/classes/PackedStringArray.xml:71
+#: doc/classes/PackedVector2Array.xml:71 doc/classes/PackedVector3Array.xml:71
msgid "Reverses the order of the elements in the array."
msgstr ""
@@ -6168,8 +6339,8 @@ msgid ""
"code] if the array is empty."
msgstr ""
-#: doc/classes/Array.xml:302 doc/classes/PackedByteArray.xml:116
-#: doc/classes/PackedFloat32Array.xml:72 doc/classes/PackedFloat64Array.xml:72
+#: doc/classes/Array.xml:302 doc/classes/PackedByteArray.xml:125
+#: doc/classes/PackedFloat32Array.xml:81 doc/classes/PackedFloat64Array.xml:81
msgid "Appends an element at the end of the array."
msgstr ""
@@ -6177,11 +6348,11 @@ msgstr ""
msgid "Adds an element at the beginning of the array."
msgstr ""
-#: doc/classes/Array.xml:320 doc/classes/PackedByteArray.xml:125
-#: doc/classes/PackedColorArray.xml:80 doc/classes/PackedFloat32Array.xml:81
-#: doc/classes/PackedFloat64Array.xml:81 doc/classes/PackedInt32Array.xml:81
-#: doc/classes/PackedInt64Array.xml:81 doc/classes/PackedStringArray.xml:80
-#: doc/classes/PackedVector2Array.xml:80 doc/classes/PackedVector3Array.xml:80
+#: doc/classes/Array.xml:320 doc/classes/PackedByteArray.xml:134
+#: doc/classes/PackedColorArray.xml:89 doc/classes/PackedFloat32Array.xml:90
+#: doc/classes/PackedFloat64Array.xml:90 doc/classes/PackedInt32Array.xml:90
+#: doc/classes/PackedInt64Array.xml:90 doc/classes/PackedStringArray.xml:89
+#: doc/classes/PackedVector2Array.xml:89 doc/classes/PackedVector3Array.xml:89
msgid "Removes an element from the array by index."
msgstr ""
@@ -6464,7 +6635,7 @@ msgid ""
msgstr ""
#: doc/classes/ArrayMesh.xml:235 doc/classes/Mesh.xml:210
-#: doc/classes/RenderingServer.xml:3115
+#: doc/classes/RenderingServer.xml:3111
msgid "Represents the size of the [enum ArrayType] enum."
msgstr ""
@@ -8281,7 +8452,9 @@ msgid ""
msgstr ""
#: doc/classes/BaseButton.xml:16
-msgid "Called when the button is pressed."
+msgid ""
+"Called when the button is pressed. If you need to know the button's pressed "
+"state (and [member toggle_mode] is active), use [method _toggled] instead."
msgstr ""
#: doc/classes/BaseButton.xml:25
@@ -8375,43 +8548,45 @@ msgstr ""
msgid ""
"Emitted when the button is toggled or pressed. This is on [signal "
"button_down] if [member action_mode] is [constant ACTION_MODE_BUTTON_PRESS] "
-"and on [signal button_up] otherwise."
+"and on [signal button_up] otherwise.\n"
+"If you need to know the button's pressed state (and [member toggle_mode] is "
+"active), use [signal toggled] instead."
msgstr ""
-#: doc/classes/BaseButton.xml:98
+#: doc/classes/BaseButton.xml:99
msgid ""
"Emitted when the button was just toggled between pressed and normal states "
"(only if [member toggle_mode] is active). The new state is contained in the "
"[code]button_pressed[/code] argument."
msgstr ""
-#: doc/classes/BaseButton.xml:104
+#: doc/classes/BaseButton.xml:105
msgid ""
"The normal state (i.e. not pressed, not hovered, not toggled and enabled) of "
"buttons."
msgstr ""
-#: doc/classes/BaseButton.xml:107
+#: doc/classes/BaseButton.xml:108
msgid "The state of buttons are pressed."
msgstr ""
-#: doc/classes/BaseButton.xml:110
+#: doc/classes/BaseButton.xml:111
msgid "The state of buttons are hovered."
msgstr ""
-#: doc/classes/BaseButton.xml:113
+#: doc/classes/BaseButton.xml:114
msgid "The state of buttons are disabled."
msgstr ""
-#: doc/classes/BaseButton.xml:116
+#: doc/classes/BaseButton.xml:117
msgid "The state of buttons are both hovered and pressed."
msgstr ""
-#: doc/classes/BaseButton.xml:119
+#: doc/classes/BaseButton.xml:120
msgid "Require just a press to consider the button clicked."
msgstr ""
-#: doc/classes/BaseButton.xml:122
+#: doc/classes/BaseButton.xml:123
msgid ""
"Require a press and a subsequent release before considering the button "
"clicked."
@@ -9104,22 +9279,22 @@ msgstr ""
msgid "Represents the size of the [enum TextureParam] enum."
msgstr ""
-#: doc/classes/BaseMaterial3D.xml:451 doc/classes/RenderingServer.xml:3657
-#: doc/classes/Viewport.xml:390
+#: doc/classes/BaseMaterial3D.xml:451 doc/classes/RenderingServer.xml:3668
+#: doc/classes/Viewport.xml:393
msgid ""
"The texture filter reads from the nearest pixel only. The simplest and "
"fastest method of filtering, but the texture will look pixelized."
msgstr ""
-#: doc/classes/BaseMaterial3D.xml:454 doc/classes/RenderingServer.xml:3660
-#: doc/classes/Viewport.xml:393
+#: doc/classes/BaseMaterial3D.xml:454 doc/classes/RenderingServer.xml:3671
+#: doc/classes/Viewport.xml:396
msgid ""
"The texture filter blends between the nearest 4 pixels. Use this when you "
"want to avoid a pixelated style, but do not want mipmaps."
msgstr ""
-#: doc/classes/BaseMaterial3D.xml:457 doc/classes/RenderingServer.xml:3663
-#: doc/classes/Viewport.xml:396
+#: doc/classes/BaseMaterial3D.xml:457 doc/classes/RenderingServer.xml:3674
+#: doc/classes/Viewport.xml:399
msgid ""
"The texture filter reads from the nearest pixel in the nearest mipmap. The "
"fastest way to read from textures with mipmaps."
@@ -9132,14 +9307,14 @@ msgid ""
"smooth out pixels that are far from the camera."
msgstr ""
-#: doc/classes/BaseMaterial3D.xml:463 doc/classes/RenderingServer.xml:3669
+#: doc/classes/BaseMaterial3D.xml:463 doc/classes/RenderingServer.xml:3680
msgid ""
"The texture filter reads from the nearest pixel, but selects a mipmap based "
"on the angle between the surface and the camera view. This reduces artifacts "
"on surfaces that are almost in line with the camera."
msgstr ""
-#: doc/classes/BaseMaterial3D.xml:466 doc/classes/RenderingServer.xml:3672
+#: doc/classes/BaseMaterial3D.xml:466 doc/classes/RenderingServer.xml:3683
msgid ""
"The texture filter blends between the nearest 4 pixels and selects a mipmap "
"based on the angle between the surface and the camera view. This reduces "
@@ -9148,7 +9323,7 @@ msgid ""
"texturing."
msgstr ""
-#: doc/classes/BaseMaterial3D.xml:469 doc/classes/CanvasItem.xml:685
+#: doc/classes/BaseMaterial3D.xml:469 doc/classes/CanvasItem.xml:695
msgid "Represents the size of the [enum TextureFilter] enum."
msgstr ""
@@ -9371,8 +9546,8 @@ msgstr ""
msgid "Enables the shadow to opacity feature."
msgstr ""
-#: doc/classes/BaseMaterial3D.xml:622 doc/classes/RenderingServer.xml:3684
-#: doc/classes/Viewport.xml:408
+#: doc/classes/BaseMaterial3D.xml:622 doc/classes/RenderingServer.xml:3695
+#: doc/classes/Viewport.xml:411
msgid ""
"Enables the texture to repeat when UV coordinates are outside the 0-1 range. "
"If using one of the linear filtering modes, this can result in artifacts at "
@@ -9513,167 +9688,195 @@ msgstr ""
#: doc/classes/Basis.xml:7
msgid ""
-"3×3 matrix used for 3D rotation and scale. Contains 3 vector fields X, Y and "
-"Z as its columns, which can be interpreted as the local basis vectors of a "
-"transformation. Can also be accessed as array of 3D vectors. These vectors "
-"are orthogonal to each other, but are not necessarily normalized (due to "
-"scaling). Almost always used as an orthogonal basis for a [Transform].\n"
-"For such use, it is composed of a scaling and a rotation matrix, in that "
-"order (M = R.S)."
+"3×3 matrix used for 3D rotation and scale. Almost always used as an "
+"orthogonal basis for a Transform.\n"
+"Contains 3 vector fields X, Y and Z as its columns, which are typically "
+"interpreted as the local basis vectors of a transformation. For such use, it "
+"is composed of a scaling and a rotation matrix, in that order (M = R.S).\n"
+"Can also be accessed as array of 3D vectors. These vectors are normally "
+"orthogonal to each other, but are not necessarily normalized (due to "
+"scaling).\n"
+"For more information, read the \"Matrices and transforms\" documentation "
+"article."
+msgstr ""
+
+#: doc/classes/Basis.xml:13 doc/classes/Transform.xml:12
+#: doc/classes/Transform2D.xml:11
+msgid ""
+"https://docs.godotengine.org/en/latest/tutorials/math/"
+"matrices_and_transforms.html"
msgstr ""
-#: doc/classes/Basis.xml:11 doc/classes/Transform.xml:11
+#: doc/classes/Basis.xml:14 doc/classes/Transform.xml:13
msgid ""
"https://docs.godotengine.org/en/latest/tutorials/3d/using_transforms.html"
msgstr ""
-#: doc/classes/Basis.xml:20
-msgid "Create a rotation matrix from the given quaternion."
+#: doc/classes/Basis.xml:23
+msgid "Constructs a pure rotation basis matrix from the given quaternion."
msgstr ""
-#: doc/classes/Basis.xml:29
+#: doc/classes/Basis.xml:32
msgid ""
-"Create a rotation matrix (in the YXZ convention: first Z, then X, and Y "
-"last) from the specified Euler angles, given in the vector format as (X "
-"angle, Y angle, Z angle)."
+"Constructs a pure rotation basis matrix from the given Euler angles (in the "
+"YXZ convention: when *composing*, first Y, then X, and Z last), given in the "
+"vector format as (X angle, Y angle, Z angle).\n"
+"Consider using the [Quat] constructor instead, which uses a quaternion "
+"instead of Euler angles."
msgstr ""
-#: doc/classes/Basis.xml:40
+#: doc/classes/Basis.xml:44
msgid ""
-"Create a rotation matrix which rotates around the given axis by the "
-"specified angle, in radians. The axis must be a normalized vector."
+"Constructs a pure rotation basis matrix, rotated around the given "
+"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a "
+"normalized vector."
msgstr ""
-#: doc/classes/Basis.xml:53
-msgid "Create a matrix from 3 axis vectors."
+#: doc/classes/Basis.xml:57
+msgid "Constructs a basis matrix from 3 axis vectors (matrix columns)."
msgstr ""
-#: doc/classes/Basis.xml:60
-msgid "Returns the determinant of the matrix."
+#: doc/classes/Basis.xml:64
+msgid ""
+"Returns the determinant of the basis matrix. If the basis is uniformly "
+"scaled, its determinant is the square of the scale.\n"
+"A negative determinant means the basis has a negative scale. A zero "
+"determinant means the basis isn't invertible, and is usually considered "
+"invalid."
msgstr ""
-#: doc/classes/Basis.xml:67
+#: doc/classes/Basis.xml:72
msgid ""
"Returns the basis's rotation in the form of Euler angles (in the YXZ "
-"convention: first Z, then X, and Y last). The returned vector contains the "
-"rotation angles in the format (X angle, Y angle, Z angle). See [method "
-"get_rotation_quat] if you need a quaternion instead."
+"convention: when decomposing, first Z, then X, and Y last). The returned "
+"vector contains the rotation angles in the format (X angle, Y angle, Z "
+"angle).\n"
+"Consider using the [method get_rotation_quat] method instead, which returns "
+"a [Quat] quaternion instead of Euler angles."
msgstr ""
-#: doc/classes/Basis.xml:74
+#: doc/classes/Basis.xml:80
msgid ""
"This function considers a discretization of rotations into 24 points on unit "
"sphere, lying along the vectors (x,y,z) with each component being either -1, "
"0, or 1, and returns the index of the point best representing the "
-"orientation of the object. It is mainly used by the grid map editor. For "
+"orientation of the object. It is mainly used by the [GridMap] editor. For "
"further details, refer to the Godot source code."
msgstr ""
-#: doc/classes/Basis.xml:81
+#: doc/classes/Basis.xml:87
msgid ""
"Returns the basis's rotation in the form of a quaternion. See [method "
"get_euler] if you need Euler angles, but keep in mind quaternions should "
"generally be preferred to Euler angles."
msgstr ""
-#: doc/classes/Basis.xml:88
+#: doc/classes/Basis.xml:94
msgid ""
"Assuming that the matrix is the combination of a rotation and scaling, "
"return the absolute value of scaling factors along each axis."
msgstr ""
-#: doc/classes/Basis.xml:95 doc/classes/Transform2D.xml:49
+#: doc/classes/Basis.xml:101
msgid "Returns the inverse of the matrix."
msgstr ""
-#: doc/classes/Basis.xml:106
+#: doc/classes/Basis.xml:112
msgid ""
"Returns [code]true[/code] if this basis and [code]b[/code] are approximately "
"equal, by calling [code]is_equal_approx[/code] on each component."
msgstr ""
-#: doc/classes/Basis.xml:113
+#: doc/classes/Basis.xml:119
msgid ""
"Returns the orthonormalized version of the matrix (useful to call from time "
"to time to avoid rounding error for orthogonal matrices). This performs a "
"Gram-Schmidt orthonormalization on the basis of the matrix."
msgstr ""
-#: doc/classes/Basis.xml:124
+#: doc/classes/Basis.xml:130
msgid ""
"Introduce an additional rotation around the given axis by phi (radians). The "
"axis must be a normalized vector."
msgstr ""
-#: doc/classes/Basis.xml:133
+#: doc/classes/Basis.xml:139
msgid ""
"Introduce an additional scaling specified by the given 3D scaling factor."
msgstr ""
-#: doc/classes/Basis.xml:144
+#: doc/classes/Basis.xml:150
msgid ""
"Assuming that the matrix is a proper rotation matrix, slerp performs a "
"spherical-linear interpolation with another rotation matrix."
msgstr ""
-#: doc/classes/Basis.xml:153
+#: doc/classes/Basis.xml:159
msgid "Transposed dot product with the X axis of the matrix."
msgstr ""
-#: doc/classes/Basis.xml:162
+#: doc/classes/Basis.xml:168
msgid "Transposed dot product with the Y axis of the matrix."
msgstr ""
-#: doc/classes/Basis.xml:171
+#: doc/classes/Basis.xml:177
msgid "Transposed dot product with the Z axis of the matrix."
msgstr ""
-#: doc/classes/Basis.xml:178
+#: doc/classes/Basis.xml:184
msgid "Returns the transposed version of the matrix."
msgstr ""
-#: doc/classes/Basis.xml:187
+#: doc/classes/Basis.xml:193
msgid "Returns a vector transformed (multiplied) by the matrix."
msgstr ""
-#: doc/classes/Basis.xml:196
+#: doc/classes/Basis.xml:202
msgid ""
-"Returns a vector transformed (multiplied) by the transposed matrix.\n"
+"Returns a vector transformed (multiplied) by the transposed basis matrix.\n"
"[b]Note:[/b] This results in a multiplication by the inverse of the matrix "
"only if it represents a rotation-reflection."
msgstr ""
-#: doc/classes/Basis.xml:203
-msgid "The basis matrix's X vector."
+#: doc/classes/Basis.xml:209 doc/classes/Transform2D.xml:181
+msgid ""
+"The basis matrix's X vector (column 0). Equivalent to array index [code]0[/"
+"code]."
msgstr ""
-#: doc/classes/Basis.xml:206
-msgid "The basis matrix's Y vector."
+#: doc/classes/Basis.xml:212 doc/classes/Transform2D.xml:184
+msgid ""
+"The basis matrix's Y vector (column 1). Equivalent to array index [code]1[/"
+"code]."
msgstr ""
-#: doc/classes/Basis.xml:209
-msgid "The basis matrix's Z vector."
+#: doc/classes/Basis.xml:215
+msgid ""
+"The basis matrix's Z vector (column 2). Equivalent to array index [code]2[/"
+"code]."
msgstr ""
-#: doc/classes/Basis.xml:214
+#: doc/classes/Basis.xml:220
msgid ""
-"The identity basis. This is identical to calling [code]Basis()[/code] "
-"without any parameters. This constant can be used to make your code clearer."
+"The identity basis, with no rotation or scaling applied.\n"
+"This is identical to calling [code]Basis()[/code] without any parameters. "
+"This constant can be used to make your code clearer, and for consistency "
+"with C#."
msgstr ""
-#: doc/classes/Basis.xml:217
+#: doc/classes/Basis.xml:224
msgid ""
"The basis that will flip something along the X axis when used in a "
"transformation."
msgstr ""
-#: doc/classes/Basis.xml:220
+#: doc/classes/Basis.xml:227
msgid ""
"The basis that will flip something along the Y axis when used in a "
"transformation."
msgstr ""
-#: doc/classes/Basis.xml:223
+#: doc/classes/Basis.xml:230
msgid ""
"The basis that will flip something along the Z axis when used in a "
"transformation."
@@ -9986,97 +10189,111 @@ msgstr ""
#: doc/classes/Button.xml:7
msgid ""
"Button is the standard themed button. It can contain text and an icon, and "
-"will display them according to the current [Theme]."
+"will display them according to the current [Theme].\n"
+"[b]Example of creating a button and assigning an action when pressed by code:"
+"[/b]\n"
+"[codeblock]\n"
+"func _ready():\n"
+" var button = Button.new()\n"
+" button.text = \"Click me\"\n"
+" button.connect(\"pressed\", self, \"_button_pressed\")\n"
+" add_child(button)\n"
+"\n"
+"func _button_pressed():\n"
+" print(\"Hello world!\")\n"
+"[/codeblock]\n"
+"Buttons (like all Control nodes) can also be created in the editor, but some "
+"situations may require creating them from code."
msgstr ""
-#: doc/classes/Button.xml:15
+#: doc/classes/Button.xml:27
msgid ""
"Text alignment policy for the button's text, use one of the [enum TextAlign] "
"constants."
msgstr ""
-#: doc/classes/Button.xml:18
+#: doc/classes/Button.xml:30
msgid ""
"When this property is enabled, text that is too large to fit the button is "
"clipped, when disabled the Button will always be wide enough to hold the "
"text."
msgstr ""
-#: doc/classes/Button.xml:21
+#: doc/classes/Button.xml:33
msgid ""
"When enabled, the button's icon will expand/shrink to fit the button's size "
"while keeping its aspect."
msgstr ""
-#: doc/classes/Button.xml:24
+#: doc/classes/Button.xml:36
msgid "Flat buttons don't display decoration."
msgstr ""
-#: doc/classes/Button.xml:27
+#: doc/classes/Button.xml:39
msgid ""
"Button's icon, if text is present the icon will be placed before the text."
msgstr ""
-#: doc/classes/Button.xml:30 doc/classes/LinkButton.xml:18
+#: doc/classes/Button.xml:42 doc/classes/LinkButton.xml:18
msgid "The button's text that will be displayed inside the button's area."
msgstr ""
-#: doc/classes/Button.xml:35
+#: doc/classes/Button.xml:47
msgid "Align the text to the left."
msgstr ""
-#: doc/classes/Button.xml:38
+#: doc/classes/Button.xml:50
msgid "Align the text to the center."
msgstr ""
-#: doc/classes/Button.xml:41
+#: doc/classes/Button.xml:53
msgid "Align the text to the right."
msgstr ""
-#: doc/classes/Button.xml:46
+#: doc/classes/Button.xml:58
msgid "[StyleBox] used when the [Button] is disabled."
msgstr ""
-#: doc/classes/Button.xml:49
+#: doc/classes/Button.xml:61
msgid ""
"[StyleBox] used when the [Button] is focused. It is displayed over the "
"current [StyleBox], so using [StyleBoxEmpty] will just disable the focus "
"visual effect."
msgstr ""
-#: doc/classes/Button.xml:52
+#: doc/classes/Button.xml:64
msgid "[Font] of the [Button]'s text."
msgstr ""
-#: doc/classes/Button.xml:55
+#: doc/classes/Button.xml:67
msgid "Default text [Color] of the [Button]."
msgstr ""
-#: doc/classes/Button.xml:58
+#: doc/classes/Button.xml:70
msgid "Text [Color] used when the [Button] is disabled."
msgstr ""
-#: doc/classes/Button.xml:61
+#: doc/classes/Button.xml:73
msgid "Text [Color] used when the [Button] is being hovered."
msgstr ""
-#: doc/classes/Button.xml:64
+#: doc/classes/Button.xml:76
msgid "Text [Color] used when the [Button] is being pressed."
msgstr ""
-#: doc/classes/Button.xml:67
+#: doc/classes/Button.xml:79
msgid "[StyleBox] used when the [Button] is being hovered."
msgstr ""
-#: doc/classes/Button.xml:70
+#: doc/classes/Button.xml:82
msgid "The horizontal space between [Button]'s icon and text."
msgstr ""
-#: doc/classes/Button.xml:73
+#: doc/classes/Button.xml:85
msgid "Default [StyleBox] for the [Button]."
msgstr ""
-#: doc/classes/Button.xml:76
+#: doc/classes/Button.xml:88
msgid "[StyleBox] used when the [Button] is being pressed."
msgstr ""
@@ -10728,7 +10945,7 @@ msgstr ""
#: doc/classes/CameraEffects.xml:37
msgid ""
"The exposure override value to use. Higher values will result in a brighter "
-"scene. Only effective if [member override_exposure_enable] is [code]true[/"
+"scene. Only effective if [member override_exposure_enabled] is [code]true[/"
"code]."
msgstr ""
@@ -10982,265 +11199,282 @@ msgid ""
msgstr ""
#: doc/classes/CanvasItem.xml:319
-msgid "Draws a string using a custom font."
+msgid ""
+"Draws [code]text[/code] using the specified [code]font[/code] at the "
+"[code]position[/code] (top-left corner). The text will have its color "
+"multiplied by [code]modulate[/code]. If [code]clip_w[/code] is greater than "
+"or equal to 0, the text will be clipped if it exceeds the specified width.\n"
+"[b]Example using the default project font:[/b]\n"
+"[codeblock]\n"
+"# If using this method in a script that redraws constantly, move the\n"
+"# `default_font` declaration to a member variable assigned in `_ready()`\n"
+"# so the Control is only created once.\n"
+"var default_font = Control.new().get_font(\"font\")\n"
+"draw_string(default_font, Vector2(64, 64), \"Hello world\")\n"
+"[/codeblock]\n"
+"See also [method Font.draw]."
msgstr ""
-#: doc/classes/CanvasItem.xml:330
+#: doc/classes/CanvasItem.xml:339
msgid "Draws a styled rectangle."
msgstr ""
-#: doc/classes/CanvasItem.xml:353
+#: doc/classes/CanvasItem.xml:362
msgid "Draws a texture at a given position."
msgstr ""
-#: doc/classes/CanvasItem.xml:380
+#: doc/classes/CanvasItem.xml:389
msgid ""
"Draws a textured rectangle at a given position, optionally modulated by a "
"color. If [code]transpose[/code] is [code]true[/code], the texture will have "
"its X and Y coordinates swapped."
msgstr ""
-#: doc/classes/CanvasItem.xml:409
+#: doc/classes/CanvasItem.xml:418
msgid ""
"Draws a textured rectangle region at a given position, optionally modulated "
"by a color. If [code]transpose[/code] is [code]true[/code], the texture will "
"have its X and Y coordinates swapped."
msgstr ""
-#: doc/classes/CanvasItem.xml:416 doc/classes/Node3D.xml:19
+#: doc/classes/CanvasItem.xml:425 doc/classes/Node3D.xml:19
msgid ""
"Forces the transform to update. Transform changes in physics are not instant "
"for performance reasons. Transforms are accumulated and then set. Use this "
"if you need an up-to-date transform when doing physics operations."
msgstr ""
-#: doc/classes/CanvasItem.xml:423
+#: doc/classes/CanvasItem.xml:432
msgid "Returns the [RID] of the [World2D] canvas where this item is in."
msgstr ""
-#: doc/classes/CanvasItem.xml:430
+#: doc/classes/CanvasItem.xml:439
msgid "Returns the canvas item RID used by [RenderingServer] for this item."
msgstr ""
-#: doc/classes/CanvasItem.xml:437
+#: doc/classes/CanvasItem.xml:446
msgid "Returns the transform matrix of this item's canvas."
msgstr ""
-#: doc/classes/CanvasItem.xml:444
+#: doc/classes/CanvasItem.xml:453
msgid "Returns the global position of the mouse."
msgstr ""
-#: doc/classes/CanvasItem.xml:451
+#: doc/classes/CanvasItem.xml:460
msgid "Returns the global transform matrix of this item."
msgstr ""
-#: doc/classes/CanvasItem.xml:458
+#: doc/classes/CanvasItem.xml:467
msgid ""
"Returns the global transform matrix of this item in relation to the canvas."
msgstr ""
-#: doc/classes/CanvasItem.xml:465
+#: doc/classes/CanvasItem.xml:474
msgid "Returns the mouse position relative to this item's position."
msgstr ""
-#: doc/classes/CanvasItem.xml:472
+#: doc/classes/CanvasItem.xml:481
msgid "Returns the transform matrix of this item."
msgstr ""
-#: doc/classes/CanvasItem.xml:479
+#: doc/classes/CanvasItem.xml:488
msgid "Returns the viewport's boundaries as a [Rect2]."
msgstr ""
-#: doc/classes/CanvasItem.xml:486
+#: doc/classes/CanvasItem.xml:495
msgid "Returns this item's transform in relation to the viewport."
msgstr ""
-#: doc/classes/CanvasItem.xml:493
+#: doc/classes/CanvasItem.xml:502
msgid "Returns the [World2D] where this item is in."
msgstr ""
-#: doc/classes/CanvasItem.xml:500
+#: doc/classes/CanvasItem.xml:509
msgid "Hide the [CanvasItem] if it's currently visible."
msgstr ""
-#: doc/classes/CanvasItem.xml:507
+#: doc/classes/CanvasItem.xml:516
msgid ""
"Returns [code]true[/code] if local transform notifications are communicated "
"to children."
msgstr ""
-#: doc/classes/CanvasItem.xml:514
+#: doc/classes/CanvasItem.xml:523
msgid ""
"Returns [code]true[/code] if the node is set as top-level. See [method "
-"set_as_toplevel]."
+"set_as_top_level]."
msgstr ""
-#: doc/classes/CanvasItem.xml:521
+#: doc/classes/CanvasItem.xml:530
msgid ""
"Returns [code]true[/code] if global transform notifications are communicated "
"to children."
msgstr ""
-#: doc/classes/CanvasItem.xml:528
+#: doc/classes/CanvasItem.xml:537 doc/classes/Node3D.xml:104
msgid ""
"Returns [code]true[/code] if the node is present in the [SceneTree], its "
-"[member visible] property is [code]true[/code] and its inherited visibility "
-"is also [code]true[/code]."
+"[member visible] property is [code]true[/code] and all its antecedents are "
+"also visible. If any antecedent is hidden, this node will not be visible in "
+"the scene tree."
msgstr ""
-#: doc/classes/CanvasItem.xml:537
+#: doc/classes/CanvasItem.xml:546
msgid "Assigns [code]screen_point[/code] as this node's new local transform."
msgstr ""
-#: doc/classes/CanvasItem.xml:546
+#: doc/classes/CanvasItem.xml:555
msgid ""
"Transformations issued by [code]event[/code]'s inputs are applied in local "
"space instead of global space."
msgstr ""
-#: doc/classes/CanvasItem.xml:555
+#: doc/classes/CanvasItem.xml:564
msgid ""
"If [code]enable[/code] is [code]true[/code], the node won't inherit its "
"transform from parent canvas items."
msgstr ""
-#: doc/classes/CanvasItem.xml:564
+#: doc/classes/CanvasItem.xml:573
msgid ""
"If [code]enable[/code] is [code]true[/code], children will be updated with "
"local transform data."
msgstr ""
-#: doc/classes/CanvasItem.xml:573
+#: doc/classes/CanvasItem.xml:582
msgid ""
"If [code]enable[/code] is [code]true[/code], children will be updated with "
"global transform data."
msgstr ""
-#: doc/classes/CanvasItem.xml:580
+#: doc/classes/CanvasItem.xml:589
msgid ""
"Show the [CanvasItem] if it's currently hidden. For controls that inherit "
"[Popup], the correct way to make them visible is to call one of the multiple "
"[code]popup*()[/code] functions instead."
msgstr ""
-#: doc/classes/CanvasItem.xml:587
+#: doc/classes/CanvasItem.xml:596
msgid ""
"Queue the [CanvasItem] for update. [constant NOTIFICATION_DRAW] will be "
"called on idle time to request redraw."
msgstr ""
-#: doc/classes/CanvasItem.xml:593
+#: doc/classes/CanvasItem.xml:602
msgid ""
"The rendering layers in which this [CanvasItem] responds to [Light2D] nodes."
msgstr ""
-#: doc/classes/CanvasItem.xml:596
+#: doc/classes/CanvasItem.xml:605
msgid "The material applied to textures on this [CanvasItem]."
msgstr ""
-#: doc/classes/CanvasItem.xml:599
+#: doc/classes/CanvasItem.xml:608
msgid "The color applied to textures on this [CanvasItem]."
msgstr ""
-#: doc/classes/CanvasItem.xml:602
+#: doc/classes/CanvasItem.xml:611
msgid ""
"The color applied to textures on this [CanvasItem]. This is not inherited by "
"children [CanvasItem]s."
msgstr ""
-#: doc/classes/CanvasItem.xml:605
+#: doc/classes/CanvasItem.xml:614
msgid "If [code]true[/code], the object draws behind its parent."
msgstr ""
-#: doc/classes/CanvasItem.xml:608
+#: doc/classes/CanvasItem.xml:617
msgid "If [code]true[/code], the object draws on top of its parent."
msgstr ""
-#: doc/classes/CanvasItem.xml:611
+#: doc/classes/CanvasItem.xml:620
msgid "The texture filtering mode to use on this [CanvasItem]."
msgstr ""
-#: doc/classes/CanvasItem.xml:614
+#: doc/classes/CanvasItem.xml:623
msgid "The texture repeating mode to use on this [CanvasItem]."
msgstr ""
-#: doc/classes/CanvasItem.xml:617
+#: doc/classes/CanvasItem.xml:626
msgid ""
"If [code]true[/code], the parent [CanvasItem]'s [member material] property "
"is used as this one's material."
msgstr ""
-#: doc/classes/CanvasItem.xml:620
+#: doc/classes/CanvasItem.xml:629
msgid ""
-"If [code]true[/code], this [CanvasItem] is drawn. For controls that inherit "
-"[Popup], the correct way to make them visible is to call one of the multiple "
-"[code]popup*()[/code] functions instead."
+"If [code]true[/code], this [CanvasItem] is drawn. The node is only visible "
+"if all of its antecedents are visible as well (in other words, [method "
+"is_visible_in_tree] must return [code]true[/code]).\n"
+"[b]Note:[/b] For controls that inherit [Popup], the correct way to make them "
+"visible is to call one of the multiple [code]popup*()[/code] functions "
+"instead."
msgstr ""
-#: doc/classes/CanvasItem.xml:626
+#: doc/classes/CanvasItem.xml:636
msgid ""
"Emitted when the [CanvasItem] must redraw. This can only be connected "
"realtime, as deferred will not allow drawing."
msgstr ""
-#: doc/classes/CanvasItem.xml:631
+#: doc/classes/CanvasItem.xml:641
msgid "Emitted when becoming hidden."
msgstr ""
-#: doc/classes/CanvasItem.xml:636
+#: doc/classes/CanvasItem.xml:646
msgid "Emitted when the item rect has changed."
msgstr ""
-#: doc/classes/CanvasItem.xml:641
+#: doc/classes/CanvasItem.xml:651
msgid "Emitted when the visibility (hidden/visible) changes."
msgstr ""
-#: doc/classes/CanvasItem.xml:647
+#: doc/classes/CanvasItem.xml:657
msgid ""
"The [CanvasItem]'s transform has changed. This notification is only received "
"if enabled by [method set_notify_transform] or [method "
"set_notify_local_transform]."
msgstr ""
-#: doc/classes/CanvasItem.xml:650
+#: doc/classes/CanvasItem.xml:660
msgid "The [CanvasItem] is requested to draw."
msgstr ""
-#: doc/classes/CanvasItem.xml:653
+#: doc/classes/CanvasItem.xml:663
msgid "The [CanvasItem]'s visibility has changed."
msgstr ""
-#: doc/classes/CanvasItem.xml:656
+#: doc/classes/CanvasItem.xml:666
msgid "The [CanvasItem] has entered the canvas."
msgstr ""
-#: doc/classes/CanvasItem.xml:659
+#: doc/classes/CanvasItem.xml:669
msgid "The [CanvasItem] has exited the canvas."
msgstr ""
-#: doc/classes/CanvasItem.xml:662 doc/classes/CanvasItem.xml:688
+#: doc/classes/CanvasItem.xml:672 doc/classes/CanvasItem.xml:698
msgid "The [CanvasItem] will inherit the filter from its parent."
msgstr ""
-#: doc/classes/CanvasItem.xml:665
+#: doc/classes/CanvasItem.xml:675
msgid ""
"The texture filter reads from the nearest pixel only. The simplest and "
"fastest method of filtering. Useful for pixel art."
msgstr ""
-#: doc/classes/CanvasItem.xml:668
+#: doc/classes/CanvasItem.xml:678
msgid ""
"The texture filter blends between the nearest four pixels. Use this for most "
"cases where you want to avoid a pixelated style."
msgstr ""
-#: doc/classes/CanvasItem.xml:671
+#: doc/classes/CanvasItem.xml:681
msgid ""
"The texture filter reads from the nearest pixel in the nearest mipmap. This "
"is the fastest way to read from textures with mipmaps."
msgstr ""
-#: doc/classes/CanvasItem.xml:674
+#: doc/classes/CanvasItem.xml:684
msgid ""
"The texture filter blends between the nearest 4 pixels and between the "
"nearest 2 mipmaps. Use this for non-pixel art textures that may be viewed at "
@@ -11248,7 +11482,7 @@ msgid ""
"smooth out pixels that are smaller than on-screen pixels."
msgstr ""
-#: doc/classes/CanvasItem.xml:677
+#: doc/classes/CanvasItem.xml:687
msgid ""
"The texture filter reads from the nearest pixel, but selects a mipmap based "
"on the angle between the surface and the camera view. This reduces artifacts "
@@ -11257,7 +11491,7 @@ msgid ""
"TEXTURE_FILTER_NEAREST_WITH_MIPMAPS] is usually more appropriate."
msgstr ""
-#: doc/classes/CanvasItem.xml:681
+#: doc/classes/CanvasItem.xml:691
msgid ""
"The texture filter blends between the nearest 4 pixels and selects a mipmap "
"based on the angle between the surface and the camera view. This reduces "
@@ -11268,21 +11502,21 @@ msgid ""
"TEXTURE_FILTER_LINEAR_WITH_MIPMAPS] is usually more appropriate."
msgstr ""
-#: doc/classes/CanvasItem.xml:691
+#: doc/classes/CanvasItem.xml:701
msgid "Texture will not repeat."
msgstr ""
-#: doc/classes/CanvasItem.xml:694
+#: doc/classes/CanvasItem.xml:704
msgid "Texture will repeat normally."
msgstr ""
-#: doc/classes/CanvasItem.xml:697
+#: doc/classes/CanvasItem.xml:707
msgid ""
"Texture will repeat in a 2x2 tiled mode, where elements at even positions "
"are mirrored."
msgstr ""
-#: doc/classes/CanvasItem.xml:700
+#: doc/classes/CanvasItem.xml:710
msgid "Represents the size of the [enum TextureRepeat] enum."
msgstr ""
@@ -12355,16 +12589,15 @@ msgid ""
msgstr ""
#: doc/classes/Color.xml:4
-msgid "Color in RGBA format with some support for ARGB format."
+msgid "Color in RGBA format using floats on the range of 0 to 1."
msgstr ""
#: doc/classes/Color.xml:7
msgid ""
-"A color is represented by red, green, and blue [code](r, g, b)[/code] "
-"components. Additionally, [code]a[/code] represents the alpha component, "
-"often used for transparency. Values are in floating-point and usually range "
-"from 0 to 1. Some properties (such as [member CanvasItem.modulate]) may "
-"accept values greater than 1.\n"
+"A color represented by red, green, blue, and alpha (RGBA) components. The "
+"alpha component is often used for transparency. Values are in floating-point "
+"and usually range from 0 to 1. Some properties (such as CanvasItem.modulate) "
+"may accept values greater than 1 (overbright or HDR colors).\n"
"You can also create a color from standardized color names by using [method "
"@GDScript.ColorN] or directly using the color constants defined here. The "
"standardized color set is based on the [url=https://en.wikipedia.org/wiki/"
@@ -12578,47 +12811,48 @@ msgid ""
msgstr ""
#: doc/classes/Color.xml:280
-msgid "Alpha value (range 0 to 1)."
+msgid ""
+"The color's alpha (transparency) component, typically on the range of 0 to 1."
msgstr ""
#: doc/classes/Color.xml:283
-msgid "Alpha value (range 0 to 255)."
+msgid "Wrapper for [member a] that uses the range 0 to 255 instead of 0 to 1."
msgstr ""
#: doc/classes/Color.xml:286
-msgid "Blue value (range 0 to 1)."
+msgid "The color's blue component, typically on the range of 0 to 1."
msgstr ""
#: doc/classes/Color.xml:289
-msgid "Blue value (range 0 to 255)."
+msgid "Wrapper for [member b] that uses the range 0 to 255 instead of 0 to 1."
msgstr ""
#: doc/classes/Color.xml:292
-msgid "Green value (range 0 to 1)."
+msgid "The color's green component, typically on the range of 0 to 1."
msgstr ""
#: doc/classes/Color.xml:295
-msgid "Green value (range 0 to 255)."
+msgid "Wrapper for [member g] that uses the range 0 to 255 instead of 0 to 1."
msgstr ""
#: doc/classes/Color.xml:298
-msgid "HSV hue value (range 0 to 1)."
+msgid "The HSV hue of this color, on the range 0 to 1."
msgstr ""
#: doc/classes/Color.xml:301
-msgid "Red value (range 0 to 1)."
+msgid "The color's red component, typically on the range of 0 to 1."
msgstr ""
#: doc/classes/Color.xml:304
-msgid "Red value (range 0 to 255)."
+msgid "Wrapper for [member r] that uses the range 0 to 255 instead of 0 to 1."
msgstr ""
#: doc/classes/Color.xml:307
-msgid "HSV saturation value (range 0 to 1)."
+msgid "The HSV saturation of this color, on the range 0 to 1."
msgstr ""
#: doc/classes/Color.xml:310
-msgid "HSV value (range 0 to 1)."
+msgid "The HSV value (brightness) of this color, on the range 0 to 1."
msgstr ""
#: doc/classes/Color.xml:315
@@ -14162,7 +14396,7 @@ msgstr ""
#: doc/classes/Control.xml:545
msgid ""
-"Invalidates the size cache in this node and in parent nodes up to toplevel. "
+"Invalidates the size cache in this node and in parent nodes up to top_level. "
"Intended to be used with [method get_minimum_size] when the return value is "
"changed. Setting [member rect_min_size] directly calls this method "
"automatically."
@@ -14538,23 +14772,35 @@ msgstr ""
#: doc/classes/Control.xml:859
msgid ""
"The node's scale, relative to its [member rect_size]. Change this property "
-"to scale the node around its [member rect_pivot_offset]."
-msgstr ""
-
-#: doc/classes/Control.xml:862
+"to scale the node around its [member rect_pivot_offset]. The Control's "
+"[member hint_tooltip] will also scale according to this value.\n"
+"[b]Note:[/b] This property is mainly intended to be used for animation "
+"purposes. Text inside the Control will look pixelated or blurry when the "
+"Control is scaled. To support multiple resolutions in your project, use an "
+"appropriate viewport stretch mode as described in the [url=https://docs."
+"godotengine.org/en/latest/tutorials/viewports/multiple_resolutions."
+"html]documentation[/url] instead of scaling Controls individually.\n"
+"[b]Note:[/b] If the Control node is a child of a [Container] node, the scale "
+"will be reset to [code]Vector2(1, 1)[/code] when the scene is instanced. To "
+"set the Control's scale when it's instanced, wait for one frame using "
+"[code]yield(get_tree(), \"idle_frame\")[/code] then set its [member "
+"rect_scale] property."
+msgstr ""
+
+#: doc/classes/Control.xml:864
msgid ""
"The size of the node's bounding rectangle, in pixels. [Container] nodes "
"update this property automatically."
msgstr ""
-#: doc/classes/Control.xml:865
+#: doc/classes/Control.xml:867
msgid ""
"Tells the parent [Container] nodes how they should resize and place the node "
"on the X axis. Use one of the [enum SizeFlags] constants to change the "
"flags. See the constants to learn what each does."
msgstr ""
-#: doc/classes/Control.xml:868
+#: doc/classes/Control.xml:870
msgid ""
"If the node and at least one of its neighbours uses the [constant "
"SIZE_EXPAND] size flag, the parent [Container] will let it take more or less "
@@ -14563,181 +14809,181 @@ msgid ""
"space."
msgstr ""
-#: doc/classes/Control.xml:871
+#: doc/classes/Control.xml:873
msgid ""
"Tells the parent [Container] nodes how they should resize and place the node "
"on the Y axis. Use one of the [enum SizeFlags] constants to change the "
"flags. See the constants to learn what each does."
msgstr ""
-#: doc/classes/Control.xml:874
+#: doc/classes/Control.xml:876
msgid ""
"Changing this property replaces the current [Theme] resource this node and "
"all its [Control] children use."
msgstr ""
-#: doc/classes/Control.xml:880
+#: doc/classes/Control.xml:882
msgid "Emitted when the node gains keyboard focus."
msgstr ""
-#: doc/classes/Control.xml:885
+#: doc/classes/Control.xml:887
msgid "Emitted when the node loses keyboard focus."
msgstr ""
-#: doc/classes/Control.xml:892
+#: doc/classes/Control.xml:894
msgid "Emitted when the node receives an [InputEvent]."
msgstr ""
-#: doc/classes/Control.xml:897
+#: doc/classes/Control.xml:899
msgid "Emitted when the node's minimum size changes."
msgstr ""
-#: doc/classes/Control.xml:902
+#: doc/classes/Control.xml:904
msgid ""
"Emitted when the mouse enters the control's [code]Rect[/code] area, provided "
"its [member mouse_filter] lets the event reach it."
msgstr ""
-#: doc/classes/Control.xml:907
+#: doc/classes/Control.xml:909
msgid ""
"Emitted when the mouse leaves the control's [code]Rect[/code] area, provided "
"its [member mouse_filter] lets the event reach it."
msgstr ""
-#: doc/classes/Control.xml:912
+#: doc/classes/Control.xml:914
msgid "Emitted when the control changes size."
msgstr ""
-#: doc/classes/Control.xml:917
+#: doc/classes/Control.xml:919
msgid ""
"Emitted when one of the size flags changes. See [member "
"size_flags_horizontal] and [member size_flags_vertical]."
msgstr ""
-#: doc/classes/Control.xml:927
+#: doc/classes/Control.xml:929
msgid "The node cannot grab focus. Use with [member focus_mode]."
msgstr ""
-#: doc/classes/Control.xml:930
+#: doc/classes/Control.xml:932
msgid ""
"The node can only grab focus on mouse clicks. Use with [member focus_mode]."
msgstr ""
-#: doc/classes/Control.xml:933
+#: doc/classes/Control.xml:935
msgid ""
"The node can grab focus on mouse click or using the arrows and the Tab keys "
"on the keyboard. Use with [member focus_mode]."
msgstr ""
-#: doc/classes/Control.xml:936
+#: doc/classes/Control.xml:938
msgid ""
"Sent when the node changes size. Use [member rect_size] to get the new size."
msgstr ""
-#: doc/classes/Control.xml:939
+#: doc/classes/Control.xml:941
msgid "Sent when the mouse pointer enters the node."
msgstr ""
-#: doc/classes/Control.xml:942
+#: doc/classes/Control.xml:944
msgid "Sent when the mouse pointer exits the node."
msgstr ""
-#: doc/classes/Control.xml:945
+#: doc/classes/Control.xml:947
msgid "Sent when the node grabs focus."
msgstr ""
-#: doc/classes/Control.xml:948
+#: doc/classes/Control.xml:950
msgid "Sent when the node loses focus."
msgstr ""
-#: doc/classes/Control.xml:951
+#: doc/classes/Control.xml:953
msgid ""
"Sent when the node's [member theme] changes, right before Godot redraws the "
"control. Happens when you call one of the [code]add_theme_*_override[/code] "
"methods."
msgstr ""
-#: doc/classes/Control.xml:954
+#: doc/classes/Control.xml:956
msgid ""
"Sent when this node is inside a [ScrollContainer] which has begun being "
"scrolled."
msgstr ""
-#: doc/classes/Control.xml:957
+#: doc/classes/Control.xml:959
msgid ""
"Sent when this node is inside a [ScrollContainer] which has stopped being "
"scrolled."
msgstr ""
-#: doc/classes/Control.xml:960
+#: doc/classes/Control.xml:962
msgid ""
"Show the system's arrow mouse cursor when the user hovers the node. Use with "
"[member mouse_default_cursor_shape]."
msgstr ""
-#: doc/classes/Control.xml:963
+#: doc/classes/Control.xml:965
msgid ""
"Show the system's I-beam mouse cursor when the user hovers the node. The I-"
"beam pointer has a shape similar to \"I\". It tells the user they can "
"highlight or insert text."
msgstr ""
-#: doc/classes/Control.xml:966
+#: doc/classes/Control.xml:968
msgid ""
"Show the system's pointing hand mouse cursor when the user hovers the node."
msgstr ""
-#: doc/classes/Control.xml:969
+#: doc/classes/Control.xml:971
msgid "Show the system's cross mouse cursor when the user hovers the node."
msgstr ""
-#: doc/classes/Control.xml:972
+#: doc/classes/Control.xml:974
msgid ""
"Show the system's wait mouse cursor, often an hourglass, when the user "
"hovers the node."
msgstr ""
-#: doc/classes/Control.xml:975
+#: doc/classes/Control.xml:977
msgid ""
"Show the system's busy mouse cursor when the user hovers the node. Often an "
"hourglass."
msgstr ""
-#: doc/classes/Control.xml:978
+#: doc/classes/Control.xml:980
msgid ""
"Show the system's drag mouse cursor, often a closed fist or a cross symbol, "
"when the user hovers the node. It tells the user they're currently dragging "
"an item, like a node in the Scene dock."
msgstr ""
-#: doc/classes/Control.xml:981
+#: doc/classes/Control.xml:983
msgid ""
"Show the system's drop mouse cursor when the user hovers the node. It can be "
"an open hand. It tells the user they can drop an item they're currently "
"grabbing, like a node in the Scene dock."
msgstr ""
-#: doc/classes/Control.xml:984
+#: doc/classes/Control.xml:986
msgid ""
"Show the system's forbidden mouse cursor when the user hovers the node. "
"Often a crossed circle."
msgstr ""
-#: doc/classes/Control.xml:987
+#: doc/classes/Control.xml:989
msgid ""
"Show the system's vertical resize mouse cursor when the user hovers the "
"node. A double-headed vertical arrow. It tells the user they can resize the "
"window or the panel vertically."
msgstr ""
-#: doc/classes/Control.xml:990
+#: doc/classes/Control.xml:992
msgid ""
"Show the system's horizontal resize mouse cursor when the user hovers the "
"node. A double-headed horizontal arrow. It tells the user they can resize "
"the window or the panel horizontally."
msgstr ""
-#: doc/classes/Control.xml:993
+#: doc/classes/Control.xml:995
msgid ""
"Show the system's window resize mouse cursor when the user hovers the node. "
"The cursor is a double-headed arrow that goes from the bottom left to the "
@@ -14745,7 +14991,7 @@ msgid ""
"horizontally and vertically."
msgstr ""
-#: doc/classes/Control.xml:996
+#: doc/classes/Control.xml:998
msgid ""
"Show the system's window resize mouse cursor when the user hovers the node. "
"The cursor is a double-headed arrow that goes from the top left to the "
@@ -14753,93 +14999,93 @@ msgid ""
"they can resize the window or the panel both horizontally and vertically."
msgstr ""
-#: doc/classes/Control.xml:999
+#: doc/classes/Control.xml:1001
msgid ""
"Show the system's move mouse cursor when the user hovers the node. It shows "
"2 double-headed arrows at a 90 degree angle. It tells the user they can move "
"a UI element freely."
msgstr ""
-#: doc/classes/Control.xml:1002
+#: doc/classes/Control.xml:1004
msgid ""
"Show the system's vertical split mouse cursor when the user hovers the node. "
"On Windows, it's the same as [constant CURSOR_VSIZE]."
msgstr ""
-#: doc/classes/Control.xml:1005
+#: doc/classes/Control.xml:1007
msgid ""
"Show the system's horizontal split mouse cursor when the user hovers the "
"node. On Windows, it's the same as [constant CURSOR_HSIZE]."
msgstr ""
-#: doc/classes/Control.xml:1008
+#: doc/classes/Control.xml:1010
msgid ""
"Show the system's help mouse cursor when the user hovers the node, a "
"question mark."
msgstr ""
-#: doc/classes/Control.xml:1011
+#: doc/classes/Control.xml:1013
msgid ""
"Snap all 4 anchors to the top-left of the parent control's bounds. Use with "
"[method set_anchors_preset]."
msgstr ""
-#: doc/classes/Control.xml:1014
+#: doc/classes/Control.xml:1016
msgid ""
"Snap all 4 anchors to the top-right of the parent control's bounds. Use with "
"[method set_anchors_preset]."
msgstr ""
-#: doc/classes/Control.xml:1017
+#: doc/classes/Control.xml:1019
msgid ""
"Snap all 4 anchors to the bottom-left of the parent control's bounds. Use "
"with [method set_anchors_preset]."
msgstr ""
-#: doc/classes/Control.xml:1020
+#: doc/classes/Control.xml:1022
msgid ""
"Snap all 4 anchors to the bottom-right of the parent control's bounds. Use "
"with [method set_anchors_preset]."
msgstr ""
-#: doc/classes/Control.xml:1023
+#: doc/classes/Control.xml:1025
msgid ""
"Snap all 4 anchors to the center of the left edge of the parent control's "
"bounds. Use with [method set_anchors_preset]."
msgstr ""
-#: doc/classes/Control.xml:1026
+#: doc/classes/Control.xml:1028
msgid ""
"Snap all 4 anchors to the center of the top edge of the parent control's "
"bounds. Use with [method set_anchors_preset]."
msgstr ""
-#: doc/classes/Control.xml:1029
+#: doc/classes/Control.xml:1031
msgid ""
"Snap all 4 anchors to the center of the right edge of the parent control's "
"bounds. Use with [method set_anchors_preset]."
msgstr ""
-#: doc/classes/Control.xml:1032
+#: doc/classes/Control.xml:1034
msgid ""
"Snap all 4 anchors to the center of the bottom edge of the parent control's "
"bounds. Use with [method set_anchors_preset]."
msgstr ""
-#: doc/classes/Control.xml:1035
+#: doc/classes/Control.xml:1037
msgid ""
"Snap all 4 anchors to the center of the parent control's bounds. Use with "
"[method set_anchors_preset]."
msgstr ""
-#: doc/classes/Control.xml:1038
+#: doc/classes/Control.xml:1040
msgid ""
"Snap all 4 anchors to the left edge of the parent control. The left margin "
"becomes relative to the left edge and the top margin relative to the top "
"left corner of the node's parent. Use with [method set_anchors_preset]."
msgstr ""
-#: doc/classes/Control.xml:1041
+#: doc/classes/Control.xml:1043
msgid ""
"Snap all 4 anchors to the top edge of the parent control. The left margin "
"becomes relative to the top left corner, the top margin relative to the top "
@@ -14847,14 +15093,14 @@ msgid ""
"parent. Use with [method set_anchors_preset]."
msgstr ""
-#: doc/classes/Control.xml:1044
+#: doc/classes/Control.xml:1046
msgid ""
"Snap all 4 anchors to the right edge of the parent control. The right margin "
"becomes relative to the right edge and the top margin relative to the top "
"right corner of the node's parent. Use with [method set_anchors_preset]."
msgstr ""
-#: doc/classes/Control.xml:1047
+#: doc/classes/Control.xml:1049
msgid ""
"Snap all 4 anchors to the bottom edge of the parent control. The left margin "
"becomes relative to the bottom left corner, the bottom margin relative to "
@@ -14862,19 +15108,19 @@ msgid ""
"the node's parent. Use with [method set_anchors_preset]."
msgstr ""
-#: doc/classes/Control.xml:1050
+#: doc/classes/Control.xml:1052
msgid ""
"Snap all 4 anchors to a vertical line that cuts the parent control in half. "
"Use with [method set_anchors_preset]."
msgstr ""
-#: doc/classes/Control.xml:1053
+#: doc/classes/Control.xml:1055
msgid ""
"Snap all 4 anchors to a horizontal line that cuts the parent control in "
"half. Use with [method set_anchors_preset]."
msgstr ""
-#: doc/classes/Control.xml:1056
+#: doc/classes/Control.xml:1058
msgid ""
"Snap all 4 anchors to the respective corners of the parent control. Set all "
"4 margins to 0 after you applied this preset and the [Control] will fit its "
@@ -14882,30 +15128,30 @@ msgid ""
"editor. Use with [method set_anchors_preset]."
msgstr ""
-#: doc/classes/Control.xml:1059
+#: doc/classes/Control.xml:1061
msgid "The control will be resized to its minimum size."
msgstr ""
-#: doc/classes/Control.xml:1062
+#: doc/classes/Control.xml:1064
msgid "The control's width will not change."
msgstr ""
-#: doc/classes/Control.xml:1065
+#: doc/classes/Control.xml:1067
msgid "The control's height will not change."
msgstr ""
-#: doc/classes/Control.xml:1068
+#: doc/classes/Control.xml:1070
msgid "The control's size will not change."
msgstr ""
-#: doc/classes/Control.xml:1071
+#: doc/classes/Control.xml:1073
msgid ""
"Tells the parent [Container] to expand the bounds of this node to fill all "
"the available space without pushing any other node. Use with [member "
"size_flags_horizontal] and [member size_flags_vertical]."
msgstr ""
-#: doc/classes/Control.xml:1074
+#: doc/classes/Control.xml:1076
msgid ""
"Tells the parent [Container] to let this node take all the available space "
"on the axis you flag. If multiple neighboring nodes are set to expand, "
@@ -14914,13 +15160,13 @@ msgid ""
"[member size_flags_vertical]."
msgstr ""
-#: doc/classes/Control.xml:1077
+#: doc/classes/Control.xml:1079
msgid ""
"Sets the node's size flags to both fill and expand. See the 2 constants "
"above for more information."
msgstr ""
-#: doc/classes/Control.xml:1080
+#: doc/classes/Control.xml:1082
msgid ""
"Tells the parent [Container] to center the node in itself. It centers the "
"control based on its bounding box, so it doesn't work with the fill or "
@@ -14928,7 +15174,7 @@ msgid ""
"size_flags_vertical]."
msgstr ""
-#: doc/classes/Control.xml:1083
+#: doc/classes/Control.xml:1085
msgid ""
"Tells the parent [Container] to align the node with its end, either the "
"bottom or the right edge. It doesn't work with the fill or expand size "
@@ -14936,7 +15182,7 @@ msgid ""
"size_flags_vertical]."
msgstr ""
-#: doc/classes/Control.xml:1086
+#: doc/classes/Control.xml:1088
msgid ""
"The control will receive mouse button input events through [method "
"_gui_input] if clicked on. And the control will receive the [signal "
@@ -14945,7 +15191,7 @@ msgid ""
"other controls. This also results in blocking signals in other controls."
msgstr ""
-#: doc/classes/Control.xml:1089
+#: doc/classes/Control.xml:1091
msgid ""
"The control will receive mouse button input events through [method "
"_gui_input] if clicked on. And the control will receive the [signal "
@@ -14957,7 +15203,7 @@ msgid ""
"not be fired."
msgstr ""
-#: doc/classes/Control.xml:1092
+#: doc/classes/Control.xml:1094
msgid ""
"The control will not receive mouse button input events through [method "
"_gui_input]. The control will also not receive the [signal mouse_entered] "
@@ -14966,25 +15212,25 @@ msgid ""
"handled automatically."
msgstr ""
-#: doc/classes/Control.xml:1095
+#: doc/classes/Control.xml:1097
msgid ""
"The control will grow to the left or top to make up if its minimum size is "
"changed to be greater than its current size on the respective axis."
msgstr ""
-#: doc/classes/Control.xml:1098
+#: doc/classes/Control.xml:1100
msgid ""
"The control will grow to the right or bottom to make up if its minimum size "
"is changed to be greater than its current size on the respective axis."
msgstr ""
-#: doc/classes/Control.xml:1101
+#: doc/classes/Control.xml:1103
msgid ""
"The control will grow in both directions equally to make up if its minimum "
"size is changed to be greater than its current size."
msgstr ""
-#: doc/classes/Control.xml:1104
+#: doc/classes/Control.xml:1106
msgid ""
"Snaps one of the 4 anchor's sides to the origin of the node's [code]Rect[/"
"code], in the top left. Use it with one of the [code]anchor_*[/code] member "
@@ -14992,7 +15238,7 @@ msgid ""
"[method set_anchors_preset]."
msgstr ""
-#: doc/classes/Control.xml:1107
+#: doc/classes/Control.xml:1109
msgid ""
"Snaps one of the 4 anchor's sides to the end of the node's [code]Rect[/"
"code], in the bottom right. Use it with one of the [code]anchor_*[/code] "
@@ -16777,7 +17023,7 @@ msgstr ""
msgid ""
"Returns the [Texture2D] associated with the specified [enum DecalTexture]. "
"This is a convenience method, in most cases you should access the texture "
-"directly. \n"
+"directly.\n"
"For example, instead of [code]albedo_tex = $Decal.get_texture(Decal."
"TEXTURE_ALBEDO)[/code], use [code]albedo_tex = $Decal.texture_albedo[/"
"code].\n"
@@ -16793,7 +17039,7 @@ msgstr ""
msgid ""
"Sets the [Texture2D] associated with the specified [enum DecalTexture]. This "
"is a convenience method, in most cases you should access the texture "
-"directly. \n"
+"directly.\n"
"For example, instead of [code]$Decal.set_texture(Decal.TEXTURE_ALBEDO, "
"albedo_tex)[/code], use [code]$Decal.texture_albedo = albedo_tex[/code].\n"
"One case where this is better than accessing the texture directly is when "
@@ -17142,7 +17388,7 @@ msgstr ""
msgid "The light's shadow rendering algorithm. See [enum ShadowMode]."
msgstr ""
-#: doc/classes/DirectionalLight3D.xml:31 doc/classes/RenderingServer.xml:3254
+#: doc/classes/DirectionalLight3D.xml:31 doc/classes/RenderingServer.xml:3250
msgid ""
"Sets the size of the directional shadow pancake. The pancake offsets the "
"start of the shadow's camera frustum to provide a higher effective depth "
@@ -17216,10 +17462,10 @@ msgstr ""
msgid ""
"Directory type. It is used to manage directories and their content (not "
"restricted to the project folder).\n"
-"When creating a new [Directory], its default opened directory will be "
-"[code]res://[/code]. This may change in the future, so it is advised to "
-"always use [method open] to initialize your [Directory] where you want to "
-"operate, with explicit error checking.\n"
+"When creating a new [Directory], it must be explicitly opened using [method "
+"open] before most methods can be used. However, [method file_exists] and "
+"[method dir_exists] can be used without opening a directory. If so, they use "
+"a path relative to [code]res://[/code].\n"
"Here is an example on how to iterate through the files of a directory:\n"
"[codeblock]\n"
"func dir_contents(path):\n"
@@ -17238,7 +17484,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/Directory.xml:27 doc/classes/File.xml:25
+#: doc/classes/Directory.xml:27 doc/classes/File.xml:26
msgid ""
"https://docs.godotengine.org/en/latest/getting_started/step_by_step/"
"filesystem.html"
@@ -17272,41 +17518,43 @@ msgstr ""
#: doc/classes/Directory.xml:65
msgid ""
"Returns whether the target directory exists. The argument can be relative to "
-"the current directory, or an absolute path."
+"the current directory, or an absolute path.\n"
+"If the [Directory] is not open, the path is relative to [code]res://[/code]."
msgstr ""
-#: doc/classes/Directory.xml:74
+#: doc/classes/Directory.xml:75
msgid ""
"Returns whether the target file exists. The argument can be relative to the "
-"current directory, or an absolute path."
+"current directory, or an absolute path.\n"
+"If the [Directory] is not open, the path is relative to [code]res://[/code]."
msgstr ""
-#: doc/classes/Directory.xml:81
+#: doc/classes/Directory.xml:83
msgid ""
"Returns the absolute path to the currently opened directory (e.g. "
"[code]res://folder[/code] or [code]C:\\tmp\\folder[/code])."
msgstr ""
-#: doc/classes/Directory.xml:88
+#: doc/classes/Directory.xml:90
msgid ""
"Returns the currently opened directory's drive index. See [method get_drive] "
"to convert returned index to the name of the drive."
msgstr ""
-#: doc/classes/Directory.xml:97
+#: doc/classes/Directory.xml:99
msgid ""
"On Windows, returns the name of the drive (partition) passed as an argument "
"(e.g. [code]C:[/code]). On other platforms, or if the requested drive does "
"not existed, the method returns an empty String."
msgstr ""
-#: doc/classes/Directory.xml:104
+#: doc/classes/Directory.xml:106
msgid ""
"On Windows, returns the number of drives (partitions) mounted on the current "
"filesystem. On other platforms, the method returns 0."
msgstr ""
-#: doc/classes/Directory.xml:111
+#: doc/classes/Directory.xml:113
msgid ""
"Returns the next element (file or directory) in the current directory "
"(including [code].[/code] and [code]..[/code], unless "
@@ -17317,14 +17565,14 @@ msgid ""
"mandatory in such a case)."
msgstr ""
-#: doc/classes/Directory.xml:119
+#: doc/classes/Directory.xml:121
msgid ""
"On UNIX desktop systems, returns the available space on the current "
"directory's disk. On other platforms, this information is not available and "
"the method returns 0 or -1."
msgstr ""
-#: doc/classes/Directory.xml:130
+#: doc/classes/Directory.xml:132
msgid ""
"Initializes the stream used to list all files and directories using the "
"[method get_next] function, closing the current opened stream if needed. "
@@ -17336,13 +17584,13 @@ msgid ""
"out."
msgstr ""
-#: doc/classes/Directory.xml:139
+#: doc/classes/Directory.xml:141
msgid ""
"Closes the current stream opened with [method list_dir_begin] (whether it "
"has been fully processed with [method get_next] or not does not matter)."
msgstr ""
-#: doc/classes/Directory.xml:148
+#: doc/classes/Directory.xml:150
msgid ""
"Creates a directory. The argument can be relative to the current directory, "
"or an absolute path. The target directory should be placed in an already "
@@ -17351,7 +17599,7 @@ msgid ""
"Returns one of the [enum Error] code constants ([code]OK[/code] on success)."
msgstr ""
-#: doc/classes/Directory.xml:158
+#: doc/classes/Directory.xml:160
msgid ""
"Creates a target directory and all necessary intermediate directories in its "
"path, by calling [method make_dir] recursively. The argument can be relative "
@@ -17359,7 +17607,7 @@ msgid ""
"Returns one of the [enum Error] code constants ([code]OK[/code] on success)."
msgstr ""
-#: doc/classes/Directory.xml:168
+#: doc/classes/Directory.xml:170
msgid ""
"Opens an existing directory of the filesystem. The [code]path[/code] "
"argument can be within the project tree ([code]res://folder[/code]), the "
@@ -17368,7 +17616,7 @@ msgid ""
"Returns one of the [enum Error] code constants ([code]OK[/code] on success)."
msgstr ""
-#: doc/classes/Directory.xml:178
+#: doc/classes/Directory.xml:180
msgid ""
"Deletes the target file or an empty directory. The argument can be relative "
"to the current directory, or an absolute path. If the target directory is "
@@ -17376,7 +17624,7 @@ msgid ""
"Returns one of the [enum Error] code constants ([code]OK[/code] on success)."
msgstr ""
-#: doc/classes/Directory.xml:190
+#: doc/classes/Directory.xml:192
msgid ""
"Renames (move) the [code]from[/code] file to the [code]to[/code] "
"destination. Both arguments should be paths to files, either relative or "
@@ -17417,6 +17665,53 @@ msgid ""
"[b]Note:[/b] This method is implemented on Linux, macOS and Windows."
msgstr ""
+#: doc/classes/DisplayServer.xml:530
+msgid ""
+"Return the greatest scale factor of all screens.\n"
+"[b]Note:[/b] On macOS returned value is [code]2.0[/code] if there is at "
+"least one hiDPI (Retina) screen in the system, and [code]1.0[/code] in all "
+"other cases.\n"
+"[b]Note:[/b] This method is implemented on macOS."
+msgstr ""
+
+#: doc/classes/DisplayServer.xml:557
+msgid ""
+"Return the scale factor of the specified screen by index.\n"
+"[b]Note:[/b] On macOS returned value is [code]2.0[/code] for hiDPI (Retina) "
+"screen, and [code]1.0[/code] for all other cases.\n"
+"[b]Note:[/b] This method is implemented on macOS."
+msgstr ""
+
+#: doc/classes/DisplayServer.xml:630
+msgid ""
+"Returns the on-screen keyboard's height in pixels. Returns 0 if there is no "
+"keyboard or if it is currently hidden."
+msgstr ""
+
+#: doc/classes/DisplayServer.xml:637
+msgid "Hides the virtual keyboard if it is shown, does nothing otherwise."
+msgstr ""
+
+#: doc/classes/DisplayServer.xml:656
+msgid ""
+"Shows the virtual keyboard if the platform has one.\n"
+"[code]existing_text[/code] parameter is useful for implementing your own "
+"[LineEdit] or [TextEdit], as it tells the virtual keyboard what text has "
+"already been typed (the virtual keyboard uses it for auto-correct and "
+"predictions).\n"
+"[code]position[/code] parameter is the screen space [Rect2] of the edited "
+"text.\n"
+"[code]multiline[/code] parameter needs to be set to [code]true[/code] to be "
+"able to enter multiple lines of text, as in [TextEdit].\n"
+"[code]max_length[/code] limits the number of characters that can be entered "
+"if different from [code]-1[/code].\n"
+"[code]cursor_start[/code] can optionally define the current text cursor "
+"position if [code]cursor_end[/code] is not set.\n"
+"[code]cursor_start[/code] and [code]cursor_end[/code] can optionally define "
+"the current text selection.\n"
+"[b]Note:[/b] This method is implemented on Android, iOS and UWP."
+msgstr ""
+
#: doc/classes/DTLSServer.xml:4
msgid "Helper class to implement a DTLS server."
msgstr ""
@@ -17537,54 +17832,62 @@ msgstr ""
msgid "Adds a fallback font."
msgstr ""
-#: doc/classes/DynamicFont.xml:35
+#: doc/classes/DynamicFont.xml:33
+msgid ""
+"Returns a string containing all the characters available in the main and all "
+"the fallback fonts.\n"
+"If a given character is included in more than one font, it appears only once "
+"in the returned string."
+msgstr ""
+
+#: doc/classes/DynamicFont.xml:43
msgid "Returns the fallback font at index [code]idx[/code]."
msgstr ""
-#: doc/classes/DynamicFont.xml:42
+#: doc/classes/DynamicFont.xml:50
msgid "Returns the number of fallback fonts."
msgstr ""
-#: doc/classes/DynamicFont.xml:51
+#: doc/classes/DynamicFont.xml:59
msgid ""
"Returns the spacing for the given [code]type[/code] (see [enum SpacingType])."
msgstr ""
-#: doc/classes/DynamicFont.xml:60
+#: doc/classes/DynamicFont.xml:68
msgid "Removes the fallback font at index [code]idx[/code]."
msgstr ""
-#: doc/classes/DynamicFont.xml:71
+#: doc/classes/DynamicFont.xml:79
msgid "Sets the fallback font at index [code]idx[/code]."
msgstr ""
-#: doc/classes/DynamicFont.xml:82
+#: doc/classes/DynamicFont.xml:90
msgid ""
"Sets the spacing for [code]type[/code] (see [enum SpacingType]) to "
"[code]value[/code] in pixels (not relative to the font size)."
msgstr ""
-#: doc/classes/DynamicFont.xml:88
+#: doc/classes/DynamicFont.xml:96
msgid "Extra spacing at the bottom in pixels."
msgstr ""
-#: doc/classes/DynamicFont.xml:91
+#: doc/classes/DynamicFont.xml:99
msgid "Extra character spacing in pixels."
msgstr ""
-#: doc/classes/DynamicFont.xml:94
+#: doc/classes/DynamicFont.xml:102
msgid "Extra space spacing in pixels."
msgstr ""
-#: doc/classes/DynamicFont.xml:97
+#: doc/classes/DynamicFont.xml:105
msgid "Extra spacing at the top in pixels."
msgstr ""
-#: doc/classes/DynamicFont.xml:100
+#: doc/classes/DynamicFont.xml:108
msgid "The font data."
msgstr ""
-#: doc/classes/DynamicFont.xml:103
+#: doc/classes/DynamicFont.xml:111
msgid ""
"The font outline's color.\n"
"[b]Note:[/b] It's recommended to leave this at the default value so that you "
@@ -17593,27 +17896,27 @@ msgid ""
"outline modulate theme item."
msgstr ""
-#: doc/classes/DynamicFont.xml:107
+#: doc/classes/DynamicFont.xml:115
msgid "The font outline's thickness in pixels (not relative to the font size)."
msgstr ""
-#: doc/classes/DynamicFont.xml:110
+#: doc/classes/DynamicFont.xml:118
msgid "The font size in pixels."
msgstr ""
-#: doc/classes/DynamicFont.xml:115
+#: doc/classes/DynamicFont.xml:123
msgid "Spacing at the top."
msgstr ""
-#: doc/classes/DynamicFont.xml:118
+#: doc/classes/DynamicFont.xml:126
msgid "Spacing at the bottom."
msgstr ""
-#: doc/classes/DynamicFont.xml:121
+#: doc/classes/DynamicFont.xml:129
msgid "Character spacing."
msgstr ""
-#: doc/classes/DynamicFont.xml:124
+#: doc/classes/DynamicFont.xml:132
msgid "Space spacing."
msgstr ""
@@ -17995,7 +18298,12 @@ msgstr ""
msgid "Remitted if a resource is reimported."
msgstr ""
-#: doc/classes/EditorFileSystem.xml:106
+#: doc/classes/EditorFileSystem.xml:100
+msgid ""
+"Emitted if at least one resource is reloaded when the filesystem is scanned."
+msgstr ""
+
+#: doc/classes/EditorFileSystem.xml:107
msgid "Emitted if the source of any imported file changed."
msgstr ""
@@ -18037,29 +18345,43 @@ msgstr ""
msgid "Returns the path to the file at index [code]idx[/code]."
msgstr ""
-#: doc/classes/EditorFileSystemDirectory.xml:86
+#: doc/classes/EditorFileSystemDirectory.xml:70
+msgid ""
+"Returns the base class of the script class defined in the file at index "
+"[code]idx[/code]. If the file doesn't define a script class using the "
+"[code]class_name[/code] syntax, this will return an empty string."
+msgstr ""
+
+#: doc/classes/EditorFileSystemDirectory.xml:79
+msgid ""
+"Returns the name of the script class defined in the file at index [code]idx[/"
+"code]. If the file doesn't define a script class using the [code]class_name[/"
+"code] syntax, this will return an empty string."
+msgstr ""
+
+#: doc/classes/EditorFileSystemDirectory.xml:88
msgid "Returns the file extension of the file at index [code]idx[/code]."
msgstr ""
-#: doc/classes/EditorFileSystemDirectory.xml:93
+#: doc/classes/EditorFileSystemDirectory.xml:95
msgid "Returns the name of this directory."
msgstr ""
-#: doc/classes/EditorFileSystemDirectory.xml:100
+#: doc/classes/EditorFileSystemDirectory.xml:102
msgid ""
"Returns the parent directory for this directory or [code]null[/code] if "
"called on a directory at [code]res://[/code] or [code]user://[/code]."
msgstr ""
-#: doc/classes/EditorFileSystemDirectory.xml:107
+#: doc/classes/EditorFileSystemDirectory.xml:109
msgid "Returns the path to this directory."
msgstr ""
-#: doc/classes/EditorFileSystemDirectory.xml:116
+#: doc/classes/EditorFileSystemDirectory.xml:118
msgid "Returns the subdirectory at index [code]idx[/code]."
msgstr ""
-#: doc/classes/EditorFileSystemDirectory.xml:123
+#: doc/classes/EditorFileSystemDirectory.xml:125
msgid "Returns the number of subdirectories in this directory."
msgstr ""
@@ -18150,45 +18472,72 @@ msgstr ""
msgid "Gets the unique name of the importer."
msgstr ""
-#: doc/classes/EditorImportPlugin.xml:92
+#: doc/classes/EditorImportPlugin.xml:86
+msgid ""
+"This method can be overridden to hide specific import options if conditions "
+"are met. This is mainly useful for hiding options that depend on others if "
+"one of them is disabled. For example:\n"
+"[codeblock]\n"
+"func get_option_visibility(option, options):\n"
+" # Only show the lossy quality setting if the compression mode is set to "
+"\"Lossy\".\n"
+" if option == \"compress/lossy_quality\" and options.has(\"compress/mode"
+"\"):\n"
+" return int(options[\"compress/mode\"]) == COMPRESS_LOSSY\n"
+"\n"
+" return true\n"
+"[/codeblock]\n"
+"Return [code]true[/code] to make all options always visible."
+msgstr ""
+
+#: doc/classes/EditorImportPlugin.xml:102
msgid ""
"Gets the number of initial presets defined by the plugin. Use [method "
"get_import_options] to get the default options for the preset and [method "
"get_preset_name] to get the name of the preset."
msgstr ""
-#: doc/classes/EditorImportPlugin.xml:101
+#: doc/classes/EditorImportPlugin.xml:111
msgid "Gets the name of the options preset at this index."
msgstr ""
-#: doc/classes/EditorImportPlugin.xml:108
+#: doc/classes/EditorImportPlugin.xml:118
msgid ""
"Gets the priority of this plugin for the recognized extension. Higher "
"priority plugins will be preferred. The default priority is [code]1.0[/code]."
msgstr ""
-#: doc/classes/EditorImportPlugin.xml:115
+#: doc/classes/EditorImportPlugin.xml:125
msgid ""
"Gets the list of file extensions to associate with this loader (case-"
"insensitive). e.g. [code][\"obj\"][/code]."
msgstr ""
-#: doc/classes/EditorImportPlugin.xml:122
+#: doc/classes/EditorImportPlugin.xml:132
msgid ""
"Gets the Godot resource type associated with this loader. e.g. [code]\"Mesh"
"\"[/code] or [code]\"Animation\"[/code]."
msgstr ""
-#: doc/classes/EditorImportPlugin.xml:129
+#: doc/classes/EditorImportPlugin.xml:139
msgid ""
"Gets the extension used to save this resource in the [code].import[/code] "
"directory."
msgstr ""
-#: doc/classes/EditorImportPlugin.xml:136
+#: doc/classes/EditorImportPlugin.xml:146
msgid "Gets the name to display in the import window."
msgstr ""
+#: doc/classes/EditorImportPlugin.xml:163
+msgid ""
+"Imports [code]source_file[/code] into [code]save_path[/code] with the import "
+"[code]options[/code] specified. The [code]platform_variants[/code] and "
+"[code]gen_files[/code] arrays will be modified by this function.\n"
+"This method must be overridden to do the actual importing work. See this "
+"class' description for an example of overriding this method."
+msgstr ""
+
#: doc/classes/EditorInspector.xml:4
msgid "A tab used to edit properties of the selected node."
msgstr ""
@@ -18204,6 +18553,58 @@ msgid ""
"the singleton using [method EditorInterface.get_inspector]."
msgstr ""
+#: doc/classes/EditorInspector.xml:17
+msgid ""
+"Refreshes the inspector.\n"
+"[b]Note:[/b] To save on CPU resources, calling this method will do nothing "
+"if the time specified in [code]docks/property_editor/auto_refresh_interval[/"
+"code] editor setting hasn't passed yet since this method was last called. "
+"(By default, this interval is set to 0.3 seconds.)"
+msgstr ""
+
+#: doc/classes/EditorInspector.xml:30
+msgid ""
+"Emitted when the Edit button of an [Object] has been pressed in the "
+"inspector. This is mainly used in the remote scene tree inspector."
+msgstr ""
+
+#: doc/classes/EditorInspector.xml:37
+msgid "Emitted when a property is removed from the inspector."
+msgstr ""
+
+#: doc/classes/EditorInspector.xml:44
+msgid "Emitted when a property is edited in the inspector."
+msgstr ""
+
+#: doc/classes/EditorInspector.xml:51
+msgid ""
+"Emitted when a property is keyed in the inspector. Properties can be keyed "
+"by clicking the \"key\" icon next to a property when the Animation panel is "
+"toggled."
+msgstr ""
+
+#: doc/classes/EditorInspector.xml:58
+msgid "Emitted when a property is selected in the inspector."
+msgstr ""
+
+#: doc/classes/EditorInspector.xml:67
+msgid ""
+"Emitted when a boolean property is toggled in the inspector.\n"
+"[b]Note:[/b] This signal is never emitted if the internal [code]autoclear[/"
+"code] property enabled. Since this property is always enabled in the editor "
+"inspector, this signal is never emitted by the editor itself."
+msgstr ""
+
+#: doc/classes/EditorInspector.xml:77
+msgid "Emitted when a resource is selected in the inspector."
+msgstr ""
+
+#: doc/classes/EditorInspector.xml:82
+msgid ""
+"Emitted when a property that requires a restart to be applied is edited in "
+"the inspector. This is only used in the Project Settings and Editor Settings."
+msgstr ""
+
#: doc/classes/EditorInspectorPlugin.xml:4
msgid "Plugin for adding custom property editors on inspector."
msgstr ""
@@ -18282,91 +18683,156 @@ msgstr ""
#: doc/classes/EditorInterface.xml:26
msgid ""
-"Returns the main container of Godot editor's window. You can use it, for "
-"example, to retrieve the size of the container and place your controls "
+"Returns the main container of Godot editor's window. For example, you can "
+"use it to retrieve the size of the container and place your controls "
"accordingly."
msgstr ""
-#: doc/classes/EditorInterface.xml:39
+#: doc/classes/EditorInterface.xml:33
+msgid "Returns the current path being viewed in the [FileSystemDock]."
+msgstr ""
+
+#: doc/classes/EditorInterface.xml:40
msgid "Returns the edited (current) scene's root [Node]."
msgstr ""
-#: doc/classes/EditorInterface.xml:46
-msgid "Returns the [EditorSettings]."
+#: doc/classes/EditorInterface.xml:47
+msgid "Returns the editor's [EditorSettings] instance."
+msgstr ""
+
+#: doc/classes/EditorInterface.xml:54
+msgid ""
+"Returns the main editor control. Use this as a parent for main screens.\n"
+"[b]Note:[/b] This returns the main editor control containing the whole "
+"editor, not the 2D or 3D viewports specifically."
+msgstr ""
+
+#: doc/classes/EditorInterface.xml:62
+msgid "Returns the editor's [FileSystemDock] instance."
msgstr ""
-#: doc/classes/EditorInterface.xml:53
-msgid "Returns the editor [Viewport]."
+#: doc/classes/EditorInterface.xml:69
+msgid "Returns the editor's [EditorInspector] instance."
msgstr ""
-#: doc/classes/EditorInterface.xml:72
+#: doc/classes/EditorInterface.xml:76
msgid "Returns an [Array] with the file paths of the currently opened scenes."
msgstr ""
-#: doc/classes/EditorInterface.xml:79
-msgid "Returns the [EditorFileSystem]."
+#: doc/classes/EditorInterface.xml:83
+msgid ""
+"Returns the name of the scene that is being played. If no scene is currently "
+"being played, returns an empty string."
+msgstr ""
+
+#: doc/classes/EditorInterface.xml:90
+msgid "Returns the editor's [EditorFileSystem] instance."
msgstr ""
-#: doc/classes/EditorInterface.xml:86
-msgid "Returns the [EditorResourcePreview]."
+#: doc/classes/EditorInterface.xml:97
+msgid "Returns the editor's [EditorResourcePreview] instance."
msgstr ""
-#: doc/classes/EditorInterface.xml:93
-msgid "Returns the [ScriptEditor]."
+#: doc/classes/EditorInterface.xml:104
+msgid "Returns the editor's [ScriptEditor] instance."
msgstr ""
-#: doc/classes/EditorInterface.xml:106
-msgid "Returns the [EditorSelection]."
+#: doc/classes/EditorInterface.xml:111
+msgid ""
+"Returns the path of the directory currently selected in the "
+"[FileSystemDock]. If a file is selected, its base directory will be returned "
+"using [method String.get_base_dir] instead."
msgstr ""
-#: doc/classes/EditorInterface.xml:117
+#: doc/classes/EditorInterface.xml:118
+msgid "Returns the editor's [EditorSelection] instance."
+msgstr ""
+
+#: doc/classes/EditorInterface.xml:129
msgid ""
-"Shows the given property on the given [code]object[/code] in the Editor's "
+"Shows the given property on the given [code]object[/code] in the editor's "
"Inspector dock."
msgstr ""
-#: doc/classes/EditorInterface.xml:126
+#: doc/classes/EditorInterface.xml:136
msgid ""
-"Returns the enabled status of a plugin. The plugin name is the same as its "
-"directory name."
+"Returns [code]true[/code] if a scene is currently being played, [code]false[/"
+"code] otherwise. Paused scenes are considered as being played."
msgstr ""
-#: doc/classes/EditorInterface.xml:137
+#: doc/classes/EditorInterface.xml:145
+#, fuzzy
+msgid ""
+"Returns [code]true[/code] if the specified [code]plugin[/code] is enabled. "
+"The plugin name is the same as its directory name."
+msgstr "如果[code]s[/code] 为0或者很接近0则返回[code]true[/code]。"
+
+#: doc/classes/EditorInterface.xml:156
msgid ""
"Returns mesh previews rendered at the given size as an [Array] of "
"[Texture2D]s."
msgstr ""
-#: doc/classes/EditorInterface.xml:146
+#: doc/classes/EditorInterface.xml:165
msgid "Opens the scene at the given path."
msgstr ""
-#: doc/classes/EditorInterface.xml:155
+#: doc/classes/EditorInterface.xml:172
+msgid "Plays the currently active scene."
+msgstr ""
+
+#: doc/classes/EditorInterface.xml:181
+msgid "Plays the scene specified by its filepath."
+msgstr ""
+
+#: doc/classes/EditorInterface.xml:188
+msgid "Plays the main scene."
+msgstr ""
+
+#: doc/classes/EditorInterface.xml:197
msgid "Reloads the scene at the given path."
msgstr ""
-#: doc/classes/EditorInterface.xml:162
+#: doc/classes/EditorInterface.xml:204
msgid ""
"Saves the scene. Returns either [code]OK[/code] or [code]ERR_CANT_CREATE[/"
"code] (see [@GlobalScope] constants)."
msgstr ""
-#: doc/classes/EditorInterface.xml:173
+#: doc/classes/EditorInterface.xml:215
msgid "Saves the scene as a file at [code]path[/code]."
msgstr ""
-#: doc/classes/EditorInterface.xml:182
+#: doc/classes/EditorInterface.xml:224
msgid ""
"Selects the file, with the path provided by [code]file[/code], in the "
"FileSystem dock."
msgstr ""
-#: doc/classes/EditorInterface.xml:201
+#: doc/classes/EditorInterface.xml:233
+msgid ""
+"Sets the editor's current main screen to the one specified in [code]name[/"
+"code]. [code]name[/code] must match the text of the tab in question exactly "
+"([code]2D[/code], [code]3D[/code], [code]Script[/code], [code]AssetLib[/"
+"code])."
+msgstr ""
+
+#: doc/classes/EditorInterface.xml:244
msgid ""
"Sets the enabled status of a plugin. The plugin name is the same as its "
"directory name."
msgstr ""
+#: doc/classes/EditorInterface.xml:251
+msgid "Stops the scene that is currently playing."
+msgstr ""
+
+#: doc/classes/EditorInterface.xml:257
+msgid ""
+"If [code]true[/code], enables distraction-free mode which hides side docks "
+"to increase the space available for the main view."
+msgstr ""
+
#: doc/classes/EditorNode3DGizmo.xml:4
msgid "Custom gizmo for editing Node3D objects."
msgstr ""
@@ -18378,14 +18844,20 @@ msgid ""
"information."
msgstr ""
-#: doc/classes/EditorNode3DGizmo.xml:26
+#: doc/classes/EditorNode3DGizmo.xml:18
+msgid ""
+"Adds the specified [code]segments[/code] to the gizmo's collision shape for "
+"picking. Call this function during [method redraw]."
+msgstr ""
+
+#: doc/classes/EditorNode3DGizmo.xml:27
msgid ""
"Adds collision triangles to the gizmo for picking. A [TriangleMesh] can be "
"generated from a regular [Mesh] too. Call this function during [method "
"redraw]."
msgstr ""
-#: doc/classes/EditorNode3DGizmo.xml:41
+#: doc/classes/EditorNode3DGizmo.xml:42
msgid ""
"Adds a list of handles (points) which can be used to deform the object being "
"edited.\n"
@@ -18393,20 +18865,33 @@ msgid ""
"handles. Call this function during [method redraw]."
msgstr ""
-#: doc/classes/EditorNode3DGizmo.xml:57
+#: doc/classes/EditorNode3DGizmo.xml:58
msgid ""
"Adds lines to the gizmo (as sets of 2 points), with a given material. The "
"lines are used for visualizing the gizmo. Call this function during [method "
"redraw]."
msgstr ""
-#: doc/classes/EditorNode3DGizmo.xml:84
+#: doc/classes/EditorNode3DGizmo.xml:73
+msgid ""
+"Adds a mesh to the gizmo with the specified [code]billboard[/code] state, "
+"[code]skeleton[/code] and [code]material[/code]. If [code]billboard[/code] "
+"is [code]true[/code], the mesh will rotate to always face the camera. Call "
+"this function during [method redraw]."
+msgstr ""
+
+#: doc/classes/EditorNode3DGizmo.xml:86
msgid ""
"Adds an unscaled billboard for visualization. Call this function during "
"[method redraw]."
msgstr ""
-#: doc/classes/EditorNode3DGizmo.xml:103
+#: doc/classes/EditorNode3DGizmo.xml:93
+msgid ""
+"Removes everything in the gizmo including meshes, collisions and handles."
+msgstr ""
+
+#: doc/classes/EditorNode3DGizmo.xml:106
msgid ""
"Commit a handle being edited (handles must have been previously added by "
"[method add_handles]).\n"
@@ -18414,40 +18899,43 @@ msgid ""
"restore the edited value to the original is provided."
msgstr ""
-#: doc/classes/EditorNode3DGizmo.xml:113
+#: doc/classes/EditorNode3DGizmo.xml:116
msgid ""
"Gets the name of an edited handle (handles must have been previously added "
"by [method add_handles]).\n"
"Handles can be named for reference to the user when editing."
msgstr ""
-#: doc/classes/EditorNode3DGizmo.xml:123
+#: doc/classes/EditorNode3DGizmo.xml:126
msgid ""
"Gets actual value of a handle. This value can be anything and used for "
"eventually undoing the motion when calling [method commit_handle]."
msgstr ""
-#: doc/classes/EditorNode3DGizmo.xml:130
+#: doc/classes/EditorNode3DGizmo.xml:133
msgid ""
"Returns the [EditorNode3DGizmoPlugin] that owns this gizmo. It's useful to "
"retrieve materials using [method EditorNode3DGizmoPlugin.get_material]."
msgstr ""
-#: doc/classes/EditorNode3DGizmo.xml:137
+#: doc/classes/EditorNode3DGizmo.xml:140
msgid "Returns the Node3D node associated with this gizmo."
msgstr ""
-#: doc/classes/EditorNode3DGizmo.xml:146
-msgid "Gets whether a handle is highlighted or not."
-msgstr ""
+#: doc/classes/EditorNode3DGizmo.xml:149
+#, fuzzy
+msgid ""
+"Returns [code]true[/code] if the handle at index [code]index[/code] is "
+"highlighted by being hovered with the mouse."
+msgstr "如果[code]a[/code]与[code]b[/code]近似相等,则返回[code]true[/code]。"
-#: doc/classes/EditorNode3DGizmo.xml:153
+#: doc/classes/EditorNode3DGizmo.xml:156
msgid ""
-"This function is called when the Node3D this gizmo refers to changes (the "
+"This function is called when the [Node3D] this gizmo refers to changes (the "
"[method Node3D.update_gizmo] is called)."
msgstr ""
-#: doc/classes/EditorNode3DGizmo.xml:166
+#: doc/classes/EditorNode3DGizmo.xml:169
msgid ""
"This function is used when the user drags a gizmo handle (previously added "
"with [method add_handles]) in screen coordinates.\n"
@@ -18455,6 +18943,18 @@ msgid ""
"raycasts."
msgstr ""
+#: doc/classes/EditorNode3DGizmo.xml:179
+msgid ""
+"Sets the gizmo's hidden state. If [code]true[/code], the gizmo will be "
+"hidden. If [code]false[/code], it will be shown."
+msgstr ""
+
+#: doc/classes/EditorNode3DGizmo.xml:188
+msgid ""
+"Sets the reference [Node3D] node for the gizmo. [code]node[/code] must "
+"inherit from [Node3D]."
+msgstr ""
+
#: doc/classes/EditorNode3DGizmoPlugin.xml:4
msgid "Used by the editor to define Node3D gizmo types."
msgstr ""
@@ -18547,7 +19047,17 @@ msgid ""
"visibility menu."
msgstr ""
-#: doc/classes/EditorNode3DGizmoPlugin.xml:150
+#: doc/classes/EditorNode3DGizmoPlugin.xml:142
+msgid ""
+"Override this method to set the gizmo's priority. Higher values correspond "
+"to higher priority. If a gizmo with higher priority conflicts with another "
+"gizmo, only the gizmo with higher priority will be used.\n"
+"All built-in editor gizmos return a priority of [code]-1[/code]. If not "
+"overridden, this method will return [code]0[/code], which means custom "
+"gizmos will automatically override built-in gizmos."
+msgstr ""
+
+#: doc/classes/EditorNode3DGizmoPlugin.xml:152
msgid ""
"Override this method to define which Node3D nodes have a gizmo from this "
"plugin. Whenever a [Node3D] node is added to a scene this method is called, "
@@ -18555,25 +19065,25 @@ msgid ""
"assigned and is added to this plugin's list of active gizmos."
msgstr ""
-#: doc/classes/EditorNode3DGizmoPlugin.xml:161
+#: doc/classes/EditorNode3DGizmoPlugin.xml:163
msgid ""
"Gets whether a handle is highlighted or not. Called for this plugin's active "
"gizmos."
msgstr ""
-#: doc/classes/EditorNode3DGizmoPlugin.xml:168
+#: doc/classes/EditorNode3DGizmoPlugin.xml:170
msgid ""
"Override this method to define whether Node3D with this gizmo should be "
"selecteble even when the gizmo is hidden."
msgstr ""
-#: doc/classes/EditorNode3DGizmoPlugin.xml:177
+#: doc/classes/EditorNode3DGizmoPlugin.xml:179
msgid ""
"Callback to redraw the provided gizmo. Called for this plugin's active "
"gizmos."
msgstr ""
-#: doc/classes/EditorNode3DGizmoPlugin.xml:192
+#: doc/classes/EditorNode3DGizmoPlugin.xml:194
msgid ""
"Update the value of a handle after it has been updated. Called for this "
"plugin's active gizmos."
@@ -18660,7 +19170,13 @@ msgid ""
"should be cleaned up using [code]remove_tool_menu_item(name)[/code]."
msgstr ""
-#: doc/classes/EditorPlugin.xml:149
+#: doc/classes/EditorPlugin.xml:151
+msgid ""
+"Registers a custom translation parser plugin for extracting translatable "
+"strings from custom files."
+msgstr ""
+
+#: doc/classes/EditorPlugin.xml:158
msgid ""
"This method is called when the editor is about to save the project, switch "
"to another tab, etc. It asks the plugin to apply any pending state changes "
@@ -18669,32 +19185,32 @@ msgid ""
"must apply the shader code being written by the user to the object."
msgstr ""
-#: doc/classes/EditorPlugin.xml:163
+#: doc/classes/EditorPlugin.xml:172
msgid ""
"Clear all the state and reset the object being edited to zero. This ensures "
"your plugin does not keep editing a currently existing node, or a node from "
"the wrong scene."
msgstr ""
-#: doc/classes/EditorPlugin.xml:170
+#: doc/classes/EditorPlugin.xml:179
msgid ""
"Called by the engine when the user disables the [EditorPlugin] in the Plugin "
"tab of the project settings window."
msgstr ""
-#: doc/classes/EditorPlugin.xml:179
+#: doc/classes/EditorPlugin.xml:188
msgid ""
"This function is used for plugins that edit specific object types (nodes or "
"resources). It requests the editor to edit the given object."
msgstr ""
-#: doc/classes/EditorPlugin.xml:186
+#: doc/classes/EditorPlugin.xml:195
msgid ""
"Called by the engine when the user enables the [EditorPlugin] in the Plugin "
"tab of the project settings window."
msgstr ""
-#: doc/classes/EditorPlugin.xml:211
+#: doc/classes/EditorPlugin.xml:220
msgid ""
"Called when there is a root node in the current edited scene, [method "
"handles] is implemented and an [InputEvent] happens in the 2D viewport. "
@@ -18719,7 +19235,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/EditorPlugin.xml:237
+#: doc/classes/EditorPlugin.xml:246
msgid ""
"Called when there is a root node in the current edited scene, [method "
"handles] is implemented and an [InputEvent] happens in the 3D viewport. "
@@ -18744,20 +19260,20 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/EditorPlugin.xml:259
+#: doc/classes/EditorPlugin.xml:268
msgid ""
"This is for editors that edit script-based objects. You can return a list of "
"breakpoints in the format ([code]script:line[/code]), for example: "
"[code]res://path_to_script.gd:25[/code]."
msgstr ""
-#: doc/classes/EditorPlugin.xml:266
+#: doc/classes/EditorPlugin.xml:275
msgid ""
"Returns the [EditorInterface] object that gives you control over Godot "
"editor's window and its functionalities."
msgstr ""
-#: doc/classes/EditorPlugin.xml:273
+#: doc/classes/EditorPlugin.xml:282
msgid ""
"Override this method in your plugin to return a [Texture2D] in order to give "
"it an icon.\n"
@@ -18775,7 +19291,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/EditorPlugin.xml:289
+#: doc/classes/EditorPlugin.xml:298
msgid ""
"Override this method in your plugin to provide the name of the plugin when "
"displayed in the Godot editor.\n"
@@ -18783,33 +19299,33 @@ msgid ""
"of the \"2D\", \"3D\", \"Script\", and \"AssetLib\" buttons."
msgstr ""
-#: doc/classes/EditorPlugin.xml:297
+#: doc/classes/EditorPlugin.xml:306
msgid ""
"Gets the Editor's dialogue used for making scripts.\n"
"[b]Note:[/b] Users can configure it before use."
msgstr ""
-#: doc/classes/EditorPlugin.xml:305
+#: doc/classes/EditorPlugin.xml:314
msgid ""
"Gets the state of your plugin editor. This is used when saving the scene (so "
"state is kept when opening it again) and for switching tabs (so state can be "
"restored when the tab returns)."
msgstr ""
-#: doc/classes/EditorPlugin.xml:312
+#: doc/classes/EditorPlugin.xml:321
msgid ""
"Gets the undo/redo object. Most actions in the editor can be undoable, so "
"use this object to make sure this happens when it's worth it."
msgstr ""
-#: doc/classes/EditorPlugin.xml:321
+#: doc/classes/EditorPlugin.xml:330
msgid ""
"Gets the GUI layout of the plugin. This is used to save the project's editor "
"layout when [method queue_save_layout] is called or the editor layout was "
"changed(For example changing the position of a dock)."
msgstr ""
-#: doc/classes/EditorPlugin.xml:330
+#: doc/classes/EditorPlugin.xml:339
msgid ""
"Implement this function if your plugin edits a specific type of object "
"(Resource or Node). If you return [code]true[/code], then you will get the "
@@ -18819,14 +19335,14 @@ msgid ""
"be called too."
msgstr ""
-#: doc/classes/EditorPlugin.xml:337
+#: doc/classes/EditorPlugin.xml:346
msgid ""
"Returns [code]true[/code] if this is a main screen editor plugin (it goes in "
"the workspace selector together with [b]2D[/b], [b]3D[/b], [b]Script[/b] and "
"[b]AssetLib[/b])."
msgstr ""
-#: doc/classes/EditorPlugin.xml:360
+#: doc/classes/EditorPlugin.xml:369
msgid ""
"This function will be called when the editor is requested to become visible. "
"It is used for plugins that edit a specific object type.\n"
@@ -18834,85 +19350,89 @@ msgid ""
"manually."
msgstr ""
-#: doc/classes/EditorPlugin.xml:368
+#: doc/classes/EditorPlugin.xml:377
msgid "Queue save the project's editor layout."
msgstr ""
-#: doc/classes/EditorPlugin.xml:377
+#: doc/classes/EditorPlugin.xml:386
msgid "Removes an Autoload [code]name[/code] from the list."
msgstr ""
-#: doc/classes/EditorPlugin.xml:386
+#: doc/classes/EditorPlugin.xml:395
msgid ""
"Removes the control from the bottom panel. You have to manually [method Node."
"queue_free] the control."
msgstr ""
-#: doc/classes/EditorPlugin.xml:397
+#: doc/classes/EditorPlugin.xml:406
msgid ""
"Removes the control from the specified container. You have to manually "
"[method Node.queue_free] the control."
msgstr ""
-#: doc/classes/EditorPlugin.xml:406
+#: doc/classes/EditorPlugin.xml:415
msgid ""
"Removes the control from the dock. You have to manually [method Node."
"queue_free] the control."
msgstr ""
-#: doc/classes/EditorPlugin.xml:415
+#: doc/classes/EditorPlugin.xml:424
msgid "Removes a custom type added by [method add_custom_type]."
msgstr ""
-#: doc/classes/EditorPlugin.xml:464
+#: doc/classes/EditorPlugin.xml:473
msgid "Removes a menu [code]name[/code] from [b]Project > Tools[/b]."
msgstr ""
-#: doc/classes/EditorPlugin.xml:471
+#: doc/classes/EditorPlugin.xml:482
+msgid "Removes a registered custom translation parser plugin."
+msgstr ""
+
+#: doc/classes/EditorPlugin.xml:489
msgid ""
"This method is called after the editor saves the project or when it's "
"closed. It asks the plugin to save edited external scenes/resources."
msgstr ""
-#: doc/classes/EditorPlugin.xml:484
+#: doc/classes/EditorPlugin.xml:502
msgid ""
"Use this method if you always want to receive inputs from 3D view screen "
"inside [method forward_spatial_gui_input]. It might be especially usable if "
"your plugin will want to use raycast in the scene."
msgstr ""
-#: doc/classes/EditorPlugin.xml:493
+#: doc/classes/EditorPlugin.xml:511
msgid "Restore the state saved by [method get_state]."
msgstr ""
-#: doc/classes/EditorPlugin.xml:502
+#: doc/classes/EditorPlugin.xml:520
msgid "Restore the plugin GUI layout saved by [method get_window_layout]."
msgstr ""
-#: doc/classes/EditorPlugin.xml:509
+#: doc/classes/EditorPlugin.xml:527
msgid "Updates the overlays of the editor (2D/3D) viewport."
msgstr ""
-#: doc/classes/EditorPlugin.xml:518
+#: doc/classes/EditorPlugin.xml:536
msgid ""
"Emitted when user changes the workspace ([b]2D[/b], [b]3D[/b], [b]Script[/"
"b], [b]AssetLib[/b]). Also works with custom screens defined by plugins."
msgstr ""
-#: doc/classes/EditorPlugin.xml:531
+#: doc/classes/EditorPlugin.xml:549
msgid ""
"Emitted when the scene is changed in the editor. The argument will return "
"the root node of the scene that has just become active. If this scene is new "
"and empty, the argument will be [code]null[/code]."
msgstr ""
-#: doc/classes/EditorPlugin.xml:538
+#: doc/classes/EditorPlugin.xml:556
msgid ""
"Emitted when user closes a scene. The argument is file path to a closed "
"scene."
msgstr ""
-#: doc/classes/EditorPlugin.xml:584
+#: doc/classes/EditorPlugin.xml:602
msgid "Represents the size of the [enum DockSlot] enum."
msgstr ""
@@ -18967,64 +19487,83 @@ msgid "When this virtual function is called, you must update your editor."
msgstr ""
#: doc/classes/EditorProperty.xml:76
-msgid "Used by the inspector, set when property is checkable."
+msgid ""
+"Used by the inspector, set to [code]true[/code] when the property is "
+"checkable."
msgstr ""
#: doc/classes/EditorProperty.xml:79
-msgid "Used by the inspector, when the property is checked."
+msgid ""
+"Used by the inspector, set to [code]true[/code] when the property is checked."
msgstr ""
-#: doc/classes/EditorProperty.xml:84
-msgid "Used by the inspector, when the property must draw with error color."
+#: doc/classes/EditorProperty.xml:82
+msgid ""
+"Used by the inspector, set to [code]true[/code] when the property can be "
+"deleted by the user."
msgstr ""
-#: doc/classes/EditorProperty.xml:87
-msgid "Used by the inspector, when the property can add keys for animation."
+#: doc/classes/EditorProperty.xml:85
+msgid ""
+"Used by the inspector, set to [code]true[/code] when the property must draw "
+"with error color. This is used for editable children's properties."
+msgstr ""
+
+#: doc/classes/EditorProperty.xml:88
+msgid ""
+"Used by the inspector, set to [code]true[/code] when the property can add "
+"keys for animation."
msgstr ""
-#: doc/classes/EditorProperty.xml:90
-msgid "Sets this property to change the label (if you want to show one)."
+#: doc/classes/EditorProperty.xml:91
+msgid "Set this property to change the label (if you want to show one)."
msgstr ""
-#: doc/classes/EditorProperty.xml:93
-msgid "Used by the inspector, when the property is read-only."
+#: doc/classes/EditorProperty.xml:94
+msgid ""
+"Used by the inspector, set to [code]true[/code] when the property is read-"
+"only."
msgstr ""
-#: doc/classes/EditorProperty.xml:103
+#: doc/classes/EditorProperty.xml:104
msgid ""
"Emit it if you want multiple properties modified at the same time. Do not "
"use if added via [method EditorInspectorPlugin.parse_property]."
msgstr ""
-#: doc/classes/EditorProperty.xml:112
+#: doc/classes/EditorProperty.xml:113
msgid "Used by sub-inspectors. Emit it if what was selected was an Object ID."
msgstr ""
-#: doc/classes/EditorProperty.xml:121
+#: doc/classes/EditorProperty.xml:122
msgid ""
"Do not emit this manually, use the [method emit_changed] method instead."
msgstr ""
-#: doc/classes/EditorProperty.xml:130
+#: doc/classes/EditorProperty.xml:131
msgid "Emitted when a property was checked. Used internally."
msgstr ""
-#: doc/classes/EditorProperty.xml:143
+#: doc/classes/EditorProperty.xml:138
+msgid "Emitted when a property was deleted. Used internally."
+msgstr ""
+
+#: doc/classes/EditorProperty.xml:145
msgid ""
"Emit it if you want to add this value as an animation key (check for keying "
"being enabled first)."
msgstr ""
-#: doc/classes/EditorProperty.xml:152
+#: doc/classes/EditorProperty.xml:154
msgid "Emit it if you want to key a property with a single value."
msgstr ""
-#: doc/classes/EditorProperty.xml:161
+#: doc/classes/EditorProperty.xml:163
msgid ""
"If you want a sub-resource to be edited, emit this signal with the resource."
msgstr ""
-#: doc/classes/EditorProperty.xml:170
+#: doc/classes/EditorProperty.xml:172
msgid "Emitted when selected. Used internally."
msgstr ""
@@ -19309,17 +19848,26 @@ msgstr ""
msgid ""
"Object that holds the project-independent editor settings. These settings "
"are generally visible in the [b]Editor > Editor Settings[/b] menu.\n"
-"Accessing the settings is done by using the regular [Object] API, such as:\n"
-"[codeblock]\n"
-"settings.set(prop,value)\n"
-"settings.get(prop)\n"
-"list_of_settings = settings.get_property_list()\n"
+"Property names use slash delimiters to distinguish sections. Setting values "
+"can be of any [Variant] type. It's recommended to use [code]snake_case[/"
+"code] for editor settings to be consistent with the Godot editor itself.\n"
+"Accessing the settings can be done using the following methods, such as:\n"
+"[codeblock]\n"
+"# `settings.set(\"some/property\", value)` also works as this class "
+"overrides `_set()` internally.\n"
+"settings.set_setting(\"some/property\",value)\n"
+"\n"
+"# `settings.get(\"some/property\", value)` also works as this class "
+"overrides `_get()` internally.\n"
+"settings.get_setting(\"some/property\")\n"
+"\n"
+"var list_of_settings = settings.get_property_list()\n"
"[/codeblock]\n"
"[b]Note:[/b] This class shouldn't be instantiated directly. Instead, access "
"the singleton using [method EditorInterface.get_editor_settings]."
msgstr ""
-#: doc/classes/EditorSettings.xml:25
+#: doc/classes/EditorSettings.xml:30
msgid ""
"Adds a custom property info to a property. The dictionary must contain:\n"
"- [code]name[/code]: [String] (the name of the property)\n"
@@ -19341,52 +19889,174 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/EditorSettings.xml:50
-msgid "Erase a given setting (pass full property path)."
+#: doc/classes/EditorSettings.xml:55
+msgid "Erases the setting whose name is specified by [code]property[/code]."
msgstr ""
-#: doc/classes/EditorSettings.xml:57
-msgid "Gets the list of favorite files and directories for this project."
+#: doc/classes/EditorSettings.xml:62
+msgid "Returns the list of favorite files and directories for this project."
msgstr ""
-#: doc/classes/EditorSettings.xml:76
+#: doc/classes/EditorSettings.xml:75
msgid ""
-"Gets the specific project settings path. Projects all have a unique sub-"
-"directory inside the settings path where project specific settings are saved."
+"Returns project-specific metadata for the [code]section[/code] and "
+"[code]key[/code] specified. If the metadata doesn't exist, [code]default[/"
+"code] will be returned instead. See also [method set_project_metadata]."
msgstr ""
-#: doc/classes/EditorSettings.xml:83
+#: doc/classes/EditorSettings.xml:82
msgid ""
-"Gets the list of recently visited folders in the file dialog for this "
+"Returns the project-specific settings path. Projects all have a unique "
+"subdirectory inside the settings path where project-specific settings are "
+"saved."
+msgstr ""
+
+#: doc/classes/EditorSettings.xml:89
+msgid ""
+"Returns the list of recently visited folders in the file dialog for this "
"project."
msgstr ""
#: doc/classes/EditorSettings.xml:98
msgid ""
+"Returns the value of the setting specified by [code]name[/code]. This is "
+"equivalent to using [method Object.get] on the EditorSettings instance."
+msgstr ""
+
+#: doc/classes/EditorSettings.xml:105
+msgid ""
"Gets the global settings path for the engine. Inside this path, you can find "
"some standard paths such as:\n"
"[code]settings/tmp[/code] - Used for temporary storage of files\n"
"[code]settings/templates[/code] - Where export templates are located"
msgstr ""
-#: doc/classes/EditorSettings.xml:133
+#: doc/classes/EditorSettings.xml:116
+#, fuzzy
+msgid ""
+"Returns [code]true[/code] if the setting specified by [code]name[/code] "
+"exists, [code]false[/code] otherwise."
+msgstr "如果[code]a[/code]与[code]b[/code]近似相等,则返回[code]true[/code]。"
+
+#: doc/classes/EditorSettings.xml:125
+msgid ""
+"Returns [code]true[/code] if the setting specified by [code]name[/code] can "
+"have its value reverted to the default value, [code]false[/code] otherwise. "
+"When this method returns [code]true[/code], a Revert button will display "
+"next to the setting in the Editor Settings."
+msgstr ""
+
+#: doc/classes/EditorSettings.xml:134
+msgid ""
+"Returns the default value of the setting specified by [code]name[/code]. "
+"This is the value that would be applied when clicking the Revert button in "
+"the Editor Settings."
+msgstr ""
+
+#: doc/classes/EditorSettings.xml:143
msgid "Sets the list of favorite files and directories for this project."
msgstr ""
-#: doc/classes/EditorSettings.xml:166
+#: doc/classes/EditorSettings.xml:156
+msgid ""
+"Sets the initial value of the setting specified by [code]name[/code] to "
+"[code]value[/code]. This is used to provide a value for the Revert button in "
+"the Editor Settings. If [code]update_current[/code] is true, the current "
+"value of the setting will be set to [code]value[/code] as well."
+msgstr ""
+
+#: doc/classes/EditorSettings.xml:169
+msgid ""
+"Sets project-specific metadata with the [code]section[/code], [code]key[/"
+"code] and [code]data[/code] specified. This metadata is stored outside the "
+"project folder and therefore won't be checked into version control. See also "
+"[method get_project_metadata]."
+msgstr ""
+
+#: doc/classes/EditorSettings.xml:178
msgid ""
"Sets the list of recently visited folders in the file dialog for this "
"project."
msgstr ""
-#: doc/classes/EditorSettings.xml:183
-msgid "Emitted when editor settings change."
+#: doc/classes/EditorSettings.xml:189
+msgid ""
+"Sets the [code]value[/code] of the setting specified by [code]name[/code]. "
+"This is equivalent to using [method Object.set] on the EditorSettings "
+"instance."
msgstr ""
-#: doc/classes/EditorSettings.xml:189
+#: doc/classes/EditorSettings.xml:196
+msgid "Emitted after any editor setting has changed."
+msgstr ""
+
+#: doc/classes/EditorSettings.xml:202
+msgid ""
+"Emitted after any editor setting has changed. It's used by various editor "
+"plugins to update their visuals on theme changes or logic on configuration "
+"changes."
+msgstr ""
+
+#: doc/classes/EditorTranslationParserPlugin.xml:4
msgid ""
-"Emitted when editor settings change. It used by various editor plugins to "
-"update their visuals on theme changes or logic on configuration changes."
+"Plugin for adding custom parsers to extract strings that are to be "
+"translated from custom files (.csv, .json etc.)."
+msgstr ""
+
+#: doc/classes/EditorTranslationParserPlugin.xml:7
+msgid ""
+"Plugins are registered via [method EditorPlugin."
+"add_translation_parser_plugin] method. To define the parsing and string "
+"extraction logic, override the [method parse_file] method in script.\n"
+"The extracted strings will be written into a POT file selected by user under "
+"\"POT Generation\" in \"Localization\" tab in \"Project Settings\" menu.\n"
+"Below shows an example of a custom parser that extracts strings in a CSV "
+"file to write into a POT.\n"
+"[codeblock]\n"
+"tool\n"
+"extends EditorTranslationParserPlugin\n"
+"\n"
+"\n"
+"func parse_file(path, extracted_strings):\n"
+" var file = File.new()\n"
+" file.open(path, File.READ)\n"
+" var text = file.get_as_text()\n"
+" var split_strs = text.split(\",\", false, 0)\n"
+" for s in split_strs:\n"
+" extracted_strings.append(s)\n"
+" #print(\"Extracted string: \" + s)\n"
+"\n"
+"\n"
+"func get_recognized_extensions():\n"
+" return [\"csv\"]\n"
+"[/codeblock]\n"
+"[b]Note:[/b] If you override parsing logic for standard script types "
+"(GDScript, C#, etc.), it would be better to load the [code]path[/code] "
+"argument using [method ResourceLoader.load]. This is because built-in "
+"scripts are loaded as [Resource] type, not [File] type.\n"
+"For example:\n"
+"[codeblock]\n"
+"func parse_file(path, extracted_strings):\n"
+" var res = ResourceLoader.load(path, \"Script\")\n"
+" var text = res.get_source_code()\n"
+" # Parsing logic.\n"
+"\n"
+"\n"
+"func get_recognized_extensions():\n"
+" return [\"gd\"]\n"
+"[/codeblock]"
+msgstr ""
+
+#: doc/classes/EditorTranslationParserPlugin.xml:48
+msgid ""
+"Gets the list of file extensions to associate with this parser, e.g. [code]"
+"[\"csv\"][/code]."
+msgstr ""
+
+#: doc/classes/EditorTranslationParserPlugin.xml:59
+msgid ""
+"Override this method to define a custom parsing logic to extract the "
+"translatable strings."
msgstr ""
#: doc/classes/EditorVCSInterface.xml:4
@@ -19997,15 +20667,15 @@ msgid ""
"to 1.3 to compensate for the lack of HDR rendering."
msgstr ""
-#: doc/classes/Environment.xml:190
+#: doc/classes/Environment.xml:214
msgid "The [Sky] resource used for this [Environment]."
msgstr ""
-#: doc/classes/Environment.xml:197
+#: doc/classes/Environment.xml:221
msgid "The depth tolerance for screen-space reflections."
msgstr ""
-#: doc/classes/Environment.xml:200
+#: doc/classes/Environment.xml:224
msgid ""
"If [code]true[/code], screen-space reflections are enabled. Screen-space "
"reflections are more accurate than reflections from [GIProbe]s or "
@@ -20013,48 +20683,48 @@ msgid ""
"others."
msgstr ""
-#: doc/classes/Environment.xml:203
+#: doc/classes/Environment.xml:227
msgid ""
"The fade-in distance for screen-space reflections. Affects the area from the "
"reflected material to the screen-space reflection)."
msgstr ""
-#: doc/classes/Environment.xml:206
+#: doc/classes/Environment.xml:230
msgid ""
"The fade-out distance for screen-space reflections. Affects the area from "
"the screen-space reflection to the \"global\" reflection."
msgstr ""
-#: doc/classes/Environment.xml:209
+#: doc/classes/Environment.xml:233
msgid ""
"The maximum number of steps for screen-space reflections. Higher values are "
"slower."
msgstr ""
-#: doc/classes/Environment.xml:212
+#: doc/classes/Environment.xml:236
msgid ""
"The screen-space ambient occlusion intensity on materials that have an AO "
"texture defined. Values higher than [code]0[/code] will make the SSAO effect "
"visible in areas darkened by AO textures."
msgstr ""
-#: doc/classes/Environment.xml:215
+#: doc/classes/Environment.xml:239
msgid ""
"The screen-space ambient occlusion bias. This should be kept high enough to "
"prevent \"smooth\" curves from being affected by ambient occlusion."
msgstr ""
-#: doc/classes/Environment.xml:218
+#: doc/classes/Environment.xml:242
msgid ""
"The screen-space ambient occlusion blur quality. See [enum SSAOBlur] for "
"possible values."
msgstr ""
-#: doc/classes/Environment.xml:221
+#: doc/classes/Environment.xml:245
msgid "The screen-space ambient occlusion edge sharpness."
msgstr ""
-#: doc/classes/Environment.xml:224
+#: doc/classes/Environment.xml:248
msgid ""
"If [code]true[/code], the screen-space ambient occlusion effect is enabled. "
"This darkens objects' corners and cavities to simulate ambient light not "
@@ -20065,13 +20735,13 @@ msgid ""
"issues."
msgstr ""
-#: doc/classes/Environment.xml:227
+#: doc/classes/Environment.xml:251
msgid ""
"The primary screen-space ambient occlusion intensity. See also [member "
"ssao_radius]."
msgstr ""
-#: doc/classes/Environment.xml:230
+#: doc/classes/Environment.xml:254
msgid ""
"The screen-space ambient occlusion intensity in direct light. In real life, "
"ambient occlusion only applies to indirect light, which means its effects "
@@ -20079,46 +20749,46 @@ msgid ""
"the SSAO effect visible in direct light."
msgstr ""
-#: doc/classes/Environment.xml:233
+#: doc/classes/Environment.xml:257
msgid "The primary screen-space ambient occlusion radius."
msgstr ""
-#: doc/classes/Environment.xml:236
+#: doc/classes/Environment.xml:260
msgid "The default exposure used for tonemapping."
msgstr ""
-#: doc/classes/Environment.xml:239
+#: doc/classes/Environment.xml:263
msgid ""
"The tonemapping mode to use. Tonemapping is the process that \"converts\" "
"HDR values to be suitable for rendering on a LDR display. (Godot doesn't "
"support rendering on HDR displays yet.)"
msgstr ""
-#: doc/classes/Environment.xml:242
+#: doc/classes/Environment.xml:266
msgid ""
"The white reference value for tonemapping. Only effective if the [member "
"tonemap_mode] isn't set to [constant TONE_MAPPER_LINEAR]."
msgstr ""
-#: doc/classes/Environment.xml:247
+#: doc/classes/Environment.xml:271
msgid ""
"Clears the background using the clear color defined in [member "
"ProjectSettings.rendering/environment/default_clear_color]."
msgstr ""
-#: doc/classes/Environment.xml:250
+#: doc/classes/Environment.xml:274
msgid "Clears the background using a custom clear color."
msgstr ""
-#: doc/classes/Environment.xml:253
+#: doc/classes/Environment.xml:277
msgid "Displays a user-defined sky in the background."
msgstr ""
-#: doc/classes/Environment.xml:256
+#: doc/classes/Environment.xml:280
msgid "Displays a [CanvasLayer] in the background."
msgstr ""
-#: doc/classes/Environment.xml:259
+#: doc/classes/Environment.xml:283
msgid ""
"Keeps on screen every pixel drawn in the background. This is the fastest "
"background mode, but it can only be safely used in fully-interior scenes (no "
@@ -20126,107 +20796,107 @@ msgid ""
"is visible, \"ghost trail\" artifacts will be visible when moving the camera."
msgstr ""
-#: doc/classes/Environment.xml:262 doc/classes/RenderingServer.xml:3446
+#: doc/classes/Environment.xml:286 doc/classes/RenderingServer.xml:3457
msgid "Displays a camera feed in the background."
msgstr ""
-#: doc/classes/Environment.xml:265
+#: doc/classes/Environment.xml:289
msgid "Represents the size of the [enum BGMode] enum."
msgstr ""
-#: doc/classes/Environment.xml:268 doc/classes/RenderingServer.xml:3452
+#: doc/classes/Environment.xml:292 doc/classes/RenderingServer.xml:3463
msgid ""
"Gather ambient light from whichever source is specified as the background."
msgstr ""
-#: doc/classes/Environment.xml:271 doc/classes/RenderingServer.xml:3455
+#: doc/classes/Environment.xml:295 doc/classes/RenderingServer.xml:3466
msgid "Disable ambient light."
msgstr ""
-#: doc/classes/Environment.xml:274 doc/classes/RenderingServer.xml:3458
+#: doc/classes/Environment.xml:298 doc/classes/RenderingServer.xml:3469
msgid "Specify a specific [Color] for ambient light."
msgstr ""
-#: doc/classes/Environment.xml:277 doc/classes/RenderingServer.xml:3461
+#: doc/classes/Environment.xml:301 doc/classes/RenderingServer.xml:3472
msgid ""
"Gather ambient light from the [Sky] regardless of what the background is."
msgstr ""
-#: doc/classes/Environment.xml:280 doc/classes/RenderingServer.xml:3464
+#: doc/classes/Environment.xml:304 doc/classes/RenderingServer.xml:3475
msgid "Use the background for reflections."
msgstr ""
-#: doc/classes/Environment.xml:283 doc/classes/RenderingServer.xml:3467
+#: doc/classes/Environment.xml:307 doc/classes/RenderingServer.xml:3478
msgid "Disable reflections."
msgstr ""
-#: doc/classes/Environment.xml:286 doc/classes/RenderingServer.xml:3470
+#: doc/classes/Environment.xml:310 doc/classes/RenderingServer.xml:3481
msgid "Use the [Sky] for reflections regardless of what the background is."
msgstr ""
-#: doc/classes/Environment.xml:289 doc/classes/RenderingServer.xml:3473
+#: doc/classes/Environment.xml:313
+msgid ""
+"Linear tonemapper operator. Reads the linear data and passes it on "
+"unmodified."
+msgstr ""
+
+#: doc/classes/Environment.xml:316
+msgid ""
+"Reinhardt tonemapper operator. Performs a variation on rendered pixels' "
+"colors by this formula: [code]color = color / (1 + color)[/code]."
+msgstr ""
+
+#: doc/classes/Environment.xml:319
+msgid "Filmic tonemapper operator."
+msgstr ""
+
+#: doc/classes/Environment.xml:322
+msgid "Academy Color Encoding System tonemapper operator."
+msgstr ""
+
+#: doc/classes/Environment.xml:325 doc/classes/RenderingServer.xml:3484
msgid ""
"Additive glow blending mode. Mostly used for particles, glows (bloom), lens "
"flare, bright sources."
msgstr ""
-#: doc/classes/Environment.xml:292 doc/classes/RenderingServer.xml:3476
+#: doc/classes/Environment.xml:328 doc/classes/RenderingServer.xml:3487
msgid ""
"Screen glow blending mode. Increases brightness, used frequently with bloom."
msgstr ""
-#: doc/classes/Environment.xml:295 doc/classes/RenderingServer.xml:3479
+#: doc/classes/Environment.xml:331 doc/classes/RenderingServer.xml:3490
msgid ""
"Soft light glow blending mode. Modifies contrast, exposes shadows and "
"highlights (vivid bloom)."
msgstr ""
-#: doc/classes/Environment.xml:298 doc/classes/RenderingServer.xml:3482
+#: doc/classes/Environment.xml:334 doc/classes/RenderingServer.xml:3493
msgid ""
"Replace glow blending mode. Replaces all pixels' color by the glow value. "
"This can be used to simulate a full-screen blur effect by tweaking the glow "
"parameters to match the original image's brightness."
msgstr ""
-#: doc/classes/Environment.xml:301 doc/classes/RenderingServer.xml:3485
+#: doc/classes/Environment.xml:337 doc/classes/RenderingServer.xml:3496
msgid ""
"Mixes the glow with the underlying color to avoid increasing brightness as "
"much while still maintaining a glow effect."
msgstr ""
-#: doc/classes/Environment.xml:304
-msgid ""
-"Linear tonemapper operator. Reads the linear data and passes it on "
-"unmodified."
-msgstr ""
-
-#: doc/classes/Environment.xml:307
-msgid ""
-"Reinhardt tonemapper operator. Performs a variation on rendered pixels' "
-"colors by this formula: [code]color = color / (1 + color)[/code]."
-msgstr ""
-
-#: doc/classes/Environment.xml:310
-msgid "Filmic tonemapper operator."
-msgstr ""
-
-#: doc/classes/Environment.xml:313
-msgid "Academy Color Encoding System tonemapper operator."
-msgstr ""
-
-#: doc/classes/Environment.xml:316
+#: doc/classes/Environment.xml:340
msgid "No blur for the screen-space ambient occlusion effect (fastest)."
msgstr ""
-#: doc/classes/Environment.xml:319
+#: doc/classes/Environment.xml:343
msgid "1×1 blur for the screen-space ambient occlusion effect."
msgstr ""
-#: doc/classes/Environment.xml:322
+#: doc/classes/Environment.xml:346
msgid "2×2 blur for the screen-space ambient occlusion effect."
msgstr ""
-#: doc/classes/Environment.xml:325
+#: doc/classes/Environment.xml:349
msgid ""
"3×3 blur for the screen-space ambient occlusion effect. Increases the radius "
"of the blur for a smoother look, but can result in checkerboard-like "
@@ -20311,14 +20981,17 @@ msgid ""
" var content = file.get_as_text()\n"
" file.close()\n"
" return content\n"
-"[/codeblock]"
+"[/codeblock]\n"
+"In the example above, the file will be saved in the user data folder as "
+"specified in the [url=https://docs.godotengine.org/en/latest/tutorials/io/"
+"data_paths.html]Data paths[/url] documentation."
msgstr ""
-#: doc/classes/File.xml:32
+#: doc/classes/File.xml:33
msgid "Closes the currently opened file."
msgstr ""
-#: doc/classes/File.xml:39
+#: doc/classes/File.xml:40
msgid ""
"Returns [code]true[/code] if the file cursor has read past the end of the "
"file.\n"
@@ -20329,7 +21002,7 @@ msgid ""
"get_position] to implement a custom logic."
msgstr ""
-#: doc/classes/File.xml:49
+#: doc/classes/File.xml:50
msgid ""
"Returns [code]true[/code] if the file exists in the given path.\n"
"[b]Note:[/b] Many resources types are imported (e.g. textures or sound "
@@ -20342,41 +21015,41 @@ msgid ""
"source asset is present in [code]res://[/code], but fail when exported)."
msgstr ""
-#: doc/classes/File.xml:57
+#: doc/classes/File.xml:58
msgid ""
"Returns the next 16 bits from the file as an integer. See [method store_16] "
"for details on what values can be stored and retrieved this way."
msgstr ""
-#: doc/classes/File.xml:64
+#: doc/classes/File.xml:65
msgid ""
"Returns the next 32 bits from the file as an integer. See [method store_32] "
"for details on what values can be stored and retrieved this way."
msgstr ""
-#: doc/classes/File.xml:71
+#: doc/classes/File.xml:72
msgid ""
"Returns the next 64 bits from the file as an integer. See [method store_64] "
"for details on what values can be stored and retrieved this way."
msgstr ""
-#: doc/classes/File.xml:78
+#: doc/classes/File.xml:79
msgid ""
"Returns the next 8 bits from the file as an integer. See [method store_8] "
"for details on what values can be stored and retrieved this way."
msgstr ""
-#: doc/classes/File.xml:85
+#: doc/classes/File.xml:86
msgid ""
"Returns the whole file as a [String].\n"
"Text is interpreted as being UTF-8 encoded."
msgstr ""
-#: doc/classes/File.xml:95
+#: doc/classes/File.xml:96
msgid "Returns next [code]len[/code] bytes of the file as a [PackedByteArray]."
msgstr ""
-#: doc/classes/File.xml:104
+#: doc/classes/File.xml:105
msgid ""
"Returns the next value of the file in CSV (Comma-Separated Values) format. "
"You can pass a different delimiter [code]delim[/code] to use other than the "
@@ -20385,37 +21058,37 @@ msgid ""
"Text is interpreted as being UTF-8 encoded."
msgstr ""
-#: doc/classes/File.xml:112
+#: doc/classes/File.xml:113
msgid "Returns the next 64 bits from the file as a floating-point number."
msgstr ""
-#: doc/classes/File.xml:119
+#: doc/classes/File.xml:120
msgid ""
"Returns the last error that happened when trying to perform operations. "
"Compare with the [code]ERR_FILE_*[/code] constants from [enum Error]."
msgstr ""
-#: doc/classes/File.xml:126
+#: doc/classes/File.xml:127
msgid "Returns the next 32 bits from the file as a floating-point number."
msgstr ""
-#: doc/classes/File.xml:133
+#: doc/classes/File.xml:134
msgid "Returns the size of the file in bytes."
msgstr ""
-#: doc/classes/File.xml:140
+#: doc/classes/File.xml:141
msgid ""
"Returns the next line of the file as a [String].\n"
"Text is interpreted as being UTF-8 encoded."
msgstr ""
-#: doc/classes/File.xml:150
+#: doc/classes/File.xml:151
msgid ""
"Returns an MD5 String representing the file at the given path or an empty "
"[String] on failure."
msgstr ""
-#: doc/classes/File.xml:159
+#: doc/classes/File.xml:160
msgid ""
"Returns the last time the [code]file[/code] was modified in unix timestamp "
"format or returns a [String] \"ERROR IN [code]file[/code]\". This unix "
@@ -20423,35 +21096,35 @@ msgid ""
"get_datetime_from_unix_time]."
msgstr ""
-#: doc/classes/File.xml:166
+#: doc/classes/File.xml:167
msgid ""
"Returns a [String] saved in Pascal format from the file.\n"
"Text is interpreted as being UTF-8 encoded."
msgstr ""
-#: doc/classes/File.xml:174
+#: doc/classes/File.xml:175
msgid "Returns the path as a [String] for the current open file."
msgstr ""
-#: doc/classes/File.xml:181
+#: doc/classes/File.xml:182
msgid "Returns the absolute path as a [String] for the current open file."
msgstr ""
-#: doc/classes/File.xml:188
+#: doc/classes/File.xml:189
msgid "Returns the file cursor's position."
msgstr ""
-#: doc/classes/File.xml:195
+#: doc/classes/File.xml:196
msgid "Returns the next bits from the file as a floating-point number."
msgstr ""
-#: doc/classes/File.xml:204
+#: doc/classes/File.xml:205
msgid ""
"Returns a SHA-256 [String] representing the file at the given path or an "
"empty [String] on failure."
msgstr ""
-#: doc/classes/File.xml:213
+#: doc/classes/File.xml:214
msgid ""
"Returns the next [Variant] value from the file. If [code]allow_objects[/"
"code] is [code]true[/code], decoding objects is allowed.\n"
@@ -20460,37 +21133,38 @@ msgid ""
"to avoid potential security threats such as remote code execution."
msgstr ""
-#: doc/classes/File.xml:221
+#: doc/classes/File.xml:222
msgid "Returns [code]true[/code] if the file is currently opened."
msgstr ""
-#: doc/classes/File.xml:232
+#: doc/classes/File.xml:233
msgid "Opens the file for writing or reading, depending on the flags."
msgstr ""
-#: doc/classes/File.xml:245
+#: doc/classes/File.xml:246
msgid "Opens a compressed file for reading or writing."
msgstr ""
-#: doc/classes/File.xml:258
+#: doc/classes/File.xml:259
msgid ""
"Opens an encrypted file in write or read mode. You need to pass a binary key "
-"to encrypt/decrypt it."
+"to encrypt/decrypt it.\n"
+"[b]Note:[/b] The provided key must be 32 bytes long."
msgstr ""
-#: doc/classes/File.xml:271
+#: doc/classes/File.xml:273
msgid ""
"Opens an encrypted file in write or read mode. You need to pass a password "
"to encrypt/decrypt it."
msgstr ""
-#: doc/classes/File.xml:280
+#: doc/classes/File.xml:282
msgid ""
"Changes the file reading/writing cursor to the specified position (in bytes "
"from the beginning of the file)."
msgstr ""
-#: doc/classes/File.xml:289
+#: doc/classes/File.xml:291
msgid ""
"Changes the file reading/writing cursor to the specified position (in bytes "
"from the end of the file).\n"
@@ -20498,7 +21172,7 @@ msgid ""
"cursor will be at the end of the file."
msgstr ""
-#: doc/classes/File.xml:299
+#: doc/classes/File.xml:301
msgid ""
"Stores an integer as 16 bits in the file.\n"
"[b]Note:[/b] The [code]value[/code] should lie in the interval [code][0, "
@@ -20526,7 +21200,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/File.xml:328
+#: doc/classes/File.xml:330
msgid ""
"Stores an integer as 32 bits in the file.\n"
"[b]Note:[/b] The [code]value[/code] should lie in the interval [code][0, "
@@ -20535,14 +21209,14 @@ msgid ""
"(see [method store_16] for an example)."
msgstr ""
-#: doc/classes/File.xml:339
+#: doc/classes/File.xml:341
msgid ""
"Stores an integer as 64 bits in the file.\n"
"[b]Note:[/b] The [code]value[/code] must lie in the interval [code][-2^63, "
"2^63 - 1][/code] (i.e. be a valid [int] value)."
msgstr ""
-#: doc/classes/File.xml:349
+#: doc/classes/File.xml:351
msgid ""
"Stores an integer as 8 bits in the file.\n"
"[b]Note:[/b] The [code]value[/code] should lie in the interval [code][0, 255]"
@@ -20551,11 +21225,11 @@ msgid ""
"(see [method store_16] for an example)."
msgstr ""
-#: doc/classes/File.xml:360
+#: doc/classes/File.xml:362
msgid "Stores the given array of bytes in the file."
msgstr ""
-#: doc/classes/File.xml:371
+#: doc/classes/File.xml:373
msgid ""
"Store the given [PackedStringArray] in the file as a line formatted in the "
"CSV (Comma-Separated Values) format. You can pass a different delimiter "
@@ -20564,45 +21238,45 @@ msgid ""
"Text will be encoded as UTF-8."
msgstr ""
-#: doc/classes/File.xml:381
+#: doc/classes/File.xml:383
msgid "Stores a floating-point number as 64 bits in the file."
msgstr ""
-#: doc/classes/File.xml:390
+#: doc/classes/File.xml:392
msgid "Stores a floating-point number as 32 bits in the file."
msgstr ""
-#: doc/classes/File.xml:399
+#: doc/classes/File.xml:401
msgid ""
"Stores the given [String] as a line in the file.\n"
"Text will be encoded as UTF-8."
msgstr ""
-#: doc/classes/File.xml:409
+#: doc/classes/File.xml:411
msgid ""
"Stores the given [String] as a line in the file in Pascal format (i.e. also "
"store the length of the string).\n"
"Text will be encoded as UTF-8."
msgstr ""
-#: doc/classes/File.xml:419
+#: doc/classes/File.xml:421
msgid "Stores a floating-point number in the file."
msgstr ""
-#: doc/classes/File.xml:428
+#: doc/classes/File.xml:430
msgid ""
"Stores the given [String] in the file.\n"
"Text will be encoded as UTF-8."
msgstr ""
-#: doc/classes/File.xml:440
+#: doc/classes/File.xml:442
msgid ""
"Stores any Variant value in the file. If [code]full_objects[/code] is "
"[code]true[/code], encoding objects is allowed (and can potentially include "
"code)."
msgstr ""
-#: doc/classes/File.xml:446
+#: doc/classes/File.xml:448
msgid ""
"If [code]true[/code], the file's endianness is swapped. Use this if you're "
"dealing with files written on big-endian machines.\n"
@@ -20610,44 +21284,44 @@ msgid ""
"reset to [code]false[/code] whenever you open the file."
msgstr ""
-#: doc/classes/File.xml:452
+#: doc/classes/File.xml:454
msgid "Opens the file for read operations."
msgstr ""
-#: doc/classes/File.xml:455
+#: doc/classes/File.xml:457
msgid ""
"Opens the file for write operations. Create it if the file does not exist "
"and truncate if it exists."
msgstr ""
-#: doc/classes/File.xml:458
+#: doc/classes/File.xml:460
msgid ""
"Opens the file for read and write operations. Does not truncate the file."
msgstr ""
-#: doc/classes/File.xml:461
+#: doc/classes/File.xml:463
msgid ""
"Opens the file for read and write operations. Create it if the file does not "
"exist and truncate if it exists."
msgstr ""
-#: doc/classes/File.xml:464
+#: doc/classes/File.xml:466
msgid "Uses the [url=http://fastlz.org/]FastLZ[/url] compression method."
msgstr ""
-#: doc/classes/File.xml:467
+#: doc/classes/File.xml:469
msgid ""
"Uses the [url=https://en.wikipedia.org/wiki/DEFLATE]DEFLATE[/url] "
"compression method."
msgstr ""
-#: doc/classes/File.xml:470
+#: doc/classes/File.xml:472
msgid ""
"Uses the [url=https://facebook.github.io/zstd/]Zstandard[/url] compression "
"method."
msgstr ""
-#: doc/classes/File.xml:473
+#: doc/classes/File.xml:475
msgid "Uses the [url=https://www.gzip.org/]gzip[/url] compression method."
msgstr ""
@@ -20863,10 +21537,11 @@ msgid ""
"Draw [code]string[/code] into a canvas item using the font at a given "
"position, with [code]modulate[/code] color, and optionally clipping the "
"width. [code]position[/code] specifies the baseline, not the top. To draw "
-"from the top, [i]ascent[/i] must be added to the Y axis."
+"from the top, [i]ascent[/i] must be added to the Y axis.\n"
+"See also [method CanvasItem.draw_string]."
msgstr ""
-#: doc/classes/Font.xml:47
+#: doc/classes/Font.xml:48
msgid ""
"Draw character [code]char[/code] into a canvas item using the font at a "
"given position, with [code]modulate[/code] color, and optionally kerning if "
@@ -20876,39 +21551,39 @@ msgid ""
"making this function useful for drawing strings character by character."
msgstr ""
-#: doc/classes/Font.xml:54
+#: doc/classes/Font.xml:55
msgid "Returns the font ascent (number of pixels above the baseline)."
msgstr ""
-#: doc/classes/Font.xml:65
+#: doc/classes/Font.xml:66
msgid ""
"Returns the size of a character, optionally taking kerning into account if "
"the next character is provided."
msgstr ""
-#: doc/classes/Font.xml:72
+#: doc/classes/Font.xml:73
msgid "Returns the font descent (number of pixels below the baseline)."
msgstr ""
-#: doc/classes/Font.xml:79
+#: doc/classes/Font.xml:80
msgid "Returns the total font height (ascent plus descent) in pixels."
msgstr ""
-#: doc/classes/Font.xml:88
+#: doc/classes/Font.xml:89
msgid "Returns the size of a string, taking kerning and advance into account."
msgstr ""
-#: doc/classes/Font.xml:99
+#: doc/classes/Font.xml:100
msgid ""
"Returns the size that the string would have with word wrapping enabled with "
"a fixed [code]width[/code]."
msgstr ""
-#: doc/classes/Font.xml:106
+#: doc/classes/Font.xml:107
msgid "Returns [code]true[/code] if the font has an outline."
msgstr ""
-#: doc/classes/Font.xml:119
+#: doc/classes/Font.xml:120
msgid ""
"After editing a font (changing size, ascent, char rects, etc.). Call this "
"function to propagate changes to controls that might use it."
@@ -21080,13 +21755,14 @@ msgstr ""
#: modules/gdscript/doc_classes/GDScriptFunctionState.xml:7
msgid ""
-"Calling [method @GDScript.yield] within a function will cause that function "
-"to yield and return its current state as an object of this type. The yielded "
+"FIXME: Outdated docs as of GDScript rewrite in 4.0.\n"
+"Calling [code]yield[/code] within a function will cause that function to "
+"yield and return its current state as an object of this type. The yielded "
"function call can then be resumed later by calling [method resume] on this "
"state object."
msgstr ""
-#: modules/gdscript/doc_classes/GDScriptFunctionState.xml:18
+#: modules/gdscript/doc_classes/GDScriptFunctionState.xml:19
msgid ""
"Check whether the function call may be resumed. This is not the case if the "
"function state was already resumed.\n"
@@ -21097,12 +21773,12 @@ msgid ""
"script have survived up to that point."
msgstr ""
-#: modules/gdscript/doc_classes/GDScriptFunctionState.xml:28
+#: modules/gdscript/doc_classes/GDScriptFunctionState.xml:29
msgid ""
"Resume execution of the yielded function call.\n"
-"If handed an argument, return the argument from the [method @GDScript.yield] "
-"call in the yielded function call. You can pass e.g. an [Array] to hand "
-"multiple arguments.\n"
+"If handed an argument, return the argument from the [code]yield[/code] call "
+"in the yielded function call. You can pass e.g. an [Array] to hand multiple "
+"arguments.\n"
"This function returns what the resumed function call returns, possibly "
"another function state if yielded again."
msgstr ""
@@ -21671,10 +22347,20 @@ msgid ""
"code], see [enum PolyJoinType].\n"
"The operation may result in an outer polygon (boundary) and inner polygon "
"(hole) produced which could be distinguished by calling [method "
-"is_polygon_clockwise]."
+"is_polygon_clockwise].\n"
+"[b]Note:[/b] To translate the polygon's vertices specifically, use the "
+"[method Transform2D.xform] method:\n"
+"[codeblock]\n"
+"var polygon = PackedVector2Array([Vector2(0, 0), Vector2(100, 0), "
+"Vector2(100, 100), Vector2(0, 100)])\n"
+"var offset = Vector2(50, 50)\n"
+"polygon = Transform2D(0, offset).xform(polygon)\n"
+"print(polygon) # prints [Vector2(50, 50), Vector2(150, 50), Vector2(150, "
+"150), Vector2(50, 150)]\n"
+"[/codeblock]"
msgstr ""
-#: doc/classes/Geometry2D.xml:217
+#: doc/classes/Geometry2D.xml:224
msgid ""
"Inflates or deflates [code]polyline[/code] by [code]delta[/code] units "
"(pixels), producing polygons. If [code]delta[/code] is positive, makes the "
@@ -21690,13 +22376,13 @@ msgid ""
"is_polygon_clockwise]."
msgstr ""
-#: doc/classes/Geometry2D.xml:235
+#: doc/classes/Geometry2D.xml:242
msgid ""
"Returns if [code]point[/code] is inside the triangle specified by [code]a[/"
"code], [code]b[/code] and [code]c[/code]."
msgstr ""
-#: doc/classes/Geometry2D.xml:250
+#: doc/classes/Geometry2D.xml:257
msgid ""
"Checks if the two segments ([code]from_a[/code], [code]to_a[/code]) and "
"([code]from_b[/code], [code]to_b[/code]) intersect. If yes, return the point "
@@ -21704,7 +22390,7 @@ msgid ""
"empty [Variant]."
msgstr ""
-#: doc/classes/Geometry2D.xml:259
+#: doc/classes/Geometry2D.xml:266
msgid ""
"Triangulates the area specified by discrete set of [code]points[/code] such "
"that no point is inside the circumcircle of any resulting triangle. Returns "
@@ -21715,7 +22401,7 @@ msgid ""
"[PackedInt32Array] is returned."
msgstr ""
-#: doc/classes/Geometry2D.xml:268
+#: doc/classes/Geometry2D.xml:275
msgid ""
"Triangulates the polygon specified by the points in [code]polygon[/code]. "
"Returns a [PackedInt32Array] where each triangle consists of three "
@@ -21725,40 +22411,40 @@ msgid ""
"[PackedInt32Array] is returned."
msgstr ""
-#: doc/classes/Geometry2D.xml:274
+#: doc/classes/Geometry2D.xml:281
msgid ""
"Create regions where either subject or clip polygons (or both) are filled."
msgstr ""
-#: doc/classes/Geometry2D.xml:277
+#: doc/classes/Geometry2D.xml:284
msgid ""
"Create regions where subject polygons are filled except where clip polygons "
"are filled."
msgstr ""
-#: doc/classes/Geometry2D.xml:280
+#: doc/classes/Geometry2D.xml:287
msgid "Create regions where both subject and clip polygons are filled."
msgstr ""
-#: doc/classes/Geometry2D.xml:283
+#: doc/classes/Geometry2D.xml:290
msgid ""
"Create regions where either subject or clip polygons are filled but not "
"where both are filled."
msgstr ""
-#: doc/classes/Geometry2D.xml:286
+#: doc/classes/Geometry2D.xml:293
msgid ""
"Squaring is applied uniformally at all convex edge joins at [code]1 * delta[/"
"code]."
msgstr ""
-#: doc/classes/Geometry2D.xml:289
+#: doc/classes/Geometry2D.xml:296
msgid ""
"While flattened paths can never perfectly trace an arc, they are "
"approximated by a series of arc chords."
msgstr ""
-#: doc/classes/Geometry2D.xml:292
+#: doc/classes/Geometry2D.xml:299
msgid ""
"There's a necessary limit to mitered joins since offsetting edges that join "
"at very acute angles will produce excessively long and narrow \"spikes\". "
@@ -21766,27 +22452,27 @@ msgid ""
"distance, \"square\" joining is applied."
msgstr ""
-#: doc/classes/Geometry2D.xml:295
+#: doc/classes/Geometry2D.xml:302
msgid ""
"Endpoints are joined using the [enum PolyJoinType] value and the path filled "
"as a polygon."
msgstr ""
-#: doc/classes/Geometry2D.xml:298
+#: doc/classes/Geometry2D.xml:305
msgid ""
"Endpoints are joined using the [enum PolyJoinType] value and the path filled "
"as a polyline."
msgstr ""
-#: doc/classes/Geometry2D.xml:301
+#: doc/classes/Geometry2D.xml:308
msgid "Endpoints are squared off with no extension."
msgstr ""
-#: doc/classes/Geometry2D.xml:304
+#: doc/classes/Geometry2D.xml:311
msgid "Endpoints are squared off and extended by [code]delta[/code] units."
msgstr ""
-#: doc/classes/Geometry2D.xml:307
+#: doc/classes/Geometry2D.xml:314
msgid "Endpoints are rounded off and extended by [code]delta[/code] units."
msgstr ""
@@ -22016,7 +22702,7 @@ msgstr ""
msgid ""
"Bakes the effect from all [GeometryInstance3D]s marked with [constant "
"GeometryInstance3D.GI_MODE_BAKED] and [Light3D]s marked with either "
-"[constant Light3D.BAKE_INDIRECT] or [constant Light3D.BAKE_ALL]. If "
+"[constant Light3D.BAKE_DYNAMIC] or [constant Light3D.BAKE_STATIC]. If "
"[code]create_visual_debug[/code] is [code]true[/code], after baking the "
"light, this will generate a [MultiMesh] that has a cube representing each "
"solid cell with each cube colored to the cell's albedo color. This can be "
@@ -22903,121 +23589,119 @@ msgstr ""
msgid "Clear all cells."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:53
+#: modules/gridmap/doc_classes/GridMap.xml:49
msgid ""
-"The [MeshLibrary] item index located at the grid-based X, Y and Z "
-"coordinates. If the cell is empty, [constant INVALID_CELL_ITEM] will be "
-"returned."
+"The [MeshLibrary] item index located at the given grid coordinates. If the "
+"cell is empty, [constant INVALID_CELL_ITEM] will be returned."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:66
+#: modules/gridmap/doc_classes/GridMap.xml:58
msgid ""
-"The orientation of the cell at the grid-based X, Y and Z coordinates. -1 is "
-"returned if the cell is empty."
+"The orientation of the cell at the given grid coordinates. [code]-1[/code] "
+"is returned if the cell is empty."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:75 doc/classes/PhysicsBody2D.xml:35
+#: modules/gridmap/doc_classes/GridMap.xml:67 doc/classes/PhysicsBody2D.xml:35
#: doc/classes/PhysicsBody3D.xml:35
msgid "Returns an individual bit on the [member collision_layer]."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:84 doc/classes/PhysicsBody2D.xml:44
+#: modules/gridmap/doc_classes/GridMap.xml:76 doc/classes/PhysicsBody2D.xml:44
#: doc/classes/PhysicsBody3D.xml:44
msgid "Returns an individual bit on the [member collision_mask]."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:91
+#: modules/gridmap/doc_classes/GridMap.xml:83
msgid ""
"Returns an array of [Transform] and [Mesh] references corresponding to the "
"non-empty cells in the grid. The transforms are specified in world space."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:98
+#: modules/gridmap/doc_classes/GridMap.xml:90
msgid ""
"Returns an array of [Vector3] with the non-empty cell coordinates in the "
"grid map."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:121
+#: modules/gridmap/doc_classes/GridMap.xml:109
msgid ""
"Returns the position of a grid cell in the GridMap's local coordinate space."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:146
+#: modules/gridmap/doc_classes/GridMap.xml:130
msgid ""
-"Sets the mesh index for the cell referenced by its grid-based X, Y and Z "
-"coordinates.\n"
+"Sets the mesh index for the cell referenced by its grid coordinates.\n"
"A negative item index such as [constant INVALID_CELL_ITEM] will clear the "
"cell.\n"
"Optionally, the item's orientation can be passed. For valid orientation "
"values, see [method Basis.get_orthogonal_index]."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:173
+#: modules/gridmap/doc_classes/GridMap.xml:157
msgid "Sets an individual bit on the [member collision_layer]."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:184
+#: modules/gridmap/doc_classes/GridMap.xml:168
msgid "Sets an individual bit on the [member collision_mask]."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:193
+#: modules/gridmap/doc_classes/GridMap.xml:177
msgid ""
"Returns the coordinates of the grid cell containing the given point.\n"
"[code]pos[/code] should be in the GridMap's local coordinate space."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:200
+#: modules/gridmap/doc_classes/GridMap.xml:184
msgid "If [code]true[/code], grid items are centered on the X axis."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:203
+#: modules/gridmap/doc_classes/GridMap.xml:187
msgid "If [code]true[/code], grid items are centered on the Y axis."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:206
+#: modules/gridmap/doc_classes/GridMap.xml:190
msgid "If [code]true[/code], grid items are centered on the Z axis."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:209
+#: modules/gridmap/doc_classes/GridMap.xml:193
msgid ""
"The size of each octant measured in number of cells. This applies to all "
"three axis."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:212
+#: modules/gridmap/doc_classes/GridMap.xml:196
msgid ""
"The scale of the cell items.\n"
"This does not affect the size of the grid cells themselves, only the items "
"in them. This can be used to make cell items overlap their neighbors."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:216
+#: modules/gridmap/doc_classes/GridMap.xml:200
msgid ""
"The dimensions of the grid's cells.\n"
"This does not affect the size of the meshes. See [member cell_scale]."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:220
+#: modules/gridmap/doc_classes/GridMap.xml:204
msgid ""
"The physics layers this GridMap is in.\n"
"GridMaps act as static bodies, meaning they aren't affected by gravity or "
"other forces. They only affect other physics bodies that collide with them."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:224
+#: modules/gridmap/doc_classes/GridMap.xml:208
msgid "The physics layers this GridMap detects collisions in."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:227
+#: modules/gridmap/doc_classes/GridMap.xml:211
msgid "The assigned [MeshLibrary]."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:235
+#: modules/gridmap/doc_classes/GridMap.xml:219
msgid "Emitted when [member cell_size] changes."
msgstr ""
-#: modules/gridmap/doc_classes/GridMap.xml:241
+#: modules/gridmap/doc_classes/GridMap.xml:225
msgid ""
"Invalid cell item that can be used in [method set_cell_item] to clear cells "
"(or represent an empty cell in [method get_cell_item])."
@@ -23382,27 +24066,33 @@ msgid ""
"server's side.\n"
"For more information on HTTP, see https://developer.mozilla.org/en-US/docs/"
"Web/HTTP (or read RFC 2616 to get it straight from the source: https://tools."
-"ietf.org/html/rfc2616)."
+"ietf.org/html/rfc2616).\n"
+"[b]Note:[/b] When performing HTTP requests from a project exported to HTML5, "
+"keep in mind the remote server may not allow requests from foreign origins "
+"due to [url=https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS]CORS[/"
+"url]. If you host the server in question, you should modify its backend to "
+"allow requests from foreign origins by adding the [code]Access-Control-Allow-"
+"Origin: *[/code] HTTP header."
msgstr ""
-#: doc/classes/HTTPClient.xml:13
+#: doc/classes/HTTPClient.xml:14
msgid ""
"https://docs.godotengine.org/en/latest/tutorials/networking/"
"http_client_class.html"
msgstr ""
-#: doc/classes/HTTPClient.xml:14 doc/classes/HTTPRequest.xml:62
+#: doc/classes/HTTPClient.xml:15 doc/classes/HTTPRequest.xml:71
#: doc/classes/StreamPeerSSL.xml:10
msgid ""
"https://docs.godotengine.org/en/latest/tutorials/networking/ssl_certificates."
"html"
msgstr ""
-#: doc/classes/HTTPClient.xml:21
+#: doc/classes/HTTPClient.xml:22
msgid "Closes the current connection, allowing reuse of this [HTTPClient]."
msgstr ""
-#: doc/classes/HTTPClient.xml:36
+#: doc/classes/HTTPClient.xml:37
msgid ""
"Connects to a host. This needs to be done before any requests are sent.\n"
"The host should not have http:// prepended but will strip the protocol "
@@ -23414,7 +24104,7 @@ msgid ""
"[code]true[/code]."
msgstr ""
-#: doc/classes/HTTPClient.xml:46
+#: doc/classes/HTTPClient.xml:47
msgid ""
"Returns the response's body length.\n"
"[b]Note:[/b] Some Web servers may not send a body length. In this case, the "
@@ -23422,15 +24112,15 @@ msgid ""
"the body length will also be [code]-1[/code]."
msgstr ""
-#: doc/classes/HTTPClient.xml:54
+#: doc/classes/HTTPClient.xml:55
msgid "Returns the response's HTTP status code."
msgstr ""
-#: doc/classes/HTTPClient.xml:61
+#: doc/classes/HTTPClient.xml:62
msgid "Returns the response headers."
msgstr ""
-#: doc/classes/HTTPClient.xml:68
+#: doc/classes/HTTPClient.xml:69
msgid ""
"Returns all response headers as a Dictionary of structure [code]{ \"key\": "
"\"value1; value2\" }[/code] where the case-sensitivity of the keys and "
@@ -23445,27 +24135,27 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/HTTPClient.xml:82
+#: doc/classes/HTTPClient.xml:83
msgid ""
"Returns a [enum Status] constant. Need to call [method poll] in order to get "
"status updates."
msgstr ""
-#: doc/classes/HTTPClient.xml:89
+#: doc/classes/HTTPClient.xml:90
msgid "If [code]true[/code], this [HTTPClient] has a response available."
msgstr ""
-#: doc/classes/HTTPClient.xml:96
+#: doc/classes/HTTPClient.xml:97
msgid "If [code]true[/code], this [HTTPClient] has a response that is chunked."
msgstr ""
-#: doc/classes/HTTPClient.xml:103
+#: doc/classes/HTTPClient.xml:104
msgid ""
"This needs to be called in order to have any request processed. Check "
"results with [method get_status]."
msgstr ""
-#: doc/classes/HTTPClient.xml:112
+#: doc/classes/HTTPClient.xml:113
msgid ""
"Generates a GET/POST application/x-www-form-urlencoded style query string "
"from a provided dictionary, e.g.:\n"
@@ -23485,11 +24175,11 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/HTTPClient.xml:130
+#: doc/classes/HTTPClient.xml:131
msgid "Reads one chunk from the response."
msgstr ""
-#: doc/classes/HTTPClient.xml:145
+#: doc/classes/HTTPClient.xml:146
msgid ""
"Sends a request to the connected host. The URL parameter is just the part "
"after the host, so for [code]http://somehost.com/index.php[/code], it is "
@@ -23507,7 +24197,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/HTTPClient.xml:168
+#: doc/classes/HTTPClient.xml:169
msgid ""
"Sends a raw request to the connected host. The URL parameter is just the "
"part after the host, so for [code]http://somehost.com/index.php[/code], it "
@@ -23517,43 +24207,43 @@ msgid ""
"Sends the body data raw, as a byte array and does not encode it in any way."
msgstr ""
-#: doc/classes/HTTPClient.xml:176
+#: doc/classes/HTTPClient.xml:177
msgid ""
"If [code]true[/code], execution will block until all data is read from the "
"response."
msgstr ""
-#: doc/classes/HTTPClient.xml:179
+#: doc/classes/HTTPClient.xml:180
msgid "The connection to use for this client."
msgstr ""
-#: doc/classes/HTTPClient.xml:182
+#: doc/classes/HTTPClient.xml:183
msgid ""
"The size of the buffer used and maximum bytes to read per iteration. See "
"[method read_response_body_chunk]."
msgstr ""
-#: doc/classes/HTTPClient.xml:187
+#: doc/classes/HTTPClient.xml:188
msgid ""
"HTTP GET method. The GET method requests a representation of the specified "
"resource. Requests using GET should only retrieve data."
msgstr ""
-#: doc/classes/HTTPClient.xml:190
+#: doc/classes/HTTPClient.xml:191
msgid ""
"HTTP HEAD method. The HEAD method asks for a response identical to that of a "
"GET request, but without the response body. This is useful to request "
"metadata like HTTP headers or to check if a resource exists."
msgstr ""
-#: doc/classes/HTTPClient.xml:193
+#: doc/classes/HTTPClient.xml:194
msgid ""
"HTTP POST method. The POST method is used to submit an entity to the "
"specified resource, often causing a change in state or side effects on the "
"server. This is often used for forms and submitting data or uploading files."
msgstr ""
-#: doc/classes/HTTPClient.xml:196
+#: doc/classes/HTTPClient.xml:197
msgid ""
"HTTP PUT method. The PUT method asks to replace all current representations "
"of the target resource with the request payload. (You can think of POST as "
@@ -23561,103 +24251,103 @@ msgid ""
"not make a clear distinction or change their meaning)."
msgstr ""
-#: doc/classes/HTTPClient.xml:199
+#: doc/classes/HTTPClient.xml:200
msgid ""
"HTTP DELETE method. The DELETE method requests to delete the specified "
"resource."
msgstr ""
-#: doc/classes/HTTPClient.xml:202
+#: doc/classes/HTTPClient.xml:203
msgid ""
"HTTP OPTIONS method. The OPTIONS method asks for a description of the "
"communication options for the target resource. Rarely used."
msgstr ""
-#: doc/classes/HTTPClient.xml:205
+#: doc/classes/HTTPClient.xml:206
msgid ""
"HTTP TRACE method. The TRACE method performs a message loop-back test along "
"the path to the target resource. Returns the entire HTTP request received in "
"the response body. Rarely used."
msgstr ""
-#: doc/classes/HTTPClient.xml:208
+#: doc/classes/HTTPClient.xml:209
msgid ""
"HTTP CONNECT method. The CONNECT method establishes a tunnel to the server "
"identified by the target resource. Rarely used."
msgstr ""
-#: doc/classes/HTTPClient.xml:211
+#: doc/classes/HTTPClient.xml:212
msgid ""
"HTTP PATCH method. The PATCH method is used to apply partial modifications "
"to a resource."
msgstr ""
-#: doc/classes/HTTPClient.xml:214
+#: doc/classes/HTTPClient.xml:215
msgid "Represents the size of the [enum Method] enum."
msgstr ""
-#: doc/classes/HTTPClient.xml:217
+#: doc/classes/HTTPClient.xml:218
msgid "Status: Disconnected from the server."
msgstr ""
-#: doc/classes/HTTPClient.xml:220
+#: doc/classes/HTTPClient.xml:221
msgid "Status: Currently resolving the hostname for the given URL into an IP."
msgstr ""
-#: doc/classes/HTTPClient.xml:223
+#: doc/classes/HTTPClient.xml:224
msgid "Status: DNS failure: Can't resolve the hostname for the given URL."
msgstr ""
-#: doc/classes/HTTPClient.xml:226
+#: doc/classes/HTTPClient.xml:227
msgid "Status: Currently connecting to server."
msgstr ""
-#: doc/classes/HTTPClient.xml:229
+#: doc/classes/HTTPClient.xml:230
msgid "Status: Can't connect to the server."
msgstr ""
-#: doc/classes/HTTPClient.xml:232
+#: doc/classes/HTTPClient.xml:233
msgid "Status: Connection established."
msgstr ""
-#: doc/classes/HTTPClient.xml:235
+#: doc/classes/HTTPClient.xml:236
msgid "Status: Currently sending request."
msgstr ""
-#: doc/classes/HTTPClient.xml:238
+#: doc/classes/HTTPClient.xml:239
msgid "Status: HTTP body received."
msgstr ""
-#: doc/classes/HTTPClient.xml:241
+#: doc/classes/HTTPClient.xml:242
msgid "Status: Error in HTTP connection."
msgstr ""
-#: doc/classes/HTTPClient.xml:244
+#: doc/classes/HTTPClient.xml:245
msgid "Status: Error in SSL handshake."
msgstr ""
-#: doc/classes/HTTPClient.xml:247
+#: doc/classes/HTTPClient.xml:248
msgid ""
"HTTP status code [code]100 Continue[/code]. Interim response that indicates "
"everything so far is OK and that the client should continue with the request "
"(or ignore this status if already finished)."
msgstr ""
-#: doc/classes/HTTPClient.xml:250
+#: doc/classes/HTTPClient.xml:251
msgid ""
"HTTP status code [code]101 Switching Protocol[/code]. Sent in response to an "
"[code]Upgrade[/code] request header by the client. Indicates the protocol "
"the server is switching to."
msgstr ""
-#: doc/classes/HTTPClient.xml:253
+#: doc/classes/HTTPClient.xml:254
msgid ""
"HTTP status code [code]102 Processing[/code] (WebDAV). Indicates that the "
"server has received and is processing the request, but no response is "
"available yet."
msgstr ""
-#: doc/classes/HTTPClient.xml:256
+#: doc/classes/HTTPClient.xml:257
msgid ""
"HTTP status code [code]200 OK[/code]. The request has succeeded. Default "
"response for successful requests. Meaning varies depending on the request. "
@@ -23668,14 +24358,14 @@ msgid ""
"server."
msgstr ""
-#: doc/classes/HTTPClient.xml:259
+#: doc/classes/HTTPClient.xml:260
msgid ""
"HTTP status code [code]201 Created[/code]. The request has succeeded and a "
"new resource has been created as a result of it. This is typically the "
"response sent after a PUT request."
msgstr ""
-#: doc/classes/HTTPClient.xml:262
+#: doc/classes/HTTPClient.xml:263
msgid ""
"HTTP status code [code]202 Accepted[/code]. The request has been received "
"but not yet acted upon. It is non-committal, meaning that there is no way in "
@@ -23684,7 +24374,7 @@ msgid ""
"server handles the request, or for batch processing."
msgstr ""
-#: doc/classes/HTTPClient.xml:265
+#: doc/classes/HTTPClient.xml:266
msgid ""
"HTTP status code [code]203 Non-Authoritative Information[/code]. This "
"response code means returned meta-information set is not exact set as "
@@ -23693,14 +24383,14 @@ msgid ""
"instead of this response."
msgstr ""
-#: doc/classes/HTTPClient.xml:268
+#: doc/classes/HTTPClient.xml:269
msgid ""
"HTTP status code [code]204 No Content[/code]. There is no content to send "
"for this request, but the headers may be useful. The user-agent may update "
"its cached headers for this resource with the new ones."
msgstr ""
-#: doc/classes/HTTPClient.xml:271
+#: doc/classes/HTTPClient.xml:272
msgid ""
"HTTP status code [code]205 Reset Content[/code]. The server has fulfilled "
"the request and desires that the client resets the \"document view\" that "
@@ -23708,49 +24398,49 @@ msgid ""
"origin server."
msgstr ""
-#: doc/classes/HTTPClient.xml:274
+#: doc/classes/HTTPClient.xml:275
msgid ""
"HTTP status code [code]206 Partial Content[/code]. This response code is "
"used because of a range header sent by the client to separate download into "
"multiple streams."
msgstr ""
-#: doc/classes/HTTPClient.xml:277
+#: doc/classes/HTTPClient.xml:278
msgid ""
"HTTP status code [code]207 Multi-Status[/code] (WebDAV). A Multi-Status "
"response conveys information about multiple resources in situations where "
"multiple status codes might be appropriate."
msgstr ""
-#: doc/classes/HTTPClient.xml:280
+#: doc/classes/HTTPClient.xml:281
msgid ""
"HTTP status code [code]208 Already Reported[/code] (WebDAV). Used inside a "
"DAV: propstat response element to avoid enumerating the internal members of "
"multiple bindings to the same collection repeatedly."
msgstr ""
-#: doc/classes/HTTPClient.xml:283
+#: doc/classes/HTTPClient.xml:284
msgid ""
"HTTP status code [code]226 IM Used[/code] (WebDAV). The server has fulfilled "
"a GET request for the resource, and the response is a representation of the "
"result of one or more instance-manipulations applied to the current instance."
msgstr ""
-#: doc/classes/HTTPClient.xml:286
+#: doc/classes/HTTPClient.xml:287
msgid ""
"HTTP status code [code]300 Multiple Choice[/code]. The request has more than "
"one possible responses and there is no standardized way to choose one of the "
"responses. User-agent or user should choose one of them."
msgstr ""
-#: doc/classes/HTTPClient.xml:289
+#: doc/classes/HTTPClient.xml:290
msgid ""
"HTTP status code [code]301 Moved Permanently[/code]. Redirection. This "
"response code means the URI of requested resource has been changed. The new "
"URI is usually included in the response."
msgstr ""
-#: doc/classes/HTTPClient.xml:292
+#: doc/classes/HTTPClient.xml:293
msgid ""
"HTTP status code [code]302 Found[/code]. Temporary redirection. This "
"response code means the URI of requested resource has been changed "
@@ -23758,7 +24448,7 @@ msgid ""
"this same URI should be used by the client in future requests."
msgstr ""
-#: doc/classes/HTTPClient.xml:295
+#: doc/classes/HTTPClient.xml:296
msgid ""
"HTTP status code [code]303 See Other[/code]. The server is redirecting the "
"user agent to a different resource, as indicated by a URI in the Location "
@@ -23766,39 +24456,39 @@ msgid ""
"original request."
msgstr ""
-#: doc/classes/HTTPClient.xml:298
+#: doc/classes/HTTPClient.xml:299
msgid ""
"HTTP status code [code]304 Not Modified[/code]. A conditional GET or HEAD "
"request has been received and would have resulted in a 200 OK response if it "
"were not for the fact that the condition evaluated to [code]false[/code]."
msgstr ""
-#: doc/classes/HTTPClient.xml:301
+#: doc/classes/HTTPClient.xml:302
msgid ""
"HTTP status code [code]305 Use Proxy[/code]. [i]Deprecated. Do not use.[/i]"
msgstr ""
-#: doc/classes/HTTPClient.xml:304
+#: doc/classes/HTTPClient.xml:305
msgid ""
"HTTP status code [code]306 Switch Proxy[/code]. [i]Deprecated. Do not use.[/"
"i]"
msgstr ""
-#: doc/classes/HTTPClient.xml:307
+#: doc/classes/HTTPClient.xml:308
msgid ""
"HTTP status code [code]307 Temporary Redirect[/code]. The target resource "
"resides temporarily under a different URI and the user agent MUST NOT change "
"the request method if it performs an automatic redirection to that URI."
msgstr ""
-#: doc/classes/HTTPClient.xml:310
+#: doc/classes/HTTPClient.xml:311
msgid ""
"HTTP status code [code]308 Permanent Redirect[/code]. The target resource "
"has been assigned a new permanent URI and any future references to this "
"resource ought to use one of the enclosed URIs."
msgstr ""
-#: doc/classes/HTTPClient.xml:313
+#: doc/classes/HTTPClient.xml:314
msgid ""
"HTTP status code [code]400 Bad Request[/code]. The request was invalid. The "
"server cannot or will not process the request due to something that is "
@@ -23807,21 +24497,21 @@ msgid ""
"routing)."
msgstr ""
-#: doc/classes/HTTPClient.xml:316
+#: doc/classes/HTTPClient.xml:317
msgid ""
"HTTP status code [code]401 Unauthorized[/code]. Credentials required. The "
"request has not been applied because it lacks valid authentication "
"credentials for the target resource."
msgstr ""
-#: doc/classes/HTTPClient.xml:319
+#: doc/classes/HTTPClient.xml:320
msgid ""
"HTTP status code [code]402 Payment Required[/code]. This response code is "
"reserved for future use. Initial aim for creating this code was using it for "
"digital payment systems, however this is not currently used."
msgstr ""
-#: doc/classes/HTTPClient.xml:322
+#: doc/classes/HTTPClient.xml:323
msgid ""
"HTTP status code [code]403 Forbidden[/code]. The client does not have access "
"rights to the content, i.e. they are unauthorized, so server is rejecting to "
@@ -23829,7 +24519,7 @@ msgid ""
"known to the server."
msgstr ""
-#: doc/classes/HTTPClient.xml:325
+#: doc/classes/HTTPClient.xml:326
msgid ""
"HTTP status code [code]404 Not Found[/code]. The server can not find "
"requested resource. Either the URL is not recognized or the endpoint is "
@@ -23837,7 +24527,7 @@ msgid ""
"403 to hide existence of a resource if the client is not authorized."
msgstr ""
-#: doc/classes/HTTPClient.xml:328
+#: doc/classes/HTTPClient.xml:329
msgid ""
"HTTP status code [code]405 Method Not Allowed[/code]. The request's HTTP "
"method is known by the server but has been disabled and cannot be used. For "
@@ -23845,7 +24535,7 @@ msgid ""
"GET and HEAD, must never be disabled and should not return this error code."
msgstr ""
-#: doc/classes/HTTPClient.xml:331
+#: doc/classes/HTTPClient.xml:332
msgid ""
"HTTP status code [code]406 Not Acceptable[/code]. The target resource does "
"not have a current representation that would be acceptable to the user "
@@ -23853,21 +24543,21 @@ msgid ""
"request. Used when negotiation content."
msgstr ""
-#: doc/classes/HTTPClient.xml:334
+#: doc/classes/HTTPClient.xml:335
msgid ""
"HTTP status code [code]407 Proxy Authentication Required[/code]. Similar to "
"401 Unauthorized, but it indicates that the client needs to authenticate "
"itself in order to use a proxy."
msgstr ""
-#: doc/classes/HTTPClient.xml:337
+#: doc/classes/HTTPClient.xml:338
msgid ""
"HTTP status code [code]408 Request Timeout[/code]. The server did not "
"receive a complete request message within the time that it was prepared to "
"wait."
msgstr ""
-#: doc/classes/HTTPClient.xml:340
+#: doc/classes/HTTPClient.xml:341
msgid ""
"HTTP status code [code]409 Conflict[/code]. The request could not be "
"completed due to a conflict with the current state of the target resource. "
@@ -23875,47 +24565,47 @@ msgid ""
"conflict and resubmit the request."
msgstr ""
-#: doc/classes/HTTPClient.xml:343
+#: doc/classes/HTTPClient.xml:344
msgid ""
"HTTP status code [code]410 Gone[/code]. The target resource is no longer "
"available at the origin server and this condition is likely permanent."
msgstr ""
-#: doc/classes/HTTPClient.xml:346
+#: doc/classes/HTTPClient.xml:347
msgid ""
"HTTP status code [code]411 Length Required[/code]. The server refuses to "
"accept the request without a defined Content-Length header."
msgstr ""
-#: doc/classes/HTTPClient.xml:349
+#: doc/classes/HTTPClient.xml:350
msgid ""
"HTTP status code [code]412 Precondition Failed[/code]. One or more "
"conditions given in the request header fields evaluated to [code]false[/"
"code] when tested on the server."
msgstr ""
-#: doc/classes/HTTPClient.xml:352
+#: doc/classes/HTTPClient.xml:353
msgid ""
"HTTP status code [code]413 Entity Too Large[/code]. The server is refusing "
"to process a request because the request payload is larger than the server "
"is willing or able to process."
msgstr ""
-#: doc/classes/HTTPClient.xml:355
+#: doc/classes/HTTPClient.xml:356
msgid ""
"HTTP status code [code]414 Request-URI Too Long[/code]. The server is "
"refusing to service the request because the request-target is longer than "
"the server is willing to interpret."
msgstr ""
-#: doc/classes/HTTPClient.xml:358
+#: doc/classes/HTTPClient.xml:359
msgid ""
"HTTP status code [code]415 Unsupported Media Type[/code]. The origin server "
"is refusing to service the request because the payload is in a format not "
"supported by this method on the target resource."
msgstr ""
-#: doc/classes/HTTPClient.xml:361
+#: doc/classes/HTTPClient.xml:362
msgid ""
"HTTP status code [code]416 Requested Range Not Satisfiable[/code]. None of "
"the ranges in the request's Range header field overlap the current extent of "
@@ -23923,21 +24613,21 @@ msgid ""
"to invalid ranges or an excessive request of small or overlapping ranges."
msgstr ""
-#: doc/classes/HTTPClient.xml:364
+#: doc/classes/HTTPClient.xml:365
msgid ""
"HTTP status code [code]417 Expectation Failed[/code]. The expectation given "
"in the request's Expect header field could not be met by at least one of the "
"inbound servers."
msgstr ""
-#: doc/classes/HTTPClient.xml:367
+#: doc/classes/HTTPClient.xml:368
msgid ""
"HTTP status code [code]418 I'm A Teapot[/code]. Any attempt to brew coffee "
"with a teapot should result in the error code \"418 I'm a teapot\". The "
"resulting entity body MAY be short and stout."
msgstr ""
-#: doc/classes/HTTPClient.xml:370
+#: doc/classes/HTTPClient.xml:371
msgid ""
"HTTP status code [code]421 Misdirected Request[/code]. The request was "
"directed at a server that is not able to produce a response. This can be "
@@ -23945,7 +24635,7 @@ msgid ""
"combination of scheme and authority that are included in the request URI."
msgstr ""
-#: doc/classes/HTTPClient.xml:373
+#: doc/classes/HTTPClient.xml:374
msgid ""
"HTTP status code [code]422 Unprocessable Entity[/code] (WebDAV). The server "
"understands the content type of the request entity (hence a 415 Unsupported "
@@ -23954,40 +24644,40 @@ msgid ""
"was unable to process the contained instructions."
msgstr ""
-#: doc/classes/HTTPClient.xml:376
+#: doc/classes/HTTPClient.xml:377
msgid ""
"HTTP status code [code]423 Locked[/code] (WebDAV). The source or destination "
"resource of a method is locked."
msgstr ""
-#: doc/classes/HTTPClient.xml:379
+#: doc/classes/HTTPClient.xml:380
msgid ""
"HTTP status code [code]424 Failed Dependency[/code] (WebDAV). The method "
"could not be performed on the resource because the requested action depended "
"on another action and that action failed."
msgstr ""
-#: doc/classes/HTTPClient.xml:382
+#: doc/classes/HTTPClient.xml:383
msgid ""
"HTTP status code [code]426 Upgrade Required[/code]. The server refuses to "
"perform the request using the current protocol but might be willing to do so "
"after the client upgrades to a different protocol."
msgstr ""
-#: doc/classes/HTTPClient.xml:385
+#: doc/classes/HTTPClient.xml:386
msgid ""
"HTTP status code [code]428 Precondition Required[/code]. The origin server "
"requires the request to be conditional."
msgstr ""
-#: doc/classes/HTTPClient.xml:388
+#: doc/classes/HTTPClient.xml:389
msgid ""
"HTTP status code [code]429 Too Many Requests[/code]. The user has sent too "
"many requests in a given amount of time (see \"rate limiting\"). Back off "
"and increase time between requests or try again later."
msgstr ""
-#: doc/classes/HTTPClient.xml:391
+#: doc/classes/HTTPClient.xml:392
msgid ""
"HTTP status code [code]431 Request Header Fields Too Large[/code]. The "
"server is unwilling to process the request because its header fields are too "
@@ -23995,27 +24685,27 @@ msgid ""
"header fields."
msgstr ""
-#: doc/classes/HTTPClient.xml:394
+#: doc/classes/HTTPClient.xml:395
msgid ""
"HTTP status code [code]451 Response Unavailable For Legal Reasons[/code]. "
"The server is denying access to the resource as a consequence of a legal "
"demand."
msgstr ""
-#: doc/classes/HTTPClient.xml:397
+#: doc/classes/HTTPClient.xml:398
msgid ""
"HTTP status code [code]500 Internal Server Error[/code]. The server "
"encountered an unexpected condition that prevented it from fulfilling the "
"request."
msgstr ""
-#: doc/classes/HTTPClient.xml:400
+#: doc/classes/HTTPClient.xml:401
msgid ""
"HTTP status code [code]501 Not Implemented[/code]. The server does not "
"support the functionality required to fulfill the request."
msgstr ""
-#: doc/classes/HTTPClient.xml:403
+#: doc/classes/HTTPClient.xml:404
msgid ""
"HTTP status code [code]502 Bad Gateway[/code]. The server, while acting as a "
"gateway or proxy, received an invalid response from an inbound server it "
@@ -24023,7 +24713,7 @@ msgid ""
"balancers or proxies."
msgstr ""
-#: doc/classes/HTTPClient.xml:406
+#: doc/classes/HTTPClient.xml:407
msgid ""
"HTTP status code [code]503 Service Unavailable[/code]. The server is "
"currently unable to handle the request due to a temporary overload or "
@@ -24031,7 +24721,7 @@ msgid ""
"again later."
msgstr ""
-#: doc/classes/HTTPClient.xml:409
+#: doc/classes/HTTPClient.xml:410
msgid ""
"HTTP status code [code]504 Gateway Timeout[/code]. The server, while acting "
"as a gateway or proxy, did not receive a timely response from an upstream "
@@ -24039,14 +24729,14 @@ msgid ""
"returned by load balancers or proxies."
msgstr ""
-#: doc/classes/HTTPClient.xml:412
+#: doc/classes/HTTPClient.xml:413
msgid ""
"HTTP status code [code]505 HTTP Version Not Supported[/code]. The server "
"does not support, or refuses to support, the major version of HTTP that was "
"used in the request message."
msgstr ""
-#: doc/classes/HTTPClient.xml:415
+#: doc/classes/HTTPClient.xml:416
msgid ""
"HTTP status code [code]506 Variant Also Negotiates[/code]. The server has an "
"internal configuration error: the chosen variant resource is configured to "
@@ -24054,14 +24744,14 @@ msgid ""
"proper end point in the negotiation process."
msgstr ""
-#: doc/classes/HTTPClient.xml:418
+#: doc/classes/HTTPClient.xml:419
msgid ""
"HTTP status code [code]507 Insufficient Storage[/code]. The method could not "
"be performed on the resource because the server is unable to store the "
"representation needed to successfully complete the request."
msgstr ""
-#: doc/classes/HTTPClient.xml:421
+#: doc/classes/HTTPClient.xml:422
msgid ""
"HTTP status code [code]508 Loop Detected[/code]. The server terminated an "
"operation because it encountered an infinite loop while processing a request "
@@ -24069,14 +24759,14 @@ msgid ""
"failed."
msgstr ""
-#: doc/classes/HTTPClient.xml:424
+#: doc/classes/HTTPClient.xml:425
msgid ""
"HTTP status code [code]510 Not Extended[/code]. The policy for accessing the "
"resource has not been met in the request. The server should send back all "
"the information necessary for the client to issue an extended request."
msgstr ""
-#: doc/classes/HTTPClient.xml:427
+#: doc/classes/HTTPClient.xml:428
msgid ""
"HTTP status code [code]511 Network Authentication Required[/code]. The "
"client needs to authenticate to gain network access."
@@ -24102,12 +24792,21 @@ msgid ""
" http_request.connect(\"request_completed\", self, "
"\"_http_request_completed\")\n"
"\n"
-" # Perform the HTTP request. The URL below returns some JSON as of "
-"writing.\n"
+" # Perform a GET request. The URL below returns JSON as of writing.\n"
" var error = http_request.request(\"https://httpbin.org/get\")\n"
" if error != OK:\n"
" push_error(\"An error occurred in the HTTP request.\")\n"
"\n"
+" # Perform a POST request. The URL below returns JSON as of writing.\n"
+" # Note: Don't make simultaneous requests using a single HTTPRequest "
+"node.\n"
+" # The snippet below is provided for reference only.\n"
+" var body = {\"name\": \"Godette\"}\n"
+" var error = http_request.request(\"https://httpbin.org/post\", [], true, "
+"HTTPClient.METHOD_POST, body)\n"
+" if error != OK:\n"
+" push_error(\"An error occurred in the HTTP request.\")\n"
+"\n"
"\n"
"# Called when the HTTP request is completed.\n"
"func _http_request_completed(result, response_code, headers, body):\n"
@@ -24147,20 +24846,26 @@ msgid ""
" var texture_rect = TextureRect.new()\n"
" add_child(texture_rect)\n"
" texture_rect.texture = texture\n"
-"[/codeblock]"
+"[/codeblock]\n"
+"[b]Note:[/b] When performing HTTP requests from a project exported to HTML5, "
+"keep in mind the remote server may not allow requests from foreign origins "
+"due to [url=https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS]CORS[/"
+"url]. If you host the server in question, you should modify its backend to "
+"allow requests from foreign origins by adding the [code]Access-Control-Allow-"
+"Origin: *[/code] HTTP header."
msgstr ""
-#: doc/classes/HTTPRequest.xml:61
+#: doc/classes/HTTPRequest.xml:70
msgid ""
"https://docs.godotengine.org/en/latest/tutorials/networking/"
"http_request_class.html"
msgstr ""
-#: doc/classes/HTTPRequest.xml:69
+#: doc/classes/HTTPRequest.xml:78
msgid "Cancels the current request."
msgstr ""
-#: doc/classes/HTTPRequest.xml:76
+#: doc/classes/HTTPRequest.xml:85
msgid ""
"Returns the response body length.\n"
"[b]Note:[/b] Some Web servers may not send a body length. In this case, the "
@@ -24168,17 +24873,17 @@ msgid ""
"the body length will also be [code]-1[/code]."
msgstr ""
-#: doc/classes/HTTPRequest.xml:84
+#: doc/classes/HTTPRequest.xml:93
msgid "Returns the amount of bytes this HTTPRequest downloaded."
msgstr ""
-#: doc/classes/HTTPRequest.xml:91
+#: doc/classes/HTTPRequest.xml:100
msgid ""
"Returns the current status of the underlying [HTTPClient]. See [enum "
"HTTPClient.Status]."
msgstr ""
-#: doc/classes/HTTPRequest.xml:108
+#: doc/classes/HTTPRequest.xml:117
msgid ""
"Creates request on the underlying [HTTPClient]. If there is no configuration "
"errors, it tries to connect using [method HTTPClient.connect_to_host] and "
@@ -24191,11 +24896,11 @@ msgid ""
"connect to host."
msgstr ""
-#: doc/classes/HTTPRequest.xml:115
+#: doc/classes/HTTPRequest.xml:124
msgid "Maximum allowed size for response bodies."
msgstr ""
-#: doc/classes/HTTPRequest.xml:118
+#: doc/classes/HTTPRequest.xml:127
msgid ""
"The size of the buffer used and maximum bytes to read per iteration. See "
"[member HTTPClient.read_chunk_size].\n"
@@ -24203,63 +24908,63 @@ msgid ""
"files to achieve better speeds at the cost of memory."
msgstr ""
-#: doc/classes/HTTPRequest.xml:122
+#: doc/classes/HTTPRequest.xml:131
msgid "The file to download into. Will output any received file into it."
msgstr ""
-#: doc/classes/HTTPRequest.xml:125
+#: doc/classes/HTTPRequest.xml:134
msgid "Maximum number of allowed redirects."
msgstr ""
-#: doc/classes/HTTPRequest.xml:130
+#: doc/classes/HTTPRequest.xml:139
msgid "If [code]true[/code], multithreading is used to improve performance."
msgstr ""
-#: doc/classes/HTTPRequest.xml:144
+#: doc/classes/HTTPRequest.xml:153
msgid "Emitted when a request is completed."
msgstr ""
-#: doc/classes/HTTPRequest.xml:150
+#: doc/classes/HTTPRequest.xml:159
msgid "Request successful."
msgstr ""
-#: doc/classes/HTTPRequest.xml:155
+#: doc/classes/HTTPRequest.xml:164
msgid "Request failed while connecting."
msgstr ""
-#: doc/classes/HTTPRequest.xml:158
+#: doc/classes/HTTPRequest.xml:167
msgid "Request failed while resolving."
msgstr ""
-#: doc/classes/HTTPRequest.xml:161
+#: doc/classes/HTTPRequest.xml:170
msgid "Request failed due to connection (read/write) error."
msgstr ""
-#: doc/classes/HTTPRequest.xml:164
+#: doc/classes/HTTPRequest.xml:173
msgid "Request failed on SSL handshake."
msgstr ""
-#: doc/classes/HTTPRequest.xml:167
+#: doc/classes/HTTPRequest.xml:176
msgid "Request does not have a response (yet)."
msgstr ""
-#: doc/classes/HTTPRequest.xml:170
+#: doc/classes/HTTPRequest.xml:179
msgid "Request exceeded its maximum size limit, see [member body_size_limit]."
msgstr ""
-#: doc/classes/HTTPRequest.xml:173
+#: doc/classes/HTTPRequest.xml:182
msgid "Request failed (currently unused)."
msgstr ""
-#: doc/classes/HTTPRequest.xml:176
+#: doc/classes/HTTPRequest.xml:185
msgid "HTTPRequest couldn't open the download file."
msgstr ""
-#: doc/classes/HTTPRequest.xml:179
+#: doc/classes/HTTPRequest.xml:188
msgid "HTTPRequest couldn't write to the download file."
msgstr ""
-#: doc/classes/HTTPRequest.xml:182
+#: doc/classes/HTTPRequest.xml:191
msgid "Request reached its maximum redirect limit, see [member max_redirects]."
msgstr ""
@@ -24483,42 +25188,46 @@ msgid "Loads an image from the binary contents of a PNG file."
msgstr ""
#: doc/classes/Image.xml:373
+msgid "Loads an image from the binary contents of a TGA file."
+msgstr ""
+
+#: doc/classes/Image.xml:382
msgid "Loads an image from the binary contents of a WebP file."
msgstr ""
-#: doc/classes/Image.xml:380
+#: doc/classes/Image.xml:389
msgid ""
"Converts the image's data to represent coordinates on a 3D plane. This is "
"used when the image represents a normalmap. A normalmap can add lots of "
"detail to a 3D surface without increasing the polygon count."
msgstr ""
-#: doc/classes/Image.xml:387
+#: doc/classes/Image.xml:396
msgid ""
"Multiplies color values with alpha values. Resulting color values for a "
"pixel are [code](color * alpha)/256[/code]."
msgstr ""
-#: doc/classes/Image.xml:400
+#: doc/classes/Image.xml:409
msgid ""
"Resizes the image to the given [code]width[/code] and [code]height[/code]. "
"New pixels are calculated using [code]interpolation[/code]. See "
"[code]interpolation[/code] constants."
msgstr ""
-#: doc/classes/Image.xml:409
+#: doc/classes/Image.xml:418
msgid ""
"Resizes the image to the nearest power of 2 for the width and height. If "
"[code]square[/code] is [code]true[/code] then set width and height to be the "
"same."
msgstr ""
-#: doc/classes/Image.xml:416
+#: doc/classes/Image.xml:425
msgid ""
"Converts a standard RGBE (Red Green Blue Exponent) image to an sRGB image."
msgstr ""
-#: doc/classes/Image.xml:427
+#: doc/classes/Image.xml:436
msgid ""
"Saves the image as an EXR file to [code]path[/code]. If [code]grayscale[/"
"code] is [code]true[/code] and the image has only one channel, it will be "
@@ -24527,11 +25236,11 @@ msgid ""
"TinyEXR module."
msgstr ""
-#: doc/classes/Image.xml:436
+#: doc/classes/Image.xml:445
msgid "Saves the image as a PNG file to [code]path[/code]."
msgstr ""
-#: doc/classes/Image.xml:455
+#: doc/classes/Image.xml:464
msgid ""
"Sets the [Color] of the pixel at [code](x, y)[/code]. Example:\n"
"[codeblock]\n"
@@ -24541,7 +25250,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/Image.xml:471
+#: doc/classes/Image.xml:480
msgid ""
"Sets the [Color] of the pixel at [code](dst.x, dst.y)[/code]. Note that the "
"[code]dst[/code] values must be integers. Example:\n"
@@ -24552,51 +25261,51 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/Image.xml:483
+#: doc/classes/Image.xml:492
msgid "Shrinks the image by a factor of 2."
msgstr ""
-#: doc/classes/Image.xml:490
+#: doc/classes/Image.xml:499
msgid "Converts the raw data from the sRGB colorspace to a linear scale."
msgstr ""
-#: doc/classes/Image.xml:496
+#: doc/classes/Image.xml:505
msgid ""
"Holds all of the image's color data in a given format. See [enum Format] "
"constants."
msgstr ""
-#: doc/classes/Image.xml:501
+#: doc/classes/Image.xml:510
msgid "The maximal width allowed for [Image] resources."
msgstr ""
-#: doc/classes/Image.xml:504
+#: doc/classes/Image.xml:513
msgid "The maximal height allowed for [Image] resources."
msgstr ""
-#: doc/classes/Image.xml:507
+#: doc/classes/Image.xml:516
msgid "Texture format with a single 8-bit depth representing luminance."
msgstr ""
-#: doc/classes/Image.xml:510
+#: doc/classes/Image.xml:519
msgid ""
"OpenGL texture format with two values, luminance and alpha each stored with "
"8 bits."
msgstr ""
-#: doc/classes/Image.xml:513
+#: doc/classes/Image.xml:522
msgid ""
"OpenGL texture format [code]RED[/code] with a single component and a "
"bitdepth of 8."
msgstr ""
-#: doc/classes/Image.xml:516
+#: doc/classes/Image.xml:525
msgid ""
"OpenGL texture format [code]RG[/code] with two components and a bitdepth of "
"8 for each."
msgstr ""
-#: doc/classes/Image.xml:519
+#: doc/classes/Image.xml:528
msgid ""
"OpenGL texture format [code]RGB[/code] with three components, each with a "
"bitdepth of 8.\n"
@@ -24604,7 +25313,7 @@ msgid ""
"conversion is performed."
msgstr ""
-#: doc/classes/Image.xml:523
+#: doc/classes/Image.xml:532
msgid ""
"OpenGL texture format [code]RGBA[/code] with four components, each with a "
"bitdepth of 8.\n"
@@ -24612,67 +25321,67 @@ msgid ""
"conversion is performed."
msgstr ""
-#: doc/classes/Image.xml:527
+#: doc/classes/Image.xml:536
msgid ""
"OpenGL texture format [code]RGBA[/code] with four components, each with a "
"bitdepth of 4."
msgstr ""
-#: doc/classes/Image.xml:532
+#: doc/classes/Image.xml:541
msgid ""
"OpenGL texture format [code]GL_R32F[/code] where there's one component, a 32-"
"bit floating-point value."
msgstr ""
-#: doc/classes/Image.xml:535
+#: doc/classes/Image.xml:544
msgid ""
"OpenGL texture format [code]GL_RG32F[/code] where there are two components, "
"each a 32-bit floating-point values."
msgstr ""
-#: doc/classes/Image.xml:538
+#: doc/classes/Image.xml:547
msgid ""
"OpenGL texture format [code]GL_RGB32F[/code] where there are three "
"components, each a 32-bit floating-point values."
msgstr ""
-#: doc/classes/Image.xml:541
+#: doc/classes/Image.xml:550
msgid ""
"OpenGL texture format [code]GL_RGBA32F[/code] where there are four "
"components, each a 32-bit floating-point values."
msgstr ""
-#: doc/classes/Image.xml:544
+#: doc/classes/Image.xml:553
msgid ""
"OpenGL texture format [code]GL_R32F[/code] where there's one component, a 16-"
"bit \"half-precision\" floating-point value."
msgstr ""
-#: doc/classes/Image.xml:547
+#: doc/classes/Image.xml:556
msgid ""
"OpenGL texture format [code]GL_RG32F[/code] where there are two components, "
"each a 16-bit \"half-precision\" floating-point value."
msgstr ""
-#: doc/classes/Image.xml:550
+#: doc/classes/Image.xml:559
msgid ""
"OpenGL texture format [code]GL_RGB32F[/code] where there are three "
"components, each a 16-bit \"half-precision\" floating-point value."
msgstr ""
-#: doc/classes/Image.xml:553
+#: doc/classes/Image.xml:562
msgid ""
"OpenGL texture format [code]GL_RGBA32F[/code] where there are four "
"components, each a 16-bit \"half-precision\" floating-point value."
msgstr ""
-#: doc/classes/Image.xml:556
+#: doc/classes/Image.xml:565
msgid ""
"A special OpenGL texture format where the three color components have 9 bits "
"of precision and all three share a single 5-bit exponent."
msgstr ""
-#: doc/classes/Image.xml:559
+#: doc/classes/Image.xml:568
msgid ""
"The [url=https://en.wikipedia.org/wiki/S3_Texture_Compression]S3TC[/url] "
"texture format that uses Block Compression 1, and is the smallest variation "
@@ -24682,7 +25391,7 @@ msgid ""
"conversion is performed."
msgstr ""
-#: doc/classes/Image.xml:563
+#: doc/classes/Image.xml:572
msgid ""
"The [url=https://en.wikipedia.org/wiki/S3_Texture_Compression]S3TC[/url] "
"texture format that uses Block Compression 2, and color data is interpreted "
@@ -24692,7 +25401,7 @@ msgid ""
"conversion is performed."
msgstr ""
-#: doc/classes/Image.xml:567
+#: doc/classes/Image.xml:576
msgid ""
"The [url=https://en.wikipedia.org/wiki/S3_Texture_Compression]S3TC[/url] "
"texture format also known as Block Compression 3 or BC3 that contains 64 "
@@ -24703,7 +25412,7 @@ msgid ""
"conversion is performed."
msgstr ""
-#: doc/classes/Image.xml:571
+#: doc/classes/Image.xml:580
msgid ""
"Texture format that uses [url=https://www.khronos.org/opengl/wiki/"
"Red_Green_Texture_Compression]Red Green Texture Compression[/url], "
@@ -24711,7 +25420,7 @@ msgid ""
"DXT5 uses for the alpha channel."
msgstr ""
-#: doc/classes/Image.xml:574
+#: doc/classes/Image.xml:583
msgid ""
"Texture format that uses [url=https://www.khronos.org/opengl/wiki/"
"Red_Green_Texture_Compression]Red Green Texture Compression[/url], "
@@ -24719,7 +25428,7 @@ msgid ""
"algorithm that DXT5 uses for the alpha channel."
msgstr ""
-#: doc/classes/Image.xml:577
+#: doc/classes/Image.xml:586
msgid ""
"Texture format that uses [url=https://www.khronos.org/opengl/wiki/"
"BPTC_Texture_Compression]BPTC[/url] compression with unsigned normalized "
@@ -24728,21 +25437,21 @@ msgid ""
"conversion is performed."
msgstr ""
-#: doc/classes/Image.xml:581
+#: doc/classes/Image.xml:590
msgid ""
"Texture format that uses [url=https://www.khronos.org/opengl/wiki/"
"BPTC_Texture_Compression]BPTC[/url] compression with signed floating-point "
"RGB components."
msgstr ""
-#: doc/classes/Image.xml:584
+#: doc/classes/Image.xml:593
msgid ""
"Texture format that uses [url=https://www.khronos.org/opengl/wiki/"
"BPTC_Texture_Compression]BPTC[/url] compression with unsigned floating-point "
"RGB components."
msgstr ""
-#: doc/classes/Image.xml:587
+#: doc/classes/Image.xml:596
msgid ""
"Texture format used on PowerVR-supported mobile platforms, uses 2-bit color "
"depth with no alpha. More information can be found [url=https://en.wikipedia."
@@ -24751,25 +25460,25 @@ msgid ""
"conversion is performed."
msgstr ""
-#: doc/classes/Image.xml:591
+#: doc/classes/Image.xml:600
msgid ""
"Same as [url=https://en.wikipedia.org/wiki/PVRTC]PVRTC2[/url], but with an "
"alpha component."
msgstr ""
-#: doc/classes/Image.xml:594
+#: doc/classes/Image.xml:603
msgid ""
"Similar to [url=https://en.wikipedia.org/wiki/PVRTC]PVRTC2[/url], but with 4-"
"bit color depth and no alpha."
msgstr ""
-#: doc/classes/Image.xml:597
+#: doc/classes/Image.xml:606
msgid ""
"Same as [url=https://en.wikipedia.org/wiki/PVRTC]PVRTC4[/url], but with an "
"alpha component."
msgstr ""
-#: doc/classes/Image.xml:600
+#: doc/classes/Image.xml:609
msgid ""
"[url=https://en.wikipedia.org/wiki/"
"Ericsson_Texture_Compression#ETC1]Ericsson Texture Compression format 1[/"
@@ -24777,7 +25486,7 @@ msgid ""
"standard. This format cannot store an alpha channel."
msgstr ""
-#: doc/classes/Image.xml:603
+#: doc/classes/Image.xml:612
msgid ""
"[url=https://en.wikipedia.org/wiki/"
"Ericsson_Texture_Compression#ETC2_and_EAC]Ericsson Texture Compression "
@@ -24785,7 +25494,7 @@ msgid ""
"unsigned data."
msgstr ""
-#: doc/classes/Image.xml:606
+#: doc/classes/Image.xml:615
msgid ""
"[url=https://en.wikipedia.org/wiki/"
"Ericsson_Texture_Compression#ETC2_and_EAC]Ericsson Texture Compression "
@@ -24793,7 +25502,7 @@ msgid ""
"channel of signed data."
msgstr ""
-#: doc/classes/Image.xml:609
+#: doc/classes/Image.xml:618
msgid ""
"[url=https://en.wikipedia.org/wiki/"
"Ericsson_Texture_Compression#ETC2_and_EAC]Ericsson Texture Compression "
@@ -24801,7 +25510,7 @@ msgid ""
"of unsigned data."
msgstr ""
-#: doc/classes/Image.xml:612
+#: doc/classes/Image.xml:621
msgid ""
"[url=https://en.wikipedia.org/wiki/"
"Ericsson_Texture_Compression#ETC2_and_EAC]Ericsson Texture Compression "
@@ -24809,7 +25518,7 @@ msgid ""
"channels of signed data."
msgstr ""
-#: doc/classes/Image.xml:615
+#: doc/classes/Image.xml:624
msgid ""
"[url=https://en.wikipedia.org/wiki/"
"Ericsson_Texture_Compression#ETC2_and_EAC]Ericsson Texture Compression "
@@ -24819,7 +25528,7 @@ msgid ""
"conversion is performed."
msgstr ""
-#: doc/classes/Image.xml:619
+#: doc/classes/Image.xml:628
msgid ""
"[url=https://en.wikipedia.org/wiki/"
"Ericsson_Texture_Compression#ETC2_and_EAC]Ericsson Texture Compression "
@@ -24829,7 +25538,7 @@ msgid ""
"conversion is performed."
msgstr ""
-#: doc/classes/Image.xml:623
+#: doc/classes/Image.xml:632
msgid ""
"[url=https://en.wikipedia.org/wiki/"
"Ericsson_Texture_Compression#ETC2_and_EAC]Ericsson Texture Compression "
@@ -24840,31 +25549,31 @@ msgid ""
"conversion is performed."
msgstr ""
-#: doc/classes/Image.xml:631
+#: doc/classes/Image.xml:640
msgid "Represents the size of the [enum Format] enum."
msgstr ""
-#: doc/classes/Image.xml:634
+#: doc/classes/Image.xml:643
msgid ""
"Performs nearest-neighbor interpolation. If the image is resized, it will be "
"pixelated."
msgstr ""
-#: doc/classes/Image.xml:637
+#: doc/classes/Image.xml:646
msgid ""
"Performs bilinear interpolation. If the image is resized, it will be blurry. "
"This mode is faster than [constant INTERPOLATE_CUBIC], but it results in "
"lower quality."
msgstr ""
-#: doc/classes/Image.xml:640
+#: doc/classes/Image.xml:649
msgid ""
"Performs cubic interpolation. If the image is resized, it will be blurry. "
"This mode often gives better results compared to [constant "
"INTERPOLATE_BILINEAR], at the cost of being slower."
msgstr ""
-#: doc/classes/Image.xml:643
+#: doc/classes/Image.xml:652
msgid ""
"Performs bilinear separately on the two most-suited mipmap levels, then "
"linearly interpolates between them.\n"
@@ -24879,55 +25588,55 @@ msgid ""
"a new set will be generated for the resulting image."
msgstr ""
-#: doc/classes/Image.xml:650
+#: doc/classes/Image.xml:659
msgid ""
"Performs Lanczos interpolation. This is the slowest image resizing mode, but "
"it typically gives the best results, especially when downscalng images."
msgstr ""
-#: doc/classes/Image.xml:653
+#: doc/classes/Image.xml:662
msgid "Image does not have alpha."
msgstr ""
-#: doc/classes/Image.xml:656
+#: doc/classes/Image.xml:665
msgid "Image stores alpha in a single bit."
msgstr ""
-#: doc/classes/Image.xml:659
+#: doc/classes/Image.xml:668
msgid "Image uses alpha."
msgstr ""
-#: doc/classes/Image.xml:662
+#: doc/classes/Image.xml:671
msgid "Use S3TC compression."
msgstr ""
-#: doc/classes/Image.xml:665
+#: doc/classes/Image.xml:674
msgid "Use PVRTC2 compression."
msgstr ""
-#: doc/classes/Image.xml:668
+#: doc/classes/Image.xml:677
msgid "Use PVRTC4 compression."
msgstr ""
-#: doc/classes/Image.xml:671
+#: doc/classes/Image.xml:680
msgid "Use ETC compression."
msgstr ""
-#: doc/classes/Image.xml:674
+#: doc/classes/Image.xml:683
msgid "Use ETC2 compression."
msgstr ""
-#: doc/classes/Image.xml:689
+#: doc/classes/Image.xml:698
msgid ""
"Source texture (before compression) is a regular texture. Default for all "
"textures."
msgstr ""
-#: doc/classes/Image.xml:692
+#: doc/classes/Image.xml:701
msgid "Source texture (before compression) is in sRGB space."
msgstr ""
-#: doc/classes/Image.xml:695
+#: doc/classes/Image.xml:704
msgid ""
"Source texture (before compression) is a normal texture (e.g. it can be "
"compressed into two channels)."
@@ -25746,7 +26455,7 @@ msgid "Contains mouse click information. See [method Node._input]."
msgstr ""
#: doc/classes/InputEventMouseButton.xml:10
-#: doc/classes/InputEventMouseMotion.xml:10
+#: doc/classes/InputEventMouseMotion.xml:11
msgid ""
"https://docs.godotengine.org/en/latest/tutorials/inputs/"
"mouse_and_input_coordinates.html"
@@ -25783,29 +26492,36 @@ msgstr ""
#: doc/classes/InputEventMouseMotion.xml:7
msgid ""
"Contains mouse and pen motion information. Supports relative, absolute "
-"positions and speed. See [method Node._input]."
+"positions and speed. See [method Node._input].\n"
+"[b]Note:[/b] By default, this event is only emitted once per frame rendered "
+"at most. If you need more precise input reporting, call [method Input."
+"set_use_accumulated_input] with [code]false[/code] to make events emitted as "
+"often as possible. If you use InputEventMouseMotion to draw lines, consider "
+"implementing [url=https://en.wikipedia.org/wiki/Bresenham"
+"%27s_line_algorithm]Bresenham's line algorithm[/url] as well to avoid "
+"visible gaps in lines if the user is moving the mouse quickly."
msgstr ""
-#: doc/classes/InputEventMouseMotion.xml:16
+#: doc/classes/InputEventMouseMotion.xml:17
msgid ""
"Represents the pressure the user puts on the pen. Ranges from [code]0.0[/"
"code] to [code]1.0[/code]."
msgstr ""
-#: doc/classes/InputEventMouseMotion.xml:19
+#: doc/classes/InputEventMouseMotion.xml:20
msgid ""
"The mouse position relative to the previous position (position at the last "
-"frame). \n"
+"frame).\n"
"[b]Note:[/b] Since [InputEventMouseMotion] is only emitted when the mouse "
"moves, the last event won't have a relative position of [code]Vector2(0, 0)[/"
"code] when the user stops moving the mouse."
msgstr ""
-#: doc/classes/InputEventMouseMotion.xml:23
+#: doc/classes/InputEventMouseMotion.xml:24
msgid "The mouse speed in pixels per second."
msgstr ""
-#: doc/classes/InputEventMouseMotion.xml:26
+#: doc/classes/InputEventMouseMotion.xml:27
msgid ""
"Represents the angles of tilt of the pen. Positive X-coordinate value "
"indicates a tilt to the right. Positive Y-coordinate value indicates a tilt "
@@ -26695,14 +27411,17 @@ msgstr ""
#: doc/classes/JSON.xml:18
msgid ""
-"Parses a JSON encoded string and returns a [JSONParseResult] containing the "
+"Parses a JSON-encoded string and returns a [JSONParseResult] containing the "
"result."
msgstr ""
#: doc/classes/JSON.xml:31
msgid ""
"Converts a [Variant] var to JSON text and returns the result. Useful for "
-"serializing data to store or send over the network."
+"serializing data to store or send over the network.\n"
+"[b]Note:[/b] The JSON specification does not define integer or float types, "
+"but only a [i]number[/i] type. Therefore, converting a Variant to JSON text "
+"will convert all numerical values to [float] types."
msgstr ""
#: doc/classes/JSONParseResult.xml:4
@@ -26725,14 +27444,14 @@ msgstr ""
#: doc/classes/JSONParseResult.xml:18
msgid ""
-"The line number where the error occurred if JSON source was not successfully "
-"parsed."
+"The line number where the error occurred if the JSON source was not "
+"successfully parsed."
msgstr ""
#: doc/classes/JSONParseResult.xml:21
msgid ""
-"The error message if JSON source was not successfully parsed. See the [enum "
-"Error] constants."
+"The error message if the JSON source was not successfully parsed. See the "
+"[enum Error] constants."
msgstr ""
#: doc/classes/JSONParseResult.xml:24
@@ -26740,11 +27459,11 @@ msgid ""
"A [Variant] containing the parsed JSON. Use [method @GDScript.typeof] or the "
"[code]is[/code] keyword to check if it is what you expect. For example, if "
"the JSON source starts with curly braces ([code]{}[/code]), a [Dictionary] "
-"will be returned. If the JSON source starts with braces ([code][][/code]), "
+"will be returned. If the JSON source starts with brackets ([code][][/code]), "
"an [Array] will be returned.\n"
"[b]Note:[/b] The JSON specification does not define integer or float types, "
-"but only a number type. Therefore, parsing a JSON text will convert all "
-"numerical values to float types.\n"
+"but only a [i]number[/i] type. Therefore, parsing a JSON text will convert "
+"all numerical values to [float] types.\n"
"[b]Note:[/b] JSON objects do not preserve key order like Godot dictionaries, "
"thus, you should not rely on keys being in a certain order if a dictionary "
"is constructed from JSON. In contrast, JSON arrays retain the order of their "
@@ -26754,13 +27473,13 @@ msgid ""
"if typeof(p.result) == TYPE_ARRAY:\n"
" print(p.result[0]) # Prints \"hello\"\n"
"else:\n"
-" print(\"unexpected results\")\n"
+" push_error(\"Unexpected results.\")\n"
"[/codeblock]"
msgstr ""
#: doc/classes/KinematicBody2D.xml:4
msgid "Kinematic body 2D node."
-msgstr ""
+msgstr "2D运动体节点。"
#: doc/classes/KinematicBody2D.xml:7
msgid ""
@@ -26870,7 +27589,7 @@ msgid ""
"simulation will run at an incorrect speed.\n"
"[code]linear_velocity[/code] is the velocity vector in pixels per second. "
"Unlike in [method move_and_collide], you should [i]not[/i] multiply it by "
-"[code]delta[/code] — the physics engine handles applying the velocity. \n"
+"[code]delta[/code] — the physics engine handles applying the velocity.\n"
"[code]up_direction[/code] is the up direction, used to determine what is a "
"wall and what is a floor or a ceiling. If set to the default value of "
"[code]Vector2(0, 0)[/code], everything is considered a wall. This is useful "
@@ -26926,7 +27645,7 @@ msgstr ""
#: doc/classes/KinematicBody3D.xml:4
msgid "Kinematic body 3D node."
-msgstr ""
+msgstr "3D运动体节点。"
#: doc/classes/KinematicBody3D.xml:7
msgid ""
@@ -26986,7 +27705,7 @@ msgid ""
"[code]linear_velocity[/code] is the velocity vector (typically meters per "
"second). Unlike in [method move_and_collide], you should [i]not[/i] multiply "
"it by [code]delta[/code] — the physics engine handles applying the "
-"velocity. \n"
+"velocity.\n"
"[code]up_direction[/code] is the up direction, used to determine what is a "
"wall and what is a floor or a ceiling. If set to the default value of "
"[code]Vector3(0, 0, 0)[/code], everything is considered a wall.\n"
@@ -27715,17 +28434,6 @@ msgid ""
"[b]Note:[/b] Hiding a light does [i]not[/i] affect baking."
msgstr ""
-#: doc/classes/Light3D.xml:152
-msgid "Only indirect lighting will be baked (default)."
-msgstr ""
-
-#: doc/classes/Light3D.xml:155
-msgid ""
-"Both direct and indirect light will be baked.\n"
-"[b]Note:[/b] You should hide the light if you don't want it to appear twice "
-"(dynamic and baked)."
-msgstr ""
-
#: doc/classes/LightOccluder2D.xml:4
msgid "Occludes light cast by a Light2D, casting shadows."
msgstr ""
@@ -28004,136 +28712,142 @@ msgstr ""
msgid "Text alignment as defined in the [enum Align] enum."
msgstr ""
-#: doc/classes/LineEdit.xml:120 doc/classes/TextEdit.xml:406
+#: doc/classes/LineEdit.xml:120 doc/classes/TextEdit.xml:358
msgid "If [code]true[/code], the caret (visual cursor) blinks."
msgstr ""
-#: doc/classes/LineEdit.xml:123 doc/classes/TextEdit.xml:409
+#: doc/classes/LineEdit.xml:123 doc/classes/TextEdit.xml:361
msgid "Duration (in seconds) of a caret's blinking cycle."
msgstr ""
-#: doc/classes/LineEdit.xml:126
+#: doc/classes/LineEdit.xml:128
msgid ""
"The cursor's position inside the [LineEdit]. When set, the text may scroll "
"to accommodate it."
msgstr ""
-#: doc/classes/LineEdit.xml:129
+#: doc/classes/LineEdit.xml:131
msgid ""
"If [code]true[/code], the [LineEdit] will show a clear button if [code]text[/"
"code] is not empty, which can be used to clear the text quickly."
msgstr ""
-#: doc/classes/LineEdit.xml:132
+#: doc/classes/LineEdit.xml:134
msgid "If [code]true[/code], the context menu will appear when right-clicked."
msgstr ""
-#: doc/classes/LineEdit.xml:135
+#: doc/classes/LineEdit.xml:137
msgid ""
"If [code]false[/code], existing text cannot be modified and new text cannot "
"be added."
msgstr ""
-#: doc/classes/LineEdit.xml:138
+#: doc/classes/LineEdit.xml:140
msgid ""
"If [code]true[/code], the [LineEdit] width will increase to stay longer than "
"the [member text]. It will [b]not[/b] compress if the [member text] is "
"shortened."
msgstr ""
-#: doc/classes/LineEdit.xml:142
+#: doc/classes/LineEdit.xml:144
msgid ""
"Maximum amount of characters that can be entered inside the [LineEdit]. If "
"[code]0[/code], there is no limit."
msgstr ""
-#: doc/classes/LineEdit.xml:146
+#: doc/classes/LineEdit.xml:148
msgid ""
"Opacity of the [member placeholder_text]. From [code]0[/code] to [code]1[/"
"code]."
msgstr ""
-#: doc/classes/LineEdit.xml:149
+#: doc/classes/LineEdit.xml:151
msgid ""
"Text shown when the [LineEdit] is empty. It is [b]not[/b] the [LineEdit]'s "
"default value (see [member text])."
msgstr ""
-#: doc/classes/LineEdit.xml:152
+#: doc/classes/LineEdit.xml:154
msgid ""
"Sets the icon that will appear in the right end of the [LineEdit] if there's "
"no [member text], or always, if [member clear_button_enabled] is set to "
"[code]false[/code]."
msgstr ""
-#: doc/classes/LineEdit.xml:155
+#: doc/classes/LineEdit.xml:157
msgid ""
"If [code]true[/code], every character is replaced with the secret character "
"(see [member secret_character])."
msgstr ""
-#: doc/classes/LineEdit.xml:158
+#: doc/classes/LineEdit.xml:160
msgid ""
"The character to use to mask secret input (defaults to \"*\"). Only a single "
"character can be used as the secret character."
msgstr ""
-#: doc/classes/LineEdit.xml:161
+#: doc/classes/LineEdit.xml:163
msgid ""
"If [code]false[/code], it's impossible to select the text using mouse nor "
"keyboard."
msgstr ""
-#: doc/classes/LineEdit.xml:164
+#: doc/classes/LineEdit.xml:166
msgid "If [code]false[/code], using shortcuts will be disabled."
msgstr ""
-#: doc/classes/LineEdit.xml:167
+#: doc/classes/LineEdit.xml:169
msgid ""
"String value of the [LineEdit].\n"
"[b]Note:[/b] Changing text using this property won't emit the [signal "
"text_changed] signal."
msgstr ""
-#: doc/classes/LineEdit.xml:174
+#: doc/classes/LineEdit.xml:173 doc/classes/TextEdit.xml:434
+msgid ""
+"If [code]true[/code], the native virtual keyboard is shown when focused on "
+"platforms that support it."
+msgstr ""
+
+#: doc/classes/LineEdit.xml:179
msgid ""
"Emitted when trying to append text that would overflow the [member "
"max_length]."
msgstr ""
-#: doc/classes/LineEdit.xml:181 doc/classes/TextEdit.xml:525
+#: doc/classes/LineEdit.xml:186 doc/classes/TextEdit.xml:490
msgid "Emitted when the text changes."
msgstr ""
-#: doc/classes/LineEdit.xml:188
+#: doc/classes/LineEdit.xml:193
msgid "Emitted when the user presses [constant KEY_ENTER] on the [LineEdit]."
msgstr ""
-#: doc/classes/LineEdit.xml:194
+#: doc/classes/LineEdit.xml:199
msgid "Aligns the text on the left-hand side of the [LineEdit]."
msgstr ""
-#: doc/classes/LineEdit.xml:197
+#: doc/classes/LineEdit.xml:202
msgid "Centers the text in the middle of the [LineEdit]."
msgstr ""
-#: doc/classes/LineEdit.xml:200
+#: doc/classes/LineEdit.xml:205
msgid "Aligns the text on the right-hand side of the [LineEdit]."
msgstr ""
-#: doc/classes/LineEdit.xml:203
+#: doc/classes/LineEdit.xml:208
msgid "Stretches whitespaces to fit the [LineEdit]'s width."
msgstr ""
-#: doc/classes/LineEdit.xml:206 doc/classes/TextEdit.xml:540
+#: doc/classes/LineEdit.xml:211 doc/classes/TextEdit.xml:505
msgid "Cuts (copies and clears) the selected text."
msgstr ""
-#: doc/classes/LineEdit.xml:209 doc/classes/TextEdit.xml:543
+#: doc/classes/LineEdit.xml:214 doc/classes/TextEdit.xml:508
msgid "Copies the selected text."
msgstr ""
-#: doc/classes/LineEdit.xml:212
+#: doc/classes/LineEdit.xml:217
msgid ""
"Pastes the clipboard text over the selected text (or at the cursor's "
"position).\n"
@@ -28141,80 +28855,80 @@ msgid ""
"clipboard via [method String.strip_escapes]."
msgstr ""
-#: doc/classes/LineEdit.xml:216
+#: doc/classes/LineEdit.xml:221
msgid "Erases the whole [LineEdit] text."
msgstr ""
-#: doc/classes/LineEdit.xml:219
+#: doc/classes/LineEdit.xml:224
msgid "Selects the whole [LineEdit] text."
msgstr ""
-#: doc/classes/LineEdit.xml:222 doc/classes/TextEdit.xml:555
+#: doc/classes/LineEdit.xml:227 doc/classes/TextEdit.xml:520
msgid "Undoes the previous action."
msgstr ""
-#: doc/classes/LineEdit.xml:225
+#: doc/classes/LineEdit.xml:230
msgid "Reverse the last undo action."
msgstr ""
-#: doc/classes/LineEdit.xml:228 doc/classes/TextEdit.xml:561
+#: doc/classes/LineEdit.xml:233 doc/classes/TextEdit.xml:526
msgid "Represents the size of the [enum MenuItems] enum."
msgstr ""
-#: doc/classes/LineEdit.xml:233
+#: doc/classes/LineEdit.xml:238
msgid "Texture for the clear button. See [member clear_button_enabled]."
msgstr ""
-#: doc/classes/LineEdit.xml:236
+#: doc/classes/LineEdit.xml:241
msgid "Color used as default tint for the clear button."
msgstr ""
-#: doc/classes/LineEdit.xml:239
+#: doc/classes/LineEdit.xml:244
msgid "Color used for the clear button when it's pressed."
msgstr ""
-#: doc/classes/LineEdit.xml:242
+#: doc/classes/LineEdit.xml:247
msgid "Color of the [LineEdit]'s visual cursor (caret)."
msgstr ""
-#: doc/classes/LineEdit.xml:245
+#: doc/classes/LineEdit.xml:250
msgid "Background used when [LineEdit] has GUI focus."
msgstr ""
-#: doc/classes/LineEdit.xml:248
+#: doc/classes/LineEdit.xml:253
msgid "Font used for the text."
msgstr ""
-#: doc/classes/LineEdit.xml:251
+#: doc/classes/LineEdit.xml:256
msgid "Default font color."
msgstr ""
-#: doc/classes/LineEdit.xml:254
+#: doc/classes/LineEdit.xml:259
msgid "Font color for selected text (inside the selection rectangle)."
msgstr ""
-#: doc/classes/LineEdit.xml:257
+#: doc/classes/LineEdit.xml:262
msgid "Font color when editing is disabled."
msgstr ""
-#: doc/classes/LineEdit.xml:260
+#: doc/classes/LineEdit.xml:265
msgid ""
"Minimum horizontal space for the text (not counting the clear button and "
"content margins). This value is measured in count of space characters (i.e. "
"this amount of space characters can be displayed without scrolling)."
msgstr ""
-#: doc/classes/LineEdit.xml:263
+#: doc/classes/LineEdit.xml:268
msgid "Default background for the [LineEdit]."
msgstr ""
-#: doc/classes/LineEdit.xml:266
+#: doc/classes/LineEdit.xml:271
msgid ""
"Background used when [LineEdit] is in read-only mode ([member editable] is "
"set to [code]false[/code])."
msgstr ""
-#: doc/classes/LineEdit.xml:269
+#: doc/classes/LineEdit.xml:274
msgid "Color of the selection rectangle."
msgstr ""
@@ -28432,14 +29146,14 @@ msgstr ""
msgid "Emitted when a user responds to a permission request."
msgstr ""
-#: doc/classes/MainLoop.xml:127 doc/classes/Node.xml:948
+#: doc/classes/MainLoop.xml:127 doc/classes/Node.xml:946
msgid ""
"Notification received from the OS when the application is exceeding its "
"allocated memory.\n"
"Specific to the iOS platform."
msgstr ""
-#: doc/classes/MainLoop.xml:131 doc/classes/Node.xml:952
+#: doc/classes/MainLoop.xml:131 doc/classes/Node.xml:950
msgid ""
"Notification received when translations may have changed. Can be triggered "
"by the user changing the locale. Can be used to respond to language changes, "
@@ -28447,39 +29161,55 @@ msgid ""
"the built-in translation support, like [method Object.tr]."
msgstr ""
-#: doc/classes/MainLoop.xml:134 doc/classes/Node.xml:955
+#: doc/classes/MainLoop.xml:134 doc/classes/Node.xml:953
msgid ""
"Notification received from the OS when a request for \"About\" information "
"is sent.\n"
"Specific to the macOS platform."
msgstr ""
-#: doc/classes/MainLoop.xml:138 doc/classes/Node.xml:959
+#: doc/classes/MainLoop.xml:138 doc/classes/Node.xml:957
msgid ""
"Notification received from Godot's crash handler when the engine is about to "
"crash.\n"
"Implemented on desktop platforms if the crash handler is enabled."
msgstr ""
-#: doc/classes/MainLoop.xml:142 doc/classes/Node.xml:963
+#: doc/classes/MainLoop.xml:142 doc/classes/Node.xml:961
msgid ""
"Notification received from the OS when an update of the Input Method Engine "
"occurs (e.g. change of IME cursor position or composition string).\n"
"Specific to the macOS platform."
msgstr ""
-#: doc/classes/MainLoop.xml:146 doc/classes/Node.xml:967
+#: doc/classes/MainLoop.xml:146 doc/classes/Node.xml:965
msgid ""
-"Notification received from the OS when the app is resumed.\n"
+"Notification received from the OS when the application is resumed.\n"
"Specific to the Android platform."
msgstr ""
-#: doc/classes/MainLoop.xml:150 doc/classes/Node.xml:971
+#: doc/classes/MainLoop.xml:150 doc/classes/Node.xml:969
msgid ""
-"Notification received from the OS when the app is paused.\n"
+"Notification received from the OS when the application is paused.\n"
"Specific to the Android platform."
msgstr ""
+#: doc/classes/MainLoop.xml:154 doc/classes/Node.xml:973
+msgid ""
+"Notification received from the OS when the application is focused, i.e. when "
+"changing the focus from the OS desktop or a thirdparty application to any "
+"open window of the Godot instance.\n"
+"Implemented on desktop platforms."
+msgstr ""
+
+#: doc/classes/MainLoop.xml:158 doc/classes/Node.xml:977
+msgid ""
+"Notification received from the OS when the application is defocused, i.e. "
+"when changing the focus from any open window of the Godot instance to the OS "
+"desktop or a thirdparty application.\n"
+"Implemented on desktop platforms."
+msgstr ""
+
#: doc/classes/MarginContainer.xml:4
msgid "Simple margin container."
msgstr ""
@@ -28787,11 +29517,11 @@ msgstr ""
msgid "Render array as triangle strips."
msgstr ""
-#: doc/classes/Mesh.xml:126 doc/classes/RenderingServer.xml:3189
+#: doc/classes/Mesh.xml:126 doc/classes/RenderingServer.xml:3185
msgid "Blend shapes are normalized."
msgstr ""
-#: doc/classes/Mesh.xml:129 doc/classes/RenderingServer.xml:3192
+#: doc/classes/Mesh.xml:129 doc/classes/RenderingServer.xml:3188
msgid "Blend shapes are relative to base weight."
msgstr ""
@@ -28833,37 +29563,37 @@ msgstr ""
msgid "Mesh array uses indices."
msgstr ""
-#: doc/classes/Mesh.xml:159 doc/classes/RenderingServer.xml:3145
+#: doc/classes/Mesh.xml:159 doc/classes/RenderingServer.xml:3141
msgid "Flag used to mark a compressed (half float) normal array."
msgstr ""
-#: doc/classes/Mesh.xml:162 doc/classes/RenderingServer.xml:3148
+#: doc/classes/Mesh.xml:162 doc/classes/RenderingServer.xml:3144
msgid "Flag used to mark a compressed (half float) tangent array."
msgstr ""
-#: doc/classes/Mesh.xml:165 doc/classes/RenderingServer.xml:3151
+#: doc/classes/Mesh.xml:165 doc/classes/RenderingServer.xml:3147
msgid "Flag used to mark a compressed (half float) color array."
msgstr ""
-#: doc/classes/Mesh.xml:168 doc/classes/RenderingServer.xml:3154
+#: doc/classes/Mesh.xml:168 doc/classes/RenderingServer.xml:3150
msgid "Flag used to mark a compressed (half float) UV coordinates array."
msgstr ""
-#: doc/classes/Mesh.xml:171 doc/classes/RenderingServer.xml:3157
+#: doc/classes/Mesh.xml:171 doc/classes/RenderingServer.xml:3153
msgid ""
"Flag used to mark a compressed (half float) UV coordinates array for the "
"second UV coordinates."
msgstr ""
-#: doc/classes/Mesh.xml:174 doc/classes/RenderingServer.xml:3160
+#: doc/classes/Mesh.xml:174 doc/classes/RenderingServer.xml:3156
msgid "Flag used to mark a compressed index array."
msgstr ""
-#: doc/classes/Mesh.xml:177 doc/classes/RenderingServer.xml:3166
+#: doc/classes/Mesh.xml:177 doc/classes/RenderingServer.xml:3162
msgid "Flag used to mark that the array contains 2D vertices."
msgstr ""
-#: doc/classes/Mesh.xml:180 doc/classes/RenderingServer.xml:3163
+#: doc/classes/Mesh.xml:180 doc/classes/RenderingServer.xml:3159
msgid ""
"Used to set flags [constant ARRAY_COMPRESS_NORMAL], [constant "
"ARRAY_COMPRESS_TANGENT], [constant ARRAY_COMPRESS_COLOR], [constant "
@@ -30624,7 +31354,10 @@ msgstr ""
msgid ""
"The number of channels to be used by ENet. Channels are used to separate "
"different kinds of data. In reliable or ordered mode, for example, the "
-"packet delivery order is ensured on a per channel basis."
+"packet delivery order is ensured on a per-channel basis. This is done to "
+"combat latency and reduces ordering restrictions on packets. The delivery "
+"status of a packet in one channel won't stall the delivery of other packets "
+"in another channel."
msgstr ""
#: modules/enet/doc_classes/NetworkedMultiplayerENet.xml:134
@@ -30651,11 +31384,12 @@ msgstr ""
#: modules/enet/doc_classes/NetworkedMultiplayerENet.xml:144
msgid ""
"Set the default channel to be used to transfer data. By default, this value "
-"is [code]-1[/code] which means that ENet will only use 2 channels, one for "
-"reliable and one for unreliable packets. Channel [code]0[/code] is reserved, "
-"and cannot be used. Setting this member to any value between [code]0[/code] "
-"and [member channel_count] (excluded) will force ENet to use that channel "
-"for sending data."
+"is [code]-1[/code] which means that ENet will only use 2 channels: one for "
+"reliable packets, and one for unreliable packets. The channel [code]0[/code] "
+"is reserved and cannot be used. Setting this member to any value between "
+"[code]0[/code] and [member channel_count] (excluded) will force ENet to use "
+"that channel for sending data. See [member channel_count] for more "
+"information about ENet channels."
msgstr ""
#: modules/enet/doc_classes/NetworkedMultiplayerENet.xml:148
@@ -31847,57 +32581,63 @@ msgstr ""
#: doc/classes/Node.xml:930
msgid ""
-"Notification received from the OS when the game window is focused.\n"
-"Implemented on all platforms."
+"Notification received from the OS when the node's parent [Window] is "
+"focused. This may be a change of focus between two windows of the same "
+"engine instance, or from the OS desktop or a third-party application to a "
+"window of the game (in which case [constant "
+"NOTIFICATION_APPLICATION_FOCUS_IN] is also emitted)."
msgstr ""
-#: doc/classes/Node.xml:934
+#: doc/classes/Node.xml:933
msgid ""
-"Notification received from the OS when the game window is unfocused.\n"
-"Implemented on all platforms."
+"Notification received from the OS when the node's parent [Window] is "
+"defocused. This may be a change of focus between two windows of the same "
+"engine instance, or from a window of the game to the OS desktop or a third-"
+"party application (in which case [constant "
+"NOTIFICATION_APPLICATION_FOCUS_OUT] is also emitted)."
msgstr ""
-#: doc/classes/Node.xml:938
+#: doc/classes/Node.xml:936
msgid ""
"Notification received from the OS when a close request is sent (e.g. closing "
"the window with a \"Close\" button or [kbd]Alt + F4[/kbd]).\n"
"Implemented on desktop platforms."
msgstr ""
-#: doc/classes/Node.xml:942
+#: doc/classes/Node.xml:940
msgid ""
"Notification received from the OS when a go back request is sent (e.g. "
"pressing the \"Back\" button on Android).\n"
"Specific to the Android platform."
msgstr ""
-#: doc/classes/Node.xml:975
+#: doc/classes/Node.xml:981
msgid ""
"Inherits pause mode from the node's parent. For the root node, it is "
"equivalent to [constant PAUSE_MODE_STOP]. Default."
msgstr ""
-#: doc/classes/Node.xml:978
+#: doc/classes/Node.xml:984
msgid "Stops processing when the [SceneTree] is paused."
msgstr ""
-#: doc/classes/Node.xml:981
+#: doc/classes/Node.xml:987
msgid "Continue to process regardless of the [SceneTree] pause state."
msgstr ""
-#: doc/classes/Node.xml:984
+#: doc/classes/Node.xml:990
msgid "Duplicate the node's signals."
msgstr ""
-#: doc/classes/Node.xml:987
+#: doc/classes/Node.xml:993
msgid "Duplicate the node's groups."
msgstr ""
-#: doc/classes/Node.xml:990
+#: doc/classes/Node.xml:996
msgid "Duplicate the node's scripts."
msgstr ""
-#: doc/classes/Node.xml:993
+#: doc/classes/Node.xml:999
msgid ""
"Duplicate using instancing.\n"
"An instance stays linked to the original so when the original changes, the "
@@ -32006,7 +32746,7 @@ msgstr ""
#: doc/classes/Node2D.xml:134
msgid "Position, relative to the node's parent."
-msgstr ""
+msgstr "位置,相对于父节点的位置。"
#: doc/classes/Node2D.xml:137
msgid "Rotation in radians, relative to the node's parent."
@@ -32014,7 +32754,7 @@ msgstr ""
#: doc/classes/Node2D.xml:140
msgid "Rotation in degrees, relative to the node's parent."
-msgstr ""
+msgstr "旋转角度,相对于父节点的旋转角度。"
#: doc/classes/Node2D.xml:143
msgid "The node's scale. Unscaled value: [code](1, 1)[/code]."
@@ -32111,7 +32851,7 @@ msgstr ""
#: doc/classes/Node3D.xml:90
msgid ""
-"Returns whether this node is set as Toplevel, that is whether it ignores its "
+"Returns whether this node is set as top_level, that is whether it ignores its "
"parent nodes transformations."
msgstr ""
@@ -32121,12 +32861,6 @@ msgid ""
"changes. [Node3D] will not propagate this by default."
msgstr ""
-#: doc/classes/Node3D.xml:104
-msgid ""
-"Returns whether the node is visible, taking into consideration that its "
-"parents visibility."
-msgstr ""
-
#: doc/classes/Node3D.xml:115
msgid ""
"Rotates itself so that the local -Z axis points towards the [code]target[/"
@@ -32296,7 +33030,10 @@ msgid "Local translation of this node."
msgstr ""
#: doc/classes/Node3D.xml:326
-msgid "If [code]true[/code], this node is drawn."
+msgid ""
+"If [code]true[/code], this node is drawn. The node is only visible if all of "
+"its antecedents are visible as well (in other words, [method "
+"is_visible_in_tree] must return [code]true[/code])."
msgstr ""
#: doc/classes/Node3D.xml:332
@@ -32553,10 +33290,20 @@ msgid ""
"the key exists, even if the value is [code]null[/code].\n"
"Objects also receive notifications. Notifications are a simple way to notify "
"the object about different events, so they can all be handled together. See "
-"[method _notification]."
+"[method _notification].\n"
+"[b]Note:[/b] Unlike references to a [Reference], references to an Object "
+"stored in a variable can become invalid without warning. Therefore, it's "
+"recommended to use [Reference] for data classes instead of [Object]."
+msgstr ""
+
+#: doc/classes/Object.xml:23 doc/classes/Reference.xml:12
+#: doc/classes/Resource.xml:11
+msgid ""
+"https://docs.godotengine.org/en/latest/getting_started/workflow/"
+"best_practices/node_alternatives.html"
msgstr ""
-#: doc/classes/Object.xml:30
+#: doc/classes/Object.xml:32
msgid ""
"Virtual method which can be overridden to customize the return value of "
"[method get].\n"
@@ -32564,7 +33311,7 @@ msgid ""
"code] does not exist."
msgstr ""
-#: doc/classes/Object.xml:38
+#: doc/classes/Object.xml:40
msgid ""
"Virtual method which can be overridden to customize the return value of "
"[method get_property_list].\n"
@@ -32576,11 +33323,11 @@ msgid ""
"PropertyUsageFlags])."
msgstr ""
-#: doc/classes/Object.xml:47
+#: doc/classes/Object.xml:49
msgid "Called when the object is initialized."
msgstr ""
-#: doc/classes/Object.xml:56
+#: doc/classes/Object.xml:58
msgid ""
"Called whenever the object receives a notification, which is identified in "
"[code]what[/code] by a constant. The base [Object] has two constants "
@@ -32589,7 +33336,7 @@ msgid ""
"notifications which are also received by this method."
msgstr ""
-#: doc/classes/Object.xml:67
+#: doc/classes/Object.xml:69
msgid ""
"Virtual method which can be overridden to customize the return value of "
"[method set].\n"
@@ -32597,7 +33344,7 @@ msgid ""
"exists."
msgstr ""
-#: doc/classes/Object.xml:75
+#: doc/classes/Object.xml:77
msgid ""
"Virtual method which can be overridden to customize the return value of "
"[method to_string], and thus the object's representation where it is "
@@ -32606,34 +33353,42 @@ msgid ""
"[code]\"[ClassName:RID]\"[/code]."
msgstr ""
-#: doc/classes/Object.xml:87
+#: doc/classes/Object.xml:89
msgid ""
"Adds a user-defined [code]signal[/code]. Arguments are optional, but can be "
"added as an [Array] of dictionaries, each containing [code]name: String[/"
"code] and [code]type: int[/code] (see [enum Variant.Type]) entries."
msgstr ""
-#: doc/classes/Object.xml:96
+#: doc/classes/Object.xml:98
msgid ""
"Calls the [code]method[/code] on the object and returns the result. This "
"method supports a variable number of arguments, so parameters are passed as "
"a comma separated list. Example:\n"
"[codeblock]\n"
"call(\"set\", \"position\", Vector2(42.0, 0.0))\n"
-"[/codeblock]"
+"[/codeblock]\n"
+"[b]Note:[/b] In C#, the method name must be specified as snake_case if it is "
+"defined by a built-in Godot node. This doesn't apply to user-defined methods "
+"where you should use the same convention as in the C# source (typically "
+"PascalCase)."
msgstr ""
-#: doc/classes/Object.xml:108
+#: doc/classes/Object.xml:111
msgid ""
"Calls the [code]method[/code] on the object during idle time. This method "
"supports a variable number of arguments, so parameters are passed as a comma "
"separated list. Example:\n"
"[codeblock]\n"
"call_deferred(\"set\", \"position\", Vector2(42.0, 0.0))\n"
-"[/codeblock]"
+"[/codeblock]\n"
+"[b]Note:[/b] In C#, the method name must be specified as snake_case if it is "
+"defined by a built-in Godot node. This doesn't apply to user-defined methods "
+"where you should use the same convention as in the C# source (typically "
+"PascalCase)."
msgstr ""
-#: doc/classes/Object.xml:122
+#: doc/classes/Object.xml:126
msgid ""
"Calls the [code]method[/code] on the object and returns the result. "
"Contrarily to [method call], this method does not support a variable number "
@@ -32643,13 +33398,13 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/Object.xml:132
+#: doc/classes/Object.xml:136
msgid ""
"Returns [code]true[/code] if the object can translate strings. See [method "
"set_message_translation] and [method tr]."
msgstr ""
-#: doc/classes/Object.xml:147
+#: doc/classes/Object.xml:151
msgid ""
"[b]FIXME:[/b] The syntax changed with the addition of [Callable], this "
"should be updated.\n"
@@ -32685,7 +33440,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/Object.xml:174
+#: doc/classes/Object.xml:178
msgid ""
"[b]FIXME:[/b] The syntax changed with the addition of [Callable], this "
"should be updated.\n"
@@ -32696,7 +33451,7 @@ msgid ""
"exists."
msgstr ""
-#: doc/classes/Object.xml:185
+#: doc/classes/Object.xml:189
msgid ""
"Emits the given [code]signal[/code]. The signal must exist, so it should be "
"a built-in signal of this class or one of its parent classes, or a user-"
@@ -32708,24 +33463,28 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/Object.xml:196
+#: doc/classes/Object.xml:200
msgid ""
"Deletes the object from memory. Any pre-existing reference to the freed "
"object will become invalid, e.g. [code]is_instance_valid(object)[/code] will "
"return [code]false[/code]."
msgstr ""
-#: doc/classes/Object.xml:205
+#: doc/classes/Object.xml:209
msgid ""
"Returns the [Variant] value of the given [code]property[/code]. If the "
-"[code]property[/code] doesn't exist, this will return [code]null[/code]."
+"[code]property[/code] doesn't exist, this will return [code]null[/code].\n"
+"[b]Note:[/b] In C#, the property name must be specified as snake_case if it "
+"is defined by a built-in Godot node. This doesn't apply to user-defined "
+"properties where you should use the same convention as in the C# source "
+"(typically PascalCase)."
msgstr ""
-#: doc/classes/Object.xml:212
+#: doc/classes/Object.xml:217
msgid "Returns the object's class as a [String]."
msgstr ""
-#: doc/classes/Object.xml:219
+#: doc/classes/Object.xml:224
msgid ""
"Returns an [Array] of dictionaries with information about signals that are "
"connected to the object.\n"
@@ -32736,7 +33495,7 @@ msgid ""
"connected."
msgstr ""
-#: doc/classes/Object.xml:232
+#: doc/classes/Object.xml:237
msgid ""
"Gets the object's property indexed by the given [NodePath]. The node path "
"should be relative to the current object and can use the colon character "
@@ -32744,26 +33503,26 @@ msgid ""
"\"[/code] or [code]\"material:next_pass:blend_mode\"[/code]."
msgstr ""
-#: doc/classes/Object.xml:239
+#: doc/classes/Object.xml:244
msgid ""
"Returns the object's unique instance ID.\n"
"This ID can be saved in [EncodedObjectAsID], and can be used to retrieve the "
"object instance with [method @GDScript.instance_from_id]."
msgstr ""
-#: doc/classes/Object.xml:249
+#: doc/classes/Object.xml:254
msgid "Returns the object's metadata entry for the given [code]name[/code]."
msgstr ""
-#: doc/classes/Object.xml:256
+#: doc/classes/Object.xml:261
msgid "Returns the object's metadata as a [PackedStringArray]."
msgstr ""
-#: doc/classes/Object.xml:263
+#: doc/classes/Object.xml:268
msgid "Returns the object's methods and their signatures as an [Array]."
msgstr ""
-#: doc/classes/Object.xml:270
+#: doc/classes/Object.xml:275
msgid ""
"Returns the object's property list as an [Array] of dictionaries.\n"
"Each property's [Dictionary] contain at least [code]name: String[/code] and "
@@ -32773,54 +33532,54 @@ msgid ""
"PropertyUsageFlags])."
msgstr ""
-#: doc/classes/Object.xml:278
+#: doc/classes/Object.xml:283
msgid ""
"Returns the object's [Script] instance, or [code]null[/code] if none is "
"assigned."
msgstr ""
-#: doc/classes/Object.xml:287
+#: doc/classes/Object.xml:292
msgid "Returns an [Array] of connections for the given [code]signal[/code]."
msgstr ""
-#: doc/classes/Object.xml:294
+#: doc/classes/Object.xml:299
msgid "Returns the list of signals as an [Array] of dictionaries."
msgstr ""
-#: doc/classes/Object.xml:303
+#: doc/classes/Object.xml:308
msgid ""
"Returns [code]true[/code] if a metadata entry is found with the given "
"[code]name[/code]."
msgstr ""
-#: doc/classes/Object.xml:312
+#: doc/classes/Object.xml:317
msgid ""
"Returns [code]true[/code] if the object contains the given [code]method[/"
"code]."
msgstr ""
-#: doc/classes/Object.xml:321
+#: doc/classes/Object.xml:326
msgid "Returns [code]true[/code] if the given [code]signal[/code] exists."
msgstr ""
-#: doc/classes/Object.xml:330
+#: doc/classes/Object.xml:335
msgid ""
"Returns [code]true[/code] if the given user-defined [code]signal[/code] "
"exists. Only signals added using [method add_user_signal] are taken into "
"account."
msgstr ""
-#: doc/classes/Object.xml:337
+#: doc/classes/Object.xml:342
msgid "Returns [code]true[/code] if signal emission blocking is enabled."
msgstr ""
-#: doc/classes/Object.xml:346
+#: doc/classes/Object.xml:351
msgid ""
"Returns [code]true[/code] if the object inherits from the given [code]class[/"
"code]."
msgstr ""
-#: doc/classes/Object.xml:357
+#: doc/classes/Object.xml:362
msgid ""
"[b]FIXME:[/b] The syntax changed with the addition of [Callable], this "
"should be updated.\n"
@@ -32828,13 +33587,13 @@ msgid ""
"code], [code]target[/code], and [code]method[/code]."
msgstr ""
-#: doc/classes/Object.xml:365
+#: doc/classes/Object.xml:370
msgid ""
"Returns [code]true[/code] if the [method Node.queue_free] method was called "
"for the object."
msgstr ""
-#: doc/classes/Object.xml:376
+#: doc/classes/Object.xml:381
msgid ""
"Send a given notification to the object, which will also trigger a call to "
"the [method _notification] method of all classes that the object inherits "
@@ -32846,34 +33605,42 @@ msgid ""
"and then down to its successive inheriting classes."
msgstr ""
-#: doc/classes/Object.xml:384
+#: doc/classes/Object.xml:389
msgid ""
"Notify the editor that the property list has changed, so that editor plugins "
"can take the new values into account. Does nothing on export builds."
msgstr ""
-#: doc/classes/Object.xml:393
+#: doc/classes/Object.xml:398
msgid "Removes a given entry from the object's metadata."
msgstr ""
-#: doc/classes/Object.xml:404
+#: doc/classes/Object.xml:409
msgid ""
"Assigns a new value to the given property. If the [code]property[/code] does "
-"not exist, nothing will happen."
+"not exist, nothing will happen.\n"
+"[b]Note:[/b] In C#, the property name must be specified as snake_case if it "
+"is defined by a built-in Godot node. This doesn't apply to user-defined "
+"properties where you should use the same convention as in the C# source "
+"(typically PascalCase)."
msgstr ""
-#: doc/classes/Object.xml:413
+#: doc/classes/Object.xml:419
msgid "If set to [code]true[/code], signal emission is blocked."
msgstr ""
-#: doc/classes/Object.xml:424
+#: doc/classes/Object.xml:430
msgid ""
"Assigns a new value to the given property, after the current frame's physics "
"step. This is equivalent to calling [method set] via [method call_deferred], "
-"i.e. [code]call_deferred(\"set\", property, value)[/code]."
+"i.e. [code]call_deferred(\"set\", property, value)[/code].\n"
+"[b]Note:[/b] In C#, the property name must be specified as snake_case if it "
+"is defined by a built-in Godot node. This doesn't apply to user-defined "
+"properties where you should use the same convention as in the C# source "
+"(typically PascalCase)."
msgstr ""
-#: doc/classes/Object.xml:435
+#: doc/classes/Object.xml:442
msgid ""
"Assigns a new value to the property identified by the [NodePath]. The node "
"path should be relative to the current object and can use the colon "
@@ -32885,19 +33652,19 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/Object.xml:449
+#: doc/classes/Object.xml:456
msgid ""
"Defines whether the object can translate strings (with calls to [method "
"tr]). Enabled by default."
msgstr ""
-#: doc/classes/Object.xml:460
+#: doc/classes/Object.xml:467
msgid ""
"Adds or changes a given entry in the object's metadata. Metadata are "
"serialized, and can take any [Variant] value."
msgstr ""
-#: doc/classes/Object.xml:469
+#: doc/classes/Object.xml:476
msgid ""
"Assigns a script to the object. Each object can have a single script "
"assigned to it, which are used to extend its functionality.\n"
@@ -32906,7 +33673,7 @@ msgid ""
"_init] method will be called."
msgstr ""
-#: doc/classes/Object.xml:477
+#: doc/classes/Object.xml:484
msgid ""
"Returns a [String] representing the object. If not overridden, defaults to "
"[code]\"[ClassName:RID]\"[/code].\n"
@@ -32914,7 +33681,7 @@ msgid ""
"representation."
msgstr ""
-#: doc/classes/Object.xml:487
+#: doc/classes/Object.xml:494
msgid ""
"Translates a message using translation catalogs configured in the Project "
"Settings.\n"
@@ -32923,35 +33690,35 @@ msgid ""
"set_message_translation]."
msgstr ""
-#: doc/classes/Object.xml:495
+#: doc/classes/Object.xml:502
msgid "Emitted whenever the object's script is changed."
msgstr ""
-#: doc/classes/Object.xml:501
+#: doc/classes/Object.xml:508
msgid "Called right when the object is initialized. Not available in script."
msgstr ""
-#: doc/classes/Object.xml:504
+#: doc/classes/Object.xml:511
msgid "Called before the object is about to be deleted."
msgstr ""
-#: doc/classes/Object.xml:507
+#: doc/classes/Object.xml:514
msgid ""
"Connects a signal in deferred mode. This way, signal emissions are stored in "
"a queue, then set on idle time."
msgstr ""
-#: doc/classes/Object.xml:510
+#: doc/classes/Object.xml:517
msgid "Persisting connections are saved when the object is serialized to file."
msgstr ""
-#: doc/classes/Object.xml:513
+#: doc/classes/Object.xml:520
msgid "One-shot connections disconnect themselves after emission."
msgstr ""
-#: doc/classes/Object.xml:516
+#: doc/classes/Object.xml:523
msgid ""
-"Connect a signal as reference counted. This means that a given signal can be "
+"Connect a signal as reference-counted. This means that a given signal can be "
"connected several times to the same target, and will only be fully "
"disconnected once no references are left."
msgstr ""
@@ -33416,10 +34183,29 @@ msgid "Returns the keycode of the given string (e.g. \"Escape\")."
msgstr ""
#: doc/classes/OS.xml:115
-msgid "Returns the command line arguments passed to the engine."
+msgid ""
+"Returns the command-line arguments passed to the engine.\n"
+"Command-line arguments can be written in any form, including both [code]--"
+"key value[/code] and [code]--key=value[/code] forms so they can be properly "
+"parsed, as long as custom command-line arguments do not conflict with engine "
+"arguments.\n"
+"You can also incorporate environment variables using the [method "
+"get_environment] method.\n"
+"You can set [code]editor/main_run_args[/code] in the Project Settings to "
+"define command-line arguments to be passed by the editor when running the "
+"project.\n"
+"Here's a minimal example on how to parse command-line arguments into a "
+"dictionary using the [code]--key=value[/code] form for arguments:\n"
+"[codeblock]\n"
+"var arguments = {}\n"
+"for argument in OS.get_cmdline_args():\n"
+" if argument.find(\"=\") > -1:\n"
+" var key_value = argument.split(\"=\")\n"
+" arguments[key_value[0].lstrip(\"--\")] = key_value[1]\n"
+"[/codeblock]"
msgstr ""
-#: doc/classes/OS.xml:122
+#: doc/classes/OS.xml:133
msgid ""
"Returns an array of MIDI device names.\n"
"The returned array will be empty if the system MIDI driver has not "
@@ -33427,14 +34213,14 @@ msgid ""
"[b]Note:[/b] This method is implemented on Linux, macOS and Windows."
msgstr ""
-#: doc/classes/OS.xml:133
+#: doc/classes/OS.xml:144
msgid ""
"Returns current date as a dictionary of keys: [code]year[/code], "
"[code]month[/code], [code]day[/code], [code]weekday[/code], [code]dst[/code] "
"(Daylight Savings Time)."
msgstr ""
-#: doc/classes/OS.xml:142
+#: doc/classes/OS.xml:153
msgid ""
"Returns current datetime as a dictionary of keys: [code]year[/code], "
"[code]month[/code], [code]day[/code], [code]weekday[/code], [code]dst[/code] "
@@ -33442,7 +34228,7 @@ msgid ""
"[code]second[/code]."
msgstr ""
-#: doc/classes/OS.xml:151
+#: doc/classes/OS.xml:162
msgid ""
"Gets a dictionary of time values corresponding to the given UNIX epoch time "
"(in seconds).\n"
@@ -33451,22 +34237,22 @@ msgid ""
"the epoch."
msgstr ""
-#: doc/classes/OS.xml:161
+#: doc/classes/OS.xml:172
msgid "Returns an environment variable."
msgstr ""
-#: doc/classes/OS.xml:168
+#: doc/classes/OS.xml:179
msgid "Returns the path to the current engine executable."
msgstr ""
-#: doc/classes/OS.xml:175
+#: doc/classes/OS.xml:186
msgid ""
"With this function you can get the list of dangerous permissions that have "
"been granted to the Android application.\n"
"[b]Note:[/b] This method is implemented on Android."
msgstr ""
-#: doc/classes/OS.xml:185
+#: doc/classes/OS.xml:196
msgid ""
"Returns the given keycode as a string (e.g. Return values: [code]\"Escape\"[/"
"code], [code]\"Shift+Escape\"[/code]).\n"
@@ -33474,18 +34260,18 @@ msgid ""
"get_keycode_with_modifiers]."
msgstr ""
-#: doc/classes/OS.xml:193
+#: doc/classes/OS.xml:204
msgid "Returns the host OS locale."
msgstr ""
-#: doc/classes/OS.xml:200
+#: doc/classes/OS.xml:211
msgid ""
"Returns the model name of the current device.\n"
"[b]Note:[/b] This method is implemented on Android and iOS. Returns "
"[code]\"GenericDevice\"[/code] on unsupported platforms."
msgstr ""
-#: doc/classes/OS.xml:208
+#: doc/classes/OS.xml:219
msgid ""
"Returns the name of the host OS. Possible values are: [code]\"Android\"[/"
"code], [code]\"iOS\"[/code], [code]\"HTML5\"[/code], [code]\"OSX\"[/code], "
@@ -33493,81 +34279,81 @@ msgid ""
"[code]\"X11\"[/code]."
msgstr ""
-#: doc/classes/OS.xml:215
+#: doc/classes/OS.xml:226
msgid ""
"Returns the project's process ID.\n"
"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and "
"Windows."
msgstr ""
-#: doc/classes/OS.xml:223
+#: doc/classes/OS.xml:234
msgid "Returns the number of threads available on the host machine."
msgstr ""
-#: doc/classes/OS.xml:230
+#: doc/classes/OS.xml:241
msgid ""
"Returns the amount of time in milliseconds it took for the boot logo to "
"appear."
msgstr ""
-#: doc/classes/OS.xml:237
+#: doc/classes/OS.xml:248
msgid "Returns the maximum amount of static memory used (only works in debug)."
msgstr ""
-#: doc/classes/OS.xml:244
+#: doc/classes/OS.xml:255
msgid "Returns the amount of static memory being used by the program in bytes."
msgstr ""
-#: doc/classes/OS.xml:253
+#: doc/classes/OS.xml:264
msgid ""
"Returns the actual path to commonly used folders across different platforms. "
"Available locations are specified in [enum SystemDir].\n"
"[b]Note:[/b] This method is implemented on Android, Linux, macOS and Windows."
msgstr ""
-#: doc/classes/OS.xml:261
+#: doc/classes/OS.xml:272
msgid ""
"Returns the total number of available tablet drivers.\n"
"[b]Note:[/b] This method is implemented on Windows."
msgstr ""
-#: doc/classes/OS.xml:271
+#: doc/classes/OS.xml:282
msgid ""
"Returns the tablet driver name for the given index.\n"
"[b]Note:[/b] This method is implemented on Windows."
msgstr ""
-#: doc/classes/OS.xml:279
+#: doc/classes/OS.xml:290
msgid ""
"Returns the amount of time passed in milliseconds since the engine started."
msgstr ""
-#: doc/classes/OS.xml:286
+#: doc/classes/OS.xml:297
msgid ""
"Returns the amount of time passed in microseconds since the engine started."
msgstr ""
-#: doc/classes/OS.xml:295
+#: doc/classes/OS.xml:306
msgid "Returns current time as a dictionary of keys: hour, minute, second."
msgstr ""
-#: doc/classes/OS.xml:302
+#: doc/classes/OS.xml:313
msgid ""
"Returns the current time zone as a dictionary with the keys: bias and name."
msgstr ""
-#: doc/classes/OS.xml:309
+#: doc/classes/OS.xml:320
msgid ""
"Returns a string that is unique to the device.\n"
"[b]Note:[/b] Returns an empty string on HTML5 and UWP, as this method isn't "
"implemented on those platforms yet."
msgstr ""
-#: doc/classes/OS.xml:317
+#: doc/classes/OS.xml:328
msgid "Returns the current UNIX epoch timestamp."
msgstr ""
-#: doc/classes/OS.xml:326
+#: doc/classes/OS.xml:337
msgid ""
"Gets an epoch time value from a dictionary of time values.\n"
"[code]datetime[/code] must be populated with the following keys: [code]year[/"
@@ -33578,7 +34364,7 @@ msgid ""
"ignored."
msgstr ""
-#: doc/classes/OS.xml:335
+#: doc/classes/OS.xml:346
msgid ""
"Returns the absolute directory path where user data is written ([code]user://"
"[/code]).\n"
@@ -33596,11 +34382,11 @@ msgid ""
"[/code]."
msgstr ""
-#: doc/classes/OS.xml:348
+#: doc/classes/OS.xml:359
msgid "Returns [code]true[/code] if an environment variable exists."
msgstr ""
-#: doc/classes/OS.xml:357
+#: doc/classes/OS.xml:368
msgid ""
"Returns [code]true[/code] if the feature for the given feature tag is "
"supported in the currently running instance, depending on platform, build "
@@ -33611,7 +34397,7 @@ msgid ""
"[b]Note:[/b] Tag names are case-sensitive."
msgstr ""
-#: doc/classes/OS.xml:365
+#: doc/classes/OS.xml:376
msgid ""
"Returns [code]true[/code] if the Godot binary used to run the project is a "
"[i]debug[/i] export template, or when running in the editor.\n"
@@ -33622,26 +34408,26 @@ msgid ""
"instead."
msgstr ""
-#: doc/classes/OS.xml:376
+#: doc/classes/OS.xml:387
msgid ""
"Returns [code]true[/code] if the input keycode corresponds to a Unicode "
"character."
msgstr ""
-#: doc/classes/OS.xml:383
+#: doc/classes/OS.xml:394
msgid ""
"Returns [code]true[/code] if the engine was executed with [code]-v[/code] "
"(verbose stdout)."
msgstr ""
-#: doc/classes/OS.xml:390
+#: doc/classes/OS.xml:401
msgid ""
"If [code]true[/code], the [code]user://[/code] file system is persistent, so "
"that its state is the same after a player quits and starts the game again. "
"Relevant to the HTML5 platform, where this persistence may be unavailable."
msgstr ""
-#: doc/classes/OS.xml:399
+#: doc/classes/OS.xml:410
msgid ""
"Kill (terminate) the process identified by the given process ID ([code]pid[/"
"code]), e.g. the one returned by [method execute] in non-blocking mode.\n"
@@ -33651,37 +34437,37 @@ msgid ""
"Windows."
msgstr ""
-#: doc/classes/OS.xml:408
+#: doc/classes/OS.xml:419
msgid ""
"Initialises the singleton for the system MIDI driver.\n"
"[b]Note:[/b] This method is implemented on Linux, macOS and Windows."
msgstr ""
-#: doc/classes/OS.xml:418
+#: doc/classes/OS.xml:429
msgid ""
"Shows all resources in the game. Optionally, the list can be written to a "
"file by specifying a file path in [code]tofile[/code]."
msgstr ""
-#: doc/classes/OS.xml:425
+#: doc/classes/OS.xml:436
msgid "Shows the list of loaded textures sorted by size in memory."
msgstr ""
-#: doc/classes/OS.xml:434
+#: doc/classes/OS.xml:445
msgid "Shows the number of resources loaded by the game of the given types."
msgstr ""
-#: doc/classes/OS.xml:443
+#: doc/classes/OS.xml:454
msgid "Shows all resources currently used by the game."
msgstr ""
-#: doc/classes/OS.xml:452
+#: doc/classes/OS.xml:463
msgid ""
"At the moment this function is only used by [code]AudioDriverOpenSL[/code] "
"to request permission for [code]RECORD_AUDIO[/code] on Android."
msgstr ""
-#: doc/classes/OS.xml:459
+#: doc/classes/OS.xml:470
msgid ""
"With this function you can request dangerous permissions since normal "
"permissions are automatically granted at install time in Android "
@@ -33689,15 +34475,15 @@ msgid ""
"[b]Note:[/b] This method is implemented on Android."
msgstr ""
-#: doc/classes/OS.xml:469
+#: doc/classes/OS.xml:480
msgid "Sets the name of the current thread."
msgstr ""
-#: doc/classes/OS.xml:478
+#: doc/classes/OS.xml:489
msgid "Enables backup saves if [code]enabled[/code] is [code]true[/code]."
msgstr ""
-#: doc/classes/OS.xml:487
+#: doc/classes/OS.xml:498
msgid ""
"Requests the OS to open a resource with the most appropriate program. For "
"example:\n"
@@ -33716,7 +34502,7 @@ msgid ""
"and Windows."
msgstr ""
-#: doc/classes/OS.xml:498
+#: doc/classes/OS.xml:509
msgid ""
"The exit code passed to the OS when the main loop exits. By convention, an "
"exit code of [code]0[/code] indicates success whereas a non-zero exit code "
@@ -33726,137 +34512,137 @@ msgid ""
"with an [code]exit_code[/code] argument passed."
msgstr ""
-#: doc/classes/OS.xml:502
+#: doc/classes/OS.xml:513
msgid ""
"If [code]true[/code], the engine optimizes for low processor usage by only "
"refreshing the screen if needed. Can improve battery consumption on mobile."
msgstr ""
-#: doc/classes/OS.xml:505
+#: doc/classes/OS.xml:516
msgid ""
"The amount of sleeping between frames when the low-processor usage mode is "
"enabled (in microseconds). Higher values will result in lower CPU usage."
msgstr ""
-#: doc/classes/OS.xml:508
-msgid "The current tablet drvier in use."
+#: doc/classes/OS.xml:519
+msgid "The current tablet driver in use."
msgstr ""
-#: doc/classes/OS.xml:513
+#: doc/classes/OS.xml:524
msgid ""
"The GLES2 rendering backend. It uses OpenGL ES 2.0 on mobile devices, OpenGL "
"2.1 on desktop platforms and WebGL 1.0 on the web."
msgstr ""
-#: doc/classes/OS.xml:516
+#: doc/classes/OS.xml:527
msgid "The Vulkan rendering backend."
msgstr ""
-#: doc/classes/OS.xml:519
+#: doc/classes/OS.xml:530
msgid "Sunday."
msgstr ""
-#: doc/classes/OS.xml:522
+#: doc/classes/OS.xml:533
msgid "Monday."
msgstr ""
-#: doc/classes/OS.xml:525
+#: doc/classes/OS.xml:536
msgid "Tuesday."
msgstr ""
-#: doc/classes/OS.xml:528
+#: doc/classes/OS.xml:539
msgid "Wednesday."
msgstr ""
-#: doc/classes/OS.xml:531
+#: doc/classes/OS.xml:542
msgid "Thursday."
msgstr ""
-#: doc/classes/OS.xml:534
+#: doc/classes/OS.xml:545
msgid "Friday."
msgstr ""
-#: doc/classes/OS.xml:537
+#: doc/classes/OS.xml:548
msgid "Saturday."
msgstr ""
-#: doc/classes/OS.xml:540
+#: doc/classes/OS.xml:551
msgid "January."
msgstr ""
-#: doc/classes/OS.xml:543
+#: doc/classes/OS.xml:554
msgid "February."
msgstr ""
-#: doc/classes/OS.xml:546
+#: doc/classes/OS.xml:557
msgid "March."
msgstr ""
-#: doc/classes/OS.xml:549
+#: doc/classes/OS.xml:560
msgid "April."
msgstr ""
-#: doc/classes/OS.xml:552
+#: doc/classes/OS.xml:563
msgid "May."
msgstr ""
-#: doc/classes/OS.xml:555
+#: doc/classes/OS.xml:566
msgid "June."
msgstr ""
-#: doc/classes/OS.xml:558
+#: doc/classes/OS.xml:569
msgid "July."
msgstr ""
-#: doc/classes/OS.xml:561
+#: doc/classes/OS.xml:572
msgid "August."
msgstr ""
-#: doc/classes/OS.xml:564
+#: doc/classes/OS.xml:575
msgid "September."
msgstr ""
-#: doc/classes/OS.xml:567
+#: doc/classes/OS.xml:578
msgid "October."
msgstr ""
-#: doc/classes/OS.xml:570
+#: doc/classes/OS.xml:581
msgid "November."
msgstr ""
-#: doc/classes/OS.xml:573
+#: doc/classes/OS.xml:584
msgid "December."
msgstr ""
-#: doc/classes/OS.xml:576
+#: doc/classes/OS.xml:587
msgid "Desktop directory path."
msgstr ""
-#: doc/classes/OS.xml:579
+#: doc/classes/OS.xml:590
msgid "DCIM (Digital Camera Images) directory path."
msgstr ""
-#: doc/classes/OS.xml:582
+#: doc/classes/OS.xml:593
msgid "Documents directory path."
msgstr ""
-#: doc/classes/OS.xml:585
+#: doc/classes/OS.xml:596
msgid "Downloads directory path."
msgstr ""
-#: doc/classes/OS.xml:588
+#: doc/classes/OS.xml:599
msgid "Movies directory path."
msgstr ""
-#: doc/classes/OS.xml:591
+#: doc/classes/OS.xml:602
msgid "Music directory path."
msgstr ""
-#: doc/classes/OS.xml:594
+#: doc/classes/OS.xml:605
msgid "Pictures directory path."
msgstr ""
-#: doc/classes/OS.xml:597
+#: doc/classes/OS.xml:608
msgid "Ringtones directory path."
msgstr ""
@@ -33911,7 +34697,16 @@ msgid ""
"should always be preferred."
msgstr ""
-#: doc/classes/PackedByteArray.xml:85
+#: doc/classes/PackedByteArray.xml:87 doc/classes/PackedColorArray.xml:53
+#: doc/classes/PackedFloat32Array.xml:54 doc/classes/PackedFloat64Array.xml:54
+#: doc/classes/PackedInt32Array.xml:54 doc/classes/PackedInt64Array.xml:54
+#: doc/classes/PackedStringArray.xml:53 doc/classes/PackedVector2Array.xml:53
+#: doc/classes/PackedVector3Array.xml:53
+#, fuzzy
+msgid "Returns [code]true[/code] if the array contains [code]value[/code]."
+msgstr "如果[code]s[/code] 为0或者很接近0则返回[code]true[/code]。"
+
+#: doc/classes/PackedByteArray.xml:94
msgid ""
"Returns a hexadecimal representation of this array as a [String].\n"
"[codeblock]\n"
@@ -33920,39 +34715,48 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/PackedByteArray.xml:100 doc/classes/PackedColorArray.xml:55
-#: doc/classes/PackedFloat32Array.xml:56 doc/classes/PackedFloat64Array.xml:56
-#: doc/classes/PackedStringArray.xml:55 doc/classes/PackedVector2Array.xml:55
-#: doc/classes/PackedVector3Array.xml:55
+#: doc/classes/PackedByteArray.xml:109 doc/classes/PackedColorArray.xml:64
+#: doc/classes/PackedFloat32Array.xml:65 doc/classes/PackedFloat64Array.xml:65
+#: doc/classes/PackedStringArray.xml:64 doc/classes/PackedVector2Array.xml:64
+#: doc/classes/PackedVector3Array.xml:64
msgid ""
"Inserts a new element at a given position in the array. The position must be "
"valid, or at the end of the array ([code]idx == size()[/code])."
msgstr ""
-#: doc/classes/PackedByteArray.xml:134 doc/classes/PackedColorArray.xml:89
-#: doc/classes/PackedFloat32Array.xml:90 doc/classes/PackedFloat64Array.xml:90
-#: doc/classes/PackedInt32Array.xml:90 doc/classes/PackedInt64Array.xml:90
-#: doc/classes/PackedStringArray.xml:89 doc/classes/PackedVector2Array.xml:89
-#: doc/classes/PackedVector3Array.xml:89
+#: doc/classes/PackedByteArray.xml:143 doc/classes/PackedColorArray.xml:98
+#: doc/classes/PackedFloat32Array.xml:99 doc/classes/PackedFloat64Array.xml:99
+#: doc/classes/PackedInt32Array.xml:99 doc/classes/PackedInt64Array.xml:99
+#: doc/classes/PackedStringArray.xml:98 doc/classes/PackedVector2Array.xml:98
+#: doc/classes/PackedVector3Array.xml:98
msgid ""
"Sets the size of the array. If the array is grown, reserves elements at the "
"end of the array. If the array is shrunk, truncates the array to the new "
"size."
msgstr ""
-#: doc/classes/PackedByteArray.xml:145
+#: doc/classes/PackedByteArray.xml:154
msgid "Changes the byte at the given index."
msgstr ""
-#: doc/classes/PackedByteArray.xml:152 doc/classes/PackedColorArray.xml:107
-#: doc/classes/PackedFloat32Array.xml:108
-#: doc/classes/PackedFloat64Array.xml:108 doc/classes/PackedStringArray.xml:107
-#: doc/classes/PackedVector2Array.xml:107
-#: doc/classes/PackedVector3Array.xml:107
+#: doc/classes/PackedByteArray.xml:161 doc/classes/PackedColorArray.xml:116
+#: doc/classes/PackedFloat32Array.xml:117
+#: doc/classes/PackedFloat64Array.xml:117 doc/classes/PackedStringArray.xml:116
+#: doc/classes/PackedVector2Array.xml:116
+#: doc/classes/PackedVector3Array.xml:116
msgid "Returns the size of the array."
msgstr ""
-#: doc/classes/PackedByteArray.xml:163
+#: doc/classes/PackedByteArray.xml:168 doc/classes/PackedColorArray.xml:123
+#: doc/classes/PackedFloat32Array.xml:124
+#: doc/classes/PackedFloat64Array.xml:124 doc/classes/PackedInt32Array.xml:124
+#: doc/classes/PackedInt64Array.xml:124 doc/classes/PackedStringArray.xml:123
+#: doc/classes/PackedVector2Array.xml:123
+#: doc/classes/PackedVector3Array.xml:123
+msgid "Sorts the elements of the array in ascending order."
+msgstr ""
+
+#: doc/classes/PackedByteArray.xml:179
msgid ""
"Returns the slice of the [PackedByteArray] between indices (inclusive) as a "
"new [PackedByteArray]. Any negative index is considered to be from the end "
@@ -33980,12 +34784,12 @@ msgstr ""
msgid "Appends a [PackedColorArray] at the end of this array."
msgstr ""
-#: doc/classes/PackedColorArray.xml:71 doc/classes/PackedInt32Array.xml:72
-#: doc/classes/PackedInt64Array.xml:72
+#: doc/classes/PackedColorArray.xml:80 doc/classes/PackedInt32Array.xml:81
+#: doc/classes/PackedInt64Array.xml:81
msgid "Appends a value to the array."
msgstr ""
-#: doc/classes/PackedColorArray.xml:100
+#: doc/classes/PackedColorArray.xml:109
msgid "Changes the [Color] at the given index."
msgstr ""
@@ -34015,8 +34819,8 @@ msgstr ""
msgid "Appends a [PackedFloat32Array] at the end of this array."
msgstr ""
-#: doc/classes/PackedFloat32Array.xml:101
-#: doc/classes/PackedFloat64Array.xml:101
+#: doc/classes/PackedFloat32Array.xml:110
+#: doc/classes/PackedFloat64Array.xml:110
msgid "Changes the float at the given index."
msgstr ""
@@ -34069,17 +34873,17 @@ msgstr ""
msgid "Appends a [PackedInt32Array] at the end of this array."
msgstr ""
-#: doc/classes/PackedInt32Array.xml:56 doc/classes/PackedInt64Array.xml:56
+#: doc/classes/PackedInt32Array.xml:65 doc/classes/PackedInt64Array.xml:65
msgid ""
"Inserts a new integer at a given position in the array. The position must be "
"valid, or at the end of the array ([code]idx == size()[/code])."
msgstr ""
-#: doc/classes/PackedInt32Array.xml:101 doc/classes/PackedInt64Array.xml:101
+#: doc/classes/PackedInt32Array.xml:110 doc/classes/PackedInt64Array.xml:110
msgid "Changes the integer at the given index."
msgstr ""
-#: doc/classes/PackedInt32Array.xml:108 doc/classes/PackedInt64Array.xml:108
+#: doc/classes/PackedInt32Array.xml:117 doc/classes/PackedInt64Array.xml:117
msgid "Returns the array size."
msgstr ""
@@ -34120,6 +34924,14 @@ msgid ""
"Can be used to save a node to a file. When saving, the node as well as all "
"the node it owns get saved (see [code]owner[/code] property on [Node]).\n"
"[b]Note:[/b] The node doesn't need to own itself.\n"
+"[b]Example of loading a saved scene:[/b]\n"
+"[codeblock]\n"
+"# Use `load()` instead of `preload()` if the path isn't known at compile-"
+"time.\n"
+"var scene = preload(\"res://scene.tscn\").instance()\n"
+"# Add the node as a child of the node the script is attached to.\n"
+"add_child(scene)\n"
+"[/codeblock]\n"
"[b]Example of saving a node with different owners:[/b] The following example "
"creates 3 objects: [code]Node2D[/code] ([code]node[/code]), "
"[code]RigidBody2D[/code] ([code]rigid[/code]) and [code]CollisionObject2D[/"
@@ -34151,29 +34963,29 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/PackedScene.xml:40
+#: doc/classes/PackedScene.xml:47
msgid "Returns [code]true[/code] if the scene file has nodes."
msgstr ""
-#: doc/classes/PackedScene.xml:47
+#: doc/classes/PackedScene.xml:54
msgid ""
"Returns the [code]SceneState[/code] representing the scene file contents."
msgstr ""
-#: doc/classes/PackedScene.xml:56
+#: doc/classes/PackedScene.xml:63
msgid ""
"Instantiates the scene's node hierarchy. Triggers child scene "
"instantiation(s). Triggers a [constant Node.NOTIFICATION_INSTANCED] "
"notification on the root node."
msgstr ""
-#: doc/classes/PackedScene.xml:65
+#: doc/classes/PackedScene.xml:72
msgid ""
"Pack will ignore any sub-nodes not owned by given node. See [member Node."
"owner]."
msgstr ""
-#: doc/classes/PackedScene.xml:71
+#: doc/classes/PackedScene.xml:78
msgid ""
"A dictionary representation of the scene contents.\n"
"Available keys include \"rnames\" and \"variants\" for resources, "
@@ -34182,18 +34994,18 @@ msgid ""
"connections, and \"version\" for the format style of the PackedScene."
msgstr ""
-#: doc/classes/PackedScene.xml:77
+#: doc/classes/PackedScene.xml:84
msgid "If passed to [method instance], blocks edits to the scene state."
msgstr ""
-#: doc/classes/PackedScene.xml:80
+#: doc/classes/PackedScene.xml:87
msgid ""
"If passed to [method instance], provides local scene resources to the local "
"scene.\n"
"[b]Note:[/b] Only available in editor builds."
msgstr ""
-#: doc/classes/PackedScene.xml:84
+#: doc/classes/PackedScene.xml:91
msgid ""
"If passed to [method instance], provides local scene resources to the local "
"scene. Only the main scene should receive the main edit state.\n"
@@ -34221,11 +35033,11 @@ msgstr ""
msgid "Appends a [PackedStringArray] at the end of this array."
msgstr ""
-#: doc/classes/PackedStringArray.xml:71
+#: doc/classes/PackedStringArray.xml:80
msgid "Appends a string element at end of the array."
msgstr ""
-#: doc/classes/PackedStringArray.xml:100
+#: doc/classes/PackedStringArray.xml:109
msgid "Changes the [String] at the given index."
msgstr ""
@@ -34250,11 +35062,11 @@ msgstr ""
msgid "Appends a [PackedVector2Array] at the end of this array."
msgstr ""
-#: doc/classes/PackedVector2Array.xml:71
+#: doc/classes/PackedVector2Array.xml:80
msgid "Inserts a [Vector2] at the end."
msgstr ""
-#: doc/classes/PackedVector2Array.xml:100
+#: doc/classes/PackedVector2Array.xml:109
msgid "Changes the [Vector2] at the given index."
msgstr ""
@@ -34279,11 +35091,11 @@ msgstr ""
msgid "Appends a [PackedVector3Array] at the end of this array."
msgstr ""
-#: doc/classes/PackedVector3Array.xml:71
+#: doc/classes/PackedVector3Array.xml:80
msgid "Inserts a [Vector3] at the end."
msgstr ""
-#: doc/classes/PackedVector3Array.xml:100
+#: doc/classes/PackedVector3Array.xml:109
msgid "Changes the [Vector3] at the given index."
msgstr ""
@@ -35174,13 +35986,55 @@ msgid ""
"as the values displayed in the [b]Monitor[/b] tab in the editor's "
"[b]Debugger[/b] panel. By using the [method get_monitor] method of this "
"class, you can access this data from your code.\n"
+"You can add custom monitors using the [method add_custom_monitor] method. "
+"Custom monitors are available in [b]Monitor[/b] tab in the editor's "
+"[b]Debugger[/b] panel together with built-in monitors.\n"
"[b]Note:[/b] A few of these monitors are only available in debug mode and "
"will always return 0 when used in a release build.\n"
"[b]Note:[/b] Many of these monitors are not updated in real-time, so there "
-"may be a short delay between changes."
+"may be a short delay between changes.\n"
+"[b]Note:[/b] Custom monitors do not support negative values. Negative values "
+"are clamped to 0."
+msgstr ""
+
+#: doc/classes/Performance.xml:26
+msgid ""
+"Adds a custom monitor with name same as id. You can specify the category of "
+"monitor using '/' in id. If there are more than one '/' then default "
+"category is used. Default category is \"Custom\".\n"
+"[codeblock]\n"
+"Performance.add_custom_monitor(\"MyCategory/MyMonitor\", some_callable) # "
+"Adds monitor with name \"MyName\" to category \"MyCategory\"\n"
+"Performance.add_custom_monitor(\"MyMonitor\", some_callable) # Adds monitor "
+"with name \"MyName\" to category \"Custom\"\n"
+"# Note: \"MyCategory/MyMonitor\" and \"MyMonitor\" have same name but "
+"different ids so above code is valid\n"
+"Performance.add_custom_monitor(\"Custom/MyMonitor\", some_callable) # Adds "
+"monitor with name \"MyName\" to category \"Custom\"\n"
+"# Note: \"MyMonitor\" and \"Custom/MyMonitor\" have same name and same "
+"category but different ids so above code is valid\n"
+"Performance.add_custom_monitor(\"MyCategoryOne/MyCategoryTwo/MyMonitor\", "
+"some_callable) # Adds monitor with name \"MyCategoryOne/MyCategoryTwo/"
+"MyMonitor\" to category \"Custom\"\n"
+"[/codeblock]\n"
+"The debugger calls the callable to get the value of custom monitor. The "
+"callable must return a number.\n"
+"Callables are called with arguments supplied in argument array.\n"
+"[b]Note:[/b] It throws an error if given id is already present."
+msgstr ""
+
+#: doc/classes/Performance.xml:46
+msgid ""
+"Returns the value of custom monitor with given id. The callable is called to "
+"get the value of custom monitor.\n"
+"[b]Note:[/b] It throws an error if the given id is absent."
msgstr ""
-#: doc/classes/Performance.xml:20
+#: doc/classes/Performance.xml:54
+msgid "Returns the names of active custom monitors in an array."
+msgstr ""
+
+#: doc/classes/Performance.xml:63
msgid ""
"Returns the value of one of the available monitors. You should provide one "
"of the [enum Monitor] constants as the argument, like this:\n"
@@ -35190,123 +36044,139 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/Performance.xml:29
+#: doc/classes/Performance.xml:73
+msgid "Returns the last tick in which custom monitor was added/removed."
+msgstr ""
+
+#: doc/classes/Performance.xml:82
+msgid ""
+"Returns true if custom monitor with the given id is present otherwise "
+"returns false."
+msgstr ""
+
+#: doc/classes/Performance.xml:91
+msgid ""
+"Removes the custom monitor with given id.\n"
+"[b]Note:[/b] It throws an error if the given id is already absent."
+msgstr ""
+
+#: doc/classes/Performance.xml:98
msgid "Number of frames per second."
msgstr ""
-#: doc/classes/Performance.xml:32
+#: doc/classes/Performance.xml:101
msgid "Time it took to complete one frame, in seconds."
msgstr ""
-#: doc/classes/Performance.xml:35
+#: doc/classes/Performance.xml:104
msgid "Time it took to complete one physics frame, in seconds."
msgstr ""
-#: doc/classes/Performance.xml:38
+#: doc/classes/Performance.xml:107
msgid ""
"Static memory currently used, in bytes. Not available in release builds."
msgstr ""
-#: doc/classes/Performance.xml:41
+#: doc/classes/Performance.xml:110
msgid "Available static memory. Not available in release builds."
msgstr ""
-#: doc/classes/Performance.xml:44
+#: doc/classes/Performance.xml:113
msgid ""
"Largest amount of memory the message queue buffer has used, in bytes. The "
"message queue is used for deferred functions calls and notifications."
msgstr ""
-#: doc/classes/Performance.xml:47
+#: doc/classes/Performance.xml:116
msgid "Number of objects currently instanced (including nodes)."
msgstr ""
-#: doc/classes/Performance.xml:50
+#: doc/classes/Performance.xml:119
msgid "Number of resources currently used."
msgstr ""
-#: doc/classes/Performance.xml:53
+#: doc/classes/Performance.xml:122
msgid ""
"Number of nodes currently instanced in the scene tree. This also includes "
"the root node."
msgstr ""
-#: doc/classes/Performance.xml:56
+#: doc/classes/Performance.xml:125
msgid ""
"Number of orphan nodes, i.e. nodes which are not parented to a node of the "
"scene tree."
msgstr ""
-#: doc/classes/Performance.xml:59
+#: doc/classes/Performance.xml:128
msgid "3D objects drawn per frame."
msgstr ""
-#: doc/classes/Performance.xml:62
+#: doc/classes/Performance.xml:131
msgid "Vertices drawn per frame. 3D only."
msgstr ""
-#: doc/classes/Performance.xml:65
+#: doc/classes/Performance.xml:134
msgid "Material changes per frame. 3D only."
msgstr ""
-#: doc/classes/Performance.xml:68
+#: doc/classes/Performance.xml:137
msgid "Shader changes per frame. 3D only."
msgstr ""
-#: doc/classes/Performance.xml:71
+#: doc/classes/Performance.xml:140
msgid "Render surface changes per frame. 3D only."
msgstr ""
-#: doc/classes/Performance.xml:74
+#: doc/classes/Performance.xml:143
msgid "Draw calls per frame. 3D only."
msgstr ""
-#: doc/classes/Performance.xml:77 doc/classes/RenderingServer.xml:3805
+#: doc/classes/Performance.xml:146 doc/classes/RenderingServer.xml:3816
msgid ""
"The amount of video memory used, i.e. texture and vertex memory combined."
msgstr ""
-#: doc/classes/Performance.xml:80 doc/classes/RenderingServer.xml:3808
+#: doc/classes/Performance.xml:149 doc/classes/RenderingServer.xml:3819
msgid "The amount of texture memory used."
msgstr ""
-#: doc/classes/Performance.xml:83 doc/classes/RenderingServer.xml:3811
+#: doc/classes/Performance.xml:152 doc/classes/RenderingServer.xml:3822
msgid "The amount of vertex memory used."
msgstr ""
-#: doc/classes/Performance.xml:86 doc/classes/RenderingServer.xml:3802
+#: doc/classes/Performance.xml:155 doc/classes/RenderingServer.xml:3813
msgid "Unimplemented in the GLES2 rendering backend, always returns 0."
msgstr ""
-#: doc/classes/Performance.xml:89
+#: doc/classes/Performance.xml:158
msgid "Number of active [RigidBody2D] nodes in the game."
msgstr ""
-#: doc/classes/Performance.xml:92
+#: doc/classes/Performance.xml:161
msgid "Number of collision pairs in the 2D physics engine."
msgstr ""
-#: doc/classes/Performance.xml:95
+#: doc/classes/Performance.xml:164
msgid "Number of islands in the 2D physics engine."
msgstr ""
-#: doc/classes/Performance.xml:98
+#: doc/classes/Performance.xml:167
msgid "Number of active [RigidBody3D] and [VehicleBody3D] nodes in the game."
msgstr ""
-#: doc/classes/Performance.xml:101
+#: doc/classes/Performance.xml:170
msgid "Number of collision pairs in the 3D physics engine."
msgstr ""
-#: doc/classes/Performance.xml:104
+#: doc/classes/Performance.xml:173
msgid "Number of islands in the 3D physics engine."
msgstr ""
-#: doc/classes/Performance.xml:107
+#: doc/classes/Performance.xml:176
msgid "Output latency of the [AudioServer]."
msgstr ""
-#: doc/classes/Performance.xml:110
+#: doc/classes/Performance.xml:179
msgid "Represents the size of the [enum Monitor] enum."
msgstr ""
@@ -35330,27 +36200,27 @@ msgstr ""
msgid "Damps the body's rotation if greater than [code]0[/code]."
msgstr ""
-#: doc/classes/PhysicalBone3D.xml:70 doc/classes/RigidBody3D.xml:132
+#: doc/classes/PhysicalBone3D.xml:70 doc/classes/RigidBody3D.xml:139
msgid "Lock the body's rotation in the X axis."
msgstr ""
-#: doc/classes/PhysicalBone3D.xml:73 doc/classes/RigidBody3D.xml:135
+#: doc/classes/PhysicalBone3D.xml:73 doc/classes/RigidBody3D.xml:142
msgid "Lock the body's rotation in the Y axis."
msgstr ""
-#: doc/classes/PhysicalBone3D.xml:76 doc/classes/RigidBody3D.xml:138
+#: doc/classes/PhysicalBone3D.xml:76 doc/classes/RigidBody3D.xml:145
msgid "Lock the body's rotation in the Z axis."
msgstr ""
-#: doc/classes/PhysicalBone3D.xml:79 doc/classes/RigidBody3D.xml:141
+#: doc/classes/PhysicalBone3D.xml:79 doc/classes/RigidBody3D.xml:148
msgid "Lock the body's movement in the X axis."
msgstr ""
-#: doc/classes/PhysicalBone3D.xml:82 doc/classes/RigidBody3D.xml:144
+#: doc/classes/PhysicalBone3D.xml:82 doc/classes/RigidBody3D.xml:151
msgid "Lock the body's movement in the Y axis."
msgstr ""
-#: doc/classes/PhysicalBone3D.xml:85 doc/classes/RigidBody3D.xml:147
+#: doc/classes/PhysicalBone3D.xml:85 doc/classes/RigidBody3D.xml:154
msgid "Lock the body's movement in the Z axis."
msgstr ""
@@ -35405,12 +36275,12 @@ msgstr ""
msgid "Damps the body's movement if greater than [code]0[/code]."
msgstr ""
-#: doc/classes/PhysicalBone3D.xml:118 doc/classes/RigidBody2D.xml:158
-#: doc/classes/RigidBody3D.xml:175
+#: doc/classes/PhysicalBone3D.xml:118 doc/classes/RigidBody2D.xml:159
+#: doc/classes/RigidBody3D.xml:183
msgid "The body's mass."
msgstr ""
-#: doc/classes/PhysicalBone3D.xml:121 doc/classes/RigidBody3D.xml:188
+#: doc/classes/PhysicalBone3D.xml:121 doc/classes/RigidBody3D.xml:196
msgid ""
"The body's weight based on its mass and the global 3D gravity. Global values "
"are set in [b]Project > Project Settings > Physics > 3d[/b]."
@@ -35717,7 +36587,7 @@ msgid "The inverse of the mass of the body."
msgstr ""
#: doc/classes/PhysicsDirectBodyState2D.xml:195
-#: doc/classes/PhysicsDirectBodyState3D.xml:198 doc/classes/RigidBody2D.xml:155
+#: doc/classes/PhysicsDirectBodyState3D.xml:198 doc/classes/RigidBody2D.xml:156
msgid "The body's linear velocity."
msgstr ""
@@ -36270,7 +37140,7 @@ msgid ""
msgstr ""
#: doc/classes/PhysicsServer2D.xml:620 doc/classes/PhysicsServer3D.xml:637
-#: doc/classes/RigidBody3D.xml:120
+#: doc/classes/RigidBody3D.xml:127
msgid ""
"Sets an axis velocity. The velocity in the given vector axis will be set as "
"the given vector length. This is useful for jumping behavior."
@@ -37335,47 +38205,64 @@ msgid ""
"collision queries. See also [PhysicsShapeQueryResult2D]."
msgstr ""
-#: doc/classes/PhysicsShapeQueryParameters2D.xml:18
-msgid ""
-"Sets the [Shape2D] that will be used for collision/intersection queries."
-msgstr ""
-
-#: doc/classes/PhysicsShapeQueryParameters2D.xml:24
+#: doc/classes/PhysicsShapeQueryParameters2D.xml:15
msgid "If [code]true[/code], the query will take [Area2D]s into account."
msgstr ""
-#: doc/classes/PhysicsShapeQueryParameters2D.xml:27
+#: doc/classes/PhysicsShapeQueryParameters2D.xml:18
msgid ""
"If [code]true[/code], the query will take [PhysicsBody2D]s into account."
msgstr ""
-#: doc/classes/PhysicsShapeQueryParameters2D.xml:30
-#: doc/classes/PhysicsShapeQueryParameters3D.xml:30
+#: doc/classes/PhysicsShapeQueryParameters2D.xml:21
+#: doc/classes/PhysicsShapeQueryParameters3D.xml:21
msgid "The physics layer(s) the query will take into account (as a bitmask)."
msgstr ""
-#: doc/classes/PhysicsShapeQueryParameters2D.xml:33
-#: doc/classes/PhysicsShapeQueryParameters3D.xml:33
+#: doc/classes/PhysicsShapeQueryParameters2D.xml:24
+#: doc/classes/PhysicsShapeQueryParameters3D.xml:24
msgid ""
"The list of objects or object [RID]s that will be excluded from collisions."
msgstr ""
-#: doc/classes/PhysicsShapeQueryParameters2D.xml:36
-#: doc/classes/PhysicsShapeQueryParameters3D.xml:36 doc/classes/Shape3D.xml:16
+#: doc/classes/PhysicsShapeQueryParameters2D.xml:27
+#: doc/classes/PhysicsShapeQueryParameters3D.xml:27 doc/classes/Shape3D.xml:16
msgid "The collision margin for the shape."
msgstr ""
-#: doc/classes/PhysicsShapeQueryParameters2D.xml:39
+#: doc/classes/PhysicsShapeQueryParameters2D.xml:30
msgid "The motion of the shape being queried for."
msgstr ""
-#: doc/classes/PhysicsShapeQueryParameters2D.xml:42
-#: doc/classes/PhysicsShapeQueryParameters3D.xml:39
-msgid "The queried shape's [RID]. See also [method set_shape]."
+#: doc/classes/PhysicsShapeQueryParameters2D.xml:33
+msgid ""
+"The [Shape2D] that will be used for collision/intersection queries. This "
+"stores the actual reference which avoids the shape to be released while "
+"being used for queries, so always prefer using this over [member shape_rid]."
+msgstr ""
+
+#: doc/classes/PhysicsShapeQueryParameters2D.xml:36
+msgid ""
+"The queried shape's [RID] that will be used for collision/intersection "
+"queries. Use this over [member shape] if you want to optimize for "
+"performance using the Servers API:\n"
+"[codeblock]\n"
+"var shape_rid = PhysicsServer2D.circle_shape_create()\n"
+"var radius = 64\n"
+"PhysicsServer2D.shape_set_data(shape_rid, radius)\n"
+"\n"
+"var params = PhysicsShapeQueryParameters2D.new()\n"
+"params.shape_rid = shape_rid\n"
+"\n"
+"# Execute physics queries here...\n"
+"\n"
+"# Release the shape when done with physics queries.\n"
+"PhysicsServer2D.free_rid(shape_rid)\n"
+"[/codeblock]"
msgstr ""
-#: doc/classes/PhysicsShapeQueryParameters2D.xml:45
-#: doc/classes/PhysicsShapeQueryParameters3D.xml:42
+#: doc/classes/PhysicsShapeQueryParameters2D.xml:52
+#: doc/classes/PhysicsShapeQueryParameters3D.xml:49
msgid "The queried shape's transform matrix."
msgstr ""
@@ -37389,18 +38276,40 @@ msgid ""
"collision queries. See also [PhysicsShapeQueryResult3D]."
msgstr ""
+#: doc/classes/PhysicsShapeQueryParameters3D.xml:15
+msgid "If [code]true[/code], the query will take [Area3D]s into account."
+msgstr ""
+
#: doc/classes/PhysicsShapeQueryParameters3D.xml:18
msgid ""
-"Sets the [Shape3D] that will be used for collision/intersection queries."
+"If [code]true[/code], the query will take [PhysicsBody3D]s into account."
msgstr ""
-#: doc/classes/PhysicsShapeQueryParameters3D.xml:24
-msgid "If [code]true[/code], the query will take [Area3D]s into account."
+#: doc/classes/PhysicsShapeQueryParameters3D.xml:30
+msgid ""
+"The [Shape3D] that will be used for collision/intersection queries. This "
+"stores the actual reference which avoids the shape to be released while "
+"being used for queries, so always prefer using this over [member shape_rid]."
msgstr ""
-#: doc/classes/PhysicsShapeQueryParameters3D.xml:27
+#: doc/classes/PhysicsShapeQueryParameters3D.xml:33
msgid ""
-"If [code]true[/code], the query will take [PhysicsBody3D]s into account."
+"The queried shape's [RID] that will be used for collision/intersection "
+"queries. Use this over [member shape] if you want to optimize for "
+"performance using the Servers API:\n"
+"[codeblock]\n"
+"var shape_rid = PhysicsServer3D.shape_create(PhysicsServer3D.SHAPE_SPHERE)\n"
+"var radius = 2.0\n"
+"PhysicsServer3D.shape_set_data(shape_rid, radius)\n"
+"\n"
+"var params = PhysicsShapeQueryParameters3D.new()\n"
+"params.shape_rid = shape_rid\n"
+"\n"
+"# Execute physics queries here...\n"
+"\n"
+"# Release the shape when done with physics queries.\n"
+"PhysicsServer3D.free_rid(shape_rid)\n"
+"[/codeblock]"
msgstr ""
#: doc/classes/PhysicsShapeQueryResult2D.xml:4
@@ -37541,92 +38450,94 @@ msgid ""
"code]."
msgstr ""
-#: doc/classes/Plane.xml:72
-msgid "Returns a point on the plane."
-msgstr ""
-
-#: doc/classes/Plane.xml:83
+#: doc/classes/Plane.xml:76
msgid ""
-"Returns [code]true[/code] if [code]point[/code] is inside the plane (by a "
-"very minimum [code]epsilon[/code] threshold)."
+"Returns [code]true[/code] if [code]point[/code] is inside the plane. "
+"Comparison uses a custom minimum [code]epsilon[/code] threshold."
msgstr ""
-#: doc/classes/Plane.xml:94
+#: doc/classes/Plane.xml:87
msgid ""
"Returns the intersection point of the three planes [code]b[/code], [code]c[/"
"code] and this plane. If no intersection is found, [code]null[/code] is "
"returned."
msgstr ""
-#: doc/classes/Plane.xml:105
+#: doc/classes/Plane.xml:98
msgid ""
"Returns the intersection point of a ray consisting of the position "
"[code]from[/code] and the direction normal [code]dir[/code] with this plane. "
"If no intersection is found, [code]null[/code] is returned."
msgstr ""
-#: doc/classes/Plane.xml:116
+#: doc/classes/Plane.xml:109
msgid ""
"Returns the intersection point of a segment from position [code]begin[/code] "
"to position [code]end[/code] with this plane. If no intersection is found, "
"[code]null[/code] is returned."
msgstr ""
-#: doc/classes/Plane.xml:125
+#: doc/classes/Plane.xml:118
msgid ""
"Returns [code]true[/code] if this plane and [code]plane[/code] are "
"approximately equal, by running [method @GDScript.is_equal_approx] on each "
"component."
msgstr ""
-#: doc/classes/Plane.xml:134
+#: doc/classes/Plane.xml:127
msgid ""
"Returns [code]true[/code] if [code]point[/code] is located above the plane."
msgstr ""
-#: doc/classes/Plane.xml:141
+#: doc/classes/Plane.xml:134
msgid "Returns a copy of the plane, normalized."
msgstr ""
-#: doc/classes/Plane.xml:150
+#: doc/classes/Plane.xml:143
msgid ""
-"Returns the orthogonal projection of point [code]p[/code] into a point in "
-"the plane."
+"Returns the orthogonal projection of [code]point[/code] into a point in the "
+"plane."
msgstr ""
-#: doc/classes/Plane.xml:156
+#: doc/classes/Plane.xml:149
msgid ""
-"Distance from the origin to the plane, in the direction of [member normal]."
+"The distance from the origin to the plane, in the direction of [member "
+"normal]. This value is typically non-negative.\n"
+"In the scalar equation of the plane [code]ax + by + cz = d[/code], this is "
+"[code]d[/code], while the [code](a, b, c)[/code] coordinates are represented "
+"by the [member normal] property."
msgstr ""
-#: doc/classes/Plane.xml:159
+#: doc/classes/Plane.xml:153
msgid ""
-"The normal of the plane. \"Over\" or \"Above\" the plane is considered the "
-"side of the plane towards where the normal is pointing."
+"The normal of the plane, which must be normalized.\n"
+"In the scalar equation of the plane [code]ax + by + cz = d[/code], this is "
+"the vector [code](a, b, c)[/code], where [code]d[/code] is the [member d] "
+"property."
msgstr ""
-#: doc/classes/Plane.xml:162
-msgid "The [member normal]'s X component."
+#: doc/classes/Plane.xml:157
+msgid "The X component of the plane's [member normal] vector."
msgstr ""
-#: doc/classes/Plane.xml:165
-msgid "The [member normal]'s Y component."
+#: doc/classes/Plane.xml:160
+msgid "The Y component of the plane's [member normal] vector."
msgstr ""
-#: doc/classes/Plane.xml:168
-msgid "The [member normal]'s Z component."
+#: doc/classes/Plane.xml:163
+msgid "The Z component of the plane's [member normal] vector."
msgstr ""
-#: doc/classes/Plane.xml:173
-msgid "A plane that extends in the Y and Z axes."
+#: doc/classes/Plane.xml:168
+msgid "A plane that extends in the Y and Z axes (normal vector points +X)."
msgstr ""
-#: doc/classes/Plane.xml:176
-msgid "A plane that extends in the X and Z axes."
+#: doc/classes/Plane.xml:171
+msgid "A plane that extends in the X and Z axes (normal vector points +Y)."
msgstr ""
-#: doc/classes/Plane.xml:179
-msgid "A plane that extends in the X and Y axes."
+#: doc/classes/Plane.xml:174
+msgid "A plane that extends in the X and Y axes (normal vector points +Z)."
msgstr ""
#: doc/classes/PlaneMesh.xml:4
@@ -38337,18 +39248,25 @@ msgstr ""
#: doc/classes/PrimitiveMesh.xml:16
msgid ""
-"Returns mesh arrays used to constitute surface of [Mesh]. Mesh arrays can be "
-"used with [ArrayMesh] to create new surfaces."
+"Returns mesh arrays used to constitute surface of [Mesh]. The result can be "
+"passed to [method ArrayMesh.add_surface_from_arrays] to create a new "
+"surface. For example:\n"
+"[codeblock]\n"
+"var c := CylinderMesh.new()\n"
+"var arr_mesh := ArrayMesh.new()\n"
+"arr_mesh.add_surface_from_arrays(Mesh.PRIMITIVE_TRIANGLES, c."
+"get_mesh_arrays())\n"
+"[/codeblock]"
msgstr ""
-#: doc/classes/PrimitiveMesh.xml:22
+#: doc/classes/PrimitiveMesh.xml:27
msgid ""
"Overrides the [AABB] with one defined by user for use with frustum culling. "
"Especially useful to avoid unnexpected culling when using a shader to "
"offset vertices."
msgstr ""
-#: doc/classes/PrimitiveMesh.xml:25
+#: doc/classes/PrimitiveMesh.xml:30
msgid ""
"If set, the order of the vertices in each triangle are reversed resulting in "
"the backside of the mesh being drawn.\n"
@@ -38356,7 +39274,7 @@ msgid ""
"[member BaseMaterial3D.cull_mode]."
msgstr ""
-#: doc/classes/PrimitiveMesh.xml:29
+#: doc/classes/PrimitiveMesh.xml:34
msgid "The current [Material] of the primitive mesh."
msgstr ""
@@ -38787,11 +39705,17 @@ msgstr ""
#: doc/classes/ProjectSettings.xml:260
msgid ""
+"Safer override for [member audio/output_latency] in the Web platform, to "
+"avoid audio issues especially on mobile devices."
+msgstr ""
+
+#: doc/classes/ProjectSettings.xml:263
+msgid ""
"Setting to hardcode audio delay when playing video. Best to leave this "
"untouched unless you know what you are doing."
msgstr ""
-#: doc/classes/ProjectSettings.xml:263
+#: doc/classes/ProjectSettings.xml:266
msgid ""
"The default compression level for gzip. Affects compressed scenes and "
"resources. Higher levels result in smaller files at the cost of compression "
@@ -38801,7 +39725,7 @@ msgid ""
"updates."
msgstr ""
-#: doc/classes/ProjectSettings.xml:266
+#: doc/classes/ProjectSettings.xml:269
msgid ""
"The default compression level for Zlib. Affects compressed scenes and "
"resources. Higher levels result in smaller files at the cost of compression "
@@ -38811,27 +39735,27 @@ msgid ""
"updates."
msgstr ""
-#: doc/classes/ProjectSettings.xml:269
+#: doc/classes/ProjectSettings.xml:272
msgid ""
"The default compression level for Zstandard. Affects compressed scenes and "
"resources. Higher levels result in smaller files at the cost of compression "
"speed. Decompression speed is mostly unaffected by the compression level."
msgstr ""
-#: doc/classes/ProjectSettings.xml:272
+#: doc/classes/ProjectSettings.xml:275
msgid ""
"Enables [url=https://github.com/facebook/zstd/releases/tag/v1.3.2]long-"
"distance matching[/url] in Zstandard."
msgstr ""
-#: doc/classes/ProjectSettings.xml:275
+#: doc/classes/ProjectSettings.xml:278
msgid ""
"Largest size limit (in power of 2) allowed when compressing using long-"
"distance matching with Zstandard. Higher values can result in better "
"compression, but will require more memory when compressing and decompressing."
msgstr ""
-#: doc/classes/ProjectSettings.xml:278
+#: doc/classes/ProjectSettings.xml:281
msgid ""
"If [code]true[/code], displays getters and setters in autocompletion results "
"in the script editor. This setting is meant to be used when porting old "
@@ -38839,74 +39763,55 @@ msgid ""
"Godot 3 onwards."
msgstr ""
-#: doc/classes/ProjectSettings.xml:281
+#: doc/classes/ProjectSettings.xml:288
msgid ""
"If [code]true[/code], enables warnings when a constant is used as a function."
msgstr ""
-#: doc/classes/ProjectSettings.xml:284
+#: doc/classes/ProjectSettings.xml:291
msgid ""
"If [code]true[/code], enables warnings when deprecated keywords are used."
msgstr ""
-#: doc/classes/ProjectSettings.xml:287
+#: doc/classes/ProjectSettings.xml:294
msgid ""
"If [code]true[/code], enables specific GDScript warnings (see [code]debug/"
"gdscript/warnings/*[/code] settings). If [code]false[/code], disables all "
"GDScript warnings."
msgstr ""
-#: doc/classes/ProjectSettings.xml:290
+#: doc/classes/ProjectSettings.xml:297
msgid ""
"If [code]true[/code], scripts in the [code]res://addons[/code] folder will "
"not generate warnings."
msgstr ""
-#: doc/classes/ProjectSettings.xml:293
-msgid ""
-"If [code]true[/code], enables warnings when a function is declared with the "
-"same name as a constant."
-msgstr ""
-
-#: doc/classes/ProjectSettings.xml:296
-msgid ""
-"If [code]true[/code], enables warnings when a function is declared with the "
-"same name as a variable. This will turn into an error in a future version "
-"when first-class functions become supported in GDScript."
-msgstr ""
-
-#: doc/classes/ProjectSettings.xml:299
-msgid ""
-"If [code]true[/code], enables warnings when a function assigned to a "
-"variable may yield and return a function state instead of a value."
-msgstr ""
-
-#: doc/classes/ProjectSettings.xml:302
+#: doc/classes/ProjectSettings.xml:300
msgid ""
"If [code]true[/code], enables warnings when using a function as if it was a "
"property."
msgstr ""
-#: doc/classes/ProjectSettings.xml:305
+#: doc/classes/ProjectSettings.xml:303
msgid ""
"If [code]true[/code], enables warnings when a ternary operator may emit "
"values with incompatible types."
msgstr ""
-#: doc/classes/ProjectSettings.xml:308
+#: doc/classes/ProjectSettings.xml:306
msgid ""
"If [code]true[/code], enables warnings when dividing an integer by another "
"integer (the decimal part will be discarded)."
msgstr ""
-#: doc/classes/ProjectSettings.xml:311
+#: doc/classes/ProjectSettings.xml:309
msgid ""
"If [code]true[/code], enables warnings when passing a floating-point value "
"to a function that expects an integer (it will be converted and lose "
"precision)."
msgstr ""
-#: doc/classes/ProjectSettings.xml:314
+#: doc/classes/ProjectSettings.xml:312
msgid ""
"If [code]true[/code], enables warnings when using a property as if it was a "
"function."
@@ -38927,102 +39832,85 @@ msgid ""
"member variable)."
msgstr ""
-#: doc/classes/ProjectSettings.xml:323
+#: doc/classes/ProjectSettings.xml:325
msgid ""
"If [code]true[/code], enables warnings when calling an expression that has "
"no effect on the surrounding code, such as writing [code]2 + 2[/code] as a "
"statement."
msgstr ""
-#: doc/classes/ProjectSettings.xml:326
+#: doc/classes/ProjectSettings.xml:328
msgid ""
"If [code]true[/code], enables warnings when calling a ternary expression "
"that has no effect on the surrounding code, such as writing [code]42 if "
"active else 0[/code] as a statement."
msgstr ""
-#: doc/classes/ProjectSettings.xml:329
+#: doc/classes/ProjectSettings.xml:331
msgid ""
"If [code]true[/code], all warnings will be reported as if they were errors."
msgstr ""
-#: doc/classes/ProjectSettings.xml:332
+#: doc/classes/ProjectSettings.xml:334
msgid ""
"If [code]true[/code], enables warnings when using a variable that wasn't "
"previously assigned."
msgstr ""
-#: doc/classes/ProjectSettings.xml:335
+#: doc/classes/ProjectSettings.xml:337
msgid ""
"If [code]true[/code], enables warnings when assigning a variable using an "
"assignment operator like [code]+=[/code] if the variable wasn't previously "
"assigned."
msgstr ""
-#: doc/classes/ProjectSettings.xml:338
+#: doc/classes/ProjectSettings.xml:340
msgid ""
"If [code]true[/code], enables warnings when unreachable code is detected "
"(such as after a [code]return[/code] statement that will always be executed)."
msgstr ""
-#: doc/classes/ProjectSettings.xml:341
+#: doc/classes/ProjectSettings.xml:345
msgid ""
"If [code]true[/code], enables warnings when using an expression whose type "
"may not be compatible with the function parameter expected."
msgstr ""
-#: doc/classes/ProjectSettings.xml:344
+#: doc/classes/ProjectSettings.xml:348
msgid "If [code]true[/code], enables warnings when performing an unsafe cast."
msgstr ""
-#: doc/classes/ProjectSettings.xml:347
+#: doc/classes/ProjectSettings.xml:351
msgid ""
"If [code]true[/code], enables warnings when calling a method whose presence "
"is not guaranteed at compile-time in the class."
msgstr ""
-#: doc/classes/ProjectSettings.xml:350
+#: doc/classes/ProjectSettings.xml:354
msgid ""
"If [code]true[/code], enables warnings when accessing a property whose "
"presence is not guaranteed at compile-time in the class."
msgstr ""
-#: doc/classes/ProjectSettings.xml:353
-msgid ""
-"If [code]true[/code], enables warnings when a function parameter is unused."
-msgstr ""
-
-#: doc/classes/ProjectSettings.xml:356
-msgid ""
-"If [code]true[/code], enables warnings when a member variable is unused."
-msgstr ""
-
-#: doc/classes/ProjectSettings.xml:359
+#: doc/classes/ProjectSettings.xml:363
msgid "If [code]true[/code], enables warnings when a signal is unused."
msgstr ""
-#: doc/classes/ProjectSettings.xml:362
+#: doc/classes/ProjectSettings.xml:366
msgid "If [code]true[/code], enables warnings when a local variable is unused."
msgstr ""
-#: doc/classes/ProjectSettings.xml:365
-msgid ""
-"If [code]true[/code], enables warnings when a variable is declared with the "
-"same name as a function. This will turn into an error in a future version "
-"when first-class functions become supported in GDScript."
-msgstr ""
-
-#: doc/classes/ProjectSettings.xml:368
+#: doc/classes/ProjectSettings.xml:369
msgid ""
"If [code]true[/code], enables warnings when assigning the result of a "
"function that returns [code]void[/code] to a variable."
msgstr ""
-#: doc/classes/ProjectSettings.xml:371
+#: doc/classes/ProjectSettings.xml:372
msgid "Message to be displayed before the backtrace when the engine crashes."
msgstr ""
-#: doc/classes/ProjectSettings.xml:374
+#: doc/classes/ProjectSettings.xml:375
msgid ""
"Maximum number of frames per second allowed. The actual number of frames per "
"second may still be below this value if the game is lagging.\n"
@@ -39033,143 +39921,143 @@ msgid ""
"project under lag conditions."
msgstr ""
-#: doc/classes/ProjectSettings.xml:379
+#: doc/classes/ProjectSettings.xml:380
msgid "Maximum call stack allowed for debugging GDScript."
msgstr ""
-#: doc/classes/ProjectSettings.xml:382
+#: doc/classes/ProjectSettings.xml:383
msgid "Maximum amount of functions per frame allowed when profiling."
msgstr ""
-#: doc/classes/ProjectSettings.xml:385
+#: doc/classes/ProjectSettings.xml:386
msgid "Print frames per second to standard output every second."
msgstr ""
-#: doc/classes/ProjectSettings.xml:388
+#: doc/classes/ProjectSettings.xml:389
msgid ""
"Print more information to standard output when running. It displays "
"information such as memory leaks, which scenes and resources are being "
"loaded, etc."
msgstr ""
-#: doc/classes/ProjectSettings.xml:391
+#: doc/classes/ProjectSettings.xml:392
msgid "Maximum call stack in visual scripting, to avoid infinite recursion."
msgstr ""
-#: doc/classes/ProjectSettings.xml:394
+#: doc/classes/ProjectSettings.xml:395
msgid ""
"Color of the contact points between collision shapes, visible when \"Visible "
"Collision Shapes\" is enabled in the Debug menu."
msgstr ""
-#: doc/classes/ProjectSettings.xml:397
+#: doc/classes/ProjectSettings.xml:398
msgid ""
"Maximum number of contact points between collision shapes to display when "
"\"Visible Collision Shapes\" is enabled in the Debug menu."
msgstr ""
-#: doc/classes/ProjectSettings.xml:400
+#: doc/classes/ProjectSettings.xml:401
msgid ""
"Color of the collision shapes, visible when \"Visible Collision Shapes\" is "
"enabled in the Debug menu."
msgstr ""
-#: doc/classes/ProjectSettings.xml:403
+#: doc/classes/ProjectSettings.xml:404
msgid ""
"Color of the disabled navigation geometry, visible when \"Visible Navigation"
"\" is enabled in the Debug menu."
msgstr ""
-#: doc/classes/ProjectSettings.xml:406
+#: doc/classes/ProjectSettings.xml:407
msgid ""
"Color of the navigation geometry, visible when \"Visible Navigation\" is "
"enabled in the Debug menu."
msgstr ""
-#: doc/classes/ProjectSettings.xml:409
+#: doc/classes/ProjectSettings.xml:410
msgid "Custom image for the mouse cursor (limited to 256×256)."
msgstr ""
-#: doc/classes/ProjectSettings.xml:412
+#: doc/classes/ProjectSettings.xml:413
msgid "Hotspot for the custom mouse cursor image."
msgstr ""
-#: doc/classes/ProjectSettings.xml:415
+#: doc/classes/ProjectSettings.xml:416
msgid "Position offset for tooltips, relative to the mouse cursor's hotspot."
msgstr ""
-#: doc/classes/ProjectSettings.xml:418
+#: doc/classes/ProjectSettings.xml:419
msgid ""
"If [code]true[/code], allows HiDPI display on Windows and macOS. This "
"setting has no effect on desktop Linux, as DPI-awareness fallbacks are not "
"supported there."
msgstr ""
-#: doc/classes/ProjectSettings.xml:421
+#: doc/classes/ProjectSettings.xml:422
msgid ""
"If [code]true[/code], keeps the screen on (even in case of inactivity), so "
"the screensaver does not take over. Works on desktop and mobile platforms."
msgstr ""
-#: doc/classes/ProjectSettings.xml:424
+#: doc/classes/ProjectSettings.xml:425
msgid "Default orientation on mobile devices."
msgstr ""
-#: doc/classes/ProjectSettings.xml:427
+#: doc/classes/ProjectSettings.xml:428
msgid ""
"If [code]true[/code], the home indicator is hidden automatically. This only "
"affects iOS devices without a physical home button."
msgstr ""
-#: doc/classes/ProjectSettings.xml:430
+#: doc/classes/ProjectSettings.xml:431
msgid "Force the window to be always on top."
msgstr ""
-#: doc/classes/ProjectSettings.xml:433
+#: doc/classes/ProjectSettings.xml:434
msgid "Force the window to be borderless."
msgstr ""
-#: doc/classes/ProjectSettings.xml:436
+#: doc/classes/ProjectSettings.xml:437
msgid "Sets the window to full screen when it starts."
msgstr ""
-#: doc/classes/ProjectSettings.xml:439
+#: doc/classes/ProjectSettings.xml:440
msgid ""
"Sets the game's main viewport height. On desktop platforms, this is the "
"default window size. Stretch mode settings also use this as a reference when "
"enabled."
msgstr ""
-#: doc/classes/ProjectSettings.xml:442
+#: doc/classes/ProjectSettings.xml:443
msgid "Allows the window to be resizable by default."
msgstr ""
-#: doc/classes/ProjectSettings.xml:445
+#: doc/classes/ProjectSettings.xml:446
msgid ""
"If greater than zero, overrides the window height when running the game. "
"Useful for testing stretch modes."
msgstr ""
-#: doc/classes/ProjectSettings.xml:448
+#: doc/classes/ProjectSettings.xml:449
msgid ""
"If greater than zero, overrides the window width when running the game. "
"Useful for testing stretch modes."
msgstr ""
-#: doc/classes/ProjectSettings.xml:451
+#: doc/classes/ProjectSettings.xml:452
msgid ""
"Sets the game's main viewport width. On desktop platforms, this is the "
"default window size. Stretch mode settings also use this as a reference when "
"enabled."
msgstr ""
-#: doc/classes/ProjectSettings.xml:454
+#: doc/classes/ProjectSettings.xml:455
msgid ""
"Specifies the tablet driver to use. If left empty, the default driver will "
"be used."
msgstr ""
-#: doc/classes/ProjectSettings.xml:457
+#: doc/classes/ProjectSettings.xml:458
msgid ""
"If [code]true[/code], enables vertical synchronization. This eliminates "
"tearing that may appear in moving scenes, at the cost of higher input "
@@ -39178,7 +40066,7 @@ msgid ""
"regardless (such as mobile platforms and HTML5)."
msgstr ""
-#: doc/classes/ProjectSettings.xml:460
+#: doc/classes/ProjectSettings.xml:461
msgid ""
"If [code]Use Vsync[/code] is enabled and this setting is [code]true[/code], "
"enables vertical synchronization via the operating system's window "
@@ -39189,13 +40077,13 @@ msgid ""
"framerate halving (e.g. from 60 FPS to 30 FPS) when using it."
msgstr ""
-#: doc/classes/ProjectSettings.xml:464
+#: doc/classes/ProjectSettings.xml:465
msgid ""
"Search path for project-specific script templates. Script templates will be "
"search both in the editor-specific path and in this project-specific path."
msgstr ""
-#: doc/classes/ProjectSettings.xml:467
+#: doc/classes/ProjectSettings.xml:468
msgid ""
"Text-based file extensions to include in the script editor's \"Find in Files"
"\" feature. You can add e.g. [code]tscn[/code] if you wish to also parse "
@@ -39203,49 +40091,49 @@ msgid ""
"serialized in the scene files."
msgstr ""
-#: doc/classes/ProjectSettings.xml:470
+#: doc/classes/ProjectSettings.xml:471
msgid ""
"Default value for [member ScrollContainer.scroll_deadzone], which will be "
"used for all [ScrollContainer]s unless overridden."
msgstr ""
-#: doc/classes/ProjectSettings.xml:473
+#: doc/classes/ProjectSettings.xml:474
msgid ""
-"If [code]true[/code], swaps OK and Cancel buttons in dialogs on Windows and "
+"If [code]true[/code], swaps Cancel and OK buttons in dialogs on Windows and "
"UWP to follow interface conventions."
msgstr ""
-#: doc/classes/ProjectSettings.xml:478
+#: doc/classes/ProjectSettings.xml:479
msgid ""
"Path to a custom [Theme] resource file to use for the project ([code]theme[/"
"code] or generic [code]tres[/code]/[code]res[/code] extension)."
msgstr ""
-#: doc/classes/ProjectSettings.xml:481
+#: doc/classes/ProjectSettings.xml:482
msgid ""
"Path to a custom [Font] resource to use as default for all GUI elements of "
"the project."
msgstr ""
-#: doc/classes/ProjectSettings.xml:484
+#: doc/classes/ProjectSettings.xml:485
msgid "If [code]true[/code], makes sure the theme used works with HiDPI."
msgstr ""
-#: doc/classes/ProjectSettings.xml:487
+#: doc/classes/ProjectSettings.xml:488
msgid ""
"Timer setting for incremental search in [Tree], [ItemList], etc. controls "
"(in milliseconds)."
msgstr ""
-#: doc/classes/ProjectSettings.xml:490
+#: doc/classes/ProjectSettings.xml:491
msgid "Timer for detecting idle in [TextEdit] (in seconds)."
msgstr ""
-#: doc/classes/ProjectSettings.xml:493
+#: doc/classes/ProjectSettings.xml:494
msgid "Default delay for tooltips (in seconds)."
msgstr ""
-#: doc/classes/ProjectSettings.xml:496
+#: doc/classes/ProjectSettings.xml:497
msgid ""
"Default [InputEventAction] to confirm a focused button, menu or list item, "
"or validate input.\n"
@@ -39254,7 +40142,7 @@ msgid ""
"to the action can however be modified."
msgstr ""
-#: doc/classes/ProjectSettings.xml:500
+#: doc/classes/ProjectSettings.xml:501
msgid ""
"Default [InputEventAction] to discard a modal or pending input.\n"
"[b]Note:[/b] Default [code]ui_*[/code] actions cannot be removed as they are "
@@ -39262,7 +40150,7 @@ msgid ""
"to the action can however be modified."
msgstr ""
-#: doc/classes/ProjectSettings.xml:504
+#: doc/classes/ProjectSettings.xml:505
msgid ""
"Default [InputEventAction] to move down in the UI.\n"
"[b]Note:[/b] Default [code]ui_*[/code] actions cannot be removed as they are "
@@ -39270,7 +40158,7 @@ msgid ""
"to the action can however be modified."
msgstr ""
-#: doc/classes/ProjectSettings.xml:508
+#: doc/classes/ProjectSettings.xml:509
msgid ""
"Default [InputEventAction] to go to the end position of a [Control] (e.g. "
"last item in an [ItemList] or a [Tree]), matching the behavior of [constant "
@@ -39280,7 +40168,7 @@ msgid ""
"to the action can however be modified."
msgstr ""
-#: doc/classes/ProjectSettings.xml:512
+#: doc/classes/ProjectSettings.xml:513
msgid ""
"Default [InputEventAction] to focus the next [Control] in the scene. The "
"focus behavior can be configured via [member Control.focus_next].\n"
@@ -39289,7 +40177,7 @@ msgid ""
"to the action can however be modified."
msgstr ""
-#: doc/classes/ProjectSettings.xml:516
+#: doc/classes/ProjectSettings.xml:517
msgid ""
"Default [InputEventAction] to focus the previous [Control] in the scene. The "
"focus behavior can be configured via [member Control.focus_previous].\n"
@@ -39298,7 +40186,7 @@ msgid ""
"to the action can however be modified."
msgstr ""
-#: doc/classes/ProjectSettings.xml:520
+#: doc/classes/ProjectSettings.xml:521
msgid ""
"Default [InputEventAction] to go to the start position of a [Control] (e.g. "
"first item in an [ItemList] or a [Tree]), matching the behavior of [constant "
@@ -39308,7 +40196,7 @@ msgid ""
"to the action can however be modified."
msgstr ""
-#: doc/classes/ProjectSettings.xml:524
+#: doc/classes/ProjectSettings.xml:525
msgid ""
"Default [InputEventAction] to move left in the UI.\n"
"[b]Note:[/b] Default [code]ui_*[/code] actions cannot be removed as they are "
@@ -39316,7 +40204,7 @@ msgid ""
"to the action can however be modified."
msgstr ""
-#: doc/classes/ProjectSettings.xml:528
+#: doc/classes/ProjectSettings.xml:529
msgid ""
"Default [InputEventAction] to go down a page in a [Control] (e.g. in an "
"[ItemList] or a [Tree]), matching the behavior of [constant KEY_PAGEDOWN] on "
@@ -39326,7 +40214,7 @@ msgid ""
"to the action can however be modified."
msgstr ""
-#: doc/classes/ProjectSettings.xml:532
+#: doc/classes/ProjectSettings.xml:533
msgid ""
"Default [InputEventAction] to go up a page in a [Control] (e.g. in an "
"[ItemList] or a [Tree]), matching the behavior of [constant KEY_PAGEUP] on "
@@ -39336,7 +40224,7 @@ msgid ""
"to the action can however be modified."
msgstr ""
-#: doc/classes/ProjectSettings.xml:536
+#: doc/classes/ProjectSettings.xml:537
msgid ""
"Default [InputEventAction] to move right in the UI.\n"
"[b]Note:[/b] Default [code]ui_*[/code] actions cannot be removed as they are "
@@ -39344,7 +40232,7 @@ msgid ""
"to the action can however be modified."
msgstr ""
-#: doc/classes/ProjectSettings.xml:540
+#: doc/classes/ProjectSettings.xml:541
msgid ""
"Default [InputEventAction] to select an item in a [Control] (e.g. in an "
"[ItemList] or a [Tree]).\n"
@@ -39353,7 +40241,7 @@ msgid ""
"to the action can however be modified."
msgstr ""
-#: doc/classes/ProjectSettings.xml:544
+#: doc/classes/ProjectSettings.xml:545
msgid ""
"Default [InputEventAction] to move up in the UI.\n"
"[b]Note:[/b] Default [code]ui_*[/code] actions cannot be removed as they are "
@@ -39361,371 +40249,371 @@ msgid ""
"to the action can however be modified."
msgstr ""
-#: doc/classes/ProjectSettings.xml:548
+#: doc/classes/ProjectSettings.xml:549
msgid ""
"If [code]true[/code], sends mouse input events when tapping or swiping on "
"the touchscreen."
msgstr ""
-#: doc/classes/ProjectSettings.xml:551
+#: doc/classes/ProjectSettings.xml:552
msgid ""
"If [code]true[/code], sends touch input events when clicking or dragging the "
"mouse."
msgstr ""
-#: doc/classes/ProjectSettings.xml:554
+#: doc/classes/ProjectSettings.xml:555
msgid "Optional name for the 2D physics layer 1."
msgstr ""
-#: doc/classes/ProjectSettings.xml:557
+#: doc/classes/ProjectSettings.xml:558
msgid "Optional name for the 2D physics layer 10."
msgstr ""
-#: doc/classes/ProjectSettings.xml:560
+#: doc/classes/ProjectSettings.xml:561
msgid "Optional name for the 2D physics layer 11."
msgstr ""
-#: doc/classes/ProjectSettings.xml:563
+#: doc/classes/ProjectSettings.xml:564
msgid "Optional name for the 2D physics layer 12."
msgstr ""
-#: doc/classes/ProjectSettings.xml:566
+#: doc/classes/ProjectSettings.xml:567
msgid "Optional name for the 2D physics layer 13."
msgstr ""
-#: doc/classes/ProjectSettings.xml:569
+#: doc/classes/ProjectSettings.xml:570
msgid "Optional name for the 2D physics layer 14."
msgstr ""
-#: doc/classes/ProjectSettings.xml:572
+#: doc/classes/ProjectSettings.xml:573
msgid "Optional name for the 2D physics layer 15."
msgstr ""
-#: doc/classes/ProjectSettings.xml:575
+#: doc/classes/ProjectSettings.xml:576
msgid "Optional name for the 2D physics layer 16."
msgstr ""
-#: doc/classes/ProjectSettings.xml:578
+#: doc/classes/ProjectSettings.xml:579
msgid "Optional name for the 2D physics layer 17."
msgstr ""
-#: doc/classes/ProjectSettings.xml:581
+#: doc/classes/ProjectSettings.xml:582
msgid "Optional name for the 2D physics layer 18."
msgstr ""
-#: doc/classes/ProjectSettings.xml:584
+#: doc/classes/ProjectSettings.xml:585
msgid "Optional name for the 2D physics layer 19."
msgstr ""
-#: doc/classes/ProjectSettings.xml:587
+#: doc/classes/ProjectSettings.xml:588
msgid "Optional name for the 2D physics layer 2."
msgstr ""
-#: doc/classes/ProjectSettings.xml:590
+#: doc/classes/ProjectSettings.xml:591
msgid "Optional name for the 2D physics layer 20."
msgstr ""
-#: doc/classes/ProjectSettings.xml:593
+#: doc/classes/ProjectSettings.xml:594
msgid "Optional name for the 2D physics layer 3."
msgstr ""
-#: doc/classes/ProjectSettings.xml:596
+#: doc/classes/ProjectSettings.xml:597
msgid "Optional name for the 2D physics layer 4."
msgstr ""
-#: doc/classes/ProjectSettings.xml:599
+#: doc/classes/ProjectSettings.xml:600
msgid "Optional name for the 2D physics layer 5."
msgstr ""
-#: doc/classes/ProjectSettings.xml:602
+#: doc/classes/ProjectSettings.xml:603
msgid "Optional name for the 2D physics layer 6."
msgstr ""
-#: doc/classes/ProjectSettings.xml:605
+#: doc/classes/ProjectSettings.xml:606
msgid "Optional name for the 2D physics layer 7."
msgstr ""
-#: doc/classes/ProjectSettings.xml:608
+#: doc/classes/ProjectSettings.xml:609
msgid "Optional name for the 2D physics layer 8."
msgstr ""
-#: doc/classes/ProjectSettings.xml:611
+#: doc/classes/ProjectSettings.xml:612
msgid "Optional name for the 2D physics layer 9."
msgstr ""
-#: doc/classes/ProjectSettings.xml:614
+#: doc/classes/ProjectSettings.xml:615
msgid "Optional name for the 2D render layer 1."
msgstr ""
-#: doc/classes/ProjectSettings.xml:617
+#: doc/classes/ProjectSettings.xml:618
msgid "Optional name for the 2D render layer 10."
msgstr ""
-#: doc/classes/ProjectSettings.xml:620
+#: doc/classes/ProjectSettings.xml:621
msgid "Optional name for the 2D render layer 11."
msgstr ""
-#: doc/classes/ProjectSettings.xml:623
+#: doc/classes/ProjectSettings.xml:624
msgid "Optional name for the 2D render layer 12."
msgstr ""
-#: doc/classes/ProjectSettings.xml:626
+#: doc/classes/ProjectSettings.xml:627
msgid "Optional name for the 2D render layer 13."
msgstr ""
-#: doc/classes/ProjectSettings.xml:629
+#: doc/classes/ProjectSettings.xml:630
msgid "Optional name for the 2D render layer 14."
msgstr ""
-#: doc/classes/ProjectSettings.xml:632
+#: doc/classes/ProjectSettings.xml:633
msgid "Optional name for the 2D render layer 15."
msgstr ""
-#: doc/classes/ProjectSettings.xml:635
+#: doc/classes/ProjectSettings.xml:636
msgid "Optional name for the 2D render layer 16."
msgstr ""
-#: doc/classes/ProjectSettings.xml:638
+#: doc/classes/ProjectSettings.xml:639
msgid "Optional name for the 2D render layer 17."
msgstr ""
-#: doc/classes/ProjectSettings.xml:641
+#: doc/classes/ProjectSettings.xml:642
msgid "Optional name for the 2D render layer 18."
msgstr ""
-#: doc/classes/ProjectSettings.xml:644
+#: doc/classes/ProjectSettings.xml:645
msgid "Optional name for the 2D render layer 19."
msgstr ""
-#: doc/classes/ProjectSettings.xml:647
+#: doc/classes/ProjectSettings.xml:648
msgid "Optional name for the 2D render layer 2."
msgstr ""
-#: doc/classes/ProjectSettings.xml:650
+#: doc/classes/ProjectSettings.xml:651
msgid "Optional name for the 2D render layer 20."
msgstr ""
-#: doc/classes/ProjectSettings.xml:653
+#: doc/classes/ProjectSettings.xml:654
msgid "Optional name for the 2D render layer 3."
msgstr ""
-#: doc/classes/ProjectSettings.xml:656
+#: doc/classes/ProjectSettings.xml:657
msgid "Optional name for the 2D render layer 4."
msgstr ""
-#: doc/classes/ProjectSettings.xml:659
+#: doc/classes/ProjectSettings.xml:660
msgid "Optional name for the 2D render layer 5."
msgstr ""
-#: doc/classes/ProjectSettings.xml:662
+#: doc/classes/ProjectSettings.xml:663
msgid "Optional name for the 2D render layer 6."
msgstr ""
-#: doc/classes/ProjectSettings.xml:665
+#: doc/classes/ProjectSettings.xml:666
msgid "Optional name for the 2D render layer 7."
msgstr ""
-#: doc/classes/ProjectSettings.xml:668
+#: doc/classes/ProjectSettings.xml:669
msgid "Optional name for the 2D render layer 8."
msgstr ""
-#: doc/classes/ProjectSettings.xml:671
+#: doc/classes/ProjectSettings.xml:672
msgid "Optional name for the 2D render layer 9."
msgstr ""
-#: doc/classes/ProjectSettings.xml:674
+#: doc/classes/ProjectSettings.xml:675
msgid "Optional name for the 3D physics layer 1."
msgstr ""
-#: doc/classes/ProjectSettings.xml:677
+#: doc/classes/ProjectSettings.xml:678
msgid "Optional name for the 3D physics layer 10."
msgstr ""
-#: doc/classes/ProjectSettings.xml:680
+#: doc/classes/ProjectSettings.xml:681
msgid "Optional name for the 3D physics layer 11."
msgstr ""
-#: doc/classes/ProjectSettings.xml:683
+#: doc/classes/ProjectSettings.xml:684
msgid "Optional name for the 3D physics layer 12."
msgstr ""
-#: doc/classes/ProjectSettings.xml:686
+#: doc/classes/ProjectSettings.xml:687
msgid "Optional name for the 3D physics layer 13."
msgstr ""
-#: doc/classes/ProjectSettings.xml:689
+#: doc/classes/ProjectSettings.xml:690
msgid "Optional name for the 3D physics layer 14."
msgstr ""
-#: doc/classes/ProjectSettings.xml:692
+#: doc/classes/ProjectSettings.xml:693
msgid "Optional name for the 3D physics layer 15."
msgstr ""
-#: doc/classes/ProjectSettings.xml:695
+#: doc/classes/ProjectSettings.xml:696
msgid "Optional name for the 3D physics layer 16."
msgstr ""
-#: doc/classes/ProjectSettings.xml:698
+#: doc/classes/ProjectSettings.xml:699
msgid "Optional name for the 3D physics layer 17."
msgstr ""
-#: doc/classes/ProjectSettings.xml:701
+#: doc/classes/ProjectSettings.xml:702
msgid "Optional name for the 3D physics layer 18."
msgstr ""
-#: doc/classes/ProjectSettings.xml:704
+#: doc/classes/ProjectSettings.xml:705
msgid "Optional name for the 3D physics layer 19."
msgstr ""
-#: doc/classes/ProjectSettings.xml:707
+#: doc/classes/ProjectSettings.xml:708
msgid "Optional name for the 3D physics layer 2."
msgstr ""
-#: doc/classes/ProjectSettings.xml:710
+#: doc/classes/ProjectSettings.xml:711
msgid "Optional name for the 3D physics layer 20."
msgstr ""
-#: doc/classes/ProjectSettings.xml:713
+#: doc/classes/ProjectSettings.xml:714
msgid "Optional name for the 3D physics layer 3."
msgstr ""
-#: doc/classes/ProjectSettings.xml:716
+#: doc/classes/ProjectSettings.xml:717
msgid "Optional name for the 3D physics layer 4."
msgstr ""
-#: doc/classes/ProjectSettings.xml:719
+#: doc/classes/ProjectSettings.xml:720
msgid "Optional name for the 3D physics layer 5."
msgstr ""
-#: doc/classes/ProjectSettings.xml:722
+#: doc/classes/ProjectSettings.xml:723
msgid "Optional name for the 3D physics layer 6."
msgstr ""
-#: doc/classes/ProjectSettings.xml:725
+#: doc/classes/ProjectSettings.xml:726
msgid "Optional name for the 3D physics layer 7."
msgstr ""
-#: doc/classes/ProjectSettings.xml:728
+#: doc/classes/ProjectSettings.xml:729
msgid "Optional name for the 3D physics layer 8."
msgstr ""
-#: doc/classes/ProjectSettings.xml:731
+#: doc/classes/ProjectSettings.xml:732
msgid "Optional name for the 3D physics layer 9."
msgstr ""
-#: doc/classes/ProjectSettings.xml:734
+#: doc/classes/ProjectSettings.xml:735
msgid "Optional name for the 3D render layer 1."
msgstr ""
-#: doc/classes/ProjectSettings.xml:737
+#: doc/classes/ProjectSettings.xml:738
msgid "Optional name for the 3D render layer 10."
msgstr ""
-#: doc/classes/ProjectSettings.xml:740
+#: doc/classes/ProjectSettings.xml:741
msgid "Optional name for the 3D render layer 11."
msgstr ""
-#: doc/classes/ProjectSettings.xml:743
+#: doc/classes/ProjectSettings.xml:744
msgid "Optional name for the 3D render layer 12."
msgstr ""
-#: doc/classes/ProjectSettings.xml:746
+#: doc/classes/ProjectSettings.xml:747
msgid "Optional name for the 3D render layer 13."
msgstr ""
-#: doc/classes/ProjectSettings.xml:749
+#: doc/classes/ProjectSettings.xml:750
msgid "Optional name for the 3D render layer 14"
msgstr ""
-#: doc/classes/ProjectSettings.xml:752
+#: doc/classes/ProjectSettings.xml:753
msgid "Optional name for the 3D render layer 15."
msgstr ""
-#: doc/classes/ProjectSettings.xml:755
+#: doc/classes/ProjectSettings.xml:756
msgid "Optional name for the 3D render layer 16."
msgstr ""
-#: doc/classes/ProjectSettings.xml:758
+#: doc/classes/ProjectSettings.xml:759
msgid "Optional name for the 3D render layer 17."
msgstr ""
-#: doc/classes/ProjectSettings.xml:761
+#: doc/classes/ProjectSettings.xml:762
msgid "Optional name for the 3D render layer 18."
msgstr ""
-#: doc/classes/ProjectSettings.xml:764
+#: doc/classes/ProjectSettings.xml:765
msgid "Optional name for the 3D render layer 19."
msgstr ""
-#: doc/classes/ProjectSettings.xml:767
+#: doc/classes/ProjectSettings.xml:768
msgid "Optional name for the 3D render layer 2."
msgstr ""
-#: doc/classes/ProjectSettings.xml:770
+#: doc/classes/ProjectSettings.xml:771
msgid "Optional name for the 3D render layer 20."
msgstr ""
-#: doc/classes/ProjectSettings.xml:773
+#: doc/classes/ProjectSettings.xml:774
msgid "Optional name for the 3D render layer 3."
msgstr ""
-#: doc/classes/ProjectSettings.xml:776
+#: doc/classes/ProjectSettings.xml:777
msgid "Optional name for the 3D render layer 4."
msgstr ""
-#: doc/classes/ProjectSettings.xml:779
+#: doc/classes/ProjectSettings.xml:780
msgid "Optional name for the 3D render layer 5."
msgstr ""
-#: doc/classes/ProjectSettings.xml:782
+#: doc/classes/ProjectSettings.xml:783
msgid "Optional name for the 3D render layer 6."
msgstr ""
-#: doc/classes/ProjectSettings.xml:785
+#: doc/classes/ProjectSettings.xml:786
msgid "Optional name for the 3D render layer 7."
msgstr ""
-#: doc/classes/ProjectSettings.xml:788
+#: doc/classes/ProjectSettings.xml:789
msgid "Optional name for the 3D render layer 8."
msgstr ""
-#: doc/classes/ProjectSettings.xml:791
+#: doc/classes/ProjectSettings.xml:792
msgid "Optional name for the 3D render layer 9."
msgstr ""
-#: doc/classes/ProjectSettings.xml:794
+#: doc/classes/ProjectSettings.xml:795
msgid ""
"The locale to fall back to if a translation isn't available in a given "
"language. If left empty, [code]en[/code] (English) will be used."
msgstr ""
-#: doc/classes/ProjectSettings.xml:797
+#: doc/classes/ProjectSettings.xml:798
msgid ""
"If non-empty, this locale will be used when running the project from the "
"editor."
msgstr ""
-#: doc/classes/ProjectSettings.xml:800
+#: doc/classes/ProjectSettings.xml:801
msgid "If [code]true[/code], logs all output to files."
msgstr ""
-#: doc/classes/ProjectSettings.xml:803
+#: doc/classes/ProjectSettings.xml:806
msgid ""
"Path to logs within the project. Using an [code]user://[/code] path is "
"recommended."
msgstr ""
-#: doc/classes/ProjectSettings.xml:806
+#: doc/classes/ProjectSettings.xml:809
msgid "Specifies the maximum amount of log files allowed (used for rotation)."
msgstr ""
-#: doc/classes/ProjectSettings.xml:809
+#: doc/classes/ProjectSettings.xml:812
msgid ""
"Godot uses a message queue to defer some function calls. If you run out of "
"space on it (you will see an error), you can increase the size here."
msgstr ""
-#: doc/classes/ProjectSettings.xml:812
+#: doc/classes/ProjectSettings.xml:815
msgid ""
"This is used by servers when used in multi-threading mode (servers and "
"visual). RIDs are preallocated to avoid stalling the server requesting them "
@@ -39733,56 +40621,56 @@ msgid ""
"thread, increase this number."
msgstr ""
-#: doc/classes/ProjectSettings.xml:829
+#: doc/classes/ProjectSettings.xml:832
msgid ""
"Maximum amount of characters allowed to send as output from the debugger. "
"Over this value, content is dropped. This helps not to stall the debugger "
"connection."
msgstr ""
-#: doc/classes/ProjectSettings.xml:832
+#: doc/classes/ProjectSettings.xml:835
msgid ""
"Maximum number of errors allowed to be sent from the debugger. Over this "
"value, content is dropped. This helps not to stall the debugger connection."
msgstr ""
-#: doc/classes/ProjectSettings.xml:835
+#: doc/classes/ProjectSettings.xml:838
msgid ""
"Maximum amount of messages in the debugger queue. Over this value, content "
"is dropped. This helps to limit the debugger memory usage."
msgstr ""
-#: doc/classes/ProjectSettings.xml:838
+#: doc/classes/ProjectSettings.xml:841
msgid ""
"Maximum number of warnings allowed to be sent from the debugger. Over this "
"value, content is dropped. This helps not to stall the debugger connection."
msgstr ""
-#: doc/classes/ProjectSettings.xml:841
+#: doc/classes/ProjectSettings.xml:844
msgid ""
"Default size of packet peer stream for deserializing Godot data. Over this "
"size, data is dropped."
msgstr ""
-#: doc/classes/ProjectSettings.xml:844
+#: doc/classes/ProjectSettings.xml:847
msgid "Timeout (in seconds) for connection attempts using TCP."
msgstr ""
-#: doc/classes/ProjectSettings.xml:847
+#: doc/classes/ProjectSettings.xml:850
msgid "Maximum size (in kiB) for the [WebRTCDataChannel] input buffer."
msgstr ""
-#: doc/classes/ProjectSettings.xml:850
+#: doc/classes/ProjectSettings.xml:853
msgid ""
"Amount of read ahead used by remote filesystem. Higher values decrease the "
"effects of latency at the cost of higher bandwidth usage."
msgstr ""
-#: doc/classes/ProjectSettings.xml:853
+#: doc/classes/ProjectSettings.xml:856
msgid "Page size used by remote filesystem (in bytes)."
msgstr ""
-#: doc/classes/ProjectSettings.xml:856
+#: doc/classes/ProjectSettings.xml:859
msgid ""
"The CA certificates bundle to use for SSL connections. If this is set to a "
"non-empty value, this will [i]override[/i] Godot's default [url=https://"
@@ -39792,31 +40680,31 @@ msgid ""
"If in doubt, leave this setting empty."
msgstr ""
-#: doc/classes/ProjectSettings.xml:860
+#: doc/classes/ProjectSettings.xml:863
msgid ""
"When creating node names automatically, set the type of casing in this "
"project. This is mostly an editor setting."
msgstr ""
-#: doc/classes/ProjectSettings.xml:863
+#: doc/classes/ProjectSettings.xml:866
msgid ""
"What to use to separate node name from number. This is mostly an editor "
"setting."
msgstr ""
-#: doc/classes/ProjectSettings.xml:866
+#: doc/classes/ProjectSettings.xml:869
msgid "Size of the hash table used for the broad-phase 2D hash grid algorithm."
msgstr ""
-#: doc/classes/ProjectSettings.xml:869
+#: doc/classes/ProjectSettings.xml:872
msgid "Cell size used for the broad-phase 2D hash grid algorithm."
msgstr ""
-#: doc/classes/ProjectSettings.xml:872
+#: doc/classes/ProjectSettings.xml:875
msgid "The default angular damp in 2D."
msgstr ""
-#: doc/classes/ProjectSettings.xml:875
+#: doc/classes/ProjectSettings.xml:878
msgid ""
"The default gravity strength in 2D.\n"
"[b]Note:[/b] This property is only read when the project starts. To change "
@@ -39828,7 +40716,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/ProjectSettings.xml:883
+#: doc/classes/ProjectSettings.xml:886
msgid ""
"The default gravity direction in 2D.\n"
"[b]Note:[/b] This property is only read when the project starts. To change "
@@ -39840,38 +40728,38 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/ProjectSettings.xml:891
+#: doc/classes/ProjectSettings.xml:894
msgid "The default linear damp in 2D."
msgstr ""
-#: doc/classes/ProjectSettings.xml:894
+#: doc/classes/ProjectSettings.xml:897
msgid ""
"Threshold defining the surface size that constitutes a large object with "
"regard to cells in the broad-phase 2D hash grid algorithm."
msgstr ""
-#: doc/classes/ProjectSettings.xml:897
+#: doc/classes/ProjectSettings.xml:900
msgid ""
"Sets which physics engine to use for 2D physics.\n"
"\"DEFAULT\" and \"GodotPhysics2D\" are the same, as there is currently no "
"alternative 2D physics server implemented."
msgstr ""
-#: doc/classes/ProjectSettings.xml:901
+#: doc/classes/ProjectSettings.xml:904
msgid ""
"Threshold angular velocity under which a 2D physics body will be considered "
"inactive. See [constant PhysicsServer2D."
"SPACE_PARAM_BODY_ANGULAR_VELOCITY_SLEEP_THRESHOLD]."
msgstr ""
-#: doc/classes/ProjectSettings.xml:904
+#: doc/classes/ProjectSettings.xml:907
msgid ""
"Threshold linear velocity under which a 2D physics body will be considered "
"inactive. See [constant PhysicsServer2D."
"SPACE_PARAM_BODY_LINEAR_VELOCITY_SLEEP_THRESHOLD]."
msgstr ""
-#: doc/classes/ProjectSettings.xml:907
+#: doc/classes/ProjectSettings.xml:910
msgid ""
"Sets whether physics is run on the main thread or a separate one. Running "
"the server on a thread increases performance, but restricts API access to "
@@ -39881,23 +40769,23 @@ msgid ""
"give you extra performance and no regressions when using it."
msgstr ""
-#: doc/classes/ProjectSettings.xml:911
+#: doc/classes/ProjectSettings.xml:914
msgid ""
"Time (in seconds) of inactivity before which a 2D physics body will put to "
"sleep. See [constant PhysicsServer2D.SPACE_PARAM_BODY_TIME_TO_SLEEP]."
msgstr ""
-#: doc/classes/ProjectSettings.xml:914
+#: doc/classes/ProjectSettings.xml:917
msgid ""
"Sets whether the 3D physics world will be created with support for "
"[SoftBody3D] physics. Only applies to the Bullet physics engine."
msgstr ""
-#: doc/classes/ProjectSettings.xml:917
+#: doc/classes/ProjectSettings.xml:920
msgid "The default angular damp in 3D."
msgstr ""
-#: doc/classes/ProjectSettings.xml:920
+#: doc/classes/ProjectSettings.xml:923
msgid ""
"The default gravity strength in 3D.\n"
"[b]Note:[/b] This property is only read when the project starts. To change "
@@ -39909,7 +40797,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/ProjectSettings.xml:928
+#: doc/classes/ProjectSettings.xml:931
msgid ""
"The default gravity direction in 3D.\n"
"[b]Note:[/b] This property is only read when the project starts. To change "
@@ -39921,11 +40809,11 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/ProjectSettings.xml:936
+#: doc/classes/ProjectSettings.xml:939
msgid "The default linear damp in 3D."
msgstr ""
-#: doc/classes/ProjectSettings.xml:939
+#: doc/classes/ProjectSettings.xml:942
msgid ""
"Sets which physics engine to use for 3D physics.\n"
"\"DEFAULT\" is currently the [url=https://bulletphysics.org]Bullet[/url] "
@@ -39933,11 +40821,11 @@ msgid ""
"alternative."
msgstr ""
-#: doc/classes/ProjectSettings.xml:943
+#: doc/classes/ProjectSettings.xml:946
msgid "Enables [member Viewport.physics_object_picking] on the root viewport."
msgstr ""
-#: doc/classes/ProjectSettings.xml:946
+#: doc/classes/ProjectSettings.xml:949
msgid ""
"The number of fixed iterations per second. This controls how often physics "
"simulation and [method Node._physics_process] methods are run.\n"
@@ -39946,7 +40834,7 @@ msgid ""
"instead."
msgstr ""
-#: doc/classes/ProjectSettings.xml:950
+#: doc/classes/ProjectSettings.xml:953
msgid ""
"Fix to improve physics jitter, specially on monitors where refresh rate is "
"different than the physics FPS.\n"
@@ -39954,7 +40842,7 @@ msgid ""
"the physics FPS at runtime, set [member Engine.physics_jitter_fix] instead."
msgstr ""
-#: doc/classes/ProjectSettings.xml:954
+#: doc/classes/ProjectSettings.xml:957
msgid ""
"Default background clear color. Overridable per [Viewport] using its "
"[Environment]. See [member Environment.background_mode] and [member "
@@ -39962,7 +40850,7 @@ msgid ""
"programmatically, use [method RenderingServer.set_default_clear_color]."
msgstr ""
-#: doc/classes/ProjectSettings.xml:957
+#: doc/classes/ProjectSettings.xml:960
msgid ""
"[Environment] that will be used as a fallback environment in case a scene "
"does not specify its own environment. The default environment is loaded in "
@@ -39972,14 +40860,14 @@ msgid ""
"here."
msgstr ""
-#: doc/classes/ProjectSettings.xml:986
+#: doc/classes/ProjectSettings.xml:989
msgid ""
"Max amount of elements renderable in a frame. If more than this are visible "
"per frame, they will be dropped. Keep in mind elements refer to mesh "
"surfaces and not meshes themselves."
msgstr ""
-#: doc/classes/ProjectSettings.xml:991
+#: doc/classes/ProjectSettings.xml:994
msgid ""
"Some NVIDIA GPU drivers have a bug which produces flickering issues for the "
"[code]draw_rect[/code] method, especially as used in [TileMap]. Refer to "
@@ -39991,73 +40879,73 @@ msgid ""
"using the Vulkan backend."
msgstr ""
-#: doc/classes/ProjectSettings.xml:995
+#: doc/classes/ProjectSettings.xml:998
msgid ""
"If [code]true[/code], forces snapping of polygons to pixels in 2D rendering. "
"May help in some pixel art styles."
msgstr ""
-#: doc/classes/ProjectSettings.xml:998
+#: doc/classes/ProjectSettings.xml:1001
msgid ""
"Sets the quality of the depth of field effect. Higher quality takes more "
"samples, which is slower but looks smoother."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1001
+#: doc/classes/ProjectSettings.xml:1004
msgid ""
"Sets the depth of field shape. Can be Box, Hexagon, or Circle. Box is the "
"fastest. Circle is the most realistic, but also the most expensive to "
"compute."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1004
+#: doc/classes/ProjectSettings.xml:1007
msgid ""
"If [code]true[/code], jitters DOF samples to make effect slightly blurrier "
"and hide lines created from low sample rates. This can result in a slightly "
"grainy appearance when used with a low number of samples."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1007
+#: doc/classes/ProjectSettings.xml:1010
msgid ""
"Disables depth pre-pass for some GPU vendors (usually mobile), as their "
"architecture already does this."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1010
+#: doc/classes/ProjectSettings.xml:1013
msgid ""
"If [code]true[/code], performs a previous depth pass before rendering "
"materials. This increases performance in scenes with high overdraw, when "
"complex materials and lighting are used."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1013
+#: doc/classes/ProjectSettings.xml:1016
msgid ""
"The directional shadow's size in pixels. Higher values will result in "
"sharper shadows, at the cost of performance. The value will be rounded up to "
"the nearest power of 2."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1016
+#: doc/classes/ProjectSettings.xml:1019
msgid ""
"Lower-end override for [member rendering/quality/directional_shadow/size] on "
"mobile devices, due to performance concerns or driver support."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1019
+#: doc/classes/ProjectSettings.xml:1022
msgid ""
"Quality setting for shadows cast by [DirectionalLight3D]s. Higher quality "
"settings use more samples when reading from shadow maps and are thus slower. "
"Low quality settings may result in shadows looking grainy."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1022
+#: doc/classes/ProjectSettings.xml:1025
msgid ""
"Lower-end override for [member rendering/quality/directional_shadow/"
"soft_shadow_quality] on mobile devices, due to performance concerns or "
"driver support."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1025
+#: doc/classes/ProjectSettings.xml:1028
msgid ""
"The video driver to use (\"GLES2\" or \"Vulkan\").\n"
"[b]Note:[/b] The backend in use can be overridden at runtime via the [code]--"
@@ -40067,32 +40955,32 @@ msgid ""
"get_current_video_driver[/code] to query it at run-time."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1031
+#: doc/classes/ProjectSettings.xml:1034
msgid ""
"If [code]true[/code], take additional samples when rendering objects "
"affected by a [GIProbe] to reduce artifacts from only sampling in one "
"direction."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1034
+#: doc/classes/ProjectSettings.xml:1037
msgid ""
"Sets the number of cone samples taken when rendering objects affected by "
"[GIProbe]s."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1037
+#: doc/classes/ProjectSettings.xml:1040
msgid ""
"Sets how the glow effect is upscaled before being copied onto the screen. "
"Linear is faster, but looks blocky. Bicubic is slower but looks smooth."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1040
+#: doc/classes/ProjectSettings.xml:1043
msgid ""
"Lower-end override for [member rendering/quality/glow/upscale_mode] on "
"mobile devices, due to performance concerns or driver support."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1043
+#: doc/classes/ProjectSettings.xml:1046
msgid ""
"Strategy used for framebuffer allocation. The simpler it is, the less "
"resources it uses (but the less features it supports). If set to \"2D "
@@ -40102,41 +40990,41 @@ msgid ""
"be available in the [Environment]."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1046
+#: doc/classes/ProjectSettings.xml:1049
msgid ""
"Lower-end override for [member rendering/quality/intended_usage/"
"framebuffer_allocation] on mobile devices, due to performance concerns or "
"driver support."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1049
+#: doc/classes/ProjectSettings.xml:1052
msgid ""
"Number of cubemaps to store in the reflection atlas. The number of "
"[ReflectionProbe]s in a scene will be limited by this amount. A higher "
"number requires more VRAM."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1052
+#: doc/classes/ProjectSettings.xml:1055
msgid ""
"Size of cubemap faces for [ReflectionProbe]s. A higher number requires more "
"VRAM and may make reflection probe updating slower."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1055
+#: doc/classes/ProjectSettings.xml:1058
msgid ""
"Lower-end override for [member rendering/quality/reflection_atlas/"
"reflection_size] on mobile devices, due to performance concerns or driver "
"support."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1058
+#: doc/classes/ProjectSettings.xml:1061
msgid ""
"Use a higher quality variant of the fast filtering algorithm. Significantly "
"slower than using default quality, but results in smoother reflections. "
"Should only be used when the scene is especially detailed."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1061
+#: doc/classes/ProjectSettings.xml:1064
msgid ""
"Sets the number of samples to take when using importance sampling for [Sky]s "
"and [ReflectionProbe]s. A higher value will result in smoother, higher "
@@ -40146,19 +41034,19 @@ msgid ""
"environments with a high level of detail."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1064
+#: doc/classes/ProjectSettings.xml:1067
msgid ""
"Lower-end override for [member rendering/quality/reflections/ggx_samples] on "
"mobile devices, due to performance concerns or driver support."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1067
+#: doc/classes/ProjectSettings.xml:1070
msgid ""
"Limits the number of layers to use in radiance maps when using importance "
"sampling. A lower number will be slightly faster and take up less VRAM."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1070
+#: doc/classes/ProjectSettings.xml:1073
msgid ""
"If [code]true[/code], uses texture arrays instead of mipmaps for reflection "
"probes and panorama backgrounds (sky). This reduces jitter noise and "
@@ -40167,14 +41055,14 @@ msgid ""
"memory."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1073
+#: doc/classes/ProjectSettings.xml:1076
msgid ""
"Lower-end override for [member rendering/quality/reflections/"
"texture_array_reflections] on mobile devices, due to performance concerns or "
"driver support."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1076
+#: doc/classes/ProjectSettings.xml:1079
msgid ""
"Sets the number of MSAA samples to use (as a power of two). MSAA is used to "
"reduce aliasing around the edges of polygons. A higher MSAA value results in "
@@ -40182,7 +41070,7 @@ msgid ""
"[b]Note:[/b] MSAA is not available on HTML5 export using the GLES2 backend."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1080
+#: doc/classes/ProjectSettings.xml:1083
msgid ""
"Sets the screen-space antialiasing mode for the default screen [Viewport]. "
"Screen-space antialiasing works by selectively blurring edges in a post-"
@@ -40191,133 +41079,117 @@ msgid ""
"MSAA and will smooth out specular aliasing, but tend to make scenes appear "
"blurry.\n"
"Another way to combat specular aliasing is to enable [member rendering/"
-"quality/screen_filters/screen_space_roughness_limiter]."
-msgstr ""
-
-#: doc/classes/ProjectSettings.xml:1084
-msgid ""
-"Enables the screen-space roughness limiter which increases material "
-"roughness in areas with a high normal frequency (i.e. when normals change a "
-"lot from pixel to pixel). This helps to reduce the amount of specular "
-"aliasing in a scene. Specular aliasing looks like random bright pixels that "
-"occur in reflections."
+"quality/screen_filters/screen_space_roughness_limiter_enabled]."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1087
-msgid ""
-"Curves the amount of the roughness limited effect. A higher value limits the "
-"effect to very sharply curved surfaces, while a lower threshold extends the "
-"effect to smoother surfaces."
-msgstr ""
-
-#: doc/classes/ProjectSettings.xml:1090
+#: doc/classes/ProjectSettings.xml:1093
msgid ""
"Sets the quality for rough screen-space reflections. Turning off will make "
"all screen space reflections sharp, while higher values make rough "
"reflections look better."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1093
+#: doc/classes/ProjectSettings.xml:1096
msgid ""
"If [code]true[/code], uses faster but lower-quality Blinn model to generate "
"blurred reflections instead of the GGX model."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1096
+#: doc/classes/ProjectSettings.xml:1099
msgid ""
"Lower-end override for [member rendering/quality/shading/"
"force_blinn_over_ggx] on mobile devices, due to performance concerns or "
"driver support."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1099
+#: doc/classes/ProjectSettings.xml:1102
msgid ""
"If [code]true[/code], uses faster but lower-quality Lambert material "
"lighting model instead of Burley."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1102
+#: doc/classes/ProjectSettings.xml:1105
msgid ""
"Lower-end override for [member rendering/quality/shading/"
"force_lambert_over_burley] on mobile devices, due to performance concerns or "
"driver support."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1105
+#: doc/classes/ProjectSettings.xml:1108
msgid ""
"If [code]true[/code], forces vertex shading for all rendering. This can "
"increase performance a lot, but also reduces quality immensely. Can be used "
"to optimize performance on low-end mobile devices."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1108
+#: doc/classes/ProjectSettings.xml:1111
msgid ""
"Lower-end override for [member rendering/quality/shading/"
"force_vertex_shading] on mobile devices, due to performance concerns or "
"driver support."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1111 doc/classes/ProjectSettings.xml:1114
-#: doc/classes/ProjectSettings.xml:1117 doc/classes/ProjectSettings.xml:1120
+#: doc/classes/ProjectSettings.xml:1114 doc/classes/ProjectSettings.xml:1117
+#: doc/classes/ProjectSettings.xml:1120 doc/classes/ProjectSettings.xml:1123
msgid ""
"Subdivision quadrant size for shadow mapping. See shadow mapping "
"documentation."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1123
+#: doc/classes/ProjectSettings.xml:1126
msgid ""
"Size for shadow atlas (used for OmniLights and SpotLights). See "
"documentation."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1126
+#: doc/classes/ProjectSettings.xml:1129
msgid ""
"Lower-end override for [member rendering/quality/shadow_atlas/size] on "
"mobile devices, due to performance concerns or driver support."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1129
+#: doc/classes/ProjectSettings.xml:1132
msgid ""
"Quality setting for shadows cast by [OmniLight3D]s and [SpotLight3D]s. "
"Higher quality settings use more samples when reading from shadow maps and "
"are thus slower. Low quality settings may result in shadows looking grainy."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1132
+#: doc/classes/ProjectSettings.xml:1135
msgid ""
"Lower-end override for [member rendering/quality/shadows/"
"soft_shadow_quality] on mobile devices, due to performance concerns or "
"driver support."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1135
+#: doc/classes/ProjectSettings.xml:1138
msgid ""
"If [code]true[/code], screen-space ambient occlusion will be rendered at "
"half size and then upscaled before being added to the scene. This is "
"significantly faster but may miss small details."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1138
+#: doc/classes/ProjectSettings.xml:1141
msgid ""
"Sets the quality of the screen-space ambient occlusion effect. Higher values "
"take more samples and so will result in better quality, at the cost of "
"performance."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1141
+#: doc/classes/ProjectSettings.xml:1144
msgid ""
"Scales the depth over which the subsurface scattering effect is applied. A "
"high value may allow light to scatter into a part of the mesh or another "
"mesh that is close in screen space but far in depth."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1144
+#: doc/classes/ProjectSettings.xml:1147
msgid ""
"Sets the quality of the subsurface scattering effect. Higher values are "
"slower but look nicer."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1147
+#: doc/classes/ProjectSettings.xml:1150
msgid ""
"Scales the distance over which samples are taken for subsurface scattering "
"effect. Changing this does not impact performance, but higher values will "
@@ -40325,7 +41197,7 @@ msgid ""
"out. A lower value results in a smaller spread of scattered light."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1150
+#: doc/classes/ProjectSettings.xml:1153
msgid ""
"Sets the maximum number of samples to take when using anisotropic filtering "
"on textures (as a power of two). A higher sample count will result in "
@@ -40334,7 +41206,7 @@ msgid ""
"materials where it is enabled."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1153
+#: doc/classes/ProjectSettings.xml:1156
msgid ""
"If [code]true[/code], uses nearest-neighbor mipmap filtering when using "
"mipmaps (also called \"bilinear filtering\"), which will result in visible "
@@ -40343,49 +41215,49 @@ msgid ""
"mipmap filtering (also called \"trilinear filtering\") is used."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1156
+#: doc/classes/ProjectSettings.xml:1163
msgid ""
"Thread model for rendering. Rendering on a thread can vastly improve "
"performance, but synchronizing to the main thread can cause a bit more "
"jitter."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1159
+#: doc/classes/ProjectSettings.xml:1166
msgid ""
"If [code]true[/code], the texture importer will import VRAM-compressed "
"textures using the BPTC algorithm. This texture compression algorithm is "
"only supported on desktop platforms, and only when using the Vulkan renderer."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1162
+#: doc/classes/ProjectSettings.xml:1169
msgid ""
"If [code]true[/code], the texture importer will import VRAM-compressed "
"textures using the Ericsson Texture Compression algorithm. This algorithm "
"doesn't support alpha channels in textures."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1165
+#: doc/classes/ProjectSettings.xml:1172
msgid ""
"If [code]true[/code], the texture importer will import VRAM-compressed "
"textures using the Ericsson Texture Compression 2 algorithm. This texture "
"compression algorithm is only supported when using the Vulkan renderer."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1168
+#: doc/classes/ProjectSettings.xml:1175
msgid ""
"If [code]true[/code], the texture importer will import VRAM-compressed "
"textures using the PowerVR Texture Compression algorithm. This texture "
"compression algorithm is only supported on iOS."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1171
+#: doc/classes/ProjectSettings.xml:1178
msgid ""
"If [code]true[/code], the texture importer will import VRAM-compressed "
"textures using the S3 Texture Compression algorithm. This algorithm is only "
"supported on desktop platforms and consoles."
msgstr ""
-#: doc/classes/ProjectSettings.xml:1182
+#: doc/classes/ProjectSettings.xml:1189
msgid "Cell size used for the 2D hash grid that [VisibilityNotifier2D] uses."
msgstr ""
@@ -40415,13 +41287,14 @@ msgstr ""
#: doc/classes/Quat.xml:7
msgid ""
-"A unit quaternion used for representing 3D rotations.\n"
-"It is similar to [Basis], which implements matrix representation of "
-"rotations, and can be parametrized using both an axis-angle pair or Euler "
-"angles. But due to its compactness and the way it is stored in memory, "
-"certain operations (obtaining axis-angle and performing SLERP, in "
-"particular) are more efficient and robust against floating-point errors.\n"
-"Quaternions need to be (re)normalized."
+"A unit quaternion used for representing 3D rotations. Quaternions need to be "
+"normalized to be used for rotation.\n"
+"It is similar to Basis, which implements matrix representation of rotations, "
+"and can be parametrized using both an axis-angle pair or Euler angles. Basis "
+"stores rotation, scale, and shearing, while Quat only stores rotation.\n"
+"Due to its compactness and the way it is stored in memory, certain "
+"operations (obtaining axis-angle and performing SLERP, in particular) are "
+"more efficient and robust against floating-point errors."
msgstr ""
#: doc/classes/Quat.xml:12
@@ -40431,29 +41304,31 @@ msgid ""
msgstr ""
#: doc/classes/Quat.xml:21
-msgid "Returns the rotation matrix corresponding to the given quaternion."
+msgid "Constructs a quaternion from the given [Basis]."
msgstr ""
#: doc/classes/Quat.xml:30
msgid ""
-"Returns a quaternion that will perform a rotation specified by Euler angles "
-"(in the YXZ convention: first Z, then X, and Y last), given in the vector "
-"format as (X angle, Y angle, Z angle)."
+"Constructs a quaternion that will perform a rotation specified by Euler "
+"angles (in the YXZ convention: when decomposing, first Z, then X, and Y "
+"last), given in the vector format as (X angle, Y angle, Z angle)."
msgstr ""
#: doc/classes/Quat.xml:41
msgid ""
-"Returns a quaternion that will rotate around the given axis by the specified "
-"angle. The axis must be a normalized vector."
+"Constructs a quaternion that will rotate around the given axis by the "
+"specified angle. The axis must be a normalized vector."
msgstr ""
#: doc/classes/Quat.xml:56
-msgid "Returns a quaternion defined by these values."
+msgid "Constructs a quaternion defined by the given values."
msgstr ""
#: doc/classes/Quat.xml:71
msgid ""
-"Performs a cubic spherical-linear interpolation with another quaternion."
+"Performs a cubic spherical interpolation between quaternions [code]preA[/"
+"code], this vector, [code]b[/code], and [code]postB[/code], by the given "
+"amount [code]t[/code]."
msgstr ""
#: doc/classes/Quat.xml:80
@@ -40462,10 +41337,10 @@ msgstr ""
#: doc/classes/Quat.xml:87
msgid ""
-"Returns Euler angles (in the YXZ convention: first Z, then X, and Y last) "
-"corresponding to the rotation represented by the unit quaternion. Returned "
-"vector contains the rotation angles in the format (X angle, Y angle, Z "
-"angle)."
+"Returns Euler angles (in the YXZ convention: when decomposing, first Z, then "
+"X, and Y last) corresponding to the rotation represented by the unit "
+"quaternion. Returned vector contains the rotation angles in the format (X "
+"angle, Y angle, Z angle)."
msgstr ""
#: doc/classes/Quat.xml:94
@@ -40504,44 +41379,57 @@ msgstr ""
#: doc/classes/Quat.xml:151
msgid ""
"Sets the quaternion to a rotation specified by Euler angles (in the YXZ "
-"convention: first Z, then X, and Y last), given in the vector format as (X "
-"angle, Y angle, Z angle)."
+"convention: when decomposing, first Z, then X, and Y last), given in the "
+"vector format as (X angle, Y angle, Z angle)."
msgstr ""
#: doc/classes/Quat.xml:162
-msgid "Performs a spherical-linear interpolation with another quaternion."
+msgid ""
+"Returns the result of the spherical linear interpolation between this "
+"quaternion and [code]to[/code] by amount [code]weight[/code].\n"
+"[b]Note:[/b] Both quaternions must be normalized."
msgstr ""
-#: doc/classes/Quat.xml:173
+#: doc/classes/Quat.xml:174
msgid ""
-"Performs a spherical-linear interpolation with another quaterion without "
-"checking if the rotation path is not bigger than 90°."
+"Returns the result of the spherical linear interpolation between this "
+"quaternion and [code]to[/code] by amount [code]weight[/code], but without "
+"checking if the rotation path is not bigger than 90 degrees."
msgstr ""
-#: doc/classes/Quat.xml:182
-msgid "Transforms the vector [code]v[/code] by this quaternion."
+#: doc/classes/Quat.xml:183
+msgid "Returns a vector transformed (multiplied) by this quaternion."
msgstr ""
-#: doc/classes/Quat.xml:188
-msgid "W component of the quaternion."
+#: doc/classes/Quat.xml:189
+msgid ""
+"W component of the quaternion (real part).\n"
+"Quaternion components should usually not be manipulated directly."
msgstr ""
-#: doc/classes/Quat.xml:191
-msgid "X component of the quaternion."
+#: doc/classes/Quat.xml:193
+msgid ""
+"X component of the quaternion (imaginary [code]i[/code] axis part).\n"
+"Quaternion components should usually not be manipulated directly."
msgstr ""
-#: doc/classes/Quat.xml:194
-msgid "Y component of the quaternion."
+#: doc/classes/Quat.xml:197
+msgid ""
+"Y component of the quaternion (imaginary [code]j[/code] axis part).\n"
+"Quaternion components should usually not be manipulated directly."
msgstr ""
-#: doc/classes/Quat.xml:197
-msgid "Z component of the quaternion."
+#: doc/classes/Quat.xml:201
+msgid ""
+"Z component of the quaternion (imaginary [code]k[/code] axis part).\n"
+"Quaternion components should usually not be manipulated directly."
msgstr ""
-#: doc/classes/Quat.xml:202
+#: doc/classes/Quat.xml:207
msgid ""
-"The identity rotation. Equivalent to an identity matrix. If a vector is "
-"transformed by an identity quaternion, it will not change."
+"The identity quaternion, representing no rotation. Equivalent to an identity "
+"[Basis] matrix. If a vector is transformed by an identity quaternion, it "
+"will not change."
msgstr ""
#: doc/classes/RandomNumberGenerator.xml:4
@@ -40744,7 +41632,8 @@ msgid ""
"collision information immediately instead of waiting for the next "
"[code]_physics_process[/code] call, for example if the ray or its parent has "
"changed state.\n"
-"[b]Note:[/b] [code]enabled == true[/code] is not required for this to work."
+"[b]Note:[/b] [member enabled] does not need to be [code]true[/code] for this "
+"to work."
msgstr ""
#: doc/classes/RayCast2D.xml:54 doc/classes/RayCast3D.xml:55
@@ -40850,7 +41739,8 @@ msgid ""
"Use this method to update the collision information immediately instead of "
"waiting for the next [code]_physics_process[/code] call, for example if the "
"ray or its parent has changed state.\n"
-"[b]Note:[/b] [code]enabled == true[/code] is not required for this to work."
+"[b]Note:[/b] [member enabled] does not need to be [code]true[/code] for this "
+"to work."
msgstr ""
#: doc/classes/RayCast3D.xml:71
@@ -41008,14 +41898,6 @@ msgstr ""
msgid "Returns a larger [Rect2] that contains this [Rect2] and [code]b[/code]."
msgstr ""
-#: doc/classes/Rect2.xml:174 doc/classes/Rect2i.xml:163
-msgid "Ending corner."
-msgstr ""
-
-#: doc/classes/Rect2.xml:177 doc/classes/Rect2i.xml:166
-msgid "Position (starting corner)."
-msgstr ""
-
#: doc/classes/Rect2i.xml:4
msgid "2D axis-aligned bounding box using integer coordinates."
msgstr ""
@@ -41128,22 +42010,22 @@ msgstr ""
msgid ""
"Base class for any object that keeps a reference count. [Resource] and many "
"other helper objects inherit this class.\n"
-"References keep an internal reference counter so that they are automatically "
-"released when no longer in use, and only then. References therefore do not "
-"need to be freed manually with [method Object.free].\n"
+"Unlike [Object]s, References keep an internal reference counter so that they "
+"are automatically released when no longer in use, and only then. References "
+"therefore do not need to be freed manually with [method Object.free].\n"
"In the vast majority of use cases, instantiating and using [Reference]-"
"derived types is all you need to do. The methods provided in this class are "
"only for advanced users, and can cause issues if misused."
msgstr ""
-#: doc/classes/Reference.xml:18
+#: doc/classes/Reference.xml:19
msgid ""
"Initializes the internal reference counter. Use this only if you really know "
"what you are doing.\n"
"Returns whether the initialization was successful."
msgstr ""
-#: doc/classes/Reference.xml:26
+#: doc/classes/Reference.xml:27
msgid ""
"Increments the internal reference counter. Use this only if you really know "
"what you are doing.\n"
@@ -41151,7 +42033,7 @@ msgid ""
"code] otherwise."
msgstr ""
-#: doc/classes/Reference.xml:34
+#: doc/classes/Reference.xml:35
msgid ""
"Decrements the internal reference counter. Use this only if you really know "
"what you are doing.\n"
@@ -41200,14 +42082,14 @@ msgid ""
"https://docs.godotengine.org/en/latest/tutorials/3d/reflection_probes.html"
msgstr ""
-#: doc/classes/ReflectionProbe.xml:17
+#: doc/classes/ReflectionProbe.xml:23
msgid ""
"If [code]true[/code], enables box projection. This makes reflections look "
"more correct in rectangle-shaped rooms by offsetting the reflection center "
"depending on the camera's location."
msgstr ""
-#: doc/classes/ReflectionProbe.xml:20
+#: doc/classes/ReflectionProbe.xml:26
msgid ""
"Sets the cull mask which determines what objects are drawn by this probe. "
"Every [VisualInstance3D] with a layer included in this cull mask will be "
@@ -41216,78 +42098,56 @@ msgid ""
"rendering cost."
msgstr ""
-#: doc/classes/ReflectionProbe.xml:23
+#: doc/classes/ReflectionProbe.xml:29
msgid ""
"If [code]true[/code], computes shadows in the reflection probe. This makes "
"the reflection probe slower to render; you may want to disable this if using "
"the [constant UPDATE_ALWAYS] [member update_mode]."
msgstr ""
-#: doc/classes/ReflectionProbe.xml:26
+#: doc/classes/ReflectionProbe.xml:32
msgid ""
"The size of the reflection probe. The larger the extents the more space "
"covered by the probe which will lower the perceived resolution. It is best "
"to keep the extents only as large as you need them."
msgstr ""
-#: doc/classes/ReflectionProbe.xml:29
+#: doc/classes/ReflectionProbe.xml:35
msgid ""
"Defines the reflection intensity. Intensity modulates the strength of the "
"reflection."
msgstr ""
-#: doc/classes/ReflectionProbe.xml:32
-msgid ""
-"Sets the ambient light color to be used when this probe is set to [member "
-"interior_enable]."
-msgstr ""
-
-#: doc/classes/ReflectionProbe.xml:35
-msgid ""
-"Sets the contribution value for how much the reflection affects the ambient "
-"light for this reflection probe when set to [member interior_enable]. Useful "
-"so that ambient light matches the color of the room."
-msgstr ""
-
#: doc/classes/ReflectionProbe.xml:38
-msgid ""
-"Sets the energy multiplier for this reflection probe's ambient light "
-"contribution when set to [member interior_enable]."
+msgid "If [code]true[/code], reflections will ignore sky contribution."
msgstr ""
#: doc/classes/ReflectionProbe.xml:41
msgid ""
-"If [code]true[/code], reflections will ignore sky contribution. Ambient "
-"lighting is then controlled by the [code]interior_ambient_*[/code] "
-"properties."
-msgstr ""
-
-#: doc/classes/ReflectionProbe.xml:44
-msgid ""
"Sets the max distance away from the probe an object can be before it is "
"culled."
msgstr ""
-#: doc/classes/ReflectionProbe.xml:47
+#: doc/classes/ReflectionProbe.xml:44
msgid ""
"Sets the origin offset to be used when this reflection probe is in box "
"project mode."
msgstr ""
-#: doc/classes/ReflectionProbe.xml:50
+#: doc/classes/ReflectionProbe.xml:47
msgid ""
"Sets how frequently the probe is updated. Can be [constant UPDATE_ONCE] or "
"[constant UPDATE_ALWAYS]."
msgstr ""
-#: doc/classes/ReflectionProbe.xml:55
+#: doc/classes/ReflectionProbe.xml:52
msgid ""
"Update the probe once on the next frame. The corresponding radiance map will "
"be generated over the following six frames. This is slower to update than "
"[constant UPDATE_ALWAYS] but can result in higher quality reflections."
msgstr ""
-#: doc/classes/ReflectionProbe.xml:58
+#: doc/classes/ReflectionProbe.xml:55
msgid ""
"Update the probe every frame. This is needed when you want to capture "
"dynamic objects. However, it results in an increased render time. Use "
@@ -41317,10 +42177,10 @@ msgid ""
"read by RegEx as [code]\\d+[/code]. Similarly, [code]compile(\"\\\"(?:\\\\\\"
"\\.|[^\\\"])*\\\"\")[/code] would be read as [code]\"(?:\\\\.|[^\"])*\"[/"
"code].\n"
-"Using [method search] you can find the pattern within the given text. If a "
+"Using [method search], you can find the pattern within the given text. If a "
"pattern is found, [RegExMatch] is returned and you can retrieve details of "
-"the results using functions such as [method RegExMatch.get_string] and "
-"[method RegExMatch.get_start].\n"
+"the results using methods such as [method RegExMatch.get_string] and [method "
+"RegExMatch.get_start].\n"
"[codeblock]\n"
"var regex = RegEx.new()\n"
"regex.compile(\"\\\\w-(\\\\d+)\")\n"
@@ -41329,7 +42189,7 @@ msgid ""
" print(result.get_string()) # Would print n-0123\n"
"[/codeblock]\n"
"The results of capturing groups [code]()[/code] can be retrieved by passing "
-"the group number to the various functions in [RegExMatch]. Group 0 is the "
+"the group number to the various methods in [RegExMatch]. Group 0 is the "
"default and will always refer to the entire pattern. In the above example, "
"calling [code]result.get_string(1)[/code] would give you [code]0123[/code].\n"
"This version of RegEx also supports named capturing groups, and the names "
@@ -41350,6 +42210,15 @@ msgid ""
" print(result.get_string(\"digit\"))\n"
"# Would print 01 03 0 3f 42\n"
"[/codeblock]\n"
+"[b]Example of splitting a string using a RegEx:[/b]\n"
+"[codeblock]\n"
+"var regex = RegEx.new()\n"
+"regex.compile(\"\\\\S+\") # Negated whitespace character class.\n"
+"var results = []\n"
+"for match in regex.search_all(\"One Two \\n\\tThree\"):\n"
+" results.push_back(match.get_string())\n"
+"# The `results` array now contains \"One\", \"Two\", \"Three\".\n"
+"[/codeblock]\n"
"[b]Note:[/b] Godot's regex implementation is based on the [url=https://www."
"pcre.org/]PCRE2[/url] library. You can view the full pattern reference "
"[url=https://www.pcre.org/current/doc/html/pcre2pattern.html]here[/url].\n"
@@ -41357,38 +42226,38 @@ msgid ""
"regular expressions online."
msgstr ""
-#: modules/regex/doc_classes/RegEx.xml:47
+#: modules/regex/doc_classes/RegEx.xml:56
msgid ""
"This method resets the state of the object, as if it was freshly created. "
"Namely, it unassigns the regular expression of this object."
msgstr ""
-#: modules/regex/doc_classes/RegEx.xml:56
+#: modules/regex/doc_classes/RegEx.xml:65
msgid ""
"Compiles and assign the search pattern to use. Returns [constant OK] if the "
"compilation is successful. If an error is encountered, details are printed "
"to standard output and an error is returned."
msgstr ""
-#: modules/regex/doc_classes/RegEx.xml:63
+#: modules/regex/doc_classes/RegEx.xml:72
msgid "Returns the number of capturing groups in compiled pattern."
msgstr ""
-#: modules/regex/doc_classes/RegEx.xml:70
+#: modules/regex/doc_classes/RegEx.xml:79
msgid ""
"Returns an array of names of named capturing groups in the compiled pattern. "
"They are ordered by appearance."
msgstr ""
-#: modules/regex/doc_classes/RegEx.xml:77
+#: modules/regex/doc_classes/RegEx.xml:86
msgid "Returns the original search pattern that was compiled."
msgstr ""
-#: modules/regex/doc_classes/RegEx.xml:84
+#: modules/regex/doc_classes/RegEx.xml:93
msgid "Returns whether this object has a valid search pattern assigned."
msgstr ""
-#: modules/regex/doc_classes/RegEx.xml:97
+#: modules/regex/doc_classes/RegEx.xml:106
msgid ""
"Searches the text for the compiled pattern. Returns a [RegExMatch] container "
"of the first matching result if found, otherwise [code]null[/code]. The "
@@ -41396,7 +42265,7 @@ msgid ""
"and end anchor would be."
msgstr ""
-#: modules/regex/doc_classes/RegEx.xml:110
+#: modules/regex/doc_classes/RegEx.xml:119
msgid ""
"Searches the text for the compiled pattern. Returns an array of [RegExMatch] "
"containers for each non-overlapping result. If no results were found, an "
@@ -41404,7 +42273,7 @@ msgid ""
"specified without modifying where the start and end anchor would be."
msgstr ""
-#: modules/regex/doc_classes/RegEx.xml:127
+#: modules/regex/doc_classes/RegEx.xml:136
msgid ""
"Searches the text for the compiled pattern and replaces it with the "
"specified string. Escapes and backreferences such as [code]$1[/code] and "
@@ -42131,7 +43000,7 @@ msgid ""
msgstr ""
#: doc/classes/RenderingServer.xml:1222 doc/classes/RenderingServer.xml:1250
-#: doc/classes/RenderingServer.xml:1527
+#: doc/classes/RenderingServer.xml:1537
msgid "Not implemented in Godot 3.x."
msgstr ""
@@ -42278,30 +43147,30 @@ msgid ""
"OmniLight3D.omni_shadow_mode]."
msgstr ""
-#: doc/classes/RenderingServer.xml:1481
+#: doc/classes/RenderingServer.xml:1491
msgid ""
"Sets the color of the light. Equivalent to [member Light3D.light_color]."
msgstr ""
-#: doc/classes/RenderingServer.xml:1492
+#: doc/classes/RenderingServer.xml:1502
msgid ""
"Sets the cull mask for this Light3D. Lights only affect objects in the "
"selected layers. Equivalent to [member Light3D.light_cull_mask]."
msgstr ""
-#: doc/classes/RenderingServer.xml:1503
+#: doc/classes/RenderingServer.xml:1513
msgid ""
"If [code]true[/code], light will subtract light instead of adding light. "
"Equivalent to [member Light3D.light_negative]."
msgstr ""
-#: doc/classes/RenderingServer.xml:1516
+#: doc/classes/RenderingServer.xml:1526
msgid ""
"Sets the specified light parameter. See [enum LightParam] for options. "
"Equivalent to [method Light3D.set_param]."
msgstr ""
-#: doc/classes/RenderingServer.xml:1538
+#: doc/classes/RenderingServer.xml:1548
msgid ""
"If [code]true[/code], reverses the backface culling of the mesh. This can be "
"useful when you have a flat mesh that has a light behind it. If you need to "
@@ -42310,29 +43179,25 @@ msgid ""
"to [member Light3D.shadow_reverse_cull_face]."
msgstr ""
-#: doc/classes/RenderingServer.xml:1549
+#: doc/classes/RenderingServer.xml:1559
msgid ""
"If [code]true[/code], light will cast shadows. Equivalent to [member Light3D."
"shadow_enabled]."
msgstr ""
-#: doc/classes/RenderingServer.xml:1560
+#: doc/classes/RenderingServer.xml:1570
msgid ""
"Sets the color of the shadow cast by the light. Equivalent to [member "
"Light3D.shadow_color]."
msgstr ""
-#: doc/classes/RenderingServer.xml:1571
-msgid "Sets whether GI probes capture light information from this light."
-msgstr ""
-
-#: doc/classes/RenderingServer.xml:1584
+#: doc/classes/RenderingServer.xml:1583
msgid ""
"Returns a mesh of a sphere with the given amount of horizontal and vertical "
"subdivisions."
msgstr ""
-#: doc/classes/RenderingServer.xml:1591
+#: doc/classes/RenderingServer.xml:1590
msgid ""
"Creates an empty material and adds it to the RenderingServer. It can be "
"accessed with the RID that is returned. This RID will be used in all "
@@ -42341,31 +43206,31 @@ msgid ""
"RenderingServer's [method free_rid] static method."
msgstr ""
-#: doc/classes/RenderingServer.xml:1603
+#: doc/classes/RenderingServer.xml:1602
msgid "Returns the value of a certain material's parameter."
msgstr ""
-#: doc/classes/RenderingServer.xml:1614
+#: doc/classes/RenderingServer.xml:1613
msgid "Sets an object's next material."
msgstr ""
-#: doc/classes/RenderingServer.xml:1627
+#: doc/classes/RenderingServer.xml:1626
msgid "Sets a material's parameter."
msgstr ""
-#: doc/classes/RenderingServer.xml:1638
+#: doc/classes/RenderingServer.xml:1637
msgid "Sets a material's render priority."
msgstr ""
-#: doc/classes/RenderingServer.xml:1649
+#: doc/classes/RenderingServer.xml:1648
msgid "Sets a shader material's shader."
msgstr ""
-#: doc/classes/RenderingServer.xml:1678
+#: doc/classes/RenderingServer.xml:1677
msgid "Removes all surfaces from a mesh."
msgstr ""
-#: doc/classes/RenderingServer.xml:1685
+#: doc/classes/RenderingServer.xml:1684
msgid ""
"Creates a new mesh and adds it to the RenderingServer. It can be accessed "
"with the RID that is returned. This RID will be used in all [code]mesh_*[/"
@@ -42376,58 +43241,58 @@ msgid ""
"instance_set_base] using the returned RID."
msgstr ""
-#: doc/classes/RenderingServer.xml:1696
+#: doc/classes/RenderingServer.xml:1695
msgid "Returns a mesh's blend shape count."
msgstr ""
-#: doc/classes/RenderingServer.xml:1705
+#: doc/classes/RenderingServer.xml:1704
msgid "Returns a mesh's blend shape mode."
msgstr ""
-#: doc/classes/RenderingServer.xml:1714
+#: doc/classes/RenderingServer.xml:1713
msgid "Returns a mesh's custom aabb."
msgstr ""
-#: doc/classes/RenderingServer.xml:1723
+#: doc/classes/RenderingServer.xml:1722
msgid "Returns a mesh's number of surfaces."
msgstr ""
-#: doc/classes/RenderingServer.xml:1734
+#: doc/classes/RenderingServer.xml:1733
msgid "Sets a mesh's blend shape mode."
msgstr ""
-#: doc/classes/RenderingServer.xml:1745
+#: doc/classes/RenderingServer.xml:1744
msgid "Sets a mesh's custom aabb."
msgstr ""
-#: doc/classes/RenderingServer.xml:1756
+#: doc/classes/RenderingServer.xml:1755
msgid "Returns a mesh's surface's buffer arrays."
msgstr ""
-#: doc/classes/RenderingServer.xml:1767
+#: doc/classes/RenderingServer.xml:1766
msgid "Returns a mesh's surface's arrays for blend shapes."
msgstr ""
-#: doc/classes/RenderingServer.xml:1782 doc/classes/RenderingServer.xml:1795
+#: doc/classes/RenderingServer.xml:1781 doc/classes/RenderingServer.xml:1794
msgid "Function is unused in Godot 3.x."
msgstr ""
-#: doc/classes/RenderingServer.xml:1806
+#: doc/classes/RenderingServer.xml:1805
msgid "Returns a mesh's surface's material."
msgstr ""
-#: doc/classes/RenderingServer.xml:1819
+#: doc/classes/RenderingServer.xml:1818
msgid "Sets a mesh's surface's material."
msgstr ""
-#: doc/classes/RenderingServer.xml:1834
+#: doc/classes/RenderingServer.xml:1833
msgid ""
"Updates a specific region of a vertex buffer for the specified surface. "
"Warning: this function alters the vertex buffer directly with no safety "
"mechanisms, you can easily corrupt your mesh."
msgstr ""
-#: doc/classes/RenderingServer.xml:1857
+#: doc/classes/RenderingServer.xml:1856
msgid ""
"Creates a new multimesh on the RenderingServer and returns an [RID] handle. "
"This RID will be used in all [code]multimesh_*[/code] RenderingServer "
@@ -42438,82 +43303,82 @@ msgid ""
"instance_set_base] using the returned RID."
msgstr ""
-#: doc/classes/RenderingServer.xml:1868
+#: doc/classes/RenderingServer.xml:1867
msgid ""
"Calculates and returns the axis-aligned bounding box that encloses all "
"instances within the multimesh."
msgstr ""
-#: doc/classes/RenderingServer.xml:1885
+#: doc/classes/RenderingServer.xml:1884
msgid "Returns the number of instances allocated for this multimesh."
msgstr ""
-#: doc/classes/RenderingServer.xml:1894
+#: doc/classes/RenderingServer.xml:1893
msgid ""
"Returns the RID of the mesh that will be used in drawing this multimesh."
msgstr ""
-#: doc/classes/RenderingServer.xml:1903
+#: doc/classes/RenderingServer.xml:1902
msgid "Returns the number of visible instances for this multimesh."
msgstr ""
-#: doc/classes/RenderingServer.xml:1914
+#: doc/classes/RenderingServer.xml:1913
msgid "Returns the color by which the specified instance will be modulated."
msgstr ""
-#: doc/classes/RenderingServer.xml:1925
+#: doc/classes/RenderingServer.xml:1924
msgid "Returns the custom data associated with the specified instance."
msgstr ""
-#: doc/classes/RenderingServer.xml:1936
+#: doc/classes/RenderingServer.xml:1935
msgid "Returns the [Transform] of the specified instance."
msgstr ""
-#: doc/classes/RenderingServer.xml:1947
+#: doc/classes/RenderingServer.xml:1946
msgid ""
"Returns the [Transform2D] of the specified instance. For use when the "
"multimesh is set to use 2D transforms."
msgstr ""
-#: doc/classes/RenderingServer.xml:1960
+#: doc/classes/RenderingServer.xml:1959
msgid ""
"Sets the color by which this instance will be modulated. Equivalent to "
"[method MultiMesh.set_instance_color]."
msgstr ""
-#: doc/classes/RenderingServer.xml:1973
+#: doc/classes/RenderingServer.xml:1972
msgid ""
"Sets the custom data for this instance. Custom data is passed as a [Color], "
"but is interpreted as a [code]vec4[/code] in the shader. Equivalent to "
"[method MultiMesh.set_instance_custom_data]."
msgstr ""
-#: doc/classes/RenderingServer.xml:1986
+#: doc/classes/RenderingServer.xml:1985
msgid ""
"Sets the [Transform] for this instance. Equivalent to [method MultiMesh."
"set_instance_transform]."
msgstr ""
-#: doc/classes/RenderingServer.xml:1999
+#: doc/classes/RenderingServer.xml:1998
msgid ""
"Sets the [Transform2D] for this instance. For use when multimesh is used in "
"2D. Equivalent to [method MultiMesh.set_instance_transform_2d]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2020
+#: doc/classes/RenderingServer.xml:2019
msgid ""
"Sets the mesh to be drawn by the multimesh. Equivalent to [member MultiMesh."
"mesh]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2031
+#: doc/classes/RenderingServer.xml:2030
msgid ""
"Sets the number of instances visible at a given time. If -1, all instances "
"that have been allocated are drawn. Equivalent to [member MultiMesh."
"visible_instance_count]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2038
+#: doc/classes/RenderingServer.xml:2037
msgid ""
"Creates a new omni light and adds it to the RenderingServer. It can be "
"accessed with the RID that is returned. This RID can be used in most "
@@ -42524,7 +43389,7 @@ msgid ""
"instance_set_base] using the returned RID."
msgstr ""
-#: doc/classes/RenderingServer.xml:2047
+#: doc/classes/RenderingServer.xml:2046
msgid ""
"Creates a particle system and adds it to the RenderingServer. It can be "
"accessed with the RID that is returned. This RID will be used in all "
@@ -42535,23 +43400,23 @@ msgid ""
"instance_set_base] using the returned RID."
msgstr ""
-#: doc/classes/RenderingServer.xml:2058
+#: doc/classes/RenderingServer.xml:2057
msgid ""
"Calculates and returns the axis-aligned bounding box that contains all the "
"particles. Equivalent to [method GPUParticles3D.capture_aabb]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2067
+#: doc/classes/RenderingServer.xml:2066
msgid "Returns [code]true[/code] if particles are currently set to emitting."
msgstr ""
-#: doc/classes/RenderingServer.xml:2076
+#: doc/classes/RenderingServer.xml:2075
msgid ""
"Returns [code]true[/code] if particles are not emitting and particles are "
"set to inactive."
msgstr ""
-#: doc/classes/RenderingServer.xml:2085
+#: doc/classes/RenderingServer.xml:2084
msgid ""
"Add particle system to list of particle systems that need to be updated. "
"Update will take place on the next frame, or on the next call to [method "
@@ -42559,121 +43424,121 @@ msgid ""
"instances_cull_ray]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2094
+#: doc/classes/RenderingServer.xml:2093
msgid ""
"Reset the particles on the next update. Equivalent to [method GPUParticles3D."
"restart]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2105
+#: doc/classes/RenderingServer.xml:2104
msgid ""
"Sets the number of particles to be drawn and allocates the memory for them. "
"Equivalent to [member GPUParticles3D.amount]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2116
+#: doc/classes/RenderingServer.xml:2115
msgid ""
"Sets a custom axis-aligned bounding box for the particle system. Equivalent "
"to [member GPUParticles3D.visibility_aabb]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2127
+#: doc/classes/RenderingServer.xml:2126
msgid ""
"Sets the draw order of the particles to one of the named enums from [enum "
"ParticlesDrawOrder]. See [enum ParticlesDrawOrder] for options. Equivalent "
"to [member GPUParticles3D.draw_order]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2140
+#: doc/classes/RenderingServer.xml:2139
msgid ""
"Sets the mesh to be used for the specified draw pass. Equivalent to [member "
"GPUParticles3D.draw_pass_1], [member GPUParticles3D.draw_pass_2], [member "
"GPUParticles3D.draw_pass_3], and [member GPUParticles3D.draw_pass_4]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2151
+#: doc/classes/RenderingServer.xml:2150
msgid ""
"Sets the number of draw passes to use. Equivalent to [member GPUParticles3D."
"draw_passes]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2162
+#: doc/classes/RenderingServer.xml:2161
msgid ""
"Sets the [Transform] that will be used by the particles when they first emit."
msgstr ""
-#: doc/classes/RenderingServer.xml:2173
+#: doc/classes/RenderingServer.xml:2172
msgid ""
"If [code]true[/code], particles will emit over time. Setting to false does "
"not reset the particles, but only stops their emission. Equivalent to "
"[member GPUParticles3D.emitting]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2184
+#: doc/classes/RenderingServer.xml:2183
msgid ""
"Sets the explosiveness ratio. Equivalent to [member GPUParticles3D."
"explosiveness]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2195
+#: doc/classes/RenderingServer.xml:2194
msgid ""
"Sets the frame rate that the particle system rendering will be fixed to. "
"Equivalent to [member GPUParticles3D.fixed_fps]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2206
+#: doc/classes/RenderingServer.xml:2205
msgid ""
"If [code]true[/code], uses fractional delta which smooths the movement of "
"the particles. Equivalent to [member GPUParticles3D.fract_delta]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2217
+#: doc/classes/RenderingServer.xml:2216
msgid ""
"Sets the lifetime of each particle in the system. Equivalent to [member "
"GPUParticles3D.lifetime]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2228
+#: doc/classes/RenderingServer.xml:2227
msgid ""
"If [code]true[/code], particles will emit once and then stop. Equivalent to "
"[member GPUParticles3D.one_shot]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2239
+#: doc/classes/RenderingServer.xml:2238
msgid ""
"Sets the preprocess time for the particles animation. This lets you delay "
"starting an animation until after the particles have begun emitting. "
"Equivalent to [member GPUParticles3D.preprocess]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2250
+#: doc/classes/RenderingServer.xml:2249
msgid ""
"Sets the material for processing the particles. Note: this is not the "
"material used to draw the materials. Equivalent to [member GPUParticles3D."
"process_material]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2261
+#: doc/classes/RenderingServer.xml:2260
msgid ""
"Sets the emission randomness ratio. This randomizes the emission of "
"particles within their phase. Equivalent to [member GPUParticles3D."
"randomness]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2272
+#: doc/classes/RenderingServer.xml:2271
msgid ""
"Sets the speed scale of the particle system. Equivalent to [member "
"GPUParticles3D.speed_scale]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2283
+#: doc/classes/RenderingServer.xml:2282
msgid ""
"If [code]true[/code], particles use local coordinates. If [code]false[/code] "
"they use global coordinates. Equivalent to [member GPUParticles3D."
"local_coords]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2290
+#: doc/classes/RenderingServer.xml:2289
msgid ""
"Creates a reflection probe and adds it to the RenderingServer. It can be "
"accessed with the RID that is returned. This RID will be used in all "
@@ -42684,85 +43549,64 @@ msgid ""
"[method instance_set_base] using the returned RID."
msgstr ""
-#: doc/classes/RenderingServer.xml:2303
+#: doc/classes/RenderingServer.xml:2332
msgid ""
"If [code]true[/code], reflections will ignore sky contribution. Equivalent "
-"to [member ReflectionProbe.interior_enable]."
+"to [member ReflectionProbe.interior]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2314
+#: doc/classes/RenderingServer.xml:2343
msgid ""
"Sets the render cull mask for this reflection probe. Only instances with a "
"matching cull mask will be rendered by this probe. Equivalent to [member "
"ReflectionProbe.cull_mask]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2325
+#: doc/classes/RenderingServer.xml:2354
msgid ""
"If [code]true[/code], uses box projection. This can make reflections look "
"more correct in certain situations. Equivalent to [member ReflectionProbe."
"box_projection]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2336
+#: doc/classes/RenderingServer.xml:2365
msgid ""
"If [code]true[/code], computes shadows in the reflection probe. This makes "
"the reflection much slower to compute. Equivalent to [member ReflectionProbe."
"enable_shadows]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2347
+#: doc/classes/RenderingServer.xml:2376
msgid ""
"Sets the size of the area that the reflection probe will capture. Equivalent "
"to [member ReflectionProbe.extents]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2358
+#: doc/classes/RenderingServer.xml:2387
msgid ""
"Sets the intensity of the reflection probe. Intensity modulates the strength "
"of the reflection. Equivalent to [member ReflectionProbe.intensity]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2369
-msgid ""
-"Sets the ambient light color for this reflection probe when set to interior "
-"mode. Equivalent to [member ReflectionProbe.interior_ambient_color]."
-msgstr ""
-
-#: doc/classes/RenderingServer.xml:2380
-msgid ""
-"Sets the energy multiplier for this reflection probes ambient light "
-"contribution when set to interior mode. Equivalent to [member "
-"ReflectionProbe.interior_ambient_energy]."
-msgstr ""
-
-#: doc/classes/RenderingServer.xml:2391
-msgid ""
-"Sets the contribution value for how much the reflection affects the ambient "
-"light for this reflection probe when set to interior mode. Useful so that "
-"ambient light matches the color of the room. Equivalent to [member "
-"ReflectionProbe.interior_ambient_contrib]."
-msgstr ""
-
-#: doc/classes/RenderingServer.xml:2402
+#: doc/classes/RenderingServer.xml:2398
msgid ""
"Sets the max distance away from the probe an object can be before it is "
"culled. Equivalent to [member ReflectionProbe.max_distance]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2413
+#: doc/classes/RenderingServer.xml:2409
msgid ""
"Sets the origin offset to be used when this reflection probe is in box "
"project mode. Equivalent to [member ReflectionProbe.origin_offset]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2424
+#: doc/classes/RenderingServer.xml:2420
msgid ""
"Sets how often the reflection probe updates. Can either be once or every "
"frame. See [enum ReflectionProbeUpdateMode] for options."
msgstr ""
-#: doc/classes/RenderingServer.xml:2437
+#: doc/classes/RenderingServer.xml:2433
msgid ""
"Schedules a callback to the corresponding named [code]method[/code] on "
"[code]where[/code] after a frame has been drawn.\n"
@@ -42770,7 +43614,7 @@ msgid ""
"[code]userdata[/code]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2445
+#: doc/classes/RenderingServer.xml:2441
msgid ""
"Creates a scenario and adds it to the RenderingServer. It can be accessed "
"with the RID that is returned. This RID will be used in all "
@@ -42780,24 +43624,24 @@ msgid ""
"The scenario is the 3D world that all the visual instances exist in."
msgstr ""
-#: doc/classes/RenderingServer.xml:2458
+#: doc/classes/RenderingServer.xml:2454
msgid ""
"Sets the [enum ScenarioDebugMode] for this scenario. See [enum "
"ScenarioDebugMode] for options."
msgstr ""
-#: doc/classes/RenderingServer.xml:2469
+#: doc/classes/RenderingServer.xml:2465
msgid "Sets the environment that will be used with this scenario."
msgstr ""
-#: doc/classes/RenderingServer.xml:2480
+#: doc/classes/RenderingServer.xml:2476
msgid ""
"Sets the fallback environment to be used by this scenario. The fallback "
"environment is used if no environment is set. Internally, this is used by "
"the editor to provide a default environment."
msgstr ""
-#: doc/classes/RenderingServer.xml:2495
+#: doc/classes/RenderingServer.xml:2491
msgid ""
"Sets a boot image. The color defines the background color. If [code]scale[/"
"code] is [code]true[/code], the image will be scaled to fit the screen size. "
@@ -42806,19 +43650,19 @@ msgid ""
"the image will be scaled with nearest-neighbor interpolation."
msgstr ""
-#: doc/classes/RenderingServer.xml:2504
+#: doc/classes/RenderingServer.xml:2500
msgid ""
"If [code]true[/code], the engine will generate wireframes for use with the "
"wireframe debug mode."
msgstr ""
-#: doc/classes/RenderingServer.xml:2513
+#: doc/classes/RenderingServer.xml:2509
msgid ""
"Sets the default clear color which is used when a specific clear color has "
"not been selected."
msgstr ""
-#: doc/classes/RenderingServer.xml:2520
+#: doc/classes/RenderingServer.xml:2516
msgid ""
"Creates an empty shader and adds it to the RenderingServer. It can be "
"accessed with the RID that is returned. This RID will be used in all "
@@ -42827,47 +43671,47 @@ msgid ""
"RenderingServer's [method free_rid] static method."
msgstr ""
-#: doc/classes/RenderingServer.xml:2530
+#: doc/classes/RenderingServer.xml:2526
msgid "Returns a shader's code."
msgstr ""
-#: doc/classes/RenderingServer.xml:2541
+#: doc/classes/RenderingServer.xml:2537
msgid "Returns a default texture from a shader searched by name."
msgstr ""
-#: doc/classes/RenderingServer.xml:2560
+#: doc/classes/RenderingServer.xml:2556
msgid "Returns the parameters of a shader."
msgstr ""
-#: doc/classes/RenderingServer.xml:2571
+#: doc/classes/RenderingServer.xml:2567
msgid "Sets a shader's code."
msgstr ""
-#: doc/classes/RenderingServer.xml:2584
+#: doc/classes/RenderingServer.xml:2580
msgid "Sets a shader's default texture. Overwrites the texture given by name."
msgstr ""
-#: doc/classes/RenderingServer.xml:2597
+#: doc/classes/RenderingServer.xml:2593
msgid "Allocates the GPU buffers for this skeleton."
msgstr ""
-#: doc/classes/RenderingServer.xml:2608
+#: doc/classes/RenderingServer.xml:2604
msgid "Returns the [Transform] set for a specific bone of this skeleton."
msgstr ""
-#: doc/classes/RenderingServer.xml:2619
+#: doc/classes/RenderingServer.xml:2615
msgid "Returns the [Transform2D] set for a specific bone of this skeleton."
msgstr ""
-#: doc/classes/RenderingServer.xml:2632
+#: doc/classes/RenderingServer.xml:2628
msgid "Sets the [Transform] for a specific bone of this skeleton."
msgstr ""
-#: doc/classes/RenderingServer.xml:2645
+#: doc/classes/RenderingServer.xml:2641
msgid "Sets the [Transform2D] for a specific bone of this skeleton."
msgstr ""
-#: doc/classes/RenderingServer.xml:2652
+#: doc/classes/RenderingServer.xml:2648
msgid ""
"Creates a skeleton and adds it to the RenderingServer. It can be accessed "
"with the RID that is returned. This RID will be used in all "
@@ -42876,11 +43720,11 @@ msgid ""
"RenderingServer's [method free_rid] static method."
msgstr ""
-#: doc/classes/RenderingServer.xml:2662
+#: doc/classes/RenderingServer.xml:2658
msgid "Returns the number of bones allocated for this skeleton."
msgstr ""
-#: doc/classes/RenderingServer.xml:2669
+#: doc/classes/RenderingServer.xml:2665
msgid ""
"Creates an empty sky and adds it to the RenderingServer. It can be accessed "
"with the RID that is returned. This RID will be used in all [code]sky_*[/"
@@ -42889,13 +43733,13 @@ msgid ""
"RenderingServer's [method free_rid] static method."
msgstr ""
-#: doc/classes/RenderingServer.xml:2681
+#: doc/classes/RenderingServer.xml:2677
msgid ""
"Sets the material that the sky uses to render the background and reflection "
"maps."
msgstr ""
-#: doc/classes/RenderingServer.xml:2688
+#: doc/classes/RenderingServer.xml:2684
msgid ""
"Creates a spot light and adds it to the RenderingServer. It can be accessed "
"with the RID that is returned. This RID can be used in most [code]light_*[/"
@@ -42906,15 +43750,15 @@ msgid ""
"instance_set_base] using the returned RID."
msgstr ""
-#: doc/classes/RenderingServer.xml:2717
+#: doc/classes/RenderingServer.xml:2713
msgid "Sets a viewport's camera."
msgstr ""
-#: doc/classes/RenderingServer.xml:2728
+#: doc/classes/RenderingServer.xml:2724
msgid "Sets a viewport's canvas."
msgstr ""
-#: doc/classes/RenderingServer.xml:2741
+#: doc/classes/RenderingServer.xml:2737
msgid ""
"Copies the viewport to a region of the screen specified by [code]rect[/"
"code]. If [method viewport_set_render_direct_to_screen] is [code]true[/"
@@ -42936,7 +43780,7 @@ msgid ""
"viewport_set_render_direct_to_screen]."
msgstr ""
-#: doc/classes/RenderingServer.xml:2755
+#: doc/classes/RenderingServer.xml:2751
msgid ""
"Creates an empty viewport and adds it to the RenderingServer. It can be "
"accessed with the RID that is returned. This RID will be used in all "
@@ -42945,72 +43789,72 @@ msgid ""
"RenderingServer's [method free_rid] static method."
msgstr ""
-#: doc/classes/RenderingServer.xml:2767
+#: doc/classes/RenderingServer.xml:2763
msgid ""
"Returns a viewport's render information. For options, see the [enum "
"ViewportRenderInfo] constants."
msgstr ""
-#: doc/classes/RenderingServer.xml:2776
+#: doc/classes/RenderingServer.xml:2772
msgid "Returns the viewport's last rendered frame."
msgstr ""
-#: doc/classes/RenderingServer.xml:2787
+#: doc/classes/RenderingServer.xml:2783
msgid "Detaches a viewport from a canvas and vice versa."
msgstr ""
-#: doc/classes/RenderingServer.xml:2798
+#: doc/classes/RenderingServer.xml:2794
msgid "If [code]true[/code], sets the viewport active, else sets it inactive."
msgstr ""
-#: doc/classes/RenderingServer.xml:2813
+#: doc/classes/RenderingServer.xml:2809
msgid ""
"Sets the stacking order for a viewport's canvas.\n"
"[code]layer[/code] is the actual canvas layer, while [code]sublayer[/code] "
"specifies the stacking order of the canvas among those in the same layer."
msgstr ""
-#: doc/classes/RenderingServer.xml:2827
+#: doc/classes/RenderingServer.xml:2823
msgid "Sets the transformation of a viewport's canvas."
msgstr ""
-#: doc/classes/RenderingServer.xml:2838
+#: doc/classes/RenderingServer.xml:2834
msgid ""
"Sets the clear mode of a viewport. See [enum ViewportClearMode] for options."
msgstr ""
-#: doc/classes/RenderingServer.xml:2849
+#: doc/classes/RenderingServer.xml:2845
msgid ""
"Sets the debug draw mode of a viewport. See [enum ViewportDebugDraw] for "
"options."
msgstr ""
-#: doc/classes/RenderingServer.xml:2860
+#: doc/classes/RenderingServer.xml:2856
msgid ""
"If [code]true[/code], rendering of a viewport's environment is disabled."
msgstr ""
-#: doc/classes/RenderingServer.xml:2871
+#: doc/classes/RenderingServer.xml:2867
msgid "Sets the viewport's global transformation matrix."
msgstr ""
-#: doc/classes/RenderingServer.xml:2882
+#: doc/classes/RenderingServer.xml:2878
msgid "If [code]true[/code], the viewport's canvas is not rendered."
msgstr ""
-#: doc/classes/RenderingServer.xml:2893
+#: doc/classes/RenderingServer.xml:2889
msgid "Currently unimplemented in Godot 3.x."
msgstr ""
-#: doc/classes/RenderingServer.xml:2904
+#: doc/classes/RenderingServer.xml:2900
msgid "Sets the anti-aliasing mode. See [enum ViewportMSAA] for options."
msgstr ""
-#: doc/classes/RenderingServer.xml:2915
+#: doc/classes/RenderingServer.xml:2911
msgid "Sets the viewport's parent to another viewport."
msgstr ""
-#: doc/classes/RenderingServer.xml:2926
+#: doc/classes/RenderingServer.xml:2922
msgid ""
"If [code]true[/code], render the contents of the viewport directly to "
"screen. This allows a low-level optimization where you can skip drawing a "
@@ -43026,455 +43870,455 @@ msgid ""
"significantly larger than the window size."
msgstr ""
-#: doc/classes/RenderingServer.xml:2937
+#: doc/classes/RenderingServer.xml:2933
msgid ""
"Sets a viewport's scenario.\n"
"The scenario contains information about the [enum ScenarioDebugMode], "
"environment information, reflection atlas etc."
msgstr ""
-#: doc/classes/RenderingServer.xml:2951
+#: doc/classes/RenderingServer.xml:2947
msgid "Sets the shadow atlas quadrant's subdivision."
msgstr ""
-#: doc/classes/RenderingServer.xml:2962
+#: doc/classes/RenderingServer.xml:2958
msgid ""
"Sets the size of the shadow atlas's images (used for omni and spot lights). "
"The value will be rounded up to the nearest power of 2."
msgstr ""
-#: doc/classes/RenderingServer.xml:2975
+#: doc/classes/RenderingServer.xml:2971
msgid "Sets the viewport's width and height."
msgstr ""
-#: doc/classes/RenderingServer.xml:2986
+#: doc/classes/RenderingServer.xml:2982
msgid ""
"If [code]true[/code], the viewport renders its background as transparent."
msgstr ""
-#: doc/classes/RenderingServer.xml:2997
+#: doc/classes/RenderingServer.xml:2993
msgid ""
"Sets when the viewport should be updated. See [enum ViewportUpdateMode] "
"constants for options."
msgstr ""
-#: doc/classes/RenderingServer.xml:3008
+#: doc/classes/RenderingServer.xml:3004
msgid ""
"If [code]true[/code], the viewport uses augmented or virtual reality "
"technologies. See [XRInterface]."
msgstr ""
-#: doc/classes/RenderingServer.xml:3014
+#: doc/classes/RenderingServer.xml:3010
msgid ""
"If [code]false[/code], disables rendering completely, but the engine logic "
"is still being processed. You can call [method force_draw] to draw a frame "
"even with rendering disabled."
msgstr ""
-#: doc/classes/RenderingServer.xml:3020
+#: doc/classes/RenderingServer.xml:3016
msgid ""
"Emitted at the end of the frame, after the RenderingServer has finished "
"updating all the Viewports."
msgstr ""
-#: doc/classes/RenderingServer.xml:3025
+#: doc/classes/RenderingServer.xml:3021
msgid ""
"Emitted at the beginning of the frame, before the RenderingServer updates "
"all the Viewports."
msgstr ""
-#: doc/classes/RenderingServer.xml:3031
+#: doc/classes/RenderingServer.xml:3027
msgid "Marks an error that shows that the index array is empty."
msgstr ""
-#: doc/classes/RenderingServer.xml:3034
+#: doc/classes/RenderingServer.xml:3030
msgid "Number of weights/bones per vertex."
msgstr ""
-#: doc/classes/RenderingServer.xml:3037
+#: doc/classes/RenderingServer.xml:3033
msgid "The minimum Z-layer for canvas items."
msgstr ""
-#: doc/classes/RenderingServer.xml:3040
+#: doc/classes/RenderingServer.xml:3036
msgid "The maximum Z-layer for canvas items."
msgstr ""
-#: doc/classes/RenderingServer.xml:3043
+#: doc/classes/RenderingServer.xml:3039
msgid ""
"Max number of glow levels that can be used with glow post-process effect."
msgstr ""
-#: doc/classes/RenderingServer.xml:3046
+#: doc/classes/RenderingServer.xml:3042
msgid "Unused enum in Godot 3.x."
msgstr ""
-#: doc/classes/RenderingServer.xml:3067
+#: doc/classes/RenderingServer.xml:3063
msgid "Shader is a 3D shader."
msgstr ""
-#: doc/classes/RenderingServer.xml:3070
+#: doc/classes/RenderingServer.xml:3066
msgid "Shader is a 2D shader."
msgstr ""
-#: doc/classes/RenderingServer.xml:3073
+#: doc/classes/RenderingServer.xml:3069
msgid "Shader is a particle shader."
msgstr ""
-#: doc/classes/RenderingServer.xml:3076
+#: doc/classes/RenderingServer.xml:3072
msgid "Shader is a sky shader."
msgstr ""
-#: doc/classes/RenderingServer.xml:3079
+#: doc/classes/RenderingServer.xml:3075
msgid "Represents the size of the [enum ShaderMode] enum."
msgstr ""
-#: doc/classes/RenderingServer.xml:3082
+#: doc/classes/RenderingServer.xml:3078
msgid "The minimum renderpriority of all materials."
msgstr ""
-#: doc/classes/RenderingServer.xml:3085
+#: doc/classes/RenderingServer.xml:3081
msgid "The maximum renderpriority of all materials."
msgstr ""
-#: doc/classes/RenderingServer.xml:3088
+#: doc/classes/RenderingServer.xml:3084
msgid "Array is a vertex array."
msgstr ""
-#: doc/classes/RenderingServer.xml:3091
+#: doc/classes/RenderingServer.xml:3087
msgid "Array is a normal array."
msgstr ""
-#: doc/classes/RenderingServer.xml:3094
+#: doc/classes/RenderingServer.xml:3090
msgid "Array is a tangent array."
msgstr ""
-#: doc/classes/RenderingServer.xml:3097
+#: doc/classes/RenderingServer.xml:3093
msgid "Array is a color array."
msgstr ""
-#: doc/classes/RenderingServer.xml:3100
+#: doc/classes/RenderingServer.xml:3096
msgid "Array is an UV coordinates array."
msgstr ""
-#: doc/classes/RenderingServer.xml:3103
+#: doc/classes/RenderingServer.xml:3099
msgid "Array is an UV coordinates array for the second UV coordinates."
msgstr ""
-#: doc/classes/RenderingServer.xml:3106
+#: doc/classes/RenderingServer.xml:3102
msgid "Array contains bone information."
msgstr ""
-#: doc/classes/RenderingServer.xml:3109
+#: doc/classes/RenderingServer.xml:3105
msgid "Array is weight information."
msgstr ""
-#: doc/classes/RenderingServer.xml:3112
+#: doc/classes/RenderingServer.xml:3108
msgid "Array is index array."
msgstr ""
-#: doc/classes/RenderingServer.xml:3118
+#: doc/classes/RenderingServer.xml:3114
msgid "Flag used to mark a vertex array."
msgstr ""
-#: doc/classes/RenderingServer.xml:3121
+#: doc/classes/RenderingServer.xml:3117
msgid "Flag used to mark a normal array."
msgstr ""
-#: doc/classes/RenderingServer.xml:3124
+#: doc/classes/RenderingServer.xml:3120
msgid "Flag used to mark a tangent array."
msgstr ""
-#: doc/classes/RenderingServer.xml:3127
+#: doc/classes/RenderingServer.xml:3123
msgid "Flag used to mark a color array."
msgstr ""
-#: doc/classes/RenderingServer.xml:3130
+#: doc/classes/RenderingServer.xml:3126
msgid "Flag used to mark an UV coordinates array."
msgstr ""
-#: doc/classes/RenderingServer.xml:3133
+#: doc/classes/RenderingServer.xml:3129
msgid ""
"Flag used to mark an UV coordinates array for the second UV coordinates."
msgstr ""
-#: doc/classes/RenderingServer.xml:3136
+#: doc/classes/RenderingServer.xml:3132
msgid "Flag used to mark a bone information array."
msgstr ""
-#: doc/classes/RenderingServer.xml:3139
+#: doc/classes/RenderingServer.xml:3135
msgid "Flag used to mark a weights array."
msgstr ""
-#: doc/classes/RenderingServer.xml:3142
+#: doc/classes/RenderingServer.xml:3138
msgid "Flag used to mark an index array."
msgstr ""
-#: doc/classes/RenderingServer.xml:3171
+#: doc/classes/RenderingServer.xml:3167
msgid "Primitive to draw consists of points."
msgstr ""
-#: doc/classes/RenderingServer.xml:3174
+#: doc/classes/RenderingServer.xml:3170
msgid "Primitive to draw consists of lines."
msgstr ""
-#: doc/classes/RenderingServer.xml:3177
+#: doc/classes/RenderingServer.xml:3173
msgid "Primitive to draw consists of a line strip from start to end."
msgstr ""
-#: doc/classes/RenderingServer.xml:3180
+#: doc/classes/RenderingServer.xml:3176
msgid "Primitive to draw consists of triangles."
msgstr ""
-#: doc/classes/RenderingServer.xml:3183
+#: doc/classes/RenderingServer.xml:3179
msgid ""
"Primitive to draw consists of a triangle strip (the last 3 vertices are "
"always combined to make a triangle)."
msgstr ""
-#: doc/classes/RenderingServer.xml:3186
+#: doc/classes/RenderingServer.xml:3182
msgid "Represents the size of the [enum PrimitiveType] enum."
msgstr ""
-#: doc/classes/RenderingServer.xml:3195
+#: doc/classes/RenderingServer.xml:3191
msgid "Use [Transform2D] to store MultiMesh transform."
msgstr ""
-#: doc/classes/RenderingServer.xml:3198
+#: doc/classes/RenderingServer.xml:3194
msgid "Use [Transform] to store MultiMesh transform."
msgstr ""
-#: doc/classes/RenderingServer.xml:3201
+#: doc/classes/RenderingServer.xml:3197
msgid "Is a directional (sun) light."
msgstr ""
-#: doc/classes/RenderingServer.xml:3204
+#: doc/classes/RenderingServer.xml:3200
msgid "Is an omni light."
msgstr ""
-#: doc/classes/RenderingServer.xml:3207
+#: doc/classes/RenderingServer.xml:3203
msgid "Is a spot light."
msgstr ""
-#: doc/classes/RenderingServer.xml:3210
+#: doc/classes/RenderingServer.xml:3206
msgid "The light's energy."
msgstr ""
-#: doc/classes/RenderingServer.xml:3215
+#: doc/classes/RenderingServer.xml:3211
msgid "The light's influence on specularity."
msgstr ""
-#: doc/classes/RenderingServer.xml:3218
+#: doc/classes/RenderingServer.xml:3214
msgid "The light's range."
msgstr ""
-#: doc/classes/RenderingServer.xml:3221
+#: doc/classes/RenderingServer.xml:3217
msgid ""
"The size of the light when using spot light or omni light. The angular size "
"of the light when using directional light."
msgstr ""
-#: doc/classes/RenderingServer.xml:3224
+#: doc/classes/RenderingServer.xml:3220
msgid "The light's attenuation."
msgstr ""
-#: doc/classes/RenderingServer.xml:3227
+#: doc/classes/RenderingServer.xml:3223
msgid "The spotlight's angle."
msgstr ""
-#: doc/classes/RenderingServer.xml:3230
+#: doc/classes/RenderingServer.xml:3226
msgid "The spotlight's attenuation."
msgstr ""
-#: doc/classes/RenderingServer.xml:3233
+#: doc/classes/RenderingServer.xml:3229
msgid "Max distance that shadows will be rendered."
msgstr ""
-#: doc/classes/RenderingServer.xml:3236
+#: doc/classes/RenderingServer.xml:3232
msgid "Proportion of shadow atlas occupied by the first split."
msgstr ""
-#: doc/classes/RenderingServer.xml:3239
+#: doc/classes/RenderingServer.xml:3235
msgid "Proportion of shadow atlas occupied by the second split."
msgstr ""
-#: doc/classes/RenderingServer.xml:3242
+#: doc/classes/RenderingServer.xml:3238
msgid ""
"Proportion of shadow atlas occupied by the third split. The fourth split "
"occupies the rest."
msgstr ""
-#: doc/classes/RenderingServer.xml:3245
+#: doc/classes/RenderingServer.xml:3241
msgid ""
"Proportion of shadow max distance where the shadow will start to fade out."
msgstr ""
-#: doc/classes/RenderingServer.xml:3248
+#: doc/classes/RenderingServer.xml:3244
msgid ""
"Normal bias used to offset shadow lookup by object normal. Can be used to "
"fix self-shadowing artifacts."
msgstr ""
-#: doc/classes/RenderingServer.xml:3251
+#: doc/classes/RenderingServer.xml:3247
msgid "Bias the shadow lookup to fix self-shadowing artifacts."
msgstr ""
-#: doc/classes/RenderingServer.xml:3257
+#: doc/classes/RenderingServer.xml:3253
msgid ""
"Blurs the edges of the shadow. Can be used to hide pixel artifacts in low "
"resolution shadow maps. A high value can make shadows appear grainy and can "
"cause other unwanted artifacts. Try to keep as near default as possible."
msgstr ""
-#: doc/classes/RenderingServer.xml:3262
+#: doc/classes/RenderingServer.xml:3258
msgid "Represents the size of the [enum LightParam] enum."
msgstr ""
-#: doc/classes/RenderingServer.xml:3265
+#: doc/classes/RenderingServer.xml:3267
msgid "Use a dual paraboloid shadow map for omni lights."
msgstr ""
-#: doc/classes/RenderingServer.xml:3268
+#: doc/classes/RenderingServer.xml:3270
msgid ""
"Use a cubemap shadow map for omni lights. Slower but better quality than "
"dual paraboloid."
msgstr ""
-#: doc/classes/RenderingServer.xml:3271
+#: doc/classes/RenderingServer.xml:3273
msgid "Use orthogonal shadow projection for directional light."
msgstr ""
-#: doc/classes/RenderingServer.xml:3274
+#: doc/classes/RenderingServer.xml:3276
msgid "Use 2 splits for shadow projection when using directional light."
msgstr ""
-#: doc/classes/RenderingServer.xml:3277
+#: doc/classes/RenderingServer.xml:3279
msgid "Use 4 splits for shadow projection when using directional light."
msgstr ""
-#: doc/classes/RenderingServer.xml:3280
+#: doc/classes/RenderingServer.xml:3282
msgid ""
"Keeps shadows stable as camera moves but has lower effective resolution."
msgstr ""
-#: doc/classes/RenderingServer.xml:3283
+#: doc/classes/RenderingServer.xml:3285
msgid ""
"Optimize use of shadow maps, increasing the effective resolution. But may "
"result in shadows moving or flickering slightly."
msgstr ""
-#: doc/classes/RenderingServer.xml:3286
+#: doc/classes/RenderingServer.xml:3288
msgid "Reflection probe will update reflections once and then stop."
msgstr ""
-#: doc/classes/RenderingServer.xml:3289
+#: doc/classes/RenderingServer.xml:3291
msgid ""
"Reflection probe will update each frame. This mode is necessary to capture "
"moving objects."
msgstr ""
-#: doc/classes/RenderingServer.xml:3302
+#: doc/classes/RenderingServer.xml:3310
msgid "Draw particles in the order that they appear in the particles array."
msgstr ""
-#: doc/classes/RenderingServer.xml:3305
+#: doc/classes/RenderingServer.xml:3313
msgid "Sort particles based on their lifetime."
msgstr ""
-#: doc/classes/RenderingServer.xml:3308
+#: doc/classes/RenderingServer.xml:3316
msgid "Sort particles based on their distance to the camera."
msgstr ""
-#: doc/classes/RenderingServer.xml:3311
+#: doc/classes/RenderingServer.xml:3319
msgid "Do not update the viewport."
msgstr ""
-#: doc/classes/RenderingServer.xml:3314
+#: doc/classes/RenderingServer.xml:3322
msgid "Update the viewport once then set to disabled."
msgstr ""
-#: doc/classes/RenderingServer.xml:3317
+#: doc/classes/RenderingServer.xml:3325
msgid "Update the viewport whenever it is visible."
msgstr ""
-#: doc/classes/RenderingServer.xml:3322
+#: doc/classes/RenderingServer.xml:3330
msgid "Always update the viewport."
msgstr ""
-#: doc/classes/RenderingServer.xml:3325
+#: doc/classes/RenderingServer.xml:3333
msgid "The viewport is always cleared before drawing."
msgstr ""
-#: doc/classes/RenderingServer.xml:3328
+#: doc/classes/RenderingServer.xml:3336
msgid "The viewport is never cleared before drawing."
msgstr ""
-#: doc/classes/RenderingServer.xml:3331
+#: doc/classes/RenderingServer.xml:3339
msgid ""
"The viewport is cleared once, then the clear mode is set to [constant "
"VIEWPORT_CLEAR_NEVER]."
msgstr ""
-#: doc/classes/RenderingServer.xml:3334
+#: doc/classes/RenderingServer.xml:3342
msgid "Multisample antialiasing is disabled."
msgstr ""
-#: doc/classes/RenderingServer.xml:3337
+#: doc/classes/RenderingServer.xml:3345
msgid "Multisample antialiasing uses 2 samples per pixel."
msgstr ""
-#: doc/classes/RenderingServer.xml:3340
+#: doc/classes/RenderingServer.xml:3348
msgid "Multisample antialiasing uses 4 samples per pixel."
msgstr ""
-#: doc/classes/RenderingServer.xml:3343
+#: doc/classes/RenderingServer.xml:3351
msgid "Multisample antialiasing uses 8 samples per pixel."
msgstr ""
-#: doc/classes/RenderingServer.xml:3346
+#: doc/classes/RenderingServer.xml:3354
msgid "Multisample antialiasing uses 16 samples per pixel."
msgstr ""
-#: doc/classes/RenderingServer.xml:3357
+#: doc/classes/RenderingServer.xml:3365
msgid "Number of objects drawn in a single frame."
msgstr ""
-#: doc/classes/RenderingServer.xml:3360
+#: doc/classes/RenderingServer.xml:3368
msgid "Number of vertices drawn in a single frame."
msgstr ""
-#: doc/classes/RenderingServer.xml:3363
+#: doc/classes/RenderingServer.xml:3371
msgid "Number of material changes during this frame."
msgstr ""
-#: doc/classes/RenderingServer.xml:3366
+#: doc/classes/RenderingServer.xml:3374
msgid "Number of shader changes during this frame."
msgstr ""
-#: doc/classes/RenderingServer.xml:3369
+#: doc/classes/RenderingServer.xml:3377
msgid "Number of surface changes during this frame."
msgstr ""
-#: doc/classes/RenderingServer.xml:3372
+#: doc/classes/RenderingServer.xml:3380
msgid "Number of draw calls during this frame."
msgstr ""
-#: doc/classes/RenderingServer.xml:3375
+#: doc/classes/RenderingServer.xml:3383
msgid "Represents the size of the [enum ViewportRenderInfo] enum."
msgstr ""
-#: doc/classes/RenderingServer.xml:3378
+#: doc/classes/RenderingServer.xml:3386
msgid "Debug draw is disabled. Default setting."
msgstr ""
-#: doc/classes/RenderingServer.xml:3381 doc/classes/Viewport.xml:348
+#: doc/classes/RenderingServer.xml:3389 doc/classes/Viewport.xml:348
msgid "Objects are displayed without light information."
msgstr ""
-#: doc/classes/RenderingServer.xml:3384
+#: doc/classes/RenderingServer.xml:3392
msgid "Objects are displayed with only light information."
msgstr ""
-#: doc/classes/RenderingServer.xml:3387 doc/classes/Viewport.xml:353
+#: doc/classes/RenderingServer.xml:3395 doc/classes/Viewport.xml:353
msgid ""
"Objects are displayed semi-transparent with additive blending so you can see "
"where they are drawing over top of one another. A higher overdraw means you "
@@ -43482,41 +44326,41 @@ msgid ""
"others."
msgstr ""
-#: doc/classes/RenderingServer.xml:3390
+#: doc/classes/RenderingServer.xml:3398
msgid "Debug draw draws objects in wireframe."
msgstr ""
-#: doc/classes/RenderingServer.xml:3393
+#: doc/classes/RenderingServer.xml:3401
msgid ""
"Normal buffer is drawn instead of regular scene so you can see the per-pixel "
"normals that will be used by post-processing effects."
msgstr ""
-#: doc/classes/RenderingServer.xml:3396 doc/classes/Viewport.xml:361
+#: doc/classes/RenderingServer.xml:3404 doc/classes/Viewport.xml:361
msgid "Objects are displayed with only the albedo value from [GIProbe]s."
msgstr ""
-#: doc/classes/RenderingServer.xml:3399 doc/classes/Viewport.xml:364
+#: doc/classes/RenderingServer.xml:3407 doc/classes/Viewport.xml:364
msgid "Objects are displayed with only the lighting value from [GIProbe]s."
msgstr ""
-#: doc/classes/RenderingServer.xml:3402 doc/classes/Viewport.xml:367
+#: doc/classes/RenderingServer.xml:3410 doc/classes/Viewport.xml:367
msgid "Objects are displayed with only the emission color from [GIProbe]s."
msgstr ""
-#: doc/classes/RenderingServer.xml:3405 doc/classes/Viewport.xml:370
+#: doc/classes/RenderingServer.xml:3413 doc/classes/Viewport.xml:370
msgid ""
"Draws the shadow atlas that stores shadows from [OmniLight3D]s and "
"[SpotLight3D]s in the upper left quadrant of the [Viewport]."
msgstr ""
-#: doc/classes/RenderingServer.xml:3408 doc/classes/Viewport.xml:373
+#: doc/classes/RenderingServer.xml:3416 doc/classes/Viewport.xml:373
msgid ""
"Draws the shadow atlas that stores shadows from [DirectionalLight3D]s in the "
"upper left quadrant of the [Viewport]."
msgstr ""
-#: doc/classes/RenderingServer.xml:3413
+#: doc/classes/RenderingServer.xml:3421
msgid ""
"Draws the screen space ambient occlusion texture instead of the scene so "
"that you can clearly see how it is affecting objects. In order for this "
@@ -43524,21 +44368,14 @@ msgid ""
"your [WorldEnvironment]."
msgstr ""
-#: doc/classes/RenderingServer.xml:3416 doc/classes/Viewport.xml:381
-msgid ""
-"Draws the roughness limiter post process over the Viewport so you can see "
-"where it has an effect. It must be enabled in [member ProjectSettings."
-"rendering/quality/screen_filters/screen_space_roughness_limiter] to work."
-msgstr ""
-
-#: doc/classes/RenderingServer.xml:3419
+#: doc/classes/RenderingServer.xml:3424
msgid ""
"Colors each PSSM split for the [DirectionalLight3D]s in the scene a "
"different color so you can see where the splits are. In order they will be "
"colored red, green, blue, yellow."
msgstr ""
-#: doc/classes/RenderingServer.xml:3424
+#: doc/classes/RenderingServer.xml:3435
msgid ""
"Uses high quality importance sampling to process the radiance map. In "
"general, this results in much higher quality than [constant Sky."
@@ -43549,7 +44386,7 @@ msgid ""
"ggx_samples]."
msgstr ""
-#: doc/classes/RenderingServer.xml:3427
+#: doc/classes/RenderingServer.xml:3438
msgid ""
"Uses the fast filtering algorithm to process the radiance map. In general "
"this results in lower quality, but substantially faster run times.\n"
@@ -43557,347 +44394,347 @@ msgid ""
"[member Sky.radiance_size] must be set to [constant Sky.RADIANCE_SIZE_256]."
msgstr ""
-#: doc/classes/RenderingServer.xml:3431
+#: doc/classes/RenderingServer.xml:3442
msgid "Use the clear color as background."
msgstr ""
-#: doc/classes/RenderingServer.xml:3434
+#: doc/classes/RenderingServer.xml:3445
msgid "Use a specified color as the background."
msgstr ""
-#: doc/classes/RenderingServer.xml:3437
+#: doc/classes/RenderingServer.xml:3448
msgid "Use a sky resource for the background."
msgstr ""
-#: doc/classes/RenderingServer.xml:3440
+#: doc/classes/RenderingServer.xml:3451
msgid ""
"Use a specified canvas layer as the background. This can be useful for "
"instantiating a 2D scene in a 3D world."
msgstr ""
-#: doc/classes/RenderingServer.xml:3443
+#: doc/classes/RenderingServer.xml:3454
msgid ""
"Do not clear the background, use whatever was rendered last frame as the "
"background."
msgstr ""
-#: doc/classes/RenderingServer.xml:3449
+#: doc/classes/RenderingServer.xml:3460
msgid "Represents the size of the [enum EnvironmentBG] enum."
msgstr ""
-#: doc/classes/RenderingServer.xml:3488
+#: doc/classes/RenderingServer.xml:3499
msgid "Output color as they came in."
msgstr ""
-#: doc/classes/RenderingServer.xml:3491
+#: doc/classes/RenderingServer.xml:3502
msgid "Use the Reinhard tonemapper."
msgstr ""
-#: doc/classes/RenderingServer.xml:3494
+#: doc/classes/RenderingServer.xml:3505
msgid "Use the filmic tonemapper."
msgstr ""
-#: doc/classes/RenderingServer.xml:3497
+#: doc/classes/RenderingServer.xml:3508
msgid "Use the ACES tonemapper."
msgstr ""
-#: doc/classes/RenderingServer.xml:3508
+#: doc/classes/RenderingServer.xml:3519
msgid "Disables the blur set for SSAO. Will make SSAO look noisier."
msgstr ""
-#: doc/classes/RenderingServer.xml:3511
+#: doc/classes/RenderingServer.xml:3522
msgid "Perform a 1x1 blur on the SSAO output."
msgstr ""
-#: doc/classes/RenderingServer.xml:3514
+#: doc/classes/RenderingServer.xml:3525
msgid "Performs a 2x2 blur on the SSAO output."
msgstr ""
-#: doc/classes/RenderingServer.xml:3517
+#: doc/classes/RenderingServer.xml:3528
msgid "Performs a 3x3 blur on the SSAO output. Use this for smoothest SSAO."
msgstr ""
-#: doc/classes/RenderingServer.xml:3520
+#: doc/classes/RenderingServer.xml:3531
msgid "Lowest quality of screen space ambient occlusion."
msgstr ""
-#: doc/classes/RenderingServer.xml:3523
+#: doc/classes/RenderingServer.xml:3534
msgid "Medium quality screen space ambient occlusion."
msgstr ""
-#: doc/classes/RenderingServer.xml:3526
+#: doc/classes/RenderingServer.xml:3537
msgid "High quality screen space ambient occlusion."
msgstr ""
-#: doc/classes/RenderingServer.xml:3529
+#: doc/classes/RenderingServer.xml:3540
msgid "Highest quality screen space ambient occlusion."
msgstr ""
-#: doc/classes/RenderingServer.xml:3540
+#: doc/classes/RenderingServer.xml:3551
msgid ""
"Lowest quality DOF blur. This is the fastest setting, but you may be able to "
"see filtering artifacts."
msgstr ""
-#: doc/classes/RenderingServer.xml:3543
+#: doc/classes/RenderingServer.xml:3554
msgid "Low quality DOF blur."
msgstr ""
-#: doc/classes/RenderingServer.xml:3546
+#: doc/classes/RenderingServer.xml:3557
msgid "Medium quality DOF blur."
msgstr ""
-#: doc/classes/RenderingServer.xml:3549
+#: doc/classes/RenderingServer.xml:3560
msgid ""
"Highest quality DOF blur. Results in the smoothest looking blur by taking "
"the most samples, but is also significantly slower."
msgstr ""
-#: doc/classes/RenderingServer.xml:3552
+#: doc/classes/RenderingServer.xml:3563
msgid ""
"Calculate the DOF blur using a box filter. The fastest option, but results "
"in obvious lines in blur pattern."
msgstr ""
-#: doc/classes/RenderingServer.xml:3555
+#: doc/classes/RenderingServer.xml:3566
msgid "Calculates DOF blur using a hexagon shaped filter."
msgstr ""
-#: doc/classes/RenderingServer.xml:3558
+#: doc/classes/RenderingServer.xml:3569
msgid ""
"Calculates DOF blur using a circle shaped filter. Best quality and most "
"realistic, but slowest. Use only for areas where a lot of performance can be "
"dedicated to post-processing (e.g. cutscenes)."
msgstr ""
-#: doc/classes/RenderingServer.xml:3573
+#: doc/classes/RenderingServer.xml:3584
msgid "Do not use a debug mode."
msgstr ""
-#: doc/classes/RenderingServer.xml:3576
+#: doc/classes/RenderingServer.xml:3587
msgid "Draw all objects as wireframe models."
msgstr ""
-#: doc/classes/RenderingServer.xml:3579
+#: doc/classes/RenderingServer.xml:3590
msgid ""
"Draw all objects in a way that displays how much overdraw is occurring. "
"Overdraw occurs when a section of pixels is drawn and shaded and then "
"another object covers it up. To optimize a scene, you should reduce overdraw."
msgstr ""
-#: doc/classes/RenderingServer.xml:3582
+#: doc/classes/RenderingServer.xml:3593
msgid ""
"Draw all objects without shading. Equivalent to setting all objects shaders "
"to [code]unshaded[/code]."
msgstr ""
-#: doc/classes/RenderingServer.xml:3585
+#: doc/classes/RenderingServer.xml:3596
msgid "The instance does not have a type."
msgstr ""
-#: doc/classes/RenderingServer.xml:3588
+#: doc/classes/RenderingServer.xml:3599
msgid "The instance is a mesh."
msgstr ""
-#: doc/classes/RenderingServer.xml:3591
+#: doc/classes/RenderingServer.xml:3602
msgid "The instance is a multimesh."
msgstr ""
-#: doc/classes/RenderingServer.xml:3594
+#: doc/classes/RenderingServer.xml:3605
msgid "The instance is an immediate geometry."
msgstr ""
-#: doc/classes/RenderingServer.xml:3597
+#: doc/classes/RenderingServer.xml:3608
msgid "The instance is a particle emitter."
msgstr ""
-#: doc/classes/RenderingServer.xml:3600
+#: doc/classes/RenderingServer.xml:3611
msgid "The instance is a light."
msgstr ""
-#: doc/classes/RenderingServer.xml:3603
+#: doc/classes/RenderingServer.xml:3614
msgid "The instance is a reflection probe."
msgstr ""
-#: doc/classes/RenderingServer.xml:3606
+#: doc/classes/RenderingServer.xml:3617
msgid "The instance is a decal."
msgstr ""
-#: doc/classes/RenderingServer.xml:3609
+#: doc/classes/RenderingServer.xml:3620
msgid "The instance is a GI probe."
msgstr ""
-#: doc/classes/RenderingServer.xml:3612
+#: doc/classes/RenderingServer.xml:3623
msgid "The instance is a lightmap."
msgstr ""
-#: doc/classes/RenderingServer.xml:3615
+#: doc/classes/RenderingServer.xml:3626
msgid "Represents the size of the [enum InstanceType] enum."
msgstr ""
-#: doc/classes/RenderingServer.xml:3618
+#: doc/classes/RenderingServer.xml:3629
msgid ""
"A combination of the flags of geometry instances (mesh, multimesh, immediate "
"and particles)."
msgstr ""
-#: doc/classes/RenderingServer.xml:3621
+#: doc/classes/RenderingServer.xml:3632
msgid "Allows the instance to be used in baked lighting."
msgstr ""
-#: doc/classes/RenderingServer.xml:3624
+#: doc/classes/RenderingServer.xml:3635
msgid "Allows the instance to be used with dynamic global illumination."
msgstr ""
-#: doc/classes/RenderingServer.xml:3627
+#: doc/classes/RenderingServer.xml:3638
msgid "When set, manually requests to draw geometry on next frame."
msgstr ""
-#: doc/classes/RenderingServer.xml:3630
+#: doc/classes/RenderingServer.xml:3641
msgid "Represents the size of the [enum InstanceFlags] enum."
msgstr ""
-#: doc/classes/RenderingServer.xml:3633
+#: doc/classes/RenderingServer.xml:3644
msgid "Disable shadows from this instance."
msgstr ""
-#: doc/classes/RenderingServer.xml:3636
+#: doc/classes/RenderingServer.xml:3647
msgid "Cast shadows from this instance."
msgstr ""
-#: doc/classes/RenderingServer.xml:3639
+#: doc/classes/RenderingServer.xml:3650
msgid ""
"Disable backface culling when rendering the shadow of the object. This is "
"slightly slower but may result in more correct shadows."
msgstr ""
-#: doc/classes/RenderingServer.xml:3642
+#: doc/classes/RenderingServer.xml:3653
msgid ""
"Only render the shadows from the object. The object itself will not be drawn."
msgstr ""
-#: doc/classes/RenderingServer.xml:3645
+#: doc/classes/RenderingServer.xml:3656
msgid "The nine patch gets stretched where needed."
msgstr ""
-#: doc/classes/RenderingServer.xml:3648
+#: doc/classes/RenderingServer.xml:3659
msgid "The nine patch gets filled with tiles where needed."
msgstr ""
-#: doc/classes/RenderingServer.xml:3651
+#: doc/classes/RenderingServer.xml:3662
msgid ""
"The nine patch gets filled with tiles where needed and stretches them a bit "
"if needed."
msgstr ""
-#: doc/classes/RenderingServer.xml:3654
+#: doc/classes/RenderingServer.xml:3665
msgid "Uses the default filter mode for this [Viewport]."
msgstr ""
-#: doc/classes/RenderingServer.xml:3666 doc/classes/Viewport.xml:399
+#: doc/classes/RenderingServer.xml:3677 doc/classes/Viewport.xml:402
msgid ""
"The texture filter blends between the nearest 4 pixels and between the "
"nearest 2 mipmaps."
msgstr ""
-#: doc/classes/RenderingServer.xml:3675
+#: doc/classes/RenderingServer.xml:3686
msgid "Max value for [enum CanvasItemTextureFilter] enum."
msgstr ""
-#: doc/classes/RenderingServer.xml:3678
+#: doc/classes/RenderingServer.xml:3689
msgid "Uses the default repeat mode for this [Viewport]."
msgstr ""
-#: doc/classes/RenderingServer.xml:3681 doc/classes/Viewport.xml:405
+#: doc/classes/RenderingServer.xml:3692 doc/classes/Viewport.xml:408
msgid ""
"Disables textures repeating. Instead, when reading UVs outside the 0-1 "
"range, the value will be clamped to the edge of the texture, resulting in a "
"stretched out look at the borders of the texture."
msgstr ""
-#: doc/classes/RenderingServer.xml:3687 doc/classes/Viewport.xml:411
+#: doc/classes/RenderingServer.xml:3698 doc/classes/Viewport.xml:414
msgid ""
"Flip the texture when repeating so that the edge lines up instead of "
"abruptly changing."
msgstr ""
-#: doc/classes/RenderingServer.xml:3690
+#: doc/classes/RenderingServer.xml:3701
msgid "Max value for [enum CanvasItemTextureRepeat] enum."
msgstr ""
-#: doc/classes/RenderingServer.xml:3693
+#: doc/classes/RenderingServer.xml:3704
msgid "Adds light color additive to the canvas."
msgstr ""
-#: doc/classes/RenderingServer.xml:3696
+#: doc/classes/RenderingServer.xml:3707
msgid "Adds light color subtractive to the canvas."
msgstr ""
-#: doc/classes/RenderingServer.xml:3699
+#: doc/classes/RenderingServer.xml:3710
msgid "The light adds color depending on transparency."
msgstr ""
-#: doc/classes/RenderingServer.xml:3702
+#: doc/classes/RenderingServer.xml:3713
msgid "The light adds color depending on mask."
msgstr ""
-#: doc/classes/RenderingServer.xml:3705
+#: doc/classes/RenderingServer.xml:3716
msgid "Do not apply a filter to canvas light shadows."
msgstr ""
-#: doc/classes/RenderingServer.xml:3708
+#: doc/classes/RenderingServer.xml:3719
msgid "Use PCF5 filtering to filter canvas light shadows."
msgstr ""
-#: doc/classes/RenderingServer.xml:3711
+#: doc/classes/RenderingServer.xml:3722
msgid "Use PCF13 filtering to filter canvas light shadows."
msgstr ""
-#: doc/classes/RenderingServer.xml:3714
+#: doc/classes/RenderingServer.xml:3725
msgid "Max value of the [enum CanvasLightShadowFilter] enum."
msgstr ""
-#: doc/classes/RenderingServer.xml:3717
+#: doc/classes/RenderingServer.xml:3728
msgid "Culling of the canvas occluder is disabled."
msgstr ""
-#: doc/classes/RenderingServer.xml:3720
+#: doc/classes/RenderingServer.xml:3731
msgid "Culling of the canvas occluder is clockwise."
msgstr ""
-#: doc/classes/RenderingServer.xml:3723
+#: doc/classes/RenderingServer.xml:3734
msgid "Culling of the canvas occluder is counterclockwise."
msgstr ""
-#: doc/classes/RenderingServer.xml:3784
+#: doc/classes/RenderingServer.xml:3795
msgid "The amount of objects in the frame."
msgstr ""
-#: doc/classes/RenderingServer.xml:3787
+#: doc/classes/RenderingServer.xml:3798
msgid "The amount of vertices in the frame."
msgstr ""
-#: doc/classes/RenderingServer.xml:3790
+#: doc/classes/RenderingServer.xml:3801
msgid "The amount of modified materials in the frame."
msgstr ""
-#: doc/classes/RenderingServer.xml:3793
+#: doc/classes/RenderingServer.xml:3804
msgid "The amount of shader rebinds in the frame."
msgstr ""
-#: doc/classes/RenderingServer.xml:3796
+#: doc/classes/RenderingServer.xml:3807
msgid "The amount of surface changes in the frame."
msgstr ""
-#: doc/classes/RenderingServer.xml:3799
+#: doc/classes/RenderingServer.xml:3810
msgid "The amount of draw calls in frame."
msgstr ""
-#: doc/classes/RenderingServer.xml:3814
+#: doc/classes/RenderingServer.xml:3825
msgid "Hardware supports shaders. This enum is currently unused in Godot 3.x."
msgstr ""
-#: doc/classes/RenderingServer.xml:3817
+#: doc/classes/RenderingServer.xml:3828
msgid ""
"Hardware supports multithreading. This enum is currently unused in Godot 3.x."
msgstr ""
@@ -43909,13 +44746,13 @@ msgstr ""
#: doc/classes/Resource.xml:7
msgid ""
"Resource is the base class for all Godot-specific resource types, serving "
-"primarily as data containers. They are reference counted and freed when no "
-"longer in use. They are also cached once loaded from disk, so that any "
-"further attempts to load a resource from a given path will return the same "
-"reference (all this in contrast to a [Node], which is not reference counted "
-"and can be instanced from disk as many times as desired). Resources can be "
-"saved externally on disk or bundled into another object, such as a [Node] or "
-"another resource."
+"primarily as data containers. Unlike [Object]s, they are reference-counted "
+"and freed when no longer in use. They are also cached once loaded from disk, "
+"so that any further attempts to load a resource from a given path will "
+"return the same reference (all this in contrast to a [Node], which is not "
+"reference-counted and can be instanced from disk as many times as desired). "
+"Resources can be saved externally on disk or bundled into another object, "
+"such as a [Node] or another resource."
msgstr ""
#: doc/classes/Resource.xml:10
@@ -43924,34 +44761,38 @@ msgid ""
"resources.html"
msgstr ""
-#: doc/classes/Resource.xml:17
+#: doc/classes/Resource.xml:18
msgid ""
"Virtual function which can be overridden to customize the behavior value of "
"[method setup_local_to_scene]."
msgstr ""
-#: doc/classes/Resource.xml:26
+#: doc/classes/Resource.xml:27
msgid ""
"Duplicates the resource, returning a new resource. By default, sub-resources "
-"are shared between resource copies for efficiency, this can be changed by "
-"passing [code]true[/code] to the [code]subresources[/code] argument."
+"are shared between resource copies for efficiency. This can be changed by "
+"passing [code]true[/code] to the [code]subresources[/code] argument which "
+"will copy the subresources.\n"
+"[b]Note:[/b] If [code]subresources[/code] is [code]true[/code], this method "
+"will only perform a shallow copy. Nested resources within subresources will "
+"not be duplicated and will still be shared."
msgstr ""
-#: doc/classes/Resource.xml:33
+#: doc/classes/Resource.xml:35
msgid ""
"If [member resource_local_to_scene] is enabled and the resource was loaded "
"from a [PackedScene] instantiation, returns the local scene where this "
"resource's unique copy is in use. Otherwise, returns [code]null[/code]."
msgstr ""
-#: doc/classes/Resource.xml:40
+#: doc/classes/Resource.xml:42
msgid ""
"Returns the RID of the resource (or an empty RID). Many resources (such as "
"[Texture2D], [Mesh], etc) are high-level abstractions of resources stored in "
"a server, so this function will return the original RID."
msgstr ""
-#: doc/classes/Resource.xml:47
+#: doc/classes/Resource.xml:49
msgid ""
"This method is called when a resource with [member resource_local_to_scene] "
"enabled is loaded from a [PackedScene] instantiation. Its behavior can be "
@@ -43961,7 +44802,7 @@ msgid ""
"local viewport."
msgstr ""
-#: doc/classes/Resource.xml:57
+#: doc/classes/Resource.xml:59
msgid ""
"Sets the path of the resource, potentially overriding an existing cache "
"entry for this path. This differs from setting [member resource_path], as "
@@ -43969,25 +44810,25 @@ msgid ""
"given path."
msgstr ""
-#: doc/classes/Resource.xml:63
+#: doc/classes/Resource.xml:65
msgid ""
"If [code]true[/code], the resource will be made unique in each instance of "
"its local scene. It can thus be modified in a scene instance without "
"impacting other instances of that same scene."
msgstr ""
-#: doc/classes/Resource.xml:66
+#: doc/classes/Resource.xml:68
msgid "The name of the resource. This is an optional identifier."
msgstr ""
-#: doc/classes/Resource.xml:69
+#: doc/classes/Resource.xml:71
msgid ""
"The path to the resource. In case it has its own file, it will return its "
"filepath. If it's tied to the scene, it will return the scene's path, "
"followed by the resource's index."
msgstr ""
-#: doc/classes/Resource.xml:75
+#: doc/classes/Resource.xml:77
msgid "Emitted whenever the resource changes."
msgstr ""
@@ -44806,11 +45647,11 @@ msgid ""
"global coordinate system, but is centered at the object's origin."
msgstr ""
-#: doc/classes/RigidBody2D.xml:87
+#: doc/classes/RigidBody2D.xml:87 doc/classes/RigidBody3D.xml:99
msgid ""
-"Returns a list of the bodies colliding with this one. Use [member "
-"contacts_reported] to set the maximum number reported. You must also set "
-"[member contact_monitor] to [code]true[/code].\n"
+"Returns a list of the bodies colliding with this one. Requires [member "
+"contact_monitor] to be set to [code]true[/code] and [member "
+"contacts_reported] to be set high enough to detect all the collisions.\n"
"[b]Note:[/b] The result of this test is not immediate after moving objects. "
"For performance, list of collisions is updated once per frame and before the "
"physics step. Consider using signals instead."
@@ -44847,7 +45688,7 @@ msgstr ""
msgid "The body's total applied torque."
msgstr ""
-#: doc/classes/RigidBody2D.xml:130 doc/classes/RigidBody3D.xml:150
+#: doc/classes/RigidBody2D.xml:130 doc/classes/RigidBody3D.xml:157
msgid ""
"If [code]true[/code], the body can enter sleep mode when there is no "
"movement. See [member sleeping]."
@@ -44859,11 +45700,17 @@ msgid ""
"another RigidBody2D. See also [member contacts_reported]."
msgstr ""
-#: doc/classes/RigidBody2D.xml:136
-msgid "The maximum number of contacts to report."
+#: doc/classes/RigidBody2D.xml:136 doc/classes/RigidBody3D.xml:163
+msgid ""
+"The maximum number of contacts that will be recorded. Requires [member "
+"contact_monitor] to be set to [code]true[/code].\n"
+"[b]Note:[/b] The number of contacts is different from the number of "
+"collisions. Collisions between parallel edges will result in two contacts "
+"(one at each end), and collisions between parallel faces will result in four "
+"contacts (one at each corner)."
msgstr ""
-#: doc/classes/RigidBody2D.xml:139
+#: doc/classes/RigidBody2D.xml:140
msgid ""
"Continuous collision detection mode.\n"
"Continuous collision detection tries to predict where a moving body will "
@@ -44873,21 +45720,21 @@ msgid ""
"methods are available. See [enum CCDMode] for details."
msgstr ""
-#: doc/classes/RigidBody2D.xml:143
+#: doc/classes/RigidBody2D.xml:144
msgid ""
"If [code]true[/code], internal force integration is disabled for this body. "
"Aside from collision response, the body will only move as determined by the "
"[method _integrate_forces] function."
msgstr ""
-#: doc/classes/RigidBody2D.xml:146
+#: doc/classes/RigidBody2D.xml:147
msgid ""
"Multiplies the gravity applied to the body. The body's gravity is calculated "
"from the [b]Default Gravity[/b] value in [b]Project > Project Settings > "
"Physics > 2d[/b] and/or any additional gravity vector applied by [Area2D]s."
msgstr ""
-#: doc/classes/RigidBody2D.xml:149
+#: doc/classes/RigidBody2D.xml:150
msgid ""
"The body's moment of inertia. This is like mass, but for rotation: it "
"determines how much torque it takes to rotate the body. The moment of "
@@ -44896,18 +45743,18 @@ msgid ""
"automatically computing it."
msgstr ""
-#: doc/classes/RigidBody2D.xml:152
+#: doc/classes/RigidBody2D.xml:153
msgid ""
"Damps the body's [member linear_velocity]. If [code]-1[/code], the body will "
"use the [b]Default Linear Damp[/b] in [b]Project > Project Settings > "
"Physics > 2d[/b]."
msgstr ""
-#: doc/classes/RigidBody2D.xml:161
+#: doc/classes/RigidBody2D.xml:162
msgid "The body's mode. See [enum Mode] for possible values."
msgstr ""
-#: doc/classes/RigidBody2D.xml:164 doc/classes/RigidBody3D.xml:181
+#: doc/classes/RigidBody2D.xml:165 doc/classes/RigidBody3D.xml:189
#: doc/classes/StaticBody2D.xml:22 doc/classes/StaticBody3D.xml:22
msgid ""
"The physics material override for the body.\n"
@@ -44915,50 +45762,50 @@ msgid ""
"other physics material, such as an inherited one."
msgstr ""
-#: doc/classes/RigidBody2D.xml:168 doc/classes/RigidBody3D.xml:185
+#: doc/classes/RigidBody2D.xml:169 doc/classes/RigidBody3D.xml:193
msgid ""
"If [code]true[/code], the body will not move and will not calculate forces "
"until woken up by another body through, for example, a collision, or by "
"using the [method apply_impulse] or [method add_force] methods."
msgstr ""
-#: doc/classes/RigidBody2D.xml:171
+#: doc/classes/RigidBody2D.xml:172
msgid ""
"The body's weight based on its mass and the [b]Default Gravity[/b] value in "
"[b]Project > Project Settings > Physics > 2d[/b]."
msgstr ""
-#: doc/classes/RigidBody2D.xml:179
+#: doc/classes/RigidBody2D.xml:180 doc/classes/RigidBody3D.xml:204
msgid ""
-"Emitted when a body enters into contact with this one. [member "
-"contact_monitor] must be [code]true[/code] and [member contacts_reported] "
-"greater than [code]0[/code]."
+"Emitted when a body enters into contact with this one. Requires [member "
+"contact_monitor] to be set to [code]true[/code] and [member "
+"contacts_reported] to be set high enough to detect all the collisions."
msgstr ""
-#: doc/classes/RigidBody2D.xml:186
+#: doc/classes/RigidBody2D.xml:187
msgid ""
-"Emitted when a body exits contact with this one. [member contact_monitor] "
-"must be [code]true[/code] and [member contacts_reported] greater than "
-"[code]0[/code]."
+"Emitted when a body exits contact with this one. Requires [member "
+"contact_monitor] to be set to [code]true[/code] and [member "
+"contacts_reported] to be set high enough to detect all the collisions."
msgstr ""
-#: doc/classes/RigidBody2D.xml:199
+#: doc/classes/RigidBody2D.xml:200
msgid ""
"Emitted when a body enters into contact with this one. Reports colliding "
"shape information. See [CollisionObject2D] for shape index information. "
-"[member contact_monitor] must be [code]true[/code] and [member "
-"contacts_reported] greater than [code]0[/code]."
+"Requires [member contact_monitor] to be set to [code]true[/code] and [member "
+"contacts_reported] to be set high enough to detect all the collisions."
msgstr ""
-#: doc/classes/RigidBody2D.xml:212
+#: doc/classes/RigidBody2D.xml:213
msgid ""
"Emitted when a body shape exits contact with this one. Reports colliding "
"shape information. See [CollisionObject2D] for shape index information. "
-"[member contact_monitor] must be [code]true[/code] and [member "
-"contacts_reported] greater than [code]0[/code]."
+"Requires [member contact_monitor] to be set to [code]true[/code] and [member "
+"contacts_reported] to be set high enough to detect all the collisions."
msgstr ""
-#: doc/classes/RigidBody2D.xml:217 doc/classes/RigidBody3D.xml:236
+#: doc/classes/RigidBody2D.xml:218 doc/classes/RigidBody3D.xml:244
msgid ""
"Emitted when the physics engine changes the body's sleeping state.\n"
"[b]Note:[/b] Changing the value [member sleeping] will not trigger this "
@@ -44966,41 +45813,41 @@ msgid ""
"engine or [code]emit_signal(\"sleeping_state_changed\")[/code] is used."
msgstr ""
-#: doc/classes/RigidBody2D.xml:224
+#: doc/classes/RigidBody2D.xml:225
msgid ""
"Rigid mode. The body behaves as a physical object. It collides with other "
"bodies and responds to forces applied to it. This is the default mode."
msgstr ""
-#: doc/classes/RigidBody2D.xml:227
+#: doc/classes/RigidBody2D.xml:228
msgid "Static mode. The body behaves like a [StaticBody2D] and does not move."
msgstr ""
-#: doc/classes/RigidBody2D.xml:230
+#: doc/classes/RigidBody2D.xml:231
msgid ""
"Character mode. Similar to [constant MODE_RIGID], but the body can not "
"rotate."
msgstr ""
-#: doc/classes/RigidBody2D.xml:233
+#: doc/classes/RigidBody2D.xml:234
msgid ""
"Kinematic mode. The body behaves like a [KinematicBody2D], and must be moved "
"by code."
msgstr ""
-#: doc/classes/RigidBody2D.xml:236
+#: doc/classes/RigidBody2D.xml:237
msgid ""
"Continuous collision detection disabled. This is the fastest way to detect "
"body collisions, but can miss small, fast-moving objects."
msgstr ""
-#: doc/classes/RigidBody2D.xml:239
+#: doc/classes/RigidBody2D.xml:240
msgid ""
"Continuous collision detection enabled using raycasting. This is faster than "
"shapecasting but less precise."
msgstr ""
-#: doc/classes/RigidBody2D.xml:242
+#: doc/classes/RigidBody2D.xml:243
msgid ""
"Continuous collision detection enabled using shapecasting. This is the "
"slowest CCD method and the most precise."
@@ -45086,42 +45933,31 @@ msgid ""
"locked."
msgstr ""
-#: doc/classes/RigidBody3D.xml:99
+#: doc/classes/RigidBody3D.xml:107
msgid ""
-"Returns a list of the bodies colliding with this one. By default, number of "
-"max contacts reported is at 0, see the [member contacts_reported] property "
-"to increase it.\n"
-"[b]Note:[/b] The result of this test is not immediate after moving objects. "
-"For performance, list of collisions is updated once per frame and before the "
-"physics step. Consider using signals instead."
+"Returns the inverse inertia tensor basis. This is used to calculate the "
+"angular acceleration resulting from a torque applied to the [RigidBody3D]."
msgstr ""
-#: doc/classes/RigidBody3D.xml:111
+#: doc/classes/RigidBody3D.xml:118
msgid "Locks the specified linear or rotational axis."
msgstr ""
-#: doc/classes/RigidBody3D.xml:126
+#: doc/classes/RigidBody3D.xml:133
msgid "Damps RigidBody3D's rotational forces."
msgstr ""
-#: doc/classes/RigidBody3D.xml:129
+#: doc/classes/RigidBody3D.xml:136
msgid "RigidBody3D's rotational velocity."
msgstr ""
-#: doc/classes/RigidBody3D.xml:153
+#: doc/classes/RigidBody3D.xml:160
msgid ""
"If [code]true[/code], the RigidBody3D will emit signals when it collides "
-"with another RigidBody3D."
+"with another RigidBody3D. See also [member contacts_reported]."
msgstr ""
-#: doc/classes/RigidBody3D.xml:156
-msgid ""
-"The maximum contacts to report. Bodies can keep a log of the contacts with "
-"other bodies, this is enabled by setting the maximum amount of contacts "
-"reported to a number greater than 0."
-msgstr ""
-
-#: doc/classes/RigidBody3D.xml:159
+#: doc/classes/RigidBody3D.xml:167
msgid ""
"If [code]true[/code], continuous collision detection is used.\n"
"Continuous collision detection tries to predict where a moving body will "
@@ -45131,7 +45967,7 @@ msgid ""
"faster to compute, but can miss small, fast-moving objects."
msgstr ""
-#: doc/classes/RigidBody3D.xml:163
+#: doc/classes/RigidBody3D.xml:171
msgid ""
"If [code]true[/code], internal force integration will be disabled (like "
"gravity or air friction) for this body. Other than collision response, the "
@@ -45139,7 +45975,7 @@ msgid ""
"function, if defined."
msgstr ""
-#: doc/classes/RigidBody3D.xml:166
+#: doc/classes/RigidBody3D.xml:174
msgid ""
"This is multiplied by the global 3D gravity setting found in [b]Project > "
"Project Settings > Physics > 3d[/b] to produce RigidBody3D's gravity. For "
@@ -45147,14 +45983,14 @@ msgid ""
"and 0.5 will apply half gravity to this object."
msgstr ""
-#: doc/classes/RigidBody3D.xml:169
+#: doc/classes/RigidBody3D.xml:177
msgid ""
"The body's linear damp. Cannot be less than -1.0. If this value is different "
"from -1.0, any linear damp derived from the world or areas will be "
"overridden."
msgstr ""
-#: doc/classes/RigidBody3D.xml:172
+#: doc/classes/RigidBody3D.xml:180
msgid ""
"The body's linear velocity. Can be used sporadically, but [b]don't set this "
"every frame[/b], because physics may run in another thread and runs at a "
@@ -45162,60 +45998,57 @@ msgid ""
"for precise control of the body state."
msgstr ""
-#: doc/classes/RigidBody3D.xml:178
+#: doc/classes/RigidBody3D.xml:186
msgid "The body mode. See [enum Mode] for possible values."
msgstr ""
-#: doc/classes/RigidBody3D.xml:196
-msgid ""
-"Emitted when a body enters into contact with this one. Contact monitor and "
-"contacts reported must be enabled for this to work."
-msgstr ""
-
-#: doc/classes/RigidBody3D.xml:203
+#: doc/classes/RigidBody3D.xml:211
msgid ""
-"Emitted when a body shape exits contact with this one. Contact monitor and "
-"contacts reported must be enabled for this to work."
+"Emitted when a body shape exits contact with this one. Requires [member "
+"contact_monitor] to be set to [code]true[/code] and [member "
+"contacts_reported] to be set high enough to detect all the collisions."
msgstr ""
-#: doc/classes/RigidBody3D.xml:216
+#: doc/classes/RigidBody3D.xml:224
msgid ""
-"Emitted when a body enters into contact with this one. Contact monitor and "
-"contacts reported must be enabled for this to work.\n"
+"Emitted when a body enters into contact with this one. Requires [member "
+"contact_monitor] to be set to [code]true[/code] and [member "
+"contacts_reported] to be set high enough to detect all the collisions.\n"
"This signal not only receives the body that collided with this one, but also "
"its [RID] ([code]body_id[/code]), the shape index from the colliding body "
"([code]body_shape[/code]), and the shape index from this body "
"([code]local_shape[/code]) the other body collided with."
msgstr ""
-#: doc/classes/RigidBody3D.xml:230
+#: doc/classes/RigidBody3D.xml:238
msgid ""
-"Emitted when a body shape exits contact with this one. Contact monitor and "
-"contacts reported must be enabled for this to work.\n"
+"Emitted when a body shape exits contact with this one. Requires [member "
+"contact_monitor] to be set to [code]true[/code] and [member "
+"contacts_reported] to be set high enough to detect all the collisions.\n"
"This signal not only receives the body that stopped colliding with this one, "
"but also its [RID] ([code]body_id[/code]), the shape index from the "
"colliding body ([code]body_shape[/code]), and the shape index from this body "
"([code]local_shape[/code]) the other body stopped colliding with."
msgstr ""
-#: doc/classes/RigidBody3D.xml:243
+#: doc/classes/RigidBody3D.xml:251
msgid ""
"Rigid body mode. This is the \"natural\" state of a rigid body. It is "
"affected by forces, and can move, rotate, and be affected by user code."
msgstr ""
-#: doc/classes/RigidBody3D.xml:246
+#: doc/classes/RigidBody3D.xml:254
msgid ""
"Static mode. The body behaves like a [StaticBody3D], and can only move by "
"user code."
msgstr ""
-#: doc/classes/RigidBody3D.xml:249
+#: doc/classes/RigidBody3D.xml:257
msgid ""
"Character body mode. This behaves like a rigid body, but can not rotate."
msgstr ""
-#: doc/classes/RigidBody3D.xml:252
+#: doc/classes/RigidBody3D.xml:260
msgid ""
"Kinematic body mode. The body behaves like a [KinematicBody3D], and can only "
"move by user code."
@@ -45722,7 +46555,7 @@ msgstr ""
msgid "The time remaining."
msgstr ""
-#: doc/classes/SceneTreeTimer.xml:28 doc/classes/Timer.xml:62
+#: doc/classes/SceneTreeTimer.xml:28 doc/classes/Timer.xml:63
msgid "Emitted when the timer reaches 0."
msgstr ""
@@ -45845,27 +46678,27 @@ msgid ""
"the singleton using [method EditorInterface.get_script_editor]."
msgstr ""
-#: doc/classes/ScriptEditor.xml:40
+#: doc/classes/ScriptEditor.xml:46
msgid "Returns a [Script] that is currently active in editor."
msgstr ""
-#: doc/classes/ScriptEditor.xml:57
+#: doc/classes/ScriptEditor.xml:69
msgid ""
"Returns an array with all [Script] objects which are currently open in "
"editor."
msgstr ""
-#: doc/classes/ScriptEditor.xml:66
+#: doc/classes/ScriptEditor.xml:78
msgid "Goes to the specified line in the current script."
msgstr ""
-#: doc/classes/ScriptEditor.xml:85
+#: doc/classes/ScriptEditor.xml:113
msgid ""
"Emitted when user changed active script. Argument is a freshly activated "
"[Script]."
msgstr ""
-#: doc/classes/ScriptEditor.xml:92
+#: doc/classes/ScriptEditor.xml:120
msgid ""
"Emitted when editor is about to close the active script. Argument is a "
"[Script] that is going to be closed."
@@ -45927,7 +46760,7 @@ msgid ""
"visible."
msgstr ""
-#: doc/classes/ScrollContainer.xml:37 doc/classes/TextEdit.xml:453
+#: doc/classes/ScrollContainer.xml:37 doc/classes/TextEdit.xml:407
msgid "The current horizontal scroll value."
msgstr ""
@@ -45935,7 +46768,7 @@ msgstr ""
msgid "If [code]true[/code], enables horizontal scrolling."
msgstr ""
-#: doc/classes/ScrollContainer.xml:43 doc/classes/TextEdit.xml:456
+#: doc/classes/ScrollContainer.xml:43 doc/classes/TextEdit.xml:410
msgid "The current vertical scroll value."
msgstr ""
@@ -46454,7 +47287,7 @@ msgstr ""
msgid ""
"Sets the global pose transform, [code]pose[/code], for the bone at "
"[code]bone_idx[/code].\n"
-"[code]amount[/code] is the interpolation strengh that will be used when "
+"[code]amount[/code] is the interpolation strength that will be used when "
"applying the pose, and [code]persistent[/code] determines if the applied "
"pose will remain.\n"
"[b]Note[/b]: The pose transform needs to be in bone space. Use [method "
@@ -46471,7 +47304,7 @@ msgstr ""
#: doc/classes/Skeleton3D.xml:266
msgid ""
-"Returns the pose transform for bone [code]bone_idx[/code].\n"
+"Sets the pose transform for bone [code]bone_idx[/code].\n"
"[b]Note[/b]: The pose transform needs to be in bone space. Use [method "
"world_transform_to_bone_transform] to convert a world transform, like one "
"you can get from a [Node3D], to bone space."
@@ -46564,6 +47397,16 @@ msgstr ""
#: doc/classes/Sky.xml:52
msgid ""
+"Automatically selects the appropriate process mode based on your sky shader. "
+"If your shader uses [code]TIME[/code] or [code]POSITION[/code], this will "
+"use [constant PROCESS_MODE_REALTIME]. If your shader uses any of the "
+"[code]LIGHT_*[/code] variables or any custom uniforms, this uses [constant "
+"PROCESS_MODE_INCREMENTAL]. Otherwise, this defaults to [constant "
+"PROCESS_MODE_QUALITY]."
+msgstr ""
+
+#: doc/classes/Sky.xml:55
+msgid ""
"Uses high quality importance sampling to process the radiance map. In "
"general, this results in much higher quality than [constant "
"PROCESS_MODE_REALTIME] but takes much longer to generate. This should not be "
@@ -46573,10 +47416,22 @@ msgid ""
"ggx_samples]."
msgstr ""
-#: doc/classes/Sky.xml:55
+#: doc/classes/Sky.xml:58
+msgid ""
+"Uses the same high quality importance sampling to process the radiance map "
+"as [constant PROCESS_MODE_QUALITY], but updates over several frames. The "
+"number of frames is determined by [member ProjectSettings.rendering/quality/"
+"reflections/roughness_layers]. Use this when you need highest quality "
+"radiance maps, but have a sky that updates slowly."
+msgstr ""
+
+#: doc/classes/Sky.xml:61
msgid ""
"Uses the fast filtering algorithm to process the radiance map. In general "
-"this results in lower quality, but substantially faster run times.\n"
+"this results in lower quality, but substantially faster run times. If you "
+"need better quality, but still need to update the sky every frame, consider "
+"turning on [member ProjectSettings.rendering/quality/reflections/"
+"fast_filter_high_quality].\n"
"[b]Note:[/b] The fast filtering algorithm is limited to 256x256 cubemaps, so "
"[member radiance_size] must be set to [constant RADIANCE_SIZE_256]."
msgstr ""
@@ -46913,9 +47768,7 @@ msgid ""
msgstr ""
#: doc/classes/SpringArm3D.xml:35
-msgid ""
-"Returns the proportion between the current arm length (after checking for "
-"collisions) and the [member spring_length]. Ranges from 0 to 1."
+msgid "Returns the spring arm's current length."
msgstr ""
#: doc/classes/SpringArm3D.xml:44
@@ -47611,7 +48464,7 @@ msgstr ""
msgid ""
"This is the built-in string class (and the one used by GDScript). It "
"supports Unicode and provides all necessary means for string handling. "
-"Strings are reference counted and use a copy-on-write approach, so passing "
+"Strings are reference-counted and use a copy-on-write approach, so passing "
"them around is cheap in resources."
msgstr ""
@@ -47766,26 +48619,32 @@ msgstr ""
#: doc/classes/String.xml:328
msgid ""
"Returns a copy of the string with escaped characters replaced by their "
-"meanings according to the C language standard."
+"meanings. Supported escape sequences are [code]\\'[/code], [code]\\\"[/"
+"code], [code]\\?[/code], [code]\\\\[/code], [code]\\a[/code], [code]\\b[/"
+"code], [code]\\f[/code], [code]\\n[/code], [code]\\r[/code], [code]\\t[/"
+"code], [code]\\v[/code].\n"
+"[b]Note:[/b] Unlike the GDScript parser, this method doesn't support the "
+"[code]\\uXXXX[/code] escape sequence."
msgstr ""
-#: doc/classes/String.xml:335
+#: doc/classes/String.xml:336
msgid ""
-"Changes the case of some letters. Replaces underscores with spaces, converts "
-"all letters to lowercase, then capitalizes first and every letter following "
-"the space character. For [code]capitalize camelCase mixed_with_underscores[/"
-"code], it will return [code]Capitalize Camelcase Mixed With Underscores[/"
+"Changes the case of some letters. Replaces underscores with spaces, adds "
+"spaces before in-word uppercase characters, converts all letters to "
+"lowercase, then capitalizes the first letter and every letter following a "
+"space character. For [code]capitalize camelCase mixed_with_underscores[/"
+"code], it will return [code]Capitalize Camel Case Mixed With Underscores[/"
"code]."
msgstr ""
-#: doc/classes/String.xml:344
+#: doc/classes/String.xml:345
msgid ""
"Performs a case-sensitive comparison to another string. Returns [code]-1[/"
"code] if less than, [code]+1[/code] if greater than, or [code]0[/code] if "
"equal."
msgstr ""
-#: doc/classes/String.xml:357
+#: doc/classes/String.xml:358
msgid ""
"Returns the number of occurrences of substring [code]what[/code] between "
"[code]from[/code] and [code]to[/code] positions. If [code]from[/code] and "
@@ -47793,7 +48652,7 @@ msgid ""
"code] equals 0 the remained substring will be used."
msgstr ""
-#: doc/classes/String.xml:370
+#: doc/classes/String.xml:371
msgid ""
"Returns the number of occurrences of substring [code]what[/code] (ignoring "
"case) between [code]from[/code] and [code]to[/code] positions. If "
@@ -47801,32 +48660,33 @@ msgid ""
"used. If only [code]to[/code] equals 0 the remained substring will be used."
msgstr ""
-#: doc/classes/String.xml:377
+#: doc/classes/String.xml:378
msgid ""
"Returns a copy of the string with indentation (leading tabs and spaces) "
"removed."
msgstr ""
-#: doc/classes/String.xml:384
+#: doc/classes/String.xml:385
msgid ""
"Returns [code]true[/code] if the length of the string equals [code]0[/code]."
msgstr ""
-#: doc/classes/String.xml:393
+#: doc/classes/String.xml:394
msgid "Returns [code]true[/code] if the string ends with the given string."
msgstr ""
-#: doc/classes/String.xml:404
+#: doc/classes/String.xml:405
msgid ""
"Erases [code]chars[/code] characters from the string starting from "
"[code]position[/code]."
msgstr ""
-#: doc/classes/String.xml:415
+#: doc/classes/String.xml:416
msgid ""
-"Finds the first occurrence of a substring. Returns the starting position of "
-"the substring or [code]-1[/code] if not found. Optionally, the initial "
-"search index can be passed.\n"
+"Returns the index of the [b]first[/b] case-sensitive occurrence of the "
+"specified string in this instance, or [code]-1[/code]. Optionally, the "
+"starting search index can be specified, continuing to the end of the "
+"string.\n"
"[b]Note:[/b] If you just want to know whether a string contains a substring, "
"use the [code]in[/code] operator as follows:\n"
"[codeblock]\n"
@@ -47836,48 +48696,42 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/String.xml:430
-msgid ""
-"Finds the last occurrence of a substring. Returns the starting position of "
-"the substring or [code]-1[/code] if not found."
-msgstr ""
-
-#: doc/classes/String.xml:441
+#: doc/classes/String.xml:433
msgid ""
-"Finds the first occurrence of a substring, ignoring case. Returns the "
-"starting position of the substring or [code]-1[/code] if not found. "
-"Optionally, the initial search index can be passed."
+"Returns the index of the [b]first[/b] case-insensitive occurrence of the "
+"specified string in this instance, or [code]-1[/code]. Optionally, the "
+"starting search index can be specified, continuing to the end of the string."
msgstr ""
-#: doc/classes/String.xml:452
+#: doc/classes/String.xml:444
msgid ""
"Formats the string by replacing all occurrences of [code]placeholder[/code] "
"with [code]values[/code]."
msgstr ""
-#: doc/classes/String.xml:459
+#: doc/classes/String.xml:451
msgid "If the string is a valid file path, returns the base directory name."
msgstr ""
-#: doc/classes/String.xml:466
+#: doc/classes/String.xml:458
msgid ""
"If the string is a valid file path, returns the full file path without the "
"extension."
msgstr ""
-#: doc/classes/String.xml:473
+#: doc/classes/String.xml:465
msgid "If the string is a valid file path, returns the extension."
msgstr ""
-#: doc/classes/String.xml:480
+#: doc/classes/String.xml:472
msgid "If the string is a valid file path, returns the filename."
msgstr ""
-#: doc/classes/String.xml:487
+#: doc/classes/String.xml:479
msgid "Hashes the string and returns a 32-bit integer."
msgstr ""
-#: doc/classes/String.xml:494
+#: doc/classes/String.xml:486
msgid ""
"Converts a string containing a hexadecimal number into an integer. "
"Hexadecimal strings are expected to be prefixed with \"[code]0x[/code]\" "
@@ -47887,7 +48741,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/String.xml:504
+#: doc/classes/String.xml:496
msgid ""
"Escapes (encodes) a string to URL friendly format. Also referred to as 'URL "
"encode'.\n"
@@ -47897,7 +48751,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/String.xml:514
+#: doc/classes/String.xml:506
msgid ""
"Unescapes (decodes) a string in URL encoded format. Also referred to as 'URL "
"decode'.\n"
@@ -47907,7 +48761,7 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/String.xml:526
+#: doc/classes/String.xml:518
msgid ""
"Converts [code]size[/code] represented as number of bytes to human-readable "
"format using internationalized set of data size units, namely: B, KiB, MiB, "
@@ -47920,48 +48774,48 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/String.xml:542
+#: doc/classes/String.xml:534
msgid ""
"Returns a copy of the string with the substring [code]what[/code] inserted "
"at the given position."
msgstr ""
-#: doc/classes/String.xml:549
+#: doc/classes/String.xml:541
msgid ""
"If the string is a path to a file or directory, returns [code]true[/code] if "
"the path is absolute."
msgstr ""
-#: doc/classes/String.xml:556
+#: doc/classes/String.xml:548
msgid ""
"If the string is a path to a file or directory, returns [code]true[/code] if "
"the path is relative."
msgstr ""
-#: doc/classes/String.xml:565
+#: doc/classes/String.xml:557
msgid ""
"Returns [code]true[/code] if this string is a subsequence of the given "
"string."
msgstr ""
-#: doc/classes/String.xml:574
+#: doc/classes/String.xml:566
msgid ""
"Returns [code]true[/code] if this string is a subsequence of the given "
"string, without considering case."
msgstr ""
-#: doc/classes/String.xml:581
+#: doc/classes/String.xml:573
msgid ""
"Returns [code]true[/code] if this string is free from characters that aren't "
"allowed in file names, those being:\n"
"[code]: / \\ ? * \" | % < >[/code]"
msgstr ""
-#: doc/classes/String.xml:589
+#: doc/classes/String.xml:581
msgid "Returns [code]true[/code] if this string contains a valid float."
msgstr ""
-#: doc/classes/String.xml:598
+#: doc/classes/String.xml:590
msgid ""
"Returns [code]true[/code] if this string contains a valid hexadecimal "
"number. If [code]with_prefix[/code] is [code]true[/code], then a validity of "
@@ -47969,7 +48823,7 @@ msgid ""
"instance: [code]0xDEADC0DE[/code]."
msgstr ""
-#: doc/classes/String.xml:605
+#: doc/classes/String.xml:597
msgid ""
"Returns [code]true[/code] if this string contains a valid color in "
"hexadecimal HTML notation. Other HTML notations such as named colors or "
@@ -47977,22 +48831,22 @@ msgid ""
"return [code]false[/code]."
msgstr ""
-#: doc/classes/String.xml:612
+#: doc/classes/String.xml:604
msgid ""
"Returns [code]true[/code] if this string is a valid identifier. A valid "
"identifier may contain only letters, digits and underscores ([code]_[/code]) "
"and the first character may not be a digit."
msgstr ""
-#: doc/classes/String.xml:619
+#: doc/classes/String.xml:611
msgid "Returns [code]true[/code] if this string contains a valid integer."
msgstr ""
-#: doc/classes/String.xml:626
+#: doc/classes/String.xml:618
msgid "Returns [code]true[/code] if this string contains a valid IP address."
msgstr ""
-#: doc/classes/String.xml:635
+#: doc/classes/String.xml:627
msgid ""
"Return a [String] which is the concatenation of the [code]parts[/code]. The "
"separator between elements is the string providing this method.\n"
@@ -48002,121 +48856,125 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/String.xml:646
+#: doc/classes/String.xml:638
msgid ""
"Returns a copy of the string with special characters escaped using the JSON "
"standard."
msgstr ""
-#: doc/classes/String.xml:655
+#: doc/classes/String.xml:647
msgid "Returns a number of characters from the left of the string."
msgstr ""
-#: doc/classes/String.xml:662
+#: doc/classes/String.xml:654
msgid "Returns the string's amount of characters."
msgstr ""
-#: doc/classes/String.xml:671
+#: doc/classes/String.xml:663
msgid "Returns a copy of the string with characters removed from the left."
msgstr ""
-#: doc/classes/String.xml:680
+#: doc/classes/String.xml:672
msgid ""
"Does a simple case-sensitive expression match, where [code]\"*\"[/code] "
"matches zero or more arbitrary characters and [code]\"?\"[/code] matches any "
"single character except a period ([code]\".\"[/code])."
msgstr ""
-#: doc/classes/String.xml:689
+#: doc/classes/String.xml:681
msgid ""
"Does a simple case-insensitive expression match, where [code]\"*\"[/code] "
"matches zero or more arbitrary characters and [code]\"?\"[/code] matches any "
"single character except a period ([code]\".\"[/code])."
msgstr ""
-#: doc/classes/String.xml:696
+#: doc/classes/String.xml:688
msgid "Returns the MD5 hash of the string as an array of bytes."
msgstr ""
-#: doc/classes/String.xml:703
+#: doc/classes/String.xml:695
msgid "Returns the MD5 hash of the string as a string."
msgstr ""
-#: doc/classes/String.xml:712
+#: doc/classes/String.xml:704
msgid ""
"Performs a case-insensitive comparison to another string. Returns [code]-1[/"
"code] if less than, [code]+1[/code] if greater than, or [code]0[/code] if "
"equal."
msgstr ""
-#: doc/classes/String.xml:721
+#: doc/classes/String.xml:713
msgid "Returns the character code at position [code]at[/code]."
msgstr ""
-#: doc/classes/String.xml:730
+#: doc/classes/String.xml:722
msgid ""
"Formats a number to have an exact number of [code]digits[/code] after the "
"decimal point."
msgstr ""
-#: doc/classes/String.xml:739
+#: doc/classes/String.xml:731
msgid ""
"Formats a number to have an exact number of [code]digits[/code] before the "
"decimal point."
msgstr ""
-#: doc/classes/String.xml:746
+#: doc/classes/String.xml:738
msgid "Decode a percent-encoded string. See [method percent_encode]."
msgstr ""
-#: doc/classes/String.xml:753
+#: doc/classes/String.xml:745
msgid ""
"Percent-encodes a string. Encodes parameters in a URL when sending a HTTP "
"GET request (and bodies of form-urlencoded POST requests)."
msgstr ""
-#: doc/classes/String.xml:762
+#: doc/classes/String.xml:754
msgid ""
"If the string is a path, this concatenates [code]file[/code] at the end of "
"the string as a subpath. E.g. [code]\"this/is\".plus_file(\"path\") == "
"\"this/is/path\"[/code]."
msgstr ""
-#: doc/classes/String.xml:771
+#: doc/classes/String.xml:763
msgid ""
"Returns original string repeated a number of times. The number of "
"repetitions is given by the argument."
msgstr ""
-#: doc/classes/String.xml:782
+#: doc/classes/String.xml:774
msgid ""
"Replaces occurrences of a case-sensitive substring with the given one inside "
"the string."
msgstr ""
-#: doc/classes/String.xml:793
+#: doc/classes/String.xml:785
msgid ""
"Replaces occurrences of a case-insensitive substring with the given one "
"inside the string."
msgstr ""
-#: doc/classes/String.xml:804
+#: doc/classes/String.xml:796
msgid ""
-"Performs a case-sensitive search for a substring, but starts from the end of "
-"the string instead of the beginning."
+"Returns the index of the [b]last[/b] case-sensitive occurrence of the "
+"specified string in this instance, or [code]-1[/code]. Optionally, the "
+"starting search index can be specified, continuing to the beginning of the "
+"string."
msgstr ""
-#: doc/classes/String.xml:815
+#: doc/classes/String.xml:807
msgid ""
-"Performs a case-insensitive search for a substring, but starts from the end "
-"of the string instead of the beginning."
+"Returns the index of the [b]last[/b] case-insensitive occurrence of the "
+"specified string in this instance, or [code]-1[/code]. Optionally, the "
+"starting search index can be specified, continuing to the beginning of the "
+"string."
msgstr ""
-#: doc/classes/String.xml:824
+#: doc/classes/String.xml:816
msgid "Returns the right side of the string from a given position."
msgstr ""
-#: doc/classes/String.xml:837
+#: doc/classes/String.xml:829
msgid ""
"Splits the string by a [code]delimiter[/code] string and returns an array of "
"the substrings, starting from right.\n"
@@ -48135,39 +48993,39 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/String.xml:856
+#: doc/classes/String.xml:848
msgid "Returns a copy of the string with characters removed from the right."
msgstr ""
-#: doc/classes/String.xml:863
+#: doc/classes/String.xml:855
msgid "Returns the SHA-1 hash of the string as an array of bytes."
msgstr ""
-#: doc/classes/String.xml:870
+#: doc/classes/String.xml:862
msgid "Returns the SHA-1 hash of the string as a string."
msgstr ""
-#: doc/classes/String.xml:877
+#: doc/classes/String.xml:869
msgid "Returns the SHA-256 hash of the string as an array of bytes."
msgstr ""
-#: doc/classes/String.xml:884
+#: doc/classes/String.xml:876
msgid "Returns the SHA-256 hash of the string as a string."
msgstr ""
-#: doc/classes/String.xml:893
+#: doc/classes/String.xml:885
msgid ""
"Returns the similarity index of the text compared to this string. 1 means "
"totally similar and 0 means totally dissimilar."
msgstr ""
-#: doc/classes/String.xml:906
+#: doc/classes/String.xml:898
msgid ""
"Splits the string by a [code]delimiter[/code] string and returns an array of "
-"the substrings.\n"
+"the substrings. The [code]delimiter[/code] can be of any length.\n"
"If [code]maxsplit[/code] is specified, it defines the number of splits to do "
-"from the left up to [code]maxsplit[/code]. The default value of 0 means that "
-"all items are split.\n"
+"from the left up to [code]maxsplit[/code]. The default value of [code]0[/"
+"code] means that all items are split.\n"
"Example:\n"
"[codeblock]\n"
"var some_string = \"One,Two,Three,Four\"\n"
@@ -48175,10 +49033,12 @@ msgid ""
"print(some_array.size()) # Prints 2\n"
"print(some_array[0]) # Prints \"One\"\n"
"print(some_array[1]) # Prints \"Two,Three,Four\"\n"
-"[/codeblock]"
+"[/codeblock]\n"
+"If you need to split strings with more complex rules, use the [RegEx] class "
+"instead."
msgstr ""
-#: doc/classes/String.xml:926
+#: doc/classes/String.xml:919
msgid ""
"Splits the string in floats by using a delimiter string and returns an array "
"of the substrings.\n"
@@ -48186,7 +49046,7 @@ msgid ""
"split by [code]\",\"[/code]."
msgstr ""
-#: doc/classes/String.xml:938
+#: doc/classes/String.xml:931
msgid ""
"Returns a copy of the string stripped of any non-printable character "
"(including tabulations, spaces and line breaks) at the beginning and the "
@@ -48194,7 +49054,7 @@ msgid ""
"right edges respectively."
msgstr ""
-#: doc/classes/String.xml:945
+#: doc/classes/String.xml:938
msgid ""
"Returns a copy of the string stripped of any escape character. These include "
"all non-printable control characters of the first page of the ASCII table (< "
@@ -48202,14 +49062,14 @@ msgid ""
"code] and [code]\\r[/code]) characters, but not spaces."
msgstr ""
-#: doc/classes/String.xml:956
+#: doc/classes/String.xml:949
msgid ""
"Returns part of the string from the position [code]from[/code] with length "
"[code]len[/code]. Argument [code]len[/code] is optional and using [code]-1[/"
"code] will return remaining characters from given position."
msgstr ""
-#: doc/classes/String.xml:963
+#: doc/classes/String.xml:956
msgid ""
"Converts the String (which is a character array) to [PackedByteArray] (which "
"is an array of bytes). The conversion is faster compared to [method "
@@ -48217,25 +49077,25 @@ msgid ""
"ASCII characters."
msgstr ""
-#: doc/classes/String.xml:970
+#: doc/classes/String.xml:963
msgid ""
"Converts a string containing a decimal number into a [code]float[/code]."
msgstr ""
-#: doc/classes/String.xml:977
+#: doc/classes/String.xml:970
msgid ""
"Converts a string containing an integer number into an [code]int[/code]."
msgstr ""
-#: doc/classes/String.xml:984
+#: doc/classes/String.xml:977
msgid "Returns the string converted to lowercase."
msgstr ""
-#: doc/classes/String.xml:991
+#: doc/classes/String.xml:984
msgid "Returns the string converted to uppercase."
msgstr ""
-#: doc/classes/String.xml:998
+#: doc/classes/String.xml:991
msgid ""
"Converts the String (which is an array of characters) to [PackedByteArray] "
"(which is an array of bytes). The conversion is a bit slower than [method "
@@ -48243,25 +49103,25 @@ msgid ""
"this function over [method to_ascii]."
msgstr ""
-#: doc/classes/String.xml:1007
+#: doc/classes/String.xml:1000
msgid ""
"Removes a given string from the start if it starts with it or leaves the "
"string unchanged."
msgstr ""
-#: doc/classes/String.xml:1016
+#: doc/classes/String.xml:1009
msgid ""
"Removes a given string from the end if it ends with it or leaves the string "
"unchanged."
msgstr ""
-#: doc/classes/String.xml:1023
+#: doc/classes/String.xml:1016
msgid ""
"Returns a copy of the string with special characters escaped using the XML "
"standard."
msgstr ""
-#: doc/classes/String.xml:1030
+#: doc/classes/String.xml:1023
msgid ""
"Returns a copy of the string with escaped characters replaced by their "
"meanings according to the XML standard."
@@ -49493,50 +50353,42 @@ msgid ""
"undo/redo."
msgstr ""
-#: doc/classes/TextEdit.xml:24
-msgid "Adds color region (given the delimiters) and its colors."
-msgstr ""
-
-#: doc/classes/TextEdit.xml:35
-msgid "Adds a [code]keyword[/code] and its [Color]."
-msgstr ""
-
-#: doc/classes/TextEdit.xml:44
+#: doc/classes/TextEdit.xml:18
msgid ""
"Returns if the given line is foldable, that is, it has indented lines right "
"below it."
msgstr ""
-#: doc/classes/TextEdit.xml:57
+#: doc/classes/TextEdit.xml:25
msgid ""
-"Clears all custom syntax coloring information previously added with [method "
-"add_color_region] or [method add_keyword_color]."
+"Centers the viewport on the line the editing cursor is at. This also resets "
+"the [member scroll_horizontal] value to [code]0[/code]."
msgstr ""
-#: doc/classes/TextEdit.xml:64
+#: doc/classes/TextEdit.xml:32
msgid "Clears the undo history."
msgstr ""
-#: doc/classes/TextEdit.xml:71
+#: doc/classes/TextEdit.xml:39
msgid "Copy's the current text selection."
msgstr ""
-#: doc/classes/TextEdit.xml:78
+#: doc/classes/TextEdit.xml:46
msgid "Returns the column the editing cursor is at."
msgstr ""
-#: doc/classes/TextEdit.xml:85
+#: doc/classes/TextEdit.xml:53
msgid "Returns the line the editing cursor is at."
msgstr ""
-#: doc/classes/TextEdit.xml:96
+#: doc/classes/TextEdit.xml:64
msgid ""
"Moves the cursor at the specified [code]column[/code] index.\n"
"If [code]adjust_viewport[/code] is set to [code]true[/code], the viewport "
"will center at the cursor position after the move occurs."
msgstr ""
-#: doc/classes/TextEdit.xml:112
+#: doc/classes/TextEdit.xml:80
msgid ""
"Moves the cursor at the specified [code]line[/code] index.\n"
"If [code]adjust_viewport[/code] is set to [code]true[/code], the viewport "
@@ -49545,111 +50397,101 @@ msgid ""
"[code]line[/code] can be hidden using [method set_line_as_hidden]."
msgstr ""
-#: doc/classes/TextEdit.xml:121
+#: doc/classes/TextEdit.xml:89
msgid "Cut's the current selection."
msgstr ""
-#: doc/classes/TextEdit.xml:128
+#: doc/classes/TextEdit.xml:96
msgid "Deselects the current selection."
msgstr ""
-#: doc/classes/TextEdit.xml:135
+#: doc/classes/TextEdit.xml:103
msgid "Folds all lines that are possible to be folded (see [method can_fold])."
msgstr ""
-#: doc/classes/TextEdit.xml:144
+#: doc/classes/TextEdit.xml:112
msgid "Folds the given line, if possible (see [method can_fold])."
msgstr ""
-#: doc/classes/TextEdit.xml:151
+#: doc/classes/TextEdit.xml:119
msgid "Returns an array containing the line number of each breakpoint."
msgstr ""
-#: doc/classes/TextEdit.xml:160
-msgid "Returns the [Color] of the specified [code]keyword[/code]."
-msgstr ""
-
-#: doc/classes/TextEdit.xml:169
+#: doc/classes/TextEdit.xml:128
msgid "Returns the text of a specific line."
msgstr ""
-#: doc/classes/TextEdit.xml:176
+#: doc/classes/TextEdit.xml:135
msgid "Returns the amount of total lines in the text."
msgstr ""
-#: doc/classes/TextEdit.xml:183
+#: doc/classes/TextEdit.xml:142
msgid ""
"Returns the [PopupMenu] of this [TextEdit]. By default, this menu is "
"displayed when right-clicking on the [TextEdit]."
msgstr ""
-#: doc/classes/TextEdit.xml:190
+#: doc/classes/TextEdit.xml:149
msgid "Returns the selection begin column."
msgstr ""
-#: doc/classes/TextEdit.xml:197
+#: doc/classes/TextEdit.xml:156
msgid "Returns the selection begin line."
msgstr ""
-#: doc/classes/TextEdit.xml:204
+#: doc/classes/TextEdit.xml:163
msgid "Returns the text inside the selection."
msgstr ""
-#: doc/classes/TextEdit.xml:211
+#: doc/classes/TextEdit.xml:170
msgid "Returns the selection end column."
msgstr ""
-#: doc/classes/TextEdit.xml:218
+#: doc/classes/TextEdit.xml:177
msgid "Returns the selection end line."
msgstr ""
-#: doc/classes/TextEdit.xml:225
+#: doc/classes/TextEdit.xml:184
msgid "Returns a [String] text with the word under the mouse cursor location."
msgstr ""
-#: doc/classes/TextEdit.xml:234
-msgid ""
-"Returns whether the specified [code]keyword[/code] has a color set to it or "
-"not."
-msgstr ""
-
-#: doc/classes/TextEdit.xml:243
+#: doc/classes/TextEdit.xml:193
msgid "Insert the specified text at the cursor position."
msgstr ""
-#: doc/classes/TextEdit.xml:252
+#: doc/classes/TextEdit.xml:202
msgid "Returns whether the line at the specified index is folded or not."
msgstr ""
-#: doc/classes/TextEdit.xml:261
+#: doc/classes/TextEdit.xml:211
msgid "Returns whether the line at the specified index is hidden or not."
msgstr ""
-#: doc/classes/TextEdit.xml:268
+#: doc/classes/TextEdit.xml:218
msgid "Returns [code]true[/code] if the selection is active."
msgstr ""
-#: doc/classes/TextEdit.xml:277
+#: doc/classes/TextEdit.xml:227
msgid ""
"Triggers a right-click menu action by the specified index. See [enum "
"MenuItems] for a list of available indexes."
msgstr ""
-#: doc/classes/TextEdit.xml:284
+#: doc/classes/TextEdit.xml:234
msgid "Paste the current selection."
msgstr ""
-#: doc/classes/TextEdit.xml:291
+#: doc/classes/TextEdit.xml:241
msgid "Perform redo operation."
msgstr ""
-#: doc/classes/TextEdit.xml:298
+#: doc/classes/TextEdit.xml:248
msgid ""
"Removes all the breakpoints. This will not fire the [signal "
"breakpoint_toggled] signal."
msgstr ""
-#: doc/classes/TextEdit.xml:313
+#: doc/classes/TextEdit.xml:263
msgid ""
"Perform a search inside the text. Search flags can be specified in the [enum "
"SearchFlags] enum.\n"
@@ -49665,244 +50507,266 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/TextEdit.xml:336
-msgid "Perform selection, from line/column to line/column."
+#: doc/classes/TextEdit.xml:286
+msgid ""
+"Perform selection, from line/column to line/column.\n"
+"If [member selecting_enabled] is [code]false[/code], no selection will occur."
msgstr ""
-#: doc/classes/TextEdit.xml:343
-msgid "Select all the text."
+#: doc/classes/TextEdit.xml:294
+msgid ""
+"Select all the text.\n"
+"If [member selecting_enabled] is [code]false[/code], no selection will occur."
msgstr ""
-#: doc/classes/TextEdit.xml:354
+#: doc/classes/TextEdit.xml:306
msgid "Sets the text for a specific line."
msgstr ""
-#: doc/classes/TextEdit.xml:365
+#: doc/classes/TextEdit.xml:317
msgid "If [code]true[/code], hides the line of the specified index."
msgstr ""
-#: doc/classes/TextEdit.xml:374
+#: doc/classes/TextEdit.xml:326
msgid "Toggle the folding of the code block at the given line."
msgstr ""
-#: doc/classes/TextEdit.xml:381
+#: doc/classes/TextEdit.xml:333
msgid "Perform undo operation."
msgstr ""
-#: doc/classes/TextEdit.xml:390
+#: doc/classes/TextEdit.xml:342
msgid "Unfolds the given line, if folded."
msgstr ""
-#: doc/classes/TextEdit.xml:397
+#: doc/classes/TextEdit.xml:349
msgid ""
"Unhide all lines that were previously set to hidden by [method "
"set_line_as_hidden]."
msgstr ""
-#: doc/classes/TextEdit.xml:403
+#: doc/classes/TextEdit.xml:355
msgid "If [code]true[/code], the breakpoint gutter is visible."
msgstr ""
-#: doc/classes/TextEdit.xml:412
+#: doc/classes/TextEdit.xml:364
msgid ""
"If [code]true[/code], the caret displays as a rectangle.\n"
"If [code]false[/code], the caret displays as a bar."
msgstr ""
-#: doc/classes/TextEdit.xml:416
+#: doc/classes/TextEdit.xml:368
msgid ""
"If [code]true[/code], a right-click moves the cursor at the mouse position "
"before displaying the context menu.\n"
"If [code]false[/code], the context menu disregards mouse location."
msgstr ""
-#: doc/classes/TextEdit.xml:420
+#: doc/classes/TextEdit.xml:372
msgid "If [code]true[/code], a right-click displays the context menu."
msgstr ""
-#: doc/classes/TextEdit.xml:423
+#: doc/classes/TextEdit.xml:375
msgid ""
"If [code]true[/code], the \"space\" character will have a visible "
"representation."
msgstr ""
-#: doc/classes/TextEdit.xml:426
+#: doc/classes/TextEdit.xml:378
msgid ""
"If [code]true[/code], the \"tab\" character will have a visible "
"representation."
msgstr ""
-#: doc/classes/TextEdit.xml:430
+#: doc/classes/TextEdit.xml:382
msgid ""
"If [code]true[/code], the fold gutter is visible. This enables folding "
"groups of indented lines."
msgstr ""
-#: doc/classes/TextEdit.xml:433
+#: doc/classes/TextEdit.xml:385
msgid ""
"If [code]true[/code], all lines that have been set to hidden by [method "
"set_line_as_hidden], will not be visible."
msgstr ""
-#: doc/classes/TextEdit.xml:436
+#: doc/classes/TextEdit.xml:388
msgid ""
"If [code]true[/code], all occurrences of the selected text will be "
"highlighted."
msgstr ""
-#: doc/classes/TextEdit.xml:439
+#: doc/classes/TextEdit.xml:391
msgid "If [code]true[/code], the line containing the cursor is highlighted."
msgstr ""
-#: doc/classes/TextEdit.xml:447
+#: doc/classes/TextEdit.xml:394
+msgid ""
+"If [code]true[/code], a minimap is shown, providing an outline of your "
+"source code."
+msgstr ""
+
+#: doc/classes/TextEdit.xml:397
+msgid "The width, in pixels, of the minimap."
+msgstr ""
+
+#: doc/classes/TextEdit.xml:401
msgid ""
"If [code]true[/code], custom [code]font_color_selected[/code] will be used "
"for selected text."
msgstr ""
-#: doc/classes/TextEdit.xml:450
+#: doc/classes/TextEdit.xml:404
msgid ""
"If [code]true[/code], read-only mode is enabled. Existing text cannot be "
"modified and new text cannot be added."
msgstr ""
-#: doc/classes/TextEdit.xml:463
+#: doc/classes/TextEdit.xml:413
msgid ""
-"If [code]true[/code], line numbers are displayed to the left of the text."
+"If [code]true[/code], text can be selected.\n"
+"If [code]false[/code], text can not be selected by the user or by the "
+"[method select] or [method select_all] methods."
msgstr ""
-#: doc/classes/TextEdit.xml:466
+#: doc/classes/TextEdit.xml:417
+#, fuzzy
msgid ""
-"If [code]true[/code], sets the [code]step[/code] of the scrollbars to "
-"[code]0.25[/code] which results in smoother scrolling."
+"If [code]true[/code], shortcut keys for context menu items are enabled, even "
+"if the context menu is disabled."
+msgstr "如果为 [code]true[/code],则对子节点进行排序,否则将禁用排序。"
+
+#: doc/classes/TextEdit.xml:420
+msgid ""
+"If [code]true[/code], line numbers are displayed to the left of the text."
msgstr ""
-#: doc/classes/TextEdit.xml:469
+#: doc/classes/TextEdit.xml:423
msgid ""
-"If [code]true[/code], any custom color properties that have been set for "
-"this [TextEdit] will be visible."
+"If [code]true[/code], sets the [code]step[/code] of the scrollbars to "
+"[code]0.25[/code] which results in smoother scrolling."
msgstr ""
-#: doc/classes/TextEdit.xml:472
+#: doc/classes/TextEdit.xml:428
msgid "String value of the [TextEdit]."
msgstr ""
-#: doc/classes/TextEdit.xml:475
+#: doc/classes/TextEdit.xml:431
msgid "Vertical scroll sensitivity."
msgstr ""
-#: doc/classes/TextEdit.xml:478
+#: doc/classes/TextEdit.xml:437
msgid ""
"If [code]true[/code], enables text wrapping when it goes beyond the edge of "
"what is visible."
msgstr ""
-#: doc/classes/TextEdit.xml:486
+#: doc/classes/TextEdit.xml:445
msgid "Emitted when a breakpoint is placed via the breakpoint gutter."
msgstr ""
-#: doc/classes/TextEdit.xml:491
+#: doc/classes/TextEdit.xml:450
msgid "Emitted when the cursor changes."
msgstr ""
-#: doc/classes/TextEdit.xml:500
+#: doc/classes/TextEdit.xml:459
msgid "Emitted when the info icon is clicked."
msgstr ""
-#: doc/classes/TextEdit.xml:531
+#: doc/classes/TextEdit.xml:496
msgid "Match case when searching."
msgstr ""
-#: doc/classes/TextEdit.xml:534
+#: doc/classes/TextEdit.xml:499
msgid "Match whole words when searching."
msgstr ""
-#: doc/classes/TextEdit.xml:537
+#: doc/classes/TextEdit.xml:502
msgid "Search from end to beginning."
msgstr ""
-#: doc/classes/TextEdit.xml:546
+#: doc/classes/TextEdit.xml:511
msgid ""
"Pastes the clipboard text over the selected text (or at the cursor's "
"position)."
msgstr ""
-#: doc/classes/TextEdit.xml:549
+#: doc/classes/TextEdit.xml:514
msgid "Erases the whole [TextEdit] text."
msgstr ""
-#: doc/classes/TextEdit.xml:552
+#: doc/classes/TextEdit.xml:517
msgid "Selects the whole [TextEdit] text."
msgstr ""
-#: doc/classes/TextEdit.xml:558
+#: doc/classes/TextEdit.xml:523
msgid "Redoes the previous action."
msgstr ""
-#: doc/classes/TextEdit.xml:566
+#: doc/classes/TextEdit.xml:531
msgid ""
"Sets the background [Color] of this [TextEdit]. [member syntax_highlighting] "
"has to be enabled."
msgstr ""
-#: doc/classes/TextEdit.xml:569
+#: doc/classes/TextEdit.xml:534
msgid ""
"Sets the [Color] of the bookmark marker. [member syntax_highlighting] has to "
"be enabled."
msgstr ""
-#: doc/classes/TextEdit.xml:574 doc/classes/TextEdit.xml:601
+#: doc/classes/TextEdit.xml:539 doc/classes/TextEdit.xml:566
msgid ""
"Sets the [Color] of the breakpoints. [member breakpoint_gutter] has to be "
"enabled."
msgstr ""
-#: doc/classes/TextEdit.xml:612
+#: doc/classes/TextEdit.xml:577
msgid "Sets the default [Font]."
msgstr ""
-#: doc/classes/TextEdit.xml:615
+#: doc/classes/TextEdit.xml:580
msgid "Sets the font [Color]."
msgstr ""
-#: doc/classes/TextEdit.xml:620
+#: doc/classes/TextEdit.xml:585
msgid ""
"Sets the [Color] of the selected text. [member override_selected_font_color] "
"has to be enabled."
msgstr ""
-#: doc/classes/TextEdit.xml:625
+#: doc/classes/TextEdit.xml:588
msgid ""
"Sets the [Color] of the line numbers. [member show_line_numbers] has to be "
"enabled."
msgstr ""
-#: doc/classes/TextEdit.xml:628
+#: doc/classes/TextEdit.xml:591
msgid "Sets the spacing between the lines."
msgstr ""
-#: doc/classes/TextEdit.xml:631
+#: doc/classes/TextEdit.xml:594
msgid "Sets the [Color] of marked text."
msgstr ""
-#: doc/classes/TextEdit.xml:636
+#: doc/classes/TextEdit.xml:597
msgid "Sets the [StyleBox] of this [TextEdit]."
msgstr ""
-#: doc/classes/TextEdit.xml:641
+#: doc/classes/TextEdit.xml:600
msgid ""
"Sets the [StyleBox] of this [TextEdit] when [member readonly] is enabled."
msgstr ""
-#: doc/classes/TextEdit.xml:646
+#: doc/classes/TextEdit.xml:605
msgid "Sets the highlight [Color] of text selections."
msgstr ""
-#: doc/classes/TextEdit.xml:653
+#: doc/classes/TextEdit.xml:610
msgid "Sets a custom [Texture2D] for tab text characters."
msgstr ""
-#: doc/classes/TextEdit.xml:656
+#: doc/classes/TextEdit.xml:613
msgid ""
"Sets the highlight [Color] of multiple occurrences. [member "
"highlight_all_occurrences] has to be enabled."
@@ -49980,80 +50844,80 @@ msgid ""
"the texture will not scale with the node."
msgstr ""
-#: doc/classes/TextureButton.xml:19
+#: doc/classes/TextureButton.xml:25
msgid ""
"Controls the texture's behavior when you resize the node's bounding "
"rectangle, [b]only if[/b] [member expand] is [code]true[/code]. Set it to "
"one of the [enum StretchMode] constants. See the constants to learn more."
msgstr ""
-#: doc/classes/TextureButton.xml:22
+#: doc/classes/TextureButton.xml:28
msgid ""
"Pure black and white [BitMap] image to use for click detection. On the mask, "
"white pixels represent the button's clickable area. Use it to create buttons "
"with curved shapes."
msgstr ""
-#: doc/classes/TextureButton.xml:25
+#: doc/classes/TextureButton.xml:31
msgid ""
"Texture to display when the node is disabled. See [member BaseButton."
"disabled]."
msgstr ""
-#: doc/classes/TextureButton.xml:28
+#: doc/classes/TextureButton.xml:34
msgid "Texture to display when the node has mouse or keyboard focus."
msgstr ""
-#: doc/classes/TextureButton.xml:31
+#: doc/classes/TextureButton.xml:37
msgid "Texture to display when the mouse hovers the node."
msgstr ""
-#: doc/classes/TextureButton.xml:34
+#: doc/classes/TextureButton.xml:40
msgid ""
"Texture to display by default, when the node is [b]not[/b] in the disabled, "
"focused, hover or pressed state."
msgstr ""
-#: doc/classes/TextureButton.xml:37
+#: doc/classes/TextureButton.xml:43
msgid ""
"Texture to display on mouse down over the node, if the node has keyboard "
"focus and the player presses the Enter key or if the player presses the "
"[member BaseButton.shortcut] key."
msgstr ""
-#: doc/classes/TextureButton.xml:42 doc/classes/TextureRect.xml:36
+#: doc/classes/TextureButton.xml:48 doc/classes/TextureRect.xml:36
msgid "Scale to fit the node's bounding rectangle."
msgstr ""
-#: doc/classes/TextureButton.xml:45 doc/classes/TextureRect.xml:39
+#: doc/classes/TextureButton.xml:51 doc/classes/TextureRect.xml:39
msgid "Tile inside the node's bounding rectangle."
msgstr ""
-#: doc/classes/TextureButton.xml:48 doc/classes/TextureRect.xml:42
+#: doc/classes/TextureButton.xml:54 doc/classes/TextureRect.xml:42
msgid ""
"The texture keeps its original size and stays in the bounding rectangle's "
"top-left corner."
msgstr ""
-#: doc/classes/TextureButton.xml:51 doc/classes/TextureRect.xml:45
+#: doc/classes/TextureButton.xml:57 doc/classes/TextureRect.xml:45
msgid ""
"The texture keeps its original size and stays centered in the node's "
"bounding rectangle."
msgstr ""
-#: doc/classes/TextureButton.xml:54 doc/classes/TextureRect.xml:48
+#: doc/classes/TextureButton.xml:60 doc/classes/TextureRect.xml:48
msgid ""
"Scale the texture to fit the node's bounding rectangle, but maintain the "
"texture's aspect ratio."
msgstr ""
-#: doc/classes/TextureButton.xml:57
+#: doc/classes/TextureButton.xml:63
msgid ""
"Scale the texture to fit the node's bounding rectangle, center it, and "
"maintain its aspect ratio."
msgstr ""
-#: doc/classes/TextureButton.xml:60 doc/classes/TextureRect.xml:54
+#: doc/classes/TextureButton.xml:66 doc/classes/TextureRect.xml:54
msgid ""
"Scale the texture so that the shorter side fits the bounding rectangle. The "
"other side clips to the node's limits."
@@ -50503,19 +51367,25 @@ msgid ""
"advised if working with shared objects."
msgstr ""
-#: doc/classes/Thread.xml:17
+#: doc/classes/Thread.xml:11
+msgid ""
+"https://docs.godotengine.org/en/latest/tutorials/threads/thread_safe_apis."
+"html"
+msgstr ""
+
+#: doc/classes/Thread.xml:18
msgid ""
"Returns the current [Thread]'s ID, uniquely identifying it among all threads."
msgstr ""
-#: doc/classes/Thread.xml:24
+#: doc/classes/Thread.xml:25
msgid ""
"Returns [code]true[/code] if this [Thread] is currently active. An active "
"[Thread] cannot start work on a new method but can be joined with [method "
"wait_to_finish]."
msgstr ""
-#: doc/classes/Thread.xml:39
+#: doc/classes/Thread.xml:40
msgid ""
"Starts a new [Thread] that runs [code]method[/code] on object "
"[code]instance[/code] with [code]userdata[/code] passed as an argument. Even "
@@ -50525,21 +51395,21 @@ msgid ""
"Returns [constant OK] on success, or [constant ERR_CANT_CREATE] on failure."
msgstr ""
-#: doc/classes/Thread.xml:47
+#: doc/classes/Thread.xml:48
msgid ""
"Joins the [Thread] and waits for it to finish. Returns what the method "
"called returned."
msgstr ""
-#: doc/classes/Thread.xml:53
+#: doc/classes/Thread.xml:54
msgid "A thread running with lower priority than normally."
msgstr ""
-#: doc/classes/Thread.xml:56
+#: doc/classes/Thread.xml:57
msgid "A thread with a standard priority."
msgstr ""
-#: doc/classes/Thread.xml:59
+#: doc/classes/Thread.xml:60
msgid "A thread running with higher priority than normally."
msgstr ""
@@ -51074,50 +51944,61 @@ msgid "Returns the [Transform2D] of a tile's shape."
msgstr ""
#: doc/classes/TileSet.xml:481
-msgid "Returns an array of the tile's shapes."
+msgid ""
+"Returns an array of dictionaries describing the tile's shapes.\n"
+"[b]Dictionary structure in the array returned by this method:[/b]\n"
+"[codeblock]\n"
+"{\n"
+" \"autotile_coord\": Vector2,\n"
+" \"one_way\": bool,\n"
+" \"one_way_margin\": int,\n"
+" \"shape\": CollisionShape2D,\n"
+" \"shape_transform\": Transform2D,\n"
+"}\n"
+"[/codeblock]"
msgstr ""
-#: doc/classes/TileSet.xml:490
+#: doc/classes/TileSet.xml:500
msgid "Returns the tile's texture."
msgstr ""
-#: doc/classes/TileSet.xml:499
+#: doc/classes/TileSet.xml:509
msgid "Returns the texture offset of the tile."
msgstr ""
-#: doc/classes/TileSet.xml:508
+#: doc/classes/TileSet.xml:518
msgid "Returns the tile's [enum TileMode]."
msgstr ""
-#: doc/classes/TileSet.xml:517
+#: doc/classes/TileSet.xml:527
msgid "Returns the tile's Z index (drawing layer)."
msgstr ""
-#: doc/classes/TileSet.xml:528
+#: doc/classes/TileSet.xml:538
msgid "Sets a light occluder for the tile."
msgstr ""
-#: doc/classes/TileSet.xml:539
+#: doc/classes/TileSet.xml:549
msgid "Sets the tile's material."
msgstr ""
-#: doc/classes/TileSet.xml:550
+#: doc/classes/TileSet.xml:560
msgid "Sets the tile's modulation color."
msgstr ""
-#: doc/classes/TileSet.xml:561
+#: doc/classes/TileSet.xml:571
msgid "Sets the tile's name."
msgstr ""
-#: doc/classes/TileSet.xml:572
+#: doc/classes/TileSet.xml:582
msgid "Sets the tile's navigation polygon."
msgstr ""
-#: doc/classes/TileSet.xml:583
+#: doc/classes/TileSet.xml:593
msgid "Sets an offset for the tile's navigation polygon."
msgstr ""
-#: doc/classes/TileSet.xml:594
+#: doc/classes/TileSet.xml:604
msgid ""
"Sets the tile's normal map texture.\n"
"[b]Note:[/b] Godot expects the normal map to use X+, Y-, and Z+ coordinates. "
@@ -51126,48 +52007,48 @@ msgid ""
"a comparison of normal map coordinates expected by popular engines."
msgstr ""
-#: doc/classes/TileSet.xml:606
+#: doc/classes/TileSet.xml:616
msgid "Sets an offset for the tile's light occluder."
msgstr ""
-#: doc/classes/TileSet.xml:617
+#: doc/classes/TileSet.xml:627
msgid ""
"Sets the tile's sub-region in the texture. This is common in texture atlases."
msgstr ""
-#: doc/classes/TileSet.xml:630
+#: doc/classes/TileSet.xml:640
msgid "Sets a shape for the tile, enabling collision."
msgstr ""
-#: doc/classes/TileSet.xml:643
+#: doc/classes/TileSet.xml:653
msgid "Sets the offset of a tile's shape."
msgstr ""
-#: doc/classes/TileSet.xml:656
+#: doc/classes/TileSet.xml:666
msgid "Enables one-way collision on a tile's shape."
msgstr ""
-#: doc/classes/TileSet.xml:681
+#: doc/classes/TileSet.xml:691
msgid "Sets a [Transform2D] on a tile's shape."
msgstr ""
-#: doc/classes/TileSet.xml:692
+#: doc/classes/TileSet.xml:702
msgid "Sets an array of shapes for the tile, enabling collision."
msgstr ""
-#: doc/classes/TileSet.xml:703
+#: doc/classes/TileSet.xml:713
msgid "Sets the tile's texture."
msgstr ""
-#: doc/classes/TileSet.xml:714
+#: doc/classes/TileSet.xml:724
msgid "Sets the tile's texture offset."
msgstr ""
-#: doc/classes/TileSet.xml:725
+#: doc/classes/TileSet.xml:735
msgid "Sets the tile's [enum TileMode]."
msgstr ""
-#: doc/classes/TileSet.xml:736
+#: doc/classes/TileSet.xml:746
msgid "Sets the tile's drawing index."
msgstr ""
@@ -51178,14 +52059,16 @@ msgstr ""
#: doc/classes/Timer.xml:7
msgid ""
"Counts down a specified interval and emits a signal on reaching 0. Can be "
-"set to repeat or \"one-shot\" mode."
+"set to repeat or \"one-shot\" mode.\n"
+"[b]Note:[/b] To create an one-shot timer without instantiating a node, use "
+"[method SceneTree.create_timer]."
msgstr ""
-#: doc/classes/Timer.xml:16
+#: doc/classes/Timer.xml:17
msgid "Returns [code]true[/code] if the timer is stopped."
msgstr ""
-#: doc/classes/Timer.xml:25
+#: doc/classes/Timer.xml:26
msgid ""
"Starts the timer. Sets [code]wait_time[/code] to [code]time_sec[/code] if "
"[code]time_sec > 0[/code]. This also resets the remaining time to "
@@ -51193,11 +52076,11 @@ msgid ""
"[b]Note:[/b] this method will not resume a paused timer. See [member paused]."
msgstr ""
-#: doc/classes/Timer.xml:33
+#: doc/classes/Timer.xml:34
msgid "Stops the timer."
msgstr ""
-#: doc/classes/Timer.xml:39
+#: doc/classes/Timer.xml:40
msgid ""
"If [code]true[/code], the timer will automatically start when entering the "
"scene tree.\n"
@@ -51205,40 +52088,40 @@ msgid ""
"the timer enters the scene tree and starts."
msgstr ""
-#: doc/classes/Timer.xml:43
+#: doc/classes/Timer.xml:44
msgid ""
"If [code]true[/code], the timer will stop when reaching 0. If [code]false[/"
"code], it will restart."
msgstr ""
-#: doc/classes/Timer.xml:46
+#: doc/classes/Timer.xml:47
msgid ""
"If [code]true[/code], the timer is paused and will not process until it is "
"unpaused again, even if [method start] is called."
msgstr ""
-#: doc/classes/Timer.xml:49
+#: doc/classes/Timer.xml:50
msgid "Processing mode. See [enum TimerProcessMode]."
msgstr ""
-#: doc/classes/Timer.xml:52
+#: doc/classes/Timer.xml:53
msgid ""
"The timer's remaining time in seconds. Returns 0 if the timer is inactive.\n"
"[b]Note:[/b] You cannot set this value. To change the timer's remaining "
"time, use [method start]."
msgstr ""
-#: doc/classes/Timer.xml:56
+#: doc/classes/Timer.xml:57
msgid "Wait time in seconds."
msgstr ""
-#: doc/classes/Timer.xml:68
+#: doc/classes/Timer.xml:69
msgid ""
"Update the timer during the physics step at each frame (fixed framerate "
"processing)."
msgstr ""
-#: doc/classes/Timer.xml:71
+#: doc/classes/Timer.xml:72
msgid "Update the timer during the idle time at each frame."
msgstr ""
@@ -51317,60 +52200,66 @@ msgstr ""
#: doc/classes/Transform.xml:7
msgid ""
-"Represents one or many transformations in 3D space such as translation, "
-"rotation, or scaling. It consists of a [member basis] and an [member "
-"origin]. It is similar to a 3×4 matrix."
+"3×4 matrix (3 rows, 4 columns) used for 3D linear transformations. It can "
+"represent transformations such as translation, rotation, or scaling. It "
+"consists of a [member basis] (first 3 columns) and a [Vector3] for the "
+"[member origin] (last column).\n"
+"For more information, read the \"Matrices and transforms\" documentation "
+"article."
msgstr ""
-#: doc/classes/Transform.xml:26
+#: doc/classes/Transform.xml:28
msgid ""
-"Constructs the Transform from four [Vector3]. Each axis corresponds to local "
-"basis vectors (some of which may be scaled)."
+"Constructs a Transform from four [Vector3] values (matrix columns). Each "
+"axis corresponds to local basis vectors (some of which may be scaled)."
msgstr ""
-#: doc/classes/Transform.xml:37
-msgid "Constructs the Transform from a [Basis] and [Vector3]."
+#: doc/classes/Transform.xml:39
+msgid "Constructs a Transform from a [Basis] and [Vector3]."
msgstr ""
-#: doc/classes/Transform.xml:46
-msgid "Constructs the Transform from a [Transform2D]."
+#: doc/classes/Transform.xml:48
+msgid "Constructs a Transform from a [Transform2D]."
msgstr ""
-#: doc/classes/Transform.xml:55
+#: doc/classes/Transform.xml:57
msgid ""
-"Constructs the Transform from a [Quat]. The origin will be Vector3(0, 0, 0)."
+"Constructs a Transform from a [Quat]. The origin will be [code]Vector3(0, 0, "
+"0)[/code]."
msgstr ""
-#: doc/classes/Transform.xml:64
+#: doc/classes/Transform.xml:66
msgid ""
"Constructs the Transform from a [Basis]. The origin will be Vector3(0, 0, 0)."
msgstr ""
-#: doc/classes/Transform.xml:71
+#: doc/classes/Transform.xml:73 doc/classes/Transform2D.xml:51
msgid ""
"Returns the inverse of the transform, under the assumption that the "
"transformation is composed of rotation, scaling and translation."
msgstr ""
-#: doc/classes/Transform.xml:82
-msgid "Interpolates the transform to other Transform by weight amount (0-1)."
+#: doc/classes/Transform.xml:84
+msgid ""
+"Interpolates the transform to other Transform by weight amount (on the range "
+"of 0.0 to 1.0)."
msgstr ""
-#: doc/classes/Transform.xml:89 doc/classes/Transform2D.xml:106
+#: doc/classes/Transform.xml:91
msgid ""
"Returns the inverse of the transform, under the assumption that the "
"transformation is composed of rotation and translation (no scaling, use "
"affine_inverse for transforms with scaling)."
msgstr ""
-#: doc/classes/Transform.xml:98 doc/classes/Transform2D.xml:115
+#: doc/classes/Transform.xml:100 doc/classes/Transform2D.xml:119
msgid ""
"Returns [code]true[/code] if this transform and [code]transform[/code] are "
"approximately equal, by calling [code]is_equal_approx[/code] on each "
"component."
msgstr ""
-#: doc/classes/Transform.xml:109
+#: doc/classes/Transform.xml:111
msgid ""
"Returns a copy of the transform rotated such that its -Z axis points towards "
"the [code]target[/code] position.\n"
@@ -51380,25 +52269,25 @@ msgid ""
"Operations take place in global space."
msgstr ""
-#: doc/classes/Transform.xml:118 doc/classes/Transform2D.xml:122
+#: doc/classes/Transform.xml:120
msgid ""
"Returns the transform with the basis orthogonal (90 degrees), and normalized "
"axis vectors."
msgstr ""
-#: doc/classes/Transform.xml:129
+#: doc/classes/Transform.xml:131
msgid ""
"Rotates the transform around the given axis by the given angle (in radians), "
"using matrix multiplication. The axis must be a normalized vector."
msgstr ""
-#: doc/classes/Transform.xml:138
+#: doc/classes/Transform.xml:140
msgid ""
"Scales basis and origin of the transform by the given scale factor, using "
"matrix multiplication."
msgstr ""
-#: doc/classes/Transform.xml:147 doc/classes/Transform2D.xml:149
+#: doc/classes/Transform.xml:149 doc/classes/Transform2D.xml:153
msgid ""
"Translates the transform by the given offset, relative to the transform's "
"basis vectors.\n"
@@ -51406,152 +52295,162 @@ msgid ""
"multiplication."
msgstr ""
-#: doc/classes/Transform.xml:157
+#: doc/classes/Transform.xml:159
msgid ""
"Transforms the given [Vector3], [Plane], [AABB], or [PackedVector3Array] by "
"this transform."
msgstr ""
-#: doc/classes/Transform.xml:166
+#: doc/classes/Transform.xml:168
msgid ""
"Inverse-transforms the given [Vector3], [Plane], [AABB], or "
"[PackedVector3Array] by this transform."
msgstr ""
-#: doc/classes/Transform.xml:172
+#: doc/classes/Transform.xml:174
msgid ""
"The basis is a matrix containing 3 [Vector3] as its columns: X axis, Y axis, "
"and Z axis. These vectors can be interpreted as the basis vectors of local "
"coordinate system traveling with the object."
msgstr ""
-#: doc/classes/Transform.xml:175
-msgid "The translation offset of the transform."
+#: doc/classes/Transform.xml:177
+msgid ""
+"The translation offset of the transform (column 3, the fourth column). "
+"Equivalent to array index [code]3[/code]."
msgstr ""
-#: doc/classes/Transform.xml:180
+#: doc/classes/Transform.xml:182
msgid ""
"[Transform] with no translation, rotation or scaling applied. When applied "
"to other data structures, [constant IDENTITY] performs no transformation."
msgstr ""
-#: doc/classes/Transform.xml:183
+#: doc/classes/Transform.xml:185
msgid "[Transform] with mirroring applied perpendicular to the YZ plane."
msgstr ""
-#: doc/classes/Transform.xml:186
+#: doc/classes/Transform.xml:188
msgid "[Transform] with mirroring applied perpendicular to the XZ plane."
msgstr ""
-#: doc/classes/Transform.xml:189
+#: doc/classes/Transform.xml:191
msgid "[Transform] with mirroring applied perpendicular to the XY plane."
msgstr ""
#: doc/classes/Transform2D.xml:4
-msgid "2D transformation (3×2 matrix)."
+msgid "2D transformation (2×3 matrix)."
msgstr ""
#: doc/classes/Transform2D.xml:7
msgid ""
-"Represents one or many transformations in 2D space such as translation, "
-"rotation, or scaling. It consists of two [member x] and [member y] "
-"[Vector2]s and an [member origin]. It is similar to a 3×2 matrix."
+"2×3 matrix (2 rows, 3 columns) used for 2D linear transformations. It can "
+"represent transformations such as translation, rotation, or scaling. It "
+"consists of a three [Vector2] values: [member x], [member y], and the "
+"[member origin].\n"
+"For more information, read the \"Matrices and transforms\" documentation "
+"article."
msgstr ""
-#: doc/classes/Transform2D.xml:18
+#: doc/classes/Transform2D.xml:20
msgid "Constructs the transform from a 3D [Transform]."
msgstr ""
-#: doc/classes/Transform2D.xml:31
+#: doc/classes/Transform2D.xml:33
msgid ""
-"Constructs the transform from 3 [Vector2]s representing x, y, and origin."
+"Constructs the transform from 3 [Vector2] values representing [member x], "
+"[member y], and the [member origin] (the three column vectors)."
msgstr ""
-#: doc/classes/Transform2D.xml:42
+#: doc/classes/Transform2D.xml:44
msgid "Constructs the transform from a given angle (in radians) and position."
msgstr ""
-#: doc/classes/Transform2D.xml:58
-msgid "Transforms the given vector by this transform's basis (no translation)."
+#: doc/classes/Transform2D.xml:60
+msgid ""
+"Returns a vector transformed (multiplied) by the basis matrix.\n"
+"This method does not account for translation (the origin vector)."
msgstr ""
-#: doc/classes/Transform2D.xml:67
+#: doc/classes/Transform2D.xml:70
msgid ""
-"Inverse-transforms the given vector by this transform's basis (no "
-"translation)."
+"Returns a vector transformed (multiplied) by the inverse basis matrix.\n"
+"This method does not account for translation (the origin vector)."
msgstr ""
-#: doc/classes/Transform2D.xml:74
+#: doc/classes/Transform2D.xml:78
msgid "Returns the transform's origin (translation)."
msgstr ""
-#: doc/classes/Transform2D.xml:81
+#: doc/classes/Transform2D.xml:85
msgid "Returns the transform's rotation (in radians)."
msgstr ""
-#: doc/classes/Transform2D.xml:88
+#: doc/classes/Transform2D.xml:92
msgid "Returns the scale."
msgstr ""
-#: doc/classes/Transform2D.xml:99
+#: doc/classes/Transform2D.xml:103
msgid ""
"Returns a transform interpolated between this transform and another by a "
-"given weight (0-1)."
+"given weight (on the range of 0.0 to 1.0)."
+msgstr ""
+
+#: doc/classes/Transform2D.xml:110
+msgid ""
+"Returns the inverse of the transform, under the assumption that the "
+"transformation is composed of rotation and translation (no scaling, use "
+"[method affine_inverse] for transforms with scaling)."
+msgstr ""
+
+#: doc/classes/Transform2D.xml:126
+msgid ""
+"Returns the transform with the basis orthogonal (90 degrees), and normalized "
+"axis vectors (scale of 1 or -1)."
msgstr ""
-#: doc/classes/Transform2D.xml:131
+#: doc/classes/Transform2D.xml:135
msgid ""
"Rotates the transform by the given angle (in radians), using matrix "
"multiplication."
msgstr ""
-#: doc/classes/Transform2D.xml:140
+#: doc/classes/Transform2D.xml:144
msgid ""
"Scales the transform by the given scale factor, using matrix multiplication."
msgstr ""
-#: doc/classes/Transform2D.xml:159
+#: doc/classes/Transform2D.xml:163
msgid ""
"Transforms the given [Vector2], [Rect2], or [PackedVector2Array] by this "
"transform."
msgstr ""
-#: doc/classes/Transform2D.xml:168
+#: doc/classes/Transform2D.xml:172
msgid ""
"Inverse-transforms the given [Vector2], [Rect2], or [PackedVector2Array] by "
"this transform."
msgstr ""
-#: doc/classes/Transform2D.xml:174
-msgid "The transform's translation offset."
-msgstr ""
-
-#: doc/classes/Transform2D.xml:177
-msgid ""
-"The X axis of 2×2 basis matrix containing 2 [Vector2]s as its columns: X "
-"axis and Y axis. These vectors can be interpreted as the basis vectors of "
-"local coordinate system traveling with the object."
-msgstr ""
-
-#: doc/classes/Transform2D.xml:180
+#: doc/classes/Transform2D.xml:178
msgid ""
-"The Y axis of 2×2 basis matrix containing 2 [Vector2]s as its columns: X "
-"axis and Y axis. These vectors can be interpreted as the basis vectors of "
-"local coordinate system traveling with the object."
+"The origin vector (column 2, the third column). Equivalent to array index "
+"[code]2[/code]. The origin vector represents translation."
msgstr ""
-#: doc/classes/Transform2D.xml:185
+#: doc/classes/Transform2D.xml:189
msgid ""
-"[Transform2D] with no translation, rotation or scaling applied. When applied "
-"to other data structures, [constant IDENTITY] performs no transformation."
+"The identity [Transform2D] with no translation, rotation or scaling applied. "
+"When applied to other data structures, [constant IDENTITY] performs no "
+"transformation."
msgstr ""
-#: doc/classes/Transform2D.xml:188
-msgid "[Transform2D] with mirroring applied parallel to the X axis."
+#: doc/classes/Transform2D.xml:192
+msgid "The [Transform2D] that will flip something along the X axis."
msgstr ""
-#: doc/classes/Transform2D.xml:191
-msgid "[Transform2D] with mirroring applied parallel to the Y axis."
+#: doc/classes/Transform2D.xml:195
+msgid "The [Transform2D] that will flip something along the Y axis."
msgstr ""
#: doc/classes/Translation.xml:4
@@ -52215,7 +53114,8 @@ msgid "Returns the column's cell mode."
msgstr ""
#: doc/classes/TreeItem.xml:121
-msgid "Returns the TreeItem's child items."
+msgid ""
+"Returns the TreeItem's first child item or a null object if there is none."
msgstr ""
#: doc/classes/TreeItem.xml:130
@@ -52247,28 +53147,32 @@ msgid "Returns the icon [Texture2D] region as [Rect2]."
msgstr ""
#: doc/classes/TreeItem.xml:199
-msgid "Returns the next TreeItem in the tree."
+msgid ""
+"Returns the next TreeItem in the tree or a null object if there is none."
msgstr ""
#: doc/classes/TreeItem.xml:208
msgid ""
-"Returns the next visible TreeItem in the tree.\n"
+"Returns the next visible TreeItem in the tree or a null object if there is "
+"none.\n"
"If [code]wrap[/code] is enabled, the method will wrap around to the first "
"visible element in the tree when called on the last visible element, "
"otherwise it returns [code]null[/code]."
msgstr ""
#: doc/classes/TreeItem.xml:216
-msgid "Returns the parent TreeItem."
+msgid "Returns the parent TreeItem or a null object if there is none."
msgstr ""
#: doc/classes/TreeItem.xml:223
-msgid "Returns the previous TreeItem in the tree."
+msgid ""
+"Returns the previous TreeItem in the tree or a null object if there is none."
msgstr ""
#: doc/classes/TreeItem.xml:232
msgid ""
-"Returns the previous visible TreeItem in the tree.\n"
+"Returns the previous visible TreeItem in the tree or a null object if there "
+"is none.\n"
"If [code]wrap[/code] is enabled, the method will wrap around to the last "
"visible element in the tree when called on the first visible element, "
"otherwise it returns [code]null[/code]."
@@ -52778,6 +53682,10 @@ msgid ""
"A simple server that opens a UDP socket and returns connected "
"[PacketPeerUDP] upon receiving new packets. See also [method PacketPeerUDP."
"connect_to_host].\n"
+"After starting the server ([method listen]), you will need to [method poll] "
+"it at regular intervals (e.g. inside [method Node._process]) for it to "
+"process new packets, delivering them to the appropriate [PacketPeerUDP], and "
+"taking new connections.\n"
"Below a small example of how it can be used:\n"
"[codeblock]\n"
"# server.gd\n"
@@ -52790,6 +53698,7 @@ msgid ""
" server.listen(4242)\n"
"\n"
"func _process(delta):\n"
+" server.poll() # Important!\n"
" if server.is_connection_available():\n"
" var peer : PacketPeerUDP = server.take_connection()\n"
" var pkt = peer.get_packet()\n"
@@ -52825,35 +53734,55 @@ msgid ""
"[/codeblock]"
msgstr ""
-#: doc/classes/UDPServer.xml:60
+#: doc/classes/UDPServer.xml:62
msgid ""
-"Returns [code]true[/code] if a packet with a new address/port combination is "
-"received on the socket."
+"Returns [code]true[/code] if a packet with a new address/port combination "
+"was received on the socket."
msgstr ""
-#: doc/classes/UDPServer.xml:67
+#: doc/classes/UDPServer.xml:69
msgid ""
"Returns [code]true[/code] if the socket is open and listening on a port."
msgstr ""
-#: doc/classes/UDPServer.xml:78
+#: doc/classes/UDPServer.xml:80
msgid ""
"Starts the server by opening a UDP socket listening on the given port. You "
"can optionally specify a [code]bind_address[/code] to only listen for "
"packets sent to that address. See also [method PacketPeerUDP.listen]."
msgstr ""
-#: doc/classes/UDPServer.xml:85
+#: doc/classes/UDPServer.xml:87
+msgid ""
+"Call this method at regular intervals (e.g. inside [method Node._process]) "
+"to process new packets. And packet from known address/port pair will be "
+"delivered to the appropriate [PacketPeerUDP], any packet received from an "
+"unknown address/port pair will be added as a pending connection (see [method "
+"is_connection_available], [method take_connection]). The maximum number of "
+"pending connection is defined via [member max_pending_connections]."
+msgstr ""
+
+#: doc/classes/UDPServer.xml:94
+msgid ""
+"Stops the server, closing the UDP socket if open. Will close all connected "
+"[PacketPeerUDP] accepted via [method take_connection] (remote peers will not "
+"be notified)."
+msgstr ""
+
+#: doc/classes/UDPServer.xml:101
msgid ""
-"Stops the server, closing the UDP socket if open. Will not disconnect any "
-"connected [PacketPeerUDP]."
+"Returns the first pending connection (connected to the appropriate address/"
+"port). Will return [code]null[/code] if no new connection is available. See "
+"also [method is_connection_available], [method PacketPeerUDP."
+"connect_to_host]."
msgstr ""
-#: doc/classes/UDPServer.xml:92
+#: doc/classes/UDPServer.xml:107
msgid ""
-"Returns a [PacketPeerUDP] connected to the address/port combination of the "
-"first packet in queue. Will return [code]null[/code] if no packet is in "
-"queue. See also [method PacketPeerUDP.connect_to_host]."
+"Define the maximum number of pending connections, during [method poll], any "
+"new pending connection exceeding that value will be automatically dropped. "
+"Setting this value to [code]0[/code] effectively prevents any new pending "
+"connection to be accepted (e.g. when all your players have connected)."
msgstr ""
#: doc/classes/UndoRedo.xml:4
@@ -53494,24 +54423,26 @@ msgstr ""
#: doc/classes/Vector2.xml:46
msgid ""
-"Returns the vector's angle in radians with respect to the X axis, or [code]"
-"(1, 0)[/code] vector.\n"
+"Returns this vector's angle with respect to the X axis, or [code](1, 0)[/"
+"code] vector, in radians.\n"
"Equivalent to the result of [method @GDScript.atan2] when called with the "
-"vector's [member x] and [member y] as parameters: [code]atan2(x, y)[/code]."
+"vector's [member y] and [member x] as parameters: [code]atan2(y, x)[/code]."
msgstr ""
#: doc/classes/Vector2.xml:56
-msgid "Returns the angle in radians between the two vectors."
+msgid "Returns the angle to the given vector, in radians."
msgstr ""
#: doc/classes/Vector2.xml:65
msgid ""
-"Returns the angle in radians between the line connecting the two points and "
-"the X coordinate."
+"Returns the angle between the line connecting the two points and the X axis, "
+"in radians."
msgstr ""
-#: doc/classes/Vector2.xml:72 doc/classes/Vector2i.xml:46
-msgid "Returns the ratio of [member x] to [member y]."
+#: doc/classes/Vector2.xml:72
+msgid ""
+"Returns the aspect ratio of this vector, the ratio of [member x] to [member "
+"y]."
msgstr ""
#: doc/classes/Vector2.xml:81 doc/classes/Vector3.xml:59
@@ -53520,24 +54451,27 @@ msgid ""
msgstr ""
#: doc/classes/Vector2.xml:88
-msgid "Returns the vector with all components rounded up."
+msgid ""
+"Returns the vector with all components rounded up (towards positive "
+"infinity)."
msgstr ""
#: doc/classes/Vector2.xml:97
-msgid "Returns the vector with a maximum length."
+msgid ""
+"Returns the vector with a maximum length by limiting its length to "
+"[code]length[/code]."
msgstr ""
#: doc/classes/Vector2.xml:106
-msgid ""
-"Returns the 2-dimensional analog of the cross product with the given vector."
+msgid "Returns the cross product of this vector and [code]with[/code]."
msgstr ""
#: doc/classes/Vector2.xml:121
msgid ""
"Cubically interpolates between this vector and [code]b[/code] using "
"[code]pre_a[/code] and [code]post_b[/code] as handles, and returns the "
-"result at position [code]t[/code]. [code]t[/code] is in the range of "
-"[code]0.0 - 1.0[/code], representing the amount of interpolation."
+"result at position [code]t[/code]. [code]t[/code] is on the range of 0.0 to "
+"1.0, representing the amount of interpolation."
msgstr ""
#: doc/classes/Vector2.xml:130 doc/classes/Vector3.xml:99
@@ -53545,182 +54479,199 @@ msgid ""
"Returns the normalized vector pointing from this vector to [code]b[/code]."
msgstr ""
-#: doc/classes/Vector2.xml:139
+#: doc/classes/Vector2.xml:139 doc/classes/Vector3.xml:108
msgid ""
-"Returns the squared distance to vector [code]b[/code]. Prefer this function "
-"over [method distance_to] if you need to sort vectors or need the squared "
-"distance for some formula."
+"Returns the squared distance between this vector and [code]b[/code].\n"
+"This method runs faster than [method distance_to], so prefer it if you need "
+"to compare vectors or need the squared distance for some formula."
msgstr ""
-#: doc/classes/Vector2.xml:148
-msgid "Returns the distance to vector [code]b[/code]."
+#: doc/classes/Vector2.xml:149
+msgid "Returns the distance between this vector and [code]to[/code]."
msgstr ""
-#: doc/classes/Vector2.xml:157
-msgid "Returns the dot product with vector [code]b[/code]."
+#: doc/classes/Vector2.xml:158
+msgid ""
+"Returns the dot product of this vector and [code]with[/code]. This can be "
+"used to compare the angle between two vectors. For example, this can be used "
+"to determine whether an enemy is facing the player.\n"
+"The dot product will be [code]0[/code] for a straight angle (90 degrees), "
+"greater than 0 for angles narrower than 90 degrees and lower than 0 for "
+"angles wider than 90 degrees.\n"
+"When using unit (normalized) vectors, the result will always be between "
+"[code]-1.0[/code] (180 degree angle) when the vectors are facing opposite "
+"directions, and [code]1.0[/code] (0 degree angle) when the vectors are "
+"aligned.\n"
+"[b]Note:[/b] [code]a.dot(b)[/code] is equivalent to [code]b.dot(a)[/code]."
msgstr ""
-#: doc/classes/Vector2.xml:164
-msgid "Returns the vector with all components rounded down."
+#: doc/classes/Vector2.xml:168
+msgid ""
+"Returns the vector with all components rounded down (towards negative "
+"infinity)."
msgstr ""
-#: doc/classes/Vector2.xml:173 doc/classes/Vector3.xml:149
+#: doc/classes/Vector2.xml:177 doc/classes/Vector3.xml:153
msgid ""
"Returns [code]true[/code] if this vector and [code]v[/code] are "
"approximately equal, by running [method @GDScript.is_equal_approx] on each "
"component."
msgstr ""
-#: doc/classes/Vector2.xml:180 doc/classes/Vector3.xml:156
-msgid "Returns [code]true[/code] if the vector is normalized."
-msgstr ""
+#: doc/classes/Vector2.xml:184 doc/classes/Vector3.xml:160
+#, fuzzy
+msgid ""
+"Returns [code]true[/code] if the vector is normalized, and false otherwise."
+msgstr "如果[code]s[/code] 为0或者很接近0则返回[code]true[/code]。"
-#: doc/classes/Vector2.xml:187 doc/classes/Vector3.xml:163
-msgid "Returns the vector's length."
+#: doc/classes/Vector2.xml:191 doc/classes/Vector3.xml:167
+msgid "Returns the length (magnitude) of this vector."
msgstr ""
-#: doc/classes/Vector2.xml:194
+#: doc/classes/Vector2.xml:198 doc/classes/Vector3.xml:174
msgid ""
-"Returns the vector's length squared. Prefer this method over [method length] "
-"if you need to sort vectors or need the squared length for some formula."
+"Returns the squared length (squared magnitude) of this vector.\n"
+"This method runs faster than [method length], so prefer it if you need to "
+"compare vectors or need the squared distance for some formula."
msgstr ""
-#: doc/classes/Vector2.xml:205
+#: doc/classes/Vector2.xml:210 doc/classes/Vector3.xml:186
msgid ""
"Returns the result of the linear interpolation between this vector and "
-"[code]b[/code] by amount [code]t[/code]. [code]t[/code] is in the range of "
-"[code]0.0 - 1.0[/code], representing the amount of interpolation."
+"[code]b[/code] by amount [code]t[/code]. [code]t[/code] is on the range of "
+"0.0 to 1.0, representing the amount of interpolation."
msgstr ""
-#: doc/classes/Vector2.xml:216 doc/classes/Vector3.xml:206
+#: doc/classes/Vector2.xml:221
msgid ""
"Moves the vector toward [code]to[/code] by the fixed [code]delta[/code] "
"amount."
msgstr ""
-#: doc/classes/Vector2.xml:223 doc/classes/Vector3.xml:213
+#: doc/classes/Vector2.xml:228 doc/classes/Vector3.xml:218
msgid ""
"Returns the vector scaled to unit length. Equivalent to [code]v / v.length()"
"[/code]."
msgstr ""
-#: doc/classes/Vector2.xml:232 doc/classes/Vector3.xml:231
+#: doc/classes/Vector2.xml:237 doc/classes/Vector3.xml:236
msgid ""
-"Returns a vector composed of the [code]fposmod[/code] of this vector's "
+"Returns a vector composed of the [method @GDScript.fposmod] of this vector's "
"components and [code]mod[/code]."
msgstr ""
-#: doc/classes/Vector2.xml:241 doc/classes/Vector3.xml:240
+#: doc/classes/Vector2.xml:246 doc/classes/Vector3.xml:245
msgid ""
-"Returns a vector composed of the [code]fposmod[/code] of this vector's "
+"Returns a vector composed of the [method @GDScript.fposmod] of this vector's "
"components and [code]modv[/code]'s components."
msgstr ""
-#: doc/classes/Vector2.xml:250 doc/classes/Vector3.xml:249
+#: doc/classes/Vector2.xml:255
msgid "Returns the vector projected onto the vector [code]b[/code]."
msgstr ""
-#: doc/classes/Vector2.xml:259 doc/classes/Vector3.xml:258
+#: doc/classes/Vector2.xml:264
msgid "Returns the vector reflected from a plane defined by the given normal."
msgstr ""
-#: doc/classes/Vector2.xml:268
+#: doc/classes/Vector2.xml:273
msgid ""
"Returns the vector rotated by [code]phi[/code] radians. See also [method "
"@GDScript.deg2rad]."
msgstr ""
-#: doc/classes/Vector2.xml:275 doc/classes/Vector3.xml:276
+#: doc/classes/Vector2.xml:280
msgid ""
"Returns the vector with all components rounded to the nearest integer, with "
"halfway cases rounded away from zero."
msgstr ""
-#: doc/classes/Vector2.xml:282 doc/classes/Vector2i.xml:53
-#: doc/classes/Vector3.xml:283 doc/classes/Vector3i.xml:55
+#: doc/classes/Vector2.xml:287
msgid ""
"Returns the vector with each component set to one or negative one, depending "
-"on the signs of the components."
+"on the signs of the components, or zero if the component is zero, by calling "
+"[method @GDScript.sign] on each component."
msgstr ""
-#: doc/classes/Vector2.xml:293 doc/classes/Vector3.xml:294
+#: doc/classes/Vector2.xml:298 doc/classes/Vector3.xml:299
msgid ""
"Returns the result of spherical linear interpolation between this vector and "
-"[code]b[/code], by amount [code]t[/code]. [code]t[/code] is in the range of "
-"[code]0.0 - 1.0[/code], representing the amount of interpolation.\n"
+"[code]b[/code], by amount [code]t[/code]. [code]t[/code] is on the range of "
+"0.0 to 1.0, representing the amount of interpolation.\n"
"[b]Note:[/b] Both vectors must be normalized."
msgstr ""
-#: doc/classes/Vector2.xml:303 doc/classes/Vector3.xml:304
-msgid ""
-"Returns the component of the vector along a plane defined by the given "
-"normal."
+#: doc/classes/Vector2.xml:308 doc/classes/Vector3.xml:309
+msgid "Returns this vector slid along a plane defined by the given normal."
msgstr ""
-#: doc/classes/Vector2.xml:312 doc/classes/Vector3.xml:313
-msgid "Returns the vector snapped to a grid with the given size."
+#: doc/classes/Vector2.xml:317 doc/classes/Vector3.xml:318
+msgid ""
+"Returns this vector with each component snapped to the nearest multiple of "
+"[code]step[/code]. This can also be used to round to an arbitrary number of "
+"decimals."
msgstr ""
-#: doc/classes/Vector2.xml:319
-msgid "Returns a perpendicular vector."
+#: doc/classes/Vector2.xml:324
+msgid ""
+"Returns a perpendicular vector rotated 90 degrees counter-clockwise compared "
+"to the original, with the same length."
msgstr ""
-#: doc/classes/Vector2.xml:325 doc/classes/Vector2i.xml:59
-#: doc/classes/Vector3.xml:326 doc/classes/Vector3i.xml:61
+#: doc/classes/Vector2.xml:330 doc/classes/Vector2i.xml:59
+#: doc/classes/Vector3.xml:332 doc/classes/Vector3i.xml:61
msgid ""
"The vector's X component. Also accessible by using the index position [code]"
"[0][/code]."
msgstr ""
-#: doc/classes/Vector2.xml:328 doc/classes/Vector2i.xml:62
-#: doc/classes/Vector3.xml:329 doc/classes/Vector3i.xml:64
+#: doc/classes/Vector2.xml:333 doc/classes/Vector2i.xml:62
+#: doc/classes/Vector3.xml:335 doc/classes/Vector3i.xml:64
msgid ""
"The vector's Y component. Also accessible by using the index position [code]"
"[1][/code]."
msgstr ""
-#: doc/classes/Vector2.xml:333 doc/classes/Vector2i.xml:67
+#: doc/classes/Vector2.xml:338 doc/classes/Vector2i.xml:67
#: doc/classes/Vector3i.xml:72
msgid "Enumerated value for the X axis."
msgstr ""
-#: doc/classes/Vector2.xml:336 doc/classes/Vector2i.xml:70
+#: doc/classes/Vector2.xml:341 doc/classes/Vector2i.xml:70
#: doc/classes/Vector3i.xml:75
msgid "Enumerated value for the Y axis."
msgstr ""
-#: doc/classes/Vector2.xml:339 doc/classes/Vector2i.xml:73
-#: doc/classes/Vector3.xml:346 doc/classes/Vector3i.xml:81
-msgid "Zero vector."
+#: doc/classes/Vector2.xml:344 doc/classes/Vector2i.xml:73
+#: doc/classes/Vector3.xml:352 doc/classes/Vector3i.xml:81
+msgid "Zero vector, a vector with all components set to [code]0[/code]."
msgstr ""
-#: doc/classes/Vector2.xml:342 doc/classes/Vector2i.xml:76
-#: doc/classes/Vector3.xml:349 doc/classes/Vector3i.xml:84
-msgid "One vector."
+#: doc/classes/Vector2.xml:347 doc/classes/Vector2i.xml:76
+#: doc/classes/Vector3.xml:355 doc/classes/Vector3i.xml:84
+msgid "One vector, a vector with all components set to [code]1[/code]."
msgstr ""
-#: doc/classes/Vector2.xml:345 doc/classes/Vector3.xml:352
-msgid "Infinity vector."
+#: doc/classes/Vector2.xml:350 doc/classes/Vector3.xml:358
+msgid ""
+"Infinity vector, a vector with all components set to [constant @GDScript."
+"INF]."
msgstr ""
-#: doc/classes/Vector2.xml:348 doc/classes/Vector2i.xml:79
-#: doc/classes/Vector3.xml:355 doc/classes/Vector3i.xml:87
-msgid "Left unit vector."
+#: doc/classes/Vector2.xml:353 doc/classes/Vector2i.xml:79
+msgid "Left unit vector. Represents the direction of left."
msgstr ""
-#: doc/classes/Vector2.xml:351 doc/classes/Vector2i.xml:82
-#: doc/classes/Vector3.xml:358 doc/classes/Vector3i.xml:90
-msgid "Right unit vector."
+#: doc/classes/Vector2.xml:356 doc/classes/Vector2i.xml:82
+msgid "Right unit vector. Represents the direction of right."
msgstr ""
-#: doc/classes/Vector2.xml:354 doc/classes/Vector2i.xml:85
-#: doc/classes/Vector3.xml:361 doc/classes/Vector3i.xml:93
-msgid "Up unit vector."
+#: doc/classes/Vector2.xml:359 doc/classes/Vector2i.xml:85
+msgid "Up unit vector. Y is down in 2D, so this vector points -Y."
msgstr ""
-#: doc/classes/Vector2.xml:357 doc/classes/Vector2i.xml:88
-#: doc/classes/Vector3.xml:364 doc/classes/Vector3i.xml:96
-msgid "Down unit vector."
+#: doc/classes/Vector2.xml:362 doc/classes/Vector2i.xml:88
+msgid "Down unit vector. Y is down in 2D, so this vector points +Y."
msgstr ""
#: doc/classes/Vector2i.xml:4
@@ -53749,6 +54700,16 @@ msgid ""
"will be truncated."
msgstr ""
+#: doc/classes/Vector2i.xml:46
+msgid "Returns the ratio of [member x] to [member y]."
+msgstr ""
+
+#: doc/classes/Vector2i.xml:53 doc/classes/Vector3i.xml:55
+msgid ""
+"Returns the vector with each component set to one or negative one, depending "
+"on the signs of the components."
+msgstr ""
+
#: doc/classes/Vector3.xml:4
msgid "Vector used for 3D math using floating point coordinates."
msgstr ""
@@ -53773,120 +54734,170 @@ msgid "Returns a [Vector3] with the given components."
msgstr ""
#: doc/classes/Vector3.xml:50
-msgid "Returns the minimum angle to the given vector."
+msgid "Returns the minimum angle to the given vector, in radians."
msgstr ""
#: doc/classes/Vector3.xml:66
-msgid "Returns a new vector with all components rounded up."
+msgid ""
+"Returns a new vector with all components rounded up (towards positive "
+"infinity)."
msgstr ""
#: doc/classes/Vector3.xml:75
-msgid "Returns the cross product with [code]b[/code]."
+msgid "Returns the cross product of this vector and [code]b[/code]."
msgstr ""
#: doc/classes/Vector3.xml:90
msgid ""
"Performs a cubic interpolation between vectors [code]pre_a[/code], [code]a[/"
"code], [code]b[/code], [code]post_b[/code] ([code]a[/code] is current), by "
-"the given amount [code]t[/code]. [code]t[/code] is in the range of [code]0.0 "
-"- 1.0[/code], representing the amount of interpolation."
+"the given amount [code]t[/code]. [code]t[/code] is on the range of 0.0 to "
+"1.0, representing the amount of interpolation."
msgstr ""
-#: doc/classes/Vector3.xml:108
-msgid ""
-"Returns the squared distance to [code]b[/code]. Prefer this function over "
-"[method distance_to] if you need to sort vectors or need the squared "
-"distance for some formula."
+#: doc/classes/Vector3.xml:118
+msgid "Returns the distance between this vector and [code]b[/code]."
msgstr ""
-#: doc/classes/Vector3.xml:117
-msgid "Returns the distance to [code]b[/code]."
-msgstr ""
-
-#: doc/classes/Vector3.xml:126
-msgid "Returns the dot product with [code]b[/code]."
+#: doc/classes/Vector3.xml:127
+msgid ""
+"Returns the dot product of this vector and [code]b[/code]. This can be used "
+"to compare the angle between two vectors. For example, this can be used to "
+"determine whether an enemy is facing the player.\n"
+"The dot product will be [code]0[/code] for a straight angle (90 degrees), "
+"greater than 0 for angles narrower than 90 degrees and lower than 0 for "
+"angles wider than 90 degrees.\n"
+"When using unit (normalized) vectors, the result will always be between "
+"[code]-1.0[/code] (180 degree angle) when the vectors are facing opposite "
+"directions, and [code]1.0[/code] (0 degree angle) when the vectors are "
+"aligned.\n"
+"[b]Note:[/b] [code]a.dot(b)[/code] is equivalent to [code]b.dot(a)[/code]."
msgstr ""
-#: doc/classes/Vector3.xml:133
-msgid "Returns a new vector with all components rounded down."
+#: doc/classes/Vector3.xml:137
+msgid ""
+"Returns a new vector with all components rounded down (towards negative "
+"infinity)."
msgstr ""
-#: doc/classes/Vector3.xml:140
+#: doc/classes/Vector3.xml:144
msgid ""
"Returns the inverse of the vector. This is the same as [code]Vector3( 1.0 / "
"v.x, 1.0 / v.y, 1.0 / v.z )[/code]."
msgstr ""
-#: doc/classes/Vector3.xml:170
+#: doc/classes/Vector3.xml:193 doc/classes/Vector3i.xml:41
msgid ""
-"Returns the vector's length squared. Prefer this function over [method "
-"length] if you need to sort vectors or need the squared length for some "
-"formula."
+"Returns the axis of the vector's largest value. See [code]AXIS_*[/code] "
+"constants. If all components are equal, this method returns [constant "
+"AXIS_X]."
msgstr ""
-#: doc/classes/Vector3.xml:181
+#: doc/classes/Vector3.xml:200 doc/classes/Vector3i.xml:48
msgid ""
-"Returns the result of the linear interpolation between this vector and "
-"[code]b[/code] by amount [code]t[/code]. [code]t[/code] is in the range of "
-"[code]0.0 - 1.0[/code], representing the amount of interpolation.."
+"Returns the axis of the vector's smallest value. See [code]AXIS_*[/code] "
+"constants. If all components are equal, this method returns [constant "
+"AXIS_Z]."
msgstr ""
-#: doc/classes/Vector3.xml:188 doc/classes/Vector3i.xml:41
+#: doc/classes/Vector3.xml:211
msgid ""
-"Returns the axis of the vector's largest value. See [code]AXIS_*[/code] "
-"constants."
+"Moves this vector toward [code]to[/code] by the fixed [code]delta[/code] "
+"amount."
+msgstr ""
+
+#: doc/classes/Vector3.xml:227
+msgid "Returns the outer product with [code]b[/code]."
msgstr ""
-#: doc/classes/Vector3.xml:195 doc/classes/Vector3i.xml:48
+#: doc/classes/Vector3.xml:254
+msgid "Returns this vector projected onto another vector [code]b[/code]."
+msgstr ""
+
+#: doc/classes/Vector3.xml:263
+msgid "Returns this vector reflected from a plane defined by the given normal."
+msgstr ""
+
+#: doc/classes/Vector3.xml:274
msgid ""
-"Returns the axis of the vector's smallest value. See [code]AXIS_*[/code] "
-"constants."
+"Rotates this vector around a given axis by [code]phi[/code] radians. The "
+"axis must be a normalized vector."
msgstr ""
-#: doc/classes/Vector3.xml:222
-msgid "Returns the outer product with [code]b[/code]."
+#: doc/classes/Vector3.xml:281
+msgid ""
+"Returns this vector with all components rounded to the nearest integer, with "
+"halfway cases rounded away from zero."
msgstr ""
-#: doc/classes/Vector3.xml:269
+#: doc/classes/Vector3.xml:288
msgid ""
-"Rotates the vector around a given axis by [code]phi[/code] radians. The axis "
-"must be a normalized vector."
+"Returns a vector with each component set to one or negative one, depending "
+"on the signs of this vector's components, or zero if the component is zero, "
+"by calling [method @GDScript.sign] on each component."
msgstr ""
-#: doc/classes/Vector3.xml:320
-msgid "Returns a diagonal matrix with the vector as main diagonal."
+#: doc/classes/Vector3.xml:325
+msgid ""
+"Returns a diagonal matrix with the vector as main diagonal.\n"
+"This is equivalent to a Basis with no rotation or shearing and this vector's "
+"components set as the scale."
msgstr ""
-#: doc/classes/Vector3.xml:332 doc/classes/Vector3i.xml:67
+#: doc/classes/Vector3.xml:338 doc/classes/Vector3i.xml:67
msgid ""
"The vector's Z component. Also accessible by using the index position [code]"
"[2][/code]."
msgstr ""
-#: doc/classes/Vector3.xml:337
+#: doc/classes/Vector3.xml:343
msgid ""
"Enumerated value for the X axis. Returned by [method max_axis] and [method "
"min_axis]."
msgstr ""
-#: doc/classes/Vector3.xml:340
+#: doc/classes/Vector3.xml:346
msgid ""
"Enumerated value for the Y axis. Returned by [method max_axis] and [method "
"min_axis]."
msgstr ""
-#: doc/classes/Vector3.xml:343
+#: doc/classes/Vector3.xml:349
msgid ""
"Enumerated value for the Z axis. Returned by [method max_axis] and [method "
"min_axis]."
msgstr ""
-#: doc/classes/Vector3.xml:367 doc/classes/Vector3i.xml:99
-msgid "Forward unit vector."
+#: doc/classes/Vector3.xml:361 doc/classes/Vector3i.xml:87
+msgid ""
+"Left unit vector. Represents the local direction of left, and the global "
+"direction of west."
+msgstr ""
+
+#: doc/classes/Vector3.xml:364 doc/classes/Vector3i.xml:90
+msgid ""
+"Right unit vector. Represents the local direction of right, and the global "
+"direction of east."
+msgstr ""
+
+#: doc/classes/Vector3.xml:367 doc/classes/Vector3i.xml:93
+msgid "Up unit vector."
+msgstr ""
+
+#: doc/classes/Vector3.xml:370 doc/classes/Vector3i.xml:96
+msgid "Down unit vector."
+msgstr ""
+
+#: doc/classes/Vector3.xml:373 doc/classes/Vector3i.xml:99
+msgid ""
+"Forward unit vector. Represents the local direction of forward, and the "
+"global direction of north."
msgstr ""
-#: doc/classes/Vector3.xml:370 doc/classes/Vector3i.xml:102
-msgid "Back unit vector."
+#: doc/classes/Vector3.xml:376 doc/classes/Vector3i.xml:102
+msgid ""
+"Back unit vector. Represents the local direction of back, and the global "
+"direction of south."
msgstr ""
#: doc/classes/Vector3i.xml:4
@@ -53935,10 +54946,14 @@ msgid ""
"directly.\n"
"[b]Note:[/b] The origin point of your VehicleBody3D will determine the "
"center of gravity of your vehicle so it is better to keep this low and move "
-"the [CollisionShape3D] and [MeshInstance3D] upwards."
+"the [CollisionShape3D] and [MeshInstance3D] upwards.\n"
+"[b]Note:[/b] This class has known issues and isn't designed to provide "
+"realistic 3D vehicle physics. If you want advanced vehicle physics, you will "
+"probably have to write your own physics integration using another "
+"[PhysicsBody3D] class."
msgstr ""
-#: doc/classes/VehicleBody3D.xml:16
+#: doc/classes/VehicleBody3D.xml:17
msgid ""
"Slows down the vehicle by applying a braking force. The vehicle is only "
"slowed down if the wheels are in contact with a surface. The force you need "
@@ -53947,7 +54962,7 @@ msgid ""
"a value in the 25 - 30 range for hard braking."
msgstr ""
-#: doc/classes/VehicleBody3D.xml:19
+#: doc/classes/VehicleBody3D.xml:20
msgid ""
"Accelerates the vehicle by applying an engine force. The vehicle is only "
"speed up if the wheels that have [member VehicleWheel3D.use_as_traction] set "
@@ -53960,7 +54975,7 @@ msgid ""
"A negative value will result in the vehicle reversing."
msgstr ""
-#: doc/classes/VehicleBody3D.xml:25
+#: doc/classes/VehicleBody3D.xml:26
msgid ""
"The steering angle for the vehicle. Setting this to a non-zero value will "
"result in the vehicle turning when it's moving. Wheels that have [member "
@@ -53976,25 +54991,29 @@ msgstr ""
msgid ""
"This node needs to be used as a child node of [VehicleBody3D] and simulates "
"the behavior of one of its wheels. This node also acts as a collider to "
-"detect if the wheel is touching a surface."
+"detect if the wheel is touching a surface.\n"
+"[b]Note:[/b] This class has known issues and isn't designed to provide "
+"realistic 3D vehicle physics. If you want advanced vehicle physics, you will "
+"probably have to write your own physics integration using another "
+"[PhysicsBody3D] class."
msgstr ""
-#: doc/classes/VehicleWheel3D.xml:16
+#: doc/classes/VehicleWheel3D.xml:17
msgid "Returns the rotational speed of the wheel in revolutions per minute."
msgstr ""
-#: doc/classes/VehicleWheel3D.xml:23
+#: doc/classes/VehicleWheel3D.xml:24
msgid ""
"Returns a value between 0.0 and 1.0 that indicates whether this wheel is "
"skidding. 0.0 is skidding (the wheel has lost grip, e.g. icy terrain), 1.0 "
"means not skidding (the wheel has full grip, e.g. dry asphalt road)."
msgstr ""
-#: doc/classes/VehicleWheel3D.xml:30
+#: doc/classes/VehicleWheel3D.xml:31
msgid "Returns [code]true[/code] if this wheel is in contact with a surface."
msgstr ""
-#: doc/classes/VehicleWheel3D.xml:36
+#: doc/classes/VehicleWheel3D.xml:37
msgid ""
"Slows down the wheel by applying a braking force. The wheel is only slowed "
"down if it is in contact with a surface. The force you need to apply to "
@@ -54003,7 +55022,7 @@ msgid ""
"- 30 range for hard braking."
msgstr ""
-#: doc/classes/VehicleWheel3D.xml:39
+#: doc/classes/VehicleWheel3D.xml:40
msgid ""
"The damping applied to the spring when the spring is being compressed. This "
"value should be between 0.0 (no damping) and 1.0. A value of 0.0 means the "
@@ -54011,7 +55030,7 @@ msgid ""
"is around 0.3 for a normal car, 0.5 for a race car."
msgstr ""
-#: doc/classes/VehicleWheel3D.xml:42
+#: doc/classes/VehicleWheel3D.xml:43
msgid ""
"The damping applied to the spring when relaxing. This value should be "
"between 0.0 (no damping) and 1.0. This value should always be slightly "
@@ -54019,7 +55038,7 @@ msgid ""
"damping_compression] value of 0.3, try a relaxation value of 0.5."
msgstr ""
-#: doc/classes/VehicleWheel3D.xml:45
+#: doc/classes/VehicleWheel3D.xml:46
msgid ""
"Accelerates the wheel by applying an engine force. The wheel is only speed "
"up if it is in contact with a surface. The [member RigidBody3D.mass] of the "
@@ -54030,13 +55049,13 @@ msgid ""
"A negative value will result in the wheel reversing."
msgstr ""
-#: doc/classes/VehicleWheel3D.xml:50
+#: doc/classes/VehicleWheel3D.xml:51
msgid ""
"The steering angle for the wheel. Setting this to a non-zero value will "
"result in the vehicle turning when it's moving."
msgstr ""
-#: doc/classes/VehicleWheel3D.xml:53
+#: doc/classes/VehicleWheel3D.xml:54
msgid ""
"The maximum force the spring can resist. This value should be higher than a "
"quarter of the [member RigidBody3D.mass] of the [VehicleBody3D] or the "
@@ -54044,28 +55063,28 @@ msgid ""
"obtained by a value that is about 3× to 4× this number."
msgstr ""
-#: doc/classes/VehicleWheel3D.xml:56
+#: doc/classes/VehicleWheel3D.xml:57
msgid ""
"This value defines the stiffness of the suspension. Use a value lower than "
"50 for an off-road car, a value between 50 and 100 for a race car and try "
"something around 200 for something like a Formula 1 car."
msgstr ""
-#: doc/classes/VehicleWheel3D.xml:59
+#: doc/classes/VehicleWheel3D.xml:60
msgid ""
"This is the distance the suspension can travel. As Godot units are "
"equivalent to meters, keep this setting relatively low. Try a value between "
"0.1 and 0.3 depending on the type of car."
msgstr ""
-#: doc/classes/VehicleWheel3D.xml:62
+#: doc/classes/VehicleWheel3D.xml:63
msgid ""
"If [code]true[/code], this wheel will be turned when the car steers. This "
"value is used in conjunction with [member VehicleBody3D.steering] and "
"ignored if you are using the per-wheel [member steering] value instead."
msgstr ""
-#: doc/classes/VehicleWheel3D.xml:65
+#: doc/classes/VehicleWheel3D.xml:66
msgid ""
"If [code]true[/code], this wheel transfers engine force to the ground to "
"propel the vehicle forward. This value is used in conjunction with [member "
@@ -54073,7 +55092,7 @@ msgid ""
"[member engine_force] value instead."
msgstr ""
-#: doc/classes/VehicleWheel3D.xml:68
+#: doc/classes/VehicleWheel3D.xml:69
msgid ""
"This determines how much grip this wheel has. It is combined with the "
"friction setting of the surface the wheel is in contact with. 0.0 means no "
@@ -54083,11 +55102,11 @@ msgid ""
"It's best to set this to 1.0 when starting out."
msgstr ""
-#: doc/classes/VehicleWheel3D.xml:72
+#: doc/classes/VehicleWheel3D.xml:73
msgid "The radius of the wheel in meters."
msgstr ""
-#: doc/classes/VehicleWheel3D.xml:75
+#: doc/classes/VehicleWheel3D.xml:76
msgid ""
"This is the distance in meters the wheel is lowered from its origin point. "
"Don't set this to 0.0 and move the wheel into position, instead move the "
@@ -54096,7 +55115,7 @@ msgid ""
"down to the position it should be in when the car is in rest."
msgstr ""
-#: doc/classes/VehicleWheel3D.xml:78
+#: doc/classes/VehicleWheel3D.xml:79
msgid ""
"This value affects the roll of your vehicle. If set to 1.0 for all wheels, "
"your vehicle will be prone to rolling over, while a value of 0.0 will resist "
@@ -54574,7 +55593,7 @@ msgstr ""
#: doc/classes/Viewport.xml:318
msgid ""
"Use fast approximate antialiasing. FXAA is a popular screen-space "
-"antialising method, which is fast but will make the image look blurry, "
+"antialiasing method, which is fast but will make the image look blurry, "
"especially at lower resolutions. It can still work relatively well at large "
"resolutions such as 1440p and 4K."
msgstr ""
@@ -54627,24 +55646,24 @@ msgid ""
"your [WorldEnvironment]."
msgstr ""
-#: doc/classes/Viewport.xml:384
+#: doc/classes/Viewport.xml:381
msgid ""
"Colors each PSSM split for the [DirectionalLight3D]s in the scene a "
"different color so you can see where the splits are. In order, they will be "
"colored red, green, blue, and yellow."
msgstr ""
-#: doc/classes/Viewport.xml:387
+#: doc/classes/Viewport.xml:384
msgid ""
"Draws the decal atlas used by [Decal]s and light projector textures in the "
"upper left quadrant of the [Viewport]."
msgstr ""
-#: doc/classes/Viewport.xml:402
+#: doc/classes/Viewport.xml:405
msgid "Max value for [enum DefaultCanvasItemTextureFilter] enum."
msgstr ""
-#: doc/classes/Viewport.xml:414
+#: doc/classes/Viewport.xml:417
msgid "Max value for [enum DefaultCanvasItemTextureRepeat] enum."
msgstr ""
@@ -54675,82 +55694,84 @@ msgid ""
"The VisibilityEnabler2D will disable [RigidBody2D], [AnimationPlayer], and "
"other nodes when they are not visible. It will only affect nodes with the "
"same root node as the VisibilityEnabler2D, and the root node itself.\n"
+"If you just want to receive notifications, use [VisibilityNotifier2D] "
+"instead.\n"
"[b]Note:[/b] For performance reasons, VisibilityEnabler2D uses an "
"approximate heuristic with precision determined by [member ProjectSettings."
-"world/2d/cell_size]. If you need exact visibility checking, use another "
+"world/2d/cell_size]. If you need precise visibility checking, use another "
"method such as adding an [Area2D] node as a child of a [Camera2D] node.\n"
"[b]Note:[/b] VisibilityEnabler2D will not affect nodes added after scene "
"initialization."
msgstr ""
-#: doc/classes/VisibilityEnabler2D.xml:20
-#: doc/classes/VisibilityEnabler3D.xml:20
+#: doc/classes/VisibilityEnabler2D.xml:21
+#: doc/classes/VisibilityEnabler3D.xml:21
msgid ""
"Returns whether the enabler identified by given [enum Enabler] constant is "
"active."
msgstr ""
-#: doc/classes/VisibilityEnabler2D.xml:31
-#: doc/classes/VisibilityEnabler3D.xml:31
+#: doc/classes/VisibilityEnabler2D.xml:32
+#: doc/classes/VisibilityEnabler3D.xml:32
msgid ""
"Sets active state of the enabler identified by given [enum Enabler] constant."
msgstr ""
-#: doc/classes/VisibilityEnabler2D.xml:37
+#: doc/classes/VisibilityEnabler2D.xml:38
msgid "If [code]true[/code], [RigidBody2D] nodes will be paused."
msgstr ""
-#: doc/classes/VisibilityEnabler2D.xml:40
+#: doc/classes/VisibilityEnabler2D.xml:41
msgid "If [code]true[/code], [AnimatedSprite2D] nodes will be paused."
msgstr ""
-#: doc/classes/VisibilityEnabler2D.xml:43
-#: doc/classes/VisibilityEnabler3D.xml:40
+#: doc/classes/VisibilityEnabler2D.xml:44
+#: doc/classes/VisibilityEnabler3D.xml:41
msgid "If [code]true[/code], [AnimationPlayer] nodes will be paused."
msgstr ""
-#: doc/classes/VisibilityEnabler2D.xml:46
+#: doc/classes/VisibilityEnabler2D.xml:47
msgid "If [code]true[/code], [GPUParticles2D] nodes will be paused."
msgstr ""
-#: doc/classes/VisibilityEnabler2D.xml:49
+#: doc/classes/VisibilityEnabler2D.xml:50
msgid ""
"If [code]true[/code], the parent's [method Node._physics_process] will be "
"stopped."
msgstr ""
-#: doc/classes/VisibilityEnabler2D.xml:52
+#: doc/classes/VisibilityEnabler2D.xml:53
msgid ""
"If [code]true[/code], the parent's [method Node._process] will be stopped."
msgstr ""
-#: doc/classes/VisibilityEnabler2D.xml:57
-#: doc/classes/VisibilityEnabler3D.xml:45
+#: doc/classes/VisibilityEnabler2D.xml:58
+#: doc/classes/VisibilityEnabler3D.xml:46
msgid "This enabler will pause [AnimationPlayer] nodes."
msgstr ""
-#: doc/classes/VisibilityEnabler2D.xml:60
+#: doc/classes/VisibilityEnabler2D.xml:61
msgid "This enabler will freeze [RigidBody2D] nodes."
msgstr ""
-#: doc/classes/VisibilityEnabler2D.xml:63
+#: doc/classes/VisibilityEnabler2D.xml:64
msgid "This enabler will stop [GPUParticles2D] nodes."
msgstr ""
-#: doc/classes/VisibilityEnabler2D.xml:66
+#: doc/classes/VisibilityEnabler2D.xml:67
msgid "This enabler will stop the parent's _process function."
msgstr ""
-#: doc/classes/VisibilityEnabler2D.xml:69
+#: doc/classes/VisibilityEnabler2D.xml:70
msgid "This enabler will stop the parent's _physics_process function."
msgstr ""
-#: doc/classes/VisibilityEnabler2D.xml:72
+#: doc/classes/VisibilityEnabler2D.xml:73
msgid "This enabler will stop [AnimatedSprite2D] nodes animations."
msgstr ""
-#: doc/classes/VisibilityEnabler2D.xml:75
-#: doc/classes/VisibilityEnabler3D.xml:51
+#: doc/classes/VisibilityEnabler2D.xml:76
+#: doc/classes/VisibilityEnabler3D.xml:52
msgid "Represents the size of the [enum Enabler] enum."
msgstr ""
@@ -54759,19 +55780,23 @@ msgid ""
"The VisibilityEnabler3D will disable [RigidBody3D] and [AnimationPlayer] "
"nodes when they are not visible. It will only affect other nodes within the "
"same scene as the VisibilityEnabler3D itself.\n"
+"If you just want to receive notifications, use [VisibilityNotifier3D] "
+"instead.\n"
"[b]Note:[/b] VisibilityEnabler3D uses an approximate heuristic for "
"performance reasons. It doesn't take walls and other occlusion into account. "
-"If you need exact visibility checking, use another method such as adding an "
-"[Area3D] node as a child of a [Camera3D] node.\n"
+"The heuristic is an implementation detail and may change in future versions. "
+"If you need precise visibility checking, use another method such as adding "
+"an [Area3D] node as a child of a [Camera3D] node and/or [method Vector3."
+"dot].\n"
"[b]Note:[/b] VisibilityEnabler3D will not affect nodes added after scene "
"initialization."
msgstr ""
-#: doc/classes/VisibilityEnabler3D.xml:37
+#: doc/classes/VisibilityEnabler3D.xml:38
msgid "If [code]true[/code], [RigidBody3D] nodes will be paused."
msgstr ""
-#: doc/classes/VisibilityEnabler3D.xml:48
+#: doc/classes/VisibilityEnabler3D.xml:49
msgid "This enabler will freeze [RigidBody3D] nodes."
msgstr ""
@@ -54785,13 +55810,15 @@ msgid ""
"The VisibilityNotifier2D detects when it is visible on the screen. It also "
"notifies when its bounding rectangle enters or exits the screen or a "
"viewport.\n"
+"If you want nodes to be disabled automatically when they exit the screen, "
+"use [VisibilityEnabler2D] instead.\n"
"[b]Note:[/b] For performance reasons, VisibilityNotifier2D uses an "
"approximate heuristic with precision determined by [member ProjectSettings."
-"world/2d/cell_size]. If you need exact visibility checking, use another "
+"world/2d/cell_size]. If you need precise visibility checking, use another "
"method such as adding an [Area2D] node as a child of a [Camera2D] node."
msgstr ""
-#: doc/classes/VisibilityNotifier2D.xml:17
+#: doc/classes/VisibilityNotifier2D.xml:18
msgid ""
"If [code]true[/code], the bounding rectangle is on the screen.\n"
"[b]Note:[/b] It takes one frame for the node's visibility to be assessed "
@@ -54800,23 +55827,23 @@ msgid ""
"pass."
msgstr ""
-#: doc/classes/VisibilityNotifier2D.xml:24
+#: doc/classes/VisibilityNotifier2D.xml:25
msgid "The VisibilityNotifier2D's bounding rectangle."
msgstr ""
-#: doc/classes/VisibilityNotifier2D.xml:30
+#: doc/classes/VisibilityNotifier2D.xml:31
msgid "Emitted when the VisibilityNotifier2D enters the screen."
msgstr ""
-#: doc/classes/VisibilityNotifier2D.xml:35
+#: doc/classes/VisibilityNotifier2D.xml:36
msgid "Emitted when the VisibilityNotifier2D exits the screen."
msgstr ""
-#: doc/classes/VisibilityNotifier2D.xml:42
+#: doc/classes/VisibilityNotifier2D.xml:43
msgid "Emitted when the VisibilityNotifier2D enters a [Viewport]'s view."
msgstr ""
-#: doc/classes/VisibilityNotifier2D.xml:49
+#: doc/classes/VisibilityNotifier2D.xml:50
msgid "Emitted when the VisibilityNotifier2D exits a [Viewport]'s view."
msgstr ""
@@ -54825,13 +55852,16 @@ msgid ""
"The VisibilityNotifier3D detects when it is visible on the screen. It also "
"notifies when its bounding rectangle enters or exits the screen or a "
"[Camera3D]'s view.\n"
+"If you want nodes to be disabled automatically when they exit the screen, "
+"use [VisibilityEnabler3D] instead.\n"
"[b]Note:[/b] VisibilityNotifier3D uses an approximate heuristic for "
"performance reasons. It doesn't take walls and other occlusion into account. "
-"If you need exact visibility checking, use another method such as adding an "
-"[Area3D] node as a child of a [Camera3D] node."
+"The heuristic is an implementation detail and may change in future versions. "
+"If you need precise visibility checking, use another method such as adding "
+"an [Area3D] node as a child of a [Camera3D] node and/or [method Vector3.dot]."
msgstr ""
-#: doc/classes/VisibilityNotifier3D.xml:17
+#: doc/classes/VisibilityNotifier3D.xml:18
msgid ""
"If [code]true[/code], the bounding box is on the screen.\n"
"[b]Note:[/b] It takes one frame for the node's visibility to be assessed "
@@ -54840,23 +55870,23 @@ msgid ""
"pass."
msgstr ""
-#: doc/classes/VisibilityNotifier3D.xml:24
+#: doc/classes/VisibilityNotifier3D.xml:25
msgid "The VisibilityNotifier3D's bounding box."
msgstr ""
-#: doc/classes/VisibilityNotifier3D.xml:32
+#: doc/classes/VisibilityNotifier3D.xml:33
msgid "Emitted when the VisibilityNotifier3D enters a [Camera3D]'s view."
msgstr ""
-#: doc/classes/VisibilityNotifier3D.xml:39
+#: doc/classes/VisibilityNotifier3D.xml:40
msgid "Emitted when the VisibilityNotifier3D exits a [Camera3D]'s view."
msgstr ""
-#: doc/classes/VisibilityNotifier3D.xml:44
+#: doc/classes/VisibilityNotifier3D.xml:45
msgid "Emitted when the VisibilityNotifier3D enters the screen."
msgstr ""
-#: doc/classes/VisibilityNotifier3D.xml:49
+#: doc/classes/VisibilityNotifier3D.xml:50
msgid "Emitted when the VisibilityNotifier3D exits the screen."
msgstr ""
@@ -55276,6 +56306,15 @@ msgid ""
"exist."
msgstr ""
+#: modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml:90
+msgid ""
+"Easing function, based on exponent. 0 is constant, 1 is linear, 0 to 1 is "
+"ease-in, 1+ is ease out. Negative values are in-out/out in."
+msgstr ""
+"缓动函数,基于指数。[code]s[/code]是函数的x值,[code]curve[/code]为0时,函数"
+"为常数函数,1是线性函数,0到1是缓入,1+是缓出。0到-1是缓出再缓入,低于-1是缓"
+"入再缓出。"
+
#: modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml:93
msgid ""
"Return the number of digit places after the decimal that the first non-zero "
@@ -56161,6 +57200,7 @@ msgid "A shader for light calculations."
msgstr ""
#: doc/classes/VisualShader.xml:214
+#: doc/classes/VisualShaderNodeMultiplyAdd.xml:26
msgid "Represents the size of the [enum Type] enum."
msgstr ""
@@ -56263,6 +57303,24 @@ msgstr ""
msgid "Translated to [code]uniform bool[/code] in the shader language."
msgstr ""
+#: doc/classes/VisualShaderNodeBooleanUniform.xml:15
+#: doc/classes/VisualShaderNodeColorUniform.xml:15
+#: doc/classes/VisualShaderNodeFloatUniform.xml:15
+#: doc/classes/VisualShaderNodeIntUniform.xml:15
+#: doc/classes/VisualShaderNodeTransformUniform.xml:15
+#: doc/classes/VisualShaderNodeVec3Uniform.xml:15
+msgid "A default value to be assigned within the shader."
+msgstr ""
+
+#: doc/classes/VisualShaderNodeBooleanUniform.xml:18
+#: doc/classes/VisualShaderNodeColorUniform.xml:18
+#: doc/classes/VisualShaderNodeFloatUniform.xml:18
+#: doc/classes/VisualShaderNodeIntUniform.xml:18
+#: doc/classes/VisualShaderNodeTransformUniform.xml:18
+#: doc/classes/VisualShaderNodeVec3Uniform.xml:18
+msgid "Enables usage of the [member default_value]."
+msgstr ""
+
#: doc/classes/VisualShaderNodeColorConstant.xml:4
msgid "A [Color] constant to be used within the visual shader graph."
msgstr ""
@@ -57113,49 +58171,49 @@ msgstr ""
msgid "Translated to [code]uniform float[/code] in the shader language."
msgstr ""
-#: doc/classes/VisualShaderNodeFloatUniform.xml:15
-#: doc/classes/VisualShaderNodeIntUniform.xml:15
+#: doc/classes/VisualShaderNodeFloatUniform.xml:21
+#: doc/classes/VisualShaderNodeIntUniform.xml:21
msgid ""
"A hint applied to the uniform, which controls the values it can take when "
"set through the inspector."
msgstr ""
-#: doc/classes/VisualShaderNodeFloatUniform.xml:18
-#: doc/classes/VisualShaderNodeIntUniform.xml:18
+#: doc/classes/VisualShaderNodeFloatUniform.xml:24
+#: doc/classes/VisualShaderNodeIntUniform.xml:24
msgid ""
"Minimum value for range hints. Used if [member hint] is set to [constant "
"HINT_RANGE] or [constant HINT_RANGE_STEP]."
msgstr ""
-#: doc/classes/VisualShaderNodeFloatUniform.xml:21
-#: doc/classes/VisualShaderNodeIntUniform.xml:21
+#: doc/classes/VisualShaderNodeFloatUniform.xml:27
+#: doc/classes/VisualShaderNodeIntUniform.xml:27
msgid ""
"Maximum value for range hints. Used if [member hint] is set to [constant "
"HINT_RANGE] or [constant HINT_RANGE_STEP]."
msgstr ""
-#: doc/classes/VisualShaderNodeFloatUniform.xml:24
-#: doc/classes/VisualShaderNodeIntUniform.xml:24
+#: doc/classes/VisualShaderNodeFloatUniform.xml:30
+#: doc/classes/VisualShaderNodeIntUniform.xml:30
msgid ""
"Step (increment) value for the range hint with step. Used if [member hint] "
"is set to [constant HINT_RANGE_STEP]."
msgstr ""
-#: doc/classes/VisualShaderNodeFloatUniform.xml:29
-#: doc/classes/VisualShaderNodeIntUniform.xml:29
+#: doc/classes/VisualShaderNodeFloatUniform.xml:35
+#: doc/classes/VisualShaderNodeIntUniform.xml:35
msgid "No hint used."
msgstr ""
-#: doc/classes/VisualShaderNodeFloatUniform.xml:32
-#: doc/classes/VisualShaderNodeIntUniform.xml:32
+#: doc/classes/VisualShaderNodeFloatUniform.xml:38
+#: doc/classes/VisualShaderNodeIntUniform.xml:38
msgid ""
"A range hint for scalar value, which limits possible input values between "
"[member min] and [member max]. Translated to [code]hint_range(min, max)[/"
"code] in shader code."
msgstr ""
-#: doc/classes/VisualShaderNodeFloatUniform.xml:35
-#: doc/classes/VisualShaderNodeIntUniform.xml:35
+#: doc/classes/VisualShaderNodeFloatUniform.xml:41
+#: doc/classes/VisualShaderNodeIntUniform.xml:41
msgid ""
"A range hint for scalar value with step, which limits possible input values "
"between [member min] and [member max], with a step (increment) of [member "
@@ -57437,6 +58495,26 @@ msgid ""
"results, e.g. division by zero)."
msgstr ""
+#: doc/classes/VisualShaderNodeMultiplyAdd.xml:4
+msgid "Performs a fused multiply-add operation within the visual shader graph."
+msgstr ""
+
+#: doc/classes/VisualShaderNodeMultiplyAdd.xml:7
+msgid "Uses three operands to compute [code](a * b + c)[/code] expression."
+msgstr ""
+
+#: doc/classes/VisualShaderNodeMultiplyAdd.xml:15
+msgid "A type of operands and returned value."
+msgstr ""
+
+#: doc/classes/VisualShaderNodeMultiplyAdd.xml:20
+msgid "A scalar type."
+msgstr ""
+
+#: doc/classes/VisualShaderNodeMultiplyAdd.xml:23
+msgid "A vector type."
+msgstr ""
+
#: doc/classes/VisualShaderNodeOuterProduct.xml:4
msgid ""
"Calculates an outer product of two vectors within the visual shader graph."
@@ -57459,7 +58537,7 @@ msgstr ""
#: doc/classes/VisualShaderNodeOutput.xml:7
msgid ""
"This visual shader node is present in all shader graphs in form of \"Output"
-"\" block with mutliple output value ports."
+"\" block with multiple output value ports."
msgstr ""
#: doc/classes/VisualShaderNodeSample3D.xml:4
@@ -57823,6 +58901,20 @@ msgid ""
"[ShaderMaterial] properties."
msgstr ""
+#: doc/classes/VisualShaderNodeUniformRef.xml:4
+msgid "A reference to an existing [VisualShaderNodeUniform]."
+msgstr ""
+
+#: doc/classes/VisualShaderNodeUniformRef.xml:7
+msgid ""
+"Creating a reference to a [VisualShaderNodeUniform] allows you to reuse this "
+"uniform in different shaders or shader stages easily."
+msgstr ""
+
+#: doc/classes/VisualShaderNodeUniformRef.xml:15
+msgid "The name of the uniform which this reference points to."
+msgstr ""
+
#: doc/classes/VisualShaderNodeVec3Constant.xml:4
msgid "A [Vector3] constant to be used within the visual shader graph."
msgstr ""
@@ -58153,7 +59245,7 @@ msgstr ""
msgid ""
"Translated to [code]refract(I, N, eta)[/code] in the shader language, where "
"[code]I[/code] is the incident vector, [code]N[/code] is the normal vector "
-"and [code]eta[/code] is the ratio of the indicies of the refraction."
+"and [code]eta[/code] is the ratio of the indices of the refraction."
msgstr ""
#: doc/classes/VisualShaderNodeVectorScalarMix.xml:4
@@ -59929,4 +61021,4 @@ msgstr ""
#: doc/classes/YSort.xml:16
msgid ""
"If [code]true[/code], child nodes are sorted, otherwise sorting is disabled."
-msgstr ""
+msgstr "如果为 [code]true[/code],则对子节点进行排序,否则将禁用排序。"