diff options
Diffstat (limited to 'doc/translations')
39 files changed, 45280 insertions, 5056 deletions
diff --git a/doc/translations/ar.po b/doc/translations/ar.po index e6aba3a951..41f1f50d6b 100644 --- a/doc/translations/ar.po +++ b/doc/translations/ar.po @@ -712,7 +712,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -7089,6 +7095,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8231,6 +8249,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10930,7 +10958,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -11000,8 +11028,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11591,6 +11619,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12349,7 +12400,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12361,21 +12421,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12391,7 +12471,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12403,7 +12488,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12417,7 +12507,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12426,7 +12522,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12436,7 +12538,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12454,10 +12562,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15974,9 +16088,11 @@ msgid "" msgstr "" #: doc/classes/Control.xml -#, fuzzy -msgid "Returns [code]true[/code] if drag operation is successful." -msgstr "يُرجع جيب التمام \"cosine \" لقيمة المَعلم." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." +msgstr "" #: doc/classes/Control.xml msgid "" @@ -19609,9 +19725,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22804,7 +22922,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23499,33 +23617,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28266,34 +28394,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29586,8 +29722,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30358,7 +30496,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30500,6 +30643,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32541,7 +32697,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32585,8 +32742,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34426,6 +34592,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35754,9 +35955,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35931,6 +36143,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36715,7 +36935,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36756,6 +36976,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37430,7 +37659,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37453,6 +37682,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37538,11 +37776,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -38125,7 +38370,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38156,7 +38401,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39239,6 +39484,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39723,6 +39978,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39805,6 +40069,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -44017,7 +44289,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -44092,12 +44372,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44143,6 +44423,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44210,13 +44500,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44247,13 +44537,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44283,13 +44573,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44315,12 +44605,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44350,12 +44640,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44384,12 +44674,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46037,6 +46327,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48335,8 +48635,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -50129,14 +50616,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50181,8 +50669,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51782,6 +52271,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51806,6 +52299,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -52160,6 +52659,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56685,7 +57582,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56769,28 +57666,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56809,6 +57725,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -60062,7 +60993,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60192,14 +61125,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60594,20 +61531,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60713,13 +61651,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60950,7 +61889,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61787,7 +62726,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -62064,6 +63005,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62856,7 +63813,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -63017,8 +63974,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -63116,7 +64073,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63199,8 +64156,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63796,7 +64753,9 @@ msgstr "يُرجع جيب التمام \"cosine \" لقيمة المَعلم." #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68258,6 +69217,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69307,23 +70292,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/ca.po b/doc/translations/ca.po index 94543dd2b3..eb82d850ee 100644 --- a/doc/translations/ca.po +++ b/doc/translations/ca.po @@ -748,7 +748,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -7110,6 +7116,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8252,6 +8270,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10949,7 +10977,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -11019,8 +11047,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11610,6 +11638,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12364,7 +12415,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12376,21 +12436,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12406,7 +12486,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12418,7 +12503,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12432,7 +12522,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12441,7 +12537,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12451,7 +12553,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12469,10 +12577,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15989,7 +16103,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19613,9 +19730,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22807,7 +22926,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23502,33 +23621,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28265,34 +28394,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29583,8 +29720,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30354,7 +30493,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30496,6 +30640,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32536,7 +32693,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32580,8 +32738,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34419,6 +34586,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35726,9 +35928,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35903,6 +36116,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36683,7 +36904,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36724,6 +36945,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37398,7 +37628,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37421,6 +37651,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37506,11 +37745,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -38093,7 +38339,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38124,7 +38370,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39202,6 +39448,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39683,6 +39939,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39765,6 +40030,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -43958,7 +44231,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -44033,12 +44314,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44084,6 +44365,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44151,13 +44442,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44188,13 +44479,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44224,13 +44515,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44256,12 +44547,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44291,12 +44582,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44325,12 +44616,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45976,6 +46267,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48274,8 +48575,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -50067,14 +50555,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50118,8 +50607,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51719,6 +52209,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51743,6 +52237,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -52097,6 +52597,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56620,7 +57518,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56704,28 +57602,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56744,6 +57661,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -59988,7 +60920,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60118,14 +61052,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60520,20 +61458,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60639,13 +61578,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60875,7 +61815,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61707,7 +62647,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -61984,6 +62926,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62776,7 +63734,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -62936,8 +63894,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -63035,7 +63993,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63117,8 +64075,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63710,7 +64668,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68155,6 +69115,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69204,23 +70190,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/classes.pot b/doc/translations/classes.pot index dc9d16da28..067a49c93d 100644 --- a/doc/translations/classes.pot +++ b/doc/translations/classes.pot @@ -628,7 +628,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -6990,6 +6996,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8132,6 +8150,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10829,7 +10857,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -10899,8 +10927,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11490,6 +11518,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12244,7 +12295,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12256,21 +12316,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12286,7 +12366,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12298,7 +12383,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12312,7 +12402,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12321,7 +12417,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12331,7 +12433,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12349,10 +12457,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15869,7 +15983,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19493,9 +19610,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22687,7 +22806,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23379,33 +23498,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28142,34 +28271,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29460,8 +29597,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30231,7 +30370,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30373,6 +30517,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32413,7 +32570,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32457,8 +32615,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34296,6 +34463,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35603,9 +35805,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35780,6 +35993,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36560,7 +36781,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36601,6 +36822,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37275,7 +37505,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37298,6 +37528,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37383,11 +37622,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -37970,7 +38216,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38001,7 +38247,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39079,6 +39325,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39560,6 +39816,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39642,6 +39907,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -43835,7 +44108,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -43910,12 +44191,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -43961,6 +44242,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44028,13 +44319,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44065,13 +44356,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44101,13 +44392,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44133,12 +44424,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44168,12 +44459,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44202,12 +44493,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45853,6 +46144,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48151,8 +48452,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -49944,14 +50432,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -49995,8 +50484,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51596,6 +52086,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51620,6 +52114,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -51974,6 +52474,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56497,7 +57395,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56581,28 +57479,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56621,6 +57538,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -59865,7 +60797,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -59995,14 +60929,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60397,20 +61335,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60516,13 +61455,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60752,7 +61692,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61584,7 +62524,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -61861,6 +62803,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62653,7 +63611,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -62813,8 +63771,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -62912,7 +63870,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -62994,8 +63952,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63587,7 +64545,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68032,6 +68992,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69081,23 +70067,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/cs.po b/doc/translations/cs.po index efd9b002f9..6315c89af2 100644 --- a/doc/translations/cs.po +++ b/doc/translations/cs.po @@ -917,7 +917,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" "Lineárně interpoluje mezi dvěma uhlý (v radiánech) pomocí normalizované " "hodnoty.\n" @@ -7498,6 +7504,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8641,6 +8659,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -11346,7 +11374,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -11416,8 +11444,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -12008,6 +12036,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12769,7 +12820,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12781,21 +12841,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12811,7 +12891,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12823,7 +12908,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12837,7 +12927,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12846,7 +12942,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12856,7 +12958,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12874,10 +12982,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -16424,9 +16538,11 @@ msgstr "" "přiblížně rovny." #: doc/classes/Control.xml -#, fuzzy -msgid "Returns [code]true[/code] if drag operation is successful." -msgstr "Vrátí [code] true [/code], pokud je vektor normalizován, jinak false." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." +msgstr "" #: doc/classes/Control.xml msgid "" @@ -20060,9 +20176,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -23261,7 +23379,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23956,33 +24074,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28727,34 +28855,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -30048,8 +30184,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30820,7 +30958,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30962,6 +31105,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -33004,7 +33160,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -33048,8 +33205,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34891,6 +35057,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -36223,9 +36424,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -36400,6 +36612,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -37184,7 +37404,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37225,6 +37445,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37899,7 +38128,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37922,6 +38151,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -38007,11 +38245,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -38594,7 +38839,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38625,7 +38870,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39712,6 +39957,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -40198,6 +40453,15 @@ msgid "" msgstr "Vrátí [code] true [/code], pokud je vektor normalizován, jinak false." #: doc/classes/OS.xml +msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml #, fuzzy msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " @@ -40283,6 +40547,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -44497,7 +44769,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -44572,12 +44852,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44623,6 +44903,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44690,13 +44980,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44727,13 +45017,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44763,13 +45053,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44795,12 +45085,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44831,12 +45121,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44865,12 +45155,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46519,6 +46809,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48817,8 +49117,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -50618,14 +51105,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50670,8 +51158,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -52271,6 +52760,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -52295,6 +52788,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -52650,6 +53149,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -57183,7 +58080,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -57267,28 +58164,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -57307,6 +58223,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -60589,7 +61520,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60722,14 +61655,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -61124,20 +62061,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -61243,13 +62181,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -61480,7 +62419,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -62319,7 +63258,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -62596,6 +63537,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -63388,7 +64345,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -63551,8 +64508,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -63652,7 +64609,7 @@ msgstr "Vektor používaný pro 3D matematiku." #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63736,8 +64693,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -64334,7 +65291,9 @@ msgstr "Vrátí [code] true [/code], pokud je vektor normalizován, jinak false. #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68801,6 +69760,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69851,23 +70836,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/de.po b/doc/translations/de.po index bc8315eb89..eb6e3b1886 100644 --- a/doc/translations/de.po +++ b/doc/translations/de.po @@ -4,7 +4,7 @@ # This file is distributed under the same license as the Godot source code. # # Jaigskim <filzstift112@gmail.com>, 2020. -# So Wieso <sowieso@dukun.de>, 2020. +# So Wieso <sowieso@dukun.de>, 2020, 2022. # artism90 <artism90@googlemail.com>, 2020. # HugeGameArt <hugegameartgd@gmail.com>, 2020. # Günther Bohn <ciscouser@gmx.de>, 2020, 2021. @@ -45,12 +45,13 @@ # Leon Marz <main@lmarz.org>, 2022. # Robin <robin.janzen@gmx.net>, 2022. # Andreas <self@andreasbresser.de>, 2022. +# Christian Packenius <christian@packenius.com>, 2022. msgid "" msgstr "" "Project-Id-Version: Godot Engine class reference\n" "Report-Msgid-Bugs-To: https://github.com/godotengine/godot\n" -"PO-Revision-Date: 2022-03-27 01:06+0000\n" -"Last-Translator: Andreas <self@andreasbresser.de>\n" +"PO-Revision-Date: 2022-04-30 17:12+0000\n" +"Last-Translator: Christian Packenius <christian@packenius.com>\n" "Language-Team: German <https://hosted.weblate.org/projects/godot-engine/" "godot-class-reference/de/>\n" "Language: de\n" @@ -58,7 +59,7 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8-bit\n" "Plural-Forms: nplurals=2; plural=n != 1;\n" -"X-Generator: Weblate 4.12-dev\n" +"X-Generator: Weblate 4.12.1\n" #: doc/tools/make_rst.py msgid "Description" @@ -86,7 +87,7 @@ msgstr "Signale" #: doc/tools/make_rst.py msgid "Enumerations" -msgstr "Aufzählungen" +msgstr "Aufzählungstypen" #: doc/tools/make_rst.py msgid "Constants" @@ -1013,7 +1014,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" "Interpoliert einen normalisierten Wert zwischen zwei Winkeln (in Radiant).\n" "Vergleichbar mit [method lerp], interpoliert aber korrekt, sobald sich der " @@ -9027,6 +9034,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -10174,6 +10193,17 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +#, fuzzy +msgid "GUI containers" +msgstr "Tabulierter Container." + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -12886,11 +12916,14 @@ msgid "" msgstr "" #: doc/classes/Basis.xml +#, fuzzy msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" +"Konstruiert ein Quaternion, das sich um die angegebene Achse um den " +"angegebenen Winkel dreht. Die Achse muss ein normalisierter Vektor sein." #: doc/classes/Basis.xml msgid "Constructs a basis matrix from 3 axis vectors (matrix columns)." @@ -12961,10 +12994,13 @@ msgid "" msgstr "" #: doc/classes/Basis.xml +#, fuzzy msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" +"Dreht diesen Vektor um eine gegebene Achse um [code]phi[/code] Bogenmaß. Die " +"Achse muss ein normierter Vektor sein." #: doc/classes/Basis.xml msgid "" @@ -13557,6 +13593,29 @@ msgstr "" "Wird ausgegeben, wenn der Dialog akzeptiert wird, d. h. die Schaltfläche OK " "gedrückt wird." +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -14322,7 +14381,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -14334,21 +14402,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -14364,7 +14452,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -14376,7 +14469,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -14390,7 +14488,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -14399,7 +14503,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -14409,7 +14519,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -14427,10 +14543,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -18110,9 +18232,11 @@ msgstr "" "code]angegeben ist, existiert, ansonsten [code]false[/code]." #: doc/classes/Control.xml -#, fuzzy -msgid "Returns [code]true[/code] if drag operation is successful." -msgstr "Gibt [code]true[/code] zurück, wenn eine Animation abgespielt wird." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." +msgstr "" #: doc/classes/Control.xml msgid "" @@ -21760,9 +21884,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -24976,7 +25102,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -25676,33 +25802,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -30490,34 +30626,42 @@ msgstr "Importieren von Bildern" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -31819,8 +31963,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -32591,7 +32737,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -32737,6 +32888,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -34785,7 +34949,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -34829,8 +34994,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -36673,6 +36847,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -38029,9 +38238,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -38210,6 +38430,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml #, fuzzy msgid "Server interface for low-level 3D navigation access." @@ -38996,7 +39224,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -39037,6 +39265,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -39714,7 +39951,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -39737,6 +39974,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -39822,11 +40068,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -40409,7 +40662,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -40440,7 +40693,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -41527,6 +41780,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -42021,6 +42284,15 @@ msgstr "" "ansonsten [code]false[/code]." #: doc/classes/OS.xml +msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml #, fuzzy msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " @@ -42110,6 +42382,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -46340,7 +46620,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -46416,13 +46704,13 @@ msgstr "" #: doc/classes/PoolByteArray.xml #, fuzzy -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "Ein gepacktes [Array] aus [Vector2]-Elementen." #: doc/classes/PoolByteArray.xml #, fuzzy msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46476,6 +46764,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -46550,14 +46848,14 @@ msgstr "" #: doc/classes/PoolColorArray.xml #, fuzzy -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "Ein gepacktes [Array] aus [Vector2]-Elementen." #: doc/classes/PoolColorArray.xml #, fuzzy msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" "Ein [Array] das nur für den Zweck [Vector2]-Elemente zu beinhalten entworfen " @@ -46600,13 +46898,13 @@ msgstr "" #: doc/classes/PoolIntArray.xml #, fuzzy -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "Ein gepacktes [Array] aus [Vector2]-Elementen." #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -46645,13 +46943,13 @@ msgstr "Ändert den [Vector2] am übergeben Index." #: doc/classes/PoolRealArray.xml #, fuzzy -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "Ein gepacktes [Array] aus [Vector2]-Elementen." #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -46682,13 +46980,13 @@ msgstr "" #: doc/classes/PoolStringArray.xml #, fuzzy -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "Ein gepacktes [Array] aus [Vector2]-Elementen." #: doc/classes/PoolStringArray.xml #, fuzzy msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46730,13 +47028,13 @@ msgstr "" #: doc/classes/PoolVector2Array.xml #, fuzzy -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "Ein gepacktes [Array] aus [Vector2]-Elementen." #: doc/classes/PoolVector2Array.xml #, fuzzy msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46774,13 +47072,13 @@ msgstr "Ändert den [Vector2] am übergeben Index." #: doc/classes/PoolVector3Array.xml #, fuzzy -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "Ein gepacktes [Array] aus [Vector3]-Elementen." #: doc/classes/PoolVector3Array.xml #, fuzzy msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -48454,6 +48752,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -50752,8 +51060,197 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +#, fuzzy +msgid "Interpolates an [Object]'s property over time." +msgstr "" +"Animiert die Eigenschaften eines Knotens im Laufe der Zeit reibungslos." + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -52590,14 +53087,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -52642,8 +53140,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -54247,6 +54746,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -54271,6 +54774,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -54630,6 +55139,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -59219,7 +60126,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -59303,28 +60210,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -59343,6 +60269,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -62666,7 +63607,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -62799,14 +63742,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -63200,21 +64147,25 @@ msgid "" msgstr "" #: doc/classes/Transform.xml +#, fuzzy msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" +"Dreht diesen Vektor um eine gegebene Achse um [code]phi[/code] Bogenmaß. Die " +"Achse muss ein normierter Vektor sein." #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -63320,13 +64271,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -63562,7 +64514,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -64419,7 +65371,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" "Tweens sind nützlich für Animationen, bei denen eine numerische Eigenschaft " "über einen Bereich von Werten interpoliert werden muss. Der Name [i]tween[/" @@ -64734,6 +65688,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -65537,7 +66507,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -65743,9 +66713,10 @@ msgstr "" "Normalenvektors zurück." #: doc/classes/Vector2.xml +#, fuzzy msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" "Gibt den Vektor rotiert um [code]phi[/code] rad zurück. Siehe auch [method " "@GDScript.deg2rad]." @@ -65869,13 +66840,17 @@ msgid "Vector used for 3D math." msgstr "" #: doc/classes/Vector3.xml +#, fuzzy msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." msgstr "" +"Ein Struktur aus zwei Elementen die genutzt werden kann um Positionen im 2D-" +"Raum oder Paare aus zwei Zahlen darzustellen.\n" +"Es werden Fließkommazahlen als Koordinaten benutzt." #: doc/classes/Vector3.xml #, fuzzy @@ -65965,9 +66940,10 @@ msgstr "" "Normalenvektors zurück." #: doc/classes/Vector3.xml +#, fuzzy msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" "Dreht diesen Vektor um eine gegebene Achse um [code]phi[/code] Bogenmaß. Die " "Achse muss ein normierter Vektor sein." @@ -66566,7 +67542,9 @@ msgstr "Gibt [code]true[/code] zurück falls das Array leer ist." #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -71101,6 +72079,32 @@ msgstr "Der Zeichen-Offset der Textur." #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -72158,23 +73162,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/el.po b/doc/translations/el.po index 98bb60e4a3..ec174486ec 100644 --- a/doc/translations/el.po +++ b/doc/translations/el.po @@ -9,12 +9,13 @@ # Michalis <michalisntovas@yahoo.gr>, 2021. # leriaz <leriaz@live.com>, 2021. # thealexanton <greektechmania@gmail.com>, 2022. +# JessicaLukatz <jessicalukatz32038@gmail.com>, 2022. msgid "" msgstr "" "Project-Id-Version: Godot Engine class reference\n" "Report-Msgid-Bugs-To: https://github.com/godotengine/godot\n" -"PO-Revision-Date: 2022-01-24 02:06+0000\n" -"Last-Translator: thealexanton <greektechmania@gmail.com>\n" +"PO-Revision-Date: 2022-05-03 07:13+0000\n" +"Last-Translator: JessicaLukatz <jessicalukatz32038@gmail.com>\n" "Language-Team: Greek <https://hosted.weblate.org/projects/godot-engine/godot-" "class-reference/el/>\n" "Language: el\n" @@ -22,7 +23,7 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8-bit\n" "Plural-Forms: nplurals=2; plural=n != 1;\n" -"X-Generator: Weblate 4.11-dev\n" +"X-Generator: Weblate 4.12.1\n" #: doc/tools/make_rst.py msgid "Description" @@ -30,7 +31,7 @@ msgstr "Περιγραφή" #: doc/tools/make_rst.py msgid "Tutorials" -msgstr "Εγχειρίδια" +msgstr "Φροντιστήρια" #: doc/tools/make_rst.py msgid "Properties" @@ -38,7 +39,7 @@ msgstr "Ιδιότητες" #: doc/tools/make_rst.py msgid "Methods" -msgstr "Συναρτήσεις" +msgstr "Μέθοδοι" #: doc/tools/make_rst.py msgid "Theme Properties" @@ -46,15 +47,15 @@ msgstr "Ιδιότητες θέματος" #: doc/tools/make_rst.py msgid "Signals" -msgstr "Σήματα" +msgstr "σήματα" #: doc/tools/make_rst.py msgid "Enumerations" -msgstr "Απαριθμήσεις" +msgstr "απαρίθμηση" #: doc/tools/make_rst.py msgid "Constants" -msgstr "Σταθερές" +msgstr "σταθερές" #: doc/tools/make_rst.py msgid "Property Descriptions" @@ -87,7 +88,7 @@ msgstr "Προεπιλεγμένο" #: doc/tools/make_rst.py msgid "Setter" -msgstr "" +msgstr "Θέτων" #: doc/tools/make_rst.py msgid "value" @@ -95,7 +96,7 @@ msgstr "τιμή" #: doc/tools/make_rst.py msgid "Getter" -msgstr "" +msgstr "λήπτης" #: doc/tools/make_rst.py msgid "" @@ -642,7 +643,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -7006,6 +7013,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8148,6 +8167,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10847,7 +10876,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -10917,8 +10946,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11508,6 +11537,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12267,7 +12319,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12279,21 +12340,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12309,7 +12390,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12321,7 +12407,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12335,7 +12426,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12344,7 +12441,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12354,7 +12457,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12372,10 +12481,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15892,9 +16007,11 @@ msgid "" msgstr "" #: doc/classes/Control.xml -#, fuzzy -msgid "Returns [code]true[/code] if drag operation is successful." -msgstr "Επιστρέφει το συνημίτονο της παραμέτρου." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." +msgstr "" #: doc/classes/Control.xml msgid "" @@ -19527,9 +19644,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22722,7 +22841,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23417,33 +23536,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28184,34 +28313,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29504,8 +29641,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30276,7 +30415,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30418,6 +30562,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32459,7 +32616,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32503,8 +32661,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34344,6 +34511,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35666,9 +35868,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35843,6 +36056,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36475,7 +36696,7 @@ msgstr "" #: doc/classes/Node.xml msgid "Nodes and Scenes" -msgstr "" +msgstr "Κόμβοι και Σκηνές" #: doc/classes/Node.xml msgid "All Demos" @@ -36627,7 +36848,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36668,6 +36889,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37342,7 +37572,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37365,6 +37595,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37450,11 +37689,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -38037,7 +38283,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38068,7 +38314,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39151,6 +39397,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39635,6 +39891,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39717,6 +39982,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -43916,7 +44189,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -43991,12 +44272,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44042,6 +44323,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44109,13 +44400,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44146,13 +44437,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44182,13 +44473,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44214,12 +44505,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44249,12 +44540,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44283,12 +44574,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45936,6 +46227,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48234,8 +48535,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -50028,14 +50516,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50080,8 +50569,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51681,6 +52171,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51705,6 +52199,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -52059,6 +52559,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56584,7 +57482,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56668,28 +57566,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56708,6 +57625,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -59961,7 +60893,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60091,14 +61025,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60493,20 +61431,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60612,13 +61551,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60849,7 +61789,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61686,7 +62626,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -61963,6 +62905,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62755,7 +63713,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -62916,8 +63874,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -63015,7 +63973,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63098,8 +64056,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63695,7 +64653,9 @@ msgstr "Επιστρέφει το συνημίτονο της παραμέτρο #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68157,6 +69117,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69206,23 +70192,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/es.po b/doc/translations/es.po index 4279e2136f..caef4dfcef 100644 --- a/doc/translations/es.po +++ b/doc/translations/es.po @@ -1008,7 +1008,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" "Interpola linealmente entre dos ángulos (en radianes) por un valor " "normalizado.\n" @@ -9158,6 +9164,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -10788,6 +10806,17 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +#, fuzzy +msgid "GUI containers" +msgstr "Contenedor con pestaña." + #: doc/classes/AspectRatioContainer.xml #, fuzzy msgid "Specifies the horizontal relative position of child controls." @@ -14185,9 +14214,10 @@ msgstr "" "cuaternio en lugar de los ángulos de Euler." #: doc/classes/Basis.xml +#, fuzzy msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" "Construye una matriz de base de rotación pura, rotada alrededor del " @@ -14288,9 +14318,10 @@ msgstr "" "Realiza una ortonormalización de Gram-Schmidt sobre la base de la matriz." #: doc/classes/Basis.xml +#, fuzzy msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" "Introducir una rotación adicional alrededor del eje dado por phi (radianes). " "El eje debe ser un vector normalizado." @@ -15067,6 +15098,30 @@ msgstr "Devuelve el botón pulsado." msgid "Emitted when one of the buttons of the group is pressed." msgstr "Se emite cuando se presiona un botón de este controlador." +#: doc/classes/CallbackTweener.xml +#, fuzzy +msgid "Calls the specified method after optional delay." +msgstr "Bloquea el eje lineal o rotacional especificado." + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "Nodo de cámara, muestra desde un punto de vista." @@ -16110,14 +16165,20 @@ msgstr "" "el objeto canvas." #: doc/classes/CanvasItem.xml -#, fuzzy msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" -"Dibuja un arco entre los ángulos dados. Cuanto mayor sea el valor de " -"[code]point_count[/code], más suave será la curva." #: doc/classes/CanvasItem.xml msgid "" @@ -16131,28 +16192,42 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml -#, fuzzy msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" -"Dibuja un polígono coloreado de cualquier cantidad de puntos, convexo o " -"cóncavo." #: doc/classes/CanvasItem.xml -#, fuzzy msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" -"Dibuja una línea desde un punto 2D a otro, con un color y un ancho " -"determinados." #: doc/classes/CanvasItem.xml msgid "" @@ -16170,7 +16245,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" "Dibuja múltiples líneas paralelas con un [code]width[/code] uniforme y " "coloración segmento por segmento. Los colores asignados a los segmentos de " @@ -16186,7 +16266,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" "Dibuja múltiples líneas paralelas con un [code]width[/code] uniforme y " "coloración segmento por segmento. Los colores asignados a los segmentos de " @@ -16205,7 +16290,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -16214,7 +16305,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -16225,7 +16322,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" "Dibuja segmentos de líneas interconectadas con un [code]width[/code] " "uniforme y coloración segmento por segmento. Los colores asignados a los " @@ -16248,10 +16351,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" "Dibuja un rectángulo. Si [code]filled[/code] es [code]true[/code], el " "rectángulo se llenará con el [code]color[/code] especificado. Si " @@ -20850,9 +20959,11 @@ msgstr "" "dado tiene una sobreescritura válida en este nodo [Control]." #: doc/classes/Control.xml -#, fuzzy -msgid "Returns [code]true[/code] if drag operation is successful." -msgstr "Devuelve [code]true[/code] si una animacion esta reproduciendose." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." +msgstr "" #: doc/classes/Control.xml msgid "" @@ -25782,10 +25893,13 @@ msgstr "" "caso de éxito)." #: doc/classes/Directory.xml +#, fuzzy msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" "Borra el archivo de destino o un directorio vacío. El argumento puede ser " @@ -30115,7 +30229,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -31020,41 +31134,52 @@ msgstr "" "coincidan con el brillo de la imagen original." #: doc/classes/Environment.xml +#, fuzzy msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" "Operador lineal de mapas de tonos. Lee los datos lineales y los transmite " "sin modificar." #: doc/classes/Environment.xml +#, fuzzy msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" "Operador de mapeado de tonos Reinhardt. Realiza una variación de los colores " "de los píxeles renderizados por esta fórmula: [code]color = color / (1 + " "color)[/code]." #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." -msgstr "Operador de mazos fílmicos." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." +msgstr "" #: doc/classes/Environment.xml -#, fuzzy msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." -msgstr "Operador del Sistema de Codificación de Color de la Academia." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." +msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -37422,22 +37547,32 @@ msgid "Importing images" msgstr "" #: doc/classes/Image.xml +#, fuzzy msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" -"Mezcla usando Alfa [code]src_rect[/code] de la imagen [code]src[/code] a " -"esta imagen en las coordenadas [code]dest[/code]." +"[code]src_rect[/code] área de bits de la imagen [code]src[/code] a esta " +"imagen en las coordenadas dadas por [code]dst[/code]. El pixel de [code]src[/" +"code] se copia en [code]dst[/code] si el valor alfa del pixel " +"correspondiente de [code]mask[/code] no es 0. La imagen [code]src[/code] y " +"la imagen [code]mask[/code] [b]deben[/b] tener el mismo tamaño (anchura y " +"altura) pero pueden tener formatos diferentes." #: doc/classes/Image.xml +#, fuzzy msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" "Mezcla usando alfa[code]src_rect[/code] de la imagen [code]src[/code] a esta " "imagen usando la imagen [code]mask[/code] en las coordenadas [code]dst[/" @@ -37449,21 +37584,31 @@ msgstr "" "formatos diferentes." #: doc/classes/Image.xml +#, fuzzy msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" -"Copia [code]src_rect[/code] de la imagen [code]src[/code] a esta imagen en " -"las coordenadas [code]dst[/code]." +"[code]src_rect[/code] área de bits de la imagen [code]src[/code] a esta " +"imagen en las coordenadas dadas por [code]dst[/code]. El pixel de [code]src[/" +"code] se copia en [code]dst[/code] si el valor alfa del pixel " +"correspondiente de [code]mask[/code] no es 0. La imagen [code]src[/code] y " +"la imagen [code]mask[/code] [b]deben[/b] tener el mismo tamaño (anchura y " +"altura) pero pueden tener formatos diferentes." #: doc/classes/Image.xml +#, fuzzy msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" "[code]src_rect[/code] área de bits de la imagen [code]src[/code] a esta " "imagen en las coordenadas dadas por [code]dst[/code]. El pixel de [code]src[/" @@ -39180,8 +39325,10 @@ msgstr "Detiene la vibración del joypad." #, fuzzy msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" "Vibración de los dispositivos Android e iOS.\n" "[b]Nota:[/b] Necesita permiso de VIBRATE para Android en la configuración de " @@ -40185,9 +40332,13 @@ msgstr "" "action_has_event] si no quieres este comportamiento." #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" -"Devuelve un conjunto de [InputEvent]s asociados a una acción determinada." #: doc/classes/InputMap.xml msgid "Returns an array of all actions in the [InputMap]." @@ -40385,6 +40536,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -43073,14 +43237,20 @@ msgid "A 2D line." msgstr "Una línea 2D." #: doc/classes/Line2D.xml +#, fuzzy msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " "[member ProjectSettings.rendering/limits/buffers/" "canvas_polygon_index_buffer_size_kb]." msgstr "" +"Un Polígono2D se define por un conjunto de puntos. Cada punto está conectado " +"al siguiente, y el punto final está conectado al primero, resultando en un " +"polígono cerrado. Los Polígonos2D pueden ser rellenados con color (sólido o " +"gradiente) o rellenados con una textura dada." #: doc/classes/Line2D.xml msgid "" @@ -43127,11 +43297,19 @@ msgstr "" "code] suministrada." #: doc/classes/Line2D.xml -#, fuzzy msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." -msgstr "Si [code]true[/code], el borde de la línea será anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." +msgstr "" #: doc/classes/Line2D.xml msgid "" @@ -45520,6 +45698,41 @@ msgstr "" "Establece la malla utilizada para dibujar. Debe ser una malla que usa " "vértices 2D." +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "Implementación de la RealidadVirtual(VR) móvil genérica." @@ -47135,9 +47348,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -47371,6 +47595,14 @@ msgstr "" "Cambia un contorno creado en el editor o por el script. Tienes que llamar a " "[method make_polygons_from_outlines] para que los polígonos se actualicen." +#: 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml #, fuzzy msgid "Server interface for low-level 3D navigation access." @@ -48516,7 +48748,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -48605,6 +48837,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -49584,7 +49825,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -49639,6 +49880,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -49737,12 +49987,19 @@ msgid "Notification received when the node is instanced." msgstr "Notificación recibida cuando el nodo es instanciado." #: doc/classes/Node.xml -msgid "Notification received when a drag begins." -msgstr "Notificación recibida cuando comienza un arrastre." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." +msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." -msgstr "Notificación recibida cuando termina un arrastre." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." +msgstr "" #: doc/classes/Node.xml msgid "Notification received when the node's [NodePath] changed." @@ -50599,7 +50856,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -50665,7 +50922,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" "[b]ARREGLAME[/b] La sintaxis cambió con el añadido de [Callable], esto " @@ -52093,6 +52350,16 @@ msgstr "" "determinarse a partir de la época." #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml #, fuzzy msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -52724,6 +52991,23 @@ msgstr "" #: doc/classes/OS.xml #, fuzzy msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" +"Matar (terminar) el proceso identificado por el ID de proceso dado " +"([code]pid[/code]), por ejemplo el devuelto por [method execute] en modo no " +"bloqueante.\n" +"[b]Nota:[/b] Este método también puede utilizarse para matar procesos que no " +"fueron generados por el juego.\n" +"[b]Nota:[/b] Este método está implementado en Android, iOS, Linux, macOS y " +"Windows." + +#: doc/classes/OS.xml +#, fuzzy +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -52842,6 +53126,14 @@ msgstr "" "Windows." #: doc/classes/OS.xml +msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml #, fuzzy msgid "" "Moves the window to the front.\n" @@ -58427,8 +58719,16 @@ msgid "Sets the weight values for the specified bone." msgstr "Establece los valores de peso para el hueso especificado." #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." -msgstr "Si [code]true[/code], los bordes de los polígonos estarán suavizados." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." +msgstr "" #: doc/classes/Polygon2D.xml msgid "" @@ -58530,13 +58830,13 @@ msgstr "" #: doc/classes/PoolByteArray.xml #, fuzzy -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "Un paquete [Array] de bytes." #: doc/classes/PoolByteArray.xml #, fuzzy msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -58599,6 +58899,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -58691,14 +59001,14 @@ msgstr "" #: doc/classes/PoolColorArray.xml #, fuzzy -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "Un paquete de [Array] de [Color]s." #: doc/classes/PoolColorArray.xml #, fuzzy msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" "Un [Array] diseñado específicamente para mantener el [Color]. Envuelve los " @@ -58740,14 +59050,14 @@ msgstr "Cambia el [Color] en el índice dado." #: doc/classes/PoolIntArray.xml #, fuzzy -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "Un paquete [Array] de 32 bits de tipo entero." #: doc/classes/PoolIntArray.xml #, fuzzy msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -58798,13 +59108,13 @@ msgstr "Cambia el entero en el índice dado." #: doc/classes/PoolRealArray.xml #, fuzzy -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "Un paquete de [Array] de [Color]s." #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -58835,13 +59145,13 @@ msgstr "Cambia el real en el índice dado." #: doc/classes/PoolStringArray.xml #, fuzzy -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "Un paquete de [Array] de [String]s." #: doc/classes/PoolStringArray.xml #, fuzzy msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -58881,13 +59191,13 @@ msgstr "Cambia la [String] en el índice dado." #: doc/classes/PoolVector2Array.xml #, fuzzy -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "Un empaquetado de [Array] de [Vector2]s." #: doc/classes/PoolVector2Array.xml #, fuzzy msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -58925,13 +59235,13 @@ msgstr "Cambia el [Vector2] en el índice dado." #: doc/classes/PoolVector3Array.xml #, fuzzy -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "Un empaquetado [Array] de [Vector3]s." #: doc/classes/PoolVector3Array.xml #, fuzzy msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -61150,6 +61460,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "Máxima pila de llamadas permitida para depurar GDScript." #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" "Cantidad máxima de funciones por fotograma permitidas en la elaboración de " @@ -63930,10 +64250,199 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +#, fuzzy +msgid "Interpolates an [Object]'s property over time." +msgstr "Anima suavemente las propiedades de un nodo a lo largo del tiempo." + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +#, fuzzy +msgid "General-purpose 3D proximity detection node." msgstr "Nodo de detección de proximidad de propósito general." +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." +msgstr "" + #: doc/classes/QuadMesh.xml msgid "Class representing a square mesh." msgstr "Clase que representa una malla cuadrada." @@ -66394,14 +66903,15 @@ msgstr "Añade texto crudo no preparado por BBCode a la pila de etiquetas." #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -66454,10 +66964,12 @@ msgid "Adds a newline tag to the tag stack." msgstr "Añade una etiqueta de nueva línea a la pila de etiquetas." #: doc/classes/RichTextLabel.xml +#, fuzzy msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" "La versión de asignación de [method append_bbcode]. Borra la pila de " "etiquetas e inserta el nuevo contenido. Devuelve [constant OK] si parsea " @@ -68523,6 +69035,10 @@ msgstr "" "[/codeblock]" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -68553,6 +69069,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "Devuelve una lista de todos los nodos asignados al grupo dado." #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" "Devuelve la identificación del remitente de la última llamada RPC recibida." @@ -69013,6 +69535,405 @@ msgstr "El tiempo restante." msgid "Emitted when the timer reaches 0." msgstr "Emitido cuando el temporizador llega a 0." +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +#, fuzzy +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "Continúe el proceso sin importar el estado de pausa de [SceneTree]." + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "Una clase almacenada como recurso." @@ -74805,7 +75726,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -74913,41 +75834,48 @@ msgstr "Cambia el dibujo de la parte interior de la caja de estilo." msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" -"Expande la caja de estilo fuera del rectángulo de control en el borde " -"inferior. Es útil en combinación con [member border_width_bottom] para " -"dibujar un borde fuera del rectángulo de control." #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" -"Expande la caja de estilo fuera del rectángulo de control en el borde " -"izquierdo. Es útil en combinación con [member border_width_left] para " -"dibujar un borde fuera del rectángulo de control." #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" -"Expande la caja de estilo fuera del rectángulo de control en el borde " -"derecho. Es útil en combinación con [member border_width_right] para dibujar " -"un borde fuera del rectángulo de control." #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" -"Expande la caja de estilo fuera del rectángulo de control en el borde " -"superior. Es útil en combinación con [member border_width_top] para dibujar " -"un borde fuera del rectángulo de control." #: doc/classes/StyleBoxFlat.xml msgid "" @@ -74969,6 +75897,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "El tamaño de la sombra en píxeles." +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "[StyleBox] que muestra una sola línea." @@ -79107,7 +80050,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" "Devuelve la fecha actual como un diccionario de claves: [code]year[/code], " "[code]month[/code], [code]day[/code], [code]weekday[/code], [code]dst[/code] " @@ -79276,14 +80221,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -79757,26 +80706,30 @@ msgstr "" "del eje normalizado (escala de 1 o -1)." #: doc/classes/Transform.xml +#, fuzzy msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" "Gira la transformación alrededor del eje dado por el ángulo dado (en " "radianes), usando la multiplicación de la matriz. El eje debe ser un vector " "normalizado." #: doc/classes/Transform.xml +#, fuzzy msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" "Base de escala y origen de la transformación por el factor de escala dado, " "utilizando la multiplicación de la matriz." #: doc/classes/Transform.xml doc/classes/Transform2D.xml +#, fuzzy msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -79917,16 +80870,19 @@ msgid "Returns the scale." msgstr "Devuelve la escala." #: doc/classes/Transform2D.xml +#, fuzzy msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" "Gira la transformación por el ángulo dado (en radianes), usando la " "multiplicación de la matriz." #: doc/classes/Transform2D.xml +#, fuzzy msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" "Escala la transformación por el factor de escala dado, usando la " "multiplicación de la matriz." @@ -80226,7 +81182,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -81284,7 +82240,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" "Los Tweens son útiles para las animaciones que requieren que una propiedad " "numérica sea interpolada en un rango de valores. El nombre [i]tween[/i] " @@ -81694,6 +82652,23 @@ msgstr "" "Una combinación de [constant EASE_IN] y [constant EASE_OUT]. La " "interpolación es más rápida en ambos extremos." +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +#, fuzzy +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "Emitido cuando el nodo entra en el árbol." + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "Clase de ayudante para implementar un servidor UDP." @@ -82824,7 +83799,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -83043,9 +84018,10 @@ msgstr "" "Devuelve el vector reflejado desde un plano definido por la normal dada." #: doc/classes/Vector2.xml +#, fuzzy msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" "Devuelve el vector rotado por [code]phi[/code] radianes. Ver también [method " "@GDScript.deg2rad]." @@ -83180,7 +84156,7 @@ msgstr "Vector utilizado para las matemáticas 3D usando coordenadas enteras." #, fuzzy msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -83299,9 +84275,10 @@ msgstr "" "dada." #: doc/classes/Vector3.xml +#, fuzzy msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" "Gira este vector alrededor de un eje dado por [code]phi[/code] radianes. El " "eje debe ser un vector normalizado." @@ -84115,10 +85092,10 @@ msgstr "Devuelve [code]true[/code] si la selección está activa." #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" -"Devuelve [code]true[/code] si el viewport está realizando actualmente una " -"operación de arrastre." #: doc/classes/Viewport.xml #, fuzzy @@ -89926,6 +90903,32 @@ msgid "Sets the texture's path." msgstr "Devuelve el ancho de la textura." #: doc/classes/VisualServer.xml +msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml #, fuzzy msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " @@ -91162,25 +92165,48 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." -msgstr "Color de salida como entraron." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." +msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." -msgstr "Usa el mapa de tonos Reinhard." +#, fuzzy +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." +msgstr "" +"Operador de mapeado de tonos Reinhardt. Realiza una variación de los colores " +"de los píxeles renderizados por esta fórmula: [code]color = color / (1 + " +"color)[/code]." #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." -msgstr "Usa el mapa de tonos fílmicos." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." +msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." -msgstr "Usa el mapa de tonos de ACES." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." +msgstr "" #: doc/classes/VisualServer.xml -#, fuzzy -msgid "Use the ACES Fitted tonemapper." -msgstr "Usa el mapa de tonos de ACES." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." +msgstr "" #: doc/classes/VisualServer.xml msgid "Lowest quality of screen space ambient occlusion." diff --git a/doc/translations/fa.po b/doc/translations/fa.po index c61a77b1dc..fb0b7d196f 100644 --- a/doc/translations/fa.po +++ b/doc/translations/fa.po @@ -915,7 +915,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" "با یک مقدار نرمال شده بین دو زاویه (در رادیان) درون یابی می کند.\n" "مشابه [روش lerp] است ، اما وقتی زاویه ها به اطراف [ثابت @ GDScript.TAU] " @@ -7429,6 +7435,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8571,6 +8589,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -11268,7 +11296,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -11338,8 +11366,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11929,6 +11957,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12683,7 +12734,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12695,21 +12755,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12725,7 +12805,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12737,7 +12822,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12751,7 +12841,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12760,7 +12856,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12770,7 +12872,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12788,10 +12896,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -16308,7 +16422,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19932,9 +20049,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -23126,7 +23245,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23821,33 +23940,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28584,34 +28713,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29902,8 +30039,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30673,7 +30812,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30815,6 +30959,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32855,7 +33012,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32899,8 +33057,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34738,6 +34905,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -36051,9 +36253,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -36228,6 +36441,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -37008,7 +37229,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37049,6 +37270,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37723,7 +37953,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37746,6 +37976,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37831,11 +38070,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -38418,7 +38664,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38449,7 +38695,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39527,6 +39773,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -40008,6 +40264,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -40090,6 +40355,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -44295,7 +44568,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -44370,12 +44651,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44421,6 +44702,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44488,13 +44779,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44525,13 +44816,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44561,13 +44852,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44593,12 +44884,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44628,12 +44919,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44662,12 +44953,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46313,6 +46604,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48611,8 +48912,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -50408,14 +50896,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50459,8 +50948,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -52060,6 +52550,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -52084,6 +52578,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -52438,6 +52938,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56961,7 +57859,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -57045,28 +57943,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -57085,6 +58002,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -60329,7 +61261,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60459,14 +61393,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60861,20 +61799,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60980,13 +61919,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -61216,7 +62156,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -62048,7 +62988,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -62325,6 +63267,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -63117,7 +64075,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -63277,8 +64235,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -63376,7 +64334,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63458,8 +64416,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -64051,7 +65009,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68496,6 +69456,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69545,23 +70531,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/fi.po b/doc/translations/fi.po index 71a130a11d..4a23377588 100644 --- a/doc/translations/fi.po +++ b/doc/translations/fi.po @@ -710,7 +710,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -7080,6 +7086,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8222,6 +8240,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10921,7 +10949,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -10991,8 +11019,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11583,6 +11611,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12343,7 +12394,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12355,21 +12415,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12385,7 +12465,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12397,7 +12482,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12411,7 +12501,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12420,7 +12516,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12430,7 +12532,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12448,10 +12556,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15969,9 +16083,11 @@ msgid "" msgstr "" #: doc/classes/Control.xml -#, fuzzy -msgid "Returns [code]true[/code] if drag operation is successful." -msgstr "Palauttaa parametrin kosinin." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." +msgstr "" #: doc/classes/Control.xml msgid "" @@ -19604,9 +19720,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22799,7 +22917,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23494,33 +23612,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28268,34 +28396,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29588,8 +29724,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30360,7 +30498,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30502,6 +30645,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32544,7 +32700,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32588,8 +32745,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34429,6 +34595,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35752,9 +35953,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35929,6 +36141,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36713,7 +36933,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36754,6 +36974,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37428,7 +37657,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37451,6 +37680,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37536,11 +37774,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -38123,7 +38368,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38154,7 +38399,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39237,6 +39482,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39721,6 +39976,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39803,6 +40067,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -44002,7 +44274,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -44077,12 +44357,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44128,6 +44408,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44195,13 +44485,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44232,13 +44522,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44268,13 +44558,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44300,12 +44590,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44335,12 +44625,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44369,12 +44659,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46022,6 +46312,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48320,8 +48620,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -50114,14 +50601,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50166,8 +50654,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51767,6 +52256,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51791,6 +52284,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -52145,6 +52644,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56672,7 +57569,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56756,28 +57653,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56796,6 +57712,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -60052,7 +60983,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60182,14 +61115,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60584,20 +61521,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60703,13 +61641,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60940,7 +61879,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61777,7 +62716,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -62054,6 +62995,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62846,7 +63803,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -63008,8 +63965,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -63107,7 +64064,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63192,8 +64149,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63789,7 +64746,9 @@ msgstr "Palauttaa parametrin kosinin." #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68252,6 +69211,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69301,23 +70286,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/fil.po b/doc/translations/fil.po index 1aeae588a9..d5533cf3b8 100644 --- a/doc/translations/fil.po +++ b/doc/translations/fil.po @@ -635,7 +635,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -6997,6 +7003,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8139,6 +8157,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10836,7 +10864,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -10906,8 +10934,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11497,6 +11525,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12251,7 +12302,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12263,21 +12323,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12293,7 +12373,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12305,7 +12390,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12319,7 +12409,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12328,7 +12424,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12338,7 +12440,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12356,10 +12464,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15876,7 +15990,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19500,9 +19617,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22694,7 +22813,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23389,33 +23508,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28152,34 +28281,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29470,8 +29607,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30241,7 +30380,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30383,6 +30527,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32423,7 +32580,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32467,8 +32625,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34306,6 +34473,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35613,9 +35815,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35790,6 +36003,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36570,7 +36791,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36611,6 +36832,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37285,7 +37515,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37308,6 +37538,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37393,11 +37632,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -37980,7 +38226,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38011,7 +38257,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39089,6 +39335,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39570,6 +39826,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39652,6 +39917,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -43845,7 +44118,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -43920,12 +44201,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -43971,6 +44252,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44038,13 +44329,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44075,13 +44366,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44111,13 +44402,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44143,12 +44434,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44178,12 +44469,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44212,12 +44503,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45863,6 +46154,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48161,8 +48462,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -49954,14 +50442,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50005,8 +50494,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51606,6 +52096,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51630,6 +52124,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -51984,6 +52484,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56507,7 +57405,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56591,28 +57489,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56631,6 +57548,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -59875,7 +60807,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60005,14 +60939,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60407,20 +61345,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60526,13 +61465,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60762,7 +61702,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61594,7 +62534,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -61871,6 +62813,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62663,7 +63621,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -62823,8 +63781,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -62922,7 +63880,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63004,8 +63962,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63597,7 +64555,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68042,6 +69002,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69091,23 +70077,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/fr.po b/doc/translations/fr.po index 99290efdf2..bf6bfa6135 100644 --- a/doc/translations/fr.po +++ b/doc/translations/fr.po @@ -61,7 +61,7 @@ msgstr "" "Project-Id-Version: Godot Engine class reference\n" "Report-Msgid-Bugs-To: https://github.com/godotengine/godot\n" "POT-Creation-Date: \n" -"PO-Revision-Date: 2022-04-25 15:12+0000\n" +"PO-Revision-Date: 2022-05-05 13:38+0000\n" "Last-Translator: Maxime Leroy <lisacintosh@gmail.com>\n" "Language-Team: French <https://hosted.weblate.org/projects/godot-engine/" "godot-class-reference/fr/>\n" @@ -70,7 +70,7 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=n > 1;\n" -"X-Generator: Weblate 4.12.1-dev\n" +"X-Generator: Weblate 4.12.1\n" #: doc/tools/make_rst.py msgid "Description" @@ -1013,7 +1013,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" "Interpolation linéaire entre deux angles (en radians) par une valeur " "normalisée.\n" @@ -4085,7 +4091,7 @@ msgstr "" #: doc/classes/@GlobalScope.xml msgid "MIDI stop message. Stop the current sequence." -msgstr "" +msgstr "Le message d'arrêt en MIDI. Arrête la séquence actuelle." #: doc/classes/@GlobalScope.xml msgid "" @@ -5438,7 +5444,7 @@ msgstr "" #: doc/classes/AnimatedSprite3D.xml msgid "2D Sprite animation (also applies to 3D)" -msgstr "" +msgstr "L'animation des sprites 2D (et aussi 3D)" #: doc/classes/AnimatedSprite3D.xml msgid "Returns [code]true[/code] if an animation is currently being played." @@ -7080,6 +7086,7 @@ msgstr "" #: doc/classes/AnimationNodeStateMachine.xml msgid "Sets the node's coordinates. Used for display in the editor." msgstr "" +"Définit les coordonnées du nœud. Utilisé pour affichage dans l'éditeur." #: doc/classes/AnimationNodeStateMachine.xml msgid "Sets the given node as the graph start point." @@ -7159,6 +7166,8 @@ msgid "" "Don't use this transition during [method AnimationNodeStateMachinePlayback." "travel] or [member auto_advance]." msgstr "" +"N'utilise pas de transition lors de [method " +"AnimationNodeStateMachinePlayback.travel] ou [member auto_advance]." #: doc/classes/AnimationNodeStateMachineTransition.xml msgid "" @@ -7284,6 +7293,7 @@ msgid "" "Adds [code]animation[/code] to the player accessible with the key " "[code]name[/code]." msgstr "" +"Ajoute [code]animation[/code] dans le lecture sous la clé [code]name[/code]." #: doc/classes/AnimationPlayer.xml msgid "" @@ -7294,7 +7304,7 @@ msgstr "" #: doc/classes/AnimationPlayer.xml msgid "Returns the name of the next animation in the queue." -msgstr "" +msgstr "Retourne le nom de l'animation suivant dans la file." #: doc/classes/AnimationPlayer.xml msgid "" @@ -8090,7 +8100,7 @@ msgstr "Nœud de transition." #: doc/classes/Area.xml msgid "3D area for detection and physics and audio influence." -msgstr "" +msgstr "Une aire 3D pour la détection et les influences physiques et audio." #: doc/classes/Area.xml msgid "" @@ -8329,7 +8339,7 @@ msgstr "" #: doc/classes/Area2D.xml msgid "2D area for detection and physics and audio influence." -msgstr "" +msgstr "Une aire 2D pour la détection et les influences physiques et audio." #: doc/classes/Area2D.xml msgid "" @@ -8701,6 +8711,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -9181,7 +9203,7 @@ msgstr "" #: doc/classes/ARVRAnchor.xml msgid "Returns the name given to this anchor." -msgstr "" +msgstr "Retourne le nom donnée à cette ancre." #: doc/classes/ARVRAnchor.xml msgid "" @@ -9679,11 +9701,11 @@ msgstr "" #: doc/classes/ARVRPositionalTracker.xml msgid "This tracker is the left hand controller." -msgstr "" +msgstr "Ce tracker est la manette de la main gauche." #: doc/classes/ARVRPositionalTracker.xml msgid "This tracker is the right hand controller." -msgstr "" +msgstr "Ce tracker est la manette de la main droite." #: doc/classes/ARVRServer.xml msgid "Server for AR and VR features." @@ -9915,6 +9937,17 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +#, fuzzy +msgid "GUI containers" +msgstr "Conteneur à onglets." + #: doc/classes/AspectRatioContainer.xml #, fuzzy msgid "Specifies the horizontal relative position of child controls." @@ -9940,12 +9973,16 @@ msgid "" "The height of child controls is automatically adjusted based on the width of " "the container." msgstr "" +"La hauteur des contrôles enfants seront automatiquement ajusté en fonction " +"de la largeur du conteneur." #: doc/classes/AspectRatioContainer.xml msgid "" "The width of child controls is automatically adjusted based on the height of " "the container." msgstr "" +"La largeur des contrôles enfants seront automatiquement ajusté en fonction " +"de la hauteur du conteneur." #: doc/classes/AspectRatioContainer.xml msgid "" @@ -10205,6 +10242,7 @@ msgstr "Retourne la liste des tous les points." msgid "" "Returns whether a point associated with the given [code]id[/code] exists." msgstr "" +"Retourne si un point associé avec l'identifiant [code]id[/code] existe." #: doc/classes/AStar.xml doc/classes/AStar2D.xml msgid "" @@ -10235,6 +10273,8 @@ msgstr "" msgid "" "Sets the [code]position[/code] for the point with the given [code]id[/code]." msgstr "" +"Définit la [code]position[/code] du point avec l'identifiant [code]id[/code] " +"spécifié." #: doc/classes/AStar.xml doc/classes/AStar2D.xml msgid "" @@ -10378,6 +10418,7 @@ msgstr "" msgid "" "Crops out one part of a texture, such as a texture from a texture atlas." msgstr "" +"Découpe une partie d'une texture, comme une texture d'une texture atlas." #: doc/classes/AtlasTexture.xml msgid "" @@ -10529,6 +10570,8 @@ msgid "" "Returns the number of audio frames discarded from the audio bus due to full " "buffer." msgstr "" +"Retourne le nombre de trames audio perdue dans le bus audio parce que sa " +"mémoire est pleine." #: doc/classes/AudioEffectCapture.xml #, fuzzy @@ -10816,7 +10859,7 @@ msgstr "" #: doc/classes/AudioEffectEQ.xml msgid "Returns the number of bands of the equalizer." -msgstr "" +msgstr "Retourne le nombre de bandes dans l'égaliseur." #: doc/classes/AudioEffectEQ.xml msgid "Returns the band's gain at the specified index, in dB." @@ -10912,7 +10955,7 @@ msgstr "Autorise les fréquences autres que [membre cutoff_hz] à passer." #: doc/classes/AudioEffectFilter.xml msgid "Threshold frequency for the filter, in Hz." -msgstr "" +msgstr "Le fréquence seuil pour le filtre, en Hz." #: doc/classes/AudioEffectFilter.xml msgid "Gain amount of the frequencies after the filter." @@ -11316,6 +11359,8 @@ msgid "" "Adds an [AudioEffect] effect to the bus [code]bus_idx[/code] at " "[code]at_position[/code]." msgstr "" +"Ajoute un effet [AudioEffect] au bus [code]bus_idx[/code] à la position " +"[code]at_position[/code]." #: doc/classes/AudioServer.xml msgid "Returns the names of all audio input devices detected on the system." @@ -11340,7 +11385,7 @@ msgstr "" #: doc/classes/AudioServer.xml msgid "Returns the number of effects on the bus at [code]bus_idx[/code]." -msgstr "" +msgstr "Retourne le nombre d'effets pour le bus [code]bus_idx[/code]." #: doc/classes/AudioServer.xml msgid "" @@ -11350,11 +11395,11 @@ msgstr "" #: doc/classes/AudioServer.xml msgid "Returns the index of the bus with the name [code]bus_name[/code]." -msgstr "" +msgstr "Retourne l'index du bus nommé [code]bus_name[/code]." #: doc/classes/AudioServer.xml msgid "Returns the name of the bus with the index [code]bus_idx[/code]." -msgstr "" +msgstr "Retourne le nom du bus à la position [code]bus_idx[/code]." #: doc/classes/AudioServer.xml msgid "" @@ -11957,6 +12002,8 @@ msgid "" "If [code]true[/code], the playback is paused. You can resume it by setting " "[member stream_paused] to [code]false[/code]." msgstr "" +"Si [code]true[/code], la lecture est en pause. Vous pouvez la reprendre en " +"définissant [member stream_paused] à [code]false[/code]." #: doc/classes/AudioStreamPlayer3D.xml msgid "The base sound level unaffected by dampening, in decibels." @@ -12130,6 +12177,8 @@ msgid "" "Audio loops the data between [member loop_begin] and [member loop_end], " "playing forward only." msgstr "" +"L'audio boucle entre [member loop_begin] et [member loop_end], ne jouant " +"qu'en avant." #: doc/classes/AudioStreamSample.xml msgid "" @@ -12142,6 +12191,8 @@ msgid "" "Audio loops the data between [member loop_begin] and [member loop_end], " "playing backward only." msgstr "" +"L'audio boucle entre [member loop_begin] et [member loop_end], ne jouant " +"qu'en arrière." #: doc/classes/BackBufferCopy.xml msgid "" @@ -12258,6 +12309,8 @@ msgid "" "Number of light bounces that are taken into account during baking. See also " "[member bounce_indirect_energy]." msgstr "" +"Le nombre de rebondissements des particules de lumière pris en compte dans " +"le baking. Voir aussi [member bounce_indirect_energy]." #: doc/classes/BakedLightmap.xml msgid "Grid size used for real-time capture information on dynamic objects." @@ -12701,11 +12754,14 @@ msgid "" msgstr "" #: doc/classes/Basis.xml +#, fuzzy msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" +"Construit un quaternion qui tournera autour de l'axe donné selon l'angle " +"spécifié. L'axe doit être un vecteur normalisé." #: doc/classes/Basis.xml msgid "Constructs a basis matrix from 3 axis vectors (matrix columns)." @@ -12776,10 +12832,13 @@ msgid "" msgstr "" #: doc/classes/Basis.xml +#, fuzzy msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" +"Pivote ce vecteur autour de l'axe donné par [code]phi[/code] radians. L'axe " +"donné doit être normalisé." #: doc/classes/Basis.xml msgid "" @@ -12897,7 +12956,7 @@ msgstr "" #: doc/classes/BitMap.xml msgid "Returns bitmap's value at the specified position." -msgstr "" +msgstr "Retourne la valeur du bitmap à la position spécifiée." #: doc/classes/BitMap.xml msgid "Returns bitmap's dimensions." @@ -12975,6 +13034,8 @@ msgstr "Efface toutes les données et paramètres de la police." msgid "" "Creates a BitmapFont from the [code]*.fnt[/code] file at [code]path[/code]." msgstr "" +"Crée un BitmapFont depuis le fichier [code]*.fnt[/code] à l'emplacement " +"[code]path[/code]." #: doc/classes/BitmapFont.xml #, fuzzy @@ -13289,15 +13350,15 @@ msgstr "Le texte du bouton qui sera affiché à l'intérieur de l'aire du bouton #: doc/classes/Button.xml msgid "Align the text to the left." -msgstr "Alignez le texte à gauche." +msgstr "Aligne le texte à gauche." #: doc/classes/Button.xml msgid "Align the text to the center." -msgstr "Alignez le texte au centre." +msgstr "Aligne le texte au centre." #: doc/classes/Button.xml msgid "Align the text to the right." -msgstr "Alignez le texte vers la droite." +msgstr "Aligne le texte vers la droite." #: doc/classes/Button.xml msgid "Default text [Color] of the [Button]." @@ -13316,15 +13377,15 @@ msgstr "" #: doc/classes/Button.xml msgid "Text [Color] used when the [Button] is being hovered." -msgstr "" +msgstr "La [Color] du texte utilisée quand le [Button] est survolé." #: doc/classes/Button.xml msgid "Text [Color] used when the [Button] is being pressed." -msgstr "" +msgstr "La [Color] du texte utilisée quand le [Button] est appuyé." #: doc/classes/Button.xml msgid "The horizontal space between [Button]'s icon and text." -msgstr "" +msgstr "L'espacement horizontal entre l'icône et le texte du [Button]." #: doc/classes/Button.xml msgid "[Font] of the [Button]'s text." @@ -13379,6 +13440,30 @@ msgstr "Renvoie le bouton actuellement enfoncé." msgid "Emitted when one of the buttons of the group is pressed." msgstr "Émis lorsqu’un bouton de ce contrôleur est appuyé." +#: doc/classes/CallbackTweener.xml +#, fuzzy +msgid "Calls the specified method after optional delay." +msgstr "Verrouille l'axe linéaire et de rotation spécifié." + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "Nœud de caméra, affiche d'un point de vue." @@ -14002,6 +14087,8 @@ msgstr "Le flux fournis des images au format RGB." #: doc/classes/CameraFeed.xml msgid "Feed supplies YCbCr images that need to be converted to RGB." msgstr "" +"Le flux fournis des images au format YCbCr qui doivent être converties en " +"RGB." #: doc/classes/CameraFeed.xml msgid "" @@ -14015,11 +14102,11 @@ msgstr "Position non renseignée." #: doc/classes/CameraFeed.xml msgid "Camera is mounted at the front of the device." -msgstr "" +msgstr "La caméra est placée à l'avant de l'appareil." #: doc/classes/CameraFeed.xml msgid "Camera is mounted at the back of the device." -msgstr "" +msgstr "La caméra est placée à l'arrière de l'appareil." #: doc/classes/CameraServer.xml msgid "Server keeping track of different cameras accessible in Godot." @@ -14165,7 +14252,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -14177,21 +14273,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -14208,7 +14324,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" "Dessine des segments de ligne interconnectés avec une [code]width[/code] " "uniforme et une coloration segment par segment. Les couleurs attribuées aux " @@ -14225,7 +14346,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" "Dessine des segments de ligne interconnectés avec une [code]width[/code] " "uniforme et une coloration segment par segment. Les couleurs attribuées aux " @@ -14243,7 +14369,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -14252,7 +14384,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -14263,7 +14401,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" "Dessine des segments de ligne interconnectés avec une [code]width[/code] " "uniforme et une coloration segment par segment. Les couleurs attribuées aux " @@ -14285,10 +14429,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -14411,6 +14561,8 @@ msgstr "Retourne le [Rect2] délimitant la fenêtre d'affichage." #: doc/classes/CanvasItem.xml msgid "Returns this item's transform in relation to the viewport." msgstr "" +"Retourne la transformation de cet élément par rapport à la fenêtre " +"d'affichage." #: doc/classes/CanvasItem.xml msgid "Returns the [World2D] where this item is in." @@ -14427,6 +14579,8 @@ msgid "" "Returns [code]true[/code] if local transform notifications are communicated " "to children." msgstr "" +"Retourne [code]true[/code] si les notification des transformations locales " +"sont communiquées aux enfants." #: doc/classes/CanvasItem.xml msgid "" @@ -14439,6 +14593,8 @@ msgid "" "Returns [code]true[/code] if global transform notifications are communicated " "to children." msgstr "" +"Retourne [code]true[/code] si les notification des transformations globales " +"sont communiquées aux enfants." #: doc/classes/CanvasItem.xml doc/classes/Spatial.xml msgid "" @@ -14520,7 +14676,7 @@ msgstr "Si [code]true[/code], l'objet est affiché derrière son parent." #: doc/classes/CanvasItem.xml msgid "If [code]true[/code], the object draws on top of its parent." -msgstr "" +msgstr "Si [code]true[/code], l'objet est affiché par dessus son parent." #: doc/classes/CanvasItem.xml msgid "" @@ -14637,7 +14793,7 @@ msgstr "" #: doc/classes/CanvasItemMaterial.xml msgid "The manner in which material reacts to lighting." -msgstr "" +msgstr "La façon dont le matériau réagit à la lumière." #: doc/classes/CanvasItemMaterial.xml msgid "" @@ -14680,11 +14836,11 @@ msgstr "" #: doc/classes/CanvasItemMaterial.xml msgid "Render the material as if there were no light." -msgstr "" +msgstr "Rend du matériau comme s'il n'y avait pas de lumière." #: doc/classes/CanvasItemMaterial.xml msgid "Render the material as if there were only light." -msgstr "" +msgstr "Rend du matériau comme s'il n'y avait que de la lumière." #: doc/classes/CanvasLayer.xml msgid "Canvas drawing layer." @@ -14706,7 +14862,7 @@ msgstr "Claques du canevas" #: doc/classes/CanvasLayer.xml msgid "Returns the RID of the canvas used by this layer." -msgstr "" +msgstr "Retourne le RID du canevas utilisé par ce calque." #: doc/classes/CanvasLayer.xml msgid "" @@ -14742,6 +14898,8 @@ msgstr "" #: doc/classes/CanvasLayer.xml msgid "Layer index for draw order. Lower values are drawn first." msgstr "" +"L'index des calques définit l'ordre d'affichage. Un index bas sera dessiné " +"en premier." #: doc/classes/CanvasLayer.xml msgid "The layer's base offset." @@ -14784,6 +14942,8 @@ msgstr "Teindre toute la toile." msgid "" "[CanvasModulate] tints the canvas elements using its assigned [member color]." msgstr "" +"Un [CanvasModulate] teintera les éléments d'un canevas selon sa [member " +"color] assignée." #: doc/classes/CanvasModulate.xml msgid "The tint color to apply." @@ -14803,7 +14963,7 @@ msgstr "" #: doc/classes/CapsuleMesh.xml msgid "Number of radial segments on the capsule mesh." -msgstr "" +msgstr "Le nombre de segments radiaux du maillage de la capsule." #: doc/classes/CapsuleMesh.xml msgid "Radius of the capsule mesh." @@ -14811,7 +14971,7 @@ msgstr "Rayon du maillage de la capsule." #: doc/classes/CapsuleMesh.xml msgid "Number of rings along the height of the capsule." -msgstr "" +msgstr "Le nombre d'anneau le long de la hauteur de la capsule." #: doc/classes/CapsuleShape.xml msgid "Capsule shape for collisions." @@ -14989,6 +15149,7 @@ msgstr "La couleur de la police du texte [CheckBox]." #: doc/classes/CheckBox.xml msgid "The [CheckBox] text's font color when it's disabled." msgstr "" +"Le couleur de la police du texte de la [CheckBox] quand elle est désactivée." #: doc/classes/CheckBox.xml msgid "" @@ -15000,6 +15161,7 @@ msgstr "" #: doc/classes/CheckBox.xml msgid "The [CheckBox] text's font color when it's hovered." msgstr "" +"Le couleur de la police du texte de la [CheckBox] quand elle est survolée." #: doc/classes/CheckBox.xml msgid "The [CheckBox] text's font color when it's hovered and pressed." @@ -15008,6 +15170,7 @@ msgstr "" #: doc/classes/CheckBox.xml msgid "The [CheckBox] text's font color when it's pressed." msgstr "" +"Le couleur de la police du texte de la [CheckBox] quand elle est appuyée." #: doc/classes/CheckBox.xml msgid "The vertical offset used when rendering the check icons (in pixels)." @@ -15024,7 +15187,7 @@ msgstr "La [Font] à utiliser pour le texte du [CheckBox]." #: doc/classes/CheckBox.xml msgid "The check icon to display when the [CheckBox] is checked." -msgstr "" +msgstr "L'icône de la coche à afficher quand la [CheckBox] est cochée." #: doc/classes/CheckBox.xml #, fuzzy @@ -15045,7 +15208,7 @@ msgstr "" #: doc/classes/CheckBox.xml msgid "The check icon to display when the [CheckBox] is unchecked." -msgstr "" +msgstr "L'icône de la coche à afficher quand la [CheckBox] est décochée." #: doc/classes/CheckBox.xml #, fuzzy @@ -15142,7 +15305,7 @@ msgstr "La [Font] à utilisé pour le texte du [CheckButton]." #: doc/classes/CheckButton.xml msgid "The icon to display when the [CheckButton] is unchecked." -msgstr "" +msgstr "L'icône à afficher que le [CheckButton] est décoché." #: doc/classes/CheckButton.xml msgid "The icon to display when the [CheckButton] is unchecked and disabled." @@ -15151,7 +15314,7 @@ msgstr "" #: doc/classes/CheckButton.xml msgid "The icon to display when the [CheckButton] is checked." -msgstr "" +msgstr "L'icône à afficher que le [CheckButton] est coché." #: doc/classes/CheckButton.xml msgid "The icon to display when the [CheckButton] is checked and disabled." @@ -15207,6 +15370,7 @@ msgstr "Dépôt d'information de classe." #: doc/classes/ClassDB.xml msgid "Provides access to metadata stored for every available class." msgstr "" +"Fournis un accès au méta-données enregistrées dans chaque classe disponible." #: doc/classes/ClassDB.xml msgid "" @@ -15355,6 +15519,8 @@ msgid "" "Returns whether [code]inherits[/code] is an ancestor of [code]class[/code] " "or not." msgstr "" +"Retourne si [code]class[/code] hérite de la classe [code]inherits[/code] ou " +"non." #: doc/classes/ClippedCamera.xml msgid "A [Camera] that includes collision." @@ -15533,7 +15699,7 @@ msgstr "Enlève toutes les formes au propriétaire de la forme." #: doc/classes/CollisionObject.xml doc/classes/CollisionObject2D.xml msgid "Returns the parent object of the given shape owner." -msgstr "" +msgstr "Retourne l'objet parent du propriétaire de la forme spécifié." #: doc/classes/CollisionObject.xml #, fuzzy @@ -15561,11 +15727,11 @@ msgstr "Retire la forme du propriétaire de forme donné." #: doc/classes/CollisionObject.xml doc/classes/CollisionObject2D.xml msgid "If [code]true[/code], disables the given shape owner." -msgstr "" +msgstr "Si [code]true[/code], désactive le propriétaire spécifié de la forme." #: doc/classes/CollisionObject.xml msgid "Sets the [Transform] of the given shape owner." -msgstr "" +msgstr "Définit la [Transform] du propriétaire de forme spécifié." #: doc/classes/CollisionObject.xml msgid "" @@ -15690,7 +15856,7 @@ msgstr "" #: doc/classes/CollisionObject2D.xml msgid "Sets the [Transform2D] of the given shape owner." -msgstr "" +msgstr "Définit la [Transform2D] du propriétaire de forme spécifié." #: doc/classes/CollisionObject2D.xml msgid "" @@ -16272,6 +16438,8 @@ msgstr "" #: doc/classes/Color.xml msgid "Wrapper for [member a] that uses the range 0 to 255 instead of 0 to 1." msgstr "" +"Raccourci pour le [member a] qui utilise l'intervalle de 0 à 255 plutôt que " +"de 0 à 1." #: doc/classes/Color.xml msgid "The color's blue component, typically on the range of 0 to 1." @@ -16280,6 +16448,8 @@ msgstr "" #: doc/classes/Color.xml msgid "Wrapper for [member b] that uses the range 0 to 255 instead of 0 to 1." msgstr "" +"Raccourci pour le [member b] qui utilise l'intervalle de 0 à 255 plutôt que " +"de 0 à 1." #: doc/classes/Color.xml msgid "The color's green component, typically on the range of 0 to 1." @@ -16288,6 +16458,8 @@ msgstr "" #: doc/classes/Color.xml msgid "Wrapper for [member g] that uses the range 0 to 255 instead of 0 to 1." msgstr "" +"Raccourci pour le [member g] qui utilise l'intervalle de 0 à 255 plutôt que " +"de 0 à 1." #: doc/classes/Color.xml msgid "The HSV hue of this color, on the range 0 to 1." @@ -16300,6 +16472,8 @@ msgstr "" #: doc/classes/Color.xml msgid "Wrapper for [member r] that uses the range 0 to 255 instead of 0 to 1." msgstr "" +"Raccourci pour le [member r] qui utilise l'intervalle de 0 à 255 plutôt que " +"de 0 à 1." #: doc/classes/Color.xml msgid "The HSV saturation of this color, on the range 0 to 1." @@ -16992,7 +17166,7 @@ msgstr "Émis lorsqu’un préréglage est supprimé." #: doc/classes/ColorPicker.xml msgid "The width of the hue selection slider." -msgstr "" +msgstr "La largeur de glisseur de la teinte." #: doc/classes/ColorPicker.xml msgid "The margin around the [ColorPicker]." @@ -17000,15 +17174,15 @@ msgstr "La marge autour du [ColorPicker]." #: doc/classes/ColorPicker.xml msgid "The height of the saturation-value selection box." -msgstr "" +msgstr "La hauteur de la boite de sélection de la saturation." #: doc/classes/ColorPicker.xml msgid "The width of the saturation-value selection box." -msgstr "" +msgstr "La largeur de la boite de sélection de la saturation." #: doc/classes/ColorPicker.xml msgid "The icon for the \"Add Preset\" button." -msgstr "" +msgstr "L'icône du bouton pour ajouter un préréglage." #: doc/classes/ColorPicker.xml msgid "Custom texture for the hue selection slider on the right." @@ -17084,6 +17258,7 @@ msgstr "La [Color] par défaut du texte du [ColorPickerButton]." #: doc/classes/ColorPickerButton.xml msgid "Text [Color] used when the [ColorPickerButton] is disabled." msgstr "" +"La [Color] du texte utiliser quand ce [ColorPickerButton] est désactivé." #: doc/classes/ColorPickerButton.xml msgid "" @@ -17094,15 +17269,16 @@ msgstr "" #: doc/classes/ColorPickerButton.xml msgid "Text [Color] used when the [ColorPickerButton] is being hovered." -msgstr "" +msgstr "La [Color] du texte utilisée quand le [ColorPickerButton] est survolé." #: doc/classes/ColorPickerButton.xml msgid "Text [Color] used when the [ColorPickerButton] is being pressed." -msgstr "" +msgstr "La [Color] du texte utilisée quand le [ColorPickerButton] est appuyé." #: doc/classes/ColorPickerButton.xml msgid "The horizontal space between [ColorPickerButton]'s icon and text." msgstr "" +"L'espacement horizontal entre l'icône et le texte de ce [ColorPickerButton]." #: doc/classes/ColorPickerButton.xml msgid "[Font] of the [ColorPickerButton]'s text." @@ -17125,7 +17301,7 @@ msgstr "" #: doc/classes/ColorPickerButton.xml msgid "[StyleBox] used when the [ColorPickerButton] is being hovered." -msgstr "" +msgstr "La [StyleBox] utilisée quand le [ColorPickerButton] est survolé." #: doc/classes/ColorPickerButton.xml msgid "Default [StyleBox] for the [ColorPickerButton]." @@ -17133,7 +17309,7 @@ msgstr "[StyleBox] par défaut pour le [ColorPickerButton]." #: doc/classes/ColorPickerButton.xml msgid "[StyleBox] used when the [ColorPickerButton] is being pressed." -msgstr "" +msgstr "La [StyleBox] utilisée quand le [ColorPickerButton] est appuyé." #: doc/classes/ColorRect.xml msgid "Colored rectangle." @@ -17355,7 +17531,7 @@ msgstr "" #: doc/classes/ConfigFile.xml msgid "Returns an array of all defined section identifiers." -msgstr "" +msgstr "Retourne la liste des identifiants de section définis." #: doc/classes/ConfigFile.xml msgid "" @@ -17372,6 +17548,7 @@ msgstr "Retourne [code]true[/code] si la section spécifiée existe." #: doc/classes/ConfigFile.xml msgid "Returns [code]true[/code] if the specified section-key pair exists." msgstr "" +"Retourne [code]true[/code] si la paire section et clé spécifiée existe." #: doc/classes/ConfigFile.xml msgid "" @@ -17893,6 +18070,7 @@ msgstr "" #: doc/classes/Control.xml msgid "Returns the minimum size for this control. See [member rect_min_size]." msgstr "" +"Retourne la taille minimale de ce contrôle. Voir [member rect_min_size]." #: doc/classes/Control.xml #, fuzzy @@ -18079,8 +18257,11 @@ msgstr "" "existe, [code]false[/code] autrement." #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." -msgstr "Retourne [code]true[/code] si l'opération de déposer-glisser a réussi." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." +msgstr "" #: doc/classes/Control.xml msgid "" @@ -18171,6 +18352,8 @@ msgid "" "Sets [member margin_left] and [member margin_top] at the same time. " "Equivalent of changing [member rect_position]." msgstr "" +"Définit à la fois [member margin_left] et [member margin_top]. Revient à " +"changer [member rect_position]." #: doc/classes/Control.xml msgid "" @@ -18224,7 +18407,7 @@ msgstr "" #: doc/classes/Control.xml msgid "Sets [member margin_right] and [member margin_bottom] at the same time." -msgstr "" +msgstr "Définit à la fois [member margin_right] et [member margin_bottom]." #: doc/classes/Control.xml msgid "" @@ -18663,6 +18846,7 @@ msgstr "" #: doc/classes/Control.xml msgid "The node cannot grab focus. Use with [member focus_mode]." msgstr "" +"Le nœud ne peut récupérer le focus. À utiliser avec [member focus_mode]." #: doc/classes/Control.xml msgid "" @@ -18684,11 +18868,11 @@ msgstr "" #: doc/classes/Control.xml msgid "Sent when the mouse pointer enters the node." -msgstr "" +msgstr "Envoyé quand le curseur de la souris entre dans le nœud." #: doc/classes/Control.xml msgid "Sent when the mouse pointer exits the node." -msgstr "" +msgstr "Envoyé quand le curseur de la souris sort du nœud." #: doc/classes/Control.xml msgid "Sent when the node grabs focus." @@ -18936,7 +19120,7 @@ msgstr "" #: doc/classes/Control.xml msgid "The control will be resized to its minimum size." -msgstr "" +msgstr "Le contrôle sera redimensionné à sa taille minimale." #: doc/classes/Control.xml msgid "The control's width will not change." @@ -19124,7 +19308,7 @@ msgstr "" #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml msgid "Returns the [Curve] of the parameter specified by [enum Parameter]." -msgstr "" +msgstr "Retourne la [Curve] du paramètre spécifié par [enum Parameter]." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml msgid "" @@ -19150,7 +19334,7 @@ msgstr "" #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml msgid "Sets the [Curve] of the parameter specified by [enum Parameter]." -msgstr "" +msgstr "Définit la [Curve] du paramètre spécifié par [enum Parameter]." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml msgid "" @@ -19176,11 +19360,12 @@ msgstr "" #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml msgid "Initial rotation applied to each particle, in degrees." -msgstr "" +msgstr "La rotation initiale appliquée à chaque particule, en degrés." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml msgid "Each particle's rotation will be animated along this [Curve]." msgstr "" +"La rotation de chaque particule sera animée en fonction de cette [Curve]." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml #: doc/classes/ParticlesMaterial.xml @@ -19196,6 +19381,8 @@ msgstr "" #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml msgid "Each particle's angular velocity will vary along this [Curve]." msgstr "" +"La vitesse angulaire de chaque particule sera animée en fonction de cette " +"[Curve]." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml #: doc/classes/ParticlesMaterial.xml @@ -19210,6 +19397,7 @@ msgstr "Décalage d’animation de particules." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml msgid "Each particle's animation offset will vary along this [Curve]." msgstr "" +"Le décalage de chaque particule sera animé en fonction de cette [Curve]." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml #: doc/classes/ParticlesMaterial.xml @@ -19224,6 +19412,8 @@ msgstr "Vitesse d’animation des particules." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml msgid "Each particle's animation speed will vary along this [Curve]." msgstr "" +"La vitesse d'animation de chaque particule sera animée en fonction de cette " +"[Curve]." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml #: doc/classes/ParticlesMaterial.xml @@ -19249,6 +19439,8 @@ msgid "" "Each particle's color will vary along this [GradientTexture] over its " "lifetime (multiplied with [member color])." msgstr "" +"La couleur de chaque particule variera suivant cette [GradientTexture] " +"durant sa durée de vie (multiplié par [member color])." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml #: doc/classes/ParticlesMaterial.xml @@ -19309,13 +19501,14 @@ msgstr "" msgid "" "The axis for the ring shaped emitter when using [constant " "EMISSION_SHAPE_RING]." -msgstr "" +msgstr "L'axe pour l'émetteur en anneau avec [constant EMISSION_SHAPE_RING]." #: doc/classes/CPUParticles.xml msgid "" "The height for the ring shaped emitter when using [constant " "EMISSION_SHAPE_RING]." msgstr "" +"La hauteur de l’émetteur en anneau pour [constant EMISSION_SHAPE_RING]." #: doc/classes/CPUParticles.xml msgid "" @@ -19327,7 +19520,7 @@ msgstr "" msgid "" "The radius for the ring shaped emitter when using [constant " "EMISSION_SHAPE_RING]." -msgstr "" +msgstr "Le rayon de l'émetteur en anneau pour [constant EMISSION_SHAPE_RING]." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml msgid "" @@ -19410,7 +19603,7 @@ msgstr "La variation de teinte appliquée à chaque particule." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml msgid "Each particle's hue will vary along this [Curve]." -msgstr "" +msgstr "La teinte de chaque particule variera suivant cette [Curve]." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml #: doc/classes/ParticlesMaterial.xml @@ -19451,6 +19644,8 @@ msgstr "" #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml msgid "Each particle's linear acceleration will vary along this [Curve]." msgstr "" +"L'accélération linéaire de chaque particule sera animée en fonction de cette " +"[Curve]." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml #: doc/classes/ParticlesMaterial.xml @@ -19489,6 +19684,8 @@ msgstr "" #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml msgid "Each particle's orbital velocity will vary along this [Curve]." msgstr "" +"La vitesse orbitale de chaque particule sera animée en fonction de cette " +"[Curve]." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml #: doc/classes/ParticlesMaterial.xml @@ -19510,6 +19707,8 @@ msgstr "" #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml msgid "Each particle's radial acceleration will vary along this [Curve]." msgstr "" +"L'accélération radiale de chaque particule sera animée en fonction de cette " +"[Curve]." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml #: doc/classes/ParticlesMaterial.xml @@ -19528,7 +19727,7 @@ msgstr "Échelle initiale appliquée à chaque particule." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml msgid "Each particle's scale will vary along this [Curve]." -msgstr "" +msgstr "La mise à l'échelle de chaque particule variera suivant cette [Curve]." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml #: doc/classes/ParticlesMaterial.xml @@ -19559,6 +19758,8 @@ msgstr "" #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml msgid "Each particle's tangential acceleration will vary along this [Curve]." msgstr "" +"L'accélération tangentielle de chaque particule sera animée en fonction de " +"cette [Curve]." #: doc/classes/CPUParticles.xml doc/classes/CPUParticles2D.xml #: doc/classes/ParticlesMaterial.xml @@ -19903,6 +20104,8 @@ msgid "" "Generates a [PoolByteArray] of cryptographically secure random bytes with " "given [code]size[/code]." msgstr "" +"Génère un [PoolByteArray] d'octets aléatoirement sécurisés de manière " +"cryptographique de la taille [code]size[/code]." #: doc/classes/Crypto.xml msgid "" @@ -19945,12 +20148,16 @@ msgid "" "Sign a given [code]hash[/code] of type [code]hash_type[/code] with the " "provided private [code]key[/code]." msgstr "" +"Signe le [code]hash[/code] spécifié du type [code]hash_type[/code] avec la " +"clé privée [code]key[/code] donnée." #: doc/classes/Crypto.xml msgid "" "Verify that a given [code]signature[/code] for [code]hash[/code] of type " "[code]hash_type[/code] against the provided public [code]key[/code]." msgstr "" +"Vérifie la [code]signature[/code] donnée pour le [code]hash[/code] du type " +"[code]hash_type[/code] avec la clé publique [code]key[/code] fournie." #: doc/classes/CryptoKey.xml msgid "A cryptographic key (RSA)." @@ -20166,6 +20373,7 @@ msgstr "" msgid "" "When [member mode] is [constant MODE_DEPTH], the depth of the extrusion." msgstr "" +"Quand [member mode] est [constant MODE_DEPTH], la profondeur de l'extrusion." #: modules/csg/doc_classes/CSGPolygon.xml msgid "" @@ -20177,7 +20385,7 @@ msgstr "" #: modules/csg/doc_classes/CSGPolygon.xml msgid "The [member mode] used to extrude the [member polygon]." -msgstr "" +msgstr "Le [member mode] utilisé pour extruder le [member polygon]." #: modules/csg/doc_classes/CSGPolygon.xml msgid "" @@ -20264,6 +20472,7 @@ msgstr "" msgid "" "When [member mode] is [constant MODE_SPIN], the number of extrusions made." msgstr "" +"Quand [member mode] est [constant MODE_SPIN], le nombre d'extrusions faites." #: modules/csg/doc_classes/CSGPolygon.xml msgid "The [member polygon] shape is extruded along the negative Z axis." @@ -20613,6 +20822,8 @@ msgid "" "Store the [CubeMap] with moderate compression that doesn't reduce image " "quality." msgstr "" +"Enregistre la [CubeMap] avec une compression modérée qui ne réduit pas la " +"qualité de l'image." #: doc/classes/CubeMap.xml msgid "Identifier for the left face of the [CubeMap]." @@ -20773,6 +20984,8 @@ msgstr "" #: doc/classes/CullInstance.xml msgid "Use for instances that will move [b]between[/b] [Room]s - e.g. players." msgstr "" +"À utiliser pour les instances qui se déplacent [b]entre[/b] les [Room], par " +"ex. les joueurs." #: doc/classes/CullInstance.xml msgid "" @@ -20822,12 +21035,12 @@ msgstr "Supprime tous les points de la courbe." #: doc/classes/Curve.xml doc/classes/Curve2D.xml doc/classes/Curve3D.xml msgid "Returns the number of points describing the curve." -msgstr "" +msgstr "Retourne le nombre de points décrivant la courbe." #: doc/classes/Curve.xml msgid "" "Returns the left [enum TangentMode] for the point at [code]index[/code]." -msgstr "" +msgstr "Retourne le [enum TangentMode] à gauche du point à [code]index[/code]." #: doc/classes/Curve.xml msgid "" @@ -20837,12 +21050,12 @@ msgstr "" #: doc/classes/Curve.xml msgid "Returns the curve coordinates for the point at [code]index[/code]." -msgstr "" +msgstr "Retourne les coordonnées de la courbe au point à [code]index[/code]." #: doc/classes/Curve.xml msgid "" "Returns the right [enum TangentMode] for the point at [code]index[/code]." -msgstr "" +msgstr "Retourne le [enum TangentMode] à droite du point à [code]index[/code]." #: doc/classes/Curve.xml msgid "" @@ -20865,7 +21078,7 @@ msgstr "" #: doc/classes/Curve.xml msgid "Removes the point at [code]index[/code] from the curve." -msgstr "" +msgstr "Retire le point à [code]index[/code] de la courbe." #: doc/classes/Curve.xml msgid "" @@ -20900,6 +21113,8 @@ msgid "" "Assigns the vertical position [code]y[/code] to the point at [code]index[/" "code]." msgstr "" +"Assigne la position verticale [code]y[/code] au point à l'index [code]index[/" +"code]." #: doc/classes/Curve.xml msgid "The number of points to include in the baked (i.e. cached) curve data." @@ -20915,11 +21130,11 @@ msgstr "La valeur minimale que la courbe peut atteindre." #: doc/classes/Curve.xml msgid "Emitted when [member max_value] or [member min_value] is changed." -msgstr "" +msgstr "Émis quand [member max_value] ou [member min_value] est changé." #: doc/classes/Curve.xml msgid "The tangent on this side of the point is user-defined." -msgstr "" +msgstr "La tangente de ce côté du point est personnalisée." #: doc/classes/Curve.xml msgid "" @@ -20929,7 +21144,7 @@ msgstr "" #: doc/classes/Curve.xml msgid "The total number of available tangent modes." -msgstr "" +msgstr "Le nombre total de modes de tangentes disponibles." #: doc/classes/Curve2D.xml msgid "Describes a Bézier curve in 2D space." @@ -21540,6 +21755,7 @@ msgstr "Retourne la liste des valeurs dans le [Dictionary]." #: doc/classes/DirectionalLight.xml msgid "Directional light from a distance, as from the Sun." msgstr "" +"Une lumière directionnelle à une certaine distance, comme pour le soleil." #: doc/classes/DirectionalLight.xml msgid "" @@ -21575,6 +21791,7 @@ msgstr "Distance maximale pour les fractionnements d’ombre." #: doc/classes/DirectionalLight.xml msgid "The light's shadow rendering algorithm. See [enum ShadowMode]." msgstr "" +"L'algorithme de rendu de l'ombre pour cette lumière. Voir [enum ShadowMode]." #: doc/classes/DirectionalLight.xml msgid "" @@ -21820,9 +22037,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -21978,6 +22197,8 @@ msgstr "Retourne le nombre de polices de rechange." msgid "" "Returns the spacing for the given [code]type[/code] (see [enum SpacingType])." msgstr "" +"Retourne l'espacement pour le [code]type[/code] spécifié (voir [enum " +"SpacingType])." #: doc/classes/DynamicFont.xml msgid "Removes the fallback font at index [code]idx[/code]." @@ -22377,7 +22598,7 @@ msgstr "Représente la taille de l'énumération [enum Feature]." #: doc/classes/EditorFileDialog.xml msgid "A modified version of [FileDialog] used by the editor." -msgstr "" +msgstr "Une version modifié du [FileDialog] utilisé par l'éditeur." #: doc/classes/EditorFileDialog.xml msgid "" @@ -22389,7 +22610,7 @@ msgstr "" #: doc/classes/EditorFileDialog.xml msgid "Removes all filters except for \"All Files (*)\"." -msgstr "" +msgstr "Retire tous les filtres sauf \"Tous les fichiers (*)\"." #: doc/classes/EditorFileDialog.xml msgid "" @@ -22483,26 +22704,35 @@ msgid "" "The [EditorFileDialog] can select a file or directory. Accepting the window " "will open it." msgstr "" +"Le [EditorFileDialog] peut sélectionner un fichier ou un dossier. Le bouton " +"de validation de la fenêtre l'ouvrira." #: doc/classes/EditorFileDialog.xml msgid "" "The [EditorFileDialog] can select only one file. Accepting the window will " "save the file." msgstr "" +"Le [EditorFileDialog] ne peut sélectionner qu'un seul fichier. Le bouton de " +"validation de la fenêtre le sauvegardera." #: doc/classes/EditorFileDialog.xml msgid "" "The [EditorFileDialog] can only view [code]res://[/code] directory contents." msgstr "" +"Le [EditorFileDialog] ne peut afficher que le contenu des dossiers dans " +"[code]res://[/code]." #: doc/classes/EditorFileDialog.xml msgid "" "The [EditorFileDialog] can only view [code]user://[/code] directory contents." msgstr "" +"Le [EditorFileDialog] ne peut afficher que le contenu des dossiers dans " +"[code]user://[/code]." #: doc/classes/EditorFileDialog.xml msgid "The [EditorFileDialog] can view the entire local file system." msgstr "" +"Le [EditorFileDialog] peut voir l'entièreté du système de fichier local." #: doc/classes/EditorFileDialog.xml msgid "The [EditorFileDialog] displays resources as thumbnails." @@ -22511,10 +22741,12 @@ msgstr "Le [EditorFileDialog] affiche les ressources sous forme de miniatures." #: doc/classes/EditorFileDialog.xml msgid "The [EditorFileDialog] displays resources as a list of filenames." msgstr "" +"Le [EditorFileDialog] affiche les ressources comme une liste de nom de " +"fichiers." #: doc/classes/EditorFileSystem.xml msgid "Resource filesystem, as the editor sees it." -msgstr "" +msgstr "Le système de fichier des ressources, tel que le voit l'éditeur." #: doc/classes/EditorFileSystem.xml msgid "" @@ -22545,7 +22777,7 @@ msgstr "" #: doc/classes/EditorFileSystem.xml msgid "Returns [code]true[/code] of the filesystem is being scanned." -msgstr "" +msgstr "Retourne [code]true[/code] si le système de fichier a été scanné." #: doc/classes/EditorFileSystem.xml msgid "Scan the filesystem for changes." @@ -22553,7 +22785,7 @@ msgstr "Analysez le système de fichiers pour les modifications." #: doc/classes/EditorFileSystem.xml msgid "Check if the source of any imported resource changed." -msgstr "" +msgstr "Vérifie si la source de n'importe quelle ressources importée a changé." #: doc/classes/EditorFileSystem.xml msgid "" @@ -22582,7 +22814,7 @@ msgstr "" #: doc/classes/EditorFileSystem.xml msgid "Emitted if the source of any imported file changed." -msgstr "" +msgstr "Émis si la source de n'importe quel fichier a changé." #: doc/classes/EditorFileSystemDirectory.xml msgid "A directory for the resource filesystem." @@ -22597,30 +22829,36 @@ msgid "" "Returns the index of the directory with name [code]name[/code] or [code]-1[/" "code] if not found." msgstr "" +"Retourne l'index du dossier nommé [code]name[/code] ou [code]-1[/code] si " +"n'existe pas." #: doc/classes/EditorFileSystemDirectory.xml msgid "" "Returns the index of the file with name [code]name[/code] or [code]-1[/code] " "if not found." msgstr "" +"Retourne l'index du fichier nommé [code]name[/code] ou [code]-1[/code] si " +"n'existe pas." #: doc/classes/EditorFileSystemDirectory.xml msgid "Returns the name of the file at index [code]idx[/code]." -msgstr "" +msgstr "Retourne le nom du fichier à l'index [code]idx[/code]." #: doc/classes/EditorFileSystemDirectory.xml msgid "Returns the number of files in this directory." -msgstr "" +msgstr "Retourne le nombre de fichiers dans ce dossier." #: doc/classes/EditorFileSystemDirectory.xml msgid "" "Returns [code]true[/code] if the file at index [code]idx[/code] imported " "properly." msgstr "" +"Retourne [code]true[/code] si le fichier à la position [code]idx[/code] à " +"été importé correctement." #: doc/classes/EditorFileSystemDirectory.xml msgid "Returns the path to the file at index [code]idx[/code]." -msgstr "" +msgstr "Retourne le chemin du fichier à l'index [code]idx[/code]." #: doc/classes/EditorFileSystemDirectory.xml msgid "" @@ -22663,7 +22901,7 @@ msgstr "Retourne le sous-répertoire à l’index [code]idx[/code]." #: doc/classes/EditorFileSystemDirectory.xml msgid "Returns the number of subdirectories in this directory." -msgstr "" +msgstr "Retourne le nombre de sous-dossiers dans ce dossier." #: doc/classes/EditorImportPlugin.xml msgid "" @@ -22907,6 +23145,8 @@ msgstr "" #: doc/classes/EditorInspectorPlugin.xml msgid "Plugin for adding custom property editors on inspector." msgstr "" +"Un greffon pour ajouter des éditeurs de propriétés personnalisés dans " +"l'inspecteur." #: doc/classes/EditorInspectorPlugin.xml msgid "" @@ -23018,7 +23258,7 @@ msgstr "" #: doc/classes/EditorInterface.xml msgid "Returns the edited (current) scene's root [Node]." -msgstr "" +msgstr "Retourne le [Node] racine de l'actuelle scène éditée." #: doc/classes/EditorInterface.xml msgid "" @@ -23153,7 +23393,7 @@ msgstr "" #: doc/classes/EditorInterface.xml msgid "Saves the scene as a file at [code]path[/code]." -msgstr "" +msgstr "Enregistre la scène dans un fichier à l'emplacement [code]path[/code]." #: doc/classes/EditorInterface.xml msgid "" @@ -23176,6 +23416,8 @@ msgid "" "Sets the enabled status of a plugin. The plugin name is the same as its " "directory name." msgstr "" +"Définit le status d'activation du greffon. Le nom du greffon est le même que " +"celui de son dossier." #: doc/classes/EditorInterface.xml msgid "Stops the scene that is currently playing." @@ -23189,7 +23431,7 @@ msgstr "" #: doc/classes/EditorPlugin.xml msgid "Used by the editor to extend its functionality." -msgstr "" +msgstr "Utiliser par l'éditeur pour augmenter ses fonctionnalités." #: doc/classes/EditorPlugin.xml msgid "" @@ -23627,7 +23869,7 @@ msgstr "Supprime un type personnalisé ajouté par [method add_custom_type]." #: doc/classes/EditorPlugin.xml msgid "Removes a menu [code]name[/code] from [b]Project > Tools[/b]." -msgstr "" +msgstr "Retirer le menu nommé [code]name[/code] dans [b]Projet > Outils[/b]." #: doc/classes/EditorPlugin.xml msgid "" @@ -23702,6 +23944,8 @@ msgid "" "This control allows property editing for one or multiple properties into " "[EditorInspector]. It is added via [EditorInspectorPlugin]." msgstr "" +"Ce contrôle permet de modifier plusieurs propriétés dans [EditorInspector]. " +"Il est ajouté via [EditorInspectorPlugin]." #: doc/classes/EditorProperty.xml msgid "" @@ -23768,6 +24012,8 @@ msgid "" "Used by the inspector, set to [code]true[/code] when the property can add " "keys for animation." msgstr "" +"Utilisé par l'inspecteur, définit à [code]true[/code] si la propriété peut " +"ajouter une clé pour être animée." #: doc/classes/EditorProperty.xml msgid "Set this property to change the label (if you want to show one)." @@ -23880,6 +24126,8 @@ msgid "" "The base type of allowed resource types. Can be a comma-separated list of " "several options." msgstr "" +"Le type de base des types de ressources autorisées. Ça peut être une liste " +"de plusieurs options séparées par des virgules." #: doc/classes/EditorResourcePicker.xml msgid "If [code]true[/code], the value can be selected and edited." @@ -24107,6 +24355,8 @@ msgid "" "Returns the source file path which got imported (e.g. [code]res://scene.dae[/" "code])." msgstr "" +"Retourne le chemin du fichier qui vient d'être importé (ex.: [code]res://" +"scene.dae[/code])." #: doc/classes/EditorScenePostImport.xml msgid "Returns the resource folder the imported scene file is located in." @@ -24189,7 +24439,7 @@ msgstr "" #: doc/classes/EditorSelection.xml msgid "Manages the SceneTree selection in the editor." -msgstr "" +msgstr "Gère la sélection du SceneTree depuis l'éditeur." #: doc/classes/EditorSelection.xml msgid "" @@ -24232,6 +24482,7 @@ msgstr "Émis lorsque la sélection change." #: doc/classes/EditorSettings.xml msgid "Object that holds the project-independent editor settings." msgstr "" +"L'objet qui contient les préférences de l'éditeur indépendamment des projets." #: doc/classes/EditorSettings.xml msgid "" @@ -24704,6 +24955,8 @@ msgstr "" #: doc/classes/EditorVCSInterface.xml msgid "Discards the changes made in file present at [code]file_path[/code]." msgstr "" +"Ignore les modifications faites dans le fichier à l'emplacement " +"[code]file_path[/code]." #: doc/classes/EditorVCSInterface.xml msgid "" @@ -24932,6 +25185,9 @@ msgid "" "The [Object] identifier stored in this [EncodedObjectAsID] instance. The " "object instance can be retrieved with [method @GDScript.instance_from_id]." msgstr "" +"L'identifiant du [Object] est enregistré dans cette instance " +"[EncodedObjectAsID]. L'instance de l'objet peut être récupérée avec [method " +"@GDScript.instance_from_id]." #: doc/classes/Engine.xml msgid "Access to engine properties." @@ -24980,7 +25236,7 @@ msgstr "" #: doc/classes/Engine.xml msgid "Returns the frames per second of the running game." -msgstr "" +msgstr "Retourne le nombre de trames par seconde du jeu lancé." #: doc/classes/Engine.xml msgid "" @@ -25038,6 +25294,8 @@ msgid "" "Returns a global singleton with given [code]name[/code]. Often used for " "plugins, e.g. [code]GodotPayment[/code] on Android." msgstr "" +"Retourne l'instance unique avec le nom [code]name[/code]. Souvent utilisé " +"pour les greffons, par ex. [code]GodotPayment[/code] sur Android." #: doc/classes/Engine.xml msgid "" @@ -25095,7 +25353,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -25232,6 +25490,8 @@ msgid "" "The global brightness value of the rendered scene. Effective only if " "[code]adjustment_enabled[/code] is [code]true[/code]." msgstr "" +"La luminosité globale des scènes rendues. Ne fonctionne que si " +"[code]adjustment_enabled[/code] est [code]true[/code]." #: doc/classes/Environment.xml msgid "" @@ -25239,12 +25499,18 @@ msgid "" "the rendered scene. Effective only if [code]adjustment_enabled[/code] is " "[code]true[/code]." msgstr "" +"Applique une [Texture] pour modifier l'apparence des couleurs dans les " +"scènes rendues. Ne fonctionne que si [code]adjustment_enabled[/code] est " +"[code]true[/code]." #: doc/classes/Environment.xml msgid "" "The global contrast value of the rendered scene (default value is 1). " "Effective only if [code]adjustment_enabled[/code] is [code]true[/code]." msgstr "" +"La valeur globale du contraste dans les scènes rendues (la valeur par défaut " +"est 1). Ne fonctionne que si [code]adjustment_enabled[/code] est [code]true[/" +"code]." #: doc/classes/Environment.xml msgid "" @@ -25259,6 +25525,9 @@ msgid "" "The global color saturation value of the rendered scene (default value is " "1). Effective only if [code]adjustment_enabled[/code] is [code]true[/code]." msgstr "" +"La valeur globale de la saturation des couleurs dans les scènes rendues (la " +"valeur par défaut est 1). Ne fonctionne que si [code]adjustment_enabled[/" +"code] est [code]true[/code]." #: doc/classes/Environment.xml msgid "The ambient light's [Color]." @@ -25327,11 +25596,11 @@ msgstr "" #: doc/classes/Environment.xml msgid "The power of the light emitted by the background." -msgstr "" +msgstr "L'intensité de la lumière émise par l'arrière-plan." #: doc/classes/Environment.xml msgid "The background mode. See [enum BGMode] for possible values." -msgstr "" +msgstr "Le mode d'arrière-plan. Voir [enum BGMode] pour les valeurs possibles." #: doc/classes/Environment.xml msgid "The [Sky] resource defined as background." @@ -25405,6 +25674,7 @@ msgstr "" #: doc/classes/Environment.xml msgid "The length of the transition between the near blur and no-blur area." msgstr "" +"La longueur de la transition entre le flou proche et la zone sans flou." #: doc/classes/Environment.xml msgid "The fog's [Color]." @@ -25413,6 +25683,7 @@ msgstr "La [Color] du brouillard." #: doc/classes/Environment.xml msgid "The fog's depth starting distance from the camera." msgstr "" +"La distance de début du brouillard de profondeur par rapport à la caméra." #: doc/classes/Environment.xml msgid "" @@ -25563,32 +25834,36 @@ msgid "" "If [code]true[/code], the 1st level of glow is enabled. This is the most " "\"local\" level (least blurry)." msgstr "" +"Si [code]true[/code], le premier niveau de lueur est active. C'est le niveau " +"le plus \"local\" (le moins flou)." #: doc/classes/Environment.xml msgid "If [code]true[/code], the 2th level of glow is enabled." -msgstr "" +msgstr "Si [code]true[/code], le 2e niveau de lueur est actif." #: doc/classes/Environment.xml msgid "If [code]true[/code], the 3th level of glow is enabled." -msgstr "" +msgstr "Si [code]true[/code], le 3e niveau de lueur est actif." #: doc/classes/Environment.xml msgid "If [code]true[/code], the 4th level of glow is enabled." -msgstr "" +msgstr "Si [code]true[/code], le 4e niveau de lueur est actif." #: doc/classes/Environment.xml msgid "If [code]true[/code], the 5th level of glow is enabled." -msgstr "" +msgstr "Si [code]true[/code], le 5e niveau de lueur est actif." #: doc/classes/Environment.xml msgid "If [code]true[/code], the 6th level of glow is enabled." -msgstr "" +msgstr "Si [code]true[/code], le 6e niveau de lueur est actif." #: doc/classes/Environment.xml msgid "" "If [code]true[/code], the 7th level of glow is enabled. This is the most " "\"global\" level (blurriest)." msgstr "" +"Si [code]true[/code], le 7e niveau de lueur est actif. C'est le niveau le " +"plus \"global\" (le plus flou)." #: doc/classes/Environment.xml msgid "" @@ -25632,6 +25907,8 @@ msgid "" "If [code]true[/code], screen-space reflections will take the material " "roughness into account." msgstr "" +"Si [code]true[/code], la réflexion à l'écran prendre la rugosité du matériau " +"en compte." #: doc/classes/Environment.xml msgid "" @@ -25751,6 +26028,7 @@ msgstr "" #: doc/classes/Environment.xml msgid "Clears the background using a custom clear color." msgstr "" +"Efface l'arrière-plan en utilisant la couleur d'effacement personnalisée." #: doc/classes/Environment.xml msgid "Displays a user-defined sky in the background." @@ -25803,34 +26081,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -#, fuzzy -msgid "Filmic tonemapper operator." -msgstr "Opérateur de mappage de tons filmique." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." +msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -25879,7 +26166,7 @@ msgstr "Qualité la plus basse de l’occlusion ambiante d’espace d’écran." #: doc/classes/Expression.xml msgid "A class that stores an expression you can execute." -msgstr "" +msgstr "Une classe qui enregistre une expression que vous pouvez exécuter." #: doc/classes/Expression.xml msgid "" @@ -25918,7 +26205,7 @@ msgstr "" #: doc/classes/Expression.xml msgid "Returns the error text if [method parse] has failed." -msgstr "" +msgstr "Retourne la description de l'erreur si [method parse] a échoué." #: doc/classes/Expression.xml msgid "Returns [code]true[/code] if [method execute] has failed." @@ -25954,7 +26241,7 @@ msgstr "La taille de la texture externe." #: doc/classes/File.xml msgid "Type to handle file reading and writing operations." -msgstr "" +msgstr "Le type pour gérer les opérations de lecture et d'écriture." #: doc/classes/File.xml msgid "" @@ -26040,30 +26327,44 @@ msgid "" "Returns the next 16 bits from the file as an integer. See [method store_16] " "for details on what values can be stored and retrieved this way." msgstr "" +"Retourne les 16 bits suivant du fichier interprété en un entier. Voir " +"[method store_16] pour les détails sur les valeurs qui peuvent être " +"enregistrées et récupérées de cette manière." #: doc/classes/File.xml msgid "" "Returns the next 32 bits from the file as an integer. See [method store_32] " "for details on what values can be stored and retrieved this way." msgstr "" +"Retourne les 32 bits suivant du fichier interprété en un entier. Voir " +"[method store_32] pour les détails sur les valeurs qui peuvent être " +"enregistrées et récupérées de cette manière." #: doc/classes/File.xml msgid "" "Returns the next 64 bits from the file as an integer. See [method store_64] " "for details on what values can be stored and retrieved this way." msgstr "" +"Retourne les 64 bits suivant du fichier interprété en un entier. Voir " +"[method store_64] pour les détails sur les valeurs qui peuvent être " +"enregistrées et récupérées de cette manière." #: doc/classes/File.xml msgid "" "Returns the next 8 bits from the file as an integer. See [method store_8] " "for details on what values can be stored and retrieved this way." msgstr "" +"Retourne les 8 bits suivant du fichier interprété en un entier. Voir [method " +"store_8] pour les détails sur les valeurs qui peuvent être enregistrées et " +"récupérées de cette manière." #: doc/classes/File.xml msgid "" "Returns the whole file as a [String].\n" "Text is interpreted as being UTF-8 encoded." msgstr "" +"Retourne le fichier complet en [String].\n" +"Le texte est interprété comme étant encodé en UTF-8." #: doc/classes/File.xml #, fuzzy @@ -26096,16 +26397,21 @@ msgstr "" #: doc/classes/File.xml msgid "Returns the next 64 bits from the file as a floating-point number." msgstr "" +"Retourne les 64 bits suivants du fichier en les interprétant en un flottant." #: doc/classes/File.xml msgid "" "Returns the last error that happened when trying to perform operations. " "Compare with the [code]ERR_FILE_*[/code] constants from [enum Error]." msgstr "" +"Retourne la dernière erreur qui est arrivé lors de l'exécution d'une " +"opération. Les erreurs sont au format [code]ERR_FILE_*[/code] dans " +"l'énumération [enum Error]." #: doc/classes/File.xml msgid "Returns the next 32 bits from the file as a floating-point number." msgstr "" +"Retourne les 32 bits suivants du fichier en les interprétant en un flottant." #: doc/classes/File.xml msgid "Returns the size of the file in bytes." @@ -26116,12 +26422,16 @@ msgid "" "Returns the next line of the file as a [String].\n" "Text is interpreted as being UTF-8 encoded." msgstr "" +"Retourne la ligne suivant du fichier en [String].\n" +"Le texte est interprété comme étant codé en UTF-8." #: doc/classes/File.xml msgid "" "Returns an MD5 String representing the file at the given path or an empty " "[String] on failure." msgstr "" +"Retourne le MD5 du fichier au chemin spécifié ou une [String] vide en cas " +"d'échec." #: doc/classes/File.xml msgid "" @@ -26136,6 +26446,8 @@ msgid "" "Returns a [String] saved in Pascal format from the file.\n" "Text is interpreted as being UTF-8 encoded." msgstr "" +"Retourne une [String] enregistrée au format Pascal depuis le fichier.\n" +"Le texte est interprété comme étant codé en UTF-8." #: doc/classes/File.xml msgid "Returns the path as a [String] for the current open file." @@ -26144,7 +26456,7 @@ msgstr "" #: doc/classes/File.xml msgid "Returns the absolute path as a [String] for the current open file." -msgstr "" +msgstr "Retourne le chemin absolu en [String] pour l'actuel fichier ouvert." #: doc/classes/File.xml msgid "Returns the file cursor's position." @@ -26159,6 +26471,8 @@ msgid "" "Returns a SHA-256 [String] representing the file at the given path or an " "empty [String] on failure." msgstr "" +"Retourne le SHA-256 du fichier au chemin spécifié ou une [String] vide en " +"cas d'échec." #: doc/classes/File.xml msgid "" @@ -26171,7 +26485,7 @@ msgstr "" #: doc/classes/File.xml msgid "Returns [code]true[/code] if the file is currently opened." -msgstr "" +msgstr "Retourne [code]true[/code] si le fichier est actuellement ouvert." #: doc/classes/File.xml msgid "Opens the file for writing or reading, depending on the flags." @@ -26268,7 +26582,7 @@ msgstr "" #: doc/classes/File.xml msgid "Stores the given array of bytes in the file." -msgstr "" +msgstr "Enregistre le tableau spécifié en octets dans le fichier." #: doc/classes/File.xml msgid "" @@ -26281,11 +26595,11 @@ msgstr "" #: doc/classes/File.xml msgid "Stores a floating-point number as 64 bits in the file." -msgstr "" +msgstr "Enregistre un flottant 64 bits dans le fichier." #: doc/classes/File.xml msgid "Stores a floating-point number as 32 bits in the file." -msgstr "" +msgstr "Enregistre un flottant 32 bits dans le fichier." #: doc/classes/File.xml msgid "" @@ -26411,6 +26725,8 @@ msgstr "" #: doc/classes/FileDialog.xml msgid "Dialog for selecting files or directories in the filesystem." msgstr "" +"Le dialogue pour sélectionner des fichiers et dossier dans le système de " +"fichiers." #: doc/classes/FileDialog.xml msgid "" @@ -26435,7 +26751,7 @@ msgstr "" #: doc/classes/FileDialog.xml msgid "Clear all the added filters in the dialog." -msgstr "" +msgstr "Efface tous les filtres ajoutés au dialogue." #: doc/classes/FileDialog.xml msgid "Clear currently selected items in the dialog." @@ -26481,7 +26797,7 @@ msgstr "L'actuel fichier sélectionné dans le dialogue de choix de fichier." #: doc/classes/FileDialog.xml msgid "The currently selected file path of the file dialog." -msgstr "" +msgstr "L'actuel chemin de fichier sélectionné dans le dialogue de fichier." #: doc/classes/FileDialog.xml msgid "" @@ -26497,6 +26813,8 @@ msgid "" "The dialog's open or save mode, which affects the selection behavior. See " "enum [code]Mode[/code] constants." msgstr "" +"Le mode d'ouverture ou de sauvegarde du dialogue, qui peut définir le " +"comportement de la sélection. Voir les constantes dans [code]Mode[/code]." #: doc/classes/FileDialog.xml msgid "" @@ -26525,7 +26843,7 @@ msgstr "Émis quand l'utilisateur sélectionne plusieurs fichiers." #: doc/classes/FileDialog.xml msgid "The dialog allows selecting one, and only one file." -msgstr "" +msgstr "Le dialogue n'autorise la sélection que d'un seul fichier." #: doc/classes/FileDialog.xml msgid "The dialog allows selecting multiple files." @@ -26561,6 +26879,7 @@ msgstr "" #: doc/classes/FileDialog.xml msgid "The dialog allows accessing files on the whole file system." msgstr "" +"Le dialogue permet d'accéder à tous les fichiers du système de fichiers." #: doc/classes/FileDialog.xml msgid "The color modulation applied to the file icon." @@ -26743,6 +27062,8 @@ msgid "" "Returns the size that the string would have with word wrapping enabled with " "a fixed [code]width[/code]." msgstr "" +"Retourne la taille que ce texte aurait si les retours à la ligne sont actifs " +"avec une largeur fixe de [code]width[/code]." #: doc/classes/Font.xml msgid "Returns [code]true[/code] if the font has an outline." @@ -26949,7 +27270,7 @@ msgstr "" #: doc/classes/Generic6DOFJoint.xml msgid "If [code]true[/code], rotation across the X axis is limited." -msgstr "" +msgstr "Si [code]true[/code], la rotation autour de l'axe X est limité." #: doc/classes/Generic6DOFJoint.xml msgid "" @@ -26961,6 +27282,8 @@ msgstr "" msgid "" "The maximum amount of force that can occur, when rotating around the X axis." msgstr "" +"La quantité maximale de force qui peut être appliquée, lors de la rotation " +"autour de l'axe X." #: doc/classes/Generic6DOFJoint.xml msgid "" @@ -27004,6 +27327,8 @@ msgstr "" msgid "" "The maximum amount of force that can occur, when rotating around the Y axis." msgstr "" +"La quantité maximale de force qui peut être appliquée, lors de la rotation " +"autour de l'axe Y." #: doc/classes/Generic6DOFJoint.xml msgid "" @@ -27047,6 +27372,8 @@ msgstr "" msgid "" "The maximum amount of force that can occur, when rotating around the Z axis." msgstr "" +"La quantité maximale de force qui peut être appliquée, lors de la rotation " +"autour de l'axe Z." #: doc/classes/Generic6DOFJoint.xml msgid "" @@ -27072,43 +27399,43 @@ msgstr "" #: doc/classes/Generic6DOFJoint.xml msgid "If [code]true[/code], a rotating motor at the X axis is enabled." -msgstr "" +msgstr "Si [code]true[/code], la rotation du moteur selon l'axe X est activée." #: doc/classes/Generic6DOFJoint.xml msgid "Maximum acceleration for the motor at the X axis." -msgstr "" +msgstr "L'accélération maximale du moteur selon l'axe X." #: doc/classes/Generic6DOFJoint.xml msgid "Target speed for the motor at the X axis." -msgstr "" +msgstr "La vitesse cible du moteur selon l'axe X." #: doc/classes/Generic6DOFJoint.xml msgid "If [code]true[/code], a rotating motor at the Y axis is enabled." -msgstr "" +msgstr "Si [code]true[/code], la rotation du moteur selon l'axe Y est activée." #: doc/classes/Generic6DOFJoint.xml msgid "Maximum acceleration for the motor at the Y axis." -msgstr "" +msgstr "L'accélération maximale du moteur selon l'axe Y." #: doc/classes/Generic6DOFJoint.xml msgid "Target speed for the motor at the Y axis." -msgstr "" +msgstr "La vitesse cible du moteur selon l'axe Y." #: doc/classes/Generic6DOFJoint.xml msgid "If [code]true[/code], a rotating motor at the Z axis is enabled." -msgstr "" +msgstr "Si [code]true[/code], la rotation du moteur selon l'axe Z est activée." #: doc/classes/Generic6DOFJoint.xml msgid "Maximum acceleration for the motor at the Z axis." -msgstr "" +msgstr "L'accélération maximale du moteur selon l'axe Z." #: doc/classes/Generic6DOFJoint.xml msgid "Target speed for the motor at the Z axis." -msgstr "" +msgstr "La vitesse cible du moteur selon l'axe Z." #: doc/classes/Generic6DOFJoint.xml msgid "The amount of damping that happens at the X motion." -msgstr "" +msgstr "La quantité d'amortissement pour les déplacements le long de l'axe X." #: doc/classes/Generic6DOFJoint.xml msgid "If [code]true[/code], the linear motion across the X axis is limited." @@ -27123,6 +27450,8 @@ msgid "" "The amount of restitution on the X axis movement. The lower, the more " "momentum gets lost." msgstr "" +"La quantité restituée pour les mouvements selon l'axe X. Plus basse est la " +"valeur, plus d'inertie sera perdue." #: doc/classes/Generic6DOFJoint.xml msgid "" @@ -27136,11 +27465,11 @@ msgstr "" #: doc/classes/Generic6DOFJoint.xml msgid "The amount of damping that happens at the Y motion." -msgstr "" +msgstr "La quantité d'amortissement pour les déplacements le long de l'axe Y." #: doc/classes/Generic6DOFJoint.xml msgid "If [code]true[/code], the linear motion across the Y axis is limited." -msgstr "" +msgstr "Si [code]true[/code], le mouvement linéaire selon l'axe Y est limité." #: doc/classes/Generic6DOFJoint.xml msgid "The minimum difference between the pivot points' Y axis." @@ -27151,8 +27480,8 @@ msgid "" "The amount of restitution on the Y axis movement. The lower, the more " "momentum gets lost." msgstr "" -"Montant de la restitution sur le mouvement de l’axe Y. Plus c'est bas, plus " -"l’élan se perd." +"La quantité restituée pour les mouvements selon l'axe Y. Plus basse est la " +"valeur, plus d'inertie sera perdue." #: doc/classes/Generic6DOFJoint.xml msgid "" @@ -27168,7 +27497,7 @@ msgstr "La différence maximale entre l'axe Y des points de pivot." #: doc/classes/Generic6DOFJoint.xml msgid "The amount of damping that happens at the Z motion." -msgstr "La quantité d’amortissement qui se produit au mouvement Z." +msgstr "La quantité d'amortissement pour les déplacements le long de l'axe Z." #: doc/classes/Generic6DOFJoint.xml msgid "If [code]true[/code], the linear motion across the Z axis is limited." @@ -27213,7 +27542,7 @@ msgstr "" #: doc/classes/Generic6DOFJoint.xml msgid "The speed that the linear motor will attempt to reach on the X axis." -msgstr "" +msgstr "La vitesse que le moteur linéaire essayera d'atteindre selon l'axe X." #: doc/classes/Generic6DOFJoint.xml msgid "" @@ -27229,7 +27558,7 @@ msgstr "" #: doc/classes/Generic6DOFJoint.xml msgid "The speed that the linear motor will attempt to reach on the Y axis." -msgstr "" +msgstr "La vitesse que le moteur linéaire essayera d'atteindre selon l'axe Y." #: doc/classes/Generic6DOFJoint.xml msgid "" @@ -27245,7 +27574,7 @@ msgstr "" #: doc/classes/Generic6DOFJoint.xml msgid "The speed that the linear motor will attempt to reach on the Z axis." -msgstr "" +msgstr "La vitesse que le moteur linéaire essayera d'atteindre selon l'axe Z." #: doc/classes/Generic6DOFJoint.xml doc/classes/PhysicsServer.xml msgid "The minimum difference between the pivot points' axes." @@ -27331,11 +27660,12 @@ msgstr "" #: doc/classes/Generic6DOFJoint.xml msgid "If enabled, linear motion is possible within the given limits." -msgstr "" +msgstr "Si actif, le mouvement linéaire est possible dans les limites données." #: doc/classes/Generic6DOFJoint.xml msgid "If enabled, rotational motion is possible within the given limits." msgstr "" +"Si actif, le mouvement de rotation est possible dans les limites données." #: doc/classes/Generic6DOFJoint.xml msgid "If enabled, there is a rotational motor across these axes." @@ -27999,6 +28329,7 @@ msgstr "" #: doc/classes/GIProbe.xml msgid "The [GIProbeData] resource that holds the data for this [GIProbe]." msgstr "" +"La ressource [GIProbeData] qui contient les données de cette [GIProbe]." #: doc/classes/GIProbe.xml msgid "" @@ -28226,11 +28557,11 @@ msgstr "" #: modules/mono/doc_classes/GodotSharp.xml msgid "Attaches the current thread to the Mono runtime." -msgstr "" +msgstr "Attache le fil d'exécution actuel à Mono." #: modules/mono/doc_classes/GodotSharp.xml msgid "Detaches the current thread from the Mono runtime." -msgstr "" +msgstr "Détache le fil d'exécution actuel à Mono." #: modules/mono/doc_classes/GodotSharp.xml msgid "" @@ -29215,14 +29546,17 @@ msgstr "" #: modules/gridmap/doc_classes/GridMap.xml msgid "If [code]true[/code], grid items are centered on the X axis." msgstr "" +"Si [code]true[/code], les éléments de la grille sont centrés sur l'axe X." #: modules/gridmap/doc_classes/GridMap.xml msgid "If [code]true[/code], grid items are centered on the Y axis." msgstr "" +"Si [code]true[/code], les éléments de la grille sont centrés sur l'axe Y." #: modules/gridmap/doc_classes/GridMap.xml msgid "If [code]true[/code], grid items are centered on the Z axis." msgstr "" +"Si [code]true[/code], les éléments de la grille sont centrés sur l'axe Z." #: modules/gridmap/doc_classes/GridMap.xml msgid "" @@ -29502,7 +29836,7 @@ msgstr "" #: doc/classes/HMACContext.xml msgid "Used to create an HMAC for a message using a key." -msgstr "" +msgstr "Utilisé pour créer un HMAC pour un message utilisant une clé." #: doc/classes/HMACContext.xml msgid "" @@ -29581,6 +29915,8 @@ msgstr "Barre de défilement horizontale." msgid "" "Horizontal version of [ScrollBar], which goes from left (min) to right (max)." msgstr "" +"La version horizontale de la [ScrollBar], qui va de la gauche (minimum) vers " +"la droite (maximum)." #: doc/classes/HScrollBar.xml msgid "" @@ -29627,7 +29963,7 @@ msgstr "Utilisé lorsque la souris survole le grappin." #: doc/classes/HScrollBar.xml doc/classes/VScrollBar.xml msgid "Used when the grabber is being dragged." -msgstr "" +msgstr "Utilisé quand le glisseur est en train d'être glissé." #: doc/classes/HScrollBar.xml doc/classes/VScrollBar.xml msgid "Used as background of this [ScrollBar]." @@ -29656,6 +29992,7 @@ msgstr "" #: doc/classes/HSeparator.xml msgid "The style for the separator line. Works best with [StyleBoxLine]." msgstr "" +"Le style pour la ligne de séparation. Fonctionne mieux avec [StyleBoxLine]." #: doc/classes/HSlider.xml msgid "Horizontal slider." @@ -29671,15 +30008,15 @@ msgstr "" #: doc/classes/HSlider.xml doc/classes/VSlider.xml msgid "The texture for the grabber (the draggable element)." -msgstr "" +msgstr "La texture du glisseur (l'élément déplaçable)." #: doc/classes/HSlider.xml doc/classes/VSlider.xml msgid "The texture for the grabber when it's disabled." -msgstr "" +msgstr "La texture du glisseur quand il est désactivé." #: doc/classes/HSlider.xml doc/classes/VSlider.xml msgid "The texture for the grabber when it's focused." -msgstr "" +msgstr "La texture du glisseur quand il a le focus." #: doc/classes/HSlider.xml doc/classes/VSlider.xml msgid "" @@ -29967,6 +30304,8 @@ msgid "" "HTTP DELETE method. The DELETE method requests to delete the specified " "resource." msgstr "" +"La méthode HTTP \"DELETE\". Elle permet de demander la suppression de la " +"ressource spécifiée." #: doc/classes/HTTPClient.xml msgid "" @@ -30724,34 +31063,42 @@ msgstr "Importer des images" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -30823,7 +31170,7 @@ msgstr "" msgid "" "Stretches the image and enlarges it by a factor of 2. No interpolation is " "done." -msgstr "" +msgstr "Étire l'image en 2 fois plus grande. Aucune interpolation n'est faite." #: doc/classes/Image.xml msgid "Fills the image with [code]color[/code]." @@ -30965,7 +31312,7 @@ msgstr "Charge une image à partir du contenu binaire d’un fichier TGA." #: doc/classes/Image.xml msgid "Loads an image from the binary contents of a WebP file." -msgstr "" +msgstr "Charge une image depuis le contenu binaire d'un fichier WebP." #: doc/classes/Image.xml msgid "" @@ -31269,6 +31616,9 @@ msgid "" "BPTC_Texture_Compression]BPTC[/url] compression with signed floating-point " "RGB components." msgstr "" +"Le format de texture qui utilise la compression [url=https://www.khronos.org/" +"opengl/wiki/BPTC_Texture_Compression]BPTC[/url] avec des flottants signés " +"pour les composants RGB." #: doc/classes/Image.xml msgid "" @@ -31276,6 +31626,9 @@ msgid "" "BPTC_Texture_Compression]BPTC[/url] compression with unsigned floating-point " "RGB components." msgstr "" +"Le format de texture qui utilise la compression [url=https://www.khronos.org/" +"opengl/wiki/BPTC_Texture_Compression]BPTC[/url] avec des flottants non-" +"signés pour les composants RGB." #: doc/classes/Image.xml msgid "" @@ -31299,6 +31652,8 @@ msgid "" "Similar to [url=https://en.wikipedia.org/wiki/PVRTC]PVRTC2[/url], but with 4-" "bit color depth and no alpha." msgstr "" +"Similaire à [url=https://en.wikipedia.org/wiki/PVRTC]PVRTC2[/url], mais avec " +"4 bits par canal et pas d'alpha." #: doc/classes/Image.xml msgid "" @@ -31697,7 +32052,7 @@ msgstr "" #: doc/classes/Input.xml msgid "If the specified action is already pressed, this will release it." -msgstr "" +msgstr "Si l'action spécifiée est déjà pressé, elle sera relâchée." #: doc/classes/Input.xml msgid "" @@ -31817,6 +32172,8 @@ msgid "" "Receives a gamepad button from [enum JoystickList] and returns its " "equivalent name as a string." msgstr "" +"Reçoit un bouton d'un manette depuis [enum JoystickList] et retourne son nom " +"équivalent." #: doc/classes/Input.xml msgid "" @@ -31826,7 +32183,7 @@ msgstr "" #: doc/classes/Input.xml msgid "Returns the name of the joypad at the specified device index." -msgstr "" +msgstr "Retourne le nom du contrôleur pour l'index de l'appareil spécifié." #: doc/classes/Input.xml msgid "Returns the duration of the current vibration effect in seconds." @@ -32101,8 +32458,10 @@ msgstr "Arrête la vibration du joypad." #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -32457,7 +32816,7 @@ msgstr "" #: doc/classes/InputEventJoypadButton.xml msgid "Button identifier. One of the [enum JoystickList] button constants." -msgstr "" +msgstr "L'identifiant du bouton. Une des constantes de [enum JoystickList]." #: doc/classes/InputEventJoypadButton.xml msgid "" @@ -32939,8 +33298,13 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." -msgstr "Retourne une tableau des [InputEvent] associés à cette action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." +msgstr "" #: doc/classes/InputMap.xml msgid "Returns an array of all actions in the [InputMap]." @@ -33106,9 +33470,24 @@ msgstr "" msgid "The target's [NodePath]." msgstr "La cible du [NodePath]." +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" +"Le protocole internet (IP) supporte des fonctionnalités comme la résolution " +"DNS." #: doc/classes/IP.xml msgid "" @@ -33275,6 +33654,8 @@ msgid "" "Ensure current selection is visible, adjusting the scroll position as " "necessary." msgstr "" +"S'assure que l'actuelle sélection est visible, en ajustant l'ascenseur si " +"nécessaire." #: doc/classes/ItemList.xml msgid "" @@ -33349,6 +33730,8 @@ msgstr "" msgid "" "Returns [code]true[/code] if the item at the specified index is disabled." msgstr "" +"Retourne [code]true[/code] si l'élément à la position spécifiée est " +"désactivé." #: doc/classes/ItemList.xml msgid "" @@ -33781,7 +34164,7 @@ msgstr "" #: doc/classes/JavaScriptObject.xml msgid "A wrapper class for native JavaScript objects." -msgstr "" +msgstr "Un classe d'encapsulation pour les objets JavaScript natifs." #: doc/classes/JavaScriptObject.xml msgid "" @@ -33906,11 +34289,13 @@ msgstr "" #: doc/classes/Joint2D.xml msgid "The first body attached to the joint. Must derive from [PhysicsBody2D]." msgstr "" +"Le premier corps attaché à l'articulation. Doit hériter de [PhysicsBody2D]." #: doc/classes/Joint2D.xml msgid "" "The second body attached to the joint. Must derive from [PhysicsBody2D]." msgstr "" +"Le second corps attaché à l'articulation. Doit hériter de [PhysicsBody2D]." #: doc/classes/JSON.xml msgid "Helper class for parsing JSON data." @@ -34744,7 +35129,7 @@ msgstr "Aligne l’ensemble du texte vers le bas." #: doc/classes/Label.xml msgid "Align the whole text by spreading the rows." -msgstr "" +msgstr "Aligne tout le texte en étirant les lignes." #: doc/classes/Label.xml msgid "Default text [Color] of the [Label]." @@ -35269,7 +35654,8 @@ msgstr "Une ligne 2D." #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -35310,13 +35696,23 @@ msgid "" "Overwrites the position in point [code]i[/code] with the supplied " "[code]position[/code]." msgstr "" +"Remplace la position du point [code]i[/code] par la [code]position[/code] " +"spécifiée." #: doc/classes/Line2D.xml -#, fuzzy msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." -msgstr "Si [code]true[/code], la frontière de la ligne sera anti-aliasée." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." +msgstr "" #: doc/classes/Line2D.xml msgid "" @@ -35698,10 +36094,11 @@ msgstr "Émis lorsque le texte change." #: doc/classes/LineEdit.xml msgid "Emitted when the user presses [constant KEY_ENTER] on the [LineEdit]." msgstr "" +"Émis quand l'utilisateur presse [constant KEY_ENTER] dans le [LineEdit]." #: doc/classes/LineEdit.xml msgid "Aligns the text on the left-hand side of the [LineEdit]." -msgstr "" +msgstr "Aligne le texte à gauche dans le [LineEdit]." #: doc/classes/LineEdit.xml msgid "Centers the text in the middle of the [LineEdit]." @@ -35709,7 +36106,7 @@ msgstr "Centre le texte au milieu de la [LineEdit]." #: doc/classes/LineEdit.xml msgid "Aligns the text on the right-hand side of the [LineEdit]." -msgstr "" +msgstr "Aligne le texte à droite dans le [LineEdit]." #: doc/classes/LineEdit.xml msgid "Stretches whitespaces to fit the [LineEdit]'s width." @@ -35753,11 +36150,11 @@ msgstr "Représente la taille de l'énumération [enum MenuItems]." #: doc/classes/LineEdit.xml msgid "Color used as default tint for the clear button." -msgstr "" +msgstr "La couleur utilisée pour la teinte par défaut pour le bouton effacer." #: doc/classes/LineEdit.xml msgid "Color used for the clear button when it's pressed." -msgstr "" +msgstr "La couleur utilisée pour le bouton effacer quand il est appuyé." #: doc/classes/LineEdit.xml msgid "Color of the [LineEdit]'s visual cursor (caret)." @@ -35885,6 +36282,7 @@ msgstr "La [Color] de texte utilisée quand le [LinkButton] est pressé." #: doc/classes/LinkButton.xml msgid "The vertical space between the baseline of text and the underline." msgstr "" +"L'espacement vertical entre la ligne de base du texte et le surlignage." #: doc/classes/LinkButton.xml msgid "[Font] of the [LinkButton]'s text." @@ -36094,10 +36492,12 @@ msgid "" "Should not be called manually, override [method _iteration] instead. Will be " "removed in Godot 4.0." msgstr "" +"Ne doit pas être appelé manuellement, utilisez [method _iteration] plutôt. " +"Sera supprimé dans Godot 4.0." #: doc/classes/MainLoop.xml msgid "Emitted when a user responds to a permission request." -msgstr "" +msgstr "Émis quand l'utilisateur répond à une demande de permission." #: doc/classes/MainLoop.xml doc/classes/Node.xml msgid "" @@ -36342,7 +36742,7 @@ msgstr "La valeur minimale pour le paramètre [member render_priority]." #: doc/classes/MenuButton.xml msgid "Special button that brings up a [PopupMenu] when clicked." -msgstr "" +msgstr "Un bouton spécial qui fait apparaitre un [PopupMenu] quand cliqué." #: doc/classes/MenuButton.xml msgid "" @@ -36523,7 +36923,7 @@ msgstr "" #: doc/classes/Mesh.xml msgid "Render array as points (one vertex equals one point)." -msgstr "" +msgstr "Rend le tableau avec des points (un sommet affiche un point)." #: doc/classes/Mesh.xml msgid "Render array as lines (every two vertices a line is created)." @@ -36608,6 +37008,8 @@ msgid "" "Used internally to calculate other [code]ARRAY_COMPRESS_*[/code] enum " "values. Do not use." msgstr "" +"Utilisé en interne pour calculer les autres valeurs [code]ARRAY_COMPRESS_*[/" +"code]. Ne pas utiliser." #: doc/classes/Mesh.xml doc/classes/VisualServer.xml msgid "Flag used to mark a compressed (half float) vertex array." @@ -37200,7 +37602,7 @@ msgstr "" #: doc/classes/MeshTexture.xml msgid "Simple texture that uses a mesh to draw itself." -msgstr "" +msgstr "Une simple texture qui utilise un maillage pour s'afficher elle-même." #: doc/classes/MeshTexture.xml msgid "" @@ -37210,16 +37612,51 @@ msgstr "" #: doc/classes/MeshTexture.xml msgid "Sets the base texture that the Mesh will use to draw." -msgstr "" +msgstr "Définit la texture de base que le maillage utilisera pour l'affichage." #: doc/classes/MeshTexture.xml msgid "Sets the size of the image, needed for reference." -msgstr "" +msgstr "Définit la taille de l'image, nécessaire pour garder une référence." #: doc/classes/MeshTexture.xml msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "Implémentation de RV mobile générique." @@ -37435,7 +37872,7 @@ msgstr "Utilise ça lors des transformations 3D." #: doc/classes/MultiMesh.xml msgid "Use when you are not using per-instance [Color]s." -msgstr "" +msgstr "À utiliser quand vous n'utilisez pas une [Color] par instance." #: doc/classes/MultiMesh.xml msgid "" @@ -37452,6 +37889,8 @@ msgstr "" #: doc/classes/MultiMesh.xml msgid "Use when you are not using per-instance custom data." msgstr "" +"À utiliser quand vous ne définissez pas des données personnalisées pour " +"chaque instance." #: doc/classes/MultiMesh.xml msgid "" @@ -37510,7 +37949,7 @@ msgstr "" #: doc/classes/MultiMeshInstance2D.xml msgid "The [MultiMesh] that will be drawn by the [MultiMeshInstance2D]." -msgstr "" +msgstr "Le [MultiMesh] qui sera affiché par ce [MultiMeshInstance2D]." #: doc/classes/MultiplayerAPI.xml msgid "High-level multiplayer API." @@ -37546,6 +37985,8 @@ msgstr "" msgid "" "Returns the unique peer ID of this MultiplayerAPI's [member network_peer]." msgstr "" +"Retourne un identifiant de pair unique pour ce [member network_peer] du " +"MultiplayerAPI." #: doc/classes/MultiplayerAPI.xml msgid "" @@ -37556,6 +37997,7 @@ msgstr "" #: doc/classes/MultiplayerAPI.xml doc/classes/SceneTree.xml msgid "Returns [code]true[/code] if there is a [member network_peer] set." msgstr "" +"Retourne [code]true[/code] s'il y a un [member network_peer] de définit." #: doc/classes/MultiplayerAPI.xml msgid "" @@ -37615,6 +38057,8 @@ msgid "" "If [code]true[/code], the MultiplayerAPI's [member network_peer] refuses new " "incoming connections." msgstr "" +"Si [code]true[/code], le [member network_peer] du MultiplayerAPI refuse les " +"nouvelles connexions entrantes." #: doc/classes/MultiplayerAPI.xml msgid "" @@ -37772,24 +38216,32 @@ msgid "" "Returns the documentation string that was previously set with " "[code]godot_nativescript_set_class_documentation[/code]." msgstr "" +"Retourne le texte de la documentation qui a été précédemment définit avec " +"[code]godot_nativescript_set_class_documentation[/code]." #: modules/gdnative/doc_classes/NativeScript.xml msgid "" "Returns the documentation string that was previously set with " "[code]godot_nativescript_set_method_documentation[/code]." msgstr "" +"Retourne le texte de la documentation qui a été précédemment définit avec " +"[code]godot_nativescript_set_method_documentation[/code]." #: modules/gdnative/doc_classes/NativeScript.xml msgid "" "Returns the documentation string that was previously set with " "[code]godot_nativescript_set_property_documentation[/code]." msgstr "" +"Retourne le texte de la documentation qui a été précédemment définit avec " +"[code]godot_nativescript_set_property_documentation[/code]." #: modules/gdnative/doc_classes/NativeScript.xml msgid "" "Returns the documentation string that was previously set with " "[code]godot_nativescript_set_signal_documentation[/code]." msgstr "" +"Retourne le texte de la documentation qui a été précédemment définit avec " +"[code]godot_nativescript_set_signal_documentation[/code]." #: modules/gdnative/doc_classes/NativeScript.xml msgid "" @@ -38575,9 +39027,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -38753,6 +39216,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml #, fuzzy msgid "Server interface for low-level 3D navigation access." @@ -38911,6 +39382,8 @@ msgid "" "Returns the channel of the last packet fetched via [method PacketPeer." "get_packet]." msgstr "" +"Retourne le canal du dernier paquet récupéré avec [method PacketPeer." +"get_packet]." #: modules/enet/doc_classes/NetworkedMultiplayerENet.xml msgid "" @@ -39011,6 +39484,8 @@ msgid "" "Enable or disable certificate verification when [member use_dtls] " "[code]true[/code]." msgstr "" +"Active ou désactive la vérification du certificat quand [member use_dtls] " +"est [code]true[/code]." #: modules/enet/doc_classes/NetworkedMultiplayerENet.xml msgid "" @@ -39101,7 +39576,7 @@ msgstr "" #: doc/classes/NetworkedMultiplayerPeer.xml msgid "" "Returns the current state of the connection. See [enum ConnectionStatus]." -msgstr "" +msgstr "Retourne l'état actuel de la connexion. Voir [enum ConnexionStatus]." #: doc/classes/NetworkedMultiplayerPeer.xml msgid "" @@ -39115,7 +39590,7 @@ msgstr "Retourne l'identifiant de ce [NetworkedMultiplayerPeer]." #: doc/classes/NetworkedMultiplayerPeer.xml msgid "Waits up to 1 second to receive a new network event." -msgstr "" +msgstr "Attend jusqu'à 1 seconde de recevoir un nouvel événement réseau." #: doc/classes/NetworkedMultiplayerPeer.xml msgid "" @@ -39601,7 +40076,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -39642,6 +40117,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -39830,6 +40314,8 @@ msgid "" "Returns [code]true[/code] if this is an instance load placeholder. See " "[InstancePlaceholder]." msgstr "" +"Retourne [code]true[/code] si c'est une instance fictive pour charger un " +"scène. Voir [InstancePlaceholder]." #: doc/classes/Node.xml msgid "Returns the [SceneTree] that contains this node." @@ -39843,6 +40329,7 @@ msgstr "Retourne le [Viewport] du nœud." msgid "" "Returns [code]true[/code] if the node that the [NodePath] points to exists." msgstr "" +"Retourne [code]true[/code] si le nœud à l'emplacement [NodePath] existe." #: doc/classes/Node.xml msgid "" @@ -39880,6 +40367,7 @@ msgstr "" msgid "" "Returns [code]true[/code] if this node is currently inside a [SceneTree]." msgstr "" +"Retourne [code]true[/code] si le nœud est actuellement dans le [SceneTree]." #: doc/classes/Node.xml msgid "" @@ -40318,7 +40806,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -40341,6 +40829,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -40379,15 +40876,15 @@ msgstr "La notification reçue quand un nœud entre dans le [SceneTree]." #: doc/classes/Node.xml msgid "Notification received when the node is about to exit a [SceneTree]." -msgstr "" +msgstr "La notification reçue quand le nœud va quitter le [SceneTree]." #: doc/classes/Node.xml msgid "Notification received when the node is moved in the parent." -msgstr "" +msgstr "La notification reçue quand le nœud est déplacé dans le parent." #: doc/classes/Node.xml msgid "Notification received when the node is ready. See [method _ready]." -msgstr "" +msgstr "La notification reçue quand le nœud est prêt. Voir [method _ready]." #: doc/classes/Node.xml msgid "Notification received when the node is paused." @@ -40426,11 +40923,18 @@ msgid "Notification received when the node is instanced." msgstr "La notification reçue quand ce nœud est instancié." #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -40532,6 +41036,8 @@ msgstr "Retourne la [Transform2D] relative au parent de ce nœud." #: doc/classes/Node2D.xml msgid "Adds the [code]offset[/code] vector to the node's global position." msgstr "" +"Ajoute le vecteur de décalage [code]offset[/code] à la position globale du " +"nœud." #: doc/classes/Node2D.xml msgid "" @@ -40581,6 +41087,8 @@ msgstr "" msgid "" "Translates the node by the given [code]offset[/code] in local coordinates." msgstr "" +"Déplace le nœud par le décalage [code]offset[/code] dans les coordonnées " +"locales." #: doc/classes/Node2D.xml msgid "Global position." @@ -41017,7 +41525,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -41048,7 +41556,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -41155,10 +41663,13 @@ msgid "" "Returns the object's [Script] instance, or [code]null[/code] if none is " "assigned." msgstr "" +"Retourne l'instance [Script] de l'objet, ou [code]null[/code] si aucune " +"n'est assignée." #: doc/classes/Object.xml msgid "Returns an [Array] of connections for the given [code]signal[/code]." msgstr "" +"Retourne un [Array] des connexions pour le [code]signal[/code] spécifié." #: doc/classes/Object.xml msgid "Returns the list of signals as an [Array] of dictionaries." @@ -42166,6 +42677,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" "Retourne la quantité totale de mémoire dynamique utilisée (ne fonctionne " @@ -42674,6 +43195,15 @@ msgstr "" "zéro." #: doc/classes/OS.xml +msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml #, fuzzy msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " @@ -42720,6 +43250,8 @@ msgid "" "Returns the number of keyboard layouts.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" +"Retourne le nombre de disposition de clavier.\n" +"[b]Note :[/b] Cette méthode est implémentée sous Linux, macOS et Windows." #: doc/classes/OS.xml msgid "" @@ -42761,6 +43293,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -42791,12 +43331,16 @@ msgid "" "Stops native video playback.\n" "[b]Note:[/b] This method is implemented on iOS." msgstr "" +"Arrête la lecture du lecteur vidéo natif.\n" +"[b]Note :[/b] Cette méthode n'est implémentée que pour iOS." #: doc/classes/OS.xml msgid "" "Resumes native video playback.\n" "[b]Note:[/b] This method is implemented on iOS." msgstr "" +"Reprend la lecture du lecteur vidéo natif.\n" +"[b]Note :[/b] Cette méthode n'est implémentée que pour iOS." #: doc/classes/OS.xml msgid "" @@ -43272,7 +43816,7 @@ msgstr "" #: doc/classes/OS.xml msgid "Uses most suitable orientation based on the hardware sensor." -msgstr "" +msgstr "Utilise l'orientation la plus adaptée en fonction du capteur matériel." #: doc/classes/OS.xml msgid "Desktop directory path." @@ -43567,6 +44111,7 @@ msgstr "Déconnecte ce pair, finissant la session DTLS." #: doc/classes/PacketPeerDTLS.xml doc/classes/StreamPeerSSL.xml msgid "Returns the status of the connection. See [enum Status] for values." msgstr "" +"Retourne le status de la connexion. Voir [enum Status] pour les valeurs." #: doc/classes/PacketPeerDTLS.xml msgid "" @@ -44050,6 +44595,7 @@ msgstr "" #: doc/classes/ParticlesMaterial.xml msgid "Particle properties for [Particles] and [Particles2D] nodes." msgstr "" +"Les propriétés des particules pour les nœuds [Particles] et [Particles2D]." #: doc/classes/ParticlesMaterial.xml msgid "" @@ -44184,12 +44730,12 @@ msgstr "" #: doc/classes/ParticlesMaterial.xml msgid "" "The axis of the ring when using the emitter [constant EMISSION_SHAPE_RING]." -msgstr "" +msgstr "L'axe de l'anneau pour l'émetteur [constant EMISSION_SHAPE_RING]." #: doc/classes/ParticlesMaterial.xml msgid "" "The height of the ring when using the emitter [constant EMISSION_SHAPE_RING]." -msgstr "" +msgstr "La hauteur de l'anneau pour l'émetteur [constant EMISSION_SHAPE_RING]." #: doc/classes/ParticlesMaterial.xml msgid "" @@ -44202,23 +44748,27 @@ msgstr "" #: doc/classes/ParticlesMaterial.xml msgid "" "The radius of the ring when using the emitter [constant EMISSION_SHAPE_RING]." -msgstr "" +msgstr "Le rayon de l'anneau pour l'émetteur [constant EMISSION_SHAPE_RING]." #: doc/classes/ParticlesMaterial.xml msgid "" "Particles will be emitted inside this region. Use [enum EmissionShape] " "constants for values." msgstr "" +"Les particules seront émises à l'intérieur de cette région. Voir les " +"constantes dans [enum EmissionShape] pour les valeurs possibles." #: doc/classes/ParticlesMaterial.xml msgid "" "The sphere's radius if [code]emission_shape[/code] is set to [constant " "EMISSION_SHAPE_SPHERE]." msgstr "" +"Le rayon de la sphère si [code]emission_shape[/code] est [constant " +"EMISSION_SHAPE_SPHERE]." #: doc/classes/ParticlesMaterial.xml msgid "Amount of [member spread] along the Y axis." -msgstr "" +msgstr "La quantité de diffusion [member spread] le long de l'axe Y." #: doc/classes/ParticlesMaterial.xml msgid "Each particle's hue will vary along this [CurveTexture]." @@ -44320,18 +44870,24 @@ msgid "" "Use with [method set_param], [method set_param_randomness], and [method " "set_param_texture] to set damping properties." msgstr "" +"À utiliser avec [method set_param], [method set_param_randomness], et " +"[method set_param_texture] pour définir les propriétés d'amortissement." #: doc/classes/ParticlesMaterial.xml msgid "" "Use with [method set_param], [method set_param_randomness], and [method " "set_param_texture] to set angle properties." msgstr "" +"À utiliser avec [method set_param], [method set_param_randomness], et " +"[method set_param_texture] pour définir les propriétés de l'angle." #: doc/classes/ParticlesMaterial.xml msgid "" "Use with [method set_param], [method set_param_randomness], and [method " "set_param_texture] to set scale properties." msgstr "" +"À utiliser avec [method set_param], [method set_param_randomness], et " +"[method set_param_texture] pour définir les propriétés de mise à l'échelle." #: doc/classes/ParticlesMaterial.xml msgid "" @@ -44381,7 +44937,7 @@ msgstr "" #: doc/classes/Path.xml msgid "Contains a [Curve3D] path for [PathFollow] nodes to follow." -msgstr "" +msgstr "Contient une chemin [Curve3D] à suivre par les nœuds [PathFollow]." #: doc/classes/Path.xml msgid "" @@ -44477,7 +45033,7 @@ msgstr "" #: doc/classes/PathFollow.xml doc/classes/PathFollow2D.xml msgid "The node's offset perpendicular to the curve." -msgstr "" +msgstr "Le décalage du nœud perpendiculairement à la courbe." #: doc/classes/PathFollow.xml msgid "Forbids the PathFollow to rotate." @@ -44626,21 +45182,25 @@ msgstr "Nombre d’images par seconde." #: doc/classes/Performance.xml msgid "Time it took to complete one frame, in seconds." -msgstr "Le temps que cela prend de compléter une trame, en seconde." +msgstr "Le temps nécessaire pour compléter une trame, en secondes." #: doc/classes/Performance.xml msgid "Time it took to complete one physics frame, in seconds." -msgstr "" +msgstr "Le temps nécessaire pour compléter une trame physique, en secondes." #: doc/classes/Performance.xml msgid "" "Static memory currently used, in bytes. Not available in release builds." msgstr "" +"La mémoire statique actuellement utilisée, en octets. N'est pas utilisable " +"dans les versions finales." #: doc/classes/Performance.xml msgid "" "Dynamic memory currently used, in bytes. Not available in release builds." msgstr "" +"La mémoire dynamique actuellement utilisée, en octets. N'est pas utilisable " +"dans les versions finales." #: doc/classes/Performance.xml #, fuzzy @@ -44732,6 +45292,7 @@ msgstr "La quantité de mémoire utilisée pour les sommets." msgid "" "Unimplemented in the GLES2 and GLES3 rendering backends, always returns 0." msgstr "" +"Ne implémenté pour les rendus sous GLES2 et GLES3, retourne toujours 0." #: doc/classes/Performance.xml msgid "Number of active [RigidBody2D] nodes in the game." @@ -44751,7 +45312,7 @@ msgstr "Le nombre de nœuds [RigidBody] et [VehicleBody] dans le jeu." #: doc/classes/Performance.xml msgid "Number of collision pairs in the 3D physics engine." -msgstr "" +msgstr "Le nombre de paires de collisions dans le moteur physique 3D." #: doc/classes/Performance.xml msgid "Number of islands in the 3D physics engine." @@ -44782,6 +45343,8 @@ msgid "" "Generates and sets an optimized translation from the given [Translation] " "resource." msgstr "" +"Génère et définit des traductions optimisées depuis la ressource " +"[Translation] donnée." #: doc/classes/Physics2DDirectBodyState.xml msgid "Direct access object to a physics body in the [Physics2DServer]." @@ -44871,6 +45434,7 @@ msgstr "" #: doc/classes/PhysicsDirectBodyState.xml msgid "Returns the linear velocity vector at the collider's contact point." msgstr "" +"Retourne le vecteur de vélocité linéaire au point de contact à la collision." #: doc/classes/Physics2DDirectBodyState.xml msgid "" @@ -44897,7 +45461,7 @@ msgstr "" #: doc/classes/Physics2DDirectBodyState.xml #: doc/classes/PhysicsDirectBodyState.xml msgid "Returns the current state of the space, useful for queries." -msgstr "" +msgstr "Retourne l'état actuel de l'espace, utile pour les requêtes." #: doc/classes/Physics2DDirectBodyState.xml #: doc/classes/PhysicsDirectBodyState.xml @@ -44932,7 +45496,7 @@ msgstr "La vitesse linéaire d'un corps en pixels par seconde." #: doc/classes/Physics2DDirectBodyState.xml #: doc/classes/PhysicsDirectBodyState.xml msgid "If [code]true[/code], this body is currently sleeping (not active)." -msgstr "" +msgstr "Si [code]true[/code], le corps est actuellement au repos (inactif)." #: doc/classes/Physics2DDirectBodyState.xml #: doc/classes/PhysicsDirectBodyState.xml @@ -44950,7 +45514,7 @@ msgstr "" #: doc/classes/Physics2DDirectBodyState.xml #: doc/classes/PhysicsDirectBodyState.xml msgid "The total gravity vector being currently applied to this body." -msgstr "" +msgstr "Le vecteur total de gravité actuellement appliqué à ce corps." #: doc/classes/Physics2DDirectBodyState.xml #: doc/classes/PhysicsDirectBodyState.xml @@ -44966,7 +45530,7 @@ msgstr "La matrice de transformation du corps." #: doc/classes/Physics2DDirectSpaceState.xml msgid "Direct access object to a space in the [Physics2DServer]." -msgstr "" +msgstr "L'objet pour accéder directement à l'espace du [Physics2DServer]." #: doc/classes/Physics2DDirectSpaceState.xml msgid "" @@ -45254,7 +45818,7 @@ msgstr "Définit la matrice de transformation pour l'aire." #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Adds a body to the list of bodies exempt from collisions." -msgstr "" +msgstr "Ajoute un corps à la liste de ceux ignorés lors des collisions." #: doc/classes/Physics2DServer.xml msgid "" @@ -45286,11 +45850,12 @@ msgstr "Crée un corps physique." #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Returns the physics layer or layers a body belongs to." -msgstr "" +msgstr "Retourne le(s) calque(s) physique(s) auquel(s) ce corps appartient." #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Returns the physics layer or layers a body can collide with." msgstr "" +"Retourne le(s) calque(s) physique(s) où le corps peut entrer en collision." #: doc/classes/Physics2DServer.xml msgid "Returns the continuous collision detection mode." @@ -45307,6 +45872,8 @@ msgid "" "Returns the maximum contacts that can be reported. See [method " "body_set_max_contacts_reported]." msgstr "" +"Retourne le nombre maximal de contacts qui peuvent être détectés. Voir " +"[method body_set_max_contacts_reported]." #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Returns the body mode." @@ -45320,11 +45887,11 @@ msgstr "" #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Returns the [RID] of the nth shape of a body." -msgstr "" +msgstr "Retourne le [RID] de la n-ième forme de ce corps." #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Returns the number of shapes assigned to a body." -msgstr "" +msgstr "Retourne le nombre de formes associées au corps." #: doc/classes/Physics2DServer.xml msgid "Returns the metadata of a shape of a body." @@ -45336,7 +45903,7 @@ msgstr "" #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Returns the [RID] of the space assigned to a body." -msgstr "" +msgstr "Retourne le [RID] de la forme assignée à ce corps." #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Returns a body state." @@ -45350,7 +45917,7 @@ msgstr "" #: doc/classes/Physics2DServer.xml msgid "Removes a body from the list of bodies exempt from collisions." -msgstr "" +msgstr "Retirer un corps de la liste de ceux ignorés lors des collisions." #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "" @@ -45367,11 +45934,12 @@ msgstr "" #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Sets the physics layer or layers a body belongs to." -msgstr "" +msgstr "Définit le(s) calque(s) physique(s) auquel(s) ce corps appartient." #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Sets the physics layer or layers a body can collide with." msgstr "" +"Définit le(s) calque(s) physique(s) où le corps peut entrer en collision." #: doc/classes/Physics2DServer.xml msgid "" @@ -45397,6 +45965,7 @@ msgstr "" #: doc/classes/Physics2DServer.xml msgid "Sets the body mode using one of the [enum BodyMode] constants." msgstr "" +"Définit le mode du corps, avec l'une des constantes de [enum BodyMode]." #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "" @@ -45421,6 +45990,8 @@ msgid "" "Enables one way collision on body if [code]enable[/code] is [code]true[/" "code]." msgstr "" +"Active les collisions dans un seul sens pour ce corps si [code]enable[/code] " +"est [code]true[/code]." #: doc/classes/Physics2DServer.xml msgid "Disables shape in body if [code]disable[/code] is [code]true[/code]." @@ -45439,7 +46010,7 @@ msgstr "Définit la matrice de transformation pour la forme du corps." #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Assigns a space to the body (see [method space_create])." -msgstr "" +msgstr "Assigne un espace au corps (voir [method space_create])." #: doc/classes/Physics2DServer.xml msgid "" @@ -45497,11 +46068,11 @@ msgstr "" #: doc/classes/Physics2DServer.xml msgid "Returns the value of a joint parameter." -msgstr "" +msgstr "Retourne la valeur du paramètre du joint." #: doc/classes/Physics2DServer.xml msgid "Returns a joint's type (see [enum JointType])." -msgstr "" +msgstr "Retourne le type de joint (voir [enum JoinType])." #: doc/classes/Physics2DServer.xml msgid "" @@ -45557,7 +46128,7 @@ msgstr "" #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Returns the value of a space parameter." -msgstr "" +msgstr "Retourne la valeur d'un paramètre de l'espace." #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Returns whether the space is active." @@ -45707,14 +46278,19 @@ msgstr "" #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Constant to set/get the linear dampening factor of an area." msgstr "" +"La constant pour définir/récupérer le facteur d'amortissement linéaire de " +"cette aire." #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Constant to set/get the angular dampening factor of an area." msgstr "" +"La constant pour définir/récupérer le facteur d'amortissement angulaire de " +"cette aire." #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Constant to set/get the priority (order of processing) of an area." msgstr "" +"La constant pour définir/obtenir la priorité (l'ordre de gestion) de l'aire." #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "" @@ -45807,10 +46383,14 @@ msgstr "" #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Constant to set/get the current linear velocity of the body." msgstr "" +"La constante pour définir/récupérer la vélocité linéaire actuelle de ce " +"corps." #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Constant to set/get the current angular velocity of the body." msgstr "" +"La constante pour définir/récupérer la vélocité angulaire actuelle de ce " +"corps." #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Constant to sleep/wake up a body, or to get whether it is sleeping." @@ -45885,7 +46465,7 @@ msgstr "" #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Constant to get the number of objects that are not sleeping." -msgstr "" +msgstr "La constante pour récupérer le nombre d'objets qui ne dorment pas." #: doc/classes/Physics2DServer.xml doc/classes/PhysicsServer.xml msgid "Constant to get the number of possible collisions." @@ -45898,7 +46478,7 @@ msgstr "" #: doc/classes/Physics2DShapeQueryParameters.xml msgid "Parameters to be sent to a 2D shape physics query." -msgstr "" +msgstr "Les paramètres à passer à un requête physique d'une forme 2D." #: doc/classes/Physics2DShapeQueryParameters.xml msgid "" @@ -45915,12 +46495,12 @@ msgstr "" #: doc/classes/Physics2DShapeQueryParameters.xml msgid "If [code]true[/code], the query will take [Area2D]s into account." -msgstr "" +msgstr "Si [code]true[/code], la requête prendra la [Area2D] en compte." #: doc/classes/Physics2DShapeQueryParameters.xml msgid "" "If [code]true[/code], the query will take [PhysicsBody2D]s into account." -msgstr "" +msgstr "Si [code]true[/code], la requête prendra la [PhysicsBody2D] en compte." #: doc/classes/Physics2DShapeQueryParameters.xml #: doc/classes/PhysicsShapeQueryParameters.xml @@ -45958,7 +46538,7 @@ msgstr "La matrice de transformation de la forme recherchée." #: doc/classes/PhysicsBody.xml msgid "Base class for all objects affected by physics in 3D space." -msgstr "" +msgstr "La classe de base pour tous les objets affecté par la physique en 3D." #: doc/classes/PhysicsBody.xml msgid "" @@ -45986,7 +46566,7 @@ msgstr "" #: doc/classes/PhysicsBody2D.xml msgid "Base class for all objects affected by physics in 2D space." -msgstr "" +msgstr "La classe de base pour tous les objets affecté par la physique en 2D." #: doc/classes/PhysicsBody2D.xml msgid "" @@ -46058,6 +46638,8 @@ msgstr "" #: doc/classes/PhysicsDirectBodyState.xml msgid "Impulse created by the contact. Only implemented for Bullet physics." msgstr "" +"L'impulsion créée lors du contact. Seulement implémenté dans le moteur " +"physique Bullet." #: doc/classes/PhysicsDirectBodyState.xml doc/classes/RigidBody.xml msgid "" @@ -46071,7 +46653,7 @@ msgstr "La vitesse linéaire du corps en unités par secondes." #: doc/classes/PhysicsDirectSpaceState.xml msgid "Direct access object to a space in the [PhysicsServer]." -msgstr "" +msgstr "L'objet pour accéder directement à l'espace du [PhysicsServer]." #: doc/classes/PhysicsDirectSpaceState.xml msgid "" @@ -46179,6 +46761,7 @@ msgstr "Un matériau pour les propriétés physiques." msgid "" "Provides a means of modifying the collision properties of a [PhysicsBody]." msgstr "" +"Fournis un moyen de modifier les propriétés de collision d'un [PhysicsBody]." #: doc/classes/PhysicsMaterial.xml msgid "" @@ -46290,7 +46873,7 @@ msgstr "" #: doc/classes/PhysicsServer.xml msgid "If [code]true[/code], the body can be detected by rays." -msgstr "" +msgstr "Si [code]true[/code], le corps peut être détecté par les rayons." #: doc/classes/PhysicsServer.xml msgid "" @@ -46309,6 +46892,7 @@ msgstr "" #: doc/classes/PhysicsServer.xml msgid "Sets the body mode, from one of the [enum BodyMode] constants." msgstr "" +"Définit le mode du corps, avec l'une des constantes de [enum BodyMode]." #: doc/classes/PhysicsServer.xml msgid "" @@ -46319,6 +46903,8 @@ msgstr "" #: doc/classes/PhysicsServer.xml msgid "Sets the body pickable with rays if [code]enabled[/code] is set." msgstr "" +"Définit ce le corps peut être sélectionné avec un rayon si [code]enabled[/" +"code] est définit." #: doc/classes/PhysicsServer.xml msgid "Sets a body state (see [enum BodyState] constants)." @@ -46477,7 +47063,7 @@ msgstr "" #: doc/classes/PhysicsServer.xml msgid "Returns the type of shape (see [enum ShapeType] constants)." -msgstr "" +msgstr "Retourne le type de forme (voir les constantes dans [enum ShapeType])." #: doc/classes/PhysicsServer.xml msgid "Gets a slider_joint parameter (see [enum SliderJointParam] constants)." @@ -46766,7 +47352,7 @@ msgstr "La [Shape] est un [HeightMapShape]." #: doc/classes/PhysicsShapeQueryParameters.xml msgid "Parameters to be sent to a 3D shape physics query." -msgstr "" +msgstr "Les paramètres à passer à un requête physique d'une forme 3D." #: doc/classes/PhysicsShapeQueryParameters.xml msgid "" @@ -46927,6 +47513,8 @@ msgstr "" msgid "" "Returns [code]true[/code] if [code]point[/code] is located above the plane." msgstr "" +"Retourne [code]true[/code] si le [code]point[/code] est localisé au-dessus " +"du plan." #: doc/classes/Plane.xml msgid "Returns a copy of the plane, normalized." @@ -46957,15 +47545,15 @@ msgstr "" #: doc/classes/Plane.xml msgid "The X component of the plane's [member normal] vector." -msgstr "" +msgstr "Le composant X du vecteur de la [member normal] du plan." #: doc/classes/Plane.xml msgid "The Y component of the plane's [member normal] vector." -msgstr "" +msgstr "Le composant Y du vecteur de la [member normal] du plan." #: doc/classes/Plane.xml msgid "The Z component of the plane's [member normal] vector." -msgstr "" +msgstr "Le composant Z du vecteur de la [member normal] du plan." #: doc/classes/Plane.xml msgid "A plane that extends in the Y and Z axes (normal vector points +X)." @@ -47067,6 +47655,8 @@ msgstr "" msgid "" "Adds a bone with the specified [code]path[/code] and [code]weights[/code]." msgstr "" +"Ajoute un os avec le chemin [code]path[/code] et le poids [code]weights[/" +"code] spécifiés." #: doc/classes/Polygon2D.xml msgid "Removes all bones from this [Polygon2D]." @@ -47091,17 +47681,23 @@ msgstr "Retourne la hauteur de l'os spécifié." #: doc/classes/Polygon2D.xml msgid "Sets the path to the node associated with the specified bone." -msgstr "" +msgstr "Définit le chemin du nœud associé avec l'os spécifié." #: doc/classes/Polygon2D.xml msgid "Sets the weight values for the specified bone." msgstr "Définit le poids pour l'os spécifié." #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" -"Si [code]true[/code], l'anticrénelage sera activé pour les bordures du " -"polygone." #: doc/classes/Polygon2D.xml msgid "" @@ -47138,6 +47734,8 @@ msgstr "" msgid "" "The polygon's fill texture. Use [code]uv[/code] to set texture coordinates." msgstr "" +"La texture pour remplir le polygone. Utilisez [code]uv[/code] pour définir " +"les coordonnées de la texture." #: doc/classes/Polygon2D.xml msgid "" @@ -47175,12 +47773,13 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +#, fuzzy +msgid "A pooled array of bytes." msgstr "Un [Array] compacté d'octets." #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -47227,6 +47826,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -47294,13 +47903,14 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +#, fuzzy +msgid "A pooled array of [Color]." msgstr "Un [Array] compacté de [Color]." #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -47332,13 +47942,14 @@ msgid "Changes the [Color] at the given index." msgstr "Change la [Color] à la position donnée." #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +#, fuzzy +msgid "A pooled array of integers ([int])." msgstr "Un [Array] compacté d'entier ([int])." #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -47369,13 +47980,14 @@ msgid "Changes the int at the given index." msgstr "Modifie le [int] à l’index donné." #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +#, fuzzy +msgid "A pooled array of reals ([float])." msgstr "Un [Array] compacté de flottants ([float])." #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -47402,12 +48014,13 @@ msgid "Changes the float at the given index." msgstr "Change la flottant à la position donnée." #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +#, fuzzy +msgid "A pooled array of [String]." msgstr "Un [Array] compacté de [String]." #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -47439,12 +48052,13 @@ msgid "Changes the [String] at the given index." msgstr "Change la [String] à la position donnée." #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +#, fuzzy +msgid "A pooled array of [Vector2]." msgstr "Un [Array] compacté de [Vector2]." #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -47474,12 +48088,13 @@ msgid "Changes the [Vector2] at the given index." msgstr "Change la [Vector2] à la position donnée." #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +#, fuzzy +msgid "A pooled array of [Vector3]." msgstr "Un [Array] compacté de [Vector3]." #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -47821,7 +48436,7 @@ msgstr "" msgid "" "Returns the tooltip associated with the specified index index [code]idx[/" "code]." -msgstr "" +msgstr "Retourne l'infobulle associée avec l'index [code]idx[/code] spécifié." #: doc/classes/PopupMenu.xml msgid "" @@ -47844,6 +48459,8 @@ msgstr "" msgid "" "Returns [code]true[/code] if the item at index [code]idx[/code] is checked." msgstr "" +"Retourne [code]true[/code] si l'élément à la position [code]idx[/code] est " +"coché." #: doc/classes/PopupMenu.xml msgid "" @@ -48095,12 +48712,16 @@ msgid "" "[StyleBox] for the left side of labeled separator. See [method " "add_separator]." msgstr "" +"La [StyleBox] pour le côté gauche du séparateur avec label. Voir [method " +"add_separator]." #: doc/classes/PopupMenu.xml msgid "" "[StyleBox] for the right side of labeled separator. See [method " "add_separator]." msgstr "" +"La [StyleBox] pour le côté droit du séparateur avec label. Voir [method " +"add_separator]." #: doc/classes/PopupMenu.xml msgid "Default [StyleBox] of the [PopupMenu] items." @@ -48135,6 +48756,8 @@ msgstr "Le style du panneau d'arrière-plan de ce [PopupPanel]." #: doc/classes/Portal.xml msgid "Portal nodes are used to enable visibility between [Room]s." msgstr "" +"Les nœuds de portail sont principalement utilisé pour activer la visibilité " +"entre les pièces [Room]." #: doc/classes/Portal.xml msgid "" @@ -48325,6 +48948,8 @@ msgid "" "How quickly the [member ground_horizon_color] fades into the [member " "ground_bottom_color]." msgstr "" +"La rapidité avec laquelle la couleur [member ground_horizon_color] change en " +"[member ground_bottom_color]." #: doc/classes/ProceduralSky.xml msgid "Amount of energy contribution from the ground." @@ -48339,6 +48964,8 @@ msgid "" "How quickly the [member sky_horizon_color] fades into the [member " "sky_top_color]." msgstr "" +"La rapidité avec laquelle la couleur [member sky_horizon_color] change en " +"[member sky_top_color]." #: doc/classes/ProceduralSky.xml msgid "Amount of energy contribution from the sky." @@ -48429,6 +49056,8 @@ msgstr "" #: doc/classes/ProgressBar.xml msgid "If [code]true[/code], the fill percentage is displayed on the bar." msgstr "" +"Si [code]true[/code], le pourcentage de progression (de remplissage) est " +"affiché dans la barre." #: doc/classes/ProgressBar.xml msgid "The color of the text." @@ -48505,6 +49134,8 @@ msgstr "" #: doc/classes/ProjectSettings.xml msgid "Clears the whole configuration (not recommended, may break things)." msgstr "" +"Efface complètement la configuration (non recommandé, peut casser des " +"choses)." #: doc/classes/ProjectSettings.xml msgid "" @@ -48520,6 +49151,11 @@ msgid "" "print(ProjectSettings.get_setting(\"application/config/name\"))\n" "[/codeblock]" msgstr "" +"Retourne la valeur d'une préférence.\n" +"[b]Exemple :[/b]\n" +"[codeblock]\n" +"print(ProjectSettings.get_setting(\"application/config/name\"))\n" +"[/codeblock]" #: doc/classes/ProjectSettings.xml msgid "" @@ -48983,6 +49619,8 @@ msgid "" "If [code]true[/code], scripts in the [code]res://addons[/code] folder will " "not generate warnings." msgstr "" +"Si [code]true[/code], les scripts dans le dossier [code]res://addons[/code] " +"ne généreront pas d'avertissements." #: doc/classes/ProjectSettings.xml #, fuzzy @@ -49027,6 +49665,8 @@ msgid "" "If [code]true[/code], enables warnings when dividing an integer by another " "integer (the decimal part will be discarded)." msgstr "" +"Si [code]true[/code], active les avertissements pour les divisions d'entiers " +"par un autre entier (la partie décimale serait alors ignorée)." #: doc/classes/ProjectSettings.xml msgid "" @@ -49040,6 +49680,8 @@ msgid "" "If [code]true[/code], enables warnings when using a property as if it was a " "function." msgstr "" +"Si [code]true[/code], active les avertissements lorsqu'une propriété est " +"utilisée comme si elle était une fonction." #: doc/classes/ProjectSettings.xml msgid "" @@ -49074,12 +49716,16 @@ msgstr "" msgid "" "If [code]true[/code], all warnings will be reported as if they were errors." msgstr "" +"Si [code]true[/code], tous les avertissements seront rapportés comme des " +"erreurs." #: doc/classes/ProjectSettings.xml msgid "" "If [code]true[/code], enables warnings when using a variable that wasn't " "previously assigned." msgstr "" +"Si [code]true[/code], active les avertissements quand une variable est " +"utilisée mais n'a pas été précédemment assignée." #: doc/classes/ProjectSettings.xml msgid "" @@ -49087,34 +49733,48 @@ msgid "" "assignment operator like [code]+=[/code] if the variable wasn't previously " "assigned." msgstr "" +"Si [code]true[/code], active les avertissements lors de l'assignation d'une " +"variable en utilisant un opérateur d'assignation comme [code]+=[/code] mais " +"que la variable n'a pas été précédemment assignée." #: doc/classes/ProjectSettings.xml msgid "" "If [code]true[/code], enables warnings when unreachable code is detected " "(such as after a [code]return[/code] statement that will always be executed)." msgstr "" +"Si [code]true[/code], active les avertissements pour les détection de code " +"inaccessible (comme après un [code]return[/code] qui sera toujours exécuté)." #: doc/classes/ProjectSettings.xml msgid "" "If [code]true[/code], enables warnings when using an expression whose type " "may not be compatible with the function parameter expected." msgstr "" +"Si [code]true[/code], active les avertissements pour les expressions où le " +"type peut ne pas être compatible avec celui attendu comme paramètre de la " +"fonction." #: doc/classes/ProjectSettings.xml msgid "If [code]true[/code], enables warnings when performing an unsafe cast." msgstr "" +"Si [code]true[/code], active les avertissements pour les transformations de " +"type non sûres." #: doc/classes/ProjectSettings.xml msgid "" "If [code]true[/code], enables warnings when calling a method whose presence " "is not guaranteed at compile-time in the class." msgstr "" +"Si [code]true[/code], active les avertissements lors d'appels à une méthode " +"qui n'est pas garantie d'exister dans la classe à la compilation." #: doc/classes/ProjectSettings.xml msgid "" "If [code]true[/code], enables warnings when accessing a property whose " "presence is not guaranteed at compile-time in the class." msgstr "" +"Si [code]true[/code], active les avertissements lors d'accès à une propriété " +"qui n'est pas garantie d'exister dans la classe à la compilation." #: doc/classes/ProjectSettings.xml #, fuzzy @@ -49132,10 +49792,14 @@ msgstr "Si [code]true[/code], le filtrage est activé." #: doc/classes/ProjectSettings.xml msgid "If [code]true[/code], enables warnings when a signal is unused." msgstr "" +"Si [code]true[/code], active les avertissements quand un signal n'est pas " +"utilisé." #: doc/classes/ProjectSettings.xml msgid "If [code]true[/code], enables warnings when a local variable is unused." msgstr "" +"Si [code]true[/code], active les avertissements quand une variable locale " +"n'est pas utilisée." #: doc/classes/ProjectSettings.xml msgid "" @@ -49149,10 +49813,12 @@ msgid "" "If [code]true[/code], enables warnings when assigning the result of a " "function that returns [code]void[/code] to a variable." msgstr "" +"Si [code]true[/code], active les avertissements lors de l'assignation du " +"résultat d'une fonction qui retourne [code]void[/code] à une variable." #: doc/classes/ProjectSettings.xml msgid "Message to be displayed before the backtrace when the engine crashes." -msgstr "" +msgstr "Le message à afficher avant les détails de crash du moteur." #: doc/classes/ProjectSettings.xml msgid "" @@ -49173,12 +49839,24 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "Pile d’appels maximale autorisée pour le débogage de GDScript." #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" +"La quantité maximale de fonctions appelées par trame lors du profilage." #: doc/classes/ProjectSettings.xml msgid "Print frames per second to standard output every second." msgstr "" +"Afficher le nombre de trames par second dans la console chaque seconde." #: doc/classes/ProjectSettings.xml msgid "" @@ -49230,6 +49908,8 @@ msgstr "" #: doc/classes/ProjectSettings.xml msgid "Custom image for the mouse cursor (limited to 256×256)." msgstr "" +"L'image personnalisée pour le curseur de la souris (limitée à 256x256 " +"pixels)." #: doc/classes/ProjectSettings.xml msgid "Hotspot for the custom mouse cursor image." @@ -49238,6 +49918,8 @@ msgstr "Hotspot pour l’image de curseur de souris personnalisée." #: doc/classes/ProjectSettings.xml msgid "Position offset for tooltips, relative to the mouse cursor's hotspot." msgstr "" +"Le décalage de la position des infobulles, relatif au point d'activation du " +"curseur de la souris." #: doc/classes/ProjectSettings.xml msgid "" @@ -49347,6 +50029,8 @@ msgid "" "Specifies the tablet driver to use. If left empty, the default driver will " "be used." msgstr "" +"Spécifie le pilote de tablette à utilise. Si vide, le pilote par défaut sera " +"utilisé." #: doc/classes/ProjectSettings.xml msgid "" @@ -49451,12 +50135,16 @@ msgstr "" #: doc/classes/ProjectSettings.xml msgid "If [code]true[/code], makes sure the theme used works with HiDPI." msgstr "" +"Si [code]true[/code], vérifie que le thème utilisé fonctionne en HiDPI " +"(écran haute définition)." #: doc/classes/ProjectSettings.xml msgid "" "Timer setting for incremental search in [Tree], [ItemList], etc. controls " "(in milliseconds)." msgstr "" +"Les préférences du minuteur pour les recherches incrémentale dans les " +"contrôles [Tree], [ItemList], etc. (en millisecondes)." #: doc/classes/ProjectSettings.xml msgid "Timer for detecting idle in [TextEdit] (in seconds)." @@ -50062,6 +50750,8 @@ msgstr "" #: doc/classes/ProjectSettings.xml msgid "Specifies the maximum amount of log files allowed (used for rotation)." msgstr "" +"Spécifie le nombre maximal de fichiers de journal autorisés (utilisé pour la " +"rotation des journaux)." #: doc/classes/ProjectSettings.xml msgid "" @@ -50136,34 +50826,44 @@ msgstr "" #: doc/classes/ProjectSettings.xml msgid "Maximum size (in kiB) for the [WebSocketClient] input buffer." msgstr "" +"La taille maximale (en kio) pour la mémoire tampon d'entrée du " +"[WebSocketClient]." #: doc/classes/ProjectSettings.xml msgid "Maximum number of concurrent input packets for [WebSocketClient]." msgstr "" +"Le nombre maximal de paquets entrants en parallèle pour le [WebSocketClient]." #: doc/classes/ProjectSettings.xml msgid "Maximum size (in kiB) for the [WebSocketClient] output buffer." msgstr "" +"La taille maximale (en kio) pour la mémoire tampon de sortie du " +"[WebSocketClient]." #: doc/classes/ProjectSettings.xml msgid "Maximum number of concurrent output packets for [WebSocketClient]." msgstr "" +"Le nombre maximal de paquets sortants en parallèle pour le [WebSocketClient]." #: doc/classes/ProjectSettings.xml msgid "Maximum size (in kiB) for the [WebSocketServer] input buffer." msgstr "" +"La taille maximale (en kio) pour la mémoire tampon d'entrée du [WebSocket]." #: doc/classes/ProjectSettings.xml msgid "Maximum number of concurrent input packets for [WebSocketServer]." msgstr "" +"Le nombre maximal de paquets entrant en parallèle pour le [WebSocketServeur]." #: doc/classes/ProjectSettings.xml msgid "Maximum size (in kiB) for the [WebSocketServer] output buffer." msgstr "" +"La taille maximale (en kio) pour la mémoire tampon de sortie du [WebSocket]." #: doc/classes/ProjectSettings.xml msgid "Maximum number of concurrent output packets for [WebSocketServer]." msgstr "" +"Le nombre maximal de paquets sortants en parallèle pour le [WebSocketServer]." #: doc/classes/ProjectSettings.xml msgid "" @@ -50422,6 +51122,8 @@ msgstr "" #: doc/classes/ProjectSettings.xml msgid "Enables [member Viewport.physics_object_picking] on the root viewport." msgstr "" +"Active [member Viewport.physics_object_picking] sur la fenêtre d'affichage " +"racine." #: doc/classes/ProjectSettings.xml msgid "" @@ -50680,24 +51382,32 @@ msgid "" "Amount of light samples taken when using [constant BakedLightmap." "BAKE_QUALITY_HIGH]." msgstr "" +"Le nombre d'échantillons de lumière pris pour [constant BakedLightmap." +"BAKE_QUALITY_HIGH]." #: doc/classes/ProjectSettings.xml msgid "" "Amount of light samples taken when using [constant BakedLightmap." "BAKE_QUALITY_LOW]." msgstr "" +"Le nombre d'échantillons de lumière pris pour [constant BakedLightmap." +"BAKE_QUALITY_LOW]." #: doc/classes/ProjectSettings.xml msgid "" "Amount of light samples taken when using [constant BakedLightmap." "BAKE_QUALITY_MEDIUM]." msgstr "" +"Le nombre d'échantillons de lumière pris pour [constant BakedLightmap." +"BAKE_QUALITY_MEDIUM]." #: doc/classes/ProjectSettings.xml msgid "" "Amount of light samples taken when using [constant BakedLightmap." "BAKE_QUALITY_ULTRA]." msgstr "" +"Le nombre d'échantillons de lumière pris pour [constant BakedLightmap." +"BAKE_QUALITY_ULTRA]." #: doc/classes/ProjectSettings.xml msgid "" @@ -50967,6 +51677,8 @@ msgid "" "Show conversion logs.\n" "[b]Note:[/b] This will automatically be disabled in exports." msgstr "" +"Afficher les détails de conversion.\n" +"[b]Note :[/b] Cela sera automatiquement désactivé dans les exports." #: doc/classes/ProjectSettings.xml #, fuzzy @@ -51381,6 +52093,7 @@ msgstr "" #: doc/classes/ProjectSettings.xml msgid "Quality setting for subsurface scattering (samples taken)." msgstr "" +"Le réglage de la qualité de transluminance (le nombre d'échantillons pris)." #: doc/classes/ProjectSettings.xml msgid "Max radius used for subsurface scattering samples." @@ -51486,10 +52199,199 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +#, fuzzy +msgid "Interpolates an [Object]'s property over time." +msgstr "Anime de manière fluide une propriété d'un nœud dans le temps." + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +#, fuzzy +msgid "General-purpose 3D proximity detection node." msgstr "Nœud de détection de proximité pour usage général." +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." +msgstr "" + #: doc/classes/QuadMesh.xml msgid "Class representing a square mesh." msgstr "Classe représentant un maillage carré." @@ -51720,12 +52622,16 @@ msgid "" "Generates a pseudo-random float between [code]0.0[/code] and [code]1.0[/" "code] (inclusive)." msgstr "" +"Génère un flottant pseudo-aléatoire entre [code]0.0[/code] et [code]1.0[/" +"code] (inclus)." #: doc/classes/RandomNumberGenerator.xml msgid "" "Generates a pseudo-random float between [code]from[/code] and [code]to[/" "code] (inclusive)." msgstr "" +"Génère un flottant pseudo-aléatoire entre [code]from[/code] et [code]to[/" +"code] (inclus)." #: doc/classes/RandomNumberGenerator.xml msgid "" @@ -53102,15 +54008,19 @@ msgstr "" msgid "" "Returns the dependencies for the resource at the given [code]path[/code]." msgstr "" +"Retourne les dépendances pour la ressource au chemin [code]path[/code] " +"spécifié." #: doc/classes/ResourceLoader.xml msgid "Returns the list of recognized extensions for a resource type." -msgstr "" +msgstr "Retourne la liste des extensions reconnues pour ce type de ressource." #: doc/classes/ResourceLoader.xml msgid "" "[i]Deprecated method.[/i] Use [method has_cached] or [method exists] instead." msgstr "" +"[i]Méthode obsolète.[/i] Utilisez plutôt [method has_cached] ou [method " +"exists]." #: doc/classes/ResourceLoader.xml msgid "" @@ -53197,11 +54107,13 @@ msgid "" "Returns [code]true[/code] if the preloader contains a resource associated to " "[code]name[/code]." msgstr "" +"Retourne [code]true[/code] si le pré-chargeur contient une ressource " +"associée avec [code]name[/code]." #: doc/classes/ResourcePreloader.xml msgid "" "Removes the resource associated to [code]name[/code] from the preloader." -msgstr "" +msgstr "Retire la ressource associée à [code]name[/code] de ce pré-chargeur." #: doc/classes/ResourcePreloader.xml msgid "" @@ -53352,14 +54264,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -53398,6 +54311,8 @@ msgid "" "Installs a custom effect. [code]effect[/code] should be a valid " "[RichTextEffect]." msgstr "" +"Installe une effet personnalisé. [code]effect[/code] doit être un " +"[RichTextEffect] valide." #: doc/classes/RichTextLabel.xml msgid "Adds a newline tag to the tag stack." @@ -53406,13 +54321,15 @@ msgstr "Ajouter un marqueur de retour à la ligne dans la pile des marqueurs." #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml msgid "Parses BBCode parameter [code]expressions[/code] into a dictionary." msgstr "" +"Interprète le paramètre BBCode [code]expressions[/code] dans un dictionnaire." #: doc/classes/RichTextLabel.xml msgid "" @@ -53425,6 +54342,8 @@ msgid "" "Adds an [code][align][/code] tag based on the given [code]align[/code] " "value. See [enum Align] for possible values." msgstr "" +"Ajoute un marqueur [code][align][/code] basé sur l'alignement [code]align[/" +"code] spécifiée. Voir [enum Align] pour les valeurs possibles." #: doc/classes/RichTextLabel.xml msgid "" @@ -53579,10 +54498,14 @@ msgid "" "If [code]true[/code], the label underlines meta tags such as [code][url]" "{text}[/url][/code]." msgstr "" +"Si [code]true[/code], le label souligne les marqueurs de méta-donnée comme " +"[code][url]{text}[/url][/code]." #: doc/classes/RichTextLabel.xml msgid "If [code]true[/code], the label uses the custom font color." msgstr "" +"Si [code]true[/code], le label utilise une couleur personnalisée pour la " +"couleur de la police." #: doc/classes/RichTextLabel.xml msgid "" @@ -53603,6 +54526,8 @@ msgid "" "If [code]true[/code], the window scrolls down to display new content " "automatically." msgstr "" +"Si [code]true[/code], la fenêtre descend/remonte automatiquement pour " +"afficher le nouveau contenu." #: doc/classes/RichTextLabel.xml msgid "If [code]true[/code], the label allows text selection." @@ -53683,6 +54608,8 @@ msgid "" "The color of selected text, used when [member selection_enabled] is " "[code]true[/code]." msgstr "" +"La couleur du texte sélectionné, utilisé quand [member selection_enabled] " +"est [code]true[/code]." #: doc/classes/RichTextLabel.xml msgid "The color of the font's shadow." @@ -53740,7 +54667,7 @@ msgstr "La police par défaut du texte." #: doc/classes/RichTextLabel.xml msgid "The background The background used when the [RichTextLabel] is focused." -msgstr "" +msgstr "L'arrière-plan utilisé quand le [RichTextLabel] a le focus." #: doc/classes/RichTextLabel.xml msgid "The normal background for the [RichTextLabel]." @@ -53810,6 +54737,9 @@ msgid "" "rotation.\n" "This is equivalent to [code]add_force(force, Vector3(0,0,0))[/code]." msgstr "" +"Ajouter un force directionnelle constante (une accélération) sans affecter " +"la rotation.\n" +"C'est équivalent à [code]add_force(force, Vector3(0,0,0))[/code]." #: doc/classes/RigidBody.xml msgid "" @@ -53822,6 +54752,8 @@ msgstr "" msgid "" "Adds a constant rotational force (i.e. a motor) without affecting position." msgstr "" +"Ajoute une force rotationnelle (par ex. un moteur) constante sans affecter " +"la position." #: doc/classes/RigidBody.xml msgid "" @@ -53851,6 +54783,8 @@ msgid "" "Returns [code]true[/code] if the specified linear or rotational axis is " "locked." msgstr "" +"Retourne [code]true[/code] si l'axe linéaire ou de rotation spécifié est " +"verrouillé." #: doc/classes/RigidBody.xml doc/classes/RigidBody2D.xml msgid "" @@ -53870,7 +54804,7 @@ msgstr "" #: doc/classes/RigidBody.xml msgid "Locks the specified linear or rotational axis." -msgstr "" +msgstr "Verrouille l'axe linéaire et de rotation spécifié." #: doc/classes/RigidBody.xml msgid "" @@ -54116,7 +55050,7 @@ msgstr "" #: doc/classes/RigidBody2D.xml msgid "A body that is controlled by the 2D physics engine." -msgstr "" +msgstr "Le corps qui est contrôlé par le moteur physique 2D." #: doc/classes/RigidBody2D.xml msgid "" @@ -54449,6 +55383,7 @@ msgstr "" #: doc/classes/RoomGroup.xml msgid "Groups [Room]s together to allow common functionality." msgstr "" +"Regroupe les [Room] ensemble pour autoriser des fonctionnalités communes." #: doc/classes/RoomGroup.xml msgid "" @@ -54822,6 +55757,8 @@ msgid "" "Returns the path to the node that owns the signal at [code]idx[/code], " "relative to the root node." msgstr "" +"Retourne le chemin du nœud qui est propriétaire du signal à l'index " +"[code]idx[/code], relatif au nœud racine." #: doc/classes/SceneState.xml msgid "" @@ -54863,6 +55800,8 @@ msgid "" "Returns the path to the represented scene file if the node at [code]idx[/" "code] is an [InstancePlaceholder]." msgstr "" +"Retourne le chemin du fichier de la scène représentée si le nœud à la " +"position [code]idx[/code] est un [InstancePlaceholder]." #: doc/classes/SceneState.xml msgid "Returns the name of the node at [code]idx[/code]." @@ -54873,6 +55812,8 @@ msgid "" "Returns the path to the owner of the node at [code]idx[/code], relative to " "the root node." msgstr "" +"Retourne le chemin du propriétaire du nœud à la position [code]idx[/code], " +"relatif au nœud racine." #: doc/classes/SceneState.xml msgid "" @@ -54911,11 +55852,15 @@ msgid "" "Returns [code]true[/code] if the node at [code]idx[/code] is an " "[InstancePlaceholder]." msgstr "" +"Retourne [code]true[/code] si le nœud à la position [code]idx[/code] est un " +"[InstancePlaceholder]." #: doc/classes/SceneState.xml msgid "" "If passed to [method PackedScene.instance], blocks edits to the scene state." msgstr "" +"Si passé à [method PackedScene.instance], empêche les modifications de la " +"scène." #: doc/classes/SceneState.xml msgid "" @@ -55028,6 +55973,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -55042,6 +55991,8 @@ msgstr "" #: doc/classes/SceneTree.xml msgid "Returns the unique peer ID of this [SceneTree]'s [member network_peer]." msgstr "" +"Retourne l'identifiant unique de ce pair [member network_peer] de ce " +"[SceneTree]." #: doc/classes/SceneTree.xml msgid "Returns the number of nodes in this [SceneTree]." @@ -55049,6 +56000,12 @@ msgstr "Retourne le nombre de nœuds dans ce [SceneTree]." #: doc/classes/SceneTree.xml msgid "Returns a list of all nodes assigned to the given group." +msgstr "Retourne la liste de tous les nœuds associés au groupe spécifié." + +#: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." msgstr "" #: doc/classes/SceneTree.xml @@ -55077,6 +56034,7 @@ msgstr "" #: doc/classes/SceneTree.xml msgid "Sends the given notification to all members of the [code]group[/code]." msgstr "" +"Émet la notification donnée à tous les membres de ce [code]group[/code]." #: doc/classes/SceneTree.xml msgid "" @@ -55089,6 +56047,8 @@ msgid "" "Queues the given object for deletion, delaying the call to [method Object." "free] to after the current frame." msgstr "" +"Marque l'objet donné pour être supprimé, l'appel [method Object.free] se " +"fera après la trame actuelle." #: doc/classes/SceneTree.xml msgid "" @@ -55116,6 +56076,9 @@ msgid "" "Enabled by default.\n" "For mobile platforms, see [method set_quit_on_go_back]." msgstr "" +"Si [code]true[/code], l'application accepte automatiquement de se fermer. " +"Activé par défaut.\n" +"Pour les plateformes mobiles, voir [method set_quit_on_go_back]." #: doc/classes/SceneTree.xml msgid "" @@ -55131,7 +56094,7 @@ msgstr "" #: doc/classes/SceneTree.xml msgid "Marks the most recent [InputEvent] as handled." -msgstr "" +msgstr "Marque le plus récent [InputEvent] comme consommé." #: doc/classes/SceneTree.xml msgid "" @@ -55156,12 +56119,16 @@ msgid "" "If [code]true[/code], collision shapes will be visible when running the game " "from the editor for debugging purposes." msgstr "" +"Si [code]true[/code], les formes des collisions seront visibles lors du " +"lancement du jeu depuis l'éditeur pour aider au débogage." #: doc/classes/SceneTree.xml msgid "" "If [code]true[/code], navigation polygons will be visible when running the " "game from the editor for debugging purposes." msgstr "" +"Si [code]true[/code], les polygones de navigation seront visibles lors du " +"lancement du jeu depuis l'éditeur pour aider au débogage." #: doc/classes/SceneTree.xml msgid "The root of the edited scene." @@ -55215,6 +56182,8 @@ msgid "" "If [code]true[/code], the [SceneTree]'s [member network_peer] refuses new " "incoming connections." msgstr "" +"Si [code]true[/code], le pair [member network_peer] de ce [SceneTree] refuse " +"les nouvelles connexions entrantes." #: doc/classes/SceneTree.xml #, fuzzy @@ -55284,17 +56253,19 @@ msgstr "" #: doc/classes/SceneTree.xml msgid "Emitted whenever a node is added to the [SceneTree]." -msgstr "" +msgstr "Émit quand un nœud est ajouté au [SceneTree]." #: doc/classes/SceneTree.xml msgid "" "Emitted when a node's configuration changed. Only emitted in [code]tool[/" "code] mode." msgstr "" +"Émis quand la configuration du nœud a changé. Uniquement en mode [code]tool[/" +"code]." #: doc/classes/SceneTree.xml msgid "Emitted whenever a node is removed from the [SceneTree]." -msgstr "" +msgstr "Émit quand un nœud est retiré du [SceneTree]." #: doc/classes/SceneTree.xml #, fuzzy @@ -55306,12 +56277,16 @@ msgid "" "Emitted immediately before [method Node._physics_process] is called on every " "node in the [SceneTree]." msgstr "" +"Émis juste avant que [method Node._physics_process] soit appelé pour chaque " +"nœud du [SceneTree]." #: doc/classes/SceneTree.xml msgid "" "Emitted when the screen resolution (fullscreen) or window size (windowed) " "changes." msgstr "" +"Émis quand la résolution de l'écran (en plein écran) ou la taille de la " +"fenêtre change." #: doc/classes/SceneTree.xml msgid "" @@ -55340,6 +56315,7 @@ msgstr "" #: doc/classes/SceneTree.xml msgid "Call a group only once even if the call is executed many times." msgstr "" +"Appelle un groupe une seule fois même si l'appel a était fait plusieurs fois." #: doc/classes/SceneTree.xml msgid "No stretching." @@ -55347,7 +56323,7 @@ msgstr "Aucun étirement." #: doc/classes/SceneTree.xml msgid "Render stretching in higher resolution (interpolated)." -msgstr "" +msgstr "Le rendu est étiré (interpolé) pour les résolutions plus grandes." #: doc/classes/SceneTree.xml msgid "" @@ -55413,6 +56389,405 @@ msgstr "Le temps restant (en secondes)." msgid "Emitted when the timer reaches 0." msgstr "Émis lorsque la minuterie atteint 0." +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +#, fuzzy +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "Arrête la mise à jour quand le [SceneTree] est en pause." + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "Une classe stockée en tant que ressource." @@ -55485,10 +56860,12 @@ msgid "" "Returns [code]true[/code] if the script is a tool script. A tool script can " "run in the editor." msgstr "" +"Retourne [code]true[/code] si le script est un script d'outil. Un script " +"d'outil peut être joué dans l'éditeur." #: doc/classes/Script.xml msgid "Reloads the script's class implementation. Returns an error code." -msgstr "" +msgstr "Recharge l'implémentation du script. Retourne un code d'erreur." #: doc/classes/Script.xml msgid "" @@ -55534,17 +56911,19 @@ msgstr "" #: doc/classes/ScriptEditor.xml msgid "Returns a [Script] that is currently active in editor." -msgstr "" +msgstr "Retourne le [Script] actuellement actif dans l'éditeur." #: doc/classes/ScriptEditor.xml msgid "" "Returns an array with all [Script] objects which are currently open in " "editor." msgstr "" +"Retourne la liste de tous les objets [Script] qui sont actuellement ouverts " +"dans l'éditeur." #: doc/classes/ScriptEditor.xml msgid "Goes to the specified line in the current script." -msgstr "" +msgstr "Va à la ligne spécifiée dans le script actuel." #: doc/classes/ScriptEditor.xml msgid "" @@ -55590,7 +56969,7 @@ msgstr "" #: doc/classes/ScrollBar.xml msgid "Emitted when the scrollbar is being scrolled." -msgstr "" +msgstr "Émis quand la barre de défilement est défilée." #: doc/classes/ScrollContainer.xml msgid "A helper node for displaying scrollable elements such as lists." @@ -55841,6 +57220,8 @@ msgid "" "Returns the default value of the material property with given [code]name[/" "code]." msgstr "" +"Retourne la valeur par défaut du paramètre nommé [code]name[/code] du " +"matériau." #: doc/classes/ShaderMaterial.xml msgid "" @@ -55973,6 +57354,9 @@ msgid "" "Generally the [InputEvent] is a keyboard key, though it can be any " "[InputEvent]." msgstr "" +"Le [InputEvent] du racourci.\n" +"C'est en général ce [InputEvent] est une touche du clavier, mais ça peut " +"être n'importe quel [InputEvent]." #: doc/classes/Skeleton.xml msgid "Skeleton for characters and animated objects." @@ -56036,7 +57420,7 @@ msgstr "" #: doc/classes/Skeleton.xml msgid "Returns the name of the bone at index [code]index[/code]." -msgstr "" +msgstr "Retourne le nom de l'os à la position [code]index[/code]." #: doc/classes/Skeleton.xml msgid "" @@ -56260,23 +57644,23 @@ msgstr "" #: doc/classes/Sky.xml msgid "Radiance texture size is 32×32 pixels." -msgstr "" +msgstr "La texture de rayonnement fait 32x32 pixels." #: doc/classes/Sky.xml msgid "Radiance texture size is 64×64 pixels." -msgstr "" +msgstr "La texture de rayonnement fait 64x64 pixels." #: doc/classes/Sky.xml msgid "Radiance texture size is 128×128 pixels." -msgstr "" +msgstr "La texture de rayonnement fait 128x128 pixels." #: doc/classes/Sky.xml msgid "Radiance texture size is 256×256 pixels." -msgstr "" +msgstr "La texture de rayonnement fait 256x256 pixels." #: doc/classes/Sky.xml msgid "Radiance texture size is 512×512 pixels." -msgstr "" +msgstr "La texture de rayonnement fait 512x512 pixels." #: doc/classes/Sky.xml msgid "" @@ -56316,6 +57700,8 @@ msgstr "" #: doc/classes/Slider.xml msgid "If [code]true[/code], the value can be changed using the mouse wheel." msgstr "" +"Si [code]true[/code], la valeur peut être changée avec la molette de la " +"souris." #: doc/classes/Slider.xml msgid "" @@ -56360,6 +57746,8 @@ msgid "" "The amount of restitution of the rotation when the limit is surpassed.\n" "Does not affect damping." msgstr "" +"La quantité de restitution de la rotation quand la limite est dépassée.\n" +"N'affecte par l'amortissement." #: doc/classes/SliderJoint.xml msgid "" @@ -56518,6 +57906,7 @@ msgstr "" msgid "" "Returns the current [World] resource this [Spatial] node is registered to." msgstr "" +"Retourne l'actuelle ressource [World] auquel ce nœud [Spatial] est associé." #: doc/classes/Spatial.xml msgid "" @@ -56542,6 +57931,7 @@ msgid "" "Disables rendering of this node. Changes [member visible] to [code]false[/" "code]." msgstr "" +"Désactive le rendu de ce nœud. Change [member visible] à [code]false[/code]." #: doc/classes/Spatial.xml msgid "" @@ -56675,6 +58065,7 @@ msgid "" "Enables rendering of this node. Changes [member visible] to [code]true[/" "code]." msgstr "" +"Active le rendu de ce nœud. Change [member visible] à [code]true[/code]." #: doc/classes/Spatial.xml msgid "" @@ -56795,6 +58186,7 @@ msgstr "" #: doc/classes/Spatial.xml msgid "Spatial nodes receives this notification when their visibility changes." msgstr "" +"Les nœuds spatiaux reçoivent cette notification quand leur visibilité change." #: doc/classes/Spatial.xml msgid "" @@ -57469,7 +58861,7 @@ msgstr "" #: doc/classes/SpatialMaterial.xml msgid "The strength of the subsurface scattering effect." -msgstr "" +msgstr "L'intensité de l'effet de transluminance." #: doc/classes/SpatialMaterial.xml msgid "" @@ -57575,6 +58967,8 @@ msgstr "" #: doc/classes/SpatialMaterial.xml msgid "If [code]true[/code], the vertex color is used as albedo color." msgstr "" +"Si [code]true[/code], la couleur du sommet est utilisé pour la couleur de " +"l'albedo." #: doc/classes/SpatialMaterial.xml msgid "Texture specifying per-pixel color." @@ -57825,16 +59219,23 @@ msgstr "" msgid "" "Use [code]UV2[/code] coordinates to look up from the [member ao_texture]." msgstr "" +"Utiliser les coordonnées [code]UV2[/code] pour la projection de la [member " +"ao_texture]." #: doc/classes/SpatialMaterial.xml msgid "" "Use [code]UV2[/code] coordinates to look up from the [member " "emission_texture]." msgstr "" +"Utiliser les coordonnées [code]UV2[/code] pour la projection de la [member " +"emission_texture]." #: doc/classes/SpatialMaterial.xml +#, fuzzy msgid "Use alpha scissor. Set by [member params_use_alpha_scissor]." msgstr "" +"Utilise un ciseau pour l'alpha. Définit par [member " +"params_use_alpha_scissor]." #: doc/classes/SpatialMaterial.xml msgid "" @@ -57895,7 +59296,7 @@ msgstr "Ancien algorithme pour l'effet spéculaire, inclus pour compatibilité." #: doc/classes/SpatialMaterial.xml msgid "Toon blob which changes size based on roughness." -msgstr "" +msgstr "Le reflet en mode cartoon change de taille suivant la rugosité." #: doc/classes/SpatialMaterial.xml msgid "No specular blob." @@ -57924,19 +59325,19 @@ msgstr "" #: doc/classes/SpatialMaterial.xml msgid "Used to read from the red channel of a texture." -msgstr "" +msgstr "Utiliser pour lire la texture depuis le canal du rouge." #: doc/classes/SpatialMaterial.xml msgid "Used to read from the green channel of a texture." -msgstr "" +msgstr "Utiliser pour lire la texture depuis le canal du vert." #: doc/classes/SpatialMaterial.xml msgid "Used to read from the blue channel of a texture." -msgstr "" +msgstr "Utiliser pour lire la texture depuis le canal du bleu." #: doc/classes/SpatialMaterial.xml msgid "Used to read from the alpha channel of a texture." -msgstr "" +msgstr "Utiliser pour lire la texture depuis le canal de l'alpha." #: doc/classes/SpatialMaterial.xml msgid "Adds the emission color to the color from the emission texture." @@ -58199,6 +59600,7 @@ msgstr "" #: doc/classes/SpringArm.xml msgid "A helper node, mostly used in 3rd person cameras." msgstr "" +"Un nœud d'aide, surtout utilisé pour les caméras à la troisième personne." #: doc/classes/SpringArm.xml msgid "" @@ -58223,6 +59625,8 @@ msgstr "" msgid "" "Clears the list of [PhysicsBody] objects excluded from the collision check." msgstr "" +"Efface la liste des objets [PhysicsBody] exclus des vérifications de " +"collision." #: doc/classes/SpringArm.xml #, fuzzy @@ -58347,6 +59751,8 @@ msgid "" "The region of the atlas texture to display. [member region_enabled] must be " "[code]true[/code]." msgstr "" +"La région de la texture atlas à afficher. [member region_enabled] doit être " +"[code]true[/code]." #: doc/classes/Sprite.xml msgid "[Texture] object to draw." @@ -58406,7 +59812,7 @@ msgstr "Si [code]true[/code], le drapeau spécifié sera actif." #: doc/classes/SpriteBase3D.xml msgid "The direction in which the front of the texture faces." -msgstr "" +msgstr "La direction que pointe la face avant de cette texture." #: doc/classes/SpriteBase3D.xml msgid "" @@ -58522,6 +59928,8 @@ msgid "" "Returns an array containing the names associated to each animation. Values " "are placed in alphabetical order." msgstr "" +"Retourne un tableau contenant les noms associés à chaque animation. Ces " +"valeurs sont triées dans l'ordre alphabétique." #: doc/classes/SpriteFrames.xml msgid "The animation's speed in frames per second." @@ -58853,6 +60261,7 @@ msgstr "Retourne la taille de [member data_array]." #: doc/classes/StreamPeerBuffer.xml msgid "Resizes the [member data_array]. This [i]doesn't[/i] update the cursor." msgstr "" +"Redimensionne [member data_array]. Cela [i]ne met pas[/i] à jour le curseur." #: doc/classes/StreamPeerBuffer.xml msgid "" @@ -58912,7 +60321,7 @@ msgstr "Le status représentant un [StreamPeerSSL] durant la poignée de main." #: doc/classes/StreamPeerSSL.xml msgid "A status representing a [StreamPeerSSL] that is connected to a host." -msgstr "" +msgstr "Un status représentant un [StreamPeerSSL] qui est connecté à l'hôte." #: doc/classes/StreamPeerSSL.xml msgid "A status representing a [StreamPeerSSL] in error state." @@ -59324,6 +60733,8 @@ msgid "" "If the string is a valid file path, returns the full file path without the " "extension." msgstr "" +"Si la chaine de caractères est un chemin de fichier valide, ça retourne le " +"chemin complet du fichier sans son extension." #: doc/classes/String.xml msgid "" @@ -59548,7 +60959,7 @@ msgstr "" #: doc/classes/String.xml msgid "Returns a number of characters from the left of the string." -msgstr "" +msgstr "Retourne le nombre de caractères à gauche de la chaine de caractères." #: doc/classes/String.xml msgid "Returns the string's amount of characters." @@ -59586,7 +60997,7 @@ msgstr "" #: doc/classes/String.xml msgid "Returns the MD5 hash of the string as a string." -msgstr "" +msgstr "Retourne le hachage MD5, sous forme de chaine de caractères." #: doc/classes/String.xml msgid "" @@ -59915,12 +61326,16 @@ msgid "" "Removes a given string from the start if it starts with it or leaves the " "string unchanged." msgstr "" +"Retire la chaine de caractères spécifiée au début si elle commence avec, ou " +"laisse le chaine telle quelle." #: doc/classes/String.xml msgid "" "Removes a given string from the end if it ends with it or leaves the string " "unchanged." msgstr "" +"Retire la chaine de caractères spécifiée à la fin si elle se termine avec, " +"ou laisse le chaine telle quelle." #: doc/classes/String.xml msgid "" @@ -60108,6 +61523,8 @@ msgid "" "Returns the given [code]corner[/code]'s radius. See [enum Corner] for " "possible values." msgstr "" +"Retourne le rayon du coin [code]corner[/code] spécifié. Voir [enum Corner] " +"pour les valeurs possibles." #: doc/classes/StyleBoxFlat.xml doc/classes/StyleBoxTexture.xml msgid "" @@ -60120,16 +61537,22 @@ msgid "" "Sets the border width to [code]width[/code] pixels for the given " "[code]margin[/code]. See [enum Margin] for possible values." msgstr "" +"Définit l'épaisseur de la bordure [code]width[/code] en pixels pour la marge " +"[code]margin[/code] spécifié. Voir [enum Margin] pour les valeurs possibles." #: doc/classes/StyleBoxFlat.xml msgid "Sets the border width to [code]width[/code] pixels for all margins." msgstr "" +"Définit la largeur de la bordure en [code]width[/code] pixels pour toutes " +"les marges." #: doc/classes/StyleBoxFlat.xml msgid "" "Sets the corner radius to [code]radius[/code] pixels for the given " "[code]corner[/code]. See [enum Corner] for possible values." msgstr "" +"Définit la rayon du coin [code]radius[/code] en pixels pour le coin " +"[code]corner[/code] spécifié. Voir [enum Corner] pour les valeurs possibles." #: doc/classes/StyleBoxFlat.xml #, fuzzy @@ -60149,6 +61572,8 @@ msgid "" "Sets the expand margin to [code]size[/code] pixels for the given " "[code]margin[/code]. See [enum Margin] for possible values." msgstr "" +"Définit la marge d'expansion [code]size[/code] en pixels pour la marge " +"[code]margin[/code] spécifiée. Voir [enum Margin] pour les valeurs possibles." #: doc/classes/StyleBoxFlat.xml doc/classes/StyleBoxTexture.xml msgid "Sets the expand margin to [code]size[/code] pixels for all margins." @@ -60165,7 +61590,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -60226,53 +61651,76 @@ msgid "" "The bottom-left corner's radius. If [code]0[/code], the corner is not " "rounded." msgstr "" +"Le rayon du coin bas-gauche. Si [code]0[/code], le coin n'est pas arrondi." #: doc/classes/StyleBoxFlat.xml msgid "" "The bottom-right corner's radius. If [code]0[/code], the corner is not " "rounded." msgstr "" +"Le rayon du coin bas-droit. Si [code]0[/code], le coin n'est pas arrondi." #: doc/classes/StyleBoxFlat.xml msgid "" "The top-left corner's radius. If [code]0[/code], the corner is not rounded." msgstr "" +"Le rayon du coin haut-gauche. Si [code]0[/code], le coin n'est pas arrondi." #: doc/classes/StyleBoxFlat.xml msgid "" "The top-right corner's radius. If [code]0[/code], the corner is not rounded." msgstr "" +"Le rayon du coin haut-droit. Si [code]0[/code], le coin n'est pas arrondi." #: doc/classes/StyleBoxFlat.xml msgid "Toggles drawing of the inner part of the stylebox." -msgstr "" +msgstr "Active l'affichage de l'intérieur de la stylebox." #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -60280,6 +61728,8 @@ msgid "" "The color of the shadow. This has no effect if [member shadow_size] is lower " "than 1." msgstr "" +"La couleur de l'ombre. Ça n'a aucun effet si [member shadow_size] est " +"inférieur à 1." #: doc/classes/StyleBoxFlat.xml msgid "" @@ -60291,6 +61741,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "La taille de l'ombre en pixels." +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "Une [StyleBox] qui n'affiche qu'une seule ligne." @@ -60346,12 +61811,16 @@ msgid "" "Returns the size of the given [code]margin[/code]. See [enum Margin] for " "possible values." msgstr "" +"Retourne la taille de la marge [code]margin[/code] spécifiée. Voir [enum " +"Margin] pour les valeurs possibles." #: doc/classes/StyleBoxTexture.xml msgid "" "Sets the margin to [code]size[/code] pixels for the given [code]margin[/" "code]. See [enum Margin] for possible values." msgstr "" +"Définit la marge à [code]size[/code] pixels pour la [code]margin[/code] " +"spécifié. Voir [enum Margin] pour les valeurs possibles." #: doc/classes/StyleBoxTexture.xml msgid "" @@ -60454,7 +61923,7 @@ msgstr "" #: doc/classes/StyleBoxTexture.xml msgid "The texture to use when drawing this style box." -msgstr "" +msgstr "La texture à utiliser pour l'affichage de cette boite de style." #: doc/classes/StyleBoxTexture.xml msgid "Emitted when the stylebox's texture is changed." @@ -60518,6 +61987,8 @@ msgid "" "Specifies an array of bones to use for the [i]next[/i] vertex. [code]bones[/" "code] must contain 4 integers." msgstr "" +"Spécifie un tableau d'os à utiliser pour le [i]prochain[/i] sommet. " +"[code]bones[/code] doit contenir 4 entiers." #: doc/classes/SurfaceTool.xml msgid "" @@ -60580,6 +62051,8 @@ msgid "" "Specifies the position of current vertex. Should be called after specifying " "other vertex properties (e.g. Color, UV)." msgstr "" +"Spécifie la position de l'actuel sommet. Doit être appelé après avoir " +"spécifié les autres propriétés du sommet (par ex. la couleur, l'UV)." #: doc/classes/SurfaceTool.xml msgid "" @@ -60640,7 +62113,7 @@ msgstr "" #: doc/classes/SurfaceTool.xml msgid "Removes the index array by expanding the vertex array." -msgstr "" +msgstr "Supprime le tableau d'indices en augmentant celui des sommets." #: doc/classes/SurfaceTool.xml msgid "" @@ -60715,6 +62188,8 @@ msgid "" "Returns [code]true[/code] if the tab at index [code]tab_idx[/code] is " "disabled." msgstr "" +"Retourne [code]true[/code] si l'onglet à la position [code]tab_idx[/code] " +"est désactivé." #: doc/classes/TabContainer.xml #, fuzzy @@ -60773,7 +62248,7 @@ msgstr "" #: doc/classes/TabContainer.xml msgid "Sets an icon for the tab at index [code]tab_idx[/code]." -msgstr "" +msgstr "Définit une icône pour l'onglet à la position [code]tab_idx[/code]." #: doc/classes/TabContainer.xml msgid "" @@ -60807,18 +62282,24 @@ msgstr "" #: doc/classes/TabContainer.xml doc/classes/Tabs.xml msgid "If [code]true[/code], tabs can be rearranged with mouse drag." msgstr "" +"Si [code]true[/code], les onglets peuvent être réarrangés avec par déposé-" +"glissé." #: doc/classes/TabContainer.xml msgid "" "The alignment of all tabs in the tab container. See the [enum TabAlign] " "constants for details." msgstr "" +"L'alignement des toutes les onglets dans le conteneur. Voir les constantes " +"[enum TabAlign] pour plus de détails." #: doc/classes/TabContainer.xml msgid "" "If [code]true[/code], tabs are visible. If [code]false[/code], tabs' content " "and titles are hidden." msgstr "" +"Si [code]true[/code], les onglets sont visibles. Si [code]false[/code], le " +"contenu des onglets et les titres sont masqués." #: doc/classes/TabContainer.xml msgid "" @@ -60907,13 +62388,15 @@ msgstr "" #: doc/classes/TabContainer.xml msgid "The icon for the menu button (see [method set_popup])." -msgstr "" +msgstr "L'icône pour le bouton de menu (voir [method set_popup])." #: doc/classes/TabContainer.xml msgid "" "The icon for the menu button (see [method set_popup]) when it's being " "hovered with the cursor." msgstr "" +"L'icône du bouton de menu (voir [method set_popup]) quand il est survolé par " +"le curseur de la souris." #: doc/classes/TabContainer.xml msgid "The style for the background fill." @@ -60998,10 +62481,14 @@ msgstr "" #: doc/classes/Tabs.xml msgid "Sets an [code]icon[/code] for the tab at index [code]tab_idx[/code]." msgstr "" +"Définit une [code]icon[/code] pour l'onglet à la position [code]tab_idx[/" +"code]." #: doc/classes/Tabs.xml msgid "Sets a [code]title[/code] for the tab at index [code]tab_idx[/code]." msgstr "" +"Définit un [code]title[/code] pour l'onglet à la position [code]tab_idx[/" +"code]." #: doc/classes/Tabs.xml msgid "" @@ -61025,6 +62512,7 @@ msgstr "" #: doc/classes/Tabs.xml msgid "The alignment of all tabs. See [enum TabAlign] for details." msgstr "" +"L'alignement de tous les onglets. Voir [enum TabAlign] plus les détails." #: doc/classes/Tabs.xml msgid "" @@ -61044,7 +62532,7 @@ msgstr "Émis quand un onglet a été cliqué-droit." #: doc/classes/Tabs.xml msgid "Emitted when a tab is clicked, even if it is the current tab." -msgstr "" +msgstr "Émis quand un onglet est cliqué, même si c'est l'onglet actuel." #: doc/classes/Tabs.xml msgid "Emitted when a tab is closed." @@ -61064,7 +62552,7 @@ msgstr "Ne jamais afficher les boutons fermer." #: doc/classes/Tabs.xml msgid "Only show the close button on the currently active tab." -msgstr "" +msgstr "N'afficher le bouton fermer que pour l'onglet actif." #: doc/classes/Tabs.xml msgid "Show the close button on all tabs." @@ -61257,7 +62745,7 @@ msgstr "" #: doc/classes/TextEdit.xml msgid "Returns the amount of total lines in the text." -msgstr "" +msgstr "Retourne le nombre total de lignes dans le texte." #: doc/classes/TextEdit.xml #, fuzzy @@ -61485,7 +62973,7 @@ msgstr "" #: doc/classes/TextEdit.xml msgid "If [code]true[/code], hides the line of the specified index." -msgstr "" +msgstr "Si [code]true[/code], cache la ligne à l'index spécifié." #: doc/classes/TextEdit.xml msgid "" @@ -61525,6 +63013,8 @@ msgid "" "If [code]true[/code], the caret displays as a rectangle.\n" "If [code]false[/code], the caret displays as a bar." msgstr "" +"Si [code]true[/code], le curseur du texte sera affiché par rectangle.\n" +"Si [code]false[/code], ça sera une barre." #: doc/classes/TextEdit.xml msgid "" @@ -61566,6 +63056,8 @@ msgid "" "If [code]true[/code], all occurrences of the selected text will be " "highlighted." msgstr "" +"Si [code]true[/code], toutes les occurrences du texte sélectionné sont " +"surlignées." #: doc/classes/TextEdit.xml msgid "If [code]true[/code], the line containing the cursor is highlighted." @@ -61593,6 +63085,8 @@ msgid "" "If [code]true[/code], read-only mode is enabled. Existing text cannot be " "modified and new text cannot be added." msgstr "" +"Si [code]true[/code], le mode lecture seul est actif. Le texte déjà existant " +"ne peut pas être modifié et aucun nouveau texte ne peut être ajouté." #: doc/classes/TextEdit.xml msgid "" @@ -61679,17 +63173,19 @@ msgstr "Recherche de la fin au début." #: doc/classes/TextEdit.xml msgid "Used to access the result column from [method search]." -msgstr "" +msgstr "Utile pour accéder à la colonne des résultats pour [method search]." #: doc/classes/TextEdit.xml msgid "Used to access the result line from [method search]." -msgstr "" +msgstr "Utile pour accéder à la line des résultats pour [method search]." #: doc/classes/TextEdit.xml msgid "" "Pastes the clipboard text over the selected text (or at the cursor's " "position)." msgstr "" +"Colle le texte dans le presse-papiers sur le texte sélectionné (ou à la " +"position du curseur)." #: doc/classes/TextEdit.xml msgid "Erases the whole [TextEdit] text." @@ -61708,6 +63204,8 @@ msgid "" "Sets the background [Color] of this [TextEdit]. [member syntax_highlighting] " "has to be enabled." msgstr "" +"Définit la [Color] de l'arrière-plan de ce [TextEdit]. [member " +"syntax_highlighting] doit être actif." #: doc/classes/TextEdit.xml msgid "" @@ -61732,12 +63230,16 @@ msgid "" "Sets the [Color] of the selected text. [member override_selected_font_color] " "has to be enabled." msgstr "" +"Définit la [Color] du texte sélectionné. [member " +"override_selected_font_color] doit être actif." #: doc/classes/TextEdit.xml msgid "" "Sets the [Color] of the line numbers. [member show_line_numbers] has to be " "enabled." msgstr "" +"Définit la [Color] des numéros de ligne. [member show_line_numbers] doit " +"être actif." #: doc/classes/TextEdit.xml msgid "Sets the [Color] of marked text." @@ -61846,6 +63348,8 @@ msgid "" "Default flags. [constant FLAG_MIPMAPS], [constant FLAG_REPEAT] and [constant " "FLAG_FILTER] are enabled." msgstr "" +"Le drapeau par défaut. [constant FLAG_MIPMAPS], [constant FLAG_REPEAT] et " +"[constant FLAG_FILTER] sont activés." #: doc/classes/Texture.xml doc/classes/VisualServer.xml msgid "" @@ -62034,7 +63538,7 @@ msgstr "" #: doc/classes/TextureButton.xml doc/classes/TextureRect.xml msgid "Scale to fit the node's bounding rectangle." -msgstr "" +msgstr "Change l'échelle pour adapter le rectangle total du nœud." #: doc/classes/TextureButton.xml doc/classes/TextureRect.xml msgid "Tile inside the node's bounding rectangle." @@ -62105,17 +63609,21 @@ msgid "" "Returns the height of the texture. Height is typically represented by the Y-" "axis." msgstr "" +"Retourne la hauteur de la texture. Elle correspond en général à l'axe Y." #: doc/classes/TextureLayered.xml msgid "" "Returns an [Image] resource with the data from specified [code]layer[/code]." msgstr "" +"Retourne la ressource de [Image] avec les données du [code]layer[/code] " +"spécifié." #: doc/classes/TextureLayered.xml msgid "" "Returns the width of the texture. Width is typically represented by the X-" "axis." msgstr "" +"Retourne la largeur de la texture. Elle correspond en général à l'axe X." #: doc/classes/TextureLayered.xml msgid "" @@ -62134,6 +63642,7 @@ msgstr "" #: doc/classes/TextureLayered.xml msgid "Returns a dictionary with all the data used by this texture." msgstr "" +"Retourne un dictionnaire avec toutes les données utilisées par cette texture." #: doc/classes/TextureLayered.xml msgid "Specifies which [enum Flags] apply to this texture." @@ -62157,6 +63666,8 @@ msgstr "La texture génèrera des mipmaps à la création." #: doc/classes/TextureLayered.xml msgid "Texture will repeat when UV used is outside the 0-1 range." msgstr "" +"La texture sera répétée quand l'UV sera en dehors de l'intervalle entre 0 et " +"1." #: doc/classes/TextureLayered.xml msgid "" @@ -62181,6 +63692,7 @@ msgstr "" #: doc/classes/TextureProgress.xml msgid "The fill direction. See [enum FillMode] for possible values." msgstr "" +"La direction de remplissage. Voir [enum FillMode] pour les valeurs possibles." #: doc/classes/TextureProgress.xml msgid "" @@ -62323,6 +63835,8 @@ msgid "" "The [member texture_progress] fills from the center, expanding both towards " "the top and the bottom." msgstr "" +"La [member texture_progress] remplie depuis le centre, puis à la fois en " +"direction du haut et du bas." #: doc/classes/TextureProgress.xml msgid "" @@ -62463,7 +63977,7 @@ msgstr "" #: doc/classes/Theme.xml msgid "Sets the theme's values to a copy of a given theme." -msgstr "" +msgstr "Définit les valeurs du thème à partir d'une copie d'un thème donné." #: doc/classes/Theme.xml #, fuzzy @@ -63123,6 +64637,8 @@ msgstr "La taille de cellule du TileMap." #: doc/classes/TileMap.xml msgid "Position for tile origin. See [enum TileOrigin] for possible values." msgstr "" +"La position de l'origine de la tuile. Voir [enum TileOrigin] pour les " +"valeurs possibles." #: doc/classes/TileMap.xml #, fuzzy @@ -63147,12 +64663,16 @@ msgid "" "Bounce value for static body collisions (see [code]collision_use_kinematic[/" "code])." msgstr "" +"La valeur de rebondissement pour les collisions avec les corps statiques " +"(voir [code]collision_use_kinematic[/code])." #: doc/classes/TileMap.xml msgid "" "Friction value for static body collisions (see " "[code]collision_use_kinematic[/code])." msgstr "" +"La valeur de friction pour les collisions avec les corps statiques (voir " +"[code]collision_use_kinematic[/code])." #: doc/classes/TileMap.xml msgid "" @@ -63371,7 +64891,7 @@ msgstr "" #: doc/classes/TileSet.xml msgid "Sets the [enum BitmaskMode] of the autotile." -msgstr "" +msgstr "Définit le [enum BitmaskMode] de l'auto-tuile." #: doc/classes/TileSet.xml msgid "" @@ -63433,6 +64953,8 @@ msgid "" "Returns the ID following the last currently used ID, useful when creating a " "new tile." msgstr "" +"Retourne l'identifiant qui suit le dernier identifiant actuellement utilisé, " +"utile pour la création de nouvelle tuile." #: doc/classes/TileSet.xml msgid "Returns an array of all currently used tile IDs." @@ -63494,7 +65016,7 @@ msgstr "Retourne le nombre de formes assignées à une tuile." #: doc/classes/TileSet.xml msgid "Returns the offset of a tile's shape." -msgstr "" +msgstr "Retourne le décalage de la forme de la tuile." #: doc/classes/TileSet.xml msgid "Returns the one-way collision value of a tile's shape." @@ -63502,7 +65024,7 @@ msgstr "" #: doc/classes/TileSet.xml msgid "Returns the [Transform2D] of a tile's shape." -msgstr "" +msgstr "Retourne la [Transform2D] de la forme de la tuile." #: doc/classes/TileSet.xml msgid "" @@ -63533,7 +65055,7 @@ msgstr "Retourne le [enum TileMode] de la tuile." #: doc/classes/TileSet.xml msgid "Returns the tile's Z index (drawing layer)." -msgstr "" +msgstr "Retourne l'index selon Z (le claque d'affichage) de la tuile." #: doc/classes/TileSet.xml msgid "Sets a light occluder for the tile." @@ -63588,7 +65110,7 @@ msgstr "Définit une forme pour la tuile, activant la collision." #: doc/classes/TileSet.xml msgid "Sets the offset of a tile's shape." -msgstr "" +msgstr "Définit le décalage de la forme de la tuile." #: doc/classes/TileSet.xml msgid "Enables one-way collision on a tile's shape." @@ -63681,7 +65203,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -63817,14 +65341,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -64200,6 +65728,8 @@ msgstr "" msgid "" "Constructs the Transform from a [Basis]. The origin will be Vector3(0, 0, 0)." msgstr "" +"Construit une transformation avec une [Basis]. L'origine sera Vector3(0, 0, " +"0)." #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" @@ -64226,6 +65756,9 @@ msgid "" "approximately equal, by calling [code]is_equal_approx[/code] on each " "component." msgstr "" +"Retourne [code]true[/code] si cette transformation est [code]transform[/" +"code] sont approximativement égales, c'est-à-dire en appelant " +"[code]is_equal_approx[/code] pour chaque composant." #: doc/classes/Transform.xml msgid "" @@ -64246,21 +65779,28 @@ msgstr "" "d’axe normalisé (échelle de 1 ou -1)." #: doc/classes/Transform.xml +#, fuzzy msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" +"Pivote ce vecteur autour de l'axe donné par [code]phi[/code] radians. L'axe " +"donné doit être normalisé." #: doc/classes/Transform.xml +#, fuzzy msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" +"Met à l'échelle le transform par le facteur d'échelle donné, en utilisant la " +"multiplication matricielle." #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -64270,6 +65810,8 @@ msgid "" "Transforms the given [Vector3], [Plane], [AABB], or [PoolVector3Array] by " "this transform." msgstr "" +"Applique cette transformation au [Vector3], [Plane], [AABB], ou " +"[PoolVector3Array] spécifié." #: doc/classes/Transform.xml msgid "" @@ -64375,16 +65917,19 @@ msgid "Returns the scale." msgstr "Retourne l’échelle." #: doc/classes/Transform2D.xml +#, fuzzy msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" "Fait pivoter le transform par l’angle donné (dans les radians), utilisant la " "multiplication de la matrice." #: doc/classes/Transform2D.xml +#, fuzzy msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" "Met à l'échelle le transform par le facteur d'échelle donné, en utilisant la " "multiplication matricielle." @@ -64594,6 +66139,8 @@ msgstr "" msgid "" "Returns the column index at [code]position[/code], or -1 if no item is there." msgstr "" +"Retourne l'index de la colonne à [code]position[/code], ou -1 s'il n'y en a " +"aucune." #: doc/classes/Tree.xml msgid "Returns the column's title." @@ -64626,7 +66173,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -64779,12 +66326,15 @@ msgid "" "Emitted when a cell with the [constant TreeItem.CELL_MODE_CUSTOM] is clicked " "to be edited." msgstr "" +"Émis quand une cellule en mode [constant TreeItem.CELL_MODE_CUSTOM] a été " +"cliquée pour modifiée." #: doc/classes/Tree.xml msgid "" "Emitted when the right mouse button is pressed in the empty space of the " "tree." msgstr "" +"Émis quand l'utilisateur fait un clic-droit dans l'espace vide de l'arbre." #: doc/classes/Tree.xml msgid "" @@ -64980,12 +66530,16 @@ msgid "" "The check icon to display when the [constant TreeItem.CELL_MODE_CHECK] mode " "cell is checked." msgstr "" +"L'icône de la coche à afficher quand un cellule en mode [constant TreeItem." +"CELL_MODE_CHECK] est cochée." #: doc/classes/Tree.xml msgid "" "The arrow icon to display for the [constant TreeItem.CELL_MODE_RANGE] mode " "cell." msgstr "" +"L'icône de la flèche à afficher pour les cellules en mode [constant TreeItem." +"CELL_MODE_RANGE]." #: doc/classes/Tree.xml msgid "" @@ -65008,6 +66562,8 @@ msgid "" "Default [StyleBox] for the [Tree], i.e. used when the control is not being " "focused." msgstr "" +"La [StyleBox] par défaut du [Tree], par ex. utilisé quand le contrôle n'a " +"pas le focus." #: doc/classes/Tree.xml msgid "[StyleBox] used when the [Tree] is being focused." @@ -65106,7 +66662,7 @@ msgstr "Rétablit la couleur d'arrière-plan par défaut de la colonne spécifi #: doc/classes/TreeItem.xml msgid "Resets the color for the given column to default." -msgstr "" +msgstr "Rétablit la couleur de la colonne spécifiée à la valeur par défaut." #: doc/classes/TreeItem.xml msgid "Deselects the given column." @@ -65117,6 +66673,8 @@ msgid "" "Removes the button at index [code]button_idx[/code] in column [code]column[/" "code]." msgstr "" +"Retire le bouton à la position [code]button_idx[/code] dans la colonne " +"[code]column[/code]." #: doc/classes/TreeItem.xml #, fuzzy @@ -65247,6 +66805,8 @@ msgid "" "Returns a dictionary containing the range parameters for a given column. The " "keys are \"min\", \"max\", \"step\", and \"expr\"." msgstr "" +"Retourne un dictionnaire contenant les paramètres de la plage pour la " +"colonne donnée. Les clés sont \"min\", \"max\", \"step\", et \"expr\"." #: doc/classes/TreeItem.xml msgid "Gets the suffix string shown after the column value." @@ -65473,11 +67033,11 @@ msgstr "Type de maillage interne." #: doc/classes/TriangleMesh.xml msgid "Mesh type used internally for collision calculations." -msgstr "" +msgstr "Le type de maillage utilisé en interne pour le calcul des collisions." #: doc/classes/Tween.xml msgid "Smoothly animates a node's properties over time." -msgstr "" +msgstr "Anime de manière fluide une propriété d'un nœud dans le temps." #: doc/classes/Tween.xml msgid "" @@ -65515,7 +67075,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -65555,6 +67117,9 @@ msgid "" "code]. [code]arg1[/code]-[code]arg5[/code] are arguments to be passed to the " "callback." msgstr "" +"Appelle la fonction [code]callback[/code] de [code]object[/code] après une " +"durée [code]duration[/code]. Les arguments [code]arg1[/code] à [code]arg5[/" +"code] sont ceux passés à la fonction." #: doc/classes/Tween.xml msgid "" @@ -65613,10 +67178,13 @@ msgid "" msgstr "" #: doc/classes/Tween.xml +#, fuzzy msgid "" "Resets all tweens to their initial values (the ones given, not those before " "the tween)." msgstr "" +"Rétablit les tween à la leur valeur par défaut (pour celles données, pas " +"celles avant les tween)." #: doc/classes/Tween.xml msgid "" @@ -65638,6 +67206,8 @@ msgid "" "Activates/deactivates the tween. See also [method stop_all] and [method " "resume_all]." msgstr "" +"Active ou désactive le tween. Voir aussi [method stop_all] et [method " +"resume_all]." #: doc/classes/Tween.xml msgid "Starts the tween. You can define animations both before and after this." @@ -65684,6 +67254,7 @@ msgstr "Retourne le temps actuel du tween." #: doc/classes/Tween.xml msgid "The tween's animation process thread. See [enum TweenProcessMode]." msgstr "" +"Le fil d'exécution de l'animation du tween. Voir [enum TweenProcessMode]." #: doc/classes/Tween.xml msgid "" @@ -65699,7 +67270,7 @@ msgstr "Si [code]true[/code], le tween se répète." #: doc/classes/Tween.xml msgid "Emitted when all processes in a tween end." -msgstr "" +msgstr "Émis quand toutes les processus du tween sont finis." #: doc/classes/Tween.xml msgid "Emitted when a tween ends." @@ -65803,6 +67374,23 @@ msgstr "" "Une combinaison de [constant EASE_IN] et de [constant EASE_OUT]. " "L'interpolation est plus rapide au début et à la fin." +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +#, fuzzy +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "Émis quand le nœud entre dans l'arborescence." + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "Une classe d'aide pour implémenter un serveur UDP." @@ -66122,7 +67710,7 @@ msgstr "" #: modules/upnp/doc_classes/UPNP.xml msgid "Adds the given [UPNPDevice] to the list of discovered devices." -msgstr "" +msgstr "Ajouter le [UPNPDevice] spécifié à la liste des appareils découverts." #: modules/upnp/doc_classes/UPNP.xml msgid "" @@ -66202,6 +67790,8 @@ msgid "" "Sets the device at [code]index[/code] from the list of discovered devices to " "[code]device[/code]." msgstr "" +"Définit le périphérique à l'index [code]index[/code] dans la liste des " +"périphériques découverts à [code]device[/code]." #: modules/upnp/doc_classes/UPNP.xml msgid "If [code]true[/code], IPv6 is used for [UPNPDevice] discovery." @@ -66225,7 +67815,7 @@ msgstr "" #: modules/upnp/doc_classes/UPNP.xml msgid "UPNP command or discovery was successful." -msgstr "" +msgstr "La commande ou la découverte UPNP a réussi." #: modules/upnp/doc_classes/UPNP.xml msgid "" @@ -66261,18 +67851,20 @@ msgstr "" #: modules/upnp/doc_classes/UPNP.xml msgid "The [UPNPDevice] does not allow wildcard values for the external port." msgstr "" +"Les [UPNPDevice] n'autorisent pas les astérismes pour les ports externes." #: modules/upnp/doc_classes/UPNP.xml msgid "The [UPNPDevice] does not allow wildcard values for the internal port." msgstr "" +"Les [UPNPDevice] n'autorisent pas les astérismes pour les ports internes." #: modules/upnp/doc_classes/UPNP.xml msgid "The remote host value must be a wildcard." -msgstr "" +msgstr "La valeur de l'hôte distante doit être un astérisme." #: modules/upnp/doc_classes/UPNP.xml msgid "The external port value must be a wildcard." -msgstr "" +msgstr "La valeur du port externe doit être un astérisme." #: modules/upnp/doc_classes/UPNP.xml msgid "" @@ -66293,7 +67885,7 @@ msgstr "" #: modules/upnp/doc_classes/UPNP.xml msgid "External and internal port values must be the same." -msgstr "" +msgstr "Le port externe et interne doivent être les mêmes." #: modules/upnp/doc_classes/UPNP.xml msgid "" @@ -66408,6 +68000,8 @@ msgid "" "Address of the local machine in the network connecting it to this " "[UPNPDevice]." msgstr "" +"L'adresse locale sur le réseau de la machine qui se connecte à ce " +"[UPNPDevice]." #: modules/upnp/doc_classes/UPNPDevice.xml msgid "IGD service type." @@ -66554,7 +68148,7 @@ msgstr "Conteneur vertical. Voir [BoxContainer]." #: doc/classes/VBoxContainer.xml msgid "The vertical space between the [VBoxContainer]'s elements." -msgstr "" +msgstr "L'espacement vertical entre les éléments du [VBoxContainer]." #: doc/classes/Vector2.xml msgid "Vector used for 2D math." @@ -66609,7 +68203,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -66618,11 +68212,14 @@ msgid "" "Returns the aspect ratio of this vector, the ratio of [member x] to [member " "y]." msgstr "" +"Retourne le ratio de ce vecteur, soit [member x] divisé par [member y]." #: doc/classes/Vector2.xml doc/classes/Vector3.xml msgid "" "Returns the vector \"bounced off\" from a plane defined by the given normal." msgstr "" +"Retourne le vecteur ayant \"rebondit\" sur un plan définit par la normale " +"donnée." #: doc/classes/Vector2.xml doc/classes/Vector3.xml msgid "" @@ -66702,6 +68299,9 @@ msgid "" "approximately equal, by running [method @GDScript.is_equal_approx] on each " "component." msgstr "" +"Retourne [code]true[/code] si ce vecteur et [code]v[/code] sont " +"approximativement identiques, en utilisant [method @GDScript." +"is_equal_approx] sur chaque composant." #: doc/classes/Vector2.xml doc/classes/Vector3.xml msgid "" @@ -66775,9 +68375,10 @@ msgid "" msgstr "" #: doc/classes/Vector2.xml +#, fuzzy msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" "Retourne le vecteur pivoté par [code]phi[/code] en radians. Voir aussi " "[method @GDScript.deg2rad]." @@ -66822,6 +68423,8 @@ msgid "" "Returns a perpendicular vector rotated 90 degrees counter-clockwise compared " "to the original, with the same length." msgstr "" +"Retourne le vecteur perpendiculaire, pivoté de 90 degrés dans le sens anti-" +"horaire comparé à l'original, mais avec la même longueur." #: doc/classes/Vector2.xml doc/classes/Vector3.xml msgid "" @@ -66886,7 +68489,7 @@ msgstr "Vecteur utilisé en 3D." #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -66969,9 +68572,10 @@ msgid "Returns this vector reflected from a plane defined by the given normal." msgstr "" #: doc/classes/Vector3.xml +#, fuzzy msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" "Pivote ce vecteur autour de l'axe donné par [code]phi[/code] radians. L'axe " "donné doit être normalisé." @@ -67002,30 +68606,40 @@ msgid "" "Enumerated value for the X axis. Returned by [method max_axis] and [method " "min_axis]." msgstr "" +"La valeur de l'énumération pour l'axe X. Retourné par [method max_axis] et " +"[method min_axis]." #: doc/classes/Vector3.xml msgid "" "Enumerated value for the Y axis. Returned by [method max_axis] and [method " "min_axis]." msgstr "" +"La valeur de l'énumération pour l'axe Y. Retourné par [method max_axis] et " +"[method min_axis]." #: doc/classes/Vector3.xml msgid "" "Enumerated value for the Z axis. Returned by [method max_axis] and [method " "min_axis]." msgstr "" +"La valeur de l'énumération pour l'axe Z. Retourné par [method max_axis] et " +"[method min_axis]." #: doc/classes/Vector3.xml msgid "" "Left unit vector. Represents the local direction of left, and the global " "direction of west." msgstr "" +"Le vecteur unitaire gauche. Représente la direction locale à gauche, et la " +"direction globale vers l'ouest." #: doc/classes/Vector3.xml msgid "" "Right unit vector. Represents the local direction of right, and the global " "direction of east." msgstr "" +"Le vecteur unitaire vers la droite. Représente la direction locale à droite, " +"et la direction globale vers l'est." #: doc/classes/Vector3.xml msgid "Up unit vector." @@ -67131,7 +68745,7 @@ msgstr "" #: doc/classes/VehicleWheel.xml msgid "Returns the rotational speed of the wheel in revolutions per minute." -msgstr "" +msgstr "Retourne la vitesse de rotation de la roue en tours par minute." #: doc/classes/VehicleWheel.xml msgid "" @@ -67320,6 +68934,7 @@ msgstr "Si [code]true[/code], la lecture commence au chargement de la scène." #: doc/classes/VideoPlayer.xml msgid "Amount of time in milliseconds to store in buffer while playing." msgstr "" +"La durée en millisecondes à stocker dans la mémoire lors de la lecture." #: doc/classes/VideoPlayer.xml msgid "Audio bus to use for sound playback." @@ -67373,6 +68988,7 @@ msgstr "" #: modules/gdnative/doc_classes/VideoStreamGDNative.xml msgid "[VideoStream] resource for for video formats implemented via GDNative." msgstr "" +"La ressource [VideoStream] pour les formats vidéo implémentés via GDNative." #: modules/gdnative/doc_classes/VideoStreamGDNative.xml msgid "" @@ -67419,6 +69035,9 @@ msgid "" "handles. The [code]file[/code] name should have the [code].ogv[/code] " "extension." msgstr "" +"Définit le fichier vidéo Ogg Theora que cette ressource [VideoStreamTheora] " +"supporte. Le nom de fichier [code]file[/code] doit avoir l'extension [code]." +"ogv[/code]." #: modules/webm/doc_classes/VideoStreamWebm.xml msgid "[VideoStream] resource for WebM videos." @@ -67441,7 +69060,7 @@ msgstr "" #: modules/webm/doc_classes/VideoStreamWebm.xml msgid "Returns the WebM video file handled by this [VideoStreamWebm]." -msgstr "" +msgstr "Retourne le fichier vidéo WebM géré par ce [VideoStreamWebm]." #: modules/webm/doc_classes/VideoStreamWebm.xml msgid "" @@ -67577,7 +69196,9 @@ msgstr "Retourne [code]true[/code] si l'opération de déposer-glisser a réussi #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -67599,6 +69220,7 @@ msgstr "" #: doc/classes/Viewport.xml msgid "Stops the input from propagating further down the [SceneTree]." msgstr "" +"Arrête la propagation de l'entrée plus profondément dans le [SceneTree]." #: doc/classes/Viewport.xml msgid "" @@ -67634,11 +69256,11 @@ msgstr "Si [code]true[/code], la texture sera centrée." #: doc/classes/Viewport.xml msgid "If [code]true[/code], the viewport will process 2D audio streams." -msgstr "" +msgstr "Si [code]true[/code], la fenêtre d'affichage gèrera les flux audio 2D." #: doc/classes/Viewport.xml msgid "If [code]true[/code], the viewport will process 3D audio streams." -msgstr "" +msgstr "Si [code]true[/code], la fenêtre d'affichage gèrera les flux audio 3D." #: doc/classes/Viewport.xml msgid "" @@ -67863,12 +69485,14 @@ msgstr "" #: doc/classes/Viewport.xml msgid "Do not update the render target." -msgstr "" +msgstr "Ne pas mettre à jour la cible de rendu." #: doc/classes/Viewport.xml msgid "" "Update the render target once, then switch to [constant UPDATE_DISABLED]." msgstr "" +"Met à jour la cible de rendu une seule fois, puis passe en mode [constant " +"UPDATE_DISABLED]." #: doc/classes/Viewport.xml msgid "" @@ -67890,14 +69514,17 @@ msgstr "" #: doc/classes/Viewport.xml msgid "This quadrant will be split in 4 and used by up to 4 shadow maps." msgstr "" +"Ce quadrant sera découpé en 4, et utilisé pour jusqu'à 4 parties d'ombre." #: doc/classes/Viewport.xml msgid "This quadrant will be split 16 ways and used by up to 16 shadow maps." msgstr "" +"Ce quadrant sera découpé en 16, et utilisé pour jusqu'à 16 parties d'ombre." #: doc/classes/Viewport.xml msgid "This quadrant will be split 64 ways and used by up to 64 shadow maps." msgstr "" +"Ce quadrant sera découpé en 64, et utilisé pour jusqu'à 64 parties d'ombre." #: doc/classes/Viewport.xml msgid "" @@ -68395,7 +70022,7 @@ msgstr "" #: modules/visual_script/doc_classes/VisualScript.xml msgid "Add a node to a function of the VisualScript." -msgstr "" +msgstr "Ajoute un nœud à une fonction du VisualScript." #: modules/visual_script/doc_classes/VisualScript.xml msgid "" @@ -68407,6 +70034,8 @@ msgstr "" msgid "" "Add an argument to a custom signal added with [method add_custom_signal]." msgstr "" +"Ajoute un argument à un signal personnalité ajouté avec [method " +"add_custom_signal]." #: modules/visual_script/doc_classes/VisualScript.xml msgid "Get the count of a custom signal's arguments." @@ -68434,7 +70063,7 @@ msgstr "Change le type de l'argument du signal personnalisé." #: modules/visual_script/doc_classes/VisualScript.xml msgid "Swap two of the arguments of a custom signal." -msgstr "" +msgstr "Échange deux des arguments d'un signal personnalisé." #: modules/visual_script/doc_classes/VisualScript.xml msgid "" @@ -68442,11 +70071,16 @@ msgid "" "[code]from_port[/code] would be fed into [code]to_node[/code]'s " "[code]to_port[/code]." msgstr "" +"Connecte deux ports de données. La valeur du port [code]from_port[/code] de " +"[code]from_node[/code] sera transféré au port [code]to_port[/code] de " +"[code]to_node[/code]." #: modules/visual_script/doc_classes/VisualScript.xml msgid "" "Disconnect two data ports previously connected with [method data_connect]." msgstr "" +"Déconnecte deux ports de données précédemment connectés avec [method " +"data_connect]." #: modules/visual_script/doc_classes/VisualScript.xml msgid "Returns the id of a function's entry point node." @@ -68458,7 +70092,7 @@ msgstr "" #: modules/visual_script/doc_classes/VisualScript.xml msgid "Returns a node given its id and its function." -msgstr "" +msgstr "Retourne le nœud définit par son identifiant et sa fonction." #: modules/visual_script/doc_classes/VisualScript.xml msgid "Returns a node's position in pixels." @@ -68480,27 +70114,27 @@ msgstr "" #: modules/visual_script/doc_classes/VisualScript.xml msgid "Returns whether a signal exists with the specified name." -msgstr "" +msgstr "Retourne s'il existe un signal avec le nom spécifié." #: modules/visual_script/doc_classes/VisualScript.xml msgid "Returns whether the specified data ports are connected." -msgstr "" +msgstr "Retourne si les ports de données spécifiés sont connectés." #: modules/visual_script/doc_classes/VisualScript.xml msgid "Returns whether a function exists with the specified name." -msgstr "" +msgstr "Retourne s'il existe une fonction avec le nom spécifié." #: modules/visual_script/doc_classes/VisualScript.xml msgid "Returns whether a node exists with the given id." -msgstr "" +msgstr "Retourne s'il existe un nœud avec le nom spécifié." #: modules/visual_script/doc_classes/VisualScript.xml msgid "Returns whether the specified sequence ports are connected." -msgstr "" +msgstr "Retourne si les ports de séquence spécifiés sont connectés." #: modules/visual_script/doc_classes/VisualScript.xml msgid "Returns whether a variable exists with the specified name." -msgstr "" +msgstr "Retourne s'il existe une variable avec le nom spécifié." #: modules/visual_script/doc_classes/VisualScript.xml msgid "Remove a custom signal with the given name." @@ -68568,10 +70202,12 @@ msgstr "Modifie quand une variable est exportée." msgid "" "Set a variable's info, using the same format as [method get_variable_info]." msgstr "" +"Définit les informations d'une variable, avec le même format que [method " +"get_variable_info]." #: modules/visual_script/doc_classes/VisualScript.xml msgid "Emitted when the ports of a node are changed." -msgstr "" +msgstr "Émis quand les ports d'un nœud ont changés." #: modules/visual_script/doc_classes/VisualScriptBasicTypeConstant.xml msgid "A Visual Script node representing a constant from the base types." @@ -68585,7 +70221,7 @@ msgstr "" #: modules/visual_script/doc_classes/VisualScriptBasicTypeConstant.xml msgid "The type to get the constant from." -msgstr "" +msgstr "Le type à partir duquel obtenir la constante." #: modules/visual_script/doc_classes/VisualScriptBasicTypeConstant.xml msgid "The name of the constant to return." @@ -68632,15 +70268,15 @@ msgstr "Retourne la tangent hyperbolique de l'entrée." #: modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml msgid "Return the arc sine of the input." -msgstr "" +msgstr "Retourne l'arc sinus de l'entrée." #: modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml msgid "Return the arc cosine of the input." -msgstr "" +msgstr "Retourne l'arc cosinus de l'entrée." #: modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml msgid "Return the arc tangent of the input." -msgstr "" +msgstr "Retourne l'arc tangente de l'entrée." #: modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml msgid "" @@ -68657,6 +70293,8 @@ msgid "" "Return the remainder of one input divided by the other, using floating-point " "numbers." msgstr "" +"Retourne le reste de la division d'une entrée par l'autre, en utilisant des " +"flottants." #: modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml msgid "" @@ -68726,10 +70364,13 @@ msgstr "" "progressive." #: modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml +#, fuzzy msgid "" "Return the number of digit places after the decimal that the first non-zero " "digit occurs." msgstr "" +"Retourne le nombre de décimales après la première décimale différente de " +"zéro." #: modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml msgid "Return the input snapped to a given step." @@ -68744,6 +70385,7 @@ msgstr "" #: modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml msgid "Moves the number toward a value, based on the third input." msgstr "" +"Rapproche un nombre vers une valeur, en fonction de la troisième entrée." #: modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml msgid "" @@ -68830,7 +70472,7 @@ msgstr "Crée une référence faible [WeakRef] de l'entrée." #: modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml msgid "Create a [FuncRef] from the input." -msgstr "" +msgstr "Crée une [FuncRef] à partir de l'entrée." #: modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml msgid "Convert between types." @@ -68844,7 +70486,7 @@ msgstr "" #: modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml msgid "Checks if a type is registered in the [ClassDB]." -msgstr "" +msgstr "Vérifie si une type est enregistré dans la [ClassDB]." #: modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml msgid "Return a character with the given ascii value." @@ -69060,18 +70702,20 @@ msgstr "Renvoie le nom du port d'entrée spécifié." msgid "" "Return the specified input port's type. See the [enum Variant.Type] values." msgstr "" +"Retourne le type du port d'entrée spécifié. Voir les valeurs dans [enum " +"Variant.Type]." #: modules/visual_script/doc_classes/VisualScriptCustomNode.xml msgid "Return the amount of output [b]sequence[/b] ports." -msgstr "" +msgstr "Retourne le nombre de ports de sortie de la [b]sequence[/b]." #: modules/visual_script/doc_classes/VisualScriptCustomNode.xml msgid "Return the specified [b]sequence[/b] output's name." -msgstr "" +msgstr "Retourne le nom de sortie de la [b]sequence[/b] spécifiée." #: modules/visual_script/doc_classes/VisualScriptCustomNode.xml msgid "Return the amount of output value ports." -msgstr "" +msgstr "Retourne le nombre de ports de valeur sortants." #: modules/visual_script/doc_classes/VisualScriptCustomNode.xml msgid "" @@ -69105,6 +70749,8 @@ msgid "" "Return the size of the custom node's working memory. See [method _step] for " "more details." msgstr "" +"Retourne la taille de la mémoire de travail du nœud personnalisé. Voir " +"[method _step] pour plus de détails." #: modules/visual_script/doc_classes/VisualScriptCustomNode.xml msgid "Return whether the custom node has an input [b]sequence[/b] port." @@ -69162,6 +70808,8 @@ msgid "" "Hint used by [method _step] to tell that control should stop and exit the " "function." msgstr "" +"Un indice utilisé par [method _step] pour préciser que ce contrôle doit " +"s'arrêter puis quitter la fonction." #: modules/visual_script/doc_classes/VisualScriptCustomNode.xml msgid "" @@ -69193,7 +70841,7 @@ msgstr "" #: modules/visual_script/doc_classes/VisualScriptEditor.xml msgid "Emitted when a custom Visual Script node is added or removed." -msgstr "" +msgstr "Émis quand un nœud Visual Script personnalisé est ajouté ou retiré." #: modules/visual_script/doc_classes/VisualScriptEmitSignal.xml msgid "Emits a specified signal." @@ -69302,6 +70950,8 @@ msgid "" "The singleton to call the method on. Used when [member call_mode] is set to " "[constant CALL_MODE_SINGLETON]." msgstr "" +"Le singleton à appeler par cette méthode. Utilisé quand [member call_mode] " +"est à [constant CALL_MODE_SINGLETON]." #: modules/visual_script/doc_classes/VisualScriptFunctionCall.xml msgid "" @@ -70309,7 +71959,7 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "Adds a circle command to the [CanvasItem]'s draw commands." -msgstr "" +msgstr "Ajouter un cercle aux commandes de dessin du [CanvasItem]." #: doc/classes/VisualServer.xml #, fuzzy @@ -70321,11 +71971,11 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "Adds a line command to the [CanvasItem]'s draw commands." -msgstr "" +msgstr "Ajouter une line aux commandes de dessin du [CanvasItem]." #: doc/classes/VisualServer.xml msgid "Adds a mesh command to the [CanvasItem]'s draw commands." -msgstr "" +msgstr "Ajouter un maillage aux commandes de dessin du [CanvasItem]." #: doc/classes/VisualServer.xml msgid "" @@ -70342,6 +71992,7 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "Adds a particle system to the [CanvasItem]'s draw commands." msgstr "" +"Ajouter un système de particules aux commandes de dessin du [CanvasItem]." #: doc/classes/VisualServer.xml msgid "Adds a polygon to the [CanvasItem]'s draw commands." @@ -70370,7 +72021,7 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "Adds a textured rect to the [CanvasItem]'s draw commands." -msgstr "" +msgstr "Ajouter un rectangle texturé aux commandes de dessin du [CanvasItem]." #: doc/classes/VisualServer.xml msgid "" @@ -70380,6 +72031,7 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "Adds a triangle array to the [CanvasItem]'s draw commands." msgstr "" +"Ajouter un tableau de triangles aux commandes de dessin du [CanvasItem]." #: doc/classes/VisualServer.xml msgid "Clears the [CanvasItem] and removes all commands in it." @@ -70458,6 +72110,8 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "Sets if [CanvasItem]'s children should be sorted by y-position." msgstr "" +"Définir si les enfants du [CanvasItem] doivent être triés par leur position " +"selon l'axe Y." #: doc/classes/VisualServer.xml msgid "Sets the [CanvasItem]'s [Transform2D]." @@ -70603,7 +72257,7 @@ msgstr "Définit la longueur du dégradé de l'ombre." #: doc/classes/VisualServer.xml msgid "Smoothens the shadow. The lower, the smoother." -msgstr "" +msgstr "L'intensité du lissage de l'ombre." #: doc/classes/VisualServer.xml msgid "" @@ -70728,6 +72382,8 @@ msgid "" "Sets the [i]BGMode[/i] of the environment. Equivalent to [member Environment." "background_mode]." msgstr "" +"Définit le mode d'arrière-plan [i]BGMode[/i] de l'environnement. Équivalent " +"à [member Environment.background_mode]." #: doc/classes/VisualServer.xml msgid "" @@ -71748,7 +73404,7 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "Returns the color by which the specified instance will be modulated." -msgstr "" +msgstr "Retourne la couleur par laquelle l'instance spécifiée sera modulée." #: doc/classes/VisualServer.xml msgid "Returns the custom data associated with the specified instance." @@ -71782,6 +73438,8 @@ msgid "" "Sets the [Transform] for this instance. Equivalent to [method MultiMesh." "set_instance_transform]." msgstr "" +"Définit la [Transform] pour cette instance. Équivalent à [method MultiMesh." +"set_instance_transform]." #: doc/classes/VisualServer.xml msgid "" @@ -71864,6 +73522,8 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "Returns [code]true[/code] if particles are currently set to emitting." msgstr "" +"Retourne [code]true[/code] si les particules sont actuellement en train " +"d'être émises." #: doc/classes/VisualServer.xml msgid "" @@ -72247,19 +73907,20 @@ msgstr "Alloue la mémoire tampon dans le GPU pour ce squelette." #: doc/classes/VisualServer.xml msgid "Returns the [Transform] set for a specific bone of this skeleton." -msgstr "" +msgstr "Retourne la [Transform] définie pour l'os spécifié pour ce squelette." #: doc/classes/VisualServer.xml msgid "Returns the [Transform2D] set for a specific bone of this skeleton." msgstr "" +"Retourne la [Transform2D] définie pour l'os spécifié pour ce squelette." #: doc/classes/VisualServer.xml msgid "Sets the [Transform] for a specific bone of this skeleton." -msgstr "" +msgstr "Définit la [Transform] pour un os spécifique de ce squelette." #: doc/classes/VisualServer.xml msgid "Sets the [Transform2D] for a specific bone of this skeleton." -msgstr "" +msgstr "Définit la [Transform2D] pour un os spécifique de ce squelette." #: doc/classes/VisualServer.xml #, fuzzy @@ -72280,7 +73941,7 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "Returns the number of bones allocated for this skeleton." -msgstr "" +msgstr "Retourne le nombre d'os alloués pour ce squelette." #: doc/classes/VisualServer.xml #, fuzzy @@ -72415,6 +74076,8 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "Sets the texture's flags. See [enum TextureFlags] for options." msgstr "" +"Définit les drapeaux de la texture. Voir [enum TextureFlags] pour les " +"options." #: doc/classes/VisualServer.xml msgid "Sets the texture's path." @@ -72422,6 +74085,32 @@ msgstr "Définit le chemin de la texture." #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -72515,7 +74204,7 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "Sets the transformation of a viewport's canvas." -msgstr "" +msgstr "Définit la transformation du canevas de la fenêtre d'affichage." #: doc/classes/VisualServer.xml msgid "" @@ -72538,6 +74227,8 @@ msgstr "" msgid "" "If [code]true[/code], rendering of a viewport's environment is disabled." msgstr "" +"Si [code]true[/code], le rendu de l'environnement de cette fenêtre " +"d'affichage est désactivé." #: doc/classes/VisualServer.xml msgid "Sets the viewport's global transformation matrix." @@ -72566,6 +74257,8 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "Sets the viewport's parent to another viewport." msgstr "" +"Définir le parent de la fenêtre d'affichage par une autre fenêtre " +"d'affichage." #: doc/classes/VisualServer.xml msgid "" @@ -72773,7 +74466,7 @@ msgstr "Répète la texture (plutôt que de s'arrêter aux bordures)." #: doc/classes/VisualServer.xml msgid "Repeats the texture with alternate sections mirrored." -msgstr "" +msgstr "Répète une texture en utilisant alternativement un effet de miroir." #: doc/classes/VisualServer.xml msgid "" @@ -73041,6 +74734,8 @@ msgstr "" msgid "" "Keeps shadows stable as camera moves but has lower effective resolution." msgstr "" +"Garde les ombres stables quand la caméra bouge, mais la résolution est " +"réduite." #: doc/classes/VisualServer.xml msgid "" @@ -73437,6 +75132,8 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "Reflection probe will update reflections once and then stop." msgstr "" +"La sonde de réflexion mettre à jour les réflexions une seule fois puis " +"s'arrêtera." #: doc/classes/VisualServer.xml msgid "" @@ -73492,6 +75189,8 @@ msgstr "Représente la taille de l'énumération [enum EnvironmentBG]." #: doc/classes/VisualServer.xml msgid "Use lowest blur quality. Fastest, but may look bad." msgstr "" +"Utilise la qualité de flou la plus basse. C'est le plus rapide mais donne le " +"plus mauvais résultat." #: doc/classes/VisualServer.xml msgid "Use medium blur quality." @@ -73519,24 +75218,44 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "Affiche uniquement l'effet de lueur sans scène sous-jacente." #: doc/classes/VisualServer.xml -msgid "Output color as they came in." -msgstr "Affiche les couleurs telles quelles." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." +msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." -msgstr "Utiliser le mappage des tons Reinhard." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." +msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." -msgstr "Utiliser le mappage des tons filmique." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." +msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." -msgstr "Utiliser le mappage des tons ACES." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." +msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." -msgstr "Utiliser le mappage des tons ACES Fitted." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." +msgstr "" #: doc/classes/VisualServer.xml msgid "Lowest quality of screen space ambient occlusion." @@ -73586,7 +75305,7 @@ msgstr "" #: doc/classes/VisualShader.xml msgid "A custom shader program with a visual editor." -msgstr "" +msgstr "Un programme de shader personnalisé dans l'éditeur visuel." #: doc/classes/VisualShader.xml msgid "" @@ -73757,7 +75476,7 @@ msgstr "Représente la taille de l'énumération [enum PortType]." #: doc/classes/VisualShaderNodeBooleanConstant.xml msgid "A boolean constant to be used within the visual shader graph." -msgstr "" +msgstr "Un booléen constant à utiliser dans le shader visuel du graphe." #: doc/classes/VisualShaderNodeBooleanConstant.xml msgid "" @@ -73773,7 +75492,7 @@ msgstr "" #: doc/classes/VisualShaderNodeBooleanUniform.xml msgid "A boolean uniform to be used within the visual shader graph." -msgstr "" +msgstr "Un booléen uniforme à utiliser dans le shader visuel du graphe." #: doc/classes/VisualShaderNodeBooleanUniform.xml msgid "Translated to [code]uniform bool[/code] in the shader language." @@ -73800,7 +75519,7 @@ msgstr "Active l'usage de [member default_value]." #: doc/classes/VisualShaderNodeColorConstant.xml msgid "A [Color] constant to be used within the visual shader graph." -msgstr "" +msgstr "Une [Color] constante à utiliser dans le shader visuel du graphe." #: doc/classes/VisualShaderNodeColorConstant.xml msgid "" @@ -73815,7 +75534,7 @@ msgstr "" #: doc/classes/VisualShaderNodeColorFunc.xml msgid "A [Color] function to be used within the visual shader graph." -msgstr "" +msgstr "Une fonction [Color] à utiliser dans le shader visuel du graphe." #: doc/classes/VisualShaderNodeColorFunc.xml msgid "" @@ -73854,7 +75573,7 @@ msgstr "" #: doc/classes/VisualShaderNodeColorOp.xml msgid "A [Color] operator to be used within the visual shader graph." -msgstr "" +msgstr "Un opérateur de [Color] à utiliser dans le shader visuel du graphe." #: doc/classes/VisualShaderNodeColorOp.xml msgid "Applies [member operator] to two color inputs." @@ -73864,6 +75583,8 @@ msgstr "Appliquer [member operator] aux deux entrées." msgid "" "An operator to be applied to the inputs. See [enum Operator] for options." msgstr "" +"Un opérateur soit être appliqué aux entrées. Voir [enum Operator] pour les " +"options." #: doc/classes/VisualShaderNodeColorOp.xml msgid "" @@ -73963,7 +75684,7 @@ msgstr "" #: doc/classes/VisualShaderNodeColorUniform.xml msgid "A [Color] uniform to be used within the visual shader graph." -msgstr "" +msgstr "Une [Color] constante à utiliser dans le shader visuel du graphe." #: doc/classes/VisualShaderNodeColorUniform.xml msgid "Translated to [code]uniform vec4[/code] in the shader language." @@ -73972,6 +75693,8 @@ msgstr "Sera traduit en [code]uniform vec4[/code] dans le code du shader." #: doc/classes/VisualShaderNodeCompare.xml msgid "A comparison function for common types within the visual shader graph." msgstr "" +"Une fonction de comparaison pour les types courants dans le shader visuel du " +"graphe." #: doc/classes/VisualShaderNodeCompare.xml msgid "" @@ -73994,6 +75717,8 @@ msgstr "Un fonction de comparaison. Voir [enum Function] pour les options." msgid "" "The type to be used in the comparison. See [enum ComparisonType] for options." msgstr "" +"Le type à utiliser pour la comparaison. Voir [enum ComparisonType] pour les " +"options." #: doc/classes/VisualShaderNodeCompare.xml msgid "A floating-point scalar." @@ -74095,6 +75820,8 @@ msgid "" "Defines the type of data provided by the source texture. See [enum " "TextureType] for options." msgstr "" +"Définit le type de donnée fournie par la texture source. Voir [enum " +"TextureType] pour les options." #: doc/classes/VisualShaderNodeCubeMap.xml msgid "" @@ -74356,7 +76083,7 @@ msgstr "" #: doc/classes/VisualShaderNodeFresnel.xml msgid "A Fresnel effect to be used within the visual shader graph." -msgstr "" +msgstr "Un effet de Fresnel à utiliser dans le shader visuel du graphe." #: doc/classes/VisualShaderNodeFresnel.xml msgid "" @@ -74398,12 +76125,16 @@ msgid "" "Adds an input port with the specified [code]type[/code] (see [enum " "VisualShaderNode.PortType]) and [code]name[/code]." msgstr "" +"Ajouter un port d'entrée du [code]type[/code] (voir [enum VisualShaderNode." +"PortType]) et nommé [code]name[/code]." #: doc/classes/VisualShaderNodeGroupBase.xml msgid "" "Adds an output port with the specified [code]type[/code] (see [enum " "VisualShaderNode.PortType]) and [code]name[/code]." msgstr "" +"Ajouter un port de sortie du [code]type[/code] (voir [enum VisualShaderNode." +"PortType]) et nommé [code]name[/code]." #: doc/classes/VisualShaderNodeGroupBase.xml msgid "Removes all previously specified input ports." @@ -74485,12 +76216,17 @@ msgstr "Renomme le port d’entrée spécifié." msgid "" "Sets the specified input port's type (see [enum VisualShaderNode.PortType])." msgstr "" +"Définit le type du port d'entrée spécifié (voir [enum VisualShaderNode." +"PortType])." #: doc/classes/VisualShaderNodeGroupBase.xml msgid "" "Defines all input ports using a [String] formatted as a colon-separated " "list: [code]id,type,name;[/code] (see [method add_input_port])." msgstr "" +"Définit tous les ports entrants avec une [String] composée de valeurs " +"séparées par un point-virgule : [code]identifiant,type,nom;[/code] (voir " +"[method add_input_port])." #: doc/classes/VisualShaderNodeGroupBase.xml msgid "Renames the specified output port." @@ -74500,12 +76236,17 @@ msgstr "Renomme le port de sortie spécifié." msgid "" "Sets the specified output port's type (see [enum VisualShaderNode.PortType])." msgstr "" +"Définit le type du port de sortie spécifié (voir [enum VisualShaderNode." +"PortType])." #: doc/classes/VisualShaderNodeGroupBase.xml msgid "" "Defines all output ports using a [String] formatted as a colon-separated " "list: [code]id,type,name;[/code] (see [method add_output_port])." msgstr "" +"Définit tous les ports sortants avec une [String] composée de valeurs " +"séparées par un point-virgule : [code]identifiant,type,nom;[/code] (voir " +"[method add_input_port])." #: doc/classes/VisualShaderNodeGroupBase.xml msgid "The size of the node in the visual shader graph." @@ -74534,6 +76275,8 @@ msgid "" "Returns the boolean result of the comparison between [code]INF[/code] or " "[code]NaN[/code] and a scalar parameter." msgstr "" +"Retourne le résultat booléen de la comparaison entre [code]INF[/code] " +"(l'infini) [code]NaN[/code] (n'est pas un nombre) et un paramètre scalaire." #: doc/classes/VisualShaderNodeIs.xml msgid "The comparison function. See [enum Function] for options." @@ -74594,6 +76337,8 @@ msgid "" "This node is only available in [code]Fragment[/code] and [code]Light[/code] " "visual shaders." msgstr "" +"Ce nœud n'est disponible que dans les shaders visuels [code]Fragment[/code] " +"et [code]Light[/code]." #: doc/classes/VisualShaderNodeScalarDerivativeFunc.xml msgid "The derivative type. See [enum Function] for options." @@ -74733,7 +76478,7 @@ msgstr "" #: doc/classes/VisualShaderNodeTexture.xml msgid "Use the current viewport's texture as the source." -msgstr "" +msgstr "Utilise la texture de la fenêtre d'affichage actuelle comme source." #: doc/classes/VisualShaderNodeTexture.xml msgid "" @@ -74747,11 +76492,11 @@ msgstr "" #: doc/classes/VisualShaderNodeTexture.xml msgid "Use the depth texture available for this shader." -msgstr "" +msgstr "Utilise la texture de profondeur disponible pour ce shader." #: doc/classes/VisualShaderNodeTexture.xml msgid "Use the texture provided in the input port for this function." -msgstr "" +msgstr "Utilise la texture spécifiée en entrée pour cette fonction." #: doc/classes/VisualShaderNodeTextureUniform.xml msgid "Performs a uniform texture lookup within the visual shader graph." @@ -74900,12 +76645,16 @@ msgid "" "Performs a component-wise multiplication of transform [code]a[/code] by the " "transform [code]b[/code]." msgstr "" +"Multiplie chaque composant de la transformation [code]a[/code] par la " +"transformation [code]b[/code]." #: doc/classes/VisualShaderNodeTransformMult.xml msgid "" "Performs a component-wise multiplication of transform [code]b[/code] by the " "transform [code]a[/code]." msgstr "" +"Multiplie chaque composant de la transformation [code]b[/code] par la " +"transformation [code]a[/code]." #: doc/classes/VisualShaderNodeTransformUniform.xml msgid "A [Transform] uniform for use within the visual shader graph." @@ -74949,12 +76698,16 @@ msgid "" "Multiplies transform [code]a[/code] by the vector [code]b[/code], skipping " "the last row and column of the transform." msgstr "" +"Multiplie la transformation [code]a[/code] par le vecteur [code]b[/code], " +"ignorant la dernière ligne et colonne de la transformation." #: doc/classes/VisualShaderNodeTransformVecMult.xml msgid "" "Multiplies vector [code]b[/code] by the transform [code]a[/code], skipping " "the last row and column of the transform." msgstr "" +"Multiplie le vecteur [code]b[/code] par la transformation [code]a[/code], " +"ignorant la dernière ligne et colonne de la transformation." #: doc/classes/VisualShaderNodeUniform.xml #, fuzzy @@ -74990,7 +76743,7 @@ msgstr "" #: doc/classes/VisualShaderNodeVec3Constant.xml msgid "A [Vector3] constant to be used within the visual shader graph." -msgstr "" +msgstr "Un [Vector3] constant à utiliser dans le graphe de shader visuel." #: doc/classes/VisualShaderNodeVec3Constant.xml msgid "A constant [Vector3], which can be used as an input node." @@ -75002,7 +76755,7 @@ msgstr "" #: doc/classes/VisualShaderNodeVec3Uniform.xml msgid "A [Vector3] uniform to be used within the visual shader graph." -msgstr "" +msgstr "Un [Vector3] uniforme à utiliser dans le graphe de shader visuel." #: doc/classes/VisualShaderNodeVec3Uniform.xml msgid "Translated to [code]uniform vec3[/code] in the shader language." @@ -75033,12 +76786,15 @@ msgstr "" msgid "" "Decomposes a [Vector3] into three scalars within the visual shader graph." msgstr "" +"Décompose un [Vector3] en trois scalaires dans le graphe de shader visuel." #: doc/classes/VisualShaderNodeVectorDecompose.xml msgid "" "Takes a [code]vec3[/code] and decomposes it into three scalar values that " "can be used as separate inputs." msgstr "" +"Prend un [code]vec3[/code] et le décompose en trois scalaires qui peuvent " +"être utilisés comme des entrées différentes." #: doc/classes/VisualShaderNodeVectorDerivativeFunc.xml msgid "Calculates a vector derivative within the visual shader graph." @@ -75081,6 +76837,8 @@ msgid "" "Normalizes the vector so that it has a length of [code]1[/code] but points " "in the same direction." msgstr "" +"Normalise le vecteur pour qu'il ait une longueur de [code]1[/code] mais " +"qu'il pointe dans la même direction." #: doc/classes/VisualShaderNodeVectorFunc.xml msgid "Clamps the value between [code]0.0[/code] and [code]1.0[/code]." @@ -75242,7 +77000,7 @@ msgstr "" #: doc/classes/VisualShaderNodeVectorLen.xml msgid "Returns the length of a [Vector3] within the visual shader graph." -msgstr "" +msgstr "Retourne la longueur d'un [Vector3] dans le graphe de shader visuel." #: doc/classes/VisualShaderNodeVectorLen.xml msgid "Translated to [code]length(p0)[/code] in the shader language." @@ -75257,6 +77015,8 @@ msgid "" "A visual shader node for use of vector operators. Operates on vector " "[code]a[/code] and vector [code]b[/code]." msgstr "" +"Un nœud de shader visuel pour les opérations vectorielles. Opère sur les " +"vecteurs [code]a[/code] et [code]b[/code]." #: doc/classes/VisualShaderNodeVectorOp.xml msgid "The operator to be used. See [enum Operator] for options." @@ -75336,6 +77096,8 @@ msgid "" "Linearly interpolates between two vectors using a scalar. For use within the " "visual shader graph." msgstr "" +"Fait l'interpolation linéaire entre deux vecteurs avec un scalaire. À " +"utiliser dans le graphe de shader visuel." #: doc/classes/VisualShaderNodeVectorScalarMix.xml msgid "" @@ -75418,6 +77180,8 @@ msgid "" "Vertical version of [Separator]. Even though it looks vertical, it is used " "to separate objects horizontally." msgstr "" +"La version verticale de [Separator]. Même s'il ressemble à un séparateur " +"vertical, il peut être utilisé comme séparateur horizontal." #: doc/classes/VSeparator.xml msgid "" @@ -75473,6 +77237,8 @@ msgid "" "Holds an [Object], but does not contribute to the reference count if the " "object is a reference." msgstr "" +"Maintient un [Object], mais ne contribue pas à son compteur de référence si " +"l'objet est une référence." #: doc/classes/WeakRef.xml msgid "" @@ -75826,6 +77592,8 @@ msgid "" "Call this method frequently (e.g. in [method Node._process] or [method Node." "_physics_process]) to properly receive signals." msgstr "" +"Appelez cette méthode fréquemment (par ex. dans [method Node._process] ou " +"[method Node._physics_process]) pour recevoir correctement les signaux." #: modules/webrtc/doc_classes/WebRTCPeerConnection.xml msgid "" @@ -75955,7 +77723,7 @@ msgstr "" #: modules/websocket/doc_classes/WebSocketClient.xml msgid "Return the IP address of the currently connected host." -msgstr "" +msgstr "Retourne l'adresse IP de l'hôte actuellement connecté." #: modules/websocket/doc_classes/WebSocketClient.xml msgid "Return the IP port of the currently connected host." @@ -76089,12 +77857,16 @@ msgid "" "Returns the IP address of the connected peer.\n" "[b]Note:[/b] Not available in the HTML5 export." msgstr "" +"Retourne l'adresse IP du pair connecté.\n" +"[b]Note :[/b] Non disponible en HTML5." #: modules/websocket/doc_classes/WebSocketPeer.xml msgid "" "Returns the remote port of the connected peer.\n" "[b]Note:[/b] Not available in the HTML5 export." msgstr "" +"Retourne le port distant du pair connecté.\n" +"[b]Note :[/b] Non disponible en HTML5." #: modules/websocket/doc_classes/WebSocketPeer.xml msgid "" @@ -76127,18 +77899,24 @@ msgid "" "Returns [code]true[/code] if the last received packet was sent as a text " "payload. See [enum WriteMode]." msgstr "" +"Retourne [code]true[/code] si le dernier paquet reçu a été envoyé sous forme " +"textuelle. Voir [enum WriteMode]." #: modules/websocket/doc_classes/WebSocketPeer.xml msgid "" "Specifies that WebSockets messages should be transferred as text payload " "(only valid UTF-8 is allowed)." msgstr "" +"Spécifie que les messages WebSockets doivent être transférés sous forme de " +"texte (uniquement l'UTF-8 est autorisé)." #: modules/websocket/doc_classes/WebSocketPeer.xml msgid "" "Specifies that WebSockets messages should be transferred as binary payload " "(any byte combination is allowed)." msgstr "" +"Spécifie que les messages WebSockets doivent être transférés sous forme " +"binaire (toute les combinaison d'octets sont autorisés)." #: modules/websocket/doc_classes/WebSocketServer.xml msgid "A WebSocket server implementation." @@ -76160,15 +77938,19 @@ msgid "" "Disconnects the peer identified by [code]id[/code] from the server. See " "[method WebSocketPeer.close] for more information." msgstr "" +"Déconnecte le pair identifié par [code]id[/code] du serveur. Voir [method " +"WebSocketPeer.close] pour plus d'informations." #: modules/websocket/doc_classes/WebSocketServer.xml msgid "Returns [code]true[/code] if a peer with the given ID is connected." msgstr "" +"Retourne [code]true[/code] si un pair avec l'identifiant spécifié est " +"connecté." #: modules/websocket/doc_classes/WebSocketServer.xml msgid "" "Returns [code]true[/code] if the server is actively listening on a port." -msgstr "" +msgstr "Retourne [code]true[/code] si le serveur écoute activement un port." #: modules/websocket/doc_classes/WebSocketServer.xml msgid "" @@ -76242,12 +78024,16 @@ msgid "" "Emitted when a new client connects. \"protocol\" will be the sub-protocol " "agreed with the client." msgstr "" +"Émis quand un nouveau client se connecte. Le \"protocol\" sera le sous-" +"protocole définit avec le client." #: modules/websocket/doc_classes/WebSocketServer.xml msgid "" "Emitted when a client disconnects. [code]was_clean_close[/code] will be " "[code]true[/code] if the connection was shutdown cleanly." msgstr "" +"Émis quand un client se déconnecte. [code]was_clean_close[/code] sera à " +"[code]true[/code] si la connexion s'est terminée proprement." #: modules/websocket/doc_classes/WebSocketServer.xml msgid "" @@ -76781,6 +78567,8 @@ msgid "" "The [Environment] resource used by this [WorldEnvironment], defining the " "default properties." msgstr "" +"La ressource du [Environment] utilisé par ce [WorldEnvironment], définissant " +"les propriétés par défaut." #: doc/classes/X509Certificate.xml msgid "An X509 certificate (e.g. for SSL)." @@ -76830,13 +78618,14 @@ msgstr "" msgid "" "Gets the name of the attribute specified by the index in [code]idx[/code] " "argument." -msgstr "" +msgstr "Retourne le nom de l'attribut spécifié par l'index [code]idx[/code]." #: doc/classes/XMLParser.xml msgid "" "Gets the value of the attribute specified by the index in [code]idx[/code] " "argument." msgstr "" +"Retourne la valeur de l'attribut spécifié par l'index [code]idx[/code]." #: doc/classes/XMLParser.xml msgid "Gets the current line in the parsed file (currently not implemented)." @@ -76880,13 +78669,15 @@ msgstr "" #: doc/classes/XMLParser.xml msgid "Check whether the current element has a certain attribute." -msgstr "" +msgstr "Vérifie quand l'élément actuel à un certain attribut." #: doc/classes/XMLParser.xml msgid "" "Check whether the current element is empty (this only works for completely " "empty tags, e.g. [code]<element \\>[/code])." msgstr "" +"Vérifie si l'élément actuel est vide (ça ne fonctionne que pour les " +"marqueurs complètement vide, par ex. [code]<element \\>[/code])." #: doc/classes/XMLParser.xml msgid "Opens an XML file for parsing. This returns an error code." diff --git a/doc/translations/gl.po b/doc/translations/gl.po index 8320f0535e..ae1ecf4fb4 100644 --- a/doc/translations/gl.po +++ b/doc/translations/gl.po @@ -636,7 +636,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -6998,6 +7004,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8140,6 +8158,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10837,7 +10865,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -10907,8 +10935,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11498,6 +11526,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12252,7 +12303,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12264,21 +12324,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12294,7 +12374,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12306,7 +12391,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12320,7 +12410,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12329,7 +12425,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12339,7 +12441,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12357,10 +12465,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15877,7 +15991,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19501,9 +19618,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22695,7 +22814,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23387,33 +23506,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28150,34 +28279,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29468,8 +29605,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30239,7 +30378,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30381,6 +30525,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32421,7 +32578,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32465,8 +32623,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34304,6 +34471,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35611,9 +35813,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35788,6 +36001,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36568,7 +36789,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36609,6 +36830,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37283,7 +37513,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37306,6 +37536,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37391,11 +37630,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -37978,7 +38224,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38009,7 +38255,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39087,6 +39333,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39568,6 +39824,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39650,6 +39915,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -43843,7 +44116,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -43918,12 +44199,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -43969,6 +44250,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44036,13 +44327,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44073,13 +44364,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44109,13 +44400,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44141,12 +44432,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44176,12 +44467,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44210,12 +44501,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45861,6 +46152,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48159,8 +48460,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -49952,14 +50440,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50003,8 +50492,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51604,6 +52094,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51628,6 +52122,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -51982,6 +52482,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56505,7 +57403,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56589,28 +57487,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56629,6 +57546,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -59873,7 +60805,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60003,14 +60937,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60405,20 +61343,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60524,13 +61463,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60760,7 +61700,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61592,7 +62532,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -61869,6 +62811,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62661,7 +63619,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -62821,8 +63779,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -62920,7 +63878,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63002,8 +63960,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63595,7 +64553,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68040,6 +69000,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69089,23 +70075,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/hi.po b/doc/translations/hi.po index f8003a91b0..7d82f6cba4 100644 --- a/doc/translations/hi.po +++ b/doc/translations/hi.po @@ -635,7 +635,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -6997,6 +7003,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8139,6 +8157,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10836,7 +10864,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -10906,8 +10934,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11497,6 +11525,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12251,7 +12302,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12263,21 +12323,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12293,7 +12373,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12305,7 +12390,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12319,7 +12409,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12328,7 +12424,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12338,7 +12440,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12356,10 +12464,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15876,7 +15990,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19500,9 +19617,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22694,7 +22813,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23386,33 +23505,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28149,34 +28278,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29467,8 +29604,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30238,7 +30377,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30380,6 +30524,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32420,7 +32577,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32464,8 +32622,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34303,6 +34470,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35610,9 +35812,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35787,6 +36000,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36567,7 +36788,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36608,6 +36829,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37282,7 +37512,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37305,6 +37535,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37390,11 +37629,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -37977,7 +38223,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38008,7 +38254,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39086,6 +39332,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39567,6 +39823,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39649,6 +39914,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -43842,7 +44115,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -43917,12 +44198,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -43968,6 +44249,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44035,13 +44326,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44072,13 +44363,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44108,13 +44399,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44140,12 +44431,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44175,12 +44466,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44209,12 +44500,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45860,6 +46151,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48158,8 +48459,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -49951,14 +50439,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50002,8 +50491,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51603,6 +52093,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51627,6 +52121,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -51981,6 +52481,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56504,7 +57402,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56588,28 +57486,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56628,6 +57545,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -59872,7 +60804,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60002,14 +60936,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60404,20 +61342,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60523,13 +61462,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60759,7 +61699,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61591,7 +62531,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -61868,6 +62810,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62660,7 +63618,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -62820,8 +63778,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -62919,7 +63877,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63001,8 +63959,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63594,7 +64552,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68039,6 +68999,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69088,23 +70074,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/hu.po b/doc/translations/hu.po index 1470c3727c..24b9a5c93d 100644 --- a/doc/translations/hu.po +++ b/doc/translations/hu.po @@ -653,7 +653,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -7015,6 +7021,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8157,6 +8175,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10854,7 +10882,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -10924,8 +10952,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11515,6 +11543,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12269,7 +12320,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12281,21 +12341,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12311,7 +12391,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12323,7 +12408,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12337,7 +12427,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12346,7 +12442,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12356,7 +12458,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12374,10 +12482,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15894,7 +16008,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19518,9 +19635,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22712,7 +22831,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23404,33 +23523,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28167,34 +28296,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29485,8 +29622,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30256,7 +30395,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30398,6 +30542,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32438,7 +32595,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32482,8 +32640,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34321,6 +34488,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35628,9 +35830,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35805,6 +36018,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36585,7 +36806,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36626,6 +36847,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37300,7 +37530,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37323,6 +37553,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37408,11 +37647,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -37995,7 +38241,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38026,7 +38272,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39104,6 +39350,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39585,6 +39841,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39667,6 +39932,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -43860,7 +44133,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -43935,12 +44216,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -43986,6 +44267,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44053,13 +44344,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44090,13 +44381,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44126,13 +44417,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44158,12 +44449,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44193,12 +44484,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44227,12 +44518,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45878,6 +46169,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48176,8 +48477,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -49969,14 +50457,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50020,8 +50509,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51621,6 +52111,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51645,6 +52139,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -51999,6 +52499,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56522,7 +57420,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56606,28 +57504,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56646,6 +57563,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -59890,7 +60822,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60020,14 +60954,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60422,20 +61360,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60541,13 +61480,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60777,7 +61717,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61609,7 +62549,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -61886,6 +62828,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62678,7 +63636,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -62838,8 +63796,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -62937,7 +63895,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63019,8 +63977,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63612,7 +64570,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68057,6 +69017,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69106,23 +70092,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/id.po b/doc/translations/id.po index f01667bef1..8c9d0937bf 100644 --- a/doc/translations/id.po +++ b/doc/translations/id.po @@ -909,7 +909,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -7409,6 +7415,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8551,6 +8569,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -11248,7 +11276,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -11318,8 +11346,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11909,6 +11937,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12664,7 +12715,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12676,21 +12736,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12706,7 +12786,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12718,7 +12803,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12732,7 +12822,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12741,7 +12837,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12751,7 +12853,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12769,10 +12877,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -16289,7 +16403,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19913,9 +20030,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -23108,7 +23227,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23803,33 +23922,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28569,34 +28698,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29887,8 +30024,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30658,7 +30797,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30800,6 +30944,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32840,7 +32997,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32884,8 +33042,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34723,6 +34890,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -36042,9 +36244,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -36219,6 +36432,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -37001,7 +37222,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37042,6 +37263,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37716,7 +37946,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37739,6 +37969,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37824,11 +38063,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -38411,7 +38657,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38442,7 +38688,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39522,6 +39768,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -40004,6 +40260,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -40086,6 +40351,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -44294,7 +44567,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -44369,12 +44650,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44420,6 +44701,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44487,13 +44778,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44524,13 +44815,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44560,13 +44851,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44592,12 +44883,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44627,12 +44918,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44661,12 +44952,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46313,6 +46604,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48611,8 +48912,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -50404,14 +50892,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50456,8 +50945,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -52057,6 +52547,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -52081,6 +52575,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -52435,6 +52935,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56960,7 +57858,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -57044,28 +57942,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -57084,6 +58001,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -60332,7 +61264,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60462,14 +61396,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60864,20 +61802,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60983,13 +61922,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -61219,7 +62159,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -62052,7 +62992,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -62329,6 +63271,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -63121,7 +64079,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -63281,8 +64239,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -63380,7 +64338,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63462,8 +64420,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -64055,7 +65013,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68505,6 +69465,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69554,23 +70540,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/is.po b/doc/translations/is.po index e6a56827fe..90fb6e951b 100644 --- a/doc/translations/is.po +++ b/doc/translations/is.po @@ -635,7 +635,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -6997,6 +7003,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8139,6 +8157,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10836,7 +10864,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -10906,8 +10934,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11497,6 +11525,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12251,7 +12302,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12263,21 +12323,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12293,7 +12373,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12305,7 +12390,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12319,7 +12409,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12328,7 +12424,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12338,7 +12440,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12356,10 +12464,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15876,7 +15990,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19500,9 +19617,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22694,7 +22813,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23386,33 +23505,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28149,34 +28278,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29467,8 +29604,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30238,7 +30377,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30380,6 +30524,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32420,7 +32577,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32464,8 +32622,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34303,6 +34470,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35610,9 +35812,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35787,6 +36000,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36567,7 +36788,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36608,6 +36829,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37282,7 +37512,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37305,6 +37535,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37390,11 +37629,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -37977,7 +38223,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38008,7 +38254,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39086,6 +39332,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39567,6 +39823,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39649,6 +39914,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -43842,7 +44115,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -43917,12 +44198,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -43968,6 +44249,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44035,13 +44326,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44072,13 +44363,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44108,13 +44399,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44140,12 +44431,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44175,12 +44466,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44209,12 +44500,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45860,6 +46151,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48158,8 +48459,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -49951,14 +50439,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50002,8 +50491,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51603,6 +52093,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51627,6 +52121,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -51981,6 +52481,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56504,7 +57402,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56588,28 +57486,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56628,6 +57545,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -59872,7 +60804,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60002,14 +60936,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60404,20 +61342,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60523,13 +61462,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60759,7 +61699,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61591,7 +62531,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -61868,6 +62810,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62660,7 +63618,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -62820,8 +63778,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -62919,7 +63877,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63001,8 +63959,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63594,7 +64552,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68039,6 +68999,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69088,23 +70074,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/it.po b/doc/translations/it.po index 94d2f52b5e..f5f588a6ae 100644 --- a/doc/translations/it.po +++ b/doc/translations/it.po @@ -998,7 +998,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" "Interpola linearmente tra due angoli (in radianti) con un valore " "normalizzato.\n" @@ -8010,6 +8016,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -9155,6 +9173,17 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +#, fuzzy +msgid "GUI containers" +msgstr "Contenitore a schede." + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -11861,7 +11890,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -11931,8 +11960,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -12523,6 +12552,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -13286,7 +13338,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13298,21 +13359,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13328,7 +13409,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13340,7 +13426,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13354,7 +13445,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -13363,7 +13460,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -13373,7 +13476,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -13391,10 +13500,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -17000,9 +17115,11 @@ msgstr "" "esiste, [code]false[/code] altrimenti." #: doc/classes/Control.xml -#, fuzzy -msgid "Returns [code]true[/code] if drag operation is successful." -msgstr "Ritorna [code]true[/code] se [Rect2i] è piano o vuoto." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." +msgstr "" #: doc/classes/Control.xml msgid "" @@ -20636,9 +20753,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -23839,7 +23958,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -24534,33 +24653,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -29325,34 +29454,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -30647,8 +30784,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -31420,7 +31559,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -31565,6 +31709,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -33608,7 +33765,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -33652,8 +33810,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -35497,6 +35664,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -36834,9 +37036,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -37012,6 +37225,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -37797,7 +38018,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37838,6 +38059,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -38512,7 +38742,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -38535,6 +38765,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -38620,11 +38859,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -39211,7 +39457,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -39242,7 +39488,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -40329,6 +40575,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -40815,6 +41071,15 @@ msgid "" msgstr "Ritorna [code]true[/code] se [code]s[/code] è zero o quasi zero." #: doc/classes/OS.xml +msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml #, fuzzy msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " @@ -40901,6 +41166,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -45124,7 +45397,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -45199,12 +45480,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45250,6 +45531,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -45317,13 +45608,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45354,13 +45645,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -45390,13 +45681,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -45422,12 +45713,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45458,12 +45749,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45492,12 +45783,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -47146,6 +47437,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -49444,8 +49745,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -51245,14 +51733,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51297,8 +51786,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -52898,6 +53388,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -52922,6 +53416,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -53278,6 +53778,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -57813,7 +58711,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -57897,28 +58795,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -57937,6 +58854,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -61224,7 +62156,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -61357,14 +62291,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -61760,20 +62698,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -61879,13 +62818,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -62116,7 +63056,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -62954,7 +63894,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -63231,6 +64173,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -64039,7 +64997,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -64205,8 +65163,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -64304,7 +65262,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -64388,8 +65346,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -64986,7 +65944,9 @@ msgstr "Ritorna [code]true[/code] se [Rect2i] è piano o vuoto." #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -69468,6 +70428,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -70526,23 +71512,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/ja.po b/doc/translations/ja.po index f48940359e..463133444e 100644 --- a/doc/translations/ja.po +++ b/doc/translations/ja.po @@ -953,6 +953,7 @@ msgstr "" "す。" #: modules/gdscript/doc_classes/@GDScript.xml +#, fuzzy msgid "" "Linearly interpolates between two angles (in radians) by a normalized " "value.\n" @@ -967,7 +968,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" "正規化された値によって２つの角度 (ラジアン) 間を線形補間します。\n" "[method lerp] と似ていますが、 [constant @GDScript.TAU] を振り切れたときでも" @@ -9090,6 +9097,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -10396,6 +10415,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -13703,9 +13732,10 @@ msgstr "" "討してください。" #: doc/classes/Basis.xml +#, fuzzy msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" "与えられた [code]axis[/code] を中心に [code]phi[/code] で回転させた純粋な回転" @@ -13801,9 +13831,10 @@ msgstr "" "す。" #: doc/classes/Basis.xml +#, fuzzy msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" "与えられた軸の周りに、ファイ (ラジアン) 単位で追加の回転を導入します。軸は正" "規化されたベクトルでなければなりません。" @@ -14470,6 +14501,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "ボタンの長押しが停止されたときに発信されます。" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml #, fuzzy msgid "Camera node, displays from a point of view." @@ -15246,7 +15300,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -15258,21 +15321,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -15288,7 +15371,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -15300,7 +15388,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -15314,7 +15407,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15323,7 +15422,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15333,7 +15438,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15351,10 +15462,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -18967,9 +19084,11 @@ msgstr "" "code]、そうでない場合は [code]false[/code] を返します。" #: doc/classes/Control.xml -#, fuzzy -msgid "Returns [code]true[/code] if drag operation is successful." -msgstr "アニメーションが再生中であれば [code]true[/code] を返します。" +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." +msgstr "" #: doc/classes/Control.xml msgid "" @@ -22654,9 +22773,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -25871,7 +25992,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -26577,33 +26698,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -31394,34 +31525,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -32723,8 +32862,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -33496,7 +33637,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -33642,6 +33788,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -35719,7 +35878,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -35763,8 +35923,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -37614,6 +37783,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -38967,9 +39171,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -39148,6 +39363,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml #, fuzzy msgid "Server interface for low-level 3D navigation access." @@ -39934,7 +40157,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -39975,6 +40198,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -40652,7 +40884,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -40675,6 +40907,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -40760,11 +41001,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -41348,7 +41596,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -41379,7 +41627,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -42470,6 +42718,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -42963,6 +43221,15 @@ msgstr "" "[code]false[/code] を返します。" #: doc/classes/OS.xml +msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml #, fuzzy msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " @@ -43051,6 +43318,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -47282,7 +47557,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -47357,12 +47640,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -47409,6 +47692,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -47476,13 +47769,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -47514,13 +47807,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -47555,13 +47848,13 @@ msgid "Changes the int at the given index." msgstr "サブノードの名前を変更します。" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -47588,12 +47881,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -47625,12 +47918,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -47660,12 +47953,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -49339,6 +49632,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -51639,8 +51942,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -53460,14 +53950,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -53512,8 +54003,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -55117,6 +55609,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -55141,6 +55637,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -55499,6 +56001,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -60335,7 +61235,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -60419,28 +61319,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -60459,6 +61378,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -63781,7 +64715,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -63914,14 +64850,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -64317,21 +65257,26 @@ msgid "" msgstr "" #: doc/classes/Transform.xml +#, fuzzy msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" +"与えられた [code]axis[/code] を中心に [code]phi[/code] で回転させた純粋な回転" +"基底行列をラジアンで構築します。軸は、正規化されたベクトルでなければなりませ" +"ん。" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -64437,13 +65382,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -64675,7 +65621,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -65526,7 +66472,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -65803,6 +66751,23 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +#, fuzzy +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "ボタンの長押しが停止されたときに発信されます。" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -66600,7 +67565,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -66768,8 +67733,8 @@ msgstr "このベクトルを別のベクトル [code]b[/code] に投影した #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -66867,7 +67832,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -66950,10 +67915,14 @@ msgid "Returns this vector reflected from a plane defined by the given normal." msgstr "" #: doc/classes/Vector3.xml +#, fuzzy msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" +"与えられた [code]axis[/code] を中心に [code]phi[/code] で回転させた純粋な回転" +"基底行列をラジアンで構築します。軸は、正規化されたベクトルでなければなりませ" +"ん。" #: doc/classes/Vector3.xml msgid "" @@ -67550,7 +68519,9 @@ msgstr "配列が空の場合は[code]true[/code]を返します。" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -72096,6 +73067,32 @@ msgstr "テクスチャの描写オフセット。" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -73155,23 +74152,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/ko.po b/doc/translations/ko.po index f3091e3a36..c6e5552649 100644 --- a/doc/translations/ko.po +++ b/doc/translations/ko.po @@ -740,7 +740,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -7127,6 +7133,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8269,6 +8287,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10968,7 +10996,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -11038,8 +11066,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11629,6 +11657,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12388,7 +12439,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12400,21 +12460,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12430,7 +12510,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12442,7 +12527,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12456,7 +12546,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12465,7 +12561,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12475,7 +12577,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12493,10 +12601,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -16042,9 +16156,11 @@ msgid "" msgstr "" #: doc/classes/Control.xml -#, fuzzy -msgid "Returns [code]true[/code] if drag operation is successful." -msgstr "매개변수의 코사인 값을 반환합니다." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." +msgstr "" #: doc/classes/Control.xml msgid "" @@ -19677,9 +19793,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22933,7 +23051,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23628,33 +23746,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28402,34 +28530,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29722,8 +29858,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30494,7 +30632,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30636,6 +30779,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32678,7 +32834,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32722,8 +32879,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34563,6 +34729,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35891,9 +36092,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -36068,6 +36280,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36977,7 +37197,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37018,6 +37238,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37692,7 +37921,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37715,6 +37944,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37800,11 +38038,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -38388,7 +38633,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38419,7 +38664,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39502,6 +39747,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39986,6 +40241,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -40068,6 +40332,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -44279,7 +44551,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -44354,12 +44634,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44405,6 +44685,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44472,13 +44762,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44509,13 +44799,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44545,13 +44835,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44577,12 +44867,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44612,12 +44902,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44646,12 +44936,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46299,6 +46589,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48597,8 +48897,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -50391,14 +50878,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50443,8 +50931,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -52044,6 +52533,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -52068,6 +52561,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -52422,6 +52921,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56947,7 +57844,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -57031,28 +57928,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -57071,6 +57987,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -60324,7 +61255,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60454,14 +61387,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60856,20 +61793,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60975,13 +61913,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -61212,7 +62151,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -62049,7 +62988,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -62326,6 +63267,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -63118,7 +64075,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -63279,8 +64236,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -63378,7 +64335,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63461,8 +64418,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -64070,7 +65027,9 @@ msgstr "매개변수의 코사인 값을 반환합니다." #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68532,6 +69491,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69581,23 +70566,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/lv.po b/doc/translations/lv.po index 8071e5caef..d77a24b111 100644 --- a/doc/translations/lv.po +++ b/doc/translations/lv.po @@ -650,7 +650,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -7012,6 +7018,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8154,6 +8172,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10851,7 +10879,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -10921,8 +10949,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11512,6 +11540,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12266,7 +12317,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12278,21 +12338,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12308,7 +12388,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12320,7 +12405,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12334,7 +12424,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12343,7 +12439,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12353,7 +12455,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12371,10 +12479,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15891,7 +16005,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19515,9 +19632,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22709,7 +22828,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23404,33 +23523,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28167,34 +28296,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29485,8 +29622,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30256,7 +30395,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30398,6 +30542,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32438,7 +32595,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32482,8 +32640,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34321,6 +34488,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35628,9 +35830,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35805,6 +36018,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36585,7 +36806,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36626,6 +36847,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37300,7 +37530,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37323,6 +37553,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37408,11 +37647,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -37995,7 +38241,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38026,7 +38272,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39104,6 +39350,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39585,6 +39841,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39667,6 +39932,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -43860,7 +44133,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -43935,12 +44216,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -43986,6 +44267,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44053,13 +44344,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44090,13 +44381,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44126,13 +44417,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44158,12 +44449,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44193,12 +44484,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44227,12 +44518,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45878,6 +46169,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48176,8 +48477,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -49969,14 +50457,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50020,8 +50509,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51621,6 +52111,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51645,6 +52139,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -51999,6 +52499,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56522,7 +57420,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56606,28 +57504,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56646,6 +57563,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -59890,7 +60822,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60020,14 +60954,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60422,20 +61360,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60541,13 +61480,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60777,7 +61717,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61609,7 +62549,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -61886,6 +62828,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62678,7 +63636,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -62838,8 +63796,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -62937,7 +63895,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63019,8 +63977,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63612,7 +64570,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68057,6 +69017,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69106,23 +70092,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/mr.po b/doc/translations/mr.po index e6c0630d9f..2e152e7774 100644 --- a/doc/translations/mr.po +++ b/doc/translations/mr.po @@ -633,7 +633,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -6995,6 +7001,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8137,6 +8155,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10834,7 +10862,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -10904,8 +10932,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11495,6 +11523,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12249,7 +12300,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12261,21 +12321,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12291,7 +12371,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12303,7 +12388,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12317,7 +12407,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12326,7 +12422,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12336,7 +12438,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12354,10 +12462,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15874,7 +15988,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19498,9 +19615,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22692,7 +22811,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23384,33 +23503,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28147,34 +28276,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29465,8 +29602,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30236,7 +30375,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30378,6 +30522,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32418,7 +32575,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32462,8 +32620,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34301,6 +34468,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35608,9 +35810,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35785,6 +35998,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36565,7 +36786,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36606,6 +36827,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37280,7 +37510,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37303,6 +37533,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37388,11 +37627,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -37975,7 +38221,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38006,7 +38252,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39084,6 +39330,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39565,6 +39821,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39647,6 +39912,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -43840,7 +44113,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -43915,12 +44196,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -43966,6 +44247,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44033,13 +44324,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44070,13 +44361,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44106,13 +44397,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44138,12 +44429,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44173,12 +44464,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44207,12 +44498,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45858,6 +46149,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48156,8 +48457,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -49949,14 +50437,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50000,8 +50489,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51601,6 +52091,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51625,6 +52119,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -51979,6 +52479,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56502,7 +57400,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56586,28 +57484,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56626,6 +57543,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -59870,7 +60802,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60000,14 +60934,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60402,20 +61340,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60521,13 +61460,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60757,7 +61697,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61589,7 +62529,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -61866,6 +62808,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62658,7 +63616,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -62818,8 +63776,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -62917,7 +63875,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -62999,8 +63957,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63592,7 +64550,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68037,6 +68997,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69086,23 +70072,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/nb.po b/doc/translations/nb.po index 10c78e4fcc..d52cdc0ce9 100644 --- a/doc/translations/nb.po +++ b/doc/translations/nb.po @@ -645,7 +645,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -7007,6 +7013,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8149,6 +8167,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10846,7 +10874,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -10916,8 +10944,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11507,6 +11535,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12261,7 +12312,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12273,21 +12333,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12303,7 +12383,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12315,7 +12400,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12329,7 +12419,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12338,7 +12434,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12348,7 +12450,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12366,10 +12474,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15886,7 +16000,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19510,9 +19627,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22704,7 +22823,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23396,33 +23515,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28159,34 +28288,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29477,8 +29614,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30248,7 +30387,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30390,6 +30534,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32430,7 +32587,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32474,8 +32632,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34313,6 +34480,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35620,9 +35822,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35797,6 +36010,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36577,7 +36798,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36618,6 +36839,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37292,7 +37522,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37315,6 +37545,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37400,11 +37639,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -37987,7 +38233,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38018,7 +38264,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39096,6 +39342,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39577,6 +39833,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39659,6 +39924,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -43852,7 +44125,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -43927,12 +44208,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -43978,6 +44259,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44045,13 +44336,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44082,13 +44373,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44118,13 +44409,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44150,12 +44441,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44185,12 +44476,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44219,12 +44510,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45870,6 +46161,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48168,8 +48469,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -49961,14 +50449,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50012,8 +50501,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51613,6 +52103,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51637,6 +52131,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -51991,6 +52491,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56514,7 +57412,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56598,28 +57496,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56638,6 +57555,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -59882,7 +60814,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60012,14 +60946,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60414,20 +61352,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60533,13 +61472,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60769,7 +61709,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61601,7 +62541,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -61878,6 +62820,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62670,7 +63628,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -62830,8 +63788,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -62929,7 +63887,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63011,8 +63969,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63604,7 +64562,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68049,6 +69009,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69098,23 +70084,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/ne.po b/doc/translations/ne.po index 201925ae35..a40402dd10 100644 --- a/doc/translations/ne.po +++ b/doc/translations/ne.po @@ -633,7 +633,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -6995,6 +7001,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8137,6 +8155,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10834,7 +10862,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -10904,8 +10932,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11495,6 +11523,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12249,7 +12300,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12261,21 +12321,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12291,7 +12371,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12303,7 +12388,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12317,7 +12407,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12326,7 +12422,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12336,7 +12438,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12354,10 +12462,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15874,7 +15988,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19498,9 +19615,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22692,7 +22811,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23384,33 +23503,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28147,34 +28276,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29465,8 +29602,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30236,7 +30375,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30378,6 +30522,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32418,7 +32575,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32462,8 +32620,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34301,6 +34468,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35608,9 +35810,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35785,6 +35998,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36565,7 +36786,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36606,6 +36827,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37280,7 +37510,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37303,6 +37533,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37388,11 +37627,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -37975,7 +38221,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38006,7 +38252,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39084,6 +39330,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39565,6 +39821,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39647,6 +39912,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -43840,7 +44113,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -43915,12 +44196,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -43966,6 +44247,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44033,13 +44324,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44070,13 +44361,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44106,13 +44397,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44138,12 +44429,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44173,12 +44464,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44207,12 +44498,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45858,6 +46149,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48156,8 +48457,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -49949,14 +50437,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50000,8 +50489,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51601,6 +52091,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51625,6 +52119,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -51979,6 +52479,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56502,7 +57400,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56586,28 +57484,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56626,6 +57543,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -59870,7 +60802,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60000,14 +60934,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60402,20 +61340,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60521,13 +61460,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60757,7 +61697,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61589,7 +62529,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -61866,6 +62808,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62658,7 +63616,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -62818,8 +63776,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -62917,7 +63875,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -62999,8 +63957,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63592,7 +64550,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68037,6 +68997,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69086,23 +70072,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/nl.po b/doc/translations/nl.po index d207e3fb09..943cbddb4c 100644 --- a/doc/translations/nl.po +++ b/doc/translations/nl.po @@ -694,7 +694,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -7064,6 +7070,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8206,6 +8224,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10903,7 +10931,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -10973,8 +11001,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11564,6 +11592,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12318,7 +12369,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12330,21 +12390,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12360,7 +12440,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12372,7 +12457,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12386,7 +12476,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12395,7 +12491,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12405,7 +12507,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12423,10 +12531,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15943,7 +16057,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19567,9 +19684,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22761,7 +22880,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23456,33 +23575,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28219,34 +28348,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29537,8 +29674,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30308,7 +30447,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30450,6 +30594,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32490,7 +32647,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32534,8 +32692,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34373,6 +34540,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35680,9 +35882,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35857,6 +36070,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36637,7 +36858,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36678,6 +36899,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37352,7 +37582,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37375,6 +37605,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37460,11 +37699,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -38047,7 +38293,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38078,7 +38324,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39156,6 +39402,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39637,6 +39893,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39719,6 +39984,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -43912,7 +44185,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -43987,12 +44268,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44038,6 +44319,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44105,13 +44396,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44142,13 +44433,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44178,13 +44469,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44210,12 +44501,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44245,12 +44536,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44279,12 +44570,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45930,6 +46221,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48228,8 +48529,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -50022,14 +50510,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50073,8 +50562,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51674,6 +52164,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51698,6 +52192,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -52052,6 +52552,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56575,7 +57473,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56659,28 +57557,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56699,6 +57616,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -59943,7 +60875,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60073,14 +61007,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60475,20 +61413,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60594,13 +61533,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60830,7 +61770,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61662,7 +62602,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -61939,6 +62881,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62731,7 +63689,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -62891,8 +63849,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -62990,7 +63948,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63072,8 +64030,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63665,7 +64623,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68110,6 +69070,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69159,23 +70145,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/pl.po b/doc/translations/pl.po index f061c11aff..64e182ff82 100644 --- a/doc/translations/pl.po +++ b/doc/translations/pl.po @@ -946,7 +946,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" "Liniowo interpoluje pomiędzy dwoma kątami (w radianach) poprzez " "znormalizowaną wartość.\n" @@ -7483,6 +7489,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8625,6 +8643,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -11324,7 +11352,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -11394,8 +11422,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11986,6 +12014,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12752,7 +12803,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12764,21 +12824,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12794,7 +12874,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12806,7 +12891,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12820,7 +12910,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12829,7 +12925,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12839,7 +12941,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12857,10 +12965,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -16382,11 +16496,11 @@ msgid "" msgstr "" #: doc/classes/Control.xml -#, fuzzy -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" -"Jeśli [code]true[/code], potomne węzły są sortowane. W innym przypadku jest " -"wyłączone." #: doc/classes/Control.xml msgid "" @@ -20022,9 +20136,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -23220,7 +23336,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23915,33 +24031,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28695,34 +28821,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -30016,8 +30150,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30788,7 +30924,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30933,6 +31074,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32982,7 +33136,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -33026,8 +33181,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34872,6 +35036,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -36216,9 +36415,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -36394,6 +36604,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -37178,7 +37396,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37219,6 +37437,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37893,7 +38120,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37916,6 +38143,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -38001,11 +38237,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -38588,7 +38831,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38619,7 +38862,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39705,6 +39948,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -40194,6 +40447,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -40279,6 +40541,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -44501,7 +44771,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -44576,12 +44854,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44627,6 +44905,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44694,13 +44982,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44731,13 +45019,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44767,13 +45055,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44799,12 +45087,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44834,12 +45122,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44868,12 +45156,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46521,6 +46809,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48819,8 +49117,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -50621,14 +51106,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50673,8 +51159,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -52274,6 +52761,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -52298,6 +52789,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -52655,6 +53152,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -57184,7 +58079,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -57268,28 +58163,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -57308,6 +58222,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -60572,7 +61501,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60702,14 +61633,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -61104,20 +62039,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -61223,13 +62159,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -61460,7 +62397,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -62297,7 +63234,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -62574,6 +63513,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -63366,7 +64321,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -63527,8 +64482,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -63626,7 +64581,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63710,8 +64665,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -64309,7 +65264,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68780,6 +69737,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69838,23 +70821,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/pt.po b/doc/translations/pt.po index 80deea8cce..a755e40906 100644 --- a/doc/translations/pt.po +++ b/doc/translations/pt.po @@ -7,12 +7,13 @@ # ssantos <ssantos@web.de>, 2022. # Felipe SiFa <felipe@logus.digital>, 2022. # Renu <ifpilucas@gmail.com>, 2022. +# Diogo Gomes <dgomes@graphnode.com>, 2022. msgid "" msgstr "" "Project-Id-Version: Godot Engine class reference\n" "Report-Msgid-Bugs-To: https://github.com/godotengine/godot\n" -"PO-Revision-Date: 2022-04-25 15:12+0000\n" -"Last-Translator: Renu <ifpilucas@gmail.com>\n" +"PO-Revision-Date: 2022-04-29 02:54+0000\n" +"Last-Translator: Diogo Gomes <dgomes@graphnode.com>\n" "Language-Team: Portuguese <https://hosted.weblate.org/projects/godot-engine/" "godot-class-reference/pt/>\n" "Language: pt\n" @@ -24,7 +25,7 @@ msgstr "" #: doc/tools/make_rst.py msgid "Description" -msgstr "“Descrição" +msgstr "Descrição" #: doc/tools/make_rst.py msgid "Tutorials" @@ -69,11 +70,11 @@ msgstr "Descrições de propriedades" #: doc/tools/make_rst.py msgid "Inherits:" -msgstr "" +msgstr "Herda de:" #: doc/tools/make_rst.py msgid "Inherited By:" -msgstr "" +msgstr "Herdado por:" #: doc/tools/make_rst.py msgid "(overrides %s)" @@ -930,7 +931,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" "Faz a interpolação linear entre dois ângulos (em radianos) por um valor " "normalizado.\n" @@ -7783,6 +7790,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8925,6 +8944,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -11622,7 +11651,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -11692,8 +11721,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -12288,6 +12317,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "Emitido quando um dos botões do grupo é pressionado." +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -13045,7 +13097,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13057,21 +13118,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13087,7 +13168,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13099,7 +13185,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13113,7 +13204,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -13122,7 +13219,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -13132,7 +13235,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -13150,10 +13259,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -16704,9 +16819,11 @@ msgid "" msgstr "" #: doc/classes/Control.xml -#, fuzzy -msgid "Returns [code]true[/code] if drag operation is successful." -msgstr "Retorna [code]true[/code] se o script pode ser instanciado." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." +msgstr "" #: doc/classes/Control.xml msgid "" @@ -20341,9 +20458,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -23543,7 +23662,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -24235,33 +24354,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -29001,34 +29130,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -30319,8 +30456,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -31094,7 +31233,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -31236,6 +31380,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -33276,7 +33433,8 @@ msgstr "Uma linha 2D." #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -33320,8 +33478,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -35161,6 +35328,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -36486,9 +36688,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -36665,6 +36878,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -37448,7 +37669,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37489,6 +37710,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -38163,7 +38393,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -38186,6 +38416,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -38271,11 +38510,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -38858,7 +39104,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38889,7 +39135,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39969,6 +40215,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -40453,6 +40709,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -40535,6 +40800,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -44728,7 +45001,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -44803,12 +45084,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44854,6 +45135,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44921,13 +45212,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44958,13 +45249,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44994,13 +45285,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -45026,12 +45317,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45061,12 +45352,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45095,12 +45386,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46747,6 +47038,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -49046,8 +49347,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -50839,14 +51327,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50891,8 +51380,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -52492,6 +52982,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -52516,6 +53010,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -52872,6 +53372,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "Emitido quando o cronômetro chega ao 0." +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -57417,7 +58315,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -57501,28 +58399,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -57541,6 +58458,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "O tamanho da sombra em pixels." +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -60794,7 +61726,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60924,14 +61858,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -61326,20 +62264,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -61445,13 +62384,14 @@ msgstr "Retorna a escala." #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -61681,7 +62621,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -62520,7 +63460,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -62797,6 +63739,23 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +#, fuzzy +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "Emitido quando o nó entra na árvore." + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -63589,7 +64548,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -63752,8 +64711,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -63851,7 +64810,7 @@ msgstr "Vetor utilizado para matemática 3D." #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63933,8 +64892,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -64528,7 +65487,9 @@ msgstr "Retorna [code]true[/code] se o script pode ser instanciado." #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68973,6 +69934,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -70022,23 +71009,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/pt_BR.po b/doc/translations/pt_BR.po index df7d7969d1..ffaf1abbfa 100644 --- a/doc/translations/pt_BR.po +++ b/doc/translations/pt_BR.po @@ -39,12 +39,13 @@ # Gonçalo Pascoal <goncalojpascoal@gmail.com>, 2022. # Douglas S. Elias <douglassantoselias@gmail.com>, 2022. # Fabio Moura de Oliveira <ccmaismais@yahoo.com>, 2022. +# Daniel Abrante <danielabrante@protonmail.com>, 2022. msgid "" msgstr "" "Project-Id-Version: Godot Engine class reference\n" "Report-Msgid-Bugs-To: https://github.com/godotengine/godot\n" -"PO-Revision-Date: 2022-04-20 18:20+0000\n" -"Last-Translator: Fabio Moura de Oliveira <ccmaismais@yahoo.com>\n" +"PO-Revision-Date: 2022-04-29 02:54+0000\n" +"Last-Translator: Daniel Abrante <danielabrante@protonmail.com>\n" "Language-Team: Portuguese (Brazil) <https://hosted.weblate.org/projects/" "godot-engine/godot-class-reference/pt_BR/>\n" "Language: pt_BR\n" @@ -52,7 +53,7 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8-bit\n" "Plural-Forms: nplurals=2; plural=n > 1;\n" -"X-Generator: Weblate 4.12-dev\n" +"X-Generator: Weblate 4.12.1-dev\n" #: doc/tools/make_rst.py msgid "Description" @@ -986,7 +987,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" "Faz a interpolação linear entre dois ângulos (em radianos) por um valor " "normalizado.\n" @@ -5989,9 +5996,8 @@ msgstr "" #: doc/classes/AnimationNodeOneShot.xml doc/classes/AnimationNodeOutput.xml #: doc/classes/AnimationNodeTimeScale.xml #: doc/classes/AnimationNodeTransition.xml -#, fuzzy msgid "AnimationTree" -msgstr "Nó de animação." +msgstr "Árvore de Animação" #: doc/classes/AnimationNodeAdd3.xml doc/classes/AnimationNodeAnimation.xml #: doc/classes/AnimationNodeBlend2.xml @@ -8054,6 +8060,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -9196,6 +9214,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -11896,7 +11924,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -11966,8 +11994,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -12562,6 +12590,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "Emitido quando um dos botões do grupo é pressionado." +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -13326,7 +13377,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13338,21 +13398,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13368,7 +13448,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13380,7 +13465,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13394,7 +13484,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -13403,7 +13499,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -13413,7 +13515,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -13431,10 +13539,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15374,11 +15488,11 @@ msgstr "" #: doc/classes/Color.xml msgid "Chocolate color." -msgstr "" +msgstr "Cor chocolate" #: doc/classes/Color.xml msgid "Coral color." -msgstr "" +msgstr "Cor coral." #: doc/classes/Color.xml msgid "Cornflower color." @@ -15394,7 +15508,7 @@ msgstr "" #: doc/classes/Color.xml msgid "Cyan color." -msgstr "" +msgstr "Cor ciano." #: doc/classes/Color.xml msgid "Dark blue color." @@ -17019,9 +17133,11 @@ msgid "" msgstr "" #: doc/classes/Control.xml -#, fuzzy -msgid "Returns [code]true[/code] if drag operation is successful." -msgstr "Retorna [code]true[/code] se o script pode ser instanciado." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." +msgstr "" #: doc/classes/Control.xml msgid "" @@ -20661,9 +20777,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -23865,7 +23983,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -24562,33 +24680,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -29353,34 +29481,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -30676,8 +30812,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -31452,7 +31590,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -31597,6 +31740,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -33643,7 +33799,8 @@ msgstr "Uma linha 2D." #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -33687,8 +33844,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -35530,6 +35696,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -36872,9 +37073,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -37052,6 +37264,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -37836,7 +38056,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37877,6 +38097,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -38551,7 +38780,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -38574,6 +38803,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -38659,11 +38897,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -39246,7 +39491,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -39277,7 +39522,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -40361,6 +40606,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -40848,6 +41103,15 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml #, fuzzy msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " @@ -40933,6 +41197,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -45161,7 +45433,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -45236,12 +45516,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45287,6 +45567,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -45354,13 +45644,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45391,13 +45681,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -45427,13 +45717,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -45459,12 +45749,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45494,12 +45784,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45528,12 +45818,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -47183,6 +47473,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -49482,8 +49782,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -50722,7 +51209,7 @@ msgstr "" #: doc/classes/Resource.xml msgid "Resources" -msgstr "" +msgstr "Recursos" #: doc/classes/Resource.xml msgid "" @@ -51283,14 +51770,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51335,8 +51823,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -52937,6 +53426,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -52961,6 +53454,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -53318,6 +53817,404 @@ msgstr "O tempo restante." msgid "Emitted when the timer reaches 0." msgstr "Emitido quando o cronômetro chega ao 0." +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -57868,7 +58765,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -57952,28 +58849,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -57992,6 +58908,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "O tamanho da sombra em pixels." +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -61268,7 +62199,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -61398,14 +62331,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -61800,20 +62737,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -61919,13 +62857,14 @@ msgstr "Retorna a escala." #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -62156,7 +63095,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -62998,7 +63937,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -63275,6 +64216,23 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +#, fuzzy +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "Emitido quando o nó entra na árvore." + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -64067,7 +65025,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -64230,8 +65188,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -64329,7 +65287,7 @@ msgstr "Vetor utilizado para matemática 3D." #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -64413,8 +65371,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -65012,7 +65970,9 @@ msgstr "Retorna [code]true[/code] se o script pode ser instanciado." #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -69485,6 +70445,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -70543,23 +71529,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/ro.po b/doc/translations/ro.po index 8ed6c32878..26a7c6b2a6 100644 --- a/doc/translations/ro.po +++ b/doc/translations/ro.po @@ -649,7 +649,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -7015,6 +7021,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8157,6 +8175,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10854,7 +10882,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -10924,8 +10952,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11515,6 +11543,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12269,7 +12320,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12281,21 +12341,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12311,7 +12391,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12323,7 +12408,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12337,7 +12427,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12346,7 +12442,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12356,7 +12458,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12374,10 +12482,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15894,7 +16008,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19518,9 +19635,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22712,7 +22831,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23407,33 +23526,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28170,34 +28299,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29488,8 +29625,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30259,7 +30398,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30401,6 +30545,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32441,7 +32598,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32485,8 +32643,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34324,6 +34491,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35631,9 +35833,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35808,6 +36021,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36588,7 +36809,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36629,6 +36850,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37303,7 +37533,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37326,6 +37556,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37411,11 +37650,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -37998,7 +38244,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38029,7 +38275,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39107,6 +39353,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39588,6 +39844,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39670,6 +39935,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -43863,7 +44136,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -43938,12 +44219,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -43989,6 +44270,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44056,13 +44347,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44093,13 +44384,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44129,13 +44420,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44161,12 +44452,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44196,12 +44487,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44230,12 +44521,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45881,6 +46172,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48179,8 +48480,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -49972,14 +50460,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50023,8 +50512,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51624,6 +52114,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51648,6 +52142,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -52002,6 +52502,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56525,7 +57423,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56609,28 +57507,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56649,6 +57566,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -59893,7 +60825,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60023,14 +60957,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60425,20 +61363,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60544,13 +61483,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60780,7 +61720,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61612,7 +62552,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -61889,6 +62831,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62681,7 +63639,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -62841,8 +63799,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -62940,7 +63898,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63022,8 +63980,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63615,7 +64573,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68060,6 +69020,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69109,23 +70095,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/ru.po b/doc/translations/ru.po index f5ef5d7395..2f27837f28 100644 --- a/doc/translations/ru.po +++ b/doc/translations/ru.po @@ -44,12 +44,13 @@ # Turok Chukchin <chukchinturok@gmail.com>, 2022. # Rish Alternative <ii4526668@gmail.com>, 2022. # Andrey <stre10k@mail.ru>, 2022. +# Smadjavul <o1985af@gmail.com>, 2022. msgid "" msgstr "" "Project-Id-Version: Godot Engine class reference\n" "Report-Msgid-Bugs-To: https://github.com/godotengine/godot\n" -"PO-Revision-Date: 2022-04-25 15:12+0000\n" -"Last-Translator: Andrey <stre10k@mail.ru>\n" +"PO-Revision-Date: 2022-04-29 02:53+0000\n" +"Last-Translator: Smadjavul <o1985af@gmail.com>\n" "Language-Team: Russian <https://hosted.weblate.org/projects/godot-engine/" "godot-class-reference/ru/>\n" "Language: ru\n" @@ -874,6 +875,25 @@ msgid "" "[/codeblock]\n" "See also [method lerp] which performs the reverse of this operation." msgstr "" +"Возвращает коэффициент интерполяции или экстраполяции с учетом диапазона, " +"указанного в [code]от[/code] и [code]до[/code], и интерполированное " +"значение, указанное в [code]весе[/code]. Возвращаемое значение будет " +"находиться в диапазоне [code]0.0[/code] and [code]1.0[/code] если [code]вес[/" +"code] находится между [code]от[/code] и [code]до[/code] (включительно). Если " +"[code]вес[/code] находится за пределами этого диапазона, то будет возвращён " +"коэффициент экстраполяции (возвращаемое значение меньше [code]0.0[/code] или " +"больше [code]1.0[/code]).\n" +"[codeblock]\n" +"# Коэффициент интерполяции в приведённом ниже вызове `lerp()` составляет " +"0,75.\n" +"var middle = lerp(20, 30, 0.75)\n" +"# `middle ` теперь составляет 27,5.\n" +"# Теперь мы делаем вид, что забыли первоначальное значение и хотим его " +"узнать.\n" +"var ratio = inverse_lerp(20, 30, 27.5)\n" +"# `ratio` теперь 0.75.\n" +"[/codeblock]\n" +"Смотрите также [метод lerp], который выполняет обратную этой операцию." #: modules/gdscript/doc_classes/@GDScript.xml msgid "" @@ -945,7 +965,6 @@ msgstr "" "[/codeblock]" #: modules/gdscript/doc_classes/@GDScript.xml -#, fuzzy msgid "" "Linearly interpolates between two values by the factor defined in " "[code]weight[/code]. To perform interpolation, [code]weight[/code] should be " @@ -965,13 +984,16 @@ msgid "" "To perform eased interpolation with [method lerp], combine it with [method " "ease] or [method smoothstep]." msgstr "" -"Линейная интерполяция между двумя значениями по нормализованному значению. " -"Это противоположно [method inverse_lerp].\n" +"Линейно интерполирует между двумя значениями с помощью коэффициента, " +"определенного в [code]weight[/code]. Для выполнения интерполяции [code]вес[/" +"code] должен составлять от [code]0.0[/code] до [code]1.0[/code] " +"(включительно). Однако значения за пределами этого диапазона разрешены и " +"могут быть использованы для выполнения [i]экстраполяции[/i].\n" "Если аргументы [code]от[/code] и [code]до[/code] имеют тип [int] или " "[float], возвращаемое значение будет [float].\n" "Если оба значения имеют одинаковый векторный тип ([Vector2], [Vector3] или " "[Color]), возвращаемое значение будет одного типа ([code]lerp[/code], затем " -"вызывается векторный тип [code]lerp[/code]).\n" +"вызывается векторный тип [code]linear_interpolate[/code]).\n" "[codeblock]\n" "lerp(0, 4, 0.75) # Возвращает 3.0, формула: (0-75%) + (4-75%)\n" "lerp(Vector2(1, 5), Vector2(3, 2), 0.5) # Возвращает Vector2(2, 3.5), " @@ -994,12 +1016,20 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" "Линейная интерполяция между двумя углами (в радианах) по нормализованному " "значению.\n" -"Аналогично [method lerp], но корректно интерполируется, когда углы " -"оборачивают [constant @GDScript.TAU].\n" +"Аналогично [методу lerp], но корректно интерполируется, когда углы " +"оборачивают вокруг [constant @GDScript.TAU]. Чтобы выполнить упрощенную " +"интерполяцию с помощью [метода lerp_angle], объедините его с [методом ease] " +"или [методом smoothstep].\n" "[codeblock]\n" "extends Sprite\n" "var elapsed = 0.0\n" @@ -1039,7 +1069,6 @@ msgstr "" "[/codeblock]" #: modules/gdscript/doc_classes/@GDScript.xml -#, fuzzy msgid "" "Loads a resource from the filesystem located at [code]path[/code]. The " "resource is loaded on the method call (unless it's referenced already " @@ -1061,23 +1090,25 @@ msgid "" "This method is a simplified version of [method ResourceLoader.load], which " "can be used for more advanced scenarios." msgstr "" -"Загружает ресурс, расположенный по адресу [code]path[/code] в файловой " -"системе. Ресурс загружается при вызове метода (если на этот ресурс нет " -"ссылок, например, в другом скрипте или в сцене), что может вызвать небольшую " -"задержку, особенно при загрузке сцен. Чтобы избежать лишних задержек при " -"многократной загрузке, храните ресурс в переменной или используйте [method " -"preload].\n" -"[b]Примечание:[/b] Пути ресурсов можно получить, щёлкнув правой кнопкой мыши " -"на ресурсе в панели \"Файловая система\" и выбрав «Копировать путь», или " -"перетащив файл из панели «Файловая система» в скрипт.\n" +"Загружает ресурс из файловой системы, расположенной по адресу [code]путь[/" +"code]. Ресурс загружается при вызове метода (если только на него уже не " +"ссылаются в другом месте, например, в другом скрипте или в сцене), что может " +"вызвать небольшую задержку, особенно при загрузке сцен. Чтобы избежать " +"ненужных задержек при многократной загрузке чего-либо, либо сохраните ресурс " +"в переменной, либо используйте [метод preload].\n" +"[b]Примечание: [/b] Пути к ресурсам можно получить, щёлкнув правой кнопкой " +"мыши на ресурсе в панели «Файловая система» и выбрав \"Копировать путь\" или " +"перетащив файл из панели «Файловая система» в сценарий.\n" "[codeblock]\n" -"# Загружает сцену main, расположенную в корневой директории проекта, и " -"кэширует её в переменной.\n" -"var main = load(\"res://main.tscn\") # main будет содержать ресурс " -"PackedScene.\n" +"# Load a scene called main located in the root of the project directory and " +"cache it in a variable.\n" +"var main = load(\"res://main.tscn\") # main will contain a PackedScene " +"resource.\n" "[/codeblock]\n" -"[b]Важно:[/b] Путь должен быть абсолютным, относительный путь просто вернёт " -"[code]null[/code]." +"[b]Важно:[/b] Путь должен быть абсолютным, локальный путь просто вернет " +"[code]null[/code].\n" +"Этот метод представляет собой упрощенную версию [метода ResourceLoader." +"load], который можно использовать для более сложных сценариев." #: modules/gdscript/doc_classes/@GDScript.xml msgid "" @@ -8546,6 +8577,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -9762,6 +9805,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -12470,7 +12523,7 @@ msgstr "" #, fuzzy msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" "Создает чистую матрицу базиса вращения, повёрнутую вокруг заданной оси " @@ -12546,10 +12599,13 @@ msgid "" msgstr "" #: doc/classes/Basis.xml +#, fuzzy msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" +"Вращает вектор вокруг заданной оси на [code]phi[/code] радиан. Ось должна " +"быть нормализованным вектором." #: doc/classes/Basis.xml msgid "" @@ -13140,6 +13196,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "Излучается при принятии диалога, т.е. когда нажата кнопка OK." +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -13905,7 +13984,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13917,21 +14005,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13947,7 +14055,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13959,7 +14072,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13973,7 +14091,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -13982,7 +14106,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -13992,7 +14122,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -14010,10 +14146,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -17650,9 +17792,11 @@ msgstr "" "приблизительно равны друг другу." #: doc/classes/Control.xml -#, fuzzy -msgid "Returns [code]true[/code] if drag operation is successful." -msgstr "Возвращает [code]true[/code] если массив пустой." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." +msgstr "" #: doc/classes/Control.xml msgid "" @@ -21294,9 +21438,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -24506,7 +24652,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -25203,33 +25349,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -29989,34 +30145,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -31311,8 +31475,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -32083,7 +32249,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -32226,6 +32397,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -34294,7 +34478,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -34338,8 +34523,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -36183,6 +36377,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -37525,9 +37754,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -37703,6 +37943,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml #, fuzzy msgid "Server interface for low-level 3D navigation access." @@ -38567,7 +38815,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -38608,6 +38856,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -39285,7 +39542,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -39308,6 +39565,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -39393,11 +39659,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -39982,7 +40255,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -40013,7 +40286,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -41104,6 +41377,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -41591,6 +41874,15 @@ msgid "" msgstr "Возвращает [code]true[/code] если вектор нормализован." #: doc/classes/OS.xml +msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml #, fuzzy msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " @@ -41676,6 +41968,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -45905,7 +46205,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -45980,12 +46288,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46032,6 +46340,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -46099,13 +46417,14 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." -msgstr "" +#, fuzzy +msgid "A pooled array of [Color]." +msgstr "Массив цветов." #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46137,13 +46456,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -46177,13 +46496,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -46210,12 +46529,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46247,12 +46566,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46282,12 +46601,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -47957,6 +48276,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -50255,8 +50584,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -52106,14 +52622,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -52158,8 +52675,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -53759,6 +54277,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -53783,6 +54305,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -54138,6 +54666,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -58701,7 +59627,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -58785,28 +59711,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -58825,6 +59770,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -62119,7 +63079,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -62252,14 +63214,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -62655,21 +63621,26 @@ msgid "" msgstr "" #: doc/classes/Transform.xml +#, fuzzy msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" +"Создает чистую матрицу базиса вращения, повёрнутую вокруг заданной оси " +"[code]axis[/code] на угол [code]phi[/code], в радианах. Ось должна быть " +"нормализованным вектором." #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -62775,13 +63746,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -63012,7 +63984,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -63861,7 +64833,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -64138,6 +65112,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -64944,7 +65934,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -65153,9 +66143,10 @@ msgstr "" "Возвращает вектор отраженный от плоскости определенной заданной нормалью." #: doc/classes/Vector2.xml +#, fuzzy msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" "Возвращает вектор вращения на [code]phi[/code] радиан. См. также [method " "@GDScript.deg2rad]." @@ -65279,7 +66270,7 @@ msgstr "" #, fuzzy msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -65392,8 +66383,8 @@ msgstr "" #: doc/classes/Vector3.xml #, fuzzy msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" "Вращает вектор вокруг заданной оси на [code]phi[/code] радиан. Ось должна " "быть нормализованным вектором." @@ -65995,7 +66986,9 @@ msgstr "Возвращает [code]true[/code] если массив пусто #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -70487,6 +71480,32 @@ msgstr "Смещение текстуры." #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -71540,23 +72559,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/sk.po b/doc/translations/sk.po index c16d337a6a..380af3d949 100644 --- a/doc/translations/sk.po +++ b/doc/translations/sk.po @@ -636,7 +636,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -6998,6 +7004,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8140,6 +8158,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10837,7 +10865,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -10907,8 +10935,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11498,6 +11526,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12252,7 +12303,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12264,21 +12324,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12294,7 +12374,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12306,7 +12391,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12320,7 +12410,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12329,7 +12425,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12339,7 +12441,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12357,10 +12465,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15877,7 +15991,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19501,9 +19618,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22695,7 +22814,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23390,33 +23509,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28153,34 +28282,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29471,8 +29608,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30242,7 +30381,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30384,6 +30528,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32424,7 +32581,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32468,8 +32626,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34307,6 +34474,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35614,9 +35816,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35791,6 +36004,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36571,7 +36792,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36612,6 +36833,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37286,7 +37516,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37309,6 +37539,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37394,11 +37633,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -37981,7 +38227,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38012,7 +38258,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39090,6 +39336,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39571,6 +39827,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39653,6 +39918,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -43846,7 +44119,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -43921,12 +44202,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -43972,6 +44253,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44039,13 +44330,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44076,13 +44367,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44112,13 +44403,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44144,12 +44435,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44179,12 +44470,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44213,12 +44504,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45864,6 +46155,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48162,8 +48463,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -49955,14 +50443,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50006,8 +50495,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51607,6 +52097,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51631,6 +52125,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -51985,6 +52485,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56508,7 +57406,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56592,28 +57490,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56632,6 +57549,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -59876,7 +60808,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60006,14 +60940,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60408,20 +61346,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60527,13 +61466,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60763,7 +61703,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61595,7 +62535,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -61872,6 +62814,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62664,7 +63622,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -62824,8 +63782,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -62923,7 +63881,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63005,8 +63963,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63598,7 +64556,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68043,6 +69003,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69092,23 +70078,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/sr_Cyrl.po b/doc/translations/sr_Cyrl.po index 5f8878e056..b3af766f44 100644 --- a/doc/translations/sr_Cyrl.po +++ b/doc/translations/sr_Cyrl.po @@ -647,7 +647,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -7009,6 +7015,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8151,6 +8169,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10848,7 +10876,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -10918,8 +10946,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11509,6 +11537,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12263,7 +12314,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12275,21 +12335,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12305,7 +12385,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12317,7 +12402,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12331,7 +12421,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12340,7 +12436,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12350,7 +12452,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12368,10 +12476,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15888,7 +16002,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19512,9 +19629,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22706,7 +22825,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23401,33 +23520,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28164,34 +28293,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29482,8 +29619,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30253,7 +30392,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30395,6 +30539,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32435,7 +32592,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32479,8 +32637,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34318,6 +34485,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35625,9 +35827,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35802,6 +36015,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36582,7 +36803,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36623,6 +36844,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37297,7 +37527,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37320,6 +37550,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37405,11 +37644,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -37992,7 +38238,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38023,7 +38269,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39101,6 +39347,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39582,6 +39838,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39664,6 +39929,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -43857,7 +44130,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -43932,12 +44213,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -43983,6 +44264,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44050,13 +44341,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44087,13 +44378,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44123,13 +44414,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44155,12 +44446,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44190,12 +44481,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44224,12 +44515,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45875,6 +46166,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48173,8 +48474,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -49966,14 +50454,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50017,8 +50506,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51618,6 +52108,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51642,6 +52136,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -51996,6 +52496,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56519,7 +57417,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56603,28 +57501,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56643,6 +57560,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -59887,7 +60819,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60017,14 +60951,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60419,20 +61357,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60538,13 +61477,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60774,7 +61714,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61606,7 +62546,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -61883,6 +62825,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62675,7 +63633,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -62835,8 +63793,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -62934,7 +63892,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63016,8 +63974,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63609,7 +64567,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68054,6 +69014,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69103,23 +70089,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/sv.po b/doc/translations/sv.po index 782a05a2e1..8da5285250 100644 --- a/doc/translations/sv.po +++ b/doc/translations/sv.po @@ -636,7 +636,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -6998,6 +7004,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8140,6 +8158,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10837,7 +10865,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -10907,8 +10935,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11498,6 +11526,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12252,7 +12303,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12264,21 +12324,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12294,7 +12374,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12306,7 +12391,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12320,7 +12410,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12329,7 +12425,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12339,7 +12441,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12357,10 +12465,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15877,7 +15991,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19501,9 +19618,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22695,7 +22814,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23387,33 +23506,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28150,34 +28279,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29468,8 +29605,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30239,7 +30378,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30381,6 +30525,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32421,7 +32578,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32465,8 +32623,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34304,6 +34471,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35611,9 +35813,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35788,6 +36001,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36568,7 +36789,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36609,6 +36830,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37283,7 +37513,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37306,6 +37536,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37391,11 +37630,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -37978,7 +38224,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38009,7 +38255,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39087,6 +39333,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39568,6 +39824,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39650,6 +39915,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -43843,7 +44116,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -43918,12 +44199,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -43969,6 +44250,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44036,13 +44327,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44073,13 +44364,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44109,13 +44400,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44141,12 +44432,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44176,12 +44467,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44210,12 +44501,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45861,6 +46152,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48159,8 +48460,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -49952,14 +50440,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50003,8 +50492,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51604,6 +52094,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51628,6 +52122,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -51982,6 +52482,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56505,7 +57403,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56589,28 +57487,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56629,6 +57546,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -59873,7 +60805,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60003,14 +60937,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60405,20 +61343,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60524,13 +61463,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60760,7 +61700,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61592,7 +62532,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -61869,6 +62811,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62661,7 +63619,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -62821,8 +63779,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -62920,7 +63878,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63002,8 +63960,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63595,7 +64553,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68040,6 +69000,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69089,23 +70075,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/th.po b/doc/translations/th.po index 712c89e797..c3e896aba7 100644 --- a/doc/translations/th.po +++ b/doc/translations/th.po @@ -714,7 +714,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -7103,6 +7109,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8245,6 +8263,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10943,7 +10971,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -11013,8 +11041,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11604,6 +11632,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12360,7 +12411,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12372,21 +12432,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12402,7 +12482,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12414,7 +12499,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12428,7 +12518,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12437,7 +12533,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12447,7 +12549,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12465,10 +12573,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15986,7 +16100,10 @@ msgid "" msgstr "" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" #: doc/classes/Control.xml @@ -19610,9 +19727,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22805,7 +22924,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23500,33 +23619,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28265,34 +28394,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29605,8 +29742,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30396,7 +30535,12 @@ msgstr "" "มากขึ้นเท่านั้น ถ้าการ action ถูกจับคู่กับตัวควบคุมที่ไม่มีแกนเป็นแป้นพิมพ์ค่าที่ส่งคืนก็จะเป็น 0 หรือ 1" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30538,6 +30682,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32590,7 +32747,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32634,8 +32792,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34473,6 +34640,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35787,9 +35989,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35964,6 +36177,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36797,7 +37018,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36838,6 +37059,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37512,7 +37742,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37535,6 +37765,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37620,11 +37859,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -38207,7 +38453,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38238,7 +38484,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39318,6 +39564,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39801,6 +40057,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39883,6 +40148,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -44081,7 +44354,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -44156,12 +44437,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44207,6 +44488,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44274,13 +44565,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44311,13 +44602,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44347,13 +44638,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44379,12 +44670,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44414,12 +44705,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44448,12 +44739,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46100,6 +46391,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48403,8 +48704,196 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +#, fuzzy +msgid "General-purpose 3D proximity detection node." +msgstr "Node สไปรต์เอนกประสงค์" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -50197,14 +50686,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50249,8 +50739,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51850,6 +52341,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51874,6 +52369,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -52228,6 +52729,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56754,7 +57653,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56838,28 +57737,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56878,6 +57796,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -60126,7 +61059,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60256,14 +61191,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60658,20 +61597,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60777,13 +61717,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -61013,7 +61954,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61846,7 +62787,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -62123,6 +63066,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62921,7 +63880,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -63081,8 +64040,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -63181,7 +64140,7 @@ msgstr "" #, fuzzy msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63268,8 +64227,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63861,7 +64820,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68310,6 +69271,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69359,23 +70346,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/tl.po b/doc/translations/tl.po index a1e69a9a36..701e32eba7 100644 --- a/doc/translations/tl.po +++ b/doc/translations/tl.po @@ -712,7 +712,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -7074,6 +7080,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8216,6 +8234,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10917,7 +10945,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -10987,8 +11015,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11578,6 +11606,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12335,7 +12386,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12347,21 +12407,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12377,7 +12457,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12389,7 +12474,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12403,7 +12493,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12412,7 +12508,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12422,7 +12524,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12440,10 +12548,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15960,11 +16074,11 @@ msgid "" msgstr "" #: doc/classes/Control.xml -#, fuzzy -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" -"Kung [code]true[/code], ang mga child nodes ay inaayos, kung hindi ang pag-" -"so-sort ay hindi pinapagana." #: doc/classes/Control.xml msgid "" @@ -19587,9 +19701,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22781,7 +22897,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23473,33 +23589,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28236,34 +28362,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29554,8 +29688,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30325,7 +30461,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30467,6 +30608,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32507,7 +32661,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32551,8 +32706,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34393,6 +34557,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35706,9 +35905,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35883,6 +36093,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36663,7 +36881,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36704,6 +36922,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37378,7 +37605,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37401,6 +37628,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37486,11 +37722,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -38073,7 +38316,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38104,7 +38347,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39182,6 +39425,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39666,6 +39919,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39748,6 +40010,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -43941,7 +44211,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -44016,12 +44294,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44067,6 +44345,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44134,13 +44422,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44171,13 +44459,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44207,13 +44495,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44239,12 +44527,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44274,12 +44562,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44308,12 +44596,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45959,6 +46247,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48257,8 +48555,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -50050,14 +50535,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50101,8 +50587,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51702,6 +52189,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51726,6 +52217,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -52080,6 +52577,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56603,7 +57498,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56687,28 +57582,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56727,6 +57641,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -59974,7 +60903,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60104,14 +61035,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60506,20 +61441,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60625,13 +61561,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60861,7 +61798,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61693,7 +62630,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -61970,6 +62909,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62762,7 +63717,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -62922,8 +63877,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -63021,7 +63976,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63103,8 +64058,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63699,7 +64654,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68144,6 +69101,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69193,23 +70176,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/tr.po b/doc/translations/tr.po index 2cc8ec84ec..43add1da92 100644 --- a/doc/translations/tr.po +++ b/doc/translations/tr.po @@ -931,7 +931,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" "İki açı arasında, sınırlandırma öğesine göre (üçüncü parametre), doğrusal " "bir ara değer hesaplar (inperpolate).\n" @@ -7771,6 +7777,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8913,6 +8931,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -11612,7 +11640,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -11682,8 +11710,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -12273,6 +12301,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -13039,7 +13090,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13051,21 +13111,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13081,7 +13161,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13093,7 +13178,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -13107,7 +13197,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -13116,7 +13212,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -13126,7 +13228,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -13144,10 +13252,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -16666,10 +16780,11 @@ msgid "" msgstr "" #: doc/classes/Control.xml -#, fuzzy -msgid "Returns [code]true[/code] if drag operation is successful." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." msgstr "" -"Eğer [code]true[/code] ise düğümler sıraya sokulur, yoksa sıraya sokulmaz." #: doc/classes/Control.xml msgid "" @@ -20302,9 +20417,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -23499,7 +23616,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -24194,33 +24311,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28969,34 +29096,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -30289,8 +30424,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -31061,7 +31198,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -31205,6 +31347,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -33246,7 +33401,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -33290,8 +33446,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -35134,6 +35299,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -36467,9 +36667,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -36645,6 +36856,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -37429,7 +37648,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37470,6 +37689,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -38144,7 +38372,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -38167,6 +38395,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -38252,11 +38489,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -38839,7 +39083,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38870,7 +39114,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39953,6 +40197,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -40438,6 +40692,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -40520,6 +40783,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -44741,7 +45012,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -44816,12 +45095,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44867,6 +45146,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44934,13 +45223,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44971,13 +45260,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -45007,13 +45296,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -45039,12 +45328,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45074,12 +45363,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -45108,12 +45397,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46761,6 +47050,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -49059,8 +49358,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -50860,14 +51346,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50912,8 +51399,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -52513,6 +53001,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -52537,6 +53029,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -52891,6 +53389,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -57418,7 +58314,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -57502,28 +58398,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -57542,6 +58457,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -60797,7 +61727,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60927,14 +61859,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -61329,20 +62265,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -61448,13 +62385,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -61685,7 +62623,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -62522,7 +63460,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -62799,6 +63739,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -63591,7 +64547,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -63752,8 +64708,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -63851,7 +64807,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63934,8 +64890,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -64532,7 +65488,9 @@ msgstr "" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68996,6 +69954,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -70051,23 +71035,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/uk.po b/doc/translations/uk.po index 036708df66..9ec0d5c89f 100644 --- a/doc/translations/uk.po +++ b/doc/translations/uk.po @@ -771,7 +771,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -7156,6 +7162,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8298,6 +8316,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10997,7 +11025,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -11067,8 +11095,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11659,6 +11687,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12419,7 +12470,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12431,21 +12491,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12461,7 +12541,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12473,7 +12558,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12487,7 +12577,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12496,7 +12592,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12506,7 +12608,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12524,10 +12632,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -16045,9 +16159,11 @@ msgid "" msgstr "" #: doc/classes/Control.xml -#, fuzzy -msgid "Returns [code]true[/code] if drag operation is successful." -msgstr "Повертає косинус параметра." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." +msgstr "" #: doc/classes/Control.xml msgid "" @@ -19680,9 +19796,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22875,7 +22993,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23567,33 +23685,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28341,34 +28469,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29661,8 +29797,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30433,7 +30571,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30575,6 +30718,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32617,7 +32773,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32661,8 +32818,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34502,6 +34668,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35832,9 +36033,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -36009,6 +36221,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36793,7 +37013,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36834,6 +37054,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37508,7 +37737,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37531,6 +37760,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37616,11 +37854,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -38203,7 +38448,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38234,7 +38479,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39317,6 +39562,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39801,6 +40056,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39883,6 +40147,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -44096,7 +44368,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -44171,12 +44451,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44222,6 +44502,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44289,13 +44579,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44326,13 +44616,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44362,13 +44652,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44394,12 +44684,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44429,12 +44719,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44463,12 +44753,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46116,6 +46406,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48414,8 +48714,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -50208,14 +50695,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50260,8 +50748,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51861,6 +52350,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51885,6 +52378,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -52239,6 +52738,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56766,7 +57663,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56850,28 +57747,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56890,6 +57806,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -60146,7 +61077,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60276,14 +61209,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60678,20 +61615,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60797,13 +61735,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -61034,7 +61973,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61871,7 +62810,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -62148,6 +63089,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62940,7 +63897,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -63101,8 +64058,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -63200,7 +64157,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63284,8 +64241,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63881,7 +64838,9 @@ msgstr "Повертає косинус параметра." #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68344,6 +69303,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69393,23 +70378,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/vi.po b/doc/translations/vi.po index f3e1d290b9..ab2fc3dc93 100644 --- a/doc/translations/vi.po +++ b/doc/translations/vi.po @@ -909,7 +909,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -7451,6 +7457,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8593,6 +8611,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -11292,7 +11320,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -11362,8 +11390,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11954,6 +11982,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12715,7 +12766,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12727,21 +12787,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12757,7 +12837,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12769,7 +12854,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12783,7 +12873,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12792,7 +12888,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12802,7 +12904,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12820,10 +12928,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -16343,9 +16457,11 @@ msgid "" msgstr "" #: doc/classes/Control.xml -#, fuzzy -msgid "Returns [code]true[/code] if drag operation is successful." -msgstr "Nếu [code]true[/code], họa tiết sẽ được căn ở trung tâm." +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." +msgstr "" #: doc/classes/Control.xml msgid "" @@ -19979,9 +20095,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -23175,7 +23293,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23869,33 +23987,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28637,34 +28765,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29958,8 +30094,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30730,7 +30868,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30873,6 +31016,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32914,7 +33070,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32958,8 +33115,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34800,6 +34966,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -36131,9 +36332,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -36309,6 +36521,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -37093,7 +37313,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37134,6 +37354,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37808,7 +38037,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37831,6 +38060,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37916,11 +38154,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -38503,7 +38748,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38534,7 +38779,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39617,6 +39862,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -40101,6 +40356,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -40183,6 +40447,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -44404,7 +44676,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -44479,12 +44759,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44530,6 +44810,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44597,13 +44887,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44634,13 +44924,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44670,13 +44960,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44702,12 +44992,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44737,12 +45027,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44771,12 +45061,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46428,6 +46718,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48726,8 +49026,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -50525,14 +51012,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50577,8 +51065,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -52178,6 +52667,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -52202,6 +52695,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -52556,6 +53055,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -57085,7 +57982,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -57169,28 +58066,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -57209,6 +58125,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -60464,7 +61395,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60594,14 +61527,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60996,20 +61933,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -61115,13 +62053,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -61352,7 +62291,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -62193,7 +63132,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -62470,6 +63411,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -63262,7 +64219,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -63423,8 +64380,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -63522,7 +64479,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63605,8 +64562,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -64202,7 +65159,9 @@ msgstr "Nếu [code]true[/code], họa tiết sẽ được căn ở trung tâm. #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68674,6 +69633,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69726,23 +70711,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml diff --git a/doc/translations/zh_CN.po b/doc/translations/zh_CN.po index ed6261ee35..984600883d 100644 --- a/doc/translations/zh_CN.po +++ b/doc/translations/zh_CN.po @@ -62,7 +62,7 @@ msgid "" msgstr "" "Project-Id-Version: Godot Engine class reference\n" "Report-Msgid-Bugs-To: https://github.com/godotengine/godot\n" -"PO-Revision-Date: 2022-04-25 15:12+0000\n" +"PO-Revision-Date: 2022-05-04 09:18+0000\n" "Last-Translator: Haoyu Qiu <timothyqiu32@gmail.com>\n" "Language-Team: Chinese (Simplified) <https://hosted.weblate.org/projects/" "godot-engine/godot-class-reference/zh_Hans/>\n" @@ -71,7 +71,7 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8-bit\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" -"X-Generator: Weblate 4.12.1-dev\n" +"X-Generator: Weblate 4.12.1\n" #: doc/tools/make_rst.py msgid "Description" @@ -957,6 +957,7 @@ msgstr "" "值，请将其与 [method ease] 或 [method smoothstep] 组合。" #: modules/gdscript/doc_classes/@GDScript.xml +#, fuzzy msgid "" "Linearly interpolates between two angles (in radians) by a normalized " "value.\n" @@ -971,7 +972,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" "通过归一化值在两个角度之间（以弧度为单位）进行线性插值。\n" "与 [method lerp] 相似，但是当角度环绕 [constant @GDScript.TAU] 时会准确插值。" @@ -1978,10 +1985,10 @@ msgid "" "something else. However, until the object is actually destroyed the weak " "reference may return the object even if there are no strong references to it." msgstr "" -"返回一个对对象的弱引用。\n" -"一个对对象的弱引用不足以使对象保持活动状态：当仅剩余的对引用对象的引用是弱引" -"用时，垃圾回收可以随意销毁该引用并将其内存重用于其他用途。但是，直到没有实际" -"破坏对象为止，弱引用仍可能会返回该对象，即使没有强引用也是如此。" +"返回对某个对象的弱引用。\n" +"对某个对象的弱引用不足以让该对象保持存活：当剩余的对引用对象的引用都是弱引用" +"时，垃圾回收可以随意销毁该对象并将其内存重用于其他用途。但是，直到没有实际破" +"坏对象为止，弱引用仍可能会返回该对象，即使没有强引用也是如此。" #: modules/gdscript/doc_classes/@GDScript.xml msgid "" @@ -4353,9 +4360,8 @@ msgid "The property is a translatable string." msgstr "该属性是一个可翻译的字符串。" #: doc/classes/@GlobalScope.xml -#, fuzzy msgid "Used to group properties together in the editor. See [EditorInspector]." -msgstr "在编辑器中用于为属性分组。" +msgstr "在编辑器中用于为属性分组。见 [EditorInspector]。" #: doc/classes/@GlobalScope.xml msgid "Used to categorize properties together in the editor." @@ -6853,10 +6859,10 @@ msgid "" "animation_tree[\"parameters/Seek/seek_position\"] = 12.0\n" "[/codeblock]" msgstr "" -"这个节点可以使命令发生在动画图示的所有子级上。使用这个节点类型可以从" -"[AnimationNodeBlendTree]内部的开头或某个播放位置开始播放[Animation]。在设置时" -"间和改变动画播放后，通过设置其[code]seek_position[/code]值为[code]-1.0[/" -"code]，使节点在下一个处理帧自动进入休眠模式。\n" +"这个节点可以使 Seek 命令发生在该动画图的所有子级上。使用这个节点类型可以从 " +"[AnimationNodeBlendTree] 内部的开头或某个播放位置开始播放 [Animation]。该 " +"Seek 节点在设置时间并改变动画播放后，会将其 [code]seek_position[/code] 值设" +"为 [code]-1.0[/code]，在下一处理帧自动进入休眠模式。\n" "[codeblock]\n" "# 从头开始播放子动画。\n" "animation_tree.set(\"parameters/Seek/seek_position\", 0.0)\n" @@ -8635,7 +8641,6 @@ msgid "Returns [code]true[/code] if the array is empty." msgstr "该数组为空时，返回 [code]true[/code]。" #: doc/classes/Array.xml -#, fuzzy msgid "" "Removes the first occurrence of a value from the array. If the value does " "not exist in the array, nothing happens. To remove an element by index, use " @@ -8645,13 +8650,26 @@ msgid "" "element is close to the beginning of the array (index 0). This is because " "all elements placed after the removed element have to be reindexed." msgstr "" -"从数组中删除第一次出现的值。要按索引删除元素，请改用 [method remove]。\n" -"[b]注意：[/b]该方法就地操作，不返回值。\n" +"从数组中删除第一次出现的某个值。如果不存在该值，则什么都不会发生。要按索引删" +"除元素，请改用 [method remove]。\n" +"[b]注意：[/b]这个方法是就地操作的，不返回值。\n" "[b]注意：[/b]在大型数组上，如果移除的元素靠近数组的开头（索引 0），则此方法会" "较慢。这是因为所有放置在删除元素之后的元素都必须重新索引。" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -10082,6 +10100,17 @@ msgstr "" "以一种方式安排子控件，以便在容器调整大小时自动保留其长宽比。解决了容器大小是" "动态的，而内容的大小需要相应调整而不失去比例的问题。" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +#, fuzzy +msgid "GUI containers" +msgstr "选项卡容器。" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "指定子控件的水平相对位置。" @@ -13389,9 +13418,10 @@ msgstr "" "可以考虑使用 [Quat] 构造函数代替，它使用四元组代替欧拉角。" #: doc/classes/Basis.xml +#, fuzzy msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" "构造一个纯旋转的基矩阵，围绕给定的 [code]axis[/code] 旋转 [code]phi[/code] 个" @@ -13479,9 +13509,10 @@ msgstr "" "的）。这将在矩阵的基上执行 Gram-Schmidt 正交化。" #: doc/classes/Basis.xml +#, fuzzy msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" "围绕给定轴线引入一个额外的旋转phi（弧度）。该轴必须是一个归一化的向量。" @@ -14202,6 +14233,30 @@ msgstr "返回当前按下的按钮。" msgid "Emitted when one of the buttons of the group is pressed." msgstr "当该组中的一个按钮被按下时触发。" +#: doc/classes/CallbackTweener.xml +#, fuzzy +msgid "Calls the specified method after optional delay." +msgstr "锁定指定的线性或旋转轴。" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "相机节点，会从某个角度进行显示。" @@ -14484,14 +14539,13 @@ msgstr "" "的Z距离会影响其感知的大小。" #: doc/classes/Camera.xml -#, fuzzy 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." msgstr "" -"相机的尺寸，以1/2的宽度或高度测量。仅适用于正交模式。由于[member keep_aspect]" -"锁定在轴上，因此[code]size[/code]设置其他轴的尺寸长度。" +"相机的尺寸，以 1/2 的宽度或高度为单位。仅适用于正交及视锥模式。由于 [member " +"keep_aspect] 锁定在轴上，因此 [code]size[/code] 设置其他轴的尺寸长度。" #: doc/classes/Camera.xml msgid "The vertical (Y) offset of the camera viewport." @@ -15126,10 +15180,17 @@ msgstr "引擎调用的可覆盖函数（如果定义了）来绘制画布项目 msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" -"在给定的角度之间绘制未填充的弧线。[code]point_count[/code] 的值越大，曲线越平" -"滑。另请参阅 [method draw_circle]。" #: doc/classes/CanvasItem.xml msgid "" @@ -15142,28 +15203,42 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" -"绘制一个彩色、未填充的圆。另请参阅 [method draw_arc]、[method " -"draw_polyline]、[method draw_polygon]。" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" -"绘制由任意数量的点构成的彩色多边形，可以是凸多边形也可以是凹多边形。与 " -"[method draw_polygon] 不同，只能为整个多边形必须指定单一颜色。" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" -"使用给定的颜色和宽度，绘制一条从一个 2D 点到另一个点的直线。还可以选择抗锯" -"齿。另请参阅 [method draw_multiline] 和 [method draw_polyline]。" #: doc/classes/CanvasItem.xml msgid "" @@ -15173,13 +15248,19 @@ msgstr "" "使用所提供的纹理以 2D 方式绘制一个 [Mesh]。相关文档请参阅 [MeshInstance2D]。" #: doc/classes/CanvasItem.xml +#, fuzzy msgid "" "Draws multiple disconnected lines with a uniform [code]color[/code]. When " "drawing large amounts of lines, this is faster than using individual [method " "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" "使用单一颜色 [code]color[/code] 绘制多条不相连的直线。绘制大量直线时，比单独" "调用 [method draw_line] 要快。要绘制相连的直线，请换用 [method " @@ -15188,6 +15269,7 @@ msgstr "" "效果。" #: doc/classes/CanvasItem.xml +#, fuzzy msgid "" "Draws multiple disconnected lines with a uniform [code]width[/code] and " "segment-by-segment coloring. Colors assigned to line segments match by index " @@ -15196,7 +15278,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" "使用单一宽度 [code]width[/code] 绘制多条不相连的直线，不同线段颜色可以不同。" "线段的颜色使用 [code]points[/code] 和 [code]colors[/code] 的索引进行匹配。绘" @@ -15218,19 +15305,29 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" -"绘制由任意数量的点构成的实心多边形，可以是凸多边形也可以是凹多边形。与 " -"[method draw_colored_polygon] 不同，每个点的颜色都可以单独修改。另请参阅 " -"[method draw_polyline] 和 [method draw_polyline_colors]。" #: doc/classes/CanvasItem.xml +#, fuzzy msgid "" "Draws interconnected line segments with a uniform [code]color[/code] and " "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" "使用单一颜色 [code]color[/code] 和宽度 [code]width[/code] 绘制多条相连的线" "段，还可以选择抗锯齿。绘制大量直线时，比单独调用 [method draw_line] 要快。要" @@ -15238,13 +15335,20 @@ msgstr "" "draw_polygon]。" #: doc/classes/CanvasItem.xml +#, fuzzy msgid "" "Draws interconnected line segments with a uniform [code]width[/code] and " "segment-by-segment coloring, and optional antialiasing. Colors assigned to " "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" "使用单一宽度 [code]width[/code] 绘制多条相连的直线，不同线段颜色可以不同。线" "段的颜色使用 [code]points[/code] 和 [code]colors[/code] 的索引进行匹配。绘制" @@ -15265,15 +15369,22 @@ msgstr "" "draw_polygon]、[method draw_rect]。" #: doc/classes/CanvasItem.xml +#, fuzzy msgid "" "Draws a rectangle. If [code]filled[/code] is [code]true[/code], the " "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" "绘制一个矩形。如果[code]filled[/code]是[code]true[/code]，矩形将被填充为指定" "的[code]color[/code]。如果[code]filled[/code]是[code]false[/code]，矩形将以" @@ -15466,6 +15577,10 @@ msgid "" "top-level. The [CanvasItem] will effectively act as if it was placed as a " "child of a bare [Node]. See also [method is_set_as_toplevel]." msgstr "" +"如果 [code]enable[/code] 为 [code]true[/code]，那么这个 [CanvasItem] [i]不会" +"[/i]继承父 [CanvasItem] 的变换。其绘制顺序也会发生改变，会被绘制到其他非顶层 " +"[CanvasItem] 之上。该 [CanvasItem] 会与设为普通 [Node] 节点的子节点的效果一" +"致。另请参阅 [method is_set_as_toplevel]。" #: doc/classes/CanvasItem.xml msgid "" @@ -16734,7 +16849,6 @@ msgid "Base node for 2D collision objects." msgstr "二维碰撞对象的基础节点。" #: doc/classes/CollisionObject2D.xml -#, fuzzy msgid "" "CollisionObject2D is the base class for 2D physics objects. It can hold any " "number of 2D collision [Shape2D]s. Each shape must be assigned to a [i]shape " @@ -16745,10 +16859,12 @@ msgid "" "([Viewport] canvas or [CanvasLayer]) are supported. The behavior of " "collisions between objects in different canvases is undefined." msgstr "" -"CollisionObject2D 是 2D 物理对象的基础类。它可以容纳任意数量的 2D 碰撞形状 " +"CollisionObject2D 是 2D 物理对象的基类，可以容纳任意数量的 2D 碰撞形状 " "[Shape2D]。每个形状必须分配给一个[i]形状所有者[/i]。CollisionObject2D 可以拥" "有任意数量的形状所有者。形状所有者不是节点，也不会出现在编辑器中，但可以通过" -"代码使用 [code]shape_owner_*[/code] 方法访问。" +"代码使用 [code]shape_owner_*[/code] 方法访问。\n" +"[b]注意：[/b]仅支持相同画布中不同对象的碰撞（[Viewport] 画布或 " +"[CanvasLayer]）。不同画布中的对象之间的碰撞行为是未定义的。" #: doc/classes/CollisionObject2D.xml msgid "" @@ -19614,8 +19730,11 @@ msgstr "" "参阅 [method add_stylebox_override]。" #: doc/classes/Control.xml -msgid "Returns [code]true[/code] if drag operation is successful." -msgstr "如果拖拽操作成功，则返回 [code]true[/code]。" +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." +msgstr "" #: doc/classes/Control.xml msgid "" @@ -24266,10 +24385,13 @@ msgstr "" "返回[enum Error]代码常量之一（成功时返回 [code]OK[/code]）。" #: doc/classes/Directory.xml +#, fuzzy msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" "删除目标文件或空目录。参数可以是相对于当前目录的，也可以是绝对路径。如果目标" @@ -25555,9 +25677,8 @@ msgstr "" "法。" #: doc/classes/EditorInspector.xml -#, fuzzy msgid "A control used to edit properties of an object." -msgstr "用于编辑所选节点的属性的选项卡。" +msgstr "用于编辑所选节点属性的控件。" #: doc/classes/EditorInspector.xml msgid "" @@ -25585,6 +25706,25 @@ msgid "" "groups. So properties with group usage usually use capitalized names instead " "of snake_cased names." msgstr "" +"这是为编辑器的“设置”对话框、“检查器”面板等实现属性编辑的控件。要获取编辑器“检" +"查器”面板中所使用的 [EditorInspector]，请使用 [method EditorInterface." +"get_inspector]。\n" +"[EditorInspector] 展示属性的顺序与 [method Object.get_property_list] 返回的数" +"组一致。\n" +"如果属性的名称为路径形式（即包含正斜杠），[EditorInspector] 会为该路径上的各" +"个“目录”创建嵌套的部分。例如，如果某个属性名为 [code]highlighting/gdscript/" +"node_path_color[/code]，那么就会显示为“Node Path Color”，位于嵌套" +"在“Highlighting”部分的“GDScript”部分中。\n" +"如果属性包含 [constant @GlobalScope.PROPERTY_USAGE_GROUP] 用法，就会将其后续" +"属性中，名称以其提示字符串开头的属性合为一组。如果遇到不以该提示字符串开头的" +"属性，或者开始了一个新的分组，那么这个分组就会结束。分组名称为空的效果为结束" +"当前分组。[EditorInspector] 会为每个分组都创建一个顶层的部分。例如，如果有个" +"包含分组用法的属性名叫 [code]Collide With[/code]，其提示字符串为 " +"[code]collide_with_[/code]，那么后续的 [code]collide_with_area[/code] 属性就" +"会以“Area”的名称出现在“Collide With”部分中。\n" +"[b]注意：[/b]与根据路径形式的名称而创建的部分不同，[EditorInspector] 不会对根" +"据分组创建的部分的名称进行首字母大写。因此，包含分组用法的属性通常使用首字母" +"大写的名称，而不是 snake_case。" #: doc/classes/EditorInspector.xml msgid "" @@ -27137,6 +27277,9 @@ msgid "" "to [EditorSceneImporterGLTF] within a script will cause an error in an " "exported project." msgstr "" +"[b]注意：[/b]这个类仅在编辑器构建中编译。运行时 glTF 的加载与保存功能在导出后" +"的项目中[i]不可用[/i]。脚本中对 [EditorSceneImporterGLTF] 的引用在导出后的项" +"目中会导致错误。" #: doc/classes/EditorScenePostImport.xml msgid "Post-processes scenes after import." @@ -28432,6 +28575,7 @@ msgid "" msgstr "如果游戏在游戏循环的固定过程和物理阶段内，返回 [code]true[/code]。" #: doc/classes/Engine.xml +#, fuzzy msgid "" "If [code]true[/code], the script is currently running inside the editor. " "This is useful for [code]tool[/code] scripts to conditionally draw editor " @@ -28443,7 +28587,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -29301,44 +29445,50 @@ msgstr "" "屏模糊效果，使其与原始图像的亮度相匹配。" #: doc/classes/Environment.xml +#, fuzzy msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "线性音频映射器操作者。读取线性数据并不加修改地传递。" #: doc/classes/Environment.xml +#, fuzzy msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" "Reinhardt tonemapper运算器。通过这个公式对渲染像素的颜色进行变化。" "[code]color = color / (1 + color)[/code]." #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." -msgstr "胶片色调映射器运算符。" +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." +msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" -"Academy Color Encoding System（学院色彩编码系统）色调映射运算器。对ACES色调映" -"射曲线进行近似计算。" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" -"高质量的 Academy Color Encoding System（学院色彩编码系统）色调映射器，符合行" -"业标准。执行更精确的物理曲线拟合，更好地模拟光线在现实世界中的工作方式。光线" -"和发光材质的颜色会随着发光能量的增加而变浅，如果光线足够亮，足以使相机传感器" -"饱和，最终会变成白色。" #: doc/classes/Environment.xml msgid "Low depth-of-field blur quality (fastest)." @@ -32070,6 +32220,9 @@ msgid "" "loading and saving is [i]not[/i] available in exported projects. References " "to [GLTFAccessor] within a script will cause an error in an exported project." msgstr "" +"[b]注意：[/b]这个类仅在编辑器构建中编译。运行时 glTF 的加载与保存功能在导出后" +"的项目中[i]不可用[/i]。脚本中对 [GLTFAccessor] 的引用在导出后的项目中会导致错" +"误。" #: modules/gltf/doc_classes/GLTFAnimation.xml msgid "" @@ -32078,6 +32231,9 @@ msgid "" "to [GLTFAnimation] within a script will cause an error in an exported " "project." msgstr "" +"[b]注意：[/b]这个类仅在编辑器构建中编译。运行时 glTF 的加载与保存功能在导出后" +"的项目中[i]不可用[/i]。脚本中对 [GLTFAnimation] 的引用在导出后的项目中会导致" +"错误。" #: modules/gltf/doc_classes/GLTFBufferView.xml msgid "" @@ -32086,6 +32242,9 @@ msgid "" "to [GLTFBufferView] within a script will cause an error in an exported " "project." msgstr "" +"[b]注意：[/b]这个类仅在编辑器构建中编译。运行时 glTF 的加载与保存功能在导出后" +"的项目中[i]不可用[/i]。脚本中对 [GLTFBufferView] 的引用在导出后的项目中会导致" +"错误。" #: modules/gltf/doc_classes/GLTFCamera.xml msgid "" @@ -32093,6 +32252,9 @@ msgid "" "loading and saving is [i]not[/i] available in exported projects. References " "to [GLTFCamera] within a script will cause an error in an exported project." msgstr "" +"[b]注意：[/b]这个类仅在编辑器构建中编译。运行时 glTF 的加载与保存功能在导出后" +"的项目中[i]不可用[/i]。脚本中对 [GLTFCamera] 的引用在导出后的项目中会导致错" +"误。" #: modules/gltf/doc_classes/GLTFDocument.xml msgid "" @@ -32100,6 +32262,9 @@ msgid "" "loading and saving is [i]not[/i] available in exported projects. References " "to [GLTFDocument] within a script will cause an error in an exported project." msgstr "" +"[b]注意：[/b]这个类仅在编辑器构建中编译。运行时 glTF 的加载与保存功能在导出后" +"的项目中[i]不可用[/i]。脚本中对 [GLTFDocument] 的引用在导出后的项目中会导致错" +"误。" #: modules/gltf/doc_classes/GLTFLight.xml msgid "" @@ -32107,6 +32272,9 @@ msgid "" "loading and saving is [i]not[/i] available in exported projects. References " "to [GLTFLight] within a script will cause an error in an exported project." msgstr "" +"[b]注意：[/b]这个类仅在编辑器构建中编译。运行时 glTF 的加载与保存功能在导出后" +"的项目中[i]不可用[/i]。脚本中对 [GLTFLight] 的引用在导出后的项目中会导致错" +"误。" #: modules/gltf/doc_classes/GLTFLight.xml msgid "" @@ -32176,6 +32344,8 @@ msgid "" "loading and saving is [i]not[/i] available in exported projects. References " "to [GLTFMesh] within a script will cause an error in an exported project." msgstr "" +"[b]注意：[/b]这个类仅在编辑器构建中编译。运行时 glTF 的加载与保存功能在导出后" +"的项目中[i]不可用[/i]。脚本中对 [GLTFMesh] 的引用在导出后的项目中会导致错误。" #: modules/gltf/doc_classes/GLTFNode.xml msgid "" @@ -32183,6 +32353,8 @@ msgid "" "loading and saving is [i]not[/i] available in exported projects. References " "to [GLTFNode] within a script will cause an error in an exported project." msgstr "" +"[b]注意：[/b]这个类仅在编辑器构建中编译。运行时 glTF 的加载与保存功能在导出后" +"的项目中[i]不可用[/i]。脚本中对 [GLTFNode] 的引用在导出后的项目中会导致错误。" #: modules/gltf/doc_classes/GLTFSkeleton.xml msgid "" @@ -32190,6 +32362,9 @@ msgid "" "loading and saving is [i]not[/i] available in exported projects. References " "to [GLTFSkeleton] within a script will cause an error in an exported project." msgstr "" +"[b]注意：[/b]这个类仅在编辑器构建中编译。运行时 glTF 的加载与保存功能在导出后" +"的项目中[i]不可用[/i]。脚本中对 [GLTFSkeleton] 的引用在导出后的项目中会导致错" +"误。" #: modules/gltf/doc_classes/GLTFSpecGloss.xml msgid "" @@ -32198,6 +32373,9 @@ msgid "" "to [GLTFSpecGloss] within a script will cause an error in an exported " "project." msgstr "" +"[b]注意：[/b]这个类仅在编辑器构建中编译。运行时 glTF 的加载与保存功能在导出后" +"的项目中[i]不可用[/i]。脚本中对 [GLTFSpecGloss] 的引用在导出后的项目中会导致" +"错误。" #: modules/gltf/doc_classes/GLTFState.xml msgid "" @@ -32205,6 +32383,9 @@ msgid "" "loading and saving is [i]not[/i] available in exported projects. References " "to [GLTFState] within a script will cause an error in an exported project." msgstr "" +"[b]注意：[/b]这个类仅在编辑器构建中编译。运行时 glTF 的加载与保存功能在导出后" +"的项目中[i]不可用[/i]。脚本中对 [GLTFState] 的引用在导出后的项目中会导致错" +"误。" #: modules/gltf/doc_classes/GLTFTexture.xml msgid "" @@ -32212,6 +32393,9 @@ msgid "" "loading and saving is [i]not[/i] available in exported projects. References " "to [GLTFTexture] within a script will cause an error in an exported project." msgstr "" +"[b]注意：[/b]这个类仅在编辑器构建中编译。运行时 glTF 的加载与保存功能在导出后" +"的项目中[i]不可用[/i]。脚本中对 [GLTFTexture] 的引用在导出后的项目中会导致错" +"误。" #: modules/mono/doc_classes/GodotSharp.xml msgid "Bridge between Godot and the Mono runtime (Mono-enabled builds only)." @@ -35242,22 +35426,31 @@ msgid "Importing images" msgstr "导入图像" #: doc/classes/Image.xml +#, fuzzy msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" -"将源图像 [code]src[/code] 上的矩形区域 [code]src_rect[/code] 与本图像从坐标 " -"[code]dest[/code] 起的区域进行 Alpha 混合。" +"将源图像 [code]src[/code] 上的矩形区域 [code]src_rect[/code] 复制到本图像从坐" +"标 [code]dst[/code] 起的区域。如果遮罩图 [code]mask[/code] 上某个像素的 " +"Alpha 值非 0，就会把 [code]src[/code] 上对应的像素复制到 [code]dst[/code] " +"上。[code]src[/code] 图像和 [code]mask[/code] 图像的大小（宽度和高度）[b]必须" +"[/b]相同，格式可以不同。" #: doc/classes/Image.xml +#, fuzzy msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" "将源图像 [code]src[/code] 上的矩形区域 [code]src_rect[/code] 与本图像从坐标 " "[code]dst[/code] 起的区域根据遮罩图像 [code]mask[/code] 进行 Alpha 混合。" @@ -35267,21 +35460,30 @@ msgstr "" "须[/b]相同，格式可以不同。" #: doc/classes/Image.xml +#, fuzzy msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" "将源图像 [code]src[/code] 上的矩形区域 [code]src_rect[/code] 复制到本图像从坐" -"标 [code]dst[/code] 起的区域。" +"标 [code]dst[/code] 起的区域。如果遮罩图 [code]mask[/code] 上某个像素的 " +"Alpha 值非 0，就会把 [code]src[/code] 上对应的像素复制到 [code]dst[/code] " +"上。[code]src[/code] 图像和 [code]mask[/code] 图像的大小（宽度和高度）[b]必须" +"[/b]相同，格式可以不同。" #: doc/classes/Image.xml +#, fuzzy msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" "将源图像 [code]src[/code] 上的矩形区域 [code]src_rect[/code] 复制到本图像从坐" "标 [code]dst[/code] 起的区域。如果遮罩图 [code]mask[/code] 上某个像素的 " @@ -36984,10 +37186,13 @@ msgid "Stops the vibration of the joypad." msgstr "停止游戏手柄的振动。" #: doc/classes/Input.xml +#, fuzzy msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" "振动 Android 和 iOS 设备。\n" "[b]注意：[/b]Android 需要导出设置中的 [code]VIBRATE[/code] 权限。 iOS 不支持" @@ -37950,8 +38155,13 @@ msgstr "" "[InputEventJoypadMotion] 事件的方向。" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." -msgstr "返回与给定操作关联的 [InputEvent] 数组。" +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." +msgstr "" #: doc/classes/InputMap.xml msgid "Returns an array of all actions in the [InputMap]." @@ -38137,6 +38347,19 @@ msgstr "相机向其目标移动的速度。较高的值将导致相机的运动 msgid "The target's [NodePath]." msgstr "目标的[NodePath]。" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "网际协议（IP）支持函数，如 DNS 解析。" @@ -40663,8 +40886,10 @@ msgid "A 2D line." msgstr "一条 2D 线。" #: doc/classes/Line2D.xml +#, fuzzy msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -40719,11 +40944,18 @@ msgstr "用提供的[code]position[/code]位置覆盖索引[code]i[/code]处点 #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" -"如果[code]true[/code]，线条的边界将抗锯齿。\n" -"[b]注意：[/b]Line2D在抗锯齿时不会被批量加速。" #: doc/classes/Line2D.xml msgid "" @@ -40961,9 +41193,8 @@ msgid "Returns the selection end column." msgstr "返回选择结束列。" #: doc/classes/LineEdit.xml -#, fuzzy msgid "Returns [code]true[/code] if the user has selected text." -msgstr "如果定时器被停止，返回 [code]true[/code]。" +msgstr "如果用户选中了文本，则返回 [code]true[/code]。" #: doc/classes/LineEdit.xml msgid "Executes a given action as defined in the [enum MenuItems] enum." @@ -42940,6 +43171,41 @@ msgstr "设置图像的大小，需要参考。" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "设置用于绘制的网格，该网格必须使用2D顶点。" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "通用移动VR实现。" @@ -44526,12 +44792,21 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" -"烘焙 [NavigationMesh]。烘焙是在单独的线程中进行的，因为导航的烘焙并不是廉价操" -"作。可以在运行时进行。完成后，会自动设置新的 [NavigationMesh]。" #: doc/classes/NavigationMeshInstance.xml msgid "Determines if the [NavigationMeshInstance] is enabled or disabled." @@ -44746,6 +45021,14 @@ msgstr "" "更改在编辑器或脚本中创建的轮廓。你必须调用 [method " "make_polygons_from_outlines] 来更新多边形。" +#: 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "访问底层 3D 导航的服务器接口。" @@ -45772,6 +46055,7 @@ msgstr "" "是“孤儿”）。" #: doc/classes/Node.xml +#, fuzzy msgid "" "Adds a child node. Nodes can have any number of children, but every child " "must have a unique name. Child nodes are automatically deleted when the " @@ -45790,7 +46074,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -45864,6 +46148,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -46795,6 +47088,7 @@ msgstr "" "code]。" #: doc/classes/Node.xml +#, fuzzy msgid "" "The node owner. A node can have any other node as owner (as long as it is a " "valid parent, grandparent, etc. ascending in the tree). When saving a node " @@ -46803,7 +47097,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -46838,6 +47132,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -46934,12 +47237,19 @@ msgid "Notification received when the node is instanced." msgstr "当该节点被实例化时收到的通知。" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." -msgstr "拖动开始时收到的通知。" +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." +msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." -msgstr "拖动结束时收到的通知。" +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." +msgstr "" #: doc/classes/Node.xml msgid "Notification received when the node's [NodePath] changed." @@ -47729,6 +48039,7 @@ msgstr "" "set_message_translation]和[method tr]。" #: doc/classes/Object.xml +#, fuzzy msgid "" "Connects a [code]signal[/code] to a [code]method[/code] on a [code]target[/" "code] object. Pass optional [code]binds[/code] to the call as an [Array] of " @@ -47736,7 +48047,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -47791,11 +48102,12 @@ msgstr "" "[/codeblock]" #: doc/classes/Object.xml +#, fuzzy msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" "将 [code]信号[/code] 与给定 [code]目标[/code] 上的 [code]方法[/code] 断开。\n" @@ -47910,15 +48222,14 @@ msgstr "" "instance_from_id] 来检索对象实例。" #: doc/classes/Object.xml -#, fuzzy msgid "" "Returns the object's metadata entry for the given [code]name[/code].\n" "Throws error if the entry does not exist, unless [code]default[/code] is not " "[code]null[/code] (in which case the default value will be returned)." msgstr "" -"在给定的位置 [code]position[/code] 返回项目索引。\n" -"当此时没有项目时，如果精确 [code]exact[/code] 是真 [code]true[/code]，则将返" -"回 -1，否则将返回最近的项目索引。" +"返回该对象的名称为给定的 [code]name[/code] 的元数据条目。\n" +"条目不存在时会抛出错误，除非 [code]default[/code] 不为 [code]null[/code]（此" +"时会返回该默认值）。" #: doc/classes/Object.xml msgid "Returns the object's metadata as a [PoolStringArray]." @@ -49202,6 +49513,16 @@ msgstr "" "令时。" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "返回使用的动态内存总量（仅适用于调试）。" @@ -49869,6 +50190,20 @@ msgstr "" "code]。" #: doc/classes/OS.xml +#, fuzzy +msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" +"杀死（终止）由给定的进程 ID（[code]pid[/code]）标识的进程，例如，在非阻塞模式" +"下由 [method execute] 返回的进程。另请参阅 [method crash]。\n" +"[b]注意：[/b]这个方法也可以用来杀死不是由游戏产生的进程。\n" +"[b]注意：[/b]这个方法在 Android、iOS、Linux、macOS 和 Windows 上实现。" + +#: doc/classes/OS.xml msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." @@ -49977,6 +50312,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -50829,6 +51172,9 @@ msgid "" "to [PackedSceneGLTF] within a script will cause an error in an exported " "project." msgstr "" +"[b]注意：[/b]这个类仅在编辑器构建中编译。运行时 glTF 的加载与保存功能在导出后" +"的项目中[i]不可用[/i]。脚本中对 [PackedSceneGLTF] 的引用在导出后的项目中会导" +"致错误。" #: doc/classes/PacketPeer.xml msgid "Abstraction and base class for packet-based protocols." @@ -55014,8 +55360,16 @@ msgid "Sets the weight values for the specified bone." msgstr "设置指定骨骼的权重值." #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." -msgstr "如果为 [code]true[/code],则多边形边缘将抗锯齿." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." +msgstr "" #: doc/classes/Polygon2D.xml msgid "" @@ -55105,12 +55459,14 @@ msgstr "" "如果数量少,则未定义的顶点将使用[code]color[/code]." #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +#, fuzzy +msgid "A pooled array of bytes." msgstr "[Array] 字节集合。" #: doc/classes/PoolByteArray.xml +#, fuzzy msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -55171,6 +55527,16 @@ msgstr "" "函数分配的最大字节数。传入 -1 则不限制输出。传入正数且解压超过该字节数时，会" "返回错误。" +#: 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -55257,13 +55623,15 @@ msgstr "" "负的索引都被认为是从数组的末端开始的。" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +#, fuzzy +msgid "A pooled array of [Color]." msgstr "[Color]的[Array]的集合。" #: doc/classes/PoolColorArray.xml +#, fuzzy msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" "专门用于保存 [Color] 的 [Array]。对内存的使用进行了优化，不会使内存碎片化。\n" @@ -55299,13 +55667,15 @@ msgid "Changes the [Color] at the given index." msgstr "更改给定索引处的[Color]。" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +#, fuzzy +msgid "A pooled array of integers ([int])." msgstr "整数[int]的[Array]的集合。" #: doc/classes/PoolIntArray.xml +#, fuzzy msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -55344,13 +55714,15 @@ msgid "Changes the int at the given index." msgstr "更改给定索引处的 int。" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +#, fuzzy +msgid "A pooled array of reals ([float])." msgstr "实数 [float] 的[Array]集合。" #: doc/classes/PoolRealArray.xml +#, fuzzy msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -55384,12 +55756,14 @@ msgid "Changes the float at the given index." msgstr "更改给定索引处的浮点数。" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +#, fuzzy +msgid "A pooled array of [String]." msgstr "[String] 的 [Array] 集合。" #: doc/classes/PoolStringArray.xml +#, fuzzy msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -55424,12 +55798,14 @@ msgid "Changes the [String] at the given index." msgstr "更改给定索引处的[String]。" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +#, fuzzy +msgid "A pooled array of [Vector2]." msgstr "[Vector2] 的 [Array] 集合。" #: doc/classes/PoolVector2Array.xml +#, fuzzy msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -55461,12 +55837,14 @@ msgid "Changes the [Vector2] at the given index." msgstr "更改给定索引处的 [Vector2]。" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +#, fuzzy +msgid "A pooled array of [Vector3]." msgstr "[Vector3] 的 [Array] 集合。" #: doc/classes/PoolVector3Array.xml +#, fuzzy msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -57561,6 +57939,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "调试GDScript时允许的最大调用堆栈。" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "分析时每个帧允许的最大函数数量。" @@ -57742,13 +58130,12 @@ msgstr "" "时，也使用此参数作为参考。" #: doc/classes/ProjectSettings.xml -#, fuzzy msgid "" "Allows the window to be resizable by default.\n" "[b]Note:[/b] This setting is ignored on iOS." msgstr "" "允许窗口默认可调整大小。\n" -"[b]注意：[/b]这个设置在 iOS 和 Android 上将忽略。" +"[b]注意：[/b]这个设置在 iOS 上将忽略。" #: doc/classes/ProjectSettings.xml msgid "" @@ -58483,9 +58870,8 @@ msgid "Optional name for the 3D render layer 13." msgstr "3D 渲染层 13 的可选名称。" #: doc/classes/ProjectSettings.xml -#, fuzzy msgid "Optional name for the 3D render layer 14." -msgstr "3D 渲染层 14 的可选名称" +msgstr "3D 渲染层 14 的可选名称。" #: doc/classes/ProjectSettings.xml msgid "Optional name for the 3D render layer 15." @@ -60216,9 +60602,16 @@ msgid "" "enable vertex shading on specific materials only.\n" "[b]Note:[/b] This setting does not affect unshaded materials." msgstr "" +"如果为 [code]true[/code]，会强制所有 3D [SpatialMaterial] 和 " +"[ShaderMaterial] 使用顶点着色渲染。可用于在低端移动设备上提升性能。缺点是着色" +"精度会大幅下降，相连的顶点间会有可见的线性插值。可以通过确保网格有足够的细分" +"层级来补偿（但层级不能过多，否则会降低性能）。启用顶点着色时，不支持某些材质" +"特性。\n" +"另请参阅 [member SpatialMaterial.flags_vertex_lighting]，可以仅在特定的材质启" +"用顶点着色。\n" +"[b]注意：[/b]这个设置不会影响未着色材质。" #: doc/classes/ProjectSettings.xml -#, fuzzy msgid "" "Lower-end override for [member rendering/quality/shading/" "force_vertex_shading] on mobile devices, due to performance concerns or " @@ -60226,7 +60619,8 @@ msgid "" "mobile platform, try disabling this setting." msgstr "" "由于性能问题或驱动支持，在移动设备上将对 [member rendering/quality/shading/" -"force_vertex_shading] 以低配数值覆盖。" +"force_vertex_shading] 以低配数值覆盖。如果将项目导出至移动平台后，光照出现问" +"题，请尝试禁用此设置。" #: doc/classes/ProjectSettings.xml msgid "" @@ -60516,10 +60910,199 @@ msgid "" "situations where a change has been made." msgstr "对象可以利用该信号，只在发生修改时才读取设置。" +#: doc/classes/PropertyTweener.xml +#, fuzzy +msgid "Interpolates an [Object]'s property over time." +msgstr "使节点的属性随时间平滑地变化。" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +#, fuzzy +msgid "General-purpose 3D proximity detection node." msgstr "通用的靠近检测节点。" +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." +msgstr "" + #: doc/classes/QuadMesh.xml msgid "Class representing a square mesh." msgstr "表示方形网格的类。" @@ -62841,15 +63424,17 @@ msgid "Adds raw non-BBCode-parsed text to the tag stack." msgstr "将非 BBCode 解析的原始文本添加到标签栈中。" #: doc/classes/RichTextLabel.xml +#, fuzzy msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" "解析 [code]bbcode[/code] 并根据需要将标签添加到标签堆栈中。返回解析结果，成功" "则返回 [constant OK]。\n" @@ -62873,9 +63458,8 @@ msgid "" msgstr "返回标签栈中文本标签的换行总数。将被包裹的文本视为一行。" #: doc/classes/RichTextLabel.xml -#, fuzzy msgid "Returns the current selection text. Does not include BBCodes." -msgstr "返回文本标签的总字符数。不包括 BBCode。" +msgstr "返回当前选中的文本。不包括 BBCode。" #: doc/classes/RichTextLabel.xml msgid "" @@ -62899,13 +63483,16 @@ msgid "Adds a newline tag to the tag stack." msgstr "在标签堆中添加一个换行标签。" #: doc/classes/RichTextLabel.xml +#, fuzzy msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" -"[method append_bbcode] 的指定版本。清除标记堆栈并插入新内容。如果成功解析 " -"[code]bbcode[/code]，则返回 [constant OK]。" +"等待该 [Semaphore]，如果其值为零，则阻塞至非零。\n" +"[b]注意：[/b]这个方法内部是不可能失败的，返回错误码是为了向后兼容，始终为 " +"[constant OK]。" #: doc/classes/RichTextLabel.xml msgid "Parses BBCode parameter [code]expressions[/code] into a dictionary." @@ -65049,6 +65636,10 @@ msgstr "" "计时器将在其时间结束后被自动释放。" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -65074,6 +65665,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "返回一个分配给给定组的所有节点的列表。" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "返回最近收到的RPC调用的发送者的对等ID。" @@ -65512,6 +66109,405 @@ msgstr "剩余时间（单位为秒）。" msgid "Emitted when the timer reaches 0." msgstr "当计时器到 0 时发出。" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +#, fuzzy +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "不管 [SceneTree] 的暂停状态如何，继续 process。" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "作为资源存储的类。" @@ -65857,6 +66853,9 @@ msgid "" "[b]Note:[/b] This method internals' can't possibly fail, but an error code " "is returned for backwards compatibility, which will always be [constant OK]." msgstr "" +"减小 [Semaphore]，允许再进入一个线程。\n" +"[b]注意：[/b]这个方法内部是不可能失败的，返回错误码是为了向后兼容，始终为 " +"[constant OK]。" #: doc/classes/Semaphore.xml msgid "" @@ -65864,6 +66863,8 @@ msgid "" "immediately and returns [constant ERR_BUSY]. If non-zero, it returns " "[constant OK] to report success." msgstr "" +"与 [method wait] 类似，但不会阻塞，所以如果值为零，则会立即失败并返回 " +"[constant ERR_BUSY]。如果非零，则会返回 [constant OK]，表示成功。" #: doc/classes/Semaphore.xml msgid "" @@ -65871,6 +66872,9 @@ msgid "" "[b]Note:[/b] This method internals' can't possibly fail, but an error code " "is returned for backwards compatibility, which will always be [constant OK]." msgstr "" +"等待该 [Semaphore]，如果其值为零，则阻塞至非零。\n" +"[b]注意：[/b]这个方法内部是不可能失败的，返回错误码是为了向后兼容，始终为 " +"[constant OK]。" #: doc/classes/Separator.xml msgid "Base class for separators." @@ -67678,6 +68682,17 @@ msgid "" "[b]Note:[/b] [member flags_vertex_lighting] has no effect if [member " "flags_unshaded] is [code]true[/code]." msgstr "" +"如果为 [code]true[/code]，会按顶点计算光照，而不是按像素。可能在低端设备上提" +"升性能，尤其是针对多边形数量较低的网格。缺点是着色精度会大幅下降，相连的顶点" +"间会有可见的线性插值。可以通过确保网格有足够的细分层级来补偿（但层级不能过" +"多，否则会降低性能）。启用顶点着色时，不支持某些材质特性。\n" +"另请参阅 [member ProjectSettings.rendering/quality/shading/" +"force_vertex_shading]，可以全局启用对所有材质的顶点着色。\n" +"[b]注意：[/b]默认情况下，[member ProjectSettings.rendering/quality/shading/" +"force_vertex_shading] 的 [code]mobile[/code] 覆盖项会强制在移动平台上启用顶点" +"着色。\n" +"[b]注意：[/b]如果 [member flags_unshaded] 为 [code]true[/code]，则 [member " +"flags_vertex_lighting] 无效。" #: doc/classes/SpatialMaterial.xml msgid "" @@ -68576,7 +69591,6 @@ msgid "Numerical input text field." msgstr "数值输入文本字段。" #: doc/classes/SpinBox.xml -#, fuzzy msgid "" "SpinBox is a numerical input text field. It allows entering integers and " "floats.\n" @@ -68608,8 +69622,10 @@ msgstr "" "[/codeblock]\n" "上面的代码将创建一个 [SpinBox]、禁用其上下文菜单，并将文本设置为右对齐。\n" "更多关于 [SpinBox] 的选项请参阅 [Range] 类。\n" -"[b]注意：[/b][SpinBox] 依赖于底层的 [LineEdit] 节点。要为 [SpinBox] 的背景设" -"置主题，请为 [LineEdit] 添加主题项，并对其进行定制。" +"[b]注意：[/b][SpinBox] 依赖于内部的 [LineEdit] 节点。要为 [SpinBox] 的背景设" +"置主题，请为 [LineEdit] 添加主题项，并对其进行定制。\n" +"[b]注意：[/b]如果你想为内部的 [LineEdit] 节点实现拖放操作，可以在 [method " +"get_line_edit] 返回的节点上使用 [method Control.set_drag_forwarding]。" #: doc/classes/SpinBox.xml msgid "Applies the current value of this [SpinBox]." @@ -70212,7 +71228,6 @@ msgstr "" "[code]: / \\ ? * \" | % < >[/code]" #: doc/classes/String.xml -#, fuzzy msgid "" "Returns [code]true[/code] if this string contains a valid float. This is " "inclusive of integers, and also supports exponents:\n" @@ -70229,7 +71244,6 @@ msgstr "" "print(\"1.7\".is_valid_float()) # 输出“True”\n" "print(\"24\".is_valid_float()) # 输出“True”\n" "print(\"7e3\".is_valid_float()) # 输出“True”\n" -"print(\"24\".is_valid_float()) # 输出“True”\n" "print(\"Hello\".is_valid_float()) # 输出“False”\n" "[/codeblock]" @@ -70588,7 +71602,6 @@ msgid "Returns the SHA-256 hash of the string as a string." msgstr "以字符串形式返回字符串的 SHA-256 哈希值。" #: doc/classes/String.xml -#, fuzzy msgid "" "Returns the similarity index ([url=https://en.wikipedia.org/wiki/" "S%C3%B8rensen%E2%80%93Dice_coefficient]Sorensen-Dice coefficient[/url]) of " @@ -70602,8 +71615,8 @@ msgid "" "[/codeblock]" msgstr "" "返回该字符串与另一个字符串的相似指数（[url=https://zh.wikipedia.org/wiki/" -"Dice%E7%B3%BB%E6%95%B0]索伦森-骰子系数[/url]）。1.0 表示完全相似，0.0 表示完" -"全不相似。\n" +"Dice%E7%B3%BB%E6%95%B0]索伦森-骰子系数[/url]）。结果为 1.0 表示完全相似，0.0 " +"表示完全不相似。\n" "[codeblock]\n" "print(\"ABC123\".similarity(\"ABC123\")) # 输出“1”\n" "print(\"ABC123\".similarity(\"XYZ456\")) # 输出“0”\n" @@ -71070,10 +72083,11 @@ msgstr "" "[code]size_right[/code] 和 [code]size_bottom[/code] 像素。" #: doc/classes/StyleBoxFlat.xml +#, fuzzy msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -71167,37 +72181,48 @@ msgstr "切换绘制StyleBox的内部部分。" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" -"在底部边缘的控件矩形之外扩展StyleBox。与 [member border_width_bottom] 结合使" -"用可在控件 rect 外绘制边框。" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" -"在左边缘的控件矩形之外扩展StyleBox。与 [member border_width_left] 结合使用可" -"在控件矩形外绘制边框。" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" -"在右边缘的控件矩形之外扩展StyleBox。与 [member border_width_right] 结合使用可" -"在控件矩形外绘制边框。" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" -"在顶部边缘的控件矩形之外扩展StyleBox。与 [member border_width_top] 结合使用可" -"在控件 rect 外绘制边框。" #: doc/classes/StyleBoxFlat.xml msgid "" @@ -71215,6 +72240,21 @@ msgstr "以像素为单位的阴影偏移。相对于StyleBox调整阴影的位 msgid "The shadow size in pixels." msgstr "以像素为单位的阴影大小。" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "显示单线的 [StyleBox] 。" @@ -72160,19 +73200,19 @@ msgstr "禁用选项卡的样式" #: doc/classes/TCP_Server.xml msgid "A TCP server." -msgstr "TCP服务器。" +msgstr "TCP 服务器。" #: doc/classes/TCP_Server.xml msgid "" "A TCP server. Listens to connections on a port and returns a [StreamPeerTCP] " "when it gets an incoming connection." msgstr "" -"一个TCP服务器。在一个端口上监听连接，当它得到一个传入的连接时返回一个" +"TCP 服务器。会在某个端口上监听连接，并在有连接连入时返回一个 " "[StreamPeerTCP]。" #: doc/classes/TCP_Server.xml msgid "Returns [code]true[/code] if a connection is available for taking." -msgstr "如果有一个连接可用，返回 [code]true[/code]。" +msgstr "如果有连接可供获取，则返回 [code]true[/code]。" #: doc/classes/TCP_Server.xml msgid "" @@ -72224,10 +73264,10 @@ msgid "" "will scroll 5 times as fast as it would normally do. This also works in the " "Godot script editor." msgstr "" -"TextEdit是用来编辑大型多行文本的。它也有编辑代码的功能，如支持语法高亮和多级" +"TextEdit 是用来编辑大型多行文本的。它也有编辑代码的功能，如支持语法高亮和多级" "撤销/重做。\n" -"[b]注意：[/b]当按住[code]Alt[/code]时，垂直滚轮的滚动速度是平时的5倍。这在" -"Godot脚本编辑器中也适用。" +"[b]注意：[/b]当按住 [code]Alt[/code] 时，垂直滚轮的滚动速度是平时的 5 倍。这" +"在 Godot 脚本编辑器中也适用。" #: doc/classes/TextEdit.xml msgid "Adds color region (given the delimiters) and its colors." @@ -72235,7 +73275,7 @@ msgstr "添加给定分隔符划分区域的颜色。" #: doc/classes/TextEdit.xml msgid "Adds a [code]keyword[/code] and its [Color]." -msgstr "添加一个关键字[code]keyword[/code]和它的颜色[Color]。" +msgstr "添加一个关键字 [code]keyword[/code] 和它的颜色 [Color]。" #: doc/classes/TextEdit.xml msgid "" @@ -72248,7 +73288,7 @@ msgid "" "Centers the viewport on the line the editing cursor is at. This also resets " "the [member scroll_horizontal] value to [code]0[/code]." msgstr "" -"将视窗置于编辑光标所在的线上。这也会将 [member scroll_horizontal] 值重置为 " +"将视区置于编辑光标所在的行上。这也会将 [member scroll_horizontal] 值重置为 " "[code]0[/code]。" #: doc/classes/TextEdit.xml @@ -72256,8 +73296,8 @@ msgid "" "Clears all custom syntax coloring information previously added with [method " "add_color_region] or [method add_keyword_color]." msgstr "" -"清除之前用[method add_color_region]或[method add_keyword_color]添加的所有自定" -"义语法着色信息。" +"清除之前用 [method add_color_region] 或 [method add_keyword_color] 添加的所有" +"自定义语法着色信息。" #: doc/classes/TextEdit.xml msgid "Clears the undo history." @@ -72321,7 +73361,7 @@ msgstr "返回一个包含每个断点行号的数组。" #: doc/classes/TextEdit.xml msgid "Returns the [Color] of the specified [code]keyword[/code]." -msgstr "返回指定的关键字[code]keyword[/code]的颜色[Color]。" +msgstr "返回指定的关键字 [code]keyword[/code] 的颜色 [Color]。" #: doc/classes/TextEdit.xml msgid "Returns the text of a specific line." @@ -73590,9 +74630,9 @@ msgid "" "compatibility. Until you set [code]expand[/code] to [code]true[/code], the " "texture will behave like [constant STRETCH_KEEP]." msgstr "" -"缩放以适应节点的边界矩形，只有当[code]expand[/code]为 [code]true[/code] 时生" -"效。默认为[code]stretch_mode[/code]，用于向后兼容。在你将[code]expand[/code]" -"设置为 [code]true[/code]之前，纹理会表现得像[constant STRETCH_KEEP]。" +"缩放以适应节点的边界矩形，只有当 [code]expand[/code] 为 [code]true[/code] 时" +"生效。默认为 [code]stretch_mode[/code]，用于向后兼容。在你将 [code]expand[/" +"code] 设置为 [code]true[/code] 之前，纹理会表现得像 [constant STRETCH_KEEP]。" #: doc/classes/TextureRect.xml msgid "" @@ -73625,6 +74665,9 @@ msgid "" "exists to perform in-memory changes to the resource. Use available " "[code]set_*[/code] methods to add theme items." msgstr "" +"为每一个有效的数据类型都添加一个空主题类型。\n" +"[b]注意：[/b]空类型不会随该主题保存。这个方法的存在是为了对资源执行内存中的更" +"改。请使用 [code]set_*[/code] 方法添加主题项目。" #: doc/classes/Theme.xml msgid "Clears all values on the theme." @@ -73972,6 +75015,8 @@ msgid "" "type is a variation, this information is also erased. If the type is a base " "for type variations, those variations lose their base." msgstr "" +"移除该主题类型，优雅地丢弃其中定义的主题项目。如果该类型为变种，则该信息也会" +"被消除。如果该类型为类型变种的基础类型，则那些变种会失去其基础类型。" #: doc/classes/Theme.xml msgid "" @@ -75136,13 +76181,16 @@ msgid "" msgstr "将给定的 Unix 时间戳转换为 ISO 8601 日期字符串（YYYY-MM-DD）。" #: doc/classes/Time.xml +#, fuzzy msgid "" "Converts the given ISO 8601 date and time string (YYYY-MM-DDTHH:MM:SS) to a " "dictionary of keys: [code]year[/code], [code]month[/code], [code]day[/code], " "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" "将给定的 ISO 8601 日期和时间字符串（YYYY-MM-DDTHH:MM:SS）转换为字典，包含的键" "为：[code]year[/code]、[code]month[/code]、[code]day[/code]、[code]weekday[/" @@ -75319,12 +76367,15 @@ msgstr "" "时区与给定的日期时间字典相同。" #: doc/classes/Time.xml +#, fuzzy msgid "" "Converts the given ISO 8601 date and/or time string to a Unix timestamp. The " "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" "将给定的 ISO 8601 日期和/或时间字符串转换为 Unix 时间戳。字符串中可以只包含日" "期、只包含时间，也可以两者都包含。\n" @@ -75332,10 +76383,13 @@ msgstr "" "时区与给定的日期时间字符串相同。" #: doc/classes/Time.xml +#, fuzzy msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" "返回当前的 Unix 时间戳，以秒为单位，基于 UTC 系统时间。本方法由操作系统实现，" "返回的时间总是 UTC 的。" @@ -75792,23 +76846,27 @@ msgid "" msgstr "返回使用正交基（90 度）以及归一化的轴向量（缩放为 1 或 -1）的变换。" #: doc/classes/Transform.xml +#, fuzzy msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" "使用矩阵乘法，将变换围绕给定的轴旋转给定的角度（单位为弧度）。轴必须是归一化" "的向量。" #: doc/classes/Transform.xml +#, fuzzy msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "使用矩阵乘法，通过给定的缩放系数，对变换的基和原点进行缩放。" #: doc/classes/Transform.xml doc/classes/Transform2D.xml +#, fuzzy msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -75934,14 +76992,17 @@ msgid "Returns the scale." msgstr "返回缩放。" #: doc/classes/Transform2D.xml +#, fuzzy msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "使用矩阵乘法，将变换旋转给定的角度，即弧度。" #: doc/classes/Transform2D.xml +#, fuzzy msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "使用矩阵乘法，用给定的缩放系数来缩放变换。" #: doc/classes/Transform2D.xml @@ -76218,12 +77279,13 @@ msgstr "" "要获得返回的放置部分相对项，请使用[method get_item_at_position]。" #: doc/classes/Tree.xml +#, fuzzy msgid "" "Returns the currently edited item. Can be used with [signal item_edited] to " "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -77129,6 +78191,7 @@ msgid "Smoothly animates a node's properties over time." msgstr "使节点的属性随时间平滑地变化。" #: doc/classes/Tween.xml +#, fuzzy msgid "" "Tweens are useful for animations requiring a numerical property to be " "interpolated over a range of values. The name [i]tween[/i] comes from [i]in-" @@ -77164,7 +78227,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" "需要让数值属性在一定范围内做插值的动画可以使用 Tween。[i]Tween[/i] 这个名字来" "自动画技术 [i]in-betweening[/i]（补间动画）：你指定[i]关键帧[/i]，而计算机则" @@ -77532,6 +78597,23 @@ msgid "" "interpolation is fastest at both ends." msgstr "[constant EASE_IN] and [constant EASE_OUT]的组合。两端的插值最快。" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +#, fuzzy +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "当节点进入树时触发。" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "用于实现 UDP 服务器的辅助类。" @@ -78611,10 +79693,11 @@ msgstr "" "vector2_angle_to.png]返回角度的说明。[/url]" #: doc/classes/Vector2.xml +#, fuzzy msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" "返回连接两点的直线与X轴的夹角，单位为弧度。\n" @@ -78814,9 +79897,10 @@ msgstr "" "量。" #: doc/classes/Vector2.xml +#, fuzzy msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "返回旋转了[code]phi[/code]弧度的向量。参阅[method @GDScript.deg2rad]。" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -78920,9 +80004,10 @@ msgid "Vector used for 3D math." msgstr "用于 3D 数学的向量。" #: doc/classes/Vector3.xml +#, fuzzy msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -79025,9 +80110,10 @@ msgid "Returns this vector reflected from a plane defined by the given normal." msgstr "返回从给定法线定义的平面上反射的向量。" #: doc/classes/Vector3.xml +#, fuzzy msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "将此向量绕给定的轴旋转 [code]phi[/code] 弧度。该轴必须是归一化的向量。" #: doc/classes/Vector3.xml @@ -79759,8 +80845,10 @@ msgstr "如果拖拽操作成功，则返回 [code]true[/code]。" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." -msgstr "如果当前视窗正在执行拖动操作，则返回 [code]true[/code]。" +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." +msgstr "" #: doc/classes/Viewport.xml msgid "" @@ -84960,6 +86048,32 @@ msgstr "设置纹理的路径。" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "如果为 [code]true[/code]，设置内部进程，将所有图像数据缩小到一半大小。" @@ -86075,24 +87189,47 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "在没有底层场景的情况下，单独显示辉光效果。" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." -msgstr "颜色怎么进来就怎么输出。" +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." +msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." -msgstr "使用 Reinhard 色调映射器。" +#, fuzzy +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." +msgstr "" +"Reinhardt tonemapper运算器。通过这个公式对渲染像素的颜色进行变化。" +"[code]color = color / (1 + color)[/code]." #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." -msgstr "使用电影色调映射器。" +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." +msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." -msgstr "使用 ACES 色调映射器。" +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." +msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." -msgstr "使用ACES的拟合色调图。" +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." +msgstr "" #: doc/classes/VisualServer.xml msgid "Lowest quality of screen space ambient occlusion." @@ -89131,7 +90268,7 @@ msgstr "" #: modules/websocket/doc_classes/WebSocketServer.xml msgid "" "Sets additional headers to be sent to clients during the HTTP handshake." -msgstr "" +msgstr "设置在 HTTP 握手期间发送给客户端的额外报头。" #: modules/websocket/doc_classes/WebSocketServer.xml msgid "Stops the server and clear its state." @@ -89220,7 +90357,6 @@ msgid "AR/VR interface using WebXR." msgstr "使用 WebXR 的 AR/VR 接口。" #: modules/webxr/doc_classes/WebXRInterface.xml -#, fuzzy msgid "" "WebXR is an open standard that allows creating VR and AR applications that " "run in the web browser.\n" @@ -89370,6 +90506,9 @@ msgstr "" "\n" " webxr_interface = ARVRServer.find_interface(\"WebXR\")\n" " if webxr_interface:\n" +" # 尽可能映射到标准按钮/轴\n" +" webxr_interface.xr_standard_mapping = true\n" +"\n" " # WebXR使用了大量的异步回调，\n" " # 所以我们要连接各种信号来接收它们。 \n" " webxr_interface.connect(\"session_supported\", self, " @@ -89655,6 +90794,9 @@ msgid "" "standard ids used by other AR/VR interfaces, when possible.\n" "Otherwise, the ids will be passed through unaltered from WebXR." msgstr "" +"如果设为真，会尽可能将按钮及轴的 ID 进行转换，以匹配其他 AR/VR 接口所使用的标" +"准 ID。\n" +"否则，会直接传递来自 WebXR 的 ID，不进行修改。" #: modules/webxr/doc_classes/WebXRInterface.xml msgid "" diff --git a/doc/translations/zh_TW.po b/doc/translations/zh_TW.po index c2418daa16..72e6532ad3 100644 --- a/doc/translations/zh_TW.po +++ b/doc/translations/zh_TW.po @@ -12,12 +12,13 @@ # Nick Chu <nickchu35@gmail.com>, 2021. # Number18 <secretemail7730@gmail.com>, 2022. # 曹恩逢 <nelson22768384@gmail.com>, 2022. +# Otis Kao <momoslim@gmail.com>, 2022. msgid "" msgstr "" "Project-Id-Version: Godot Engine class reference\n" "Report-Msgid-Bugs-To: https://github.com/godotengine/godot\n" -"PO-Revision-Date: 2022-04-10 17:08+0000\n" -"Last-Translator: 曹恩逢 <nelson22768384@gmail.com>\n" +"PO-Revision-Date: 2022-05-03 07:13+0000\n" +"Last-Translator: Otis Kao <momoslim@gmail.com>\n" "Language-Team: Chinese (Traditional) <https://hosted.weblate.org/projects/" "godot-engine/godot-class-reference/zh_Hant/>\n" "Language: zh_TW\n" @@ -25,7 +26,7 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8-bit\n" "Plural-Forms: nplurals=1; plural=0;\n" -"X-Generator: Weblate 4.12-dev\n" +"X-Generator: Weblate 4.12.1\n" #: doc/tools/make_rst.py msgid "Description" @@ -68,17 +69,16 @@ msgid "Method Descriptions" msgstr "方法說明" #: doc/tools/make_rst.py -#, fuzzy msgid "Theme Property Descriptions" -msgstr "屬性說明" +msgstr "主題屬性說明" #: doc/tools/make_rst.py msgid "Inherits:" -msgstr "" +msgstr "繼承:" #: doc/tools/make_rst.py msgid "Inherited By:" -msgstr "" +msgstr "繼承自:" #: doc/tools/make_rst.py msgid "(overrides %s)" @@ -94,7 +94,7 @@ msgstr "Setter" #: doc/tools/make_rst.py msgid "value" -msgstr "" +msgstr "值" #: doc/tools/make_rst.py msgid "Getter" @@ -103,13 +103,13 @@ msgstr "" #: doc/tools/make_rst.py msgid "" "This method should typically be overridden by the user to have any effect." -msgstr "" +msgstr "此方法通常應由用戶覆蓋以產生任何效果。" #: doc/tools/make_rst.py msgid "" "This method has no side effects. It doesn't modify any of the instance's " "member variables." -msgstr "" +msgstr "這種方法沒有副作用。它不會修改任何實例的成員變量。" #: doc/tools/make_rst.py msgid "" @@ -729,7 +729,13 @@ msgid "" " var max_angle = deg2rad(90.0)\n" " rotation = lerp_angle(min_angle, max_angle, elapsed)\n" " elapsed += delta\n" -"[/codeblock]" +"[/codeblock]\n" +"[b]Note:[/b] This method lerps through the shortest path between [code]from[/" +"code] and [code]to[/code]. However, when these two angles are approximately " +"[code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not " +"obvious which way they lerp due to floating-point precision errors. For " +"example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, " +"while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise." msgstr "" #: modules/gdscript/doc_classes/@GDScript.xml @@ -7110,6 +7116,18 @@ msgstr "" #: doc/classes/Array.xml msgid "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements:\n" +"[codeblock]\n" +"var array = []\n" +"array.resize(10)\n" +"array.fill(0) # Initialize the 10 elements to 0.\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Array.xml +msgid "" "Searches the array for a value and returns its index or [code]-1[/code] if " "not found. Optionally, the initial search index can be passed." msgstr "" @@ -8252,6 +8270,16 @@ msgid "" "accordingly without losing proportions." msgstr "" +#: doc/classes/AspectRatioContainer.xml doc/classes/BoxContainer.xml +#: doc/classes/CenterContainer.xml doc/classes/Container.xml +#: doc/classes/GridContainer.xml doc/classes/HBoxContainer.xml +#: doc/classes/HSplitContainer.xml doc/classes/MarginContainer.xml +#: doc/classes/PanelContainer.xml doc/classes/ScrollContainer.xml +#: doc/classes/SplitContainer.xml doc/classes/TabContainer.xml +#: doc/classes/VBoxContainer.xml doc/classes/VSplitContainer.xml +msgid "GUI containers" +msgstr "" + #: doc/classes/AspectRatioContainer.xml msgid "Specifies the horizontal relative position of child controls." msgstr "" @@ -10951,7 +10979,7 @@ msgstr "" #: doc/classes/Basis.xml msgid "" "Constructs a pure rotation basis matrix, rotated around the given " -"[code]axis[/code] by [code]phi[/code], in radians. The axis must be a " +"[code]axis[/code] by [code]angle[/code] (in radians). The axis must be a " "normalized vector." msgstr "" @@ -11021,8 +11049,8 @@ msgstr "" #: doc/classes/Basis.xml msgid "" -"Introduce an additional rotation around the given axis by phi (radians). The " -"axis must be a normalized vector." +"Introduce an additional rotation around the given axis by [code]angle[/code] " +"(in radians). The axis must be a normalized vector." msgstr "" #: doc/classes/Basis.xml @@ -11613,6 +11641,29 @@ msgstr "" msgid "Emitted when one of the buttons of the group is pressed." msgstr "" +#: doc/classes/CallbackTweener.xml +msgid "Calls the specified method after optional delay." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"[CallbackTweener] is used to call a method in a tweening sequence. See " +"[method SceneTreeTween.tween_callback] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_callback] is the only correct way " +"to create [CallbackTweener]. Any [CallbackTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/CallbackTweener.xml +msgid "" +"Makes the callback call delayed by given time in seconds. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback(queue_free).set_delay(2) #this will call queue_free() " +"after 2 seconds\n" +"[/codeblock]" +msgstr "" + #: doc/classes/Camera.xml msgid "Camera node, displays from a point of view." msgstr "" @@ -12373,7 +12424,16 @@ msgstr "" msgid "" "Draws a unfilled arc between the given angles. The larger the value of " "[code]point_count[/code], the smoother the curve. See also [method " -"draw_circle]." +"draw_circle].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedRegularPolygon2D node. That node relies on a texture with custom " +"mipmaps to perform antialiasing. 2D batching is also still supported with " +"those antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12385,21 +12445,41 @@ msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored, unfilled circle. See also [method draw_arc], [method " -"draw_polyline] and [method draw_polygon]." +"draw_polyline] and [method draw_polygon].\n" +"[b]Note:[/b] Built-in antialiasing is not provided for [method draw_circle]. " +"As a workaround, install the [url=https://github.com/godot-extended-" +"libraries/godot-antialiased-line2d]Antialiased Line2D[/url] add-on then " +"create an AntialiasedRegularPolygon2D node. That node relies on a texture " +"with custom mipmaps to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a colored polygon of any amount of points, convex or concave. Unlike " "[method draw_polygon], a single color must be specified for the whole " -"polygon." +"polygon.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml msgid "" "Draws a line from a 2D point to another, with a given color and width. It " "can be optionally antialiased. See also [method draw_multiline] and [method " -"draw_polyline]." +"draw_polyline].\n" +"[b]Note:[/b] Line drawing is not accelerated by batching if " +"[code]antialiased[/code] is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12415,7 +12495,12 @@ msgid "" "draw_line] calls. To draw interconnected lines, use [method draw_polyline] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12427,7 +12512,12 @@ msgid "" "calls. To draw interconnected lines, use [method draw_polyline_colors] " "instead.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are currently " -"not implemented and have no effect." +"not implemented and have no effect. As a workaround, install the " +"[url=https://github.com/godot-extended-libraries/godot-antialiased-" +"line2d]Antialiased Line2D[/url] add-on then create an AntialiasedLine2D " +"node. That node relies on a texture with custom mipmaps to perform " +"antialiasing. 2D batching is also still supported with those antialiased " +"lines." msgstr "" #: doc/classes/CanvasItem.xml @@ -12441,7 +12531,13 @@ msgid "" "Draws a solid polygon of any amount of points, convex or concave. Unlike " "[method draw_colored_polygon], each point's color can be changed " "individually. See also [method draw_polyline] and [method " -"draw_polyline_colors]." +"draw_polyline_colors].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12450,7 +12546,13 @@ msgid "" "[code]width[/code] and optional antialiasing. When drawing large amounts of " "lines, this is faster than using individual [method draw_line] calls. To " "draw disconnected lines, use [method draw_multiline] instead. See also " -"[method draw_polygon]." +"[method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12460,7 +12562,13 @@ msgid "" "line segments match by index between [code]points[/code] and [code]colors[/" "code]. When drawing large amounts of lines, this is faster than using " "individual [method draw_line] calls. To draw disconnected lines, use [method " -"draw_multiline_colors] instead. See also [method draw_polygon]." +"draw_multiline_colors] instead. See also [method draw_polygon].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -12478,10 +12586,16 @@ msgid "" "rectangle will be filled with the [code]color[/code] specified. If " "[code]filled[/code] is [code]false[/code], the rectangle will be drawn as a " "stroke with the [code]color[/code] and [code]width[/code] specified. If " -"[code]antialiased[/code] is [code]true[/code], the lines will be " -"antialiased.\n" +"[code]antialiased[/code] is [code]true[/code], the lines will attempt to " +"perform antialiasing using OpenGL line smoothing.\n" "[b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only " -"effective if [code]filled[/code] is [code]false[/code]." +"effective if [code]filled[/code] is [code]false[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/CanvasItem.xml @@ -15999,9 +16113,11 @@ msgid "" msgstr "" #: doc/classes/Control.xml -#, fuzzy -msgid "Returns [code]true[/code] if drag operation is successful." -msgstr "回傳參數的餘弦值。" +msgid "" +"Returns [code]true[/code] if a drag operation is successful. Alternative to " +"[method Viewport.gui_is_drag_successful].\n" +"Best used with [constant Node.NOTIFICATION_DRAG_END]." +msgstr "" #: doc/classes/Control.xml msgid "" @@ -19634,9 +19750,11 @@ msgstr "" #: doc/classes/Directory.xml msgid "" -"Deletes the target file or an empty directory. The argument can be relative " -"to the current directory, or an absolute path. If the target directory is " -"not empty, the operation will fail.\n" +"Permanently deletes the target file or an empty directory. The argument can " +"be relative to the current directory, or an absolute path. If the target " +"directory is not empty, the operation will fail.\n" +"If you don't want to delete the file/directory permanently, use [method OS." +"move_to_trash] instead.\n" "Returns one of the [enum Error] code constants ([code]OK[/code] on success)." msgstr "" @@ -22829,7 +22947,7 @@ msgid "" "else:\n" " simulate_physics()\n" "[/codeblock]\n" -"See [url=$DOCS_URL/tutorials/misc/running_code_in_the_editor.html]Running " +"See [url=$DOCS_URL/tutorials/plugins/running_code_in_the_editor.html]Running " "code in the editor[/url] in the documentation for more information.\n" "[b]Note:[/b] To detect whether the script is run from an editor [i]build[/i] " "(e.g. when pressing [code]F5[/code]), use [method OS.has_feature] with the " @@ -23524,33 +23642,43 @@ msgstr "" #: doc/classes/Environment.xml msgid "" "Linear tonemapper operator. Reads the linear data and passes it on " -"unmodified." +"unmodified. This can cause bright lighting to look blown out, with " +"noticeable clipping in the output colors." msgstr "" #: doc/classes/Environment.xml msgid "" "Reinhardt tonemapper operator. Performs a variation on rendered pixels' " -"colors by this formula: [code]color = color / (1 + color)[/code]." +"colors by this formula: [code]color = color / (1 + color)[/code]. This " +"avoids clipping bright highlights, but the resulting image can look a bit " +"dull." msgstr "" #: doc/classes/Environment.xml -msgid "Filmic tonemapper operator." +msgid "" +"Filmic tonemapper operator. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"TONE_MAPPER_REINHARDT]." msgstr "" #: doc/classes/Environment.xml msgid "" -"Academy Color Encoding System tonemapper operator. Performs an approximation " -"of the ACES tonemapping curve." +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant TONE_MAPPER_ACES_FITTED], this version of ACES " +"does not handle bright lighting in a physically accurate way. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/Environment.xml msgid "" -"High quality Academy Color Encoding System tonemapper operator that matches " -"the industry standard. Performs a more physically accurate curve fit which " -"better simulates how light works in the real world. The color of lights and " -"emissive materials will become lighter as the emissive energy increases, and " -"will eventually become white if the light is bright enough to saturate the " -"camera sensor." +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant TONE_MAPPER_REINHARDT] " +"and [constant TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/Environment.xml @@ -28298,34 +28426,42 @@ msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"at coordinates [code]dest[/code]." +"at coordinates [code]dest[/code], clipped accordingly to both image bounds. " +"This image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Alpha-blends [code]src_rect[/code] from [code]src[/code] image to this image " -"using [code]mask[/code] image at coordinates [code]dst[/code]. Alpha " -"channels are required for both [code]src[/code] and [code]mask[/code]. " -"[code]dst[/code] pixels and [code]src[/code] pixels will blend if the " -"corresponding mask pixel's alpha value is not 0. [code]src[/code] image and " -"[code]mask[/code] image [b]must[/b] have the same size (width and height) " -"but they can have different formats." +"using [code]mask[/code] image at coordinates [code]dst[/code], clipped " +"accordingly to both image bounds. Alpha channels are required for both " +"[code]src[/code] and [code]mask[/code]. [code]dst[/code] pixels and " +"[code]src[/code] pixels will blend if the corresponding mask pixel's alpha " +"value is not 0. This image and [code]src[/code] image [b]must[/b] have the " +"same format. [code]src[/code] image and [code]mask[/code] image [b]must[/b] " +"have the same size (width and height) but they can have different formats. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Copies [code]src_rect[/code] from [code]src[/code] image to this image at " -"coordinates [code]dst[/code]." +"coordinates [code]dst[/code], clipped accordingly to both image bounds. This " +"image and [code]src[/code] image [b]must[/b] have the same format. " +"[code]src_rect[/code] with not positive size is treated as empty." msgstr "" #: doc/classes/Image.xml msgid "" "Blits [code]src_rect[/code] area from [code]src[/code] image to this image " -"at the coordinates given by [code]dst[/code]. [code]src[/code] pixel is " -"copied onto [code]dst[/code] if the corresponding [code]mask[/code] pixel's " -"alpha value is not 0. [code]src[/code] image and [code]mask[/code] image " -"[b]must[/b] have the same size (width and height) but they can have " -"different formats." +"at the coordinates given by [code]dst[/code], clipped accordingly to both " +"image bounds. [code]src[/code] pixel is copied onto [code]dst[/code] if the " +"corresponding [code]mask[/code] pixel's alpha value is not 0. This image and " +"[code]src[/code] image [b]must[/b] have the same format. [code]src[/code] " +"image and [code]mask[/code] image [b]must[/b] have the same size (width and " +"height) but they can have different formats. [code]src_rect[/code] with not " +"positive size is treated as empty." msgstr "" #: doc/classes/Image.xml @@ -29618,8 +29754,10 @@ msgstr "" #: doc/classes/Input.xml msgid "" "Vibrate Android and iOS devices.\n" -"[b]Note:[/b] It needs [code]VIBRATE[/code] permission for Android at export " -"settings. iOS does not support duration." +"[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." msgstr "" #: doc/classes/Input.xml @@ -30390,7 +30528,12 @@ msgid "" msgstr "" #: doc/classes/InputMap.xml -msgid "Returns an array of [InputEvent]s associated with a given action." +msgid "" +"Returns an array of [InputEvent]s associated with a given action.\n" +"[b]Note:[/b] When used in the editor (e.g. a tool script or [EditorPlugin]), " +"this method will return events for the editor action. If you want to access " +"your project's input binds from the editor, read the [code]input/*[/code] " +"settings from [ProjectSettings]." msgstr "" #: doc/classes/InputMap.xml @@ -30532,6 +30675,19 @@ msgstr "" msgid "The target's [NodePath]." msgstr "" +#: doc/classes/IntervalTweener.xml +msgid "Creates an idle interval in a [SceneTreeTween] animation." +msgstr "" + +#: doc/classes/IntervalTweener.xml +msgid "" +"[IntervalTweener] is used to make delays in a tweening sequence. See [method " +"SceneTreeTween.tween_interval] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_interval] is the only correct way " +"to create [IntervalTweener]. Any [IntervalTweener] created manually will not " +"function correctly." +msgstr "" + #: doc/classes/IP.xml msgid "Internet protocol (IP) support functions such as DNS resolution." msgstr "" @@ -32574,7 +32730,8 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"A line through several points in 2D space.\n" +"A line through several points in 2D space. Supports varying width and color " +"over the line's length, texturing, and several cap/joint types.\n" "[b]Note:[/b] By default, Godot can only draw up to 4,096 polygon points at a " "time. To increase this limit, open the Project Settings and increase [member " "ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb] and " @@ -32618,8 +32775,17 @@ msgstr "" #: doc/classes/Line2D.xml msgid "" -"If [code]true[/code], the line's border will be anti-aliased.\n" -"[b]Note:[/b] Line2D is not accelerated by batching when being anti-aliased." +"If [code]true[/code], the line's border will attempt to perform antialiasing " +"by drawing thin OpenGL smooth lines on the line's edges.\n" +"[b]Note:[/b] Line2D is not accelerated by batching if [member antialiased] " +"is [code]true[/code].\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent lines and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedLine2D node. That node relies on a texture with custom mipmaps to " +"perform antialiasing. 2D batching is also still supported with those " +"antialiased lines." msgstr "" #: doc/classes/Line2D.xml @@ -34459,6 +34625,41 @@ msgstr "" msgid "Sets the mesh used to draw. It must be a mesh using 2D vertices." msgstr "" +#: doc/classes/MethodTweener.xml +msgid "" +"Interpolates an abstract value and supplies it to a method called over time." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"[MethodTweener] is similar to a combination of [CallbackTweener] and " +"[PropertyTweener]. It calls a method providing an interpolated value as a " +"parameter. See [method SceneTreeTween.tween_method] for more usage " +"information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_method] is the only correct way to " +"create [MethodTweener]. Any [MethodTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the time in seconds after which the [MethodTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [SceneTreeTween] that contains this Tweener." +msgstr "" + +#: doc/classes/MethodTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [SceneTreeTween] that contains " +"this Tweener." +msgstr "" + #: modules/mobile_vr/doc_classes/MobileVRInterface.xml msgid "Generic mobile VR implementation." msgstr "" @@ -35788,9 +35989,20 @@ msgstr "" #: doc/classes/NavigationMeshInstance.xml msgid "" -"Bakes the [NavigationMesh]. The baking is done in a separate thread because " -"navigation baking is not a cheap operation. This can be done at runtime. " -"When it is completed, it automatically sets the new [NavigationMesh]." +"Bakes the [NavigationMesh]. If [code]on_thread[/code] is set to [code]true[/" +"code] (default), the baking is done on a separate thread. Baking on separate " +"thread is useful because navigation baking is not a cheap operation. When it " +"is completed, it automatically sets the new [NavigationMesh]. Please note " +"that baking on separate thread may be very slow if geometry is parsed from " +"meshes as async access to each mesh involves heavy synchronization." +msgstr "" + +#: doc/classes/NavigationMeshInstance.xml +msgid "" +"Returns the [RID] of this region on the [NavigationServer]. Combined with " +"[method NavigationServer.map_get_closest_point_owner] can be used to " +"identify the [NavigationMeshInstance] closest to a point on the merged " +"navigation map." msgstr "" #: doc/classes/NavigationMeshInstance.xml @@ -35965,6 +36177,14 @@ msgid "" "[method make_polygons_from_outlines] for the polygons to update." 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 " +"identify the [NavigationPolygonInstance] closest to a point on the merged " +"navigation map." +msgstr "" + #: doc/classes/NavigationServer.xml msgid "Server interface for low-level 3D navigation access." msgstr "" @@ -36749,7 +36969,7 @@ msgid "" "[/codeblock]\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -36790,6 +37010,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Creates a new [SceneTreeTween] and binds it to this node. This is equivalent " +"of doing:\n" +"[codeblock]\n" +"get_tree().create_tween().bind_node(self)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/Node.xml +msgid "" "Duplicates the node, returning a new node.\n" "You can fine-tune the behavior using the [code]flags[/code] (see [enum " "DuplicateFlags]).\n" @@ -37464,7 +37693,7 @@ msgid "" "subinstancing.\n" "[b]Note:[/b] If you want a child to be persisted to a [PackedScene], you " "must set [member owner] in addition to calling [method add_child]. This is " -"typically relevant for [url=$DOCS_URL/tutorials/misc/" +"typically relevant for [url=$DOCS_URL/tutorials/plugins/" "running_code_in_the_editor.html]tool scripts[/url] and [url=$DOCS_URL/" "tutorials/plugins/editor/index.html]editor plugins[/url]. If [method " "add_child] is called without setting [member owner], the newly added [Node] " @@ -37487,6 +37716,15 @@ msgstr "" #: doc/classes/Node.xml msgid "" +"Sets this node's name as a unique name in its [member owner]. This allows " +"the node to be accessed as [code]%Name[/code] instead of the full path, from " +"any node within that scene.\n" +"If another node with the same owner already had that name declared as " +"unique, that other node's name will no longer be set as having a unique name." +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." msgstr "" @@ -37572,11 +37810,18 @@ msgid "Notification received when the node is instanced." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag begins." +msgid "" +"Notification received when a drag operation begins. All nodes receive this " +"notification, not only the dragged one.\n" +"Can be triggered either by dragging a [Control] that provides drag data (see " +"[method Control.get_drag_data]) or using [method Control.force_drag].\n" +"Use [method Viewport.gui_get_drag_data] to get the dragged data." msgstr "" #: doc/classes/Node.xml -msgid "Notification received when a drag ends." +msgid "" +"Notification received when a drag operation ends.\n" +"Use [method Viewport.gui_is_drag_successful] to check if the drag succeeded." msgstr "" #: doc/classes/Node.xml @@ -38159,7 +38404,7 @@ msgid "" "parameter used in the call to [method emit_signal]. Use [code]flags[/code] " "to set deferred or one-shot connections. See [enum ConnectFlags] constants.\n" "A [code]signal[/code] can only be connected once to a [code]method[/code]. " -"It will throw an error if already connected, unless the signal was connected " +"It will print an error if already connected, unless the signal was connected " "with [constant CONNECT_REFERENCE_COUNTED]. To avoid this, first, use [method " "is_connected] to check for existing connections.\n" "If the [code]target[/code] is destroyed in the game's lifecycle, the " @@ -38190,7 +38435,7 @@ msgid "" "Disconnects a [code]signal[/code] from a [code]method[/code] on the given " "[code]target[/code].\n" "If you try to disconnect a connection that does not exist, the method will " -"throw an error. Use [method is_connected] to ensure that the connection " +"print an error. Use [method is_connected] to ensure that the connection " "exists." msgstr "" @@ -39273,6 +39518,16 @@ msgid "" msgstr "" #: doc/classes/OS.xml +msgid "" +"Returns an [Array] of [Rect2], each of which is the bounding rectangle for a " +"display cutout or notch. These are non-functional areas on edge-to-edge " +"screens used by cameras and sensors. Returns an empty array if the device " +"does not have cutouts. See also [method get_window_safe_area].\n" +"[b]Note:[/b] Currently only implemented on Android. Other platforms will " +"return an empty array even if they do have display cutouts or notches." +msgstr "" + +#: doc/classes/OS.xml msgid "Returns the total amount of dynamic memory used (only works in debug)." msgstr "" @@ -39757,6 +40012,15 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Returns [code]true[/code] if the child process ID ([code]pid[/code]) is " +"still running or [code]false[/code] if it has terminated.\n" +"Must be a valid ID generated from [method execute].\n" +"[b]Note:[/b] This method is implemented on Android, iOS, Linux, macOS and " +"Windows." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Returns [code]true[/code] if the input scancode corresponds to a Unicode " "character." msgstr "" @@ -39839,6 +40103,14 @@ msgstr "" #: doc/classes/OS.xml msgid "" +"Moves the file or directory to the system's recycle bin. See also [method " +"Directory.remove].\n" +"[b]Note:[/b] If the user has disabled the recycle bin on their system, the " +"file will be permanently deleted instead." +msgstr "" + +#: doc/classes/OS.xml +msgid "" "Moves the window to the front.\n" "[b]Note:[/b] This method is implemented on Linux, macOS and Windows." msgstr "" @@ -44050,7 +44322,15 @@ msgid "Sets the weight values for the specified bone." msgstr "" #: doc/classes/Polygon2D.xml -msgid "If [code]true[/code], polygon edges will be anti-aliased." +msgid "" +"If [code]true[/code], attempts to perform antialiasing for polygon edges by " +"drawing a thin OpenGL smooth line on the edges.\n" +"[b]Note:[/b] Due to how it works, built-in antialiasing will not look " +"correct for translucent polygons and may not work on certain platforms. As a " +"workaround, install the [url=https://github.com/godot-extended-libraries/" +"godot-antialiased-line2d]Antialiased Line2D[/url] add-on then create an " +"AntialiasedPolygon2D node. That node relies on a texture with custom mipmaps " +"to perform antialiasing." msgstr "" #: doc/classes/Polygon2D.xml @@ -44125,12 +44405,12 @@ msgid "" msgstr "" #: doc/classes/PoolByteArray.xml -msgid "A pooled [Array] of bytes." +msgid "A pooled array of bytes." msgstr "" #: doc/classes/PoolByteArray.xml msgid "" -"An [Array] specifically designed to hold bytes. Optimized for memory usage, " +"An array specifically designed to hold bytes. Optimized for memory usage, " "does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44176,6 +44456,16 @@ msgid "" "decompression exceeds that amount in bytes, then an error will be returned." 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 "" +"Assigns the given value to all elements in the array. This can typically be " +"used together with [method resize] to create an array with a given size and " +"initialized elements." +msgstr "" + #: doc/classes/PoolByteArray.xml msgid "" "Returns a copy of the array's contents as [String]. Fast alternative to " @@ -44243,13 +44533,13 @@ msgid "" msgstr "" #: doc/classes/PoolColorArray.xml -msgid "A pooled [Array] of [Color]." +msgid "A pooled array of [Color]." msgstr "" #: doc/classes/PoolColorArray.xml msgid "" -"An [Array] specifically designed to hold [Color]. Optimized for memory " -"usage, does not fragment the memory.\n" +"An array specifically designed to hold [Color]. Optimized for memory usage, " +"does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44280,13 +44570,13 @@ msgid "Changes the [Color] at the given index." msgstr "" #: doc/classes/PoolIntArray.xml -msgid "A pooled [Array] of integers ([int])." +msgid "A pooled array of integers ([int])." msgstr "" #: doc/classes/PoolIntArray.xml msgid "" -"An [Array] specifically designed to hold integer values ([int]). Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold integer values ([int]). Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it " "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. " @@ -44316,13 +44606,13 @@ msgid "Changes the int at the given index." msgstr "" #: doc/classes/PoolRealArray.xml -msgid "A pooled [Array] of reals ([float])." +msgid "A pooled array of reals ([float])." msgstr "" #: doc/classes/PoolRealArray.xml msgid "" -"An [Array] specifically designed to hold floating-point values. Optimized " -"for memory usage, does not fragment the memory.\n" +"An array specifically designed to hold floating-point values. Optimized for " +"memory usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference.\n" "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in " "[PoolRealArray] are 32-bit floats. This means values stored in " @@ -44348,12 +44638,12 @@ msgid "Changes the float at the given index." msgstr "" #: doc/classes/PoolStringArray.xml -msgid "A pooled [Array] of [String]." +msgid "A pooled array of [String]." msgstr "" #: doc/classes/PoolStringArray.xml msgid "" -"An [Array] specifically designed to hold [String]s. Optimized for memory " +"An array specifically designed to hold [String]s. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44383,12 +44673,12 @@ msgid "Changes the [String] at the given index." msgstr "" #: doc/classes/PoolVector2Array.xml -msgid "A pooled [Array] of [Vector2]." +msgid "A pooled array of [Vector2]." msgstr "" #: doc/classes/PoolVector2Array.xml msgid "" -"An [Array] specifically designed to hold [Vector2]. Optimized for memory " +"An array specifically designed to hold [Vector2]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -44417,12 +44707,12 @@ msgid "Changes the [Vector2] at the given index." msgstr "" #: doc/classes/PoolVector3Array.xml -msgid "A pooled [Array] of [Vector3]." +msgid "A pooled array of [Vector3]." msgstr "" #: doc/classes/PoolVector3Array.xml msgid "" -"An [Array] specifically designed to hold [Vector3]. Optimized for memory " +"An array specifically designed to hold [Vector3]. Optimized for memory " "usage, does not fragment the memory.\n" "[b]Note:[/b] This type is passed by value and not by reference." msgstr "" @@ -46070,6 +46360,16 @@ msgid "Maximum call stack allowed for debugging GDScript." msgstr "" #: doc/classes/ProjectSettings.xml +msgid "" +"If [code]true[/code], enables warnings which can help pinpoint where nodes " +"are being incorrectly updated, which will result in incorrect interpolation " +"and visual glitches.\n" +"When a node is being interpolated, it is essential that the transform is set " +"during [method Node._physics_process] (during a physics tick) rather than " +"[method Node._process] (during a frame)." +msgstr "" + +#: doc/classes/ProjectSettings.xml msgid "Maximum amount of functions per frame allowed when profiling." msgstr "" @@ -48368,8 +48668,195 @@ msgid "" "situations where a change has been made." msgstr "" +#: doc/classes/PropertyTweener.xml +msgid "Interpolates an [Object]'s property over time." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"[PropertyTweener] is used to interpolate a property in an object. See " +"[method SceneTreeTween.tween_property] for more usage information.\n" +"[b]Note:[/b] [method SceneTreeTween.tween_property] is the only correct way " +"to create [PropertyTweener]. Any [PropertyTweener] created manually will not " +"function correctly." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"When called, the final value will be used as a relative value instead. " +"Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2.RIGHT * 100, 1)." +"as_relative() #the node will move by 100 pixels to the right\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets a custom initial value to the [PropertyTweener]. Example:\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(Vector2(100, 100) #this will move the node from position (100, 100) to " +"(200, 100)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Makes the [PropertyTweener] use the current property value (i.e. at the time " +"of creating this [PropertyTweener]) as a starting point. This is equivalent " +"of using [method from] with the current value. These two calls will do the " +"same:\n" +"[codeblock]\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from(position)\n" +"tween.tween_property(self, \"position\", Vector2(200, 100), 1)." +"from_current()\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the time in seconds after which the [PropertyTweener] will start " +"interpolating. By default there's no delay." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used easing from [enum Tween.EaseType]. If not set, the " +"default easing is used from the [Tween] that contains this Tweener." +msgstr "" + +#: doc/classes/PropertyTweener.xml +msgid "" +"Sets the type of used transition from [enum Tween.TransitionType]. If not " +"set, the default transition is used from the [Tween] that contains this " +"Tweener." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "General-purpose 3D proximity detection node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"General-purpose proximity detection node. [ProximityGroup] can be used for " +"[i]approximate[/i] distance checks, which are faster than exact distance " +"checks using [method Vector3.distance_to] or [method Vector3." +"distance_squared_to].\n" +"[ProximityGroup] nodes are automatically grouped together, as long as they " +"share the same [member group_name] and intersect with each other. By calling " +"the [method broadcast], you can invoke a specified method with various " +"parameters to all intersecting members.\n" +"[ProximityGroup] is cuboid-shaped and consists of a cluster of [Vector3] " +"coordinates. The coordinates are automatically calculated by calling [member " +"grid_radius]. To allow [ProximityGroup] to find its peers (and perform " +"automatic grouping), you need to define its [member group_name] to a non-" +"empty [String]. As soon as this object's shape intersects with another " +"[ProximityGroup] object' shape, and both share the same [member group_name], " +"they will belong together for as long as they intersect.\n" +"Since [ProximityGroup] doesn't rely the physics engine, you don't need to " +"add any other node as a child (unlike [PhysicsBody]).\n" +"The [ProximityGroup] uses the [SceneTree] groups in the background by " +"calling the method [method Node.add_to_group] internally. The [SceneTree] " +"group names are constructed by combining the [member group_name] with its " +"coordinates, which are calculated using the [member grid_radius] you defined " +"beforehand.\n" +"[b]Example:[/b] A [ProximityGroup] node named [code]\"PlanetEarth\"[/code] " +"at position [code]Vector3(6, 6, 6)[/code] with a [member group_name] set to " +"[code]\"planets\"[/code] and a [member grid_radius] of [code]Vector3(1, 2, 3)" +"[/code] will create the following [SceneTree] group names:\n" +"[codeblock]\n" +"- \"planets|5|4|3\"\n" +"- \"planets|5|4|4\"\n" +"- \"planets|5|4|5\"\n" +"- \"planets|5|4|6\"\n" +"- \"planets|5|4|7\"\n" +"- \"planets|5|4|8\"\n" +"- \"planets|5|4|9\"\n" +"- ...\n" +"[/codeblock]\n" +"If there is another [ProximityGroup] named [code]\"PlanetMars\"[/code] with " +"group name [code]\"planets\"[/code], and one of its coordinates is " +"[code]Vector3(5, 4, 7)[/code], it would normally create the [SceneTree] " +"group called [code]\"planets|5|4|7\"[/code]. However, since this group name " +"already exists, this [ProximityGroup] object will be [i]added[/i] to the " +"existing one. [code]\"PlanetEarth\"[/code] is already in this group. As long " +"as both nodes don't change their transform and stop intersecting (or exit " +"the scene tree), they are grouped together. As long as this intersection " +"exists, any call to [method broadcast] will affect [i]both[/i] " +"[ProximityGroup] nodes.\n" +"There are 3 caveats to keep in mind when using [ProximityGroup]:\n" +"- The larger the grid radius, the more coordinates and the more [SceneTree] " +"groups are created. This can have a performance impact if too many groups " +"are created.\n" +"- If the [ProximityGroup] node is transformed in any way (or is removed from " +"the scene tree), the groupings will have to be recalculated. This can also " +"have a performance impact.\n" +"- 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 " +"fast enough too, especially if you call them less often using a [Timer] node." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Calls on all intersecting [ProximityGroup] the given method and parameters.\n" +"If the [member dispatch_mode] is set to [constant MODE_PROXY] (the default), " +"all calls are delegated to their respective parent [Node]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specifies which node gets contacted on a call of method [method broadcast]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"The size of the space in 3D units. This also sets the amount of coordinates " +"required to calculate whether two [ProximityGroup] nodes are intersecting or " +"not. Smaller [member grid_radius] values can be used for more precise " +"proximity checks at the cost of performance, since more groups will be " +"created." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Specify the common group name, to let other [ProximityGroup] nodes know, if " +"they should be auto-grouped with this node in case they intersect with each " +"other.\n" +"For example, if you have a [ProximityGroup] node named [code]\"Earth\"[/" +"code] and another called [code]\"Mars\"[/code], with both nodes having " +"[code]\"planet\"[/code] as their [member group_name]. Give both planets a " +"significantly larger [member grid_radius] than their actual radius, position " +"them close enough and they'll be automatically grouped." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "" +"Emitted when the user calls the [method broadcast] method and has set " +"[member dispatch_mode] to [constant MODE_SIGNAL].\n" +"The given method and its parameters are passed on to the listeners who " +"connected to this signal of this object, as well as any [ProximityGroup] " +"node this node is grouped together with.\n" +"[b]Note:[/b] This signal is [i]not[/i] emitted by default, as the default " +"[member dispatch_mode] is [constant MODE_PROXY]." +msgstr "" + +#: doc/classes/ProximityGroup.xml +msgid "This [ProximityGroup]'s parent will be target of [method broadcast]." +msgstr "" + #: doc/classes/ProximityGroup.xml -msgid "General-purpose proximity detection node." +msgid "" +"This [ProximityGroup] will emit the [signal broadcast] [i]signal[/i] when " +"calling the [method broadcast] [i]method[/i]." msgstr "" #: doc/classes/QuadMesh.xml @@ -50162,14 +50649,15 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" -"Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns " -"the result of the parsing, [constant OK] if successful.\n" +"Parses [code]bbcode[/code] and adds tags to the tag stack as needed.\n" "[b]Note:[/b] Using this method, you can't close a tag that was opened in a " "previous [method append_bbcode] call. This is done to improve performance, " "especially when updating large RichTextLabels since rebuilding the whole " "BBCode every time would be slower. If you absolutely need to close a tag in " "a future method call, append the [member bbcode_text] instead of using " -"[method append_bbcode]." +"[method append_bbcode].\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -50214,8 +50702,9 @@ msgstr "" #: doc/classes/RichTextLabel.xml msgid "" "The assignment version of [method append_bbcode]. Clears the tag stack and " -"inserts the new content. Returns [constant OK] if parses [code]bbcode[/code] " -"successfully." +"inserts the new content.\n" +"[b]Note:[/b] This method internals' can't possibly fail, but an error code " +"is returned for backwards compatibility, which will always be [constant OK]." msgstr "" #: doc/classes/RichTextLabel.xml @@ -51815,6 +52304,10 @@ msgid "" msgstr "" #: doc/classes/SceneTree.xml +msgid "Creates and returns a new [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "" "Returns the current frame number, i.e. the total frame count since the " "application started." @@ -51839,6 +52332,12 @@ msgid "Returns a list of all nodes assigned to the given group." msgstr "" #: doc/classes/SceneTree.xml +msgid "" +"Returns an array of currently existing [SceneTreeTween]s in the [SceneTree] " +"(both running and paused)." +msgstr "" + +#: doc/classes/SceneTree.xml msgid "Returns the sender's peer ID for the most recently received RPC call." msgstr "" @@ -52193,6 +52692,404 @@ msgstr "" msgid "Emitted when the timer reaches 0." msgstr "" +#: doc/classes/SceneTreeTween.xml +msgid "" +"Lightweight object used for general-purpose animation via script, using " +"[Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"[SceneTreeTween] is a tween managed by the scene tree. As opposed to " +"[Tween], it does not require the instantiation of a node.\n" +"[SceneTreeTween]s are more light-weight than [AnimationPlayer], so they are " +"very much suited for simple animations or general tasks that don't require " +"visual tweaking provided by the editor. They can be used in a fire-and-" +"forget manner for some logic that normally would be done by code. You can e." +"g. make something shoot periodically by using a looped [CallbackTweener] " +"with a delay.\n" +"A [SceneTreeTween] can be created by using either [method SceneTree." +"create_tween] or [method Node.create_tween]. [SceneTreeTween]s created " +"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" +"[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" +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_property($Sprite, \"modulate\", Color.red, 1).set_trans(Tween." +"TRANS_SINE)\n" +"tween.tween_property($Sprite, \"scale\", Vector2(), 1).set_trans(Tween." +"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" +"[codeblock]\n" +"var tween = get_tree().create_tween().bind_node(self).set_trans(Tween." +"TRANS_ELASTIC)\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" +"Another interesting use for [SceneTreeTween]s is animating arbitrary set of " +"objects:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"for sprite in get_children():\n" +" tween.tween_property(sprite, \"position\", Vector2(), 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." +"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 " +"controls where the [code]trans_type[/code] is applied to the interpolation " +"(in the beginning, the end, or both). If you don't know which transition and " +"easing to pick, you can try different [enum Tween.TransitionType] constants " +"with [constant Tween.EASE_IN_OUT], and use the one that looks best.\n" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Binds this [SceneTreeTween] with the given [code]node[/code]. " +"[SceneTreeTween]s are processed directly by the [SceneTree], so they run " +"independently of the animated nodes. When you bind a [Node] with the " +"[SceneTreeTween], the [SceneTreeTween] will halt the animation when the " +"object is not inside tree and the [SceneTreeTween] will be automatically " +"killed when the bound object is freed. Also [constant TWEEN_PAUSE_BOUND] " +"will make the pausing behavior dependent on the bound node.\n" +"For a shorter way to create and bind a [SceneTreeTween], you can use [method " +"Node.create_tween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Used to chain two [Tweener]s after [method set_parallel] is called with " +"[code]true[/code].\n" +"[codeblock]\n" +"var tween = create_tween().set_parallel(true)\n" +"tween.tween_property(...)\n" +"tween.tween_property(...) # Will run parallelly with above.\n" +"tween.chain().tween_property(...) # Will run after two above are finished.\n" +"[/codeblock]" +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" +"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." +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" +"[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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"This method can be used for manual interpolation of a value, when you don't " +"want [SceneTreeTween] to do animating for you. It's similar to [method " +"@GDScript.lerp], but with support for custom transition and easing.\n" +"[code]initial_value[/code] is the starting value of the interpolation.\n" +"[code]delta_value[/code] is the change of the value in the interpolation, i." +"e. it's equal to [code]final_value - initial_value[/code].\n" +"[code]elapsed_time[/code] is the time in seconds that passed after the " +"interpolation started and it's used to control the position of the " +"interpolation. E.g. when it's equal to half of the [code]duration[/code], " +"the interpolated value will be halfway between initial and final values. " +"This value can also be greater than [code]duration[/code] or lower than 0, " +"which will extrapolate the value.\n" +"[code]duration[/code] is the total time of the interpolation.\n" +"[b]Note:[/b] If [code]duration[/code] is equal to [code]0[/code], the method " +"will always return the final value, regardless of [code]elapsed_time[/code] " +"provided." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Returns whether the [SceneTreeTween] is currently running, i.e. it wasn't " +"paused and it's not finished." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Aborts all tweening operations and invalidates the [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Makes the next [Tweener] run parallelly to the previous one. Example:\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"tween.parallel().tween_property(...)\n" +"[/codeblock]\n" +"All [Tweener]s in the example will run at the same time.\n" +"You can make the [SceneTreeTween] parallel by default by using [method " +"set_parallel]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Pauses the tweening. The animation can be resumed by using [method play]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "Resumes a paused or stopped [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default ease type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[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 " +"[SceneTreeTween]'s lifetime depends on some node, always use [method " +"bind_node]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If [code]parallel[/code] is [code]true[/code], the [Tweener]s appended after " +"this method will by default run simultaneously, as opposed to sequentially." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines the behavior of the [SceneTreeTween] when the [SceneTree] is " +"paused. Check [enum TweenPauseMode] for options.\n" +"Default value is [constant TWEEN_PAUSE_BOUND]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Determines whether the [SceneTreeTween] should run during idle frame (see " +"[method Node._process]) or physics frame (see [method Node." +"_physics_process].\n" +"Default value is [constant Tween.TWEEN_PROCESS_IDLE]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Scales the speed of tweening. This affects all [Tweener]s and their delays." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Sets the default transition type for [PropertyTweener]s and [MethodTweener]s " +"animated by this [SceneTreeTween]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Stops the tweening and resets the [SceneTreeTween] to its initial state. " +"This will not remove any appended [Tweener]s." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [CallbackTweener]. This method can be used to call an " +"arbitrary method in any object. Use [code]binds[/code] to bind additional " +"arguments for the call.\n" +"Example: object that keeps shooting every 1 second.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween().set_loops()\n" +"tween.tween_callback(self, \"shoot\").set_delay(1)\n" +"[/codeblock]\n" +"Example: turning a sprite red and then blue, with 2 second delay.\n" +"[codeblock]\n" +"var tween = get_tree().create_tween()\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.red]).set_delay(2)\n" +"tween.tween_callback($Sprite, \"set_modulate\", [Color.blue]).set_delay(2)\n" +"[/codeblock]" +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" +"Example: creating an interval in code execution.\n" +"[codeblock]\n" +"# ... some code\n" +"yield(create_tween().tween_interval(2), \"finished\")\n" +"# ... more code\n" +"[/codeblock]\n" +"Example: creating an object that moves back and forth and jumps every few " +"seconds.\n" +"[codeblock]\n" +"var tween = create_tween().set_loops()\n" +"tween.tween_property($Sprite, \"position:x\", 200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"tween.tween_property($Sprite, \"position:x\", -200.0, 1).as_relative()\n" +"tween.tween_callback(self, \"jump\")\n" +"tween.tween_interval(2)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"Creates and appends a [MethodTweener]. This method is similar to a " +"combination of [method tween_callback] and [method tween_property]. It calls " +"a method over time with a tweened value provided as an argument. The value " +"is tweened between [code]from[/code] and [code]to[/code] over the time " +"specified by [code]duration[/code], in seconds. Use [code]binds[/code] to " +"bind additional arguments for the call. You can use [method MethodTweener." +"set_ease] and [method MethodTweener.set_trans] to tweak the easing and " +"transition of the value or [method MethodTweener.set_delay] to delay the " +"tweening.\n" +"Example: making a 3D object look from one point to another point.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_method(self, \"look_at\", Vector3(-1, 0, -1), Vector3(1, 0, -1), " +"1, [Vector3.UP]) # The look_at() method takes up vector as second argument.\n" +"[/codeblock]\n" +"Example: setting a text of a [Label], using an intermediate method and after " +"a delay.\n" +"[codeblock]\n" +"func _ready():\n" +" var tween = create_tween()\n" +" tween.tween_method(self, \"set_label_text\", 0, 10, 1).set_delay(1)\n" +"\n" +"func set_label_text(value: int):\n" +" $Label.text = \"Counting \" + str(value)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2(100, 200), 1)\n" +"tween.tween_property($Sprite, \"position\", Vector2(200, 300), 1)\n" +"[/codeblock]\n" +"will move the sprite to position (100, 200) and then to (200, 300). If you " +"use [method PropertyTweener.from] or [method PropertyTweener.from_current], " +"the starting position will be overwritten by the given value instead. See " +"other methods in [PropertyTweener] to see how the tweening can be tweaked " +"further.\n" +"[b]Note:[/b] You can find the correct property name by hovering over the " +"property in the Inspector. You can also provide the components of a property " +"directly by using [code]\"property:component\"[/code] (eg. [code]position:x[/" +"code]), where it would only apply to that particular component.\n" +"Example: moving object twice from the same position, with different " +"transition types.\n" +"[codeblock]\n" +"var tween = create_tween()\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().set_trans(Tween.TRANS_SINE)\n" +"tween.tween_property($Sprite, \"position\", Vector2.RIGHT * 300, 1)." +"as_relative().from_current().set_trans(Tween.TRANS_EXPO)\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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]." +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 " +"finished] instead for this case." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +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." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"If the [SceneTreeTween] has a bound node, it will process when that node can " +"process (see [member Node.pause_mode]). Otherwise it's the same as [constant " +"TWEEN_PAUSE_STOP]." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "If [SceneTree] is paused, the [SceneTreeTween] will also pause." +msgstr "" + +#: doc/classes/SceneTreeTween.xml +msgid "" +"The [SceneTreeTween] will process regardless of whether [SceneTree] is " +"paused." +msgstr "" + #: doc/classes/Script.xml msgid "A class stored as a resource." msgstr "" @@ -56720,7 +57617,7 @@ msgstr "" msgid "" "Antialiasing draws a small ring around the edges, which fades to " "transparency. As a result, edges look much smoother. This is only noticeable " -"when using rounded corners.\n" +"when using rounded corners or [member skew].\n" "[b]Note:[/b] When using beveled corners with 45-degree angles ([member " "corner_detail] = 1), it is recommended to set [member anti_aliasing] to " "[code]false[/code] to ensure crisp visuals and avoid possible visual " @@ -56804,28 +57701,47 @@ msgstr "" msgid "" "Expands the stylebox outside of the control rect on the bottom edge. Useful " "in combination with [member border_width_bottom] to draw a border outside " -"the control rect." +"the control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_bottom], [member " +"expand_margin_bottom] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the left edge. Useful in " "combination with [member border_width_left] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_left], [member " +"expand_margin_left] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the right edge. Useful " "in combination with [member border_width_right] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_right], [member " +"expand_margin_right] does [i]not[/i] affect the size of the clickable area " +"for [Control]s. This can negatively impact usability if used wrong, as the " +"user may try to click an area of the StyleBox that cannot actually receive " +"clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml msgid "" "Expands the stylebox outside of the control rect on the top edge. Useful in " "combination with [member border_width_top] to draw a border outside the " -"control rect." +"control rect.\n" +"[b]Note:[/b] Unlike [member StyleBox.content_margin_top], [member " +"expand_margin_top] does [i]not[/i] affect the size of the clickable area for " +"[Control]s. This can negatively impact usability if used wrong, as the user " +"may try to click an area of the StyleBox that cannot actually receive clicks." msgstr "" #: doc/classes/StyleBoxFlat.xml @@ -56844,6 +57760,21 @@ msgstr "" msgid "The shadow size in pixels." msgstr "" +#: doc/classes/StyleBoxFlat.xml +msgid "" +"If set to a non-zero value on either axis, [member skew] distorts the " +"StyleBox horizontally and/or vertically. This can be used for \"futuristic\"-" +"style UIs. Positive values skew the StyleBox towards the right (X axis) and " +"upwards (Y axis), while negative values skew the StyleBox towards the left " +"(X axis) and downwards (Y axis).\n" +"[b]Note:[/b] To ensure text does not touch the StyleBox's edges, consider " +"increasing the [StyleBox]'s content margin (see [member StyleBox." +"content_margin_bottom]). It is preferable to increase the content margin " +"instead of the expand margin (see [member expand_margin_bottom]), as " +"increasing the expand margin does not increase the size of the clickable " +"area for [Control]s." +msgstr "" + #: doc/classes/StyleBoxLine.xml msgid "[StyleBox] that displays a single line." msgstr "" @@ -60100,7 +61031,9 @@ msgid "" "[code]weekday[/code], [code]hour[/code], [code]minute[/code], and " "[code]second[/code].\n" "If [code]weekday[/code] is false, then the [code]weekday[/code] entry is " -"excluded (the calculation is relatively expensive)." +"excluded (the calculation is relatively expensive).\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml @@ -60230,14 +61163,18 @@ msgid "" "string can contain a date only, a time only, or both.\n" "[b]Note:[/b] Unix timestamps are often in UTC. This method does not do any " "timezone conversion, so the timestamp will be in the same timezone as the " -"given datetime string." +"given datetime string.\n" +"[b]Note:[/b] Any decimal fraction in the time string will be ignored " +"silently." msgstr "" #: doc/classes/Time.xml msgid "" "Returns the current Unix timestamp in seconds based on the system time in " "UTC. This method is implemented by the operating system and always returns " -"the time in UTC." +"the time in UTC.\n" +"[b]Note:[/b] Unlike other methods that use integer timestamps, this method " +"returns the timestamp as a [float] for sub-second precision." msgstr "" #: doc/classes/Time.xml @@ -60632,20 +61569,21 @@ msgstr "" #: doc/classes/Transform.xml msgid "" -"Rotates the transform around the given axis by the given angle (in radians), " -"using matrix multiplication. The axis must be a normalized vector." +"Returns a copy of the transform rotated around the given [code]axis[/code] " +"by the given [code]angle[/code] (in radians), using matrix multiplication. " +"The [code]axis[/code] must be a normalized vector." msgstr "" #: doc/classes/Transform.xml msgid "" -"Scales basis and origin of the transform by the given scale factor, using " -"matrix multiplication." +"Returns a copy of the transform with its basis and origin scaled by the " +"given [code]scale[/code] factor, using matrix multiplication." msgstr "" #: doc/classes/Transform.xml doc/classes/Transform2D.xml msgid "" -"Translates the transform by the given offset, relative to the transform's " -"basis vectors.\n" +"Returns a copy of the transform translated by the given [code]offset[/code], " +"relative to the transform's basis vectors.\n" "Unlike [method rotated] and [method scaled], this does not use matrix " "multiplication." msgstr "" @@ -60751,13 +61689,14 @@ msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Rotates the transform by the given angle (in radians), using matrix " -"multiplication." +"Returns a copy of the transform rotated by the given [code]angle[/code] (in " +"radians), using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml msgid "" -"Scales the transform by the given scale factor, using matrix multiplication." +"Returns a copy of the transform scaled by the given [code]scale[/code] " +"factor, using matrix multiplication." msgstr "" #: doc/classes/Transform2D.xml @@ -60988,7 +61927,7 @@ msgid "" "get the item that was modified.\n" "[codeblock]\n" "func _ready():\n" -" $Tree.item_edited.connect(on_Tree_item_edited)\n" +" $Tree.connect(\"item_edited\", self, \"on_Tree_item_edited\")\n" "\n" "func on_Tree_item_edited():\n" " print($Tree.get_edited()) # This item just got edited (e.g. checked).\n" @@ -61825,7 +62764,9 @@ msgid "" "[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" "tween_cheatsheet.png]Tween easing and transition types cheatsheet[/url]\n" "[b]Note:[/b] Tween methods will return [code]false[/code] if the requested " -"operation cannot be completed." +"operation cannot be completed.\n" +"[b]Note:[/b] For an alternative method of tweening, that doesn't require " +"using nodes, see [SceneTreeTween]." msgstr "" #: doc/classes/Tween.xml @@ -62102,6 +63043,22 @@ msgid "" "interpolation is fastest at both ends." msgstr "" +#: doc/classes/Tweener.xml +msgid "Abstract class for all Tweeners used by [SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "" +"Tweeners are objects that perform a specific animating task, e.g. " +"interpolating a property or calling a method at a given time. A [Tweener] " +"can't be created manually, you need to use a dedicated method from " +"[SceneTreeTween]." +msgstr "" + +#: doc/classes/Tweener.xml +msgid "Emitted when the [Tweener] has just finished its job." +msgstr "" + #: doc/classes/UDPServer.xml msgid "Helper class to implement a UDP server." msgstr "" @@ -62894,7 +63851,7 @@ msgstr "" msgid "" "Returns the angle between the line connecting the two points and the X axis, " "in radians.\n" -"[url=https://raw.githubusercontent.com/godotengine/godot-docs/master/img/" +"[url=https://raw.githubusercontent.com/godotengine/godot-docs/stable/img/" "vector2_angle_to_point.png]Illustration of the returned angle.[/url]" msgstr "" @@ -63056,8 +64013,8 @@ msgstr "" #: doc/classes/Vector2.xml msgid "" -"Returns the vector rotated by [code]phi[/code] radians. See also [method " -"@GDScript.deg2rad]." +"Returns the vector rotated by [code]angle[/code] (in radians). See also " +"[method @GDScript.deg2rad]." msgstr "" #: doc/classes/Vector2.xml doc/classes/Vector3.xml @@ -63155,7 +64112,7 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" "3-element structure that can be used to represent positions in 3D space or " -"any other pair of numeric values.\n" +"any other triplet of numeric values.\n" "[b]Note:[/b] In a boolean context, a Vector3 will evaluate to [code]false[/" "code] if it's equal to [code]Vector3(0, 0, 0)[/code]. Otherwise, a Vector3 " "will always evaluate to [code]true[/code]." @@ -63240,8 +64197,8 @@ msgstr "" #: doc/classes/Vector3.xml msgid "" -"Rotates this vector around a given axis by [code]phi[/code] radians. The " -"axis must be a normalized vector." +"Rotates this vector around a given axis by [code]angle[/code] (in radians). " +"The axis must be a normalized vector." msgstr "" #: doc/classes/Vector3.xml @@ -63837,7 +64794,9 @@ msgstr "回傳參數的餘弦值。" #: doc/classes/Viewport.xml msgid "" "Returns [code]true[/code] if the viewport is currently performing a drag " -"operation." +"operation.\n" +"Alternative to [constant Node.NOTIFICATION_DRAG_BEGIN] and [constant Node." +"NOTIFICATION_DRAG_END] when you prefer polling the value." msgstr "" #: doc/classes/Viewport.xml @@ -68300,6 +69259,32 @@ msgstr "" #: doc/classes/VisualServer.xml msgid "" +"Creates an update link between two textures, similar to how " +"[ViewportTexture]s operate. When the base texture is the texture of a " +"[Viewport], every time the viewport renders a new frame, the proxy texture " +"automatically receives an update.\n" +"For example, this code links a generic [ImageTexture] to the texture output " +"of the [Viewport] using the VisualServer API:\n" +"[codeblock]\n" +"func _ready():\n" +" var viewport_rid = get_viewport().get_viewport_rid()\n" +" var viewport_texture_rid = VisualServer." +"viewport_get_texture(viewport_rid)\n" +"\n" +" var proxy_texture = ImageTexture.new()\n" +" var viewport_texture_image_data = VisualServer." +"texture_get_data(viewport_texture_rid)\n" +"\n" +" proxy_texture.create_from_image(viewport_texture_image_data)\n" +" var proxy_texture_rid = proxy_texture.get_rid()\n" +" VisualServer.texture_set_proxy(proxy_texture_rid, viewport_texture_rid)\n" +"\n" +" $TextureRect.texture = proxy_texture\n" +"[/codeblock]" +msgstr "" + +#: doc/classes/VisualServer.xml +msgid "" "If [code]true[/code], sets internal processes to shrink all image data to " "half the size." msgstr "" @@ -69349,23 +70334,43 @@ msgid "Shows the glow effect by itself without the underlying scene." msgstr "" #: doc/classes/VisualServer.xml -msgid "Output color as they came in." +msgid "" +"Output color as they came in. This can cause bright lighting to look blown " +"out, with noticeable clipping in the output colors." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the Reinhard tonemapper." +msgid "" +"Use the Reinhard tonemapper. Performs a variation on rendered pixels' colors " +"by this formula: [code]color = color / (1 + color)[/code]. This avoids " +"clipping bright highlights, but the resulting image can look a bit dull." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the filmic tonemapper." +msgid "" +"Use the filmic tonemapper. This avoids clipping bright highlights, with a " +"resulting image that usually looks more vivid than [constant " +"ENV_TONE_MAPPER_REINHARD]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES tonemapper." +msgid "" +"Use the legacy Godot version of the Academy Color Encoding System " +"tonemapper. Unlike [constant ENV_TONE_MAPPER_ACES_FITTED], this version of " +"ACES does not handle bright lighting in a physically accurate way. ACES " +"typically has a more contrasted output compared to [constant " +"ENV_TONE_MAPPER_REINHARD] and [constant ENV_TONE_MAPPER_FILMIC].\n" +"[b]Note:[/b] This tonemapping operator will be removed in Godot 4.0 in favor " +"of the more accurate [constant ENV_TONE_MAPPER_ACES_FITTED]." msgstr "" #: doc/classes/VisualServer.xml -msgid "Use the ACES Fitted tonemapper." +msgid "" +"Use the Academy Color Encoding System tonemapper. ACES is slightly more " +"expensive than other options, but it handles bright lighting in a more " +"realistic fashion by desaturating it as it becomes brighter. ACES typically " +"has a more contrasted output compared to [constant ENV_TONE_MAPPER_REINHARD] " +"and [constant ENV_TONE_MAPPER_FILMIC]." msgstr "" #: doc/classes/VisualServer.xml |