diff options
Diffstat (limited to 'doc/translations/ne.po')
| -rw-r--r-- | doc/translations/ne.po | 776 |
1 files changed, 557 insertions, 219 deletions
diff --git a/doc/translations/ne.po b/doc/translations/ne.po index 24062d3cff..a4a37692f7 100644 --- a/doc/translations/ne.po +++ b/doc/translations/ne.po @@ -538,8 +538,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" @@ -549,7 +550,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 @@ -603,7 +605,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 " @@ -615,7 +618,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 @@ -845,7 +849,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 @@ -1023,10 +1034,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 @@ -4837,19 +4853,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 @@ -4870,21 +4888,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 @@ -4893,9 +4915,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" @@ -5547,9 +5570,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" @@ -5723,8 +5746,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 @@ -7682,8 +7705,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 "" @@ -8726,8 +8749,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 "" @@ -8778,10 +8802,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. When capturing audio data from a " +"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." +"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 @@ -9023,12 +9057,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 "" @@ -9574,7 +9602,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 @@ -9735,12 +9768,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 @@ -9888,6 +9925,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 "" @@ -9963,7 +10015,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 @@ -10022,7 +10080,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 " @@ -10128,7 +10189,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 @@ -11694,7 +11761,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 @@ -11739,7 +11806,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 @@ -11782,7 +11854,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 @@ -11810,9 +11884,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 @@ -12309,13 +12383,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" @@ -12341,8 +12416,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 @@ -12655,12 +12732,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 @@ -12705,8 +12782,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 @@ -12754,8 +12833,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 @@ -12817,7 +12899,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 @@ -12942,7 +13024,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 "" @@ -15938,7 +16023,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 @@ -18663,7 +18750,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 @@ -18812,16 +18901,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 @@ -18966,18 +19056,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 "" @@ -20150,7 +20228,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 @@ -23536,7 +23614,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 "" @@ -23881,8 +23959,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 @@ -24502,7 +24584,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 @@ -25367,7 +25451,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 "" @@ -26086,10 +26170,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 @@ -27496,8 +27583,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, " @@ -28408,13 +28495,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 @@ -29796,11 +29884,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 @@ -29828,9 +29919,9 @@ msgid "" "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]disabled[/i] by default for backward " -"compatibility reasons. It is however recommended to enable it for games " -"which don't require very reactive input, as this will decrease CPU usage." +"[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 @@ -30404,10 +30495,13 @@ 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 can be emitted multiple times per frame " -"rendered, allowing for precise input reporting, at the expense of CPU usage. " -"You can set [member Input.use_accumulated_input] to [code]true[/code] to let " -"multiple events merge into a single emitted event per frame.\n" +"[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 " @@ -30420,6 +30514,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 "" @@ -30636,7 +30736,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 @@ -30648,6 +30752,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 " @@ -32453,7 +32567,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. " @@ -32469,7 +32583,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. " @@ -32499,7 +32613,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 "" @@ -33005,14 +33119,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 @@ -33020,21 +33134,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 @@ -34611,9 +34725,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 @@ -35072,7 +35186,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 @@ -36184,7 +36300,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 @@ -36599,7 +36715,7 @@ msgid "" "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 " +"[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." @@ -36860,7 +36976,7 @@ msgid "" "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 " +"[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." @@ -36974,6 +37090,64 @@ msgstr "" 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." @@ -39671,7 +39845,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 @@ -39683,7 +39863,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 @@ -40616,7 +40797,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 @@ -45287,6 +45470,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 " @@ -45973,7 +46163,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 @@ -46212,7 +46404,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 @@ -46941,7 +47135,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 @@ -49622,8 +49820,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 @@ -53640,7 +53849,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 @@ -53784,13 +53995,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 @@ -54211,7 +54428,8 @@ msgid "" "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." +"[SceneTreeTween]s can't have [Tweener]s appended. You can however still use " +"[method interpolate_value]." msgstr "" #: doc/classes/SceneTreeTween.xml @@ -54251,15 +54469,16 @@ msgstr "" 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 [Tween] run infinitely, " -"until either it is killed with [method kill], the [Tween]'s bound node is " -"freed, or all the animated objects have been freed (which makes further " -"animation impossible).\n" +"Calling this method without arguments will make the [SceneTreeTween] run " +"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. 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 [Tween]'s " -"lifetime depends on some node, always use [method bind_node]." +"number of loops, which may produce unexpected results. If a " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." msgstr "" #: doc/classes/SceneTreeTween.xml @@ -54978,7 +55197,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 @@ -55597,6 +55819,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 " @@ -55735,11 +55965,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 " @@ -55912,7 +56161,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 @@ -57345,7 +57596,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 @@ -57409,7 +57660,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. " @@ -58610,6 +58861,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" @@ -58671,6 +58925,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" @@ -58693,7 +58950,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 @@ -59830,6 +60090,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 "" @@ -59859,6 +60123,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 "" @@ -59900,7 +60168,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 @@ -60300,8 +60570,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 "" @@ -63924,13 +64194,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]." @@ -63942,13 +64213,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]." @@ -64763,21 +65035,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" @@ -64790,7 +65066,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" @@ -64819,7 +65095,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 @@ -64829,22 +65137,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 "" @@ -64857,8 +65178,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 @@ -65056,16 +65379,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 @@ -65756,11 +66079,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." @@ -65840,8 +66163,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, " @@ -70834,7 +71157,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 @@ -70919,6 +71246,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 "" @@ -73682,7 +74018,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 |