diff options
Diffstat (limited to 'doc/translations/sk.po')
| -rw-r--r-- | doc/translations/sk.po | 2517 |
1 files changed, 2010 insertions, 507 deletions
diff --git a/doc/translations/sk.po b/doc/translations/sk.po index 8229fd93a9..e5562df057 100644 --- a/doc/translations/sk.po +++ b/doc/translations/sk.po @@ -348,7 +348,7 @@ msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml msgid "" "Compares two values by checking their actual contents, recursing into any " -"`Array` or `Dictionary` up to its deepest level.\n" +"[Array] or [Dictionary] up to its deepest level.\n" "This compares to [code]==[/code] in a number of ways:\n" "- For [code]null[/code], [code]int[/code], [code]float[/code], [code]String[/" "code], [code]Object[/code] and [code]RID[/code] both [code]deep_equal[/code] " @@ -395,7 +395,7 @@ msgid "" "- 1.0: Linear\n" "- Greater than 1.0 (exclusive): Ease in\n" "[/codeblock]\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/3.4/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/3.5/img/" "ease_cheatsheet.png]ease() curve values cheatsheet[/url]\n" "See also [method smoothstep]. If you need to perform more advanced " "transitions, use [Tween] or [AnimationPlayer]." @@ -541,8 +541,9 @@ msgid "" "[code]0.0[/code] and [code]1.0[/code] if [code]weight[/code] is between " "[code]from[/code] and [code]to[/code] (inclusive). If [code]weight[/code] is " "located outside this range, then an extrapolation factor will be returned " -"(return value lower than [code]0.0[/code] or greater than [code]1.0[/" -"code]).\n" +"(return value lower than [code]0.0[/code] or greater than [code]1.0[/code]). " +"Use [method clamp] on the result of [method inverse_lerp] if this is not " +"desired.\n" "[codeblock]\n" "# The interpolation ratio in the `lerp()` call below is 0.75.\n" "var middle = lerp(20, 30, 0.75)\n" @@ -552,7 +553,8 @@ msgid "" "var ratio = inverse_lerp(20, 30, 27.5)\n" "# `ratio` is now 0.75.\n" "[/codeblock]\n" -"See also [method lerp] which performs the reverse of this operation." +"See also [method lerp] which performs the reverse of this operation, and " +"[method range_lerp] to map a continuous series of values to another." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -606,7 +608,8 @@ msgid "" "[code]weight[/code]. To perform interpolation, [code]weight[/code] should be " "between [code]0.0[/code] and [code]1.0[/code] (inclusive). However, values " "outside this range are allowed and can be used to perform [i]extrapolation[/" -"i].\n" +"i]. Use [method clamp] on the result of [method lerp] if this is not " +"desired.\n" "If the [code]from[/code] and [code]to[/code] arguments are of type [int] or " "[float], the return value is a [float].\n" "If both are of the same vector type ([Vector2], [Vector3] or [Color]), the " @@ -618,7 +621,8 @@ msgid "" "[/codeblock]\n" "See also [method inverse_lerp] which performs the reverse of this operation. " "To perform eased interpolation with [method lerp], combine it with [method " -"ease] or [method smoothstep]." +"ease] or [method smoothstep]. See also [method range_lerp] to map a " +"continuous series of values to another." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -848,7 +852,14 @@ msgid "" msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml -msgid "Like [method print], but prints only when used in debug mode." +msgid "" +"Like [method print], but includes the current stack frame when running with " +"the debugger turned on.\n" +"Output in the console would look something like this:\n" +"[codeblock]\n" +"Test print\n" +" At: res://test.gd:15:_process()\n" +"[/codeblock]" msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -1026,10 +1037,15 @@ msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml msgid "" "Maps a [code]value[/code] from range [code][istart, istop][/code] to [code]" -"[ostart, ostop][/code].\n" +"[ostart, ostop][/code]. See also [method lerp] and [method inverse_lerp]. If " +"[code]value[/code] is outside [code][istart, istop][/code], then the " +"resulting value will also be outside [code][ostart, ostop][/code]. Use " +"[method clamp] on the result of [method range_lerp] if this is not desired.\n" "[codeblock]\n" "range_lerp(75, 0, 100, -1, 1) # Returns 0.5\n" -"[/codeblock]" +"[/codeblock]\n" +"For complex use cases where you need multiple ranges, consider using [Curve] " +"or [Gradient] instead." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -1102,7 +1118,7 @@ msgid "" "[method smoothstep] returns the smoothest possible curve with no sudden " "changes in the derivative. If you need to perform more advanced transitions, " "use [Tween] or [AnimationPlayer].\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/3.4/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/3.5/img/" "smoothstep_ease_comparison.png]Comparison between smoothstep() and ease(x, " "-1.6521) return values[/url]" msgstr "" @@ -3380,6 +3396,12 @@ msgstr "" #: doc/classes/@GlobalScope.xml msgid "" +"Hints that an integer property is a bitmask using the optionally named 2D " +"navigation layers." +msgstr "" + +#: doc/classes/@GlobalScope.xml +msgid "" "Hints that an integer property is a bitmask using the optionally named 3D " "render layers." msgstr "" @@ -3392,6 +3414,12 @@ msgstr "" #: doc/classes/@GlobalScope.xml msgid "" +"Hints that an integer property is a bitmask using the optionally named 3D " +"navigation layers." +msgstr "" + +#: doc/classes/@GlobalScope.xml +msgid "" "Hints that a string property is a path to a file. Editing it will show a " "file dialog for picking the path. The hint string can be a set of filters " "with wildcards like [code]\"*.png,*.jpg\"[/code]." @@ -4828,19 +4856,21 @@ msgid "" msgstr "" #: doc/classes/AnimationNode.xml -msgid "Gets the text caption for this node (used by some editors)." +msgid "" +"When inheriting from [AnimationRootNode], implement this virtual method to " +"override the text caption for this node." msgstr "" #: doc/classes/AnimationNode.xml msgid "" -"Gets a child node by index (used by editors inheriting from " -"[AnimationRootNode])." +"When inheriting from [AnimationRootNode], implement this virtual method to " +"return a child node by its [code]name[/code]." msgstr "" #: doc/classes/AnimationNode.xml msgid "" -"Gets all children nodes in order as a [code]name: node[/code] dictionary. " -"Only useful when inheriting [AnimationRootNode]." +"When inheriting from [AnimationRootNode], implement this virtual method to " +"return all children nodes in order as a [code]name: node[/code] dictionary." msgstr "" #: doc/classes/AnimationNode.xml @@ -4861,21 +4891,25 @@ msgstr "" #: doc/classes/AnimationNode.xml msgid "" -"Gets the default value of a parameter. Parameters are custom local memory " -"used for your nodes, given a resource can be reused in multiple trees." +"When inheriting from [AnimationRootNode], implement this virtual method to " +"return the default value of parameter \"[code]name[/code]\". Parameters are " +"custom local memory used for your nodes, given a resource can be reused in " +"multiple trees." msgstr "" #: doc/classes/AnimationNode.xml msgid "" -"Gets the property information for parameter. Parameters are custom local " +"When inheriting from [AnimationRootNode], implement this virtual method to " +"return a list of the properties on this node. Parameters are custom local " "memory used for your nodes, given a resource can be reused in multiple " "trees. Format is similar to [method Object.get_property_list]." msgstr "" #: doc/classes/AnimationNode.xml msgid "" -"Returns [code]true[/code] whether you want the blend tree editor to display " -"filter editing on this node." +"When inheriting from [AnimationRootNode], implement this virtual method to " +"return whether the blend tree editor should display filter editing on this " +"node." msgstr "" #: doc/classes/AnimationNode.xml @@ -4884,9 +4918,10 @@ msgstr "" #: doc/classes/AnimationNode.xml msgid "" -"User-defined callback called when a custom node is processed. The " -"[code]time[/code] parameter is a relative delta, unless [code]seek[/code] is " -"[code]true[/code], in which case it is absolute.\n" +"When inheriting from [AnimationRootNode], implement this virtual method to " +"run some code when this node is processed. The [code]time[/code] parameter " +"is a relative delta, unless [code]seek[/code] is [code]true[/code], in which " +"case it is absolute.\n" "Here, call the [method blend_input], [method blend_node] or [method " "blend_animation] functions. You can also use [method get_parameter] and " "[method set_parameter] to modify local memory.\n" @@ -5538,9 +5573,9 @@ msgid "" "Turn on auto advance when this condition is set. The provided name will " "become a boolean parameter on the [AnimationTree] that can be controlled " "from code (see [url=$DOCS_URL/tutorials/animation/animation_tree." -"html#controlling-from-code][/url]). For example, if [member AnimationTree." -"tree_root] is an [AnimationNodeStateMachine] and [member advance_condition] " -"is set to [code]\"idle\"[/code]:\n" +"html#controlling-from-code]Using AnimationTree[/url]). For example, if " +"[member AnimationTree.tree_root] is an [AnimationNodeStateMachine] and " +"[member advance_condition] is set to [code]\"idle\"[/code]:\n" "[codeblock]\n" "$animation_tree[\"parameters/conditions/idle\"] = is_on_floor and " "(linear_velocity.x == 0)\n" @@ -5714,8 +5749,8 @@ msgstr "" #: doc/classes/AnimationPlayer.xml msgid "" -"Returns the [Animation] with key [code]name[/code] or [code]null[/code] if " -"not found." +"Returns the [Animation] with the key [code]name[/code]. If the animation " +"does not exist, [code]null[/code] is returned and an error is logged." msgstr "" #: doc/classes/AnimationPlayer.xml @@ -6426,7 +6461,12 @@ msgstr "" msgid "" "3D area that detects [CollisionObject] nodes overlapping, entering, or " "exiting. Can also alter or override local physics parameters (gravity, " -"damping) and route audio to custom audio buses." +"damping) and route audio to a custom audio bus.\n" +"To give the area its shape, add a [CollisionShape] or a [CollisionPolygon] " +"node as a [i]direct[/i] child (or add multiple such nodes as direct " +"children) of the area.\n" +"[b]Warning:[/b] See [ConcavePolygonShape] (also called \"trimesh\") for a " +"warning about possibly unexpected behavior when using that shape for an area." msgstr "" #: doc/classes/Area.xml doc/classes/QuadMesh.xml doc/classes/Viewport.xml @@ -6663,7 +6703,12 @@ msgstr "" msgid "" "2D area that detects [CollisionObject2D] nodes overlapping, entering, or " "exiting. Can also alter or override local physics parameters (gravity, " -"damping) and route audio to a custom audio bus." +"damping) and route audio to a custom audio bus.\n" +"To give the area its shape, add a [CollisionShape2D] or a " +"[CollisionPolygon2D] node as a [i]direct[/i] child (or add multiple such " +"nodes as direct children) of the area.\n" +"[b]Warning:[/b] See [ConcavePolygonShape2D] for a warning about possibly " +"unexpected behavior when using that shape for an area." msgstr "" #: doc/classes/Area2D.xml @@ -7311,7 +7356,15 @@ msgid "" "mode\" where the vertex and other arrays become the sources of data and the " "index array defines the vertex order. All sub-arrays must have the same " "length as the vertex array or be empty, except for [constant ARRAY_INDEX] if " -"it is used." +"it is used.\n" +"[code]compress_flags[/code] is a bitfield made of [enum Mesh.ArrayFormat] " +"values. It defaults to [constant Mesh.ARRAY_COMPRESS_DEFAULT].\n" +"[b]Note:[/b] The default [code]compress_flags[/code] enable [constant Mesh." +"ARRAY_COMPRESS_COLOR], which makes vertex colors stored as 8-bit unsigned " +"integers. This will clamp overbright vertex colors to [code]Color(1, 1, 1, 1)" +"[/code] and reduce their precision. To store HDR vertex colors, remove the " +"vertex color compression flag by passing [code]Mesh.ARRAY_COMPRESS_DEFAULT ^ " +"Mesh.ARRAY_COMPRESS_COLOR[/code] as the value of [code]compress_flags[/code]." msgstr "" #: doc/classes/ArrayMesh.xml @@ -7673,8 +7726,8 @@ msgstr "" #: doc/classes/ARVRController.xml msgid "" "The degree to which the controller vibrates. Ranges from [code]0.0[/code] to " -"[code]1.0[/code] with precision [code].01[/code]. If changed, updates " -"[member ARVRPositionalTracker.rumble] accordingly.\n" +"[code]1.0[/code]. If changed, updates [member ARVRPositionalTracker.rumble] " +"accordingly.\n" "This is a useful property to animate if you want the controller to vibrate " "for a limited duration." msgstr "" @@ -8367,7 +8420,7 @@ msgid "" "[/codeblock]" msgstr "" -#: doc/classes/AStar.xml +#: doc/classes/AStar.xml doc/classes/AStar2D.xml msgid "" "Deletes the segment between the given points. If [code]bidirectional[/code] " "is [code]false[/code], only movement from [code]id[/code] to [code]to_id[/" @@ -8566,7 +8619,10 @@ msgid "" msgstr "" #: doc/classes/AStar2D.xml -msgid "Returns whether there is a connection/segment between the given points." +msgid "" +"Returns whether there is a connection/segment between the given points. If " +"[code]bidirectional[/code] is [code]false[/code], returns whether movement " +"from [code]id[/code] to [code]to_id[/code] is possible through this segment." msgstr "" #: doc/classes/AStar2D.xml @@ -8583,10 +8639,6 @@ msgid "" msgstr "" #: doc/classes/AStar2D.xml -msgid "Deletes the segment between the given points." -msgstr "" - -#: doc/classes/AStar2D.xml msgid "" "Returns the closest position to [code]to_position[/code] that resides inside " "a segment between two connected points.\n" @@ -8718,8 +8770,9 @@ msgid "" "resource is applied on." msgstr "" -#: doc/classes/AudioEffect.xml doc/classes/AudioEffectRecord.xml -#: doc/classes/AudioServer.xml doc/classes/AudioStream.xml +#: doc/classes/AudioEffect.xml doc/classes/AudioEffectCapture.xml +#: doc/classes/AudioEffectRecord.xml doc/classes/AudioServer.xml +#: doc/classes/AudioStream.xml doc/classes/AudioStreamMicrophone.xml #: doc/classes/AudioStreamPlayer.xml msgid "Audio Mic Record Demo" msgstr "" @@ -8770,8 +8823,20 @@ msgid "" "attached audio effect bus into its internal ring buffer.\n" "Application code should consume these audio frames from this ring buffer " "using [method get_buffer] and process it as needed, for example to capture " -"data from a microphone, implement application defined effects, or to " -"transmit audio over the network." +"data from an [AudioStreamMicrophone], implement application-defined effects, " +"or to transmit audio over the network. When capturing audio data from a " +"microphone, the format of the samples will be stereo 32-bit floating point " +"PCM.\n" +"[b]Note:[/b] [member ProjectSettings.audio/enable_audio_input] must be " +"[code]true[/code] for audio input to work. See also that setting's " +"description for caveats related to permissions and operating system privacy " +"settings." +msgstr "" + +#: doc/classes/AudioEffectCapture.xml doc/classes/AudioEffectDistortion.xml +#: doc/classes/AudioEffectFilter.xml doc/classes/AudioEffectHighShelfFilter.xml +#: doc/classes/AudioEffectLowShelfFilter.xml doc/classes/AudioServer.xml +msgid "Audio buses" msgstr "" #: doc/classes/AudioEffectCapture.xml @@ -9013,12 +9078,6 @@ msgid "" "coming from some saturated device or speaker very efficiently." msgstr "" -#: doc/classes/AudioEffectDistortion.xml doc/classes/AudioEffectFilter.xml -#: doc/classes/AudioEffectHighShelfFilter.xml -#: doc/classes/AudioEffectLowShelfFilter.xml doc/classes/AudioServer.xml -msgid "Audio buses" -msgstr "" - #: doc/classes/AudioEffectDistortion.xml msgid "Distortion power. Value can range from 0 to 1." msgstr "" @@ -9564,7 +9623,12 @@ msgid "" msgstr "" #: doc/classes/AudioServer.xml -msgid "Returns the names of all audio input devices detected on the system." +msgid "" +"Returns the names of all audio input devices detected on the system.\n" +"[b]Note:[/b] [member ProjectSettings.audio/enable_audio_input] must be " +"[code]true[/code] for audio input to work. See also that setting's " +"description for caveats related to permissions and operating system privacy " +"settings." msgstr "" #: doc/classes/AudioServer.xml @@ -9725,12 +9789,16 @@ msgstr "" #: doc/classes/AudioServer.xml msgid "" -"Name of the current device for audio input (see [method get_device_list]). " -"On systems with multiple audio inputs (such as analog, USB and HDMI audio), " -"this can be used to select the audio input device. The value " -"[code]\"Default\"[/code] will record audio on the system-wide default audio " -"input. If an invalid device name is set, the value will be reverted back to " -"[code]\"Default\"[/code]." +"Name of the current device for audio input (see [method " +"capture_get_device_list]). On systems with multiple audio inputs (such as " +"analog, USB and HDMI audio), this can be used to select the audio input " +"device. The value [code]\"Default\"[/code] will record audio on the system-" +"wide default audio input. If an invalid device name is set, the value will " +"be reverted back to [code]\"Default\"[/code].\n" +"[b]Note:[/b] [member ProjectSettings.audio/enable_audio_input] must be " +"[code]true[/code] for audio input to work. See also that setting's " +"description for caveats related to permissions and operating system privacy " +"settings." msgstr "" #: doc/classes/AudioServer.xml @@ -9878,6 +9946,21 @@ msgid "" "GDNative, but [method push_frame] may be [i]more[/i] efficient in GDScript." msgstr "" +#: doc/classes/AudioStreamMicrophone.xml +msgid "Plays real-time audio input data." +msgstr "" + +#: doc/classes/AudioStreamMicrophone.xml +msgid "" +"When used directly in an [AudioStreamPlayer] node, [AudioStreamMicrophone] " +"plays back microphone input in real-time. This can be used in conjunction " +"with [AudioEffectCapture] to process the data or save it.\n" +"[b]Note:[/b] [member ProjectSettings.audio/enable_audio_input] must be " +"[code]true[/code] for audio input to work. See also that setting's " +"description for caveats related to permissions and operating system privacy " +"settings." +msgstr "" + #: modules/minimp3/doc_classes/AudioStreamMP3.xml msgid "MP3 audio stream driver." msgstr "" @@ -9953,7 +10036,13 @@ msgid "If [code]true[/code], audio plays when added to scene tree." msgstr "" #: doc/classes/AudioStreamPlayer.xml doc/classes/AudioStreamPlayer2D.xml -msgid "Bus on which this audio is playing." +msgid "" +"Bus on which this audio is playing.\n" +"[b]Note:[/b] When setting this property, keep in mind that no validation is " +"performed to see if the given name matches an existing bus. This is because " +"audio bus layouts might be loaded after this property is set. If this given " +"name can't be resolved at runtime, it will fall back to [code]\"Master\"[/" +"code]." msgstr "" #: doc/classes/AudioStreamPlayer.xml @@ -10012,7 +10101,10 @@ msgstr "" #: doc/classes/AudioStreamPlayer2D.xml msgid "" -"Plays audio that dampens with distance from screen center.\n" +"Plays audio that dampens with distance from a given position.\n" +"By default, audio is heard from the screen center. This can be changed by " +"adding a [Listener2D] node to the scene and enabling it by calling [method " +"Listener2D.make_current] on it.\n" "See also [AudioStreamPlayer] to play a sound non-positionally.\n" "[b]Note:[/b] Hiding an [AudioStreamPlayer2D] node does not disable its audio " "output. To temporarily disable an [AudioStreamPlayer2D]'s audio output, set " @@ -10118,7 +10210,13 @@ msgid "" msgstr "" #: doc/classes/AudioStreamPlayer3D.xml -msgid "The bus on which this audio is playing." +msgid "" +"The bus on which this audio is playing.\n" +"[b]Note:[/b] When setting this property, keep in mind that no validation is " +"performed to see if the given name matches an existing bus. This is because " +"audio bus layouts might be loaded after this property is set. If this given " +"name can't be resolved at runtime, it will fall back to [code]\"Master\"[/" +"code]." msgstr "" #: doc/classes/AudioStreamPlayer3D.xml @@ -11684,7 +11782,7 @@ msgid "" "Sets the camera projection to frustum mode (see [constant " "PROJECTION_FRUSTUM]), by specifying a [code]size[/code], an [code]offset[/" "code], and the [code]z_near[/code] and [code]z_far[/code] clip planes in " -"world space units." +"world space units. See also [member frustum_offset]." msgstr "" #: doc/classes/Camera.xml @@ -11729,7 +11827,12 @@ msgstr "" #: doc/classes/Camera.xml msgid "" -"If [code]true[/code], the ancestor [Viewport] is currently using this camera." +"If [code]true[/code], the ancestor [Viewport] is currently using this " +"camera.\n" +"If multiple cameras are in the scene, one will always be made current. For " +"example, if two [Camera] nodes are present in the scene and only one is " +"current, setting one camera's [member current] to [code]false[/code] will " +"cause the other camera to be made current." msgstr "" #: doc/classes/Camera.xml @@ -11772,7 +11875,9 @@ msgstr "" msgid "" "The camera's frustum offset. This can be changed from the default to create " "\"tilted frustum\" effects such as [url=https://zdoom.org/wiki/Y-shearing]Y-" -"shearing[/url]." +"shearing[/url].\n" +"[b]Note:[/b] Only effective if [member projection] is [constant " +"PROJECTION_FRUSTUM]." msgstr "" #: doc/classes/Camera.xml @@ -11800,9 +11905,9 @@ msgstr "" #: doc/classes/Camera.xml msgid "" -"The camera's size measured as 1/2 the width or height. Only applicable in " -"orthogonal and frustum modes. Since [member keep_aspect] locks on axis, " -"[code]size[/code] sets the other axis' size length." +"The camera's size in meters measured as the diameter of the width or height, " +"depending on [member keep_aspect]. Only applicable in orthogonal and frustum " +"modes." msgstr "" #: doc/classes/Camera.xml @@ -12127,10 +12232,12 @@ msgid "" msgstr "" #: doc/classes/Camera2D.xml doc/classes/ClippedCamera.xml +#: doc/classes/InterpolatedCamera.xml msgid "The camera updates with the [code]_physics_process[/code] callback." msgstr "" #: doc/classes/Camera2D.xml doc/classes/ClippedCamera.xml +#: doc/classes/InterpolatedCamera.xml msgid "The camera updates with the [code]_process[/code] callback." msgstr "" @@ -12297,13 +12404,14 @@ msgid "" "inherit and extend their parent's transform. [CanvasItem] is extended by " "[Control] for anything GUI-related, and by [Node2D] for anything related to " "the 2D engine.\n" -"Any [CanvasItem] can draw. For this, [method update] must be called, then " -"[constant NOTIFICATION_DRAW] will be received on idle time to request " -"redraw. Because of this, canvas items don't need to be redrawn on every " -"frame, improving the performance significantly. Several functions for " +"Any [CanvasItem] can draw. For this, [method update] is called by the " +"engine, then [constant NOTIFICATION_DRAW] will be received on idle time to " +"request redraw. Because of this, canvas items don't need to be redrawn on " +"every frame, improving the performance significantly. Several functions for " "drawing on the [CanvasItem] are provided (see [code]draw_*[/code] " -"functions). However, they can only be used inside the [method Object." -"_notification], signal or [method _draw] virtual functions.\n" +"functions). However, they can only be used inside [method _draw], its " +"corresponding [method Object._notification] or methods connected to the " +"[signal draw] signal.\n" "Canvas items are drawn in tree order. By default, children are on top of " "their parents so a root [CanvasItem] will be drawn behind everything. This " "behavior can be changed on a per-item basis.\n" @@ -12329,8 +12437,10 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" -"Overridable function called by the engine (if defined) to draw the canvas " -"item." +"Called when [CanvasItem] has been requested to redraw (when [method update] " +"is called, either manually or by the engine).\n" +"Corresponds to the [constant NOTIFICATION_DRAW] notification in [method " +"Object._notification]." msgstr "" #: doc/classes/CanvasItem.xml @@ -12643,12 +12753,12 @@ msgid "" "to children." msgstr "" -#: doc/classes/CanvasItem.xml doc/classes/Spatial.xml +#: doc/classes/CanvasItem.xml msgid "" "Returns [code]true[/code] if the node is present in the [SceneTree], its " "[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." +"the scene tree, and is consequently not drawn (see [method _draw])." msgstr "" #: doc/classes/CanvasItem.xml @@ -12693,8 +12803,10 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" -"Queue the [CanvasItem] for update. [constant NOTIFICATION_DRAW] will be " -"called on idle time to request redraw." +"Queues the [CanvasItem] to redraw. During idle time, if [CanvasItem] is " +"visible, [constant NOTIFICATION_DRAW] is sent and [method _draw] is called. " +"This only occurs [b]once[/b] per frame, even if this method has been called " +"multiple times." msgstr "" #: doc/classes/CanvasItem.xml @@ -12742,8 +12854,11 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" -"Emitted when the [CanvasItem] must redraw. This can only be connected " -"realtime, as deferred will not allow drawing." +"Emitted when the [CanvasItem] must redraw, [i]after[/i] the related " +"[constant NOTIFICATION_DRAW] notification, and [i]before[/i] [method _draw] " +"is called.\n" +"[b]Note:[/b] Deferred connections do not allow drawing through the " +"[code]draw_*[/code] methods." msgstr "" #: doc/classes/CanvasItem.xml @@ -12805,7 +12920,7 @@ msgid "" msgstr "" #: doc/classes/CanvasItem.xml -msgid "The [CanvasItem] is requested to draw." +msgid "The [CanvasItem] is requested to draw (see [method _draw])." msgstr "" #: doc/classes/CanvasItem.xml @@ -12930,7 +13045,10 @@ msgstr "" #: doc/classes/CanvasLayer.xml msgid "" -"Sets the layer to follow the viewport in order to simulate a pseudo 3D " +"If enabled, the [CanvasLayer] will use the viewport's transform, so it will " +"move when camera moves instead of being anchored in a fixed position on the " +"screen.\n" +"Together with [member follow_viewport_scale] it can be used for a pseudo 3D " "effect." msgstr "" @@ -13614,7 +13732,7 @@ msgid "" msgstr "" #: doc/classes/CollisionObject.xml doc/classes/CollisionObject2D.xml -#: doc/classes/Navigation.xml doc/classes/Navigation2D.xml +#: doc/classes/Navigation2D.xml msgid "Returns the object's [RID]." msgstr "" @@ -13635,17 +13753,17 @@ msgstr "" #: doc/classes/CollisionObject.xml doc/classes/CollisionObject2D.xml msgid "" "If [code]value[/code] is [code]true[/code], sets the specified [code]bit[/" -"code] in the the [member collision_layer].\n" +"code] in the [member collision_layer].\n" "If [code]value[/code] is [code]false[/code], clears the specified [code]bit[/" -"code] in the the [member collision_layer]." +"code] in the [member collision_layer]." msgstr "" #: doc/classes/CollisionObject.xml doc/classes/CollisionObject2D.xml msgid "" "If [code]value[/code] is [code]true[/code], sets the specified [code]bit[/" -"code] in the the [member collision_mask].\n" +"code] in the [member collision_mask].\n" "If [code]value[/code] is [code]false[/code], clears the specified [code]bit[/" -"code] in the the [member collision_mask]." +"code] in the [member collision_mask]." msgstr "" #: doc/classes/CollisionObject.xml doc/classes/CollisionObject2D.xml @@ -13952,12 +14070,13 @@ msgstr "" #: doc/classes/CollisionShape.xml msgid "" -"Editor facility for creating and editing collision shapes in 3D space. You " -"can use this node to represent all sorts of collision shapes, for example, " -"add this to an [Area] to give it a detection shape, or add it to a " -"[PhysicsBody] to create a solid object. [b]IMPORTANT[/b]: this is an Editor-" -"only helper to create shapes, use [method CollisionObject." -"shape_owner_get_shape] to get the actual shape." +"Editor facility for creating and editing collision shapes in 3D space. Set " +"the [member shape] property to configure the shape. [b]IMPORTANT[/b]: this " +"is an Editor-only helper to create shapes, use [method CollisionObject." +"shape_owner_get_shape] to get the actual shape.\n" +"You can use this node to represent all sorts of collision shapes, for " +"example, add this to an [Area] to give it a detection shape, or add it to a " +"[PhysicsBody] to create a solid object." msgstr "" #: doc/classes/CollisionShape.xml doc/classes/CollisionShape2D.xml @@ -13994,12 +14113,13 @@ msgstr "" #: doc/classes/CollisionShape2D.xml msgid "" -"Editor facility for creating and editing collision shapes in 2D space. You " -"can use this node to represent all sorts of collision shapes, for example, " -"add this to an [Area2D] to give it a detection shape, or add it to a " -"[PhysicsBody2D] to create a solid object. [b]IMPORTANT[/b]: this is an " -"Editor-only helper to create shapes, use [method CollisionObject2D." -"shape_owner_get_shape] to get the actual shape." +"Editor facility for creating and editing collision shapes in 2D space. Set " +"the [member shape] property to configure the shape. [b]IMPORTANT[/b]: this " +"is an Editor-only helper to create shapes, use [method CollisionObject2D." +"shape_owner_get_shape] to get the actual shape.\n" +"You can use this node to represent all sorts of collision shapes, for " +"example, add this to an [Area2D] to give it a detection shape, or add it to " +"a [PhysicsBody2D] to create a solid object." msgstr "" #: doc/classes/CollisionShape2D.xml doc/classes/KinematicBody2D.xml @@ -15159,7 +15279,15 @@ msgid "" "area. This shape is created by feeding a list of triangles.\n" "[b]Note:[/b] When used for collision, [ConcavePolygonShape] is intended to " "work with static [PhysicsBody] nodes like [StaticBody] and will not work " -"with [KinematicBody] or [RigidBody] with a mode other than Static." +"with [KinematicBody] or [RigidBody] with a mode other than Static.\n" +"[b]Warning:[/b] Using this shape for an [Area] (via a [CollisionShape] node, " +"created e.g. by using the [i]Create Trimesh Collision Sibling[/i] option in " +"the [i]Mesh[/i] menu that appears when selecting a [MeshInstance] node) may " +"give unexpected results: when using Godot Physics, the area will only detect " +"collisions with the triangle faces in the [ConcavePolygonShape] (and not " +"with any \"inside\" of the shape, for example), and when using Bullet " +"Physics the area will not detect any collisions with the concave shape at " +"all (this is a known bug)." msgstr "" #: doc/classes/ConcavePolygonShape.xml @@ -15185,7 +15313,11 @@ msgid "" "The main difference between a [ConvexPolygonShape2D] and a " "[ConcavePolygonShape2D] is that a concave polygon assumes it is concave and " "uses a more complex method of collision detection, and a convex one forces " -"itself to be convex in order to speed up collision detection." +"itself to be convex in order to speed up collision detection.\n" +"[b]Warning:[/b] Using this shape for an [Area2D] (via a [CollisionShape2D] " +"node) may give unexpected results: the area will only detect collisions with " +"the segments in the [ConcavePolygonShape2D] (and not with any \"inside\" of " +"the shape, for example)." msgstr "" #: doc/classes/ConcavePolygonShape2D.xml @@ -15926,7 +16058,9 @@ msgstr "" #: doc/classes/Control.xml msgid "" "Steal the focus from another control and become the focused control (see " -"[member focus_mode])." +"[member focus_mode]).\n" +"[b]Note[/b]: Using this method together with [method Object.call_deferred] " +"makes it more reliable, especially when called inside [method Node._ready]." msgstr "" #: doc/classes/Control.xml @@ -18651,7 +18785,9 @@ msgstr "" msgid "" "A curve that can be saved and re-used for other objects. By default, it " "ranges between [code]0[/code] and [code]1[/code] on the Y axis and positions " -"points relative to the [code]0.5[/code] Y position." +"points relative to the [code]0.5[/code] Y position.\n" +"See also [Gradient] which is designed for color interpolation. See also " +"[Curve2D] and [Curve3D]." msgstr "" #: doc/classes/Curve.xml @@ -18800,16 +18936,17 @@ msgid "" "further calculations." msgstr "" -#: doc/classes/Curve2D.xml +#: doc/classes/Curve2D.xml doc/classes/Curve3D.xml msgid "" -"Adds a point to a curve at [code]position[/code] relative to the [Curve2D]'s " -"position, with control points [code]in[/code] and [code]out[/code].\n" -"If [code]at_position[/code] is given, the point is inserted before the point " -"number [code]at_position[/code], moving that point (and every point after) " -"after the inserted point. If [code]at_position[/code] is not given, or is an " -"illegal value ([code]at_position <0[/code] or [code]at_position >= [method " -"get_point_count][/code]), the point will be appended at the end of the point " -"list." +"Adds a point with the specified [code]position[/code] relative to the " +"curve's own position, with control points [code]in[/code] and [code]out[/" +"code]. Appends the new point at the end of the point list.\n" +"If [code]index[/code] is given, the new point is inserted before the " +"existing point identified by index [code]index[/code]. Every existing point " +"starting from [code]index[/code] is shifted further down the list of points. " +"The index must be greater than or equal to [code]0[/code] and must not " +"exceed the number of existing points in the line. See [method " +"get_point_count]." msgstr "" #: doc/classes/Curve2D.xml doc/classes/Curve3D.xml @@ -18954,18 +19091,6 @@ msgid "" msgstr "" #: doc/classes/Curve3D.xml -msgid "" -"Adds a point to a curve at [code]position[/code] relative to the [Curve3D]'s " -"position, with control points [code]in[/code] and [code]out[/code].\n" -"If [code]at_position[/code] is given, the point is inserted before the point " -"number [code]at_position[/code], moving that point (and every point after) " -"after the inserted point. If [code]at_position[/code] is not given, or is an " -"illegal value ([code]at_position <0[/code] or [code]at_position >= [method " -"get_point_count][/code]), the point will be appended at the end of the point " -"list." -msgstr "" - -#: doc/classes/Curve3D.xml msgid "Returns the cache of points as a [PoolVector3Array]." msgstr "" @@ -19089,11 +19214,14 @@ msgid "" msgstr "" #: doc/classes/CurveTexture.xml -msgid "The [code]curve[/code] rendered onto the texture." +msgid "The [Curve] that is rendered onto the texture." msgstr "" #: doc/classes/CurveTexture.xml -msgid "The width of the texture." +msgid "" +"The width of the texture (in pixels). Higher values make it possible to " +"represent high-frequency data better (such as sudden direction changes), at " +"the cost of increased generation time and memory usage." msgstr "" #: doc/classes/CylinderMesh.xml @@ -19379,6 +19507,13 @@ msgid "Returns the list of keys in the [Dictionary]." msgstr "" #: doc/classes/Dictionary.xml +msgid "" +"Adds elements from [code]dictionary[/code] to this [Dictionary]. By default, " +"duplicate keys will not be copied over, unless [code]overwrite[/code] is " +"[code]true[/code]." +msgstr "" + +#: doc/classes/Dictionary.xml msgid "Returns the number of keys in the dictionary." msgstr "" @@ -19402,13 +19537,17 @@ msgstr "" #: doc/classes/DirectionalLight.xml msgid "" "Amount of extra bias for shadow splits that are far away. If self-shadowing " -"occurs only on the splits far away, increasing this value can fix them." +"occurs only on the splits far away, increasing this value can fix them. This " +"is ignored when [member directional_shadow_mode] is [constant " +"SHADOW_ORTHOGONAL]." msgstr "" #: doc/classes/DirectionalLight.xml msgid "" "If [code]true[/code], shadow detail is sacrificed in exchange for smoother " -"transitions between splits." +"transitions between splits. Enabling shadow blend splitting also has a " +"moderate performance cost. This is ignored when [member " +"directional_shadow_mode] is [constant SHADOW_ORTHOGONAL]." msgstr "" #: doc/classes/DirectionalLight.xml @@ -19418,7 +19557,11 @@ msgid "" msgstr "" #: doc/classes/DirectionalLight.xml -msgid "The maximum distance for shadow splits." +msgid "" +"The maximum distance for shadow splits. Increasing this value will make " +"directional shadows visible from further away, at the cost of lower overall " +"shadow detail and performance (since more objects need to be included in the " +"directional shadow rendering)." msgstr "" #: doc/classes/DirectionalLight.xml @@ -19435,23 +19578,23 @@ msgstr "" msgid "" "The distance from camera to shadow split 1. Relative to [member " "directional_shadow_max_distance]. Only used when [member " -"directional_shadow_mode] is [code]SHADOW_PARALLEL_2_SPLITS[/code] or " -"[code]SHADOW_PARALLEL_4_SPLITS[/code]." +"directional_shadow_mode] is [constant SHADOW_PARALLEL_2_SPLITS] or [constant " +"SHADOW_PARALLEL_4_SPLITS]." msgstr "" #: doc/classes/DirectionalLight.xml msgid "" "The distance from shadow split 1 to split 2. Relative to [member " "directional_shadow_max_distance]. Only used when [member " -"directional_shadow_mode] is [code]SHADOW_PARALLEL_2_SPLITS[/code] or " -"[code]SHADOW_PARALLEL_4_SPLITS[/code]." +"directional_shadow_mode] is [constant SHADOW_PARALLEL_2_SPLITS] or [constant " +"SHADOW_PARALLEL_4_SPLITS]." msgstr "" #: doc/classes/DirectionalLight.xml msgid "" "The distance from shadow split 2 to split 3. Relative to [member " "directional_shadow_max_distance]. Only used when [member " -"directional_shadow_mode] is [code]SHADOW_PARALLEL_4_SPLITS[/code]." +"directional_shadow_mode] is [constant SHADOW_PARALLEL_4_SPLITS]." msgstr "" #: doc/classes/DirectionalLight.xml @@ -20120,7 +20263,7 @@ msgstr "" msgid "" "Saves the editor feature profile to a file in JSON format. It can then be " "imported using the feature profile manager's [b]Import[/b] button or the " -"[method load_from_file] button." +"[method load_from_file] method." msgstr "" #: doc/classes/EditorFeatureProfile.xml @@ -21317,9 +21460,23 @@ msgstr "" #: doc/classes/EditorPlugin.xml 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)." +"Override this method to provide a state data you want to be saved, like view " +"position, grid settings, folding, etc. 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). This data is automatically saved for " +"each scene in an [code]editstate[/code] file in the editor metadata folder. " +"If you want to store global (scene-independent) editor data for your plugin, " +"you can use [method get_window_layout] instead.\n" +"Use [method set_state] to restore your saved state.\n" +"[b]Note:[/b] This method should not be used to save important settings that " +"should persist with the project.\n" +"[b]Note:[/b] You must implement [method get_plugin_name] for the state to be " +"stored and restored correctly.\n" +"[codeblock]\n" +"func get_state():\n" +" var state = {\"zoom\": zoom, \"preferred_color\": my_color}\n" +" return state\n" +"[/codeblock]" msgstr "" #: doc/classes/EditorPlugin.xml @@ -21330,9 +21487,18 @@ msgstr "" #: doc/classes/EditorPlugin.xml 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)." +"Override this method to provide the GUI layout of the plugin or any other " +"data you want to be stored. 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). The data is stored in the " +"[code]editor_layout.cfg[/code] file in the editor metadata directory.\n" +"Use [method set_window_layout] to restore your saved layout.\n" +"[codeblock]\n" +"func get_window_layout(configuration):\n" +" configuration.set_value(\"MyPlugin\", \"window_position\", $Window." +"position)\n" +" configuration.set_value(\"MyPlugin\", \"icon_color\", $Icon.modulate)\n" +"[/codeblock]" msgstr "" #: doc/classes/EditorPlugin.xml @@ -21445,11 +21611,30 @@ msgid "" msgstr "" #: doc/classes/EditorPlugin.xml -msgid "Restore the state saved by [method get_state]." +msgid "" +"Restore the state saved by [method get_state]. This method is called when " +"the current scene tab is changed in the editor.\n" +"[b]Note:[/b] Your plugin must implement [method get_plugin_name], otherwise " +"it will not be recognized and this method will not be called.\n" +"[codeblock]\n" +"func set_state(data):\n" +" zoom = data.get(\"zoom\", 1.0)\n" +" preferred_color = data.get(\"my_color\", Color.white)\n" +"[/codeblock]" msgstr "" #: doc/classes/EditorPlugin.xml -msgid "Restore the plugin GUI layout saved by [method get_window_layout]." +msgid "" +"Restore the plugin GUI layout and data saved by [method get_window_layout]. " +"This method is called for every plugin on editor startup. Use the provided " +"[code]configuration[/code] file to read your saved data.\n" +"[codeblock]\n" +"func set_window_layout(configuration):\n" +" $Window.position = configuration.get_value(\"MyPlugin\", " +"\"window_position\", Vector2())\n" +" $Icon.modulate = configuration.get_value(\"MyPlugin\", \"icon_color\", " +"Color.white)\n" +"[/codeblock]" msgstr "" #: doc/classes/EditorPlugin.xml @@ -23467,7 +23652,7 @@ msgstr "" #: doc/classes/Environment.xml 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 " +"HDR values to be suitable for rendering on a SDR display. (Godot doesn't " "support rendering on HDR displays yet.)" msgstr "" @@ -23812,8 +23997,12 @@ msgstr "" #: doc/classes/File.xml msgid "" -"Returns the whole file as a [String].\n" -"Text is interpreted as being UTF-8 encoded." +"Returns the whole file as a [String]. Text is interpreted as being UTF-8 " +"encoded.\n" +"If [code]skip_cr[/code] is [code]true[/code], carriage return characters " +"([code]\\r[/code], CR) will be ignored when parsing the UTF-8, so that only " +"line feed characters ([code]\\n[/code], LF) represent a new line (Unix " +"convention)." msgstr "" #: doc/classes/File.xml @@ -24433,7 +24622,9 @@ msgid "" "[code]next[/code] is passed. 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. The width used by the character is returned, " -"making this function useful for drawing strings character by character." +"making this function useful for drawing strings character by character.\n" +"If [code]outline[/code] is [code]true[/code], the outline of the character " +"is drawn instead of the character itself." msgstr "" #: doc/classes/Font.xml @@ -25298,7 +25489,7 @@ msgstr "" #: doc/classes/Geometry.xml msgid "" "Given an array of [Vector2]s representing tiles, builds an atlas. The " -"returned dictionary has two keys: [code]points[/code] is a vector of " +"returned dictionary has two keys: [code]points[/code] is an array of " "[Vector2] that specifies the positions of each tile, [code]size[/code] " "contains the overall size of the whole atlas as [Vector2]." msgstr "" @@ -26017,10 +26208,13 @@ msgstr "" #: doc/classes/Gradient.xml msgid "" "Given a set of colors, this resource will interpolate them in order. This " -"means that if you have color 1, color 2 and color 3, the ramp will " -"interpolate from color 1 to color 2 and from color 2 to color 3. The ramp " -"will initially have 2 colors (black and white), one (black) at ramp lower " -"offset 0 and the other (white) at the ramp higher offset 1." +"means that if you have color 1, color 2 and color 3, the gradient will " +"interpolate from color 1 to color 2 and from color 2 to color 3. The " +"gradient will initially have 2 colors (black and white), one (black) at " +"gradient lower offset 0 and the other (white) at the gradient higher offset " +"1.\n" +"See also [Curve] which supports more complex easing methods, but does not " +"support colors." msgstr "" #: doc/classes/Gradient.xml @@ -26087,7 +26281,8 @@ msgid "" "will be filled from left to right using colors obtained from the gradient. " "This means the texture does not necessarily represent an exact copy of the " "gradient, but instead an interpolation of samples obtained from the gradient " -"at fixed steps (see [member width])." +"at fixed steps (see [member width]). See also [GradientTexture2D] and " +"[CurveTexture]." msgstr "" #: doc/classes/GradientTexture.xml @@ -26109,7 +26304,8 @@ msgid "" "repeat] types using colors obtained from the gradient. The texture does not " "necessarily represent an exact copy of the gradient, but instead an " "interpolation of samples obtained from the gradient at fixed steps (see " -"[member width] and [member height])." +"[member width] and [member height]). See also [GradientTexture] and " +"[CurveTexture]." msgstr "" #: doc/classes/GradientTexture2D.xml @@ -26915,6 +27111,12 @@ msgid "" msgstr "" #: modules/gridmap/doc_classes/GridMap.xml +msgid "" +"If [code]true[/code], this GridMap uses cell navmesh resources to create " +"navigation regions." +msgstr "" + +#: modules/gridmap/doc_classes/GridMap.xml msgid "If [code]true[/code], grid items are centered on the X axis." msgstr "" @@ -26965,6 +27167,10 @@ msgid "The assigned [MeshLibrary]." msgstr "" #: modules/gridmap/doc_classes/GridMap.xml +msgid "The navigation layers the GridMap generates its navigation regions in." +msgstr "" + +#: modules/gridmap/doc_classes/GridMap.xml msgid "" "Overrides the default friction and bounce physics properties for the whole " "[GridMap]." @@ -27415,8 +27621,8 @@ msgstr "" msgid "" "Hyper-text transfer protocol client (sometimes called \"User Agent\"). Used " "to make HTTP requests to download web content, upload files and other data " -"or to communicate with various services, among other use cases. [b]See the " -"[HTTPRequest] node for a higher-level alternative.[/b]\n" +"or to communicate with various services, among other use cases.\n" +"See the [HTTPRequest] node for a higher-level alternative.\n" "[b]Note:[/b] This client only needs to connect to a host once (see [method " "connect_to_host]) to send multiple requests. Because of this, methods that " "take URLs usually take just the part after the host instead of the full URL, " @@ -28188,7 +28394,7 @@ msgid "" " # 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 body = to_json({\"name\": \"Godette\"})\n" " error = http_request.request(\"https://httpbin.org/post\", [], true, " "HTTPClient.METHOD_POST, body)\n" " if error != OK:\n" @@ -28327,13 +28533,14 @@ msgstr "" #: doc/classes/HTTPRequest.xml msgid "" -"If set to a value greater than [code]0.0[/code], the HTTP request will time " -"out after [code]timeout[/code] seconds have passed and the request is not " -"[i]completed[/i] yet. For small HTTP requests such as REST API usage, set " -"[member timeout] to a value greater than [code]0.0[/code] to prevent the " -"application from getting stuck if the request fails to get a response in a " -"timely manner. For file downloads, leave this to [code]0.0[/code] to prevent " -"the download from failing if it takes too much time." +"If set to a value greater than [code]0.0[/code] before the request starts, " +"the HTTP request will time out after [code]timeout[/code] seconds have " +"passed and the request is not [i]completed[/i] yet. For small HTTP requests " +"such as REST API usage, set [member timeout] to a value between [code]10.0[/" +"code] and [code]30.0[/code] to prevent the application from getting stuck if " +"the request fails to get a response in a timely manner. For file downloads, " +"leave this to [code]0.0[/code] to prevent the download from failing if it " +"takes too much time." msgstr "" #: doc/classes/HTTPRequest.xml @@ -29355,7 +29562,7 @@ msgstr "" msgid "" "Sends all input events which are in the current buffer to the game loop. " "These events may have been buffered as a result of accumulated input " -"([method set_use_accumulated_input]) or agile input flushing ([member " +"([member use_accumulated_input]) or agile input flushing ([member " "ProjectSettings.input_devices/buffering/agile_event_flushing]).\n" "The engine will already do this itself at key execution points (at least " "once per frame). However, this can be useful in advanced cases where you " @@ -29504,10 +29711,6 @@ msgid "" msgstr "" #: doc/classes/Input.xml -msgid "Returns the mouse mode. See the constants for more information." -msgstr "" - -#: doc/classes/Input.xml msgid "" "Gets an input vector by specifying four actions for the positive and " "negative X and Y axes.\n" @@ -29701,24 +29904,6 @@ msgid "" msgstr "" #: doc/classes/Input.xml -msgid "Sets the mouse mode. See the constants for more information." -msgstr "" - -#: doc/classes/Input.xml -msgid "" -"Enables or disables the accumulation of similar input events sent by the " -"operating system. When input accumulation is enabled, all input events " -"generated during a frame will be merged and emitted when the frame is done " -"rendering. Therefore, this limits the number of input method calls per " -"second to the rendering FPS.\n" -"Input accumulation is enabled by default. It can be disabled to get slightly " -"more precise/reactive input at the cost of increased CPU usage. In " -"applications where drawing freehand lines is required, input accumulation " -"should generally be disabled while the user is drawing the line to get " -"results that closely follow the actual input." -msgstr "" - -#: doc/classes/Input.xml msgid "" "Starts to vibrate the joypad. Joypads usually come with two rumble motors, a " "strong and a weak one. [code]weak_magnitude[/code] is the strength of the " @@ -29737,11 +29922,14 @@ msgstr "" #: doc/classes/Input.xml msgid "" -"Vibrate Android and iOS devices.\n" +"Vibrate handheld devices.\n" +"[b]Note:[/b] This method is implemented on Android, iOS, and HTML5.\n" "[b]Note:[/b] For Android, it requires enabling the [code]VIBRATE[/code] " "permission in the export preset.\n" "[b]Note:[/b] For iOS, specifying the duration is supported in iOS 13 and " -"later." +"later.\n" +"[b]Note:[/b] Some web browsers such as Safari and Firefox for Android do not " +"support this method." msgstr "" #: doc/classes/Input.xml @@ -29754,6 +29942,27 @@ msgid "" msgstr "" #: doc/classes/Input.xml +msgid "Controls the mouse mode. See [enum MouseMode] for more information." +msgstr "" + +#: doc/classes/Input.xml +msgid "" +"If [code]true[/code], similar input events sent by the operating system are " +"accumulated. When input accumulation is enabled, all input events generated " +"during a frame will be merged and emitted when the frame is done rendering. " +"Therefore, this limits the number of input method calls per second to the " +"rendering FPS.\n" +"Input accumulation can be disabled to get slightly more precise/reactive " +"input at the cost of increased CPU usage. In applications where drawing " +"freehand lines is required, input accumulation should generally be disabled " +"while the user is drawing the line to get results that closely follow the " +"actual input.\n" +"[b]Note:[/b] Input accumulation is [i]enabled[/i] by default. It is " +"recommended to keep it enabled for games which don't require very reactive " +"input, as this will decrease CPU usage." +msgstr "" + +#: doc/classes/Input.xml msgid "Emitted when a joypad device has been connected or disconnected." msgstr "" @@ -30061,8 +30270,8 @@ msgstr "" #: doc/classes/InputEventJoypadButton.xml msgid "" -"Represents the pressure the user puts on the button with his finger, if the " -"controller supports it. Ranges from [code]0[/code] to [code]1[/code]." +"Represents the pressure the user puts on the button with their finger, if " +"the controller supports it. Ranges from [code]0[/code] to [code]1[/code]." msgstr "" #: doc/classes/InputEventJoypadMotion.xml @@ -30324,10 +30533,14 @@ msgstr "" msgid "" "Contains mouse and pen motion information. Supports relative, absolute " "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 " +"[b]Note:[/b] The behavior of this event is affected by the value of [member " +"Input.use_accumulated_input]. When set to [code]true[/code] (default), mouse/" +"pen motion events received from the OS will be merged to emit an accumulated " +"event only once per frame rendered at most. When set to [code]false[/code], " +"the events will be emitted as received, which means that they can be emitted " +"multiple times per frame rendered, allowing for precise input reporting at " +"the expense of CPU usage.\n" +"[b]Note:[/b] 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." @@ -30339,6 +30552,12 @@ msgstr "" #: doc/classes/InputEventMouseMotion.xml msgid "" +"Returns [code]true[/code] when using the eraser end of a stylus pen.\n" +"[b]Note:[/b] This property is implemented on Linux, macOS and Windows." +msgstr "" + +#: doc/classes/InputEventMouseMotion.xml +msgid "" "Represents the pressure the user puts on the pen. Ranges from [code]0.0[/" "code] to [code]1.0[/code]." msgstr "" @@ -30555,7 +30774,11 @@ msgstr "" #: doc/classes/InstancePlaceholder.xml msgid "" -"Not thread-safe. Use [method Object.call_deferred] if calling from a thread." +"Call this method to actually load in the node. The created node will be " +"placed as a sibling [i]above[/i] the [InstancePlaceholder] in the scene " +"tree. The [Node]'s reference is also returned for convenience.\n" +"[b]Note:[/b] [method create_instance] is not thread-safe. Use [method Object." +"call_deferred] if calling from a thread." msgstr "" #: doc/classes/InstancePlaceholder.xml @@ -30567,6 +30790,16 @@ msgstr "" #: doc/classes/InstancePlaceholder.xml msgid "" +"Returns the list of properties that will be applied to the node when [method " +"create_instance] is called.\n" +"If [code]with_order[/code] is [code]true[/code], a key named [code].order[/" +"code] (note the leading period) is added to the dictionary. This [code]." +"order[/code] key is an [Array] of [String] property names specifying the " +"order in which properties will be applied (with index 0 being the first)." +msgstr "" + +#: doc/classes/InstancePlaceholder.xml +msgid "" "Replaces this placeholder by the scene handed as an argument, or the " "original scene if no argument is given. As for all resources, the scene is " "loaded only if it's not loaded already. By manually loading the scene " @@ -30650,6 +30883,11 @@ msgstr "" #: doc/classes/InterpolatedCamera.xml msgid "" +"The camera's process callback. See [enum InterpolatedCameraProcessMode]." +msgstr "" + +#: doc/classes/InterpolatedCamera.xml +msgid "" "How quickly the camera moves toward its target. Higher values will result in " "tighter camera motion." msgstr "" @@ -30814,7 +31052,18 @@ msgid "" "[code]\\n[/code]) in the string won't produce a newline. Text wrapping is " "enabled in [constant ICON_MODE_TOP] mode, but column's width is adjusted to " "fully fit its content by default. You need to set [member " -"fixed_column_width] greater than zero to wrap the text." +"fixed_column_width] greater than zero to wrap the text.\n" +"[b]Incremental search:[/b] Like [PopupMenu] and [Tree], [ItemList] supports " +"searching within the list while the control is focused. Press a key that " +"matches the first letter of an item's name to select the first item starting " +"with the given letter. After that point, there are two ways to perform " +"incremental search: 1) Press the same key again before the timeout duration " +"to select the next item starting with the same letter. 2) Press letter keys " +"that match the rest of the word before the timeout duration to match to " +"select the item in question directly. Both of these actions will be reset to " +"the beginning of the list if the timeout duration has passed since the last " +"keystroke was registered. You can adjust the timeout duration by changing " +"[member ProjectSettings.gui/timers/incremental_search_max_interval_msec]." msgstr "" #: doc/classes/ItemList.xml @@ -32356,7 +32605,7 @@ msgstr "" msgid "" "Sets the render priority for the text outline. Higher priority objects will " "be sorted in front of lower priority objects.\n" -"[b]Node:[/b] This only applies if [member alpha_cut] is set to [constant " +"[b]Note:[/b] This only applies if [member alpha_cut] is set to [constant " "ALPHA_CUT_DISABLED] (default value).\n" "[b]Note:[/b] This only applies to sorting of transparent objects. This will " "not impact how transparent objects are sorted relative to opaque objects. " @@ -32372,7 +32621,7 @@ msgstr "" msgid "" "Sets the render priority for the text. Higher priority objects will be " "sorted in front of lower priority objects.\n" -"[b]Node:[/b] This only applies if [member alpha_cut] is set to [constant " +"[b]Note:[/b] This only applies if [member alpha_cut] is set to [constant " "ALPHA_CUT_DISABLED] (default value).\n" "[b]Note:[/b] This only applies to sorting of transparent objects. This will " "not impact how transparent objects are sorted relative to opaque objects. " @@ -32402,7 +32651,7 @@ msgstr "" #: doc/classes/Label3D.xml msgid "" -"If set, text can be seen from the back as well. If not, the texture is " +"If set, text can be seen from the back as well. If not, the text is " "invisible when looking at it from behind." msgstr "" @@ -32908,14 +33157,14 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"Adds a point at the [code]position[/code]. Appends the point at the end of " -"the line.\n" -"If [code]at_position[/code] is given, the point is inserted before the point " -"number [code]at_position[/code], moving that point (and every point after) " -"after the inserted point. If [code]at_position[/code] is not given, or is an " -"illegal value ([code]at_position < 0[/code] or [code]at_position >= [method " -"get_point_count][/code]), the point will be appended at the end of the point " -"list." +"Adds a point with the specified [code]position[/code] relative to the line's " +"own position. Appends the new point at the end of the point list.\n" +"If [code]index[/code] is given, the new point is inserted before the " +"existing point identified by index [code]index[/code]. Every existing point " +"starting from [code]index[/code] is shifted further down the list of points. " +"The index must be greater than or equal to [code]0[/code] and must not " +"exceed the number of existing points in the line. See [method " +"get_point_count]." msgstr "" #: doc/classes/Line2D.xml @@ -32923,21 +33172,21 @@ msgid "Removes all points from the line." msgstr "" #: doc/classes/Line2D.xml -msgid "Returns the Line2D's amount of points." +msgid "Returns the amount of points in the line." msgstr "" #: doc/classes/Line2D.xml -msgid "Returns point [code]i[/code]'s position." +msgid "Returns the position of the point at index [code]index[/code]." msgstr "" #: doc/classes/Line2D.xml -msgid "Removes the point at index [code]i[/code] from the line." +msgid "Removes the point at index [code]index[/code] from the line." msgstr "" #: doc/classes/Line2D.xml msgid "" -"Overwrites the position in point [code]i[/code] with the supplied " -"[code]position[/code]." +"Overwrites the position of the point at index [code]index[/code] with the " +"supplied [code]position[/code]." msgstr "" #: doc/classes/Line2D.xml @@ -34213,8 +34462,12 @@ msgstr "" msgid "Flag used to mark a compressed (half float) tangent array." msgstr "" -#: doc/classes/Mesh.xml doc/classes/VisualServer.xml -msgid "Flag used to mark a compressed (half float) color array." +#: doc/classes/Mesh.xml +msgid "" +"Flag used to mark a compressed (half float) color array.\n" +"[b]Note:[/b] If this flag is enabled, vertex colors will be stored as 8-bit " +"unsigned integers. This will clamp overbright colors to [code]Color(1, 1, 1, " +"1)[/code] and reduce colors' precision." msgstr "" #: doc/classes/Mesh.xml doc/classes/VisualServer.xml @@ -34259,7 +34512,10 @@ msgid "" "ARRAY_COMPRESS_NORMAL], [constant ARRAY_COMPRESS_TANGENT], [constant " "ARRAY_COMPRESS_COLOR], [constant ARRAY_COMPRESS_TEX_UV], [constant " "ARRAY_COMPRESS_TEX_UV2], [constant ARRAY_COMPRESS_WEIGHTS], and [constant " -"ARRAY_FLAG_USE_OCTAHEDRAL_COMPRESSION] quickly." +"ARRAY_FLAG_USE_OCTAHEDRAL_COMPRESSION] quickly.\n" +"[b]Note:[/b] Since this flag enables [constant ARRAY_COMPRESS_COLOR], vertex " +"colors will be stored as 8-bit unsigned integers. This will clamp overbright " +"colors to [code]Color(1, 1, 1, 1)[/code] and reduce colors' precision." msgstr "" #: doc/classes/Mesh.xml @@ -34514,9 +34770,9 @@ msgid "" "MeshInstance is a node that takes a [Mesh] resource and adds it to the " "current scenario by creating an instance of it. This is the class most often " "used to get 3D geometry rendered and can be used to instance a single [Mesh] " -"in many places. This allows to reuse geometry and save on resources. When a " -"[Mesh] has to be instanced more than thousands of times at close proximity, " -"consider using a [MultiMesh] in a [MultiMeshInstance] instead." +"in many places. This allows reusing geometry, which can save on resources. " +"When a [Mesh] has to be instanced more than thousands of times at close " +"proximity, consider using a [MultiMesh] in a [MultiMeshInstance] instead." msgstr "" #: doc/classes/MeshInstance.xml @@ -34561,11 +34817,16 @@ msgid "" msgstr "" #: doc/classes/MeshInstance.xml -msgid "Returns the [Material] for a surface of the [Mesh] resource." +msgid "" +"Returns the override [Material] for a surface of the [Mesh] resource.\n" +"[b]Note:[/b] This function only returns [i]override[/i] materials associated " +"with this [MeshInstance]. Consider using [method get_active_material] or " +"[method Mesh.surface_get_material] to get materials associated with the " +"[Mesh] resource." msgstr "" #: doc/classes/MeshInstance.xml -msgid "Returns the number of surface materials." +msgid "Returns the number of surface override materials." msgstr "" #: doc/classes/MeshInstance.xml @@ -34602,7 +34863,10 @@ msgid "" msgstr "" #: doc/classes/MeshInstance.xml -msgid "Sets the [Material] for a surface of the [Mesh] resource." +msgid "" +"Sets the override [Material] for the specified surface of the [Mesh] " +"resource. This material is associated with this [MeshInstance] rather than " +"with the [Mesh] resource." msgstr "" #: doc/classes/MeshInstance.xml @@ -34633,9 +34897,10 @@ msgstr "" #: doc/classes/MeshInstance2D.xml msgid "" -"Node used for displaying a [Mesh] in 2D. Can be constructed from an existing " -"[Sprite] via a tool in the editor toolbar. Select \"Sprite\" then \"Convert " -"to Mesh2D\", select settings in popup and press \"Create Mesh2D\"." +"Node used for displaying a [Mesh] in 2D. A [MeshInstance2D] can be " +"automatically created from an existing [Sprite] via a tool in the editor " +"toolbar. Select the [Sprite] node, then choose [b]Sprite > Convert to " +"MeshInstance2D[/b] at the top of the 2D editor viewport." msgstr "" #: doc/classes/MeshInstance2D.xml @@ -34966,7 +35231,9 @@ msgid "" "existing vertex colors.\n" "For the color to take effect, ensure that [member color_format] is non-" "[code]null[/code] on the [MultiMesh] and [member SpatialMaterial." -"vertex_color_use_as_albedo] is [code]true[/code] on the material." +"vertex_color_use_as_albedo] is [code]true[/code] on the material. If the " +"color doesn't look as expected, make sure the material's albedo color is set " +"to pure white ([code]Color(1, 1, 1)[/code])." msgstr "" #: doc/classes/MultiMesh.xml @@ -35393,6 +35660,9 @@ msgstr "" #: doc/classes/Navigation.xml msgid "" +"[i]Deprecated.[/i] [Navigation] node and [method get_simple_path] are " +"deprecated and will be removed in a future version. Use [method " +"NavigationServer.map_get_path] instead.\n" "Provides navigation and pathfinding within a collection of " "[NavigationMesh]es. By default, these will be automatically collected from " "child [NavigationMeshInstance] nodes. In addition to basic pathfinding, this " @@ -35433,7 +35703,14 @@ msgid "" msgstr "" #: doc/classes/Navigation.xml +msgid "Returns the [RID] of the navigation map on the [NavigationServer]." +msgstr "" + +#: doc/classes/Navigation.xml msgid "" +"[i]Deprecated.[/i] [Navigation] node and [method get_simple_path] are " +"deprecated and will be removed in a future version. Use [method " +"NavigationServer.map_get_path] instead.\n" "Returns the path between two given points. Points are in local coordinate " "space. If [code]optimize[/code] is [code]true[/code] (the default), the " "agent properties associated with each [NavigationMesh] (radius, height, " @@ -35455,16 +35732,31 @@ msgstr "" #: doc/classes/Navigation.xml msgid "" +"A bitfield determining all navigation map layers the navigation can use on a " +"[method Navigation.get_simple_path] path query." +msgstr "" + +#: doc/classes/Navigation.xml +msgid "" "Defines which direction is up. By default, this is [code](0, 1, 0)[/code], " "which is the world's \"up\" direction." msgstr "" +#: doc/classes/Navigation.xml doc/classes/Navigation2DServer.xml +#: doc/classes/NavigationServer.xml +msgid "" +"Emitted when a navigation map is updated, when a region moves or is modified." +msgstr "" + #: doc/classes/Navigation2D.xml msgid "2D navigation and pathfinding node." msgstr "" #: doc/classes/Navigation2D.xml msgid "" +"[i]Deprecated.[/i] [Navigation2D] node and [method get_simple_path] are " +"deprecated and will be removed in a future version. Use [method " +"Navigation2DServer.map_get_path] instead.\n" "Navigation2D provides navigation and pathfinding within a 2D area, specified " "as a collection of [NavigationPolygon] resources. By default, these are " "automatically collected from child [NavigationPolygonInstance] nodes." @@ -35484,6 +35776,9 @@ msgstr "" #: doc/classes/Navigation2D.xml msgid "" +"[i]Deprecated.[/i] [Navigation2D] node and [method get_simple_path] are " +"deprecated and will be removed in a future version. Use [method " +"Navigation2DServer.map_get_path] instead.\n" "Returns the path between two given points. Points are in local coordinate " "space. If [code]optimize[/code] is [code]true[/code] (the default), the path " "is smoothed by merging path segments where possible." @@ -35493,6 +35788,12 @@ msgstr "" msgid "The XY plane cell size to use for fields." msgstr "" +#: doc/classes/Navigation2D.xml +msgid "" +"A bitfield determining all navigation map layers the navigation can use on a " +"[method Navigation2D.get_simple_path] path query." +msgstr "" + #: doc/classes/Navigation2DServer.xml msgid "Server interface for low-level 2D navigation access." msgstr "" @@ -35509,8 +35810,12 @@ msgid "" "through scripts.\n" "For two regions to be connected to each other, they must share a similar " "edge. An edge is considered connected to another if both of its two vertices " -"are at a distance less than [member Navigation.edge_connection_margin] to " -"the respective other edge's vertex.\n" +"are at a distance less than navigation map [code]edge_connection_margin[/" +"code] to the respective other edge's vertex.\n" +"You may assign navigation layers to regions with [method Navigation2DServer." +"region_set_navigation_layers], which then can be checked upon when " +"requesting a path with [method Navigation2DServer.map_get_path]. This allows " +"allowing or forbidding some areas to 2D objects.\n" "To use the collision avoidance system, you may use agents. You can set an " "agent's target velocity, then the servers will emit a callback with a " "modified velocity.\n" @@ -35538,7 +35843,17 @@ msgid "Returns [code]true[/code] if the map got changed the previous frame." msgstr "" #: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml -msgid "Callback called at the end of the RVO process." +msgid "" +"Callback called at the end of the RVO process. If a callback is created " +"manually and the agent is placed on a navigation map it will calculate " +"avoidance for the agent and dispatch the calculated [code]safe_velocity[/" +"code] to the [code]receiver[/code] object with a signal to the chosen " +"[code]method[/code] name.\n" +"[b]Note:[/b] Created callbacks are always processed independently of the " +"SceneTree state as long as the agent is on a navigation map and not freed. " +"To disable the dispatch of a callback from an agent use [method " +"agent_set_callback] again with a [code]null[/code] object as the " +"[code]receiver[/code]." msgstr "" #: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml @@ -35593,15 +35908,55 @@ msgid "Destroys the given RID." msgstr "" #: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml +msgid "" +"Returns all created navigation map [RID]s on the NavigationServer. This " +"returns both 2D and 3D created navigation maps as there is technically no " +"distinction between them." +msgstr "" + +#: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml msgid "Create a new map." msgstr "" #: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml msgid "" +"This function immediately forces synchronization of the specified navigation " +"[code]map[/code] [RID]. By default navigation maps are only synchronized at " +"the end of each physics frame. This function can be used to immediately " +"(re)calculate all the navigation meshes and region connections of the " +"navigation map. This makes it possible to query a navigation path for a " +"changed map immediately and in the same frame (multiple times if needed).\n" +"Due to technical restrictions the current NavigationServer command queue " +"will be flushed. This means all already queued update commands for this " +"physics frame will be executed, even those intended for other maps, regions " +"and agents not part of the specified map. The expensive computation of the " +"navigation meshes and region connections of a map will only be done for the " +"specified map. Other maps will receive the normal synchronization at the end " +"of the physics frame. Should the specified map receive changes after the " +"forced update it will update again as well when the other maps receive their " +"update.\n" +"Avoidance processing and dispatch of the [code]safe_velocity[/code] signals " +"is untouched by this function and continues to happen for all maps and " +"agents at the end of the physics frame.\n" +"[b]Note:[/b] With great power comes great responsibility. This function " +"should only be used by users that really know what they are doing and have a " +"good reason for it. Forcing an immediate update of a navigation map requires " +"locking the NavigationServer and flushing the entire NavigationServer " +"command queue. Not only can this severely impact the performance of a game " +"but it can also introduce bugs if used inappropriately without much " +"foresight." +msgstr "" + +#: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml +msgid "" "Returns all navigation agents [RID]s that are currently assigned to the " "requested navigation [code]map[/code]." msgstr "" +#: doc/classes/Navigation2DServer.xml +msgid "Returns the map cell height. [b]Note:[/b] Currently not implemented." +msgstr "" + #: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml msgid "Returns the map cell size." msgstr "" @@ -35625,7 +35980,10 @@ msgid "" msgstr "" #: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml -msgid "Returns the navigation path to reach the destination from the origin." +msgid "" +"Returns the navigation path to reach the destination from the origin. " +"[code]navigation_layers[/code] is a bitmask of all region layers that are " +"allowed to be in the path." msgstr "" #: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml @@ -35642,6 +36000,12 @@ msgstr "" msgid "Sets the map active." msgstr "" +#: doc/classes/Navigation2DServer.xml +msgid "" +"Set the map cell height used to weld the navigation mesh polygons. [b]Note:[/" +"b] Currently not implemented." +msgstr "" + #: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml msgid "Set the map cell size used to weld the navigation mesh polygons." msgstr "" @@ -35657,14 +36021,73 @@ msgstr "" #: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml msgid "" +"Returns the ending point of a connection door. [code]connection[/code] is an " +"index between 0 and the return value of [method " +"region_get_connections_count]." +msgstr "" + +#: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml +msgid "" +"Returns the starting point of a connection door. [code]connection[/code] is " +"an index between 0 and the return value of [method " +"region_get_connections_count]." +msgstr "" + +#: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml +msgid "" +"Returns how many connections this [code]region[/code] has with other regions " +"in the map." +msgstr "" + +#: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml +msgid "Returns the [code]enter_cost[/code] of this [code]region[/code]." +msgstr "" + +#: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml +msgid "" "Returns the navigation map [RID] the requested [code]region[/code] is " "currently assigned to." msgstr "" #: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml +msgid "Returns the region's navigation layers." +msgstr "" + +#: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml +msgid "Returns the [code]travel_cost[/code] of this [code]region[/code]." +msgstr "" + +#: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml +msgid "" +"Returns [code]true[/code] if the provided [code]point[/code] in world space " +"is currently owned by the provided navigation [code]region[/code]. Owned in " +"this context means that one of the region's navigation mesh polygon faces " +"has a possible position at the closest distance to this point compared to " +"all other navigation meshes from other navigation regions that are also " +"registered on the navigation map of the provided region.\n" +"If multiple navigation meshes have positions at equal distance the " +"navigation region whose polygons are processed first wins the ownership. " +"Polygons are processed in the same order that navigation regions were " +"registered on the NavigationServer.\n" +"[b]Note:[/b] If navigation meshes from different navigation regions overlap " +"(which should be avoided in general) the result might not be what is " +"expected." +msgstr "" + +#: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml +msgid "Sets the [code]enter_cost[/code] for this [code]region[/code]." +msgstr "" + +#: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml msgid "Sets the map for the region." msgstr "" +#: doc/classes/Navigation2DServer.xml +msgid "" +"Set the region's navigation layers. This allows selecting regions from a " +"path request (when using [method Navigation2DServer.map_get_path])." +msgstr "" + #: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml msgid "Sets the navigation mesh for the region." msgstr "" @@ -35673,6 +36096,10 @@ msgstr "" msgid "Sets the global transformation for the region." msgstr "" +#: doc/classes/Navigation2DServer.xml doc/classes/NavigationServer.xml +msgid "Sets the [code]travel_cost[/code] for this [code]region[/code]." +msgstr "" + #: doc/classes/NavigationAgent.xml msgid "3D agent used in navigation for collision avoidance." msgstr "" @@ -35682,9 +36109,16 @@ msgid "" "3D agent that is used in navigation to reach a location while avoiding " "static and dynamic obstacles. The dynamic obstacles are avoided using RVO " "(Reciprocal Velocity Obstacles) collision avoidance. The agent needs " -"navigation data to work correctly. This can be done by having the agent as a " -"child of a [Navigation] node, or using [method set_navigation]. " -"[NavigationAgent] is physics safe." +"navigation data to work correctly. By default this node will register to the " +"default [World] navigation map. If this node is a child of a [Navigation] " +"node it will register to the navigation map of the navigation node or the " +"function [method set_navigation] can be used to set the navigation node " +"directly. [NavigationAgent] is physics safe.\n" +"[b]Note:[/b] After [method set_target_location] is used it is required to " +"use the [method get_next_location] function once every physics frame to " +"update the internal path logic of the NavigationAgent. The returned vector " +"position from this function should be used as the next movement position for " +"the agent's parent Node." msgstr "" #: doc/classes/NavigationAgent.xml doc/classes/NavigationAgent2D.xml @@ -35702,7 +36136,15 @@ msgid "" msgstr "" #: doc/classes/NavigationAgent.xml doc/classes/NavigationAgent2D.xml -msgid "Returns the path from start to finish in global coordinates." +msgid "" +"Returns this agent's current path from start to finish in global " +"coordinates. The path only updates when the target location is changed or " +"the agent requires a repath. The path array is not intended to be used in " +"direct path movement as the agent has its own internal path logic that would " +"get corrupted by changing the path array manually. Use the intended [method " +"get_next_location] once every physics frame to receive the next path point " +"for the agents movement as this function also updates the internal path " +"logic." msgstr "" #: doc/classes/NavigationAgent.xml @@ -35717,11 +36159,24 @@ msgid "" "system." msgstr "" -#: doc/classes/NavigationAgent.xml +#: doc/classes/NavigationAgent.xml doc/classes/NavigationAgent2D.xml +msgid "" +"Returns the [RID] of the navigation map for this NavigationAgent node. This " +"function returns always the map set on the NavigationAgent node and not the " +"map of the abstract agent on the NavigationServer. If the agent map is " +"changed directly with the NavigationServer API the NavigationAgent node will " +"not be aware of the map change. Use [method set_navigation_map] to change " +"the navigation map for the NavigationAgent and also update the agent on the " +"NavigationServer." +msgstr "" + +#: doc/classes/NavigationAgent.xml doc/classes/NavigationAgent2D.xml msgid "" -"Returns a [Vector3] in global coordinates, that can be moved to, making sure " -"that there are no static objects in the way. If the agent does not have a " -"navigation path, it will return the origin of the agent's parent." +"Returns the next location in global coordinates that can be moved to, making " +"sure that there are no static objects in the way. If the agent does not have " +"a navigation path, it will return the position of the agent's parent. The " +"use of this function once every physics frame is required to update the " +"internal path logic of the NavigationAgent." msgstr "" #: doc/classes/NavigationAgent.xml @@ -35762,6 +36217,12 @@ msgstr "" #: doc/classes/NavigationAgent.xml doc/classes/NavigationAgent2D.xml msgid "" +"Sets the [RID] of the navigation map this NavigationAgent node should use " +"and also updates the [code]agent[/code] on the NavigationServer." +msgstr "" + +#: doc/classes/NavigationAgent.xml doc/classes/NavigationAgent2D.xml +msgid "" "Sets the user desired final location. This will clear the current navigation " "path." msgstr "" @@ -35774,7 +36235,13 @@ msgid "" msgstr "" #: doc/classes/NavigationAgent.xml -msgid "The agent height offset to match the navigation mesh height." +msgid "" +"The NavigationAgent height offset is subtracted from the y-axis value of any " +"vector path position for this NavigationAgent. The NavigationAgent height " +"offset does not change or influence the navigation mesh or pathfinding query " +"result. Additional navigation maps that use regions with navigation meshes " +"that the developer baked with appropriate agent radius or height values are " +"required to support different-sized agents." msgstr "" #: doc/classes/NavigationAgent.xml @@ -35801,26 +36268,53 @@ msgstr "" msgid "The maximum speed that an agent can move." msgstr "" +#: doc/classes/NavigationAgent.xml +msgid "" +"A bitfield determining all navigation map layers the [NavigationAgent] " +"belongs to. On path requests the agent will ignore navmeshes without at " +"least one matching layer." +msgstr "" + #: doc/classes/NavigationAgent.xml doc/classes/NavigationAgent2D.xml msgid "The distance to search for other agents." msgstr "" #: doc/classes/NavigationAgent.xml doc/classes/NavigationAgent2D.xml msgid "" +"The distance threshold before a path point is considered to be reached. This " +"will allow an agent to not have to hit a path point on the path exactly, but " +"in the area. If this value is set to high the NavigationAgent will skip " +"points on the path which can lead to leaving the navigation mesh. If this " +"value is set to low the NavigationAgent will be stuck in a repath loop cause " +"it will constantly overshoot or undershoot the distance to the next point on " +"each physics frame update." +msgstr "" + +#: doc/classes/NavigationAgent.xml doc/classes/NavigationAgent2D.xml +msgid "" "The maximum distance the agent is allowed away from the ideal path to the " "final location. This can happen due to trying to avoid collisions. When the " "maximum distance is exceeded, it recalculates the ideal path." msgstr "" -#: doc/classes/NavigationAgent.xml doc/classes/NavigationAgent2D.xml -msgid "The radius of the agent." +#: doc/classes/NavigationAgent.xml +msgid "" +"The radius of the avoidance agent. This is the \"body\" of the avoidance " +"agent and not the avoidance maneuver starting radius (which is controlled by " +"[member neighbor_dist]).\n" +"Does not affect normal pathfinding. To change an actor's pathfinding radius " +"bake [NavigationMesh] resources with a different [member NavigationMesh." +"agent_radius] property and use different navigation maps for each actor size." msgstr "" #: doc/classes/NavigationAgent.xml doc/classes/NavigationAgent2D.xml msgid "" -"The distance threshold before a target is considered to be reached. This " -"will allow an agent to not have to hit a point on the path exactly, but in " -"the area." +"The distance threshold before the final target point is considered to be " +"reached. This will allow an agent to not have to hit the point of the final " +"target exactly, but only the area. If this value is set to low the " +"NavigationAgent will be stuck in a repath loop cause it will constantly " +"overshoot or undershoot the distance to the final target point on each " +"physics frame update." msgstr "" #: doc/classes/NavigationAgent.xml doc/classes/NavigationAgent2D.xml @@ -35851,7 +36345,7 @@ msgstr "" #: doc/classes/NavigationAgent.xml doc/classes/NavigationAgent2D.xml msgid "" "Notifies when the collision avoidance velocity is calculated after a call to " -"[method set_velocity]." +"[method set_velocity]. Only emitted when [member avoidance_enabled] is true." msgstr "" #: doc/classes/NavigationAgent2D.xml @@ -35863,9 +36357,16 @@ msgid "" "2D agent that is used in navigation to reach a location while avoiding " "static and dynamic obstacles. The dynamic obstacles are avoided using RVO " "(Reciprocal Velocity Obstacles) collision avoidance. The agent needs " -"navigation data to work correctly. This can be done by having the agent as a " -"child of a [Navigation2D] node, or using [method set_navigation]. " -"[NavigationAgent2D] is physics safe." +"navigation data to work correctly. By default this node will register to the " +"default [World2D] navigation map. If this node is a child of a " +"[Navigation2D] node it will register to the navigation map of the navigation " +"node or the function [method set_navigation] can be used to set the " +"navigation node directly. [NavigationAgent2D] is physics safe.\n" +"[b]Note:[/b] After [method set_target_location] is used it is required to " +"use the [method get_next_location] function once every physics frame to " +"update the internal path logic of the NavigationAgent. The returned vector " +"position from this function should be used as the next movement position for " +"the agent's parent Node." msgstr "" #: doc/classes/NavigationAgent2D.xml @@ -35881,13 +36382,6 @@ msgid "" msgstr "" #: doc/classes/NavigationAgent2D.xml -msgid "" -"Returns a [Vector2] in global coordinates, that can be moved to, making sure " -"that there are no static objects in the way. If the agent does not have a " -"navigation path, it will return the position of the agent's parent." -msgstr "" - -#: doc/classes/NavigationAgent2D.xml msgid "Returns the [RID] of this agent on the [Navigation2DServer]." msgstr "" @@ -35907,6 +36401,21 @@ msgid "" "only be enabled on agents that currently require it." msgstr "" +#: doc/classes/NavigationAgent2D.xml +msgid "" +"A bitfield determining all navigation map layers the [NavigationAgent2D] " +"belongs to. On path requests the agent will ignore navmeshes without at " +"least one matching layer." +msgstr "" + +#: doc/classes/NavigationAgent2D.xml +msgid "" +"The radius of the avoidance agent. This is the \"body\" of the avoidance " +"agent and not the avoidance maneuver starting radius (which is controlled by " +"[member neighbor_dist]).\n" +"Does not affect normal pathfinding." +msgstr "" + #: doc/classes/NavigationMesh.xml msgid "A mesh to approximate the walkable areas and obstacles." msgstr "" @@ -35937,8 +36446,8 @@ msgstr "" #: doc/classes/NavigationMesh.xml msgid "" -"Returns whether the specified [code]bit[/code] of the [member geometry/" -"collision_mask] is set." +"Returns whether the specified [code]bit[/code] of the [member " +"geometry_collision_mask] is set." msgstr "" #: doc/classes/NavigationMesh.xml doc/classes/NavigationPolygon.xml @@ -35960,9 +36469,9 @@ msgstr "" #: doc/classes/NavigationMesh.xml msgid "" "If [code]value[/code] is [code]true[/code], sets the specified [code]bit[/" -"code] in the [member geometry/collision_mask].\n" +"code] in the [member geometry_collision_mask].\n" "If [code]value[/code] is [code]false[/code], clears the specified [code]bit[/" -"code] in the [member geometry/collision_mask]." +"code] in the [member geometry_collision_mask]." msgstr "" #: doc/classes/NavigationMesh.xml doc/classes/NavigationPolygon.xml @@ -35976,14 +36485,14 @@ msgid "" "The minimum floor to ceiling height that will still allow the floor area to " "be considered walkable.\n" "[b]Note:[/b] While baking, this value will be rounded up to the nearest " -"multiple of [member cell/height]." +"multiple of [member cell_height]." msgstr "" #: doc/classes/NavigationMesh.xml msgid "" "The minimum ledge height that is considered to still be traversable.\n" "[b]Note:[/b] While baking, this value will be rounded down to the nearest " -"multiple of [member cell/height]." +"multiple of [member cell_height]." msgstr "" #: doc/classes/NavigationMesh.xml @@ -35995,7 +36504,7 @@ msgid "" "The distance to erode/shrink the walkable area of the heightfield away from " "obstructions.\n" "[b]Note:[/b] While baking, this value will be rounded up to the nearest " -"multiple of [member cell/size]." +"multiple of [member cell_size]." msgstr "" #: doc/classes/NavigationMesh.xml @@ -36023,13 +36532,17 @@ msgstr "" msgid "" "The maximum allowed length for contour edges along the border of the mesh.\n" "[b]Note:[/b] While baking, this value will be rounded up to the nearest " -"multiple of [member cell/size]." +"multiple of [member cell_size]." msgstr "" #: doc/classes/NavigationMesh.xml msgid "" -"If [code]true[/code], marks walkable spans as not walkable if the clearance " -"above the span is less than [member agent/height]." +"If the baking [AABB] has a volume the navigation mesh baking will be " +"restricted to its enclosing area." +msgstr "" + +#: doc/classes/NavigationMesh.xml +msgid "The position offset applied to the [member filter_baking_aabb] [AABB]." msgstr "" #: doc/classes/NavigationMesh.xml @@ -36039,13 +36552,19 @@ msgstr "" #: doc/classes/NavigationMesh.xml msgid "" "If [code]true[/code], marks non-walkable spans as walkable if their maximum " -"is within [member agent/max_climb] of a walkable neighbor." +"is within [member agent_max_climb] of a walkable neighbor." +msgstr "" + +#: doc/classes/NavigationMesh.xml +msgid "" +"If [code]true[/code], marks walkable spans as not walkable if the clearance " +"above the span is less than [member agent_height]." msgstr "" #: doc/classes/NavigationMesh.xml msgid "" "The physics layers to scan for static colliders.\n" -"Only used when [member geometry/parsed_geometry_type] is [constant " +"Only used when [member geometry_parsed_geometry_type] is [constant " "PARSED_GEOMETRY_STATIC_COLLIDERS] or [constant PARSED_GEOMETRY_BOTH]." msgstr "" @@ -36064,7 +36583,7 @@ msgstr "" #: doc/classes/NavigationMesh.xml msgid "" "The name of the group to scan for geometry.\n" -"Only used when [member geometry/source_geometry_mode] is [constant " +"Only used when [member geometry_source_geometry_mode] is [constant " "SOURCE_GEOMETRY_GROUPS_WITH_CHILDREN] or [constant " "SOURCE_GEOMETRY_GROUPS_EXPLICIT]." msgstr "" @@ -36127,7 +36646,7 @@ msgstr "" #: doc/classes/NavigationMesh.xml msgid "" "Parses [StaticBody] colliders as geometry. The collider should be in any of " -"the layers specified by [member geometry/collision_mask]." +"the layers specified by [member geometry_collision_mask]." msgstr "" #: doc/classes/NavigationMesh.xml @@ -36148,13 +36667,13 @@ msgstr "" #: doc/classes/NavigationMesh.xml msgid "" "Scans nodes in a group and their child nodes recursively for geometry. The " -"group is specified by [member geometry/source_group_name]." +"group is specified by [member geometry_source_group_name]." msgstr "" #: doc/classes/NavigationMesh.xml msgid "" "Uses nodes in a group for geometry. The group is specified by [member " -"geometry/source_group_name]." +"geometry_source_group_name]." msgstr "" #: doc/classes/NavigationMesh.xml @@ -36196,7 +36715,15 @@ msgid "" "geometry for walkable terrain suitable to [NavigationMesh] agent properties " "by creating a voxel world around the meshes bounding area.\n" "The finalized navigation mesh is then returned and stored inside the " -"[NavigationMesh] for use as a resource inside [NavigationMeshInstance] nodes." +"[NavigationMesh] for use as a resource inside [NavigationMeshInstance] " +"nodes.\n" +"[b]Note:[/b] Using meshes to not only define walkable surfaces but also " +"obstruct navigation baking does not always work. The navigation baking has " +"no concept of what is a geometry \"inside\" when dealing with mesh source " +"geometry and this is intentional. Depending on current baking parameters, as " +"soon as the obstructing mesh is large enough to fit a navigation mesh area " +"inside, the baking will generate navigation mesh areas that are inside the " +"obstructing source geometry mesh." msgstr "" #: doc/classes/NavigationMeshGenerator.xml @@ -36204,8 +36731,8 @@ msgid "" "Bakes navigation data to the provided [code]nav_mesh[/code] by parsing child " "nodes under the provided [code]root_node[/code] or a specific group of nodes " "for potential source geometry. The parse behavior can be controlled with the " -"[member NavigationMesh.geometry/parsed_geometry_type] and [member " -"NavigationMesh.geometry/source_geometry_mode] properties on the " +"[member NavigationMesh.geometry_parsed_geometry_type] and [member " +"NavigationMesh.geometry_source_geometry_mode] properties on the " "[NavigationMesh] resource." msgstr "" @@ -36222,8 +36749,21 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" "An instance of a [NavigationMesh]. It tells the [Navigation] node what can " -"be navigated and what cannot, based on the [NavigationMesh] resource. This " -"should be a child of a [Navigation] node." +"be navigated and what cannot, based on the [NavigationMesh] resource.\n" +"By default this node will register to the default [World] navigation map. If " +"this node is a child of a [Navigation] node it will register to the " +"navigation map of the navigation node.\n" +"Two regions can be connected to each other if they share a similar edge. You " +"can set the minimum distance between two vertices required to connect two " +"edges by using [method NavigationServer.map_set_edge_connection_margin].\n" +"[b]Note:[/b] Overlapping two regions' navmeshes is not enough for connecting " +"two regions. They must share a similar edge.\n" +"The cost of entering this region from another region can be controlled with " +"the [member enter_cost] value.\n" +"[b]Note:[/b] This value is not added to the path cost when the start " +"position is already inside this region.\n" +"The cost of traveling distances inside this region can be controlled with " +"the [member travel_cost] multiplier." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -36252,10 +36792,34 @@ msgid "Determines if the [NavigationMeshInstance] is enabled or disabled." msgstr "" #: doc/classes/NavigationMeshInstance.xml +#: doc/classes/NavigationPolygonInstance.xml +msgid "" +"When pathfinding enters this region's navmesh from another regions navmesh " +"the [code]enter_cost[/code] value is added to the path distance for " +"determining the shortest path." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"A bitfield determining all navigation map layers the [NavigationMesh] " +"belongs to. On path requests with [method NavigationServer.map_get_path] " +"navmeshes without matching layers will be ignored and the navigation map " +"will only proximity merge different navmeshes with matching layers." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml msgid "The [NavigationMesh] resource to use." msgstr "" #: doc/classes/NavigationMeshInstance.xml +#: doc/classes/NavigationPolygonInstance.xml +msgid "" +"When pathfinding moves inside this region's navmesh the traveled distances " +"are multiplied with [code]travel_cost[/code] for determining the shortest " +"path." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml msgid "Notifies when the navigation mesh bake operation is completed." msgstr "" @@ -36272,7 +36836,9 @@ msgid "" "3D obstacle used in navigation for collision avoidance. The obstacle needs " "navigation data to work correctly. This can be done by having the obstacle " "as a child of a [Navigation] node, or using [method set_navigation]. " -"[NavigationObstacle] is physics safe." +"[NavigationObstacle] is physics safe.\n" +"[b]Note:[/b] Obstacles are intended as a last resort option for constantly " +"moving objects that cannot be (re)baked to a navigation mesh efficiently." msgstr "" #: doc/classes/NavigationObstacle.xml @@ -36312,7 +36878,9 @@ msgid "" "2D obstacle used in navigation for collision avoidance. The obstacle needs " "navigation data to work correctly. This can be done by having the obstacle " "as a child of a [Navigation2D] node, or using [method set_navigation]. " -"[NavigationObstacle2D] is physics safe." +"[NavigationObstacle2D] is physics safe.\n" +"[b]Note:[/b] Obstacles are intended as a last resort option for constantly " +"moving objects that cannot be (re)baked to a navigation mesh efficiently." msgstr "" #: doc/classes/NavigationObstacle2D.xml @@ -36392,6 +36960,14 @@ msgstr "" #: doc/classes/NavigationPolygon.xml msgid "" +"Returns the [NavigationMesh] resulting from this navigation polygon. This " +"navmesh can be used to update the navmesh of a region with the [method " +"NavigationServer.region_set_navmesh] API directly (as 2D uses the 3D server " +"behind the scene)." +msgstr "" + +#: doc/classes/NavigationPolygon.xml +msgid "" "Returns a [PoolVector2Array] containing the vertices of an outline that was " "created in the editor or by script." msgstr "" @@ -36428,6 +37004,30 @@ msgid "" msgstr "" #: doc/classes/NavigationPolygonInstance.xml +msgid "A region of the 2D navigation map." +msgstr "" + +#: doc/classes/NavigationPolygonInstance.xml +msgid "" +"A region of the navigation map. It tells the [Navigation2DServer] what can " +"be navigated and what cannot, based on its [NavigationPolygon] resource.\n" +"By default this node will register to the default [World2D] navigation map. " +"If this node is a child of a [Navigation2D] node it will register to the " +"navigation map of the navigation node.\n" +"Two regions can be connected to each other if they share a similar edge. You " +"can set the minimum distance between two vertices required to connect two " +"edges by using [method Navigation2DServer.map_set_edge_connection_margin].\n" +"[b]Note:[/b] Overlapping two regions' polygons is not enough for connecting " +"two regions. They must share a similar edge.\n" +"The pathfinding cost of entering this region from another region can be " +"controlled with the [member enter_cost] value.\n" +"[b]Note:[/b] This value is not added to the path cost when the start " +"position is already inside this region.\n" +"The pathfinding cost of traveling distances inside this region can be " +"controlled with the [member travel_cost] multiplier." +msgstr "" + +#: doc/classes/NavigationPolygonInstance.xml msgid "" "Returns the [RID] of this region on the [Navigation2DServer]. Combined with " "[method Navigation2DServer.map_get_closest_point_owner] can be used to " @@ -36435,6 +37035,22 @@ msgid "" "navigation map." msgstr "" +#: doc/classes/NavigationPolygonInstance.xml +msgid "Determines if the [NavigationPolygonInstance] is enabled or disabled." +msgstr "" + +#: doc/classes/NavigationPolygonInstance.xml +msgid "" +"A bitfield determining all navigation map layers the [NavigationPolygon] " +"belongs to. On path requests with [method Navigation2DServer.map_get_path] " +"navmeshes without matching layers will be ignored and the navigation map " +"will only proximity merge different navmeshes with matching layers." +msgstr "" + +#: doc/classes/NavigationPolygonInstance.xml +msgid "The [NavigationPolygon] resource to use." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36510,9 +37126,73 @@ msgid "Bakes the navigation mesh." msgstr "" #: doc/classes/NavigationServer.xml +msgid "" +"Set the region's navigation layers. This allows selecting regions from a " +"path request (when using [method NavigationServer.map_get_path])." +msgstr "" + +#: doc/classes/NavigationServer.xml msgid "Control activation of this server." msgstr "" +#: doc/classes/NetworkedMultiplayerCustom.xml +msgid "" +"A [NetworkedMultiplayerPeer] implementation that can be controlled from a " +"script." +msgstr "" + +#: doc/classes/NetworkedMultiplayerCustom.xml +msgid "" +"A [NetworkedMultiplayerPeer] implementation that can be used as a [member " +"MultiplayerAPI.network_peer] and controlled from a script.\n" +"Its purpose is to allow adding a new backend for the high-Level multiplayer " +"API without needing to use GDNative." +msgstr "" + +#: doc/classes/NetworkedMultiplayerCustom.xml +msgid "" +"Deliver a packet to the local [MultiplayerAPI].\n" +"When your script receives a packet from other peers over the network " +"(originating from the [signal packet_generated] signal on the sending peer), " +"passing it to this method will deliver it locally." +msgstr "" + +#: doc/classes/NetworkedMultiplayerCustom.xml +msgid "" +"Initialize the peer with the given [code]peer_id[/code] (must be between 1 " +"and 2147483647).\n" +"Can only be called if the connection status is [constant " +"NetworkedMultiplayerPeer.CONNECTION_CONNECTING]. See [method " +"set_connection_status]." +msgstr "" + +#: doc/classes/NetworkedMultiplayerCustom.xml +msgid "" +"Set the state of the connection. See [enum NetworkedMultiplayerPeer." +"ConnectionStatus].\n" +"This will emit the [signal NetworkedMultiplayerPeer.connection_succeeded], " +"[signal NetworkedMultiplayerPeer.connection_failed] or [signal " +"NetworkedMultiplayerPeer.server_disconnected] signals depending on the " +"status and if the peer has the unique network id of [code]1[/code].\n" +"You can only change to [constant NetworkedMultiplayerPeer." +"CONNECTION_CONNECTING] from [constant NetworkedMultiplayerPeer." +"CONNECTION_DISCONNECTED] and to [constant NetworkedMultiplayerPeer." +"CONNECTION_CONNECTED] from [constant NetworkedMultiplayerPeer." +"CONNECTION_CONNECTING]." +msgstr "" + +#: doc/classes/NetworkedMultiplayerCustom.xml +msgid "Set the max packet size that this peer can handle." +msgstr "" + +#: doc/classes/NetworkedMultiplayerCustom.xml +msgid "" +"Emitted when the local [MultiplayerAPI] generates a packet.\n" +"Your script should take this packet and send it to the requested peer over " +"the network (which should call [method deliver_packet] with the data when " +"it's received)." +msgstr "" + #: modules/enet/doc_classes/NetworkedMultiplayerENet.xml msgid "" "PacketPeer implementation using the [url=http://enet.bespin.org/index." @@ -37976,13 +38656,19 @@ msgstr "" #: doc/classes/Node.xml msgid "" "Emitted when a child node enters the scene tree, either because it entered " -"on its own or because this node entered with it." +"on its own or because this node entered with it.\n" +"This signal is emitted [i]after[/i] the child node's own [constant " +"NOTIFICATION_ENTER_TREE] and [signal tree_entered]." msgstr "" #: doc/classes/Node.xml msgid "" -"Emitted when a child node exits the scene tree, either because it exited on " -"its own or because this node exited." +"Emitted when a child node is about to exit the scene tree, either because it " +"is being removed or freed directly, or because this node is exiting the " +"tree.\n" +"When this signal is received, the child [code]node[/code] is still in the " +"tree and valid. This signal is emitted [i]after[/i] the child node's own " +"[signal tree_exiting] and [constant NOTIFICATION_EXIT_TREE]." msgstr "" #: doc/classes/Node.xml @@ -37994,7 +38680,10 @@ msgid "Emitted when the node is renamed." msgstr "" #: doc/classes/Node.xml -msgid "Emitted when the node enters the tree." +msgid "" +"Emitted when the node enters the tree.\n" +"This signal is emitted [i]after[/i] the related [constant " +"NOTIFICATION_ENTER_TREE] notification." msgstr "" #: doc/classes/Node.xml @@ -38004,15 +38693,21 @@ msgstr "" #: doc/classes/Node.xml msgid "" "Emitted when the node is still active but about to exit the tree. This is " -"the right place for de-initialization (or a \"destructor\", if you will)." +"the right place for de-initialization (or a \"destructor\", if you will).\n" +"This signal is emitted [i]before[/i] the related [constant " +"NOTIFICATION_EXIT_TREE] notification." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when the node enters a [SceneTree]." +msgid "" +"Notification received when the node enters a [SceneTree].\n" +"This notification is emitted [i]before[/i] the related [signal tree_entered]." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when the node is about to exit a [SceneTree]." +msgid "" +"Notification received when the node is about to exit a [SceneTree].\n" +"This notification is emitted [i]after[/i] the related [signal tree_exiting]." msgstr "" #: doc/classes/Node.xml @@ -38273,7 +38968,13 @@ msgid "Rotation in degrees, relative to the node's parent." msgstr "" #: doc/classes/Node2D.xml -msgid "The node's scale. Unscaled value: [code](1, 1)[/code]." +msgid "" +"The node's scale. Unscaled value: [code](1, 1)[/code].\n" +"[b]Note:[/b] Negative X scales in 2D are not decomposable from the " +"transformation matrix. Due to the way scale is represented with " +"transformation matrices in Godot, negative scales on the X axis will be " +"changed to negative scales on the Y axis and a rotation of 180 degrees when " +"decomposed." msgstr "" #: doc/classes/Node2D.xml @@ -39189,7 +39890,13 @@ msgid "See [enum ShadowDetail]." msgstr "" #: doc/classes/OmniLight.xml -msgid "See [enum ShadowMode]." +msgid "" +"The shadow rendering mode to use for this [OmniLight]. See [enum " +"ShadowMode].\n" +"[b]Note:[/b] In GLES2, [constant SHADOW_CUBE] is only supported on GPUs that " +"feature support for depth cubemaps. Old GPUs such as the Radeon HD 4000 " +"series don't support cubemap shadows and will fall back to dual paraboloid " +"shadows as a result." msgstr "" #: doc/classes/OmniLight.xml @@ -39201,7 +39908,8 @@ msgstr "" #: doc/classes/OmniLight.xml msgid "" "Shadows are rendered to a cubemap. Slower than [constant " -"SHADOW_DUAL_PARABOLOID], but higher-quality." +"SHADOW_DUAL_PARABOLOID], but higher-quality. Only supported on GPUs that " +"feature support for depth cubemaps." msgstr "" #: doc/classes/OmniLight.xml @@ -39713,6 +40421,10 @@ msgid "" " if argument.find(\"=\") > -1:\n" " var key_value = argument.split(\"=\")\n" " arguments[key_value[0].lstrip(\"--\")] = key_value[1]\n" +" else:\n" +" # Options without an argument will be present in the dictionary,\n" +" # with the value set to an empty string.\n" +" arguments[argument.lstrip(\"--\")] = \"\"\n" "[/codeblock]" msgstr "" @@ -40130,7 +40842,9 @@ msgid "" "are also subject to automatic adjustments by the operating system. [b]Always " "use[/b] [method get_ticks_usec] or [method get_ticks_msec] for precise time " "calculation instead, since they are guaranteed to be monotonic (i.e. never " -"decrease)." +"decrease).\n" +"[b]Note:[/b] To get a floating point timestamp with sub-second precision, " +"use [method Time.get_unix_time_from_system]." msgstr "" #: doc/classes/OS.xml @@ -40366,8 +41080,15 @@ msgstr "" msgid "" "Moves the file or directory to the system's recycle bin. See also [method " "Directory.remove].\n" +"The method takes only global paths, so you may need to use [method " +"ProjectSettings.globalize_path]. Do not use it for files in [code]res://[/" +"code] as it will not work in exported project.\n" "[b]Note:[/b] If the user has disabled the recycle bin on their system, the " -"file will be permanently deleted instead." +"file will be permanently deleted instead.\n" +"[codeblock]\n" +"var file_to_remove = \"user://slot1.sav\"\n" +"OS.move_to_trash(ProjectSettings.globalize_path(file_to_remove))\n" +"[/codeblock]" msgstr "" #: doc/classes/OS.xml @@ -44794,6 +45515,13 @@ msgstr "" msgid "Changes the byte at the given index." msgstr "" +#: doc/classes/PoolByteArray.xml doc/classes/PoolColorArray.xml +#: doc/classes/PoolIntArray.xml doc/classes/PoolRealArray.xml +#: doc/classes/PoolStringArray.xml doc/classes/PoolVector2Array.xml +#: doc/classes/PoolVector3Array.xml +msgid "Sorts the elements of the array in ascending order." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns the slice of the [PoolByteArray] between indices (inclusive) as a " @@ -45206,7 +45934,18 @@ msgstr "" #: doc/classes/PopupMenu.xml msgid "" "[PopupMenu] is a [Control] that displays a list of options. They are popular " -"in toolbars or context menus." +"in toolbars or context menus.\n" +"[b]Incremental search:[/b] Like [ItemList] and [Tree], [PopupMenu] supports " +"searching within the list while the control is focused. Press a key that " +"matches the first letter of an item's name to select the first item starting " +"with the given letter. After that point, there are two ways to perform " +"incremental search: 1) Press the same key again before the timeout duration " +"to select the next item starting with the same letter. 2) Press letter keys " +"that match the rest of the word before the timeout duration to match to " +"select the item in question directly. Both of these actions will be reset to " +"the beginning of the list if the timeout duration has passed since the last " +"keystroke was registered. You can adjust the timeout duration by changing " +"[member ProjectSettings.gui/timers/incremental_search_max_interval_msec]." msgstr "" #: doc/classes/PopupMenu.xml @@ -45469,7 +46208,9 @@ msgid "" msgstr "" #: doc/classes/PopupMenu.xml -msgid "Sets the currently focused item as the given [code]index[/code]." +msgid "" +"Sets the currently focused item as the given [code]index[/code].\n" +"Passing [code]-1[/code] as the index makes so that no item is focused." msgstr "" #: doc/classes/PopupMenu.xml @@ -45708,7 +46449,9 @@ msgstr "" msgid "" "Class for displaying popups with a panel background. In some cases it might " "be simpler to use than [Popup], since it provides a configurable background. " -"If you are making windows, better check [WindowDialog]." +"If you are making windows, better check [WindowDialog].\n" +"If any [Control] node is added as a child of this [PopupPanel], it will be " +"stretched to fit the panel's size (similar to how [PanelContainer] works)." msgstr "" #: doc/classes/PopupPanel.xml @@ -46437,7 +47180,11 @@ msgstr "" #: doc/classes/ProjectSettings.xml msgid "" "If [code]true[/code], microphone input will be allowed. This requires " -"appropriate permissions to be set when exporting to Android or iOS." +"appropriate permissions to be set when exporting to Android or iOS.\n" +"[b]Note:[/b] If the operating system blocks access to audio input devices " +"(due to the user's privacy settings), audio capture will only return " +"silence. On Windows 10 and later, make sure that apps are allowed to access " +"the microphone in the OS' privacy settings." msgstr "" #: doc/classes/ProjectSettings.xml @@ -46713,7 +47460,16 @@ msgid "" msgstr "" #: doc/classes/ProjectSettings.xml -msgid "Message to be displayed before the backtrace when the engine crashes." +msgid "" +"Message to be displayed before the backtrace when the engine crashes. By " +"default, this message is only used in exported projects due to the editor-" +"only override applied to this setting." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Editor-only override for [member debug/settings/crash_handler/message]. Does " +"not affect exported projects in debug or release mode." msgstr "" #: doc/classes/ProjectSettings.xml @@ -46958,6 +47714,18 @@ msgstr "" #: doc/classes/ProjectSettings.xml msgid "" +"Default naming style for scene files to infer from their root nodes. " +"Possible options are:\n" +"- [code]0[/code] (Auto): Uses the scene root name as is without changing its " +"casing.\n" +"- [code]1[/code] (PascalCase): Converts the scene root name to PascalCase " +"casing.\n" +"- [code]2[/code] (snake_case): Converts the scene root name to snake_case " +"casing." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" "Search path for project-specific script templates. Godot will search for " "script templates both in the editor-specific path and in this project-" "specific path." @@ -47183,6 +47951,198 @@ msgid "Default delay for touch events. This only affects iOS devices." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 1. If left empty, the layer will " +"display as \"Layer 1\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 10. If left empty, the layer will " +"display as \"Layer 10\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 11. If left empty, the layer will " +"display as \"Layer 11\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 12. If left empty, the layer will " +"display as \"Layer 12\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 13. If left empty, the layer will " +"display as \"Layer 13\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 14. If left empty, the layer will " +"display as \"Layer 14\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 15. If left empty, the layer will " +"display as \"Layer 15\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 16. If left empty, the layer will " +"display as \"Layer 16\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 17. If left empty, the layer will " +"display as \"Layer 17\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 18. If left empty, the layer will " +"display as \"Layer 18\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 19. If left empty, the layer will " +"display as \"Layer 19\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 2. If left empty, the layer will " +"display as \"Layer 2\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 20. If left empty, the layer will " +"display as \"Layer 20\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 21. If left empty, the layer will " +"display as \"Layer 21\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 22. If left empty, the layer will " +"display as \"Layer 22\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 23. If left empty, the layer will " +"display as \"Layer 23\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 24. If left empty, the layer will " +"display as \"Layer 24\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 25. If left empty, the layer will " +"display as \"Layer 25\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 26. If left empty, the layer will " +"display as \"Layer 26\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 27. If left empty, the layer will " +"display as \"Layer 27\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 28. If left empty, the layer will " +"display as \"Layer 28\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 29. If left empty, the layer will " +"display as \"Layer 29\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 3. If left empty, the layer will " +"display as \"Layer 3\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 30. If left empty, the layer will " +"display as \"Layer 30\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 31. If left empty, the layer will " +"display as \"Layer 31\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 32. If left empty, the layer will " +"display as \"Layer 32\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 4. If left empty, the layer will " +"display as \"Layer 4\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 5. If left empty, the layer will " +"display as \"Layer 5\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 6. If left empty, the layer will " +"display as \"Layer 6\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 7. If left empty, the layer will " +"display as \"Layer 7\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 8. If left empty, the layer will " +"display as \"Layer 8\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 2D navigation layer 9. If left empty, the layer will " +"display as \"Layer 9\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Optional name for the 2D physics layer 1." msgstr "" @@ -47391,6 +48351,198 @@ msgid "Optional name for the 2D render layer 9." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 1. If left empty, the layer will " +"display as \"Layer 1\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 10. If left empty, the layer will " +"display as \"Layer 10\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 11. If left empty, the layer will " +"display as \"Layer 11\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 12. If left empty, the layer will " +"display as \"Layer 12\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 13. If left empty, the layer will " +"display as \"Layer 13\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 14. If left empty, the layer will " +"display as \"Layer 14\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 15. If left empty, the layer will " +"display as \"Layer 15\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 16. If left empty, the layer will " +"display as \"Layer 16\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 17. If left empty, the layer will " +"display as \"Layer 17\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 18. If left empty, the layer will " +"display as \"Layer 18\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 19. If left empty, the layer will " +"display as \"Layer 19\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 2. If left empty, the layer will " +"display as \"Layer 2\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 20. If left empty, the layer will " +"display as \"Layer 20\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 21. If left empty, the layer will " +"display as \"Layer 21\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 22. If left empty, the layer will " +"display as \"Layer 22\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 23. If left empty, the layer will " +"display as \"Layer 23\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 24. If left empty, the layer will " +"display as \"Layer 24\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 25. If left empty, the layer will " +"display as \"Layer 25\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 26. If left empty, the layer will " +"display as \"Layer 26\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 27. If left empty, the layer will " +"display as \"Layer 27\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 28. If left empty, the layer will " +"display as \"Layer 28\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 29. If left empty, the layer will " +"display as \"Layer 29\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 3. If left empty, the layer will " +"display as \"Layer 3\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 30. If left empty, the layer will " +"display as \"Layer 30\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 31. If left empty, the layer will " +"display as \"Layer 31\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 32. If left empty, the layer will " +"display as \"Layer 32\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 4. If left empty, the layer will " +"display as \"Layer 4\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 5. If left empty, the layer will " +"display as \"Layer 5\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 6. If left empty, the layer will " +"display as \"Layer 6\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 7. If left empty, the layer will " +"display as \"Layer 7\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 8. If left empty, the layer will " +"display as \"Layer 8\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Optional name for the 3D navigation layer 9. If left empty, the layer will " +"display as \"Layer 9\"." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Optional name for the 3D physics layer 1." msgstr "" @@ -47658,6 +48810,49 @@ msgstr "" #: doc/classes/ProjectSettings.xml msgid "" +"Default cell height for 2D navigation maps. See [method Navigation2DServer." +"map_set_cell_height].\n" +"[b]Note:[/b] Currently not implemented." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Default cell size for 2D navigation maps. See [method Navigation2DServer." +"map_set_cell_size]." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Default edge connection margin for 2D navigation maps. See [method " +"Navigation2DServer.map_set_edge_connection_margin]." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Default cell height for 3D navigation maps. See [method NavigationServer." +"map_set_cell_height]." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Default cell size for 3D navigation maps. See [method NavigationServer." +"map_set_cell_size]." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Default edge connection margin for 3D navigation maps. See [method " +"NavigationServer.map_set_edge_connection_margin]." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"Default map up vector for 3D navigation maps. See [method NavigationServer." +"map_set_up]." +msgstr "" + +#: doc/classes/ProjectSettings.xml +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." @@ -48331,20 +49526,28 @@ msgid "" "cause.\n" "The default value is a conservative one, so you are advised to tweak it " "according to the hardware you are targeting.\n" -"[b]Note:[/b] This setting is only meaningful if [code]rendering/gles3/" -"shaders/shader_compilation_mode[/code] is [b]not[/b] [code]Synchronous[/" -"code]." +"[b]Note:[/b] This setting is only meaningful if [member rendering/gles3/" +"shaders/shader_compilation_mode] is [b]not[/b] [code]Synchronous[/code]." msgstr "" #: doc/classes/ProjectSettings.xml msgid "" -"The default is a very conservative override for [code]rendering/gles3/" -"shaders/max_concurrent_compiles[/code].\n" +"The default is a very conservative override for [member rendering/gles3/" +"shaders/max_simultaneous_compiles].\n" "Depending on the specific devices you are targeting, you may want to raise " "it.\n" -"[b]Note:[/b] This setting is only meaningful if [code]rendering/gles3/" -"shaders/shader_compilation_mode[/code] is [b]not[/b] [code]Synchronous[/" -"code]." +"[b]Note:[/b] This setting is only meaningful if [member rendering/gles3/" +"shaders/shader_compilation_mode] is [b]not[/b] [code]Synchronous[/code]." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"The default is a very conservative override for [member rendering/gles3/" +"shaders/max_simultaneous_compiles].\n" +"Depending on the specific browsers you are targeting, you may want to raise " +"it.\n" +"[b]Note:[/b] This setting is only meaningful if [member rendering/gles3/" +"shaders/shader_compilation_mode] is [b]not[/b] [code]Synchronous[/code]." msgstr "" #: doc/classes/ProjectSettings.xml @@ -48352,19 +49555,28 @@ msgid "" "The maximum size, in megabytes, that the ubershader cache can grow up to. On " "startup, the least recently used entries will be deleted until the total " "size is within bounds.\n" -"[b]Note:[/b] This setting is only meaningful if [code]rendering/gles3/" -"shaders/shader_compilation_mode[/code] is set to [code]Asynchronous + Cache[/" -"code]." +"[b]Note:[/b] This setting is only meaningful if [member rendering/gles3/" +"shaders/shader_compilation_mode] is set to [code]Asynchronous + Cache[/code]." msgstr "" #: doc/classes/ProjectSettings.xml msgid "" -"An override for [code]rendering/gles3/shaders/ubershader_cache_size_mb[/" -"code], so a smaller maximum size can be configured for mobile platforms, " -"where storage space is more limited.\n" -"[b]Note:[/b] This setting is only meaningful if [code]rendering/gles3/" -"shaders/shader_compilation_mode[/code] is set to [code]Asynchronous + Cache[/" -"code]." +"An override for [member rendering/gles3/shaders/shader_cache_size_mb], so a " +"smaller maximum size can be configured for mobile platforms, where storage " +"space is more limited.\n" +"[b]Note:[/b] This setting is only meaningful if [member rendering/gles3/" +"shaders/shader_compilation_mode] is set to [code]Asynchronous + Cache[/code]." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" +"An override for [member rendering/gles3/shaders/shader_cache_size_mb], so a " +"smaller maximum size can be configured for web platforms, where storage " +"space is more limited.\n" +"[b]Note:[/b] Currently, shader caching is generally unavailable on web " +"platforms.\n" +"[b]Note:[/b] This setting is only meaningful if [member rendering/gles3/" +"shaders/shader_compilation_mode] is set to [code]Asynchronous + Cache[/code]." msgstr "" #: doc/classes/ProjectSettings.xml @@ -48396,14 +49608,22 @@ msgstr "" #: doc/classes/ProjectSettings.xml msgid "" -"An override for [code]rendering/gles3/shaders/shader_compilation_mode[/" -"code], so asynchronous compilation can be disabled for mobile.\n" +"An override for [member rendering/gles3/shaders/shader_compilation_mode], so " +"asynchronous compilation can be disabled on mobile platforms.\n" "You may want to do that since mobile GPUs generally won't support " "ubershaders due to their complexity." msgstr "" #: doc/classes/ProjectSettings.xml msgid "" +"An override for [member rendering/gles3/shaders/shader_compilation_mode], so " +"asynchronous compilation can be disabled on web platforms.\n" +"You may want to do that since certain browsers (especially on mobile " +"platforms) generally won't support ubershaders due to their complexity." +msgstr "" + +#: doc/classes/ProjectSettings.xml +msgid "" "Max buffer size for blend shapes. Any blend shape bigger than this will not " "work." msgstr "" @@ -48645,8 +49865,19 @@ msgstr "" msgid "" "Maximum anisotropic filter level used for textures with anisotropy enabled. " "Higher values will result in sharper textures when viewed from oblique " -"angles, at the cost of performance. Only power-of-two values are valid (2, " -"4, 8, 16)." +"angles, at the cost of performance. With the exception of [code]1[/code], " +"only power-of-two values are valid ([code]2[/code], [code]4[/code], [code]8[/" +"code], [code]16[/code]). A value of [code]1[/code] forcibly disables " +"anisotropic filtering, even on textures where it is enabled.\n" +"[b]Note:[/b] For performance reasons, anisotropic filtering [i]is not " +"enabled by default[/i] on textures. For this setting to have an effect, " +"anisotropic texture filtering can be enabled by selecting a texture in the " +"FileSystem dock, going to the Import dock, checking the [b]Anisotropic[/b] " +"checkbox then clicking [b]Reimport[/b]. However, anisotropic filtering is " +"rarely useful in 2D, so only enable it for textures in 2D if it makes a " +"meaningful visual difference.\n" +"[b]Note:[/b] This property is only read when the project starts. There is " +"currently no way to change this setting at run-time." msgstr "" #: doc/classes/ProjectSettings.xml @@ -48857,8 +50088,8 @@ msgstr "" #: doc/classes/ProjectSettings.xml msgid "" -"Size for shadow atlas (used for OmniLights and SpotLights). See " -"documentation." +"Size for shadow atlas (used for OmniLights and SpotLights). The value will " +"be rounded up to the nearest power of 2. See shadow mapping documentation." msgstr "" #: doc/classes/ProjectSettings.xml @@ -49160,7 +50391,6 @@ msgid "" "- If your [member grid_radius] is smaller than [code]Vector3(1, 1, 1)[/" "code], it will be rounded up to [code]Vector3(1, 1, 1)[/code]. Therefore, " "small grid radius values may lead to unwanted groupings.\n" -"[/codeblock]\n" "[b]Note:[/b] [ProximityGroup] will be removed in Godot 4.0 in favor of more " "effective and faster [VisibilityNotifier] functionality. For most use cases, " "[method Vector3.distance_to] or [method Vector3.distance_squared_to] are " @@ -51307,6 +52537,22 @@ msgid "Makes text fill width." msgstr "" #: doc/classes/RichTextLabel.xml +msgid "Aligns top of the inline image to the top of the text." +msgstr "" + +#: doc/classes/RichTextLabel.xml +msgid "Aligns center of the inline image to the center of the text." +msgstr "" + +#: doc/classes/RichTextLabel.xml +msgid "Aligns bottom of the inline image to the baseline of the text." +msgstr "" + +#: doc/classes/RichTextLabel.xml +msgid "Aligns bottom of the inline image to the bottom of the text." +msgstr "" + +#: doc/classes/RichTextLabel.xml msgid "Each list item has a number marker." msgstr "" @@ -52207,11 +53453,15 @@ msgstr "" msgid "" "Switches the portal culling system on and off.\n" "It is important to note that when portal culling is active, it is " -"responsible for [b]all[/b] the 3d culling. Some editor functionality may be " -"more difficult to use, so switching the active flag is intended to be used " -"to make sure your [Room] / [Portal] layout works within the editor.\n" +"responsible for [b]all[/b] the 3d culling. Some editor visual debugging " +"helpers may not be available when active, so switching the active flag is " +"intended to be used to ensure your [Room] / [Portal] layout works within the " +"editor.\n" "Switching to [code]active[/code] will have no effect when the [code]room " -"graph[/code] is unloaded (the rooms have not yet been converted)." +"graph[/code] is unloaded (the rooms have not yet been converted).\n" +"[b]Note:[/b] For efficiency, the portal system is designed to work with only " +"the core visual object types. In particular, only nodes derived from " +"[VisualInstance] are expected to show when the system is active." msgstr "" #: doc/classes/RoomManager.xml @@ -52648,7 +53898,9 @@ msgid "" "cannot be instantiated.\n" "[b]Note:[/b] The scene change is deferred, which means that the new scene " "node is added on the next idle frame. You won't be able to access it " -"immediately after the [method change_scene_to] call." +"immediately after the [method change_scene_to] call.\n" +"[b]Note:[/b] Passing a value of [code]null[/code] into the method will " +"unload the current scene without loading a new one." msgstr "" #: doc/classes/SceneTree.xml @@ -52792,13 +54044,19 @@ msgstr "" #: doc/classes/SceneTree.xml msgid "" "If [code]true[/code], collision shapes will be visible when running the game " -"from the editor for debugging purposes." +"from the editor for debugging purposes.\n" +"[b]Note:[/b] This property is not designed to be changed at run-time. " +"Changing the value of [member debug_collisions_hint] while the project is " +"running will not have the desired effect." msgstr "" #: doc/classes/SceneTree.xml msgid "" "If [code]true[/code], navigation polygons will be visible when running the " -"game from the editor for debugging purposes." +"game from the editor for debugging purposes.\n" +"[b]Note:[/b] This property is not designed to be changed at run-time. " +"Changing the value of [member debug_navigation_hint] while the project is " +"running will not have the desired effect." msgstr "" #: doc/classes/SceneTree.xml @@ -53044,8 +54302,8 @@ msgid "" " yield(get_tree().create_timer(1.0), \"timeout\")\n" " print(\"Timer ended.\")\n" "[/codeblock]\n" -"The timer will be automatically freed after its time elapses, so be aware " -"that any reference you might have kept to it will become invalid." +"The timer will be dereferenced after its time elapses. To preserve the " +"timer, you can keep a reference to it. See [Reference]." msgstr "" #: doc/classes/SceneTreeTimer.xml @@ -53077,24 +54335,23 @@ msgid "" "manually (i.e. by using [code]Tween.new()[/code]) are invalid. They can't be " "used for tweening values, but you can do manual interpolation with [method " "interpolate_value].\n" -"A [SceneTreeTween] animation is composed of a sequence of [Tweener]s, which " -"by default are executed one after another. You can create a sequence by " -"appending [Tweener]s to the [SceneTreeTween]. Animating something with a " -"[Tweener] is called tweening. Example tweening sequence looks like this:\n" +"A tween animation is created by adding [Tweener]s to the [SceneTreeTween] " +"object, using [method tween_property], [method tween_interval], [method " +"tween_callback] or [method tween_method]:\n" "[codeblock]\n" "var tween = get_tree().create_tween()\n" "tween.tween_property($Sprite, \"modulate\", Color.red, 1)\n" "tween.tween_property($Sprite, \"scale\", Vector2(), 1)\n" "tween.tween_callback($Sprite, \"queue_free\")\n" "[/codeblock]\n" -"This sequence will make the [code]$Sprite[/code] node turn red, then shrink " -"and finally the [method Node.queue_free] is called to remove the sprite. See " -"methods [method tween_property], [method tween_interval], [method " -"tween_callback] and [method tween_method] for more usage information.\n" +"This sequence will make the [code]$Sprite[/code] node turn red, then shrink, " +"before finally calling [method Node.queue_free] to free the sprite. " +"[Tweener]s are executed one after another by default. This behavior can be " +"changed using [method parallel] and [method set_parallel].\n" "When a [Tweener] is created with one of the [code]tween_*[/code] methods, a " "chained method call can be used to tweak the properties of this [Tweener]. " -"For example, if you want to set different transition type in the above " -"example, you can do:\n" +"For example, if you want to set a different transition type in the above " +"example, you can use [method set_trans]:\n" "[codeblock]\n" "var tween = get_tree().create_tween()\n" "tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." @@ -53103,8 +54360,9 @@ msgid "" "TRANS_BOUNCE)\n" "tween.tween_callback($Sprite, \"queue_free\")\n" "[/codeblock]\n" -"Most of the [SceneTreeTween] methods can be chained this way too. In this " -"example the [SceneTreeTween] is bound and have set a default transition:\n" +"Most of the [SceneTreeTween] methods can be chained this way too. In the " +"following example the [SceneTreeTween] is bound to the running script's node " +"and a default transition is set for its [Tweener]s:\n" "[codeblock]\n" "var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." "TRANS_ELASTIC)\n" @@ -53112,16 +54370,28 @@ msgid "" "tween.tween_property($Sprite, \"scale\", Vector2(), 1)\n" "tween.tween_callback($Sprite, \"queue_free\")\n" "[/codeblock]\n" -"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"Another interesting use for [SceneTreeTween]s is animating arbitrary sets of " "objects:\n" "[codeblock]\n" "var tween = create_tween()\n" "for sprite in get_children():\n" -" tween.tween_property(sprite, \"position\", Vector2(), 1)\n" +" tween.tween_property(sprite, \"position\", Vector2(0, 0), 1)\n" "[/codeblock]\n" "In the example above, all children of a node are moved one after another to " "position (0, 0).\n" -"Some [Tweener]s use transitions and eases. The first accepts an [enum Tween." +"You should avoid using more than one [SceneTreeTween] per object's property. " +"If two or more tweens animate one property at the same time, the last one " +"created will take priority and assign the final value. If you want to " +"interrupt and restart an animation, consider assigning the [SceneTreeTween] " +"to a variable:\n" +"[codeblock]\n" +"var tween\n" +"func animate():\n" +" if tween:\n" +" tween.kill() # Abort the previous animation.\n" +" tween = create_tween()\n" +"[/codeblock]\n" +"Some [Tweener]s use transitions and eases. The first accepts a [enum Tween." "TransitionType] constant, and refers to the way the timing of the animation " "is handled (see [url=https://easings.net/]easings.net[/url] for some " "examples). The second accepts an [enum Tween.EaseType] constant, and " @@ -53133,7 +54403,10 @@ msgid "" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] All [SceneTreeTween]s will automatically start by default. To " "prevent a [SceneTreeTween] from autostarting, you can call [method stop] " -"immediately after it was created." +"immediately after it is created.\n" +"[b]Note:[/b] [SceneTreeTween]s are processing after all of nodes in the " +"current frame, i.e. after [method Node._process] or [method Node." +"_physics_process] (depending on [enum Tween.TweenProcessMode])." msgstr "" #: doc/classes/SceneTreeTween.xml @@ -53163,21 +54436,24 @@ msgstr "" #: doc/classes/SceneTreeTween.xml msgid "" -"Processes the [SceneTreeTween] by given [code]delta[/code] value, in " -"seconds. Mostly useful when the [SceneTreeTween] is paused, for controlling " -"it manually. Can also be used to end the [SceneTreeTween] animation " -"immediately, by using [code]delta[/code] longer than the whole duration.\n" +"Processes the [SceneTreeTween] by the given [code]delta[/code] value, in " +"seconds. This is mostly useful for manual control when the [SceneTreeTween] " +"is paused. It can also be used to end the [SceneTreeTween] animation " +"immediately, by setting [code]delta[/code] longer than the whole duration of " +"the [SceneTreeTween] animation.\n" "Returns [code]true[/code] if the [SceneTreeTween] still has [Tweener]s that " "haven't finished.\n" -"[b]Note:[/b] The [SceneTreeTween] will become invalid after finished, but " -"you can call [method stop] after the step, to keep it and reset." +"[b]Note:[/b] The [SceneTreeTween] will become invalid in the next processing " +"frame after its animation finishes. Calling [method stop] after performing " +"[method custom_step] instead keeps and resets the [SceneTreeTween]." msgstr "" #: doc/classes/SceneTreeTween.xml msgid "" "Returns the total time in seconds the [SceneTreeTween] has been animating (i." -"e. time since it started, not counting pauses etc.). The time is affected by " -"[method set_speed_scale] and [method stop] will reset it to [code]0[/code].\n" +"e. the time since it started, not counting pauses etc.). The time is " +"affected by [method set_speed_scale], and [method stop] will reset it to " +"[code]0[/code].\n" "[b]Note:[/b] As it results from accumulating frame deltas, the time returned " "after the [SceneTreeTween] has finished animating will be slightly greater " "than the actual [SceneTreeTween] duration." @@ -53213,11 +54489,11 @@ msgstr "" msgid "" "Returns whether the [SceneTreeTween] is valid. A valid [SceneTreeTween] is a " "[SceneTreeTween] contained by the scene tree (i.e. the array from [method " -"SceneTree.get_processed_tweens] will contain this [SceneTreeTween]). " -"[SceneTreeTween] might become invalid when it has finished tweening or was " -"killed, also when created with [code]Tween.new()[/code]. Invalid " -"[SceneTreeTween] can't have [Tweener]s appended, because it can't animate " -"them. You can however still use [method interpolate_value]." +"SceneTree.get_processed_tweens] will contain this [SceneTreeTween]). A " +"[SceneTreeTween] might become invalid when it has finished tweening, is " +"killed, or when created with [code]SceneTreeTween.new()[/code]. Invalid " +"[SceneTreeTween]s can't have [Tweener]s appended. You can however still use " +"[method interpolate_value]." msgstr "" #: doc/classes/SceneTreeTween.xml @@ -53258,13 +54534,13 @@ msgid "" "Sets the number of times the tweening sequence will be repeated, i.e. " "[code]set_loops(2)[/code] will run the animation twice.\n" "Calling this method without arguments will make the [SceneTreeTween] run " -"infinitely, until it is either killed by [method kill] or by freeing bound " -"node, or all the animated objects have been freed (which makes further " -"animation impossible).\n" +"infinitely, until either it is killed with [method kill], the " +"[SceneTreeTween]'s bound node is freed, or all the animated objects have " +"been freed (which makes further animation impossible).\n" "[b]Warning:[/b] Make sure to always add some duration/delay when using " -"infinite loops. 0-duration looped animations (e.g. single [CallbackTweener] " -"with no delay or [PropertyTweener] with invalid node) are equivalent to " -"infinite [code]while[/code] loops and will freeze your game. If a " +"infinite loops. To prevent the game freezing, 0-duration looped animations " +"(e.g. a single [CallbackTweener] with no delay) are stopped after a small " +"number of loops, which may produce unexpected results. If a " "[SceneTreeTween]'s lifetime depends on some node, always use [method " "bind_node]." msgstr "" @@ -53328,10 +54604,10 @@ msgstr "" #: doc/classes/SceneTreeTween.xml msgid "" "Creates and appends an [IntervalTweener]. This method can be used to create " -"delays in the tween animation, as an alternative for using the delay in " -"other [Tweener]s or when there's no animation (in which case the " -"[SceneTreeTween] acts as a timer). [code]time[/code] is the length of the " -"interval, in seconds.\n" +"delays in the tween animation, as an alternative to using the delay in other " +"[Tweener]s, or when there's no animation (in which case the [SceneTreeTween] " +"acts as a timer). [code]time[/code] is the length of the interval, in " +"seconds.\n" "Example: creating an interval in code execution.\n" "[codeblock]\n" "# ... some code\n" @@ -53385,8 +54661,8 @@ msgid "" "Creates and appends a [PropertyTweener]. This method tweens a " "[code]property[/code] of an [code]object[/code] between an initial value and " "[code]final_val[/code] in a span of time equal to [code]duration[/code], in " -"seconds. The initial value by default is a value at the time the tweening of " -"the [PropertyTweener] start. For example:\n" +"seconds. The initial value by default is the property's value at the time " +"the tweening of the [PropertyTweener] starts. For example:\n" "[codeblock]\n" "var tween = create_tween()\n" "tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" @@ -53417,16 +54693,15 @@ msgid "" "Emitted when the [SceneTreeTween] has finished all tweening. Never emitted " "when the [SceneTreeTween] is set to infinite looping (see [method " "set_loops]).\n" -"[b]Note:[/b] The [SceneTreeTween] is removed (invalidated) after this signal " -"is emitted, but it doesn't happen immediately, but on the next processing " -"frame. Calling [method stop] inside the signal callback will preserve the " -"[SceneTreeTween]." +"[b]Note:[/b] The [SceneTreeTween] is removed (invalidated) in the next " +"processing frame after this signal is emitted. Calling [method stop] inside " +"the signal callback will prevent the [SceneTreeTween] from being removed." msgstr "" #: doc/classes/SceneTreeTween.xml msgid "" "Emitted when a full loop is complete (see [method set_loops]), providing the " -"loop index. This signal is not emitted after final loop, use [signal " +"loop index. This signal is not emitted after the final loop, use [signal " "finished] instead for this case." msgstr "" @@ -53434,7 +54709,7 @@ msgstr "" msgid "" "Emitted when one step of the [SceneTreeTween] is complete, providing the " "step index. One step is either a single [Tweener] or a group of [Tweener]s " -"running parallelly." +"running in parallel." msgstr "" #: doc/classes/SceneTreeTween.xml @@ -53986,7 +55261,10 @@ msgid "" msgstr "" #: doc/classes/Shape2D.xml -msgid "The shape's custom solver bias." +msgid "" +"The shape's custom solver bias. Defines how much bodies react to enforce " +"contact separation when this shape is involved.\n" +"When set to [code]0.0[/code], the default value of [code]0.3[/code] is used." msgstr "" #: doc/classes/ShortCut.xml @@ -54605,6 +55883,14 @@ msgstr "" #: doc/classes/Spatial.xml msgid "" +"Returns [code]true[/code] if the node is present in the [SceneTree], its " +"[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/Spatial.xml +msgid "" "Rotates the node so that the local forward axis (-Z) points toward the " "[code]target[/code] position.\n" "The local up axis (+Y) points as close to the [code]up[/code] vector as " @@ -54743,11 +56029,30 @@ msgid "" msgstr "" #: doc/classes/Spatial.xml +msgid "" +"Rotation part of the global transformation in radians, specified in terms of " +"YXZ-Euler angles in the format (X angle, Y angle, Z angle).\n" +"[b]Note:[/b] In the mathematical sense, rotation is a matrix and not a " +"vector. The three Euler angles, which are the three independent parameters " +"of the Euler-angle parametrization of the rotation matrix, are stored in a " +"[Vector3] data structure not because the rotation is a vector, but only " +"because [Vector3] exists as a convenient data-structure to store 3 floating-" +"point numbers. Therefore, applying affine operations on the rotation " +"\"vector\" is not meaningful." +msgstr "" + +#: doc/classes/Spatial.xml msgid "World space (global) [Transform] of this node." msgstr "" #: doc/classes/Spatial.xml msgid "" +"Global position of this node. This is equivalent to [code]global_transform." +"origin[/code]." +msgstr "" + +#: doc/classes/Spatial.xml +msgid "" "Rotation part of the local transformation in radians, specified in terms of " "YXZ-Euler angles in the format (X angle, Y angle, Z angle).\n" "[b]Note:[/b] In the mathematical sense, rotation is a matrix and not a " @@ -54766,7 +56071,12 @@ msgid "" msgstr "" #: doc/classes/Spatial.xml -msgid "Scale part of the local transformation." +msgid "" +"Scale part of the local transformation.\n" +"[b]Note:[/b] Mixed negative scales in 3D are not decomposable from the " +"transformation matrix. Due to the way scale is represented with " +"transformation matrices in Godot, the scale values will either be all " +"positive or all negative." msgstr "" #: doc/classes/Spatial.xml @@ -54915,7 +56225,9 @@ msgid "" "[b]Note:[/b] Material anisotropy should not to be confused with anisotropic " "texture filtering. Anisotropic texture filtering can be enabled by selecting " "a texture in the FileSystem dock, going to the Import dock, checking the " -"[b]Anisotropic[/b] checkbox then clicking [b]Reimport[/b]." +"[b]Anisotropic[/b] checkbox then clicking [b]Reimport[/b]. The anisotropic " +"filtering level can be changed by adjusting [member ProjectSettings." +"rendering/quality/filters/anisotropic_filter_level]." msgstr "" #: doc/classes/SpatialMaterial.xml @@ -56348,7 +57660,7 @@ msgstr "" #: doc/classes/Sprite3D.xml msgid "" "[Texture] object to draw. If [member GeometryInstance.material_override] is " -"used, this will be overridden." +"used, this will be overridden. The size information is still used." msgstr "" #: doc/classes/SpriteBase3D.xml @@ -56412,7 +57724,7 @@ msgstr "" msgid "" "Sets the render priority for the sprite. Higher priority objects will be " "sorted in front of lower priority objects.\n" -"[b]Node:[/b] This only applies if [member alpha_cut] is set to [constant " +"[b]Note:[/b] This only applies if [member alpha_cut] is set to [constant " "ALPHA_CUT_DISABLED] (default value).\n" "[b]Note:[/b] This only applies to sorting of transparent objects. This will " "not impact how transparent objects are sorted relative to opaque objects. " @@ -57207,7 +58519,31 @@ msgstr "" #: doc/classes/String.xml msgid "" "Formats the string by replacing all occurrences of [code]placeholder[/code] " -"with [code]values[/code]." +"with the elements of [code]values[/code].\n" +"[code]values[/code] can be a [Dictionary] or an [Array]. Any underscores in " +"[code]placeholder[/code] will be replaced with the corresponding keys in " +"advance. Array elements use their index as keys.\n" +"[codeblock]\n" +"# Prints: Waiting for Godot is a play by Samuel Beckett, and Godot Engine is " +"named after it.\n" +"var use_array_values = \"Waiting for {0} is a play by {1}, and {0} Engine is " +"named after it.\"\n" +"print(use_array_values.format([\"Godot\", \"Samuel Beckett\"]))\n" +"\n" +"# Prints: User 42 is Godot.\n" +"print(\"User {id} is {name}.\".format({\"id\": 42, \"name\": \"Godot\"}))\n" +"[/codeblock]\n" +"Some additional handling is performed when [code]values[/code] is an array. " +"If [code]placeholder[/code] does not contain an underscore, the elements of " +"the array will be used to replace one occurrence of the placeholder in turn; " +"If an array element is another 2-element array, it'll be interpreted as a " +"key-value pair.\n" +"[codeblock]\n" +"# Prints: User 42 is Godot.\n" +"print(\"User {} is {}.\".format([42, \"Godot\"], \"{}\"))\n" +"print(\"User {id} is {name}.\".format([[\"id\", 42], [\"name\", " +"\"Godot\"]]))\n" +"[/codeblock]" msgstr "" #: doc/classes/String.xml @@ -57397,11 +58733,11 @@ msgstr "" msgid "" "Returns [code]true[/code] if this string contains a valid integer.\n" "[codeblock]\n" -"print(\"7\".is_valid_int()) # Prints \"True\"\n" -"print(\"14.6\".is_valid_int()) # Prints \"False\"\n" -"print(\"L\".is_valid_int()) # Prints \"False\"\n" -"print(\"+3\".is_valid_int()) # Prints \"True\"\n" -"print(\"-12\".is_valid_int()) # Prints \"True\"\n" +"print(\"7\".is_valid_integer()) # Prints \"True\"\n" +"print(\"14.6\".is_valid_integer()) # Prints \"False\"\n" +"print(\"L\".is_valid_integer()) # Prints \"False\"\n" +"print(\"+3\".is_valid_integer()) # Prints \"True\"\n" +"print(\"-12\".is_valid_integer()) # Prints \"True\"\n" "[/codeblock]" msgstr "" @@ -57589,6 +58925,9 @@ msgid "" "the substrings, starting from right.\n" "The splits in the returned array are sorted in the same order as the " "original string, from left to right.\n" +"If [code]allow_empty[/code] is [code]true[/code], and there are two adjacent " +"delimiters in the string, it will add an empty string to the array of " +"substrings at this position.\n" "If [code]maxsplit[/code] is specified, it defines the number of splits to do " "from the right up to [code]maxsplit[/code]. The default value of 0 means " "that all items are split, thus giving the same result as [method split].\n" @@ -57650,6 +58989,9 @@ msgstr "" msgid "" "Splits the string by a [code]delimiter[/code] string and returns an array of " "the substrings. The [code]delimiter[/code] can be of any length.\n" +"If [code]allow_empty[/code] is [code]true[/code], and there are two adjacent " +"delimiters in the string, it will add an empty string to the array of " +"substrings at this position.\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 [code]0[/" "code] means that all items are split.\n" @@ -57672,7 +59014,10 @@ msgid "" "Splits the string in floats by using a delimiter string and returns an array " "of the substrings.\n" "For example, [code]\"1,2.5,3\"[/code] will return [code][1,2.5,3][/code] if " -"split by [code]\",\"[/code]." +"split by [code]\",\"[/code].\n" +"If [code]allow_empty[/code] is [code]true[/code], and there are two adjacent " +"delimiters in the string, it will add an empty string to the array of " +"substrings at this position." msgstr "" #: doc/classes/String.xml @@ -57804,9 +59149,11 @@ msgstr "" #: doc/classes/StyleBox.xml msgid "" -"Draws this stylebox using a [CanvasItem] with given [RID].\n" -"You can get a [RID] value using [method Object.get_instance_id] on a " -"[CanvasItem]-derived node." +"Draws this stylebox using a canvas item identified by the given [RID].\n" +"The [RID] value can either be the result of [method CanvasItem." +"get_canvas_item] called on an existing [CanvasItem]-derived node, or " +"directly from creating a canvas item in the [VisualServer] with [method " +"VisualServer.canvas_item_create]." msgstr "" #: doc/classes/StyleBox.xml @@ -58807,6 +60154,10 @@ msgid "Returns [code]true[/code] if select with right mouse button is enabled." msgstr "" #: doc/classes/Tabs.xml +msgid "Returns the button icon from the tab at index [code]tab_idx[/code]." +msgstr "" + +#: doc/classes/Tabs.xml msgid "Returns the number of hidden tabs offsetted to the left." msgstr "" @@ -58836,6 +60187,10 @@ msgid "" msgstr "" #: doc/classes/Tabs.xml +msgid "Sets the button icon from the tab at index [code]tab_idx[/code]." +msgstr "" + +#: doc/classes/Tabs.xml msgid "Sets an [code]icon[/code] for the tab at index [code]tab_idx[/code]." msgstr "" @@ -58877,7 +60232,9 @@ msgid "" msgstr "" #: doc/classes/Tabs.xml -msgid "Emitted when a tab is right-clicked." +msgid "" +"Emitted when a tab's right button is pressed. See [method " +"set_tab_button_icon]." msgstr "" #: doc/classes/Tabs.xml @@ -59277,8 +60634,8 @@ msgstr "" #: doc/classes/TextEdit.xml msgid "" -"Bookmarks the [code]line[/code] if [code]bookmark[/code] is true. Deletes " -"the bookmark if [code]bookmark[/code] is false.\n" +"Bookmarks the [code]line[/code] if [code]bookmark[/code] is [code]true[/" +"code]. Deletes the bookmark if [code]bookmark[/code] is [code]false[/code].\n" "Bookmarks are shown in the [member breakpoint_gutter]." msgstr "" @@ -59343,6 +60700,10 @@ msgid "If [code]true[/code], a right-click displays the context menu." msgstr "" #: doc/classes/TextEdit.xml +msgid "If [code]true[/code], allow drag and drop of selected text." +msgstr "" + +#: doc/classes/TextEdit.xml msgid "" "If [code]true[/code], the \"space\" character will have a visible " "representation." @@ -60223,37 +61584,38 @@ msgstr "" #: doc/classes/Theme.xml msgid "" -"Clears the [Color] at [code]name[/code] if the theme has [code]node_type[/" +"Clears the [Color] at [code]name[/code] if the theme has [code]theme_type[/" "code]." msgstr "" #: doc/classes/Theme.xml msgid "" -"Clears the constant at [code]name[/code] if the theme has [code]node_type[/" +"Clears the constant at [code]name[/code] if the theme has [code]theme_type[/" "code]." msgstr "" #: doc/classes/Theme.xml msgid "" -"Clears the [Font] at [code]name[/code] if the theme has [code]node_type[/" +"Clears the [Font] at [code]name[/code] if the theme has [code]theme_type[/" "code]." msgstr "" #: doc/classes/Theme.xml msgid "" -"Clears the icon at [code]name[/code] if the theme has [code]node_type[/code]." +"Clears the icon at [code]name[/code] if the theme has [code]theme_type[/" +"code]." msgstr "" #: doc/classes/Theme.xml msgid "" -"Clears [StyleBox] at [code]name[/code] if the theme has [code]node_type[/" +"Clears [StyleBox] at [code]name[/code] if the theme has [code]theme_type[/" "code]." msgstr "" #: doc/classes/Theme.xml msgid "" "Clears the theme item of [code]data_type[/code] at [code]name[/code] if the " -"theme has [code]node_type[/code]." +"theme has [code]theme_type[/code]." msgstr "" #: doc/classes/Theme.xml @@ -60272,14 +61634,15 @@ msgstr "" #: doc/classes/Theme.xml msgid "" -"Returns the [Color] at [code]name[/code] if the theme has [code]node_type[/" +"Returns the [Color] at [code]name[/code] if the theme has [code]theme_type[/" "code]." msgstr "" #: doc/classes/Theme.xml msgid "" "Returns all the [Color]s as a [PoolStringArray] filled with each [Color]'s " -"name, for use in [method get_color], if the theme has [code]node_type[/code]." +"name, for use in [method get_color], if the theme has [code]theme_type[/" +"code]." msgstr "" #: doc/classes/Theme.xml @@ -60290,14 +61653,14 @@ msgstr "" #: doc/classes/Theme.xml msgid "" -"Returns the constant at [code]name[/code] if the theme has [code]node_type[/" +"Returns the constant at [code]name[/code] if the theme has [code]theme_type[/" "code]." msgstr "" #: doc/classes/Theme.xml msgid "" "Returns all the constants as a [PoolStringArray] filled with each constant's " -"name, for use in [method get_constant], if the theme has [code]node_type[/" +"name, for use in [method get_constant], if the theme has [code]theme_type[/" "code]." msgstr "" @@ -60310,7 +61673,7 @@ msgstr "" #: doc/classes/Theme.xml msgid "" -"Returns the [Font] at [code]name[/code] if the theme has [code]node_type[/" +"Returns the [Font] at [code]name[/code] if the theme has [code]theme_type[/" "code]. If such item does not exist and [member default_font] is set on the " "theme, the default font will be returned." msgstr "" @@ -60318,7 +61681,7 @@ msgstr "" #: doc/classes/Theme.xml msgid "" "Returns all the [Font]s as a [PoolStringArray] filled with each [Font]'s " -"name, for use in [method get_font], if the theme has [code]node_type[/code]." +"name, for use in [method get_font], if the theme has [code]theme_type[/code]." msgstr "" #: doc/classes/Theme.xml @@ -60330,13 +61693,13 @@ msgstr "" #: doc/classes/Theme.xml msgid "" "Returns the icon [Texture] at [code]name[/code] if the theme has " -"[code]node_type[/code]." +"[code]theme_type[/code]." msgstr "" #: doc/classes/Theme.xml msgid "" "Returns all the icons as a [PoolStringArray] filled with each [Texture]'s " -"name, for use in [method get_icon], if the theme has [code]node_type[/code]." +"name, for use in [method get_icon], if the theme has [code]theme_type[/code]." msgstr "" #: doc/classes/Theme.xml @@ -60348,17 +61711,19 @@ msgstr "" #: doc/classes/Theme.xml msgid "" "Returns the [StyleBox] at [code]name[/code] if the theme has " -"[code]node_type[/code].\n" +"[code]theme_type[/code].\n" "Valid [code]name[/code]s may be found using [method get_stylebox_list]. " -"Valid [code]node_type[/code]s may be found using [method get_stylebox_types]." +"Valid [code]theme_type[/code]s may be found using [method " +"get_stylebox_types]." msgstr "" #: doc/classes/Theme.xml msgid "" "Returns all the [StyleBox]s as a [PoolStringArray] filled with each " "[StyleBox]'s name, for use in [method get_stylebox], if the theme has " -"[code]node_type[/code].\n" -"Valid [code]node_type[/code]s may be found using [method get_stylebox_types]." +"[code]theme_type[/code].\n" +"Valid [code]theme_type[/code]s may be found using [method " +"get_stylebox_types]." msgstr "" #: doc/classes/Theme.xml @@ -60371,9 +61736,9 @@ msgstr "" #: doc/classes/Theme.xml msgid "" "Returns the theme item of [code]data_type[/code] at [code]name[/code] if the " -"theme has [code]node_type[/code].\n" +"theme has [code]theme_type[/code].\n" "Valid [code]name[/code]s may be found using [method get_theme_item_list] or " -"a data type specific method. Valid [code]node_type[/code]s may be found " +"a data type specific method. Valid [code]theme_type[/code]s may be found " "using [method get_theme_item_types] or a data type specific method." msgstr "" @@ -60381,8 +61746,8 @@ msgstr "" msgid "" "Returns all the theme items of [code]data_type[/code] as a [PoolStringArray] " "filled with each theme items's name, for use in [method get_theme_item] or a " -"data type specific method, if the theme has [code]node_type[/code].\n" -"Valid [code]node_type[/code]s may be found using [method " +"data type specific method, if the theme has [code]theme_type[/code].\n" +"Valid [code]theme_type[/code]s may be found using [method " "get_theme_item_types] or a data type specific method." msgstr "" @@ -60397,7 +61762,7 @@ msgstr "" msgid "" "Returns all the theme types as a [PoolStringArray] filled with unique type " "names, for use in other [code]get_*[/code] functions of this theme.\n" -"[b]Note:[/b] [code]node_type[/code] has no effect and will be removed in " +"[b]Note:[/b] [code]theme_type[/code] has no effect and will be removed in " "future version." msgstr "" @@ -60415,15 +61780,17 @@ msgstr "" #: doc/classes/Theme.xml msgid "" "Returns [code]true[/code] if [Color] with [code]name[/code] is in " -"[code]node_type[/code].\n" -"Returns [code]false[/code] if the theme does not have [code]node_type[/code]." +"[code]theme_type[/code].\n" +"Returns [code]false[/code] if the theme does not have [code]theme_type[/" +"code]." msgstr "" #: doc/classes/Theme.xml msgid "" "Returns [code]true[/code] if constant with [code]name[/code] is in " -"[code]node_type[/code].\n" -"Returns [code]false[/code] if the theme does not have [code]node_type[/code]." +"[code]theme_type[/code].\n" +"Returns [code]false[/code] if the theme does not have [code]theme_type[/" +"code]." msgstr "" #: doc/classes/Theme.xml @@ -60435,29 +61802,33 @@ msgstr "" #: doc/classes/Theme.xml msgid "" "Returns [code]true[/code] if [Font] with [code]name[/code] is in " -"[code]node_type[/code].\n" -"Returns [code]false[/code] if the theme does not have [code]node_type[/code]." +"[code]theme_type[/code].\n" +"Returns [code]false[/code] if the theme does not have [code]theme_type[/" +"code]." msgstr "" #: doc/classes/Theme.xml msgid "" "Returns [code]true[/code] if icon [Texture] with [code]name[/code] is in " -"[code]node_type[/code].\n" -"Returns [code]false[/code] if the theme does not have [code]node_type[/code]." +"[code]theme_type[/code].\n" +"Returns [code]false[/code] if the theme does not have [code]theme_type[/" +"code]." msgstr "" #: doc/classes/Theme.xml msgid "" "Returns [code]true[/code] if [StyleBox] with [code]name[/code] is in " -"[code]node_type[/code].\n" -"Returns [code]false[/code] if the theme does not have [code]node_type[/code]." +"[code]theme_type[/code].\n" +"Returns [code]false[/code] if the theme does not have [code]theme_type[/" +"code]." msgstr "" #: doc/classes/Theme.xml msgid "" "Returns [code]true[/code] if a theme item of [code]data_type[/code] with " -"[code]name[/code] is in [code]node_type[/code].\n" -"Returns [code]false[/code] if the theme does not have [code]node_type[/code]." +"[code]name[/code] is in [code]theme_type[/code].\n" +"Returns [code]false[/code] if the theme does not have [code]theme_type[/" +"code]." msgstr "" #: doc/classes/Theme.xml @@ -60485,87 +61856,87 @@ msgstr "" #: doc/classes/Theme.xml msgid "" "Renames the [Color] at [code]old_name[/code] to [code]name[/code] if the " -"theme has [code]node_type[/code]. If [code]name[/code] is already taken, " +"theme has [code]theme_type[/code]. If [code]name[/code] is already taken, " "this method fails." msgstr "" #: doc/classes/Theme.xml msgid "" "Renames the constant at [code]old_name[/code] to [code]name[/code] if the " -"theme has [code]node_type[/code]. If [code]name[/code] is already taken, " +"theme has [code]theme_type[/code]. If [code]name[/code] is already taken, " "this method fails." msgstr "" #: doc/classes/Theme.xml msgid "" "Renames the [Font] at [code]old_name[/code] to [code]name[/code] if the " -"theme has [code]node_type[/code]. If [code]name[/code] is already taken, " +"theme has [code]theme_type[/code]. If [code]name[/code] is already taken, " "this method fails." msgstr "" #: doc/classes/Theme.xml msgid "" "Renames the icon at [code]old_name[/code] to [code]name[/code] if the theme " -"has [code]node_type[/code]. If [code]name[/code] is already taken, this " +"has [code]theme_type[/code]. If [code]name[/code] is already taken, this " "method fails." msgstr "" #: doc/classes/Theme.xml msgid "" "Renames [StyleBox] at [code]old_name[/code] to [code]name[/code] if the " -"theme has [code]node_type[/code]. If [code]name[/code] is already taken, " +"theme has [code]theme_type[/code]. If [code]name[/code] is already taken, " "this method fails." msgstr "" #: doc/classes/Theme.xml msgid "" "Renames the theme item of [code]data_type[/code] at [code]old_name[/code] to " -"[code]name[/code] if the theme has [code]node_type[/code]. If [code]name[/" +"[code]name[/code] if the theme has [code]theme_type[/code]. If [code]name[/" "code] is already taken, this method fails." msgstr "" #: doc/classes/Theme.xml msgid "" "Sets the theme's [Color] to [code]color[/code] at [code]name[/code] in " -"[code]node_type[/code].\n" -"Creates [code]node_type[/code] if the theme does not have it." +"[code]theme_type[/code].\n" +"Creates [code]theme_type[/code] if the theme does not have it." msgstr "" #: doc/classes/Theme.xml msgid "" "Sets the theme's constant to [code]constant[/code] at [code]name[/code] in " -"[code]node_type[/code].\n" -"Creates [code]node_type[/code] if the theme does not have it." +"[code]theme_type[/code].\n" +"Creates [code]theme_type[/code] if the theme does not have it." msgstr "" #: doc/classes/Theme.xml msgid "" "Sets the theme's [Font] to [code]font[/code] at [code]name[/code] in " -"[code]node_type[/code].\n" -"Creates [code]node_type[/code] if the theme does not have it." +"[code]theme_type[/code].\n" +"Creates [code]theme_type[/code] if the theme does not have it." msgstr "" #: doc/classes/Theme.xml msgid "" "Sets the theme's icon [Texture] to [code]texture[/code] at [code]name[/code] " -"in [code]node_type[/code].\n" -"Creates [code]node_type[/code] if the theme does not have it." +"in [code]theme_type[/code].\n" +"Creates [code]theme_type[/code] if the theme does not have it." msgstr "" #: doc/classes/Theme.xml msgid "" "Sets theme's [StyleBox] to [code]stylebox[/code] at [code]name[/code] in " -"[code]node_type[/code].\n" -"Creates [code]node_type[/code] if the theme does not have it." +"[code]theme_type[/code].\n" +"Creates [code]theme_type[/code] if the theme does not have it." msgstr "" #: doc/classes/Theme.xml msgid "" "Sets the theme item of [code]data_type[/code] to [code]value[/code] at " -"[code]name[/code] in [code]node_type[/code].\n" +"[code]name[/code] in [code]theme_type[/code].\n" "Does nothing if the [code]value[/code] type does not match [code]data_type[/" "code].\n" -"Creates [code]node_type[/code] if the theme does not have it." +"Creates [code]theme_type[/code] if the theme does not have it." msgstr "" #: doc/classes/Theme.xml @@ -60867,6 +62238,10 @@ msgid "" msgstr "" #: doc/classes/TileMap.xml +msgid "If [code]true[/code], this TileMap bakes a navigation region." +msgstr "" + +#: doc/classes/TileMap.xml msgid "If [code]true[/code], the cell's UVs will be clipped." msgstr "" @@ -60973,6 +62348,10 @@ msgid "The TileMap orientation mode. See [enum Mode] for possible values." msgstr "" #: doc/classes/TileMap.xml +msgid "The navigation layers the TileMap generates its navigation regions in." +msgstr "" + +#: doc/classes/TileMap.xml msgid "" "The light mask assigned to all light occluders in the TileMap. The TileSet's " "light occluders will cast shadows only from Light2D(s) that have the same " @@ -62104,7 +63483,12 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" "Returns a copy of the transform scaled by the given [code]scale[/code] " -"factor, using matrix multiplication." +"factor, using matrix multiplication.\n" +"[b]Note:[/b] Negative X scales in 2D are not decomposable from the " +"transformation matrix. Due to the way scale is represented with " +"transformation matrices in Godot, negative scales on the X axis will be " +"changed to negative scales on the Y axis and a rotation of 180 degrees when " +"decomposed." msgstr "" #: doc/classes/Transform2D.xml @@ -62259,7 +63643,18 @@ msgid "" "To iterate over all the [TreeItem] objects in a [Tree] object, use [method " "TreeItem.get_next] and [method TreeItem.get_children] after getting the root " "through [method get_root]. You can use [method Object.free] on a [TreeItem] " -"to remove it from the [Tree]." +"to remove it from the [Tree].\n" +"[b]Incremental search:[/b] Like [ItemList] and [PopupMenu], [Tree] supports " +"searching within the list while the control is focused. Press a key that " +"matches the first letter of an item's name to select the first item starting " +"with the given letter. After that point, there are two ways to perform " +"incremental search: 1) Press the same key again before the timeout duration " +"to select the next item starting with the same letter. 2) Press letter keys " +"that match the rest of the word before the timeout duration to match to " +"select the item in question directly. Both of these actions will be reset to " +"the beginning of the list if the timeout duration has passed since the last " +"keystroke was registered. You can adjust the timeout duration by changing " +"[member ProjectSettings.gui/timers/incremental_search_max_interval_msec]." msgstr "" #: doc/classes/Tree.xml @@ -62873,13 +64268,14 @@ msgstr "" #: doc/classes/TreeItem.xml msgid "" -"Returns the next TreeItem in the tree or a null object if there is none." +"Returns the next sibling TreeItem in the tree or a null object if there is " +"none." msgstr "" #: doc/classes/TreeItem.xml msgid "" -"Returns the next visible TreeItem in the tree or a null object if there is " -"none.\n" +"Returns the next visible sibling 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]." @@ -62891,13 +64287,14 @@ msgstr "" #: doc/classes/TreeItem.xml msgid "" -"Returns the previous TreeItem in the tree or a null object if there is none." +"Returns the previous sibling TreeItem in the tree or a null object if there " +"is none." msgstr "" #: doc/classes/TreeItem.xml msgid "" -"Returns the previous visible TreeItem in the tree or a null object if there " -"is none.\n" +"Returns the previous visible sibling 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]." @@ -63712,21 +65109,25 @@ msgid "Makes subsequent actions with the same name be merged into one." msgstr "" #: modules/upnp/doc_classes/UPNP.xml -msgid "UPNP network functions." +msgid "" +"Universal Plug and Play (UPnP) functions for network device discovery, " +"querying and port forwarding." msgstr "" #: modules/upnp/doc_classes/UPNP.xml msgid "" -"Provides UPNP functionality to discover [UPNPDevice]s on the local network " -"and execute commands on them, like managing port mappings (port forwarding) " -"and querying the local and remote network IP address. Note that methods on " -"this class are synchronous and block the calling thread.\n" -"To forward a specific port:\n" +"This class can be used to discover compatible [UPNPDevice]s on the local " +"network and execute commands on them, like managing port mappings (for port " +"forwarding/NAT traversal) and querying the local and remote network IP " +"address. Note that methods on this class are synchronous and block the " +"calling thread.\n" +"To forward a specific port (here [code]7777[/code], note both [method " +"discover] and [method add_port_mapping] can return errors that should be " +"checked):\n" "[codeblock]\n" -"const PORT = 7777\n" "var upnp = UPNP.new()\n" -"upnp.discover(2000, 2, \"InternetGatewayDevice\")\n" -"upnp.add_port_mapping(port)\n" +"upnp.discover()\n" +"upnp.add_port_mapping(7777)\n" "[/codeblock]\n" "To close a specific port (e.g. after you have finished using it):\n" "[codeblock]\n" @@ -63739,7 +65140,7 @@ msgid "" "or failure).\n" "signal upnp_completed(error)\n" "\n" -"# Replace this with your own server port number between 1025 and 65535.\n" +"# Replace this with your own server port number between 1024 and 65535.\n" "const SERVER_PORT = 3928\n" "var thread = null\n" "\n" @@ -63768,7 +65169,39 @@ msgid "" " # Wait for thread finish here to handle game exit while the thread is " "running.\n" " thread.wait_to_finish()\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Terminology:[/b] In the context of UPnP networking, \"gateway\" (or " +"\"internet gateway device\", short IGD) refers to network devices that allow " +"computers in the local network to access the internet (\"wide area " +"network\", WAN). These gateways are often also called \"routers\".\n" +"[b]Pitfalls:[/b]\n" +"- As explained above, these calls are blocking and shouldn't be run on the " +"main thread, especially as they can block for multiple seconds at a time. " +"Use threading!\n" +"- Networking is physical and messy. Packets get lost in transit or get " +"filtered, addresses, free ports and assigned mappings change, and devices " +"may leave or join the network at any time. Be mindful of this, be diligent " +"when checking and handling errors, and handle these gracefully if you can: " +"add clear error UI, timeouts and re-try handling.\n" +"- Port mappings may change (and be removed) at any time, and the remote/" +"external IP address of the gateway can change likewise. You should consider " +"re-querying the external IP and try to update/refresh the port mapping " +"periodically (for example, every 5 minutes and on networking failures).\n" +"- Not all devices support UPnP, and some users disable UPnP support. You " +"need to handle this (e.g. documenting and requiring the user to manually " +"forward ports, or adding alternative methods of NAT traversal, like a relay/" +"mirror server, or NAT hole punching, STUN/TURN, etc.).\n" +"- Consider what happens on mapping conflicts. Maybe multiple users on the " +"same network would like to play your game at the same time, or maybe another " +"application uses the same port. Make the port configurable, and optimally " +"choose a port automatically (re-trying with a different port on failure).\n" +"[b]Further reading:[/b] If you want to know more about UPnP (and the " +"Internet Gateway Device (IGD) and Port Control Protocol (PCP) specifically), " +"[url=https://en.wikipedia.org/wiki/Universal_Plug_and_Play]Wikipedia[/url] " +"is a good first stop, the specification can be found at the [url=https://" +"openconnectivity.org/developer/specifications/upnp-resources/upnp/]Open " +"Connectivity Foundation[/url] and Godot's implementation is based on the " +"[url=https://github.com/miniupnp/miniupnp]MiniUPnP client[/url]." msgstr "" #: modules/upnp/doc_classes/UPNP.xml @@ -63778,22 +65211,35 @@ msgstr "" #: modules/upnp/doc_classes/UPNP.xml msgid "" "Adds a mapping to forward the external [code]port[/code] (between 1 and " -"65535) on the default gateway (see [method get_gateway]) to the " -"[code]internal_port[/code] on the local machine for the given protocol " -"[code]proto[/code] (either [code]TCP[/code] or [code]UDP[/code], with UDP " -"being the default). If a port mapping for the given port and protocol " -"combination already exists on that gateway device, this method tries to " -"overwrite it. If that is not desired, you can retrieve the gateway manually " -"with [method get_gateway] and call [method add_port_mapping] on it, if any.\n" +"65535, although recommended to use port 1024 or above) on the default " +"gateway (see [method get_gateway]) to the [code]internal_port[/code] on the " +"local machine for the given protocol [code]proto[/code] (either [code]TCP[/" +"code] or [code]UDP[/code], with UDP being the default). If a port mapping " +"for the given port and protocol combination already exists on that gateway " +"device, this method tries to overwrite it. If that is not desired, you can " +"retrieve the gateway manually with [method get_gateway] and call [method " +"add_port_mapping] on it, if any. Note that forwarding a well-known port " +"(below 1024) with UPnP may fail depending on the device.\n" +"Depending on the gateway device, if a mapping for that port already exists, " +"it will either be updated or it will refuse this command due to that " +"conflict, especially if the existing mapping for that port wasn't created " +"via UPnP or points to a different network address (or device) than this " +"one.\n" "If [code]internal_port[/code] is [code]0[/code] (the default), the same port " "number is used for both the external and the internal port (the [code]port[/" "code] value).\n" -"The description ([code]desc[/code]) is shown in some router UIs and can be " -"used to point out which application added the mapping. The mapping's lease " -"duration can be limited by specifying a [code]duration[/code] (in seconds). " -"However, some routers are incompatible with one or both of these, so use " -"with caution and add fallback logic in case of errors to retry without them " -"if in doubt.\n" +"The description ([code]desc[/code]) is shown in some routers management UIs " +"and can be used to point out which application added the mapping.\n" +"The mapping's lease [code]duration[/code] can be limited by specifying a " +"duration in seconds. The default of [code]0[/code] means no duration, i.e. a " +"permanent lease and notably some devices only support these permanent " +"leases. Note that whether permanent or not, this is only a request and the " +"gateway may still decide at any point to remove the mapping (which usually " +"happens on a reboot of the gateway, when its external IP address changes, or " +"on some models when it detects a port mapping has become inactive, i.e. had " +"no traffic for multiple minutes). If not [code]0[/code] (permanent), the " +"allowed range according to spec is between [code]120[/code] (2 minutes) and " +"[code]86400[/code] seconds (24 hours).\n" "See [enum UPNPResult] for possible return values." msgstr "" @@ -63806,8 +65252,10 @@ msgid "" "Deletes the port mapping for the given port and protocol combination on the " "default gateway (see [method get_gateway]) if one exists. [code]port[/code] " "must be a valid port between 1 and 65535, [code]proto[/code] can be either " -"[code]TCP[/code] or [code]UDP[/code]. See [enum UPNPResult] for possible " -"return values." +"[code]TCP[/code] or [code]UDP[/code]. May be refused for mappings pointing " +"to addresses other than this one, for well-known ports (below 1024), or for " +"mappings not added via UPnP. See [enum UPNPResult] for possible return " +"values." msgstr "" #: modules/upnp/doc_classes/UPNP.xml @@ -64005,16 +65453,16 @@ msgid "Unknown error." msgstr "" #: modules/upnp/doc_classes/UPNPDevice.xml -msgid "UPNP device." +msgid "Universal Plug and Play (UPnP) device." msgstr "" #: modules/upnp/doc_classes/UPNPDevice.xml msgid "" -"UPNP device. See [UPNP] for UPNP discovery and utility functions. Provides " -"low-level access to UPNP control commands. Allows to manage port mappings " -"(port forwarding) and to query network information of the device (like local " -"and external IP address and status). Note that methods on this class are " -"synchronous and block the calling thread." +"Universal Plug and Play (UPnP) device. See [UPNP] for UPnP discovery and " +"utility functions. Provides low-level access to UPNP control commands. " +"Allows to manage port mappings (port forwarding) and to query network " +"information of the device (like local and external IP address and status). " +"Note that methods on this class are synchronous and block the calling thread." msgstr "" #: modules/upnp/doc_classes/UPNPDevice.xml @@ -64705,11 +66153,11 @@ msgstr "" #: doc/classes/VehicleBody.xml msgid "" "Accelerates the vehicle by applying an engine force. The vehicle is only " -"speed up if the wheels that have [member VehicleWheel.use_as_traction] set " -"to [code]true[/code] and are in contact with a surface. The [member " -"RigidBody.mass] of the vehicle has an effect on the acceleration of the " -"vehicle. For a vehicle with a mass set to 1000, try a value in the 25 - 50 " -"range for acceleration.\n" +"sped up if the wheels that have [member VehicleWheel.use_as_traction] set to " +"[code]true[/code] and are in contact with a surface. The [member RigidBody." +"mass] of the vehicle has an effect on the acceleration of the vehicle. For a " +"vehicle with a mass set to 1000, try a value in the 25 - 50 range for " +"acceleration.\n" "[b]Note:[/b] The simulation does not take the effect of gears into account, " "you will need to add logic for this if you wish to simulate gears.\n" "A negative value will result in the vehicle reversing." @@ -64789,8 +66237,8 @@ msgstr "" #: doc/classes/VehicleWheel.xml 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 RigidBody.mass] of the " +"Accelerates the wheel by applying an engine force. The wheel is only sped up " +"if it is in contact with a surface. The [member RigidBody.mass] of the " "vehicle has an effect on the acceleration of the vehicle. For a vehicle with " "a mass set to 1000, try a value in the 25 - 50 range for acceleration.\n" "[b]Note:[/b] The simulation does not take the effect of gears into account, " @@ -65393,9 +66841,10 @@ msgstr "" msgid "" "The shadow atlas' resolution (used for omni and spot lights). The value will " "be rounded up to the nearest power of 2.\n" -"[b]Note:[/b] If this is set to 0, shadows won't be visible. Since user-" -"created viewports default to a value of 0, this value must be set above 0 " -"manually." +"[b]Note:[/b] If this is set to [code]0[/code], both point [i]and[/i] " +"directional shadows won't be visible. Since user-created viewports default " +"to a value of [code]0[/code], this value must be set above [code]0[/code] " +"manually (typically at least [code]256[/code])." msgstr "" #: doc/classes/Viewport.xml @@ -65424,7 +66873,11 @@ msgid "" msgstr "" #: doc/classes/Viewport.xml -msgid "The rendering mode of viewport." +msgid "" +"The rendering mode of viewport.\n" +"[b]Note:[/b] If set to [constant USAGE_2D] or [constant " +"USAGE_2D_NO_SAMPLING], [member hdr] will have no effect when enabled since " +"HDR is not supported for 2D." msgstr "" #: doc/classes/Viewport.xml @@ -65775,11 +67228,12 @@ msgid "This enabler will stop [Particles2D] nodes." msgstr "" #: doc/classes/VisibilityEnabler2D.xml -msgid "This enabler will stop the parent's _process function." +msgid "This enabler will stop the parent's [method Node._process] function." msgstr "" #: doc/classes/VisibilityEnabler2D.xml -msgid "This enabler will stop the parent's _physics_process function." +msgid "" +"This enabler will stop the parent's [method Node._physics_process] function." msgstr "" #: doc/classes/VisibilityEnabler2D.xml @@ -65819,6 +67273,16 @@ msgid "The VisibilityNotifier's bounding box." msgstr "" #: doc/classes/VisibilityNotifier.xml +msgid "" +"In addition to checking whether a node is on screen or within a [Camera]'s " +"view, VisibilityNotifier can also optionally check whether a node is within " +"a specified maximum distance when using a [Camera] with perspective " +"projection. This is useful for throttling the performance requirements of " +"nodes that are far away.\n" +"[b]Note:[/b] This feature will be disabled if set to 0.0." +msgstr "" + +#: doc/classes/VisibilityNotifier.xml msgid "Emitted when the VisibilityNotifier enters a [Camera]'s view." msgstr "" @@ -69767,7 +71231,11 @@ msgid "Sets the viewport's global transformation matrix." msgstr "" #: doc/classes/VisualServer.xml -msgid "If [code]true[/code], the viewport renders to hdr." +msgid "" +"If [code]true[/code], the viewport renders to high dynamic range (HDR) " +"instead of standard dynamic range (SDR). See also [method " +"viewport_set_use_32_bpc_depth].\n" +"[b]Note:[/b] Only available on the GLES3 backend." msgstr "" #: doc/classes/VisualServer.xml @@ -69852,6 +71320,15 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"If [code]true[/code], allocates the viewport's framebuffer with full " +"floating-point precision (32-bit) instead of half floating-point precision " +"(16-bit). Only effective if [method viewport_set_use_32_bpc_depth] is used " +"on the same [Viewport] to set HDR to [code]true[/code].\n" +"[b]Note:[/b] Only available on the GLES3 backend." +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], the viewport uses augmented or virtual reality " "technologies. See [ARVRInterface]." msgstr "" @@ -70079,6 +71556,10 @@ msgid "Flag used to mark an index array." msgstr "" #: doc/classes/VisualServer.xml +msgid "Flag used to mark a compressed (half float) color array." +msgstr "" + +#: doc/classes/VisualServer.xml msgid "" "Used to set flags [constant ARRAY_COMPRESS_NORMAL], [constant " "ARRAY_COMPRESS_TANGENT], [constant ARRAY_COMPRESS_COLOR], [constant " @@ -70564,6 +72045,16 @@ msgid "The amount of shader rebinds in the frame." msgstr "" #: doc/classes/VisualServer.xml +msgid "" +"The peak amount of shaders that have been under compilation in the frame.\n" +"This is useful to know when asynchronous shader compilation has finished for " +"the current shaders on screen.\n" +"[b]Note:[/b] For complete certainty, only assume there are no outstanding " +"compilations when this value is zero for at least two frames in a row.\n" +"Unimplemented in the GLES2 rendering backend, always returns 0." +msgstr "" + +#: doc/classes/VisualServer.xml msgid "The amount of surface changes in the frame." msgstr "" @@ -72605,7 +74096,9 @@ msgid "" msgstr "" #: doc/classes/WeakRef.xml -msgid "Returns the [Object] this weakref is referring to." +msgid "" +"Returns the [Object] this weakref is referring to. Returns [code]null[/code] " +"if that object no longer exists." msgstr "" #: modules/webrtc/doc_classes/WebRTCDataChannel.xml @@ -73760,8 +75253,8 @@ msgstr "" #: doc/classes/World.xml msgid "" "Class that has everything pertaining to a world. A physics space, a visual " -"scenario and a sound space. Spatial nodes register their resources into the " -"current world." +"scenario, a navigation map and a sound space. Spatial nodes register their " +"resources into the current world." msgstr "" #: doc/classes/World.xml @@ -73776,8 +75269,13 @@ msgstr "" #: doc/classes/World.xml msgid "" -"The World's fallback_environment will be used if the World's [Environment] " -"fails or is missing." +"The World's fallback environment will be used if [member environment] fails " +"or is missing." +msgstr "" + +#: doc/classes/World.xml +msgid "" +"The [RID] of this world's navigation map. Used by the [NavigationServer]." msgstr "" #: doc/classes/World.xml @@ -73795,8 +75293,8 @@ msgstr "" #: doc/classes/World2D.xml msgid "" "Class that has everything pertaining to a 2D world. A physics space, a " -"visual scenario and a sound space. 2D nodes register their resources into " -"the current 2D world." +"visual scenario, a navigation map and a sound space. 2D nodes register their " +"resources into the current 2D world." msgstr "" #: doc/classes/World2D.xml @@ -73814,6 +75312,11 @@ msgstr "" #: doc/classes/World2D.xml msgid "" +"The [RID] of this world's navigation map. Used by the [Navigation2DServer]." +msgstr "" + +#: doc/classes/World2D.xml +msgid "" "The [RID] of this world's physics space resource. Used by the " "[Physics2DServer] for 2D physics, treating it as both a space and an area." msgstr "" |