godotengine/godot
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
32,115 Commits 15 Branches 59 Tags 2.2 GiB
cae911f004
Commit Graph

2872 Commits

Author SHA1 Message Date
lawnjelly
b1e24597e7 Renaming rendering/2d project settings. 
The rendering/quality/2d section of project settings is becoming considerably expanded in 3.2.4, and arguably was not the correct place for settings that were not really to do with quality.

3.2.4 is the last sensible opportunity we will have to move these settings, as the only existing one likely to break compatibility in a small way is `pixel_snap`, and given that the whole snapping area is being overhauled we can draw attention to the fact it has changed in the release notes.

Class reference is also updated and slightly improved.

`pixel_snap` is renamed to `gpu_pixel_snap` in the project settings and code to help differentiate from CPU side transform snapping.
 2021-03-01 11:38:46 +00:00
lawnjelly
7d5cf60149 Disallow antialiasing for software skinned 2d polys 
Antialiasing is not supported for batched polys. Currently due to the fallback mechanism, skinned antialiased polys will be rendered without applying animation.

This PR simply treats such polys as if antialiasing had not been selected. The class reference is updated to reflect this.
 2021-03-01 08:26:59 +00:00
Delf Neumärker
7df977c3ed
Fix crash during drag if user freed the drag preview 2021-02-27 15:16:06 +01:00
Haoyu Qiu
2003a41f0f Fixes typo in Array::bsearch_custom doc 
(cherry picked from commit 31243e377f)
 2021-02-26 11:29:35 +01:00
Hugo Locurcio
b2725cb4b9 Improve the OS.get_environment()/OS.set_environment() documentation 
(cherry picked from commit 355803db1b)
 2021-02-25 22:38:07 +01:00
Rémi Verschelde
6fc9c409dd
Merge pull request #46420 from nekomatata/draw-collision-outline-option-3.2 
[3.2] Added option in project settings to draw Shape2D outlines
 2021-02-25 17:15:52 +01:00
PouleyKetchoupp
d94cd42ccd Added option in project settings to draw Shape2D outlines 
Disabling collision outlines can be useful for performance when the game
is running and many collision shapes are displayed.
 2021-02-25 07:48:33 -07:00
Jummit
0a9190134d expose edit_selected in Tree 
(cherry picked from commit 13fb24cb6f)
 2021-02-25 15:14:32 +01:00
Bastiaan Olij
e9ce9a8422 Expose set_environment to GDScript 2021-02-25 22:07:38 +11:00
bruvzg
5bbacc85bd
Expose String contents to the GDScript as PoolByteArray. 2021-02-23 13:43:36 +02:00
lawnjelly
27aa03cac1 Small class reference update for 3.2.4 
Changed batching entries now that it is available in GLES3 and GLES2.
Added entry for camera_snap.
 2021-02-23 10:00:37 +00:00
hungrymonkey
1716423c97 Added sample code to the bsearch_custom function 
bsearch_custom arguments

name - type - description
value - Variant - bisection search value
obj - Any object instance - Location of the 2 argument comparison function
func - String - Name of the function declared in obj
before - boolean - first and second resolver

Fixes https://github.com/godotengine/godot-docs/issues/4564
 2021-02-22 15:55:33 +01:00
Rémi Verschelde
38c168b53b
Merge pull request #46301 from Calinou/gles2-improve-shadow-rendering 
Improve PCF13 shadow rendering in GLES2 by using a soft PCF filter
 2021-02-22 14:07:10 +01:00
Hugo Locurcio
83eec8f7db
Improve PCF13 shadow rendering in GLES2 by using a soft PCF filter 
This suppresses the blocky shadow appearance, bringing the shadow rendering
much closer to GLES3. This soft filter is more demanding as it requires
more lookups, but it makes PCF13 shadows more usable.

The soft PCF filter was adapted from three.js.
 2021-02-22 13:36:15 +01:00
Rémi Verschelde
aa5993c98b
Merge pull request #46308 from akien-mga/3.2-cherrypicks 
Cherry-picks for the 3.2 branch (future 3.2.4) - 24th batch
 2021-02-22 11:53:51 +01:00
Rémi Verschelde
0abf702d4b
Merge pull request #45957 from lupoDharkael/natural-comp 
[3.2] Add natural string comparison
 2021-02-22 11:07:54 +01:00
Andy Maloney
e262c6b8bc [docs] Clarification on theme's get_stylebox 
Remove reference to "icon" (must have been a copy-paste error) & clarify where to find out what names & node_types are valid.

(cherry picked from commit d397c32169)
 2021-02-22 10:41:30 +01:00
Hugo Locurcio
3122d12365 Document theming a SpinBox's background 
This closes #46248.

(cherry picked from commit 159581739a)
 2021-02-22 10:17:09 +01:00
Hugo Locurcio
e5d0889c49 Document that Button doesn't interpret touch input (= no multitouch) 
TouchScreenButton should be used for gameplay actions instead.

(cherry picked from commit f6087d3f2b)
 2021-02-22 10:16:06 +01:00
Lyuma
069c08e155 Backport d800329 AudioEffectCapture to 3.2 2021-02-21 20:14:58 -08:00
Yuri Sizov
57e57872fd Add documentation for EditorPlugin's build method 
(cherry picked from commit 724ed88215)
 2021-02-19 15:55:57 +01:00
Hugo Locurcio
9f236d48e6 Don't allow negative values for OS.delay_usec()/OS.delay_msec() 
This closes #46190.

(cherry picked from commit 76f1f9b3c5)
 2021-02-19 15:52:54 +01:00
Luke Hubmayer-Werner
0974cf15f6 Documentation: Correct CanvasItem.draw_string position description. 
Also add height warnings to Font.get_char_size and Font.get_string_size
 2021-02-19 18:33:27 +10:30
Rémi Verschelde
8651838268 doc: Fixup RichTextLabel bbcode_enabled note 2021-02-19 00:04:32 +01:00
skyace65
72aef9d67e Add information on bb code enabled 2021-02-18 23:46:33 +01:00
Jitesh
d968a03cbc
Add animation_finished signal and fix frame_changed signal for AnimatedSprite3D 
Fixes #40301.
Fixes #45947.

(cherry picked from commit c3be0c2c04)
 2021-02-18 00:36:20 +01:00
Rémi Verschelde
30c69c296b
Merge pull request #46093 from akien-mga/3.2-cherrypicks 
Cherry-picks for the 3.2 branch (future 3.2.4) - 23rd batch
 2021-02-16 15:17:00 +01:00
David Buchmann
26e2eaf068 doc: Clarify TileMap world_to_map and map_to_world usage 
Per discussion in #38551.
Fixes #31663.
Fixes #37394.
 2021-02-16 14:52:51 +01:00
Rémi Verschelde
7c3602dc8c
doc: Sync classref with current source 2021-02-16 14:47:29 +01:00
Sylvain Beucler
dc1264af0a
doc: explain TouchScreenButton passby mode 
(cherry picked from commit 9e21077fad)
 2021-02-16 14:27:40 +01:00
hoontee
d91a5e7883
Implement CollisionPolygon3D margin 
(cherry picked from commit fbb1ef759c)
 2021-02-16 14:27:39 +01:00
Hugo Locurcio
6c6f4e9895
Expose a File.flush() method to scripting 
This can be used to ensure a file has its contents saved
even if the project crashes or is killed by the user
(among other use cases).

See discussion in #29075.

(cherry picked from commit ab397460e9)
 2021-02-16 14:27:38 +01:00
Hugo Locurcio
15d9f77f97
Add a project setting to enable stdout flushing in release builds 
This can be used in server builds for journalctl compatibility.

(cherry picked from commit 341b9cf15a)

Fixes crash when exiting with --verbose with leaked resources

(cherry picked from commit 25c4dacb88)
 2021-02-16 14:27:38 +01:00
JFonS
56bf256d76 Add options to reduce lightmaps disk usage. 
Added BakedLightmap.use_hdr and BakedLightmap.use_color properties
that can reduce the flie size of lightmap texture at the expense of quality.

Changed the denoiser to work in a single buffer, reducing RAM
usage. Also added the `-mstackrealign` flag in the denoiser compilation
for MinGW builds. This flag helped fix a bug in Embree, so I want to see
if it will help fix GH #45296.
 2021-02-16 13:20:27 +01:00
lupoDharkael
460e1b94c3 [3.2] Add natural string comparison 2021-02-13 15:13:58 +01:00
Emily
92dd573053
fixed typo in packedscene 
(cherry picked from commit 7368bc534a)
 2021-02-12 11:11:35 +01:00
Kongfa Waroros
adb93d7120
Update GraphEdit when GraphNode's slot is updated 
(cherry picked from commit fe6c8d48e6)
 2021-02-11 13:14:33 +01:00
Ryan Roden-Corrent
08d556f677
Clarify EditorImportPlugin.get_visible_name. 
According to the docs at
https://docs.godotengine.org/en/stable/tutorials/plugins/editor/import_plugins.html#the-editorimportplugin-class

> The get_visible_name() method is responsible for returning the name of
> the type it imports and it will be shown to the user in the Import dock.
> You should choose this name as a continuation to "Import as", e.g.
> "Import as Silly Material"

I've verified Godot's behavior reflects this, so the code examples
should reflect this.

Also document propagating save error in EditorImportPlugin.

It seems that the suggested code ignores any error from
`ResourceSaver.save`, but I think we should return it.

(cherry picked from commit 9676650f2f)
 2021-02-11 13:12:06 +01:00
Rémi Verschelde
f55c23d8f2
Merge pull request #44476 from Calinou/doc-object-new-bug 
Document known bug with `Object.new()` and workaround
 2021-02-11 12:26:25 +01:00
Rémi Verschelde
5e7df2da08
Merge pull request #45876 from Calinou/doc-particles2d-no-atlas 
Document Particles2D not supporting AtlasTexture region
 2021-02-10 19:47:42 +01:00
Hugo Locurcio
97b43e816b Document Particles2D not supporting AtlasTexture region 
See #13923.
 2021-02-10 18:09:51 +01:00
Aaron Franke
f201382a85
[3.2] Use instance and first arg in Basis is_equal_approx 
Discards the second argument.
 2021-02-09 05:09:51 -05:00
Rémi Verschelde
398a625a9f
Merge pull request #39421 from RandomShaper/pause_aware_picking_3.2 
Implement pause-aware picking (3.2)
 2021-02-09 10:43:48 +01:00
Hugo Locurcio
2261e738c2
Improve the SurfaceTool.generate_normals() documentation 
(cherry picked from commit b8df8b1043)
 2021-02-08 22:36:36 +01:00
Pedro J. Estébanez
745c711289 Implement pause-aware picking 
This adds a new project setting (`physics/common/enable_pause_aware_picking`). It's disabled by default.

When enabled, it changes the way 2D & 3D physics picking behaves in relation to pause:
- When pause is set, every collision object that is hovered or captured (3D only) is released from that condition, getting the relevant mouse-exit callback., unless its pause mode makes it immune from pause.
- During the pause. picking only considers collision objects immune from pause, sending input events and enter/exit callbacks to them as expected.
- When pause is left, nothing happens. This is a big difference with the classic behavior, which at this point would process all the input events that have been queued against the current state of the 2D/3D world (in other words, checking them against the current position of the objects instead of those at the time of the events).
 2021-02-08 20:48:13 +01:00
Marcel Admiraal
3dd57a22df Add support for new SDL gamecontroller keywords. 2021-02-07 16:41:23 +00:00
Hugo Locurcio
898327b312
Document known bug with Object.new() and workaround 2021-02-07 16:15:24 +01:00
Hugo Locurcio
ee89da129f Improve the File.endian_swap documentation 
(cherry picked from commit c5f0db45df)
 2021-02-05 09:26:09 +01:00
James Westman
7ce1789597
docs: Add TreeItem method descriptions 
(cherry picked from commit 2f5164d78c)
 2021-02-02 13:02:46 +01:00
Hugo Locurcio
38a94ce2bc
Reference the control gallery image in the Control class documentation 
Like the Tween cheatsheet or Color constants cheatsheet, this references
a "cheatsheet" image from the documentation repository.

(cherry picked from commit 200f1cf015)
 2021-02-02 13:02:46 +01:00
kleonc
995388cf6f
Docs: Fix TileMap::map_to_world description 
(cherry picked from commit e62ec6c6b1)
 2021-02-02 13:02:46 +01:00
HaSa1002
4ff0df702d Expose bookmark, breakpoint, and mark safe functions in TextEdit 2021-01-27 22:41:07 +01:00
Hugo Locurcio
eb0ca31ac1
Add an OS.get_thread_caller_id() method 
This can be used to print thread IDs in logs. This can make it easier
to debug multi-threaded applications.

Co-authored-by: Khaos <khaos@khaos-coders.org>
(cherry picked from commit 35b046ddf7)
 2021-01-26 22:10:30 +01:00
Hugo Locurcio
1c9ee4baa2
Improve the Array.hash() documentation 
Co-authored-by: Laguzus <67963093+Laguzus@users.noreply.github.com>
(cherry picked from commit 435848192e)
 2021-01-26 22:10:30 +01:00
Andrii Doroshenko (Xrayez)
0ff0fdef5c
Document shape metadata for TileMap 
(cherry picked from commit 0c2dbd01dc)
 2021-01-26 17:24:39 +01:00
Hugo Locurcio
9a3c5033f7
Document the expected low performance of VideoPlayer on HTML5 
(cherry picked from commit b98540dd9d)
 2021-01-26 17:00:17 +01:00
Hugo Locurcio
e2a2005a48
Document low performance of Array.push_front() and Array.pop_front() 
(cherry picked from commit 7ce3cc0478)
 2021-01-26 17:00:16 +01:00
Hugo Locurcio
af891cebe4
Document that the high-level multiplayer API is only for Godot servers 
(cherry picked from commit 1b03f3f72b)
 2021-01-26 17:00:16 +01:00
Nils Reid
349f25429b
Exposed find_next_valid_focus and find_prev_valid_focus. 
(cherry picked from commit 3e94c23fa5)
 2021-01-26 17:00:16 +01:00
Hugo Locurcio
22bb9fcd82
Document a built-in use of Resource.resource_name 
(cherry picked from commit 1a606b1a04)
 2021-01-26 17:00:16 +01:00
Ryan Roden-Corrent
c31bb02a3e
Clarify that create_timer does not require cleanup. 
This is how I would expect it to work, but the docs didn't clarify, so I
had to check the source just to make sure I wasn't responsible for
freeing the timer:

d39f6386ce/scene/main/scene_tree.cpp (L473)
(cherry picked from commit 6e7e4f82ec)
 2021-01-26 17:00:16 +01:00
Andrii Doroshenko (Xrayez)
ee73e4aa24
Document GPU particles visibility rect/aabb behavior 
(cherry picked from commit b4675973fd)
 2021-01-26 17:00:15 +01:00
Hugo Locurcio
86ca5ff5f0
Document that ShaderMaterial doesn't support GIProbe emission 2021-01-25 18:19:10 +01:00
Hugo Locurcio
9dbdec7e33
Document workaround for storing 64-bit floats in PoolRealArray 2021-01-16 21:46:01 +01:00
Hugo Locurcio
e2c13c00f7
Document that PoolRealArray stores 32-bit floats 
This closes #45230.
 2021-01-16 16:48:09 +01:00
Phischermen
708f690b50
Add info about how gizmos affect transform notifications 
(cherry picked from commit 72d1d7e948)
 2021-01-15 16:49:46 +01:00
Andrii Doroshenko (Xrayez)
b124c0c466
Expose Resource.emit_changed() to script 
Also known as `emit_signal("changed")`.

(cherry picked from commit e94f46dcdb)
 2021-01-15 16:49:46 +01:00
Alexander Pech
d73281a350
Keep RichTextLabel visible character properties in sync 
The RichTextLabel class is inconsistent in how it updates the
visible_characters and percent_visible properties when either is changed.

To keep both properties consistent, update percent_visible when setting the
visible_characters property.
For both properties, when setting one, notify change for the other.

Docs updated for member set_visible_characters on RichTextLabel class.

(cherry picked from commit 463e2002ab)
 2021-01-15 16:49:46 +01:00
Rémi Verschelde
497653ab53
Merge pull request #44628 from JFonS/new_cpu_lightmapper_3.2 
[3.2] New CPU lightmapper
 2021-01-15 13:25:46 +01:00
JFonS
b1ca82c43a CPU lightmapper fixes. 
- Fix Embree runtime when using MinGW (patch by @RandomShaper).
- Fix baking of lightmaps on GridMaps.
- Fix some GLSL errors.
- Fix overflow in the number of shader variants (GLES2).
 2021-01-15 12:32:54 +01:00
JFonS
d909592fc5 Add documentation for new CPU lightmapper. 2021-01-15 12:31:46 +01:00
Marcel Admiraal
253b1c22da Rename the final parameter of area_shape_entered-exited local_shape. 2021-01-15 09:46:19 +00:00
Marcel Admiraal
cdcd425432 Update area-body_shape_entered-exited signal documentation. 2021-01-15 09:46:17 +00:00
Rémi Verschelde
d298949513
Merge pull request #42882 from madmiraal/fix-39767-3.2 
[3.2] Set Bullet collision shape index to zero when using a single shape or ConcavePolygonShape
 2021-01-14 20:46:06 +01:00
Rémi Verschelde
152415a006
Merge pull request #43924 from madmiraal/fix-43588-3.2 
[3.2] Fix cast_motion sometimes failing
 2021-01-14 20:44:40 +01:00
Rémi Verschelde
b9c5e2f9eb
doc: Sync classref with current source 
And fix copyright headers in new code.
 2021-01-13 16:55:27 +01:00
TechnoPorg
d824efda75
Fix incorrect parameter in audio_track_set_key_stream. 
The description for audio_track_set_key_stream referenced a parameter called offset, which is not a parameter for that method. The description now references the correct parameter, stream.

(cherry picked from commit 81dc9be973)
 2021-01-13 16:17:10 +01:00
skyace65
45cdb8aab3
Remove the implication that references and resources are not objected from their description 
(cherry picked from commit dca298d22b)
 2021-01-13 16:17:10 +01:00
Andrii Doroshenko (Xrayez)
9c9ac159e9
Clarify lstrip()/rstrip() methods in String for removed characters 
(cherry picked from commit a2c82bbf5f)
 2021-01-13 16:17:09 +01:00
kobewi
d16f2bddee
Clarify class_get_method_list() in release exports 
(cherry picked from commit 84acafb2ce)
 2021-01-13 16:17:07 +01:00
Andrii Doroshenko (Xrayez)
acd9abe507 Add AspectRatioContainer class 
Backported from ba68383706.

Co-authored-by: Ugis Brekis <ugis.brekis@productmadness.com>
 2021-01-12 16:25:26 +02:00
lawnjelly
690e07b509 Dynamic BVH for rendering and godot physics 
Complete rewrite of spatial partitioning using a bounding volume hierarchy rather than octree.

Switchable in project settings between using octree or BVH for rendering and physics.
 2021-01-12 12:12:10 +00:00
Andrii Doroshenko (Xrayez)
47899e67c5 Add ability to restore RandomNumberGenerator state 
3.2 version of b5107715f1.

`get_seed()` still returns the previous state and not the initial seed,
because users may rely on this behavior for resetting the state in 3.2.
Documented this is going to be fixed in 4.0.

Co-authored-by: MidZik <matt.idzik1@gmail.com>
 2021-01-08 15:02:02 +02:00
Rémi Verschelde
3d31433229
doc: Remove links to RNG tutorial, not yet in 3.2 branch 2021-01-07 14:33:36 +01:00
Hugo Locurcio
cec16357ef
Document the requirement to update GPU particle visibility 
This also updates some option names in the editor for consistency
and accuracy.

See #44955.
 2021-01-06 19:17:57 +01:00
Rémi Verschelde
d7102ac78f
doc: Sync classref with current source 2021-01-05 21:33:34 +01:00
Hugo Locurcio
7fb212fdb6
Mention that the delta argument is in seconds in Node documentation 
(cherry picked from commit fcb6ecaf21)
 2021-01-05 21:33:34 +01:00
Maganty Rushyendra
90d1d580af
Explain A Star pathfinding algorithm cost calcuation 
(cherry picked from commit f6634648ce)
 2021-01-05 21:33:33 +01:00
Rémi Verschelde
66bfe855a8
Revert "Add a project setting to enable stdout flushing in release builds" 
This reverts commit 341b9cf15a.

This makes the logger crash when used during cleanup: #44850.
 2021-01-05 21:33:33 +01:00
Maganty Rushyendra
d2241a2b5f
Specify order of drawing of Nodes in raise() description 
(cherry picked from commit a67ef5999d)
 2021-01-05 21:33:32 +01:00
Hugo Locurcio
58efe5f313
Document the desktop-only file logging setting override 
This closes https://github.com/godotengine/godot-docs/issues/4505.

(cherry picked from commit bd0b7003e0)
 2021-01-05 20:49:00 +01:00
Eoin O'Neill
650f7c6f35
StateMachinePlayback: Added missing bindings to get_current_play_pos and get_current_length. 
This allows the user to query the AnimationNodeStateMachinePlayback's current
play position and total length of current animation state. These methods are currently
used in the editor plugin, but can also be useful for querying general playback state
information.

Added documentation for AnimationNodeStateMachinePlayback's `get_current_play_position`

(cherry picked from commit 674fb52f52)
 2021-01-05 20:48:57 +01:00
Yuri Roubinsky
adfc646f8c
Added optional id parameter to PopupMenu::add_separator 
(cherry picked from commit ca8c794d04)
 2020-12-30 09:57:01 +01:00
Hugo Locurcio
e2ff3ab88f
Document RichTextLabel not supporting entangled BBCode tags 
See #44634.

(cherry picked from commit 3b6612e48e)
 2020-12-30 09:56:17 +01:00
Rémi Verschelde
a24a6d510f
doc: Sync classref with current source 2020-12-29 16:02:45 +01:00
kobewi
151fa897fb
Complete documentation of EditorExportPlugin 
(cherry picked from commit 8b231aff28)
 2020-12-29 16:02:03 +01:00
kobewi
a227eefd2d
Rename offset to point in remove_point() 
(cherry picked from commit 4f72a07eaa)
 2020-12-29 16:02:03 +01:00
Jummit
27bfacd425
fix missing "s" in Viewport docs 
(cherry picked from commit 63456bdd8a)
 2020-12-29 16:02:03 +01:00
kobewi
9150d35699
Mention that change_scene is deferred 
(cherry picked from commit 86aa9b1233)
 2020-12-29 16:02:02 +01:00
Hugo Locurcio
f50c0d9503
Fix confusing SliderJoint3D brief description 
(cherry picked from commit 27f964d538)
 2020-12-29 16:02:02 +01:00
Hugo Locurcio
76b5cde0b2
Document how to solve UV jittering when using large procedural meshes 
(cherry picked from commit a86ed339a4)
 2020-12-29 16:02:01 +01:00
Yuri Roubinsky
bafbb238af
Added a note describing a code behind Vector2/3.direction_to 
(cherry picked from commit fa0683ed30)
 2020-12-29 16:02:00 +01:00
Hugo Locurcio
f5f04a10f5
Add a project setting to enable stdout flushing in release builds 
This can be used in server builds for journalctl compatibility.

(cherry picked from commit 341b9cf15a)
 2020-12-29 16:02:00 +01:00
Fabio Alessandrelli
53988c7de3
Add important note about OS.get_unixtime. 
Should NEVER be used for precise time computations since its return
values are not guaranteed to be monotonic.

(cherry picked from commit 49741d9464)
 2020-12-29 16:01:59 +01:00
Marcus Brummer
d3d34dc73b
Fixed Geometry2D::get_closest_points_between_segments docs 
(cherry picked from commit 56e5ca38d7)
 2020-12-29 16:01:59 +01:00
Rémi Verschelde
1a64f5d2ec
ProximityGroup: Fix access modifiers, rename private methods for clarity 
See #36285 which mistakenly added documentation for the whole C++ API, while
some of it is meant to be and stay private as it's not exposed to scripts.
The access modifiers and method prefix were not used properly.

Cleanup code, and rename wrong `group_name` parameters to `method`, as it's a
method name which is being broadcast.

This is a very old class from pre-open source days, chances are that it was
just forgotten and not meant to be kept as is and undocumented.

(cherry picked from commit 79ba70f7ee)
 2020-12-29 16:01:58 +01:00
Rémi Verschelde
a4d25a115e
Merge pull request #44460 from theogen-ratkin/3.2 
[3.2] Add interpolation parameter to resize_to_po2()
 2020-12-19 09:36:01 +01:00
Theogen Ratkin
8f6a6ac8d0 Add interpolation parameter to resize_to_po2() 
Image::resize_to_po2() now takes an optional p_interpolation parameter
that it passes directly to resize() with default value INTERPOLATE_BILINEAR.

GLES2: call resize_to_po2() with interpolate argument

Call resize_to_po2() in GLES2 rasterizer storage with either
INTERPOLATE_BILINEAR or INTERPOLATE_NEAREST depending on TEXTURE_FLAG_FILTER.

This avoids filtering issues with non power of two pixel art textures.
See #44379
 2020-12-18 14:02:38 -04:00
Yuri Sizov
816fef21f9 Add a minimap to the GraphEdit 2020-12-18 01:31:17 +03:00
Rémi Verschelde
9710a38637
Merge pull request #44435 from Calinou/fix-max-renderable-elements-hint 
Fix invalid property hint for `max_renderable_elements` project setting
 2020-12-16 21:59:29 +01:00
Hugo Locurcio
680312b95a
Fix invalid property hint for max_renderable_elements project setting 
This closes #36240.
 2020-12-16 19:33:15 +01:00
skyace65
04926adb8a [3.2] Document what can be used as a type hint 2020-12-15 22:34:25 -05:00
Marcel Admiraal
825ad65fc4 Remove Generic6DOFJoint precision property 2020-12-15 10:15:42 +00:00
Hugo Locurcio
9c234abdc9
Document the argument count limit in SceneTree.call_group() 
This limitation should be lifted in 4.0 thanks to the new method
binding system, but it's still present in 3.2.x.
 2020-12-15 00:53:40 +01:00
Hugo Locurcio
d72dcf5b24
Document that SpatialMaterial doesn't support depth mapping + triplanar 
See #44322.
 2020-12-12 17:11:50 +01:00
Hugo Locurcio
f2b04e8865
Document that changing the particle amount resets emission 
See #16352.
 2020-12-11 15:38:55 +01:00
Rémi Verschelde
0c7a9bd283
doc: Sync classref with current source 
And fix broken doctool after #43948.
 2020-12-10 14:22:31 +01:00
volzhs
c904cf612a
Add option to draw all tabs in front 
(cherry picked from commit 814f9015f8)
 2020-12-10 13:07:49 +01:00
Michael Alexsander
32da9dc1e9
Add "font_color_separator" theme property to 'PopupMenu' 
(cherry picked from commit 383e8919e0)
 2020-12-10 13:06:15 +01:00
Tomasz Chabora
99a6cf77dd
Mention that 'changed' signal needs manual emit 
(cherry picked from commit b552c26c68)
 2020-12-10 13:03:25 +01:00
Hugo Locurcio
b1919a3ed0
Document the lack of localization remapping support in VideoPlayer 
See #43917.

(cherry picked from commit 1636fb8856)
 2020-12-10 13:03:05 +01:00
Danil Alexeev
6c3a0e3a5a
Several edits to the GDScript docs 
(cherry picked from commit bf96056ad0)
 2020-12-09 11:22:03 +01:00
Hugo Locurcio
eda04c6b6c
Fix incorrect Curve3D.interpolate_baked() description 
The offset is in 3D units, not pixels.

This closes https://github.com/godotengine/godot-docs/issues/4339.

(cherry picked from commit 5a9600cd24)
 2020-12-02 16:03:06 +01:00
Jummit
deda90bad7
add root_node as property of MultiplayerAPI 
(cherry picked from commit d4c4d2db4c)
 2020-12-01 09:00:54 +01:00
Hugo Locurcio
d8c90f5f1e
Improve the ProjectSettings.globalize_path() documentation 
This closes https://github.com/godotengine/godot-docs/issues/4409.

(cherry picked from commit f415db5b75)
 2020-12-01 09:00:52 +01:00
Rémi Verschelde
dbb69f8f49
doc: Mention iOS support for Input gravity/gyroscope sensors 
It has been implemented for iOS a long time ago already with #7127.

(cherry picked from commit 2d0fda3ca2)
 2020-12-01 09:00:48 +01:00
Marcel Admiraal
2e99b5b137 Fix cast_motion sometimes failing 
- Fixes Godot physics failing when the cast Shape is inside of, or
already colliding with another Shape.
- Fixes Bullet physics failing when there is no motion.
- Ensures Godot and Bullet physics behave the same.
- Updates the documentation to exclude the caveats for the failures and
differences.
 2020-11-27 15:32:25 +00:00
jfons
bdc6f2fd95
Fix binding of default value in EditorSpatialGizmoPlugin::get_material() 
It was commented for some reason I can't remember.

(cherry picked from commit e6949dae72)
 2020-11-26 09:38:47 +01:00
Hugo Locurcio
9706b78a3f
Document C# garbage collection caveats in Reference and Resource 
(cherry picked from commit 0565c76e8b)
 2020-11-26 09:38:47 +01:00
Hugo Locurcio
b2b5d9a7a3
Improve the AudioStreamPlayer3D class documentation 
(cherry picked from commit 95618e2937)
 2020-11-26 09:38:47 +01:00
Rémi Verschelde
ac8dedd532
doc: Warn about using Node internal processing 
See #43689.

Also 'fixed' some spelling for behavior in publicly visible strings.
(Sorry en_GB, en_CA, en_AU, and more... Silicon Valley won the tech spelling
war.)

(cherry picked from commit a655de89e3)
 2020-11-26 09:38:45 +01:00
Hugo Locurcio
8adaf603d1
Update the number of lights supported in OmniLight and SpotLight docs 
Follow-up to #43606.
 2020-11-20 14:07:33 +01:00
Phischermen
776faa5c92
Clarify that SceneTree::quit() does not immediately end the application. 
(cherry picked from commit 371d12a2f0)
 2020-11-19 17:15:27 +01:00
Andrii Doroshenko (Xrayez)
2edd489f83 Describe ImageTexture, Image creation and usage 
Ported from commit 0ee88d6705.
 2020-11-17 18:06:52 +02:00
Rémi Verschelde
d099b6cf60
Merge pull request #43606 from NHodgesVFX/3.2 
Make lights_per_object configurable
 2020-11-17 16:20:38 +01:00
Unknown
5965fbd9fa Make lights_per_object configurable 2020-11-17 10:03:44 -05:00
Rémi Verschelde
fc718d87a6
doc: Add description for rendering/quality/2d/use_transform_snap 
Co-authored-by: lawnjelly <lawnjelly@gmail.com>
 2020-11-17 12:23:58 +01:00
Ryan Roden-Corrent
07c8e25078
Clarify Curve3D.get_point_{in,out} position in doc. 
I verified this experimentally. I added a point at roughly (1,0,0), and
dragged a handle back to the origin. The result was:

```
get_point_position: (0.991079, 0, -0.000069)
get_point_in: (0.993409, 0, 0)
get_point_out: (-0.993409, 0, 0)
```

(cherry picked from commit c6093ae612)
 2020-11-17 12:07:02 +01:00
Tomasz Chabora
17af75953f
Correct the doc about Tree.get_edited 
(cherry picked from commit b8145c182b)
 2020-11-17 12:07:02 +01:00
Hugo Locurcio
e53a5f6be5
Improve the Dictionary class documentation 
- Mention Lua-style syntax.
- Make the code samples self-contained.
- Mention caveat with `const` (also in Array).
- Clarify the description of `size()`.

This closes https://github.com/godotengine/godot-docs/issues/4272.

(cherry picked from commit 5325de4e6b)
 2020-11-17 12:07:02 +01:00
Hugo Locurcio
92f81ff782
Clarify packet peer max_buffer_po2 in ProjectSettings documentation 
This closes https://github.com/godotengine/godot-docs/issues/4364.

(cherry picked from commit c475b1fd0b)
 2020-11-17 12:07:02 +01:00
Feniks
c58b5c5df4
Changed mouse cursor to the caret (text cursor) location. 
(cherry picked from commit 59ed3c1aaf)
 2020-11-17 12:01:58 +01:00
Wilson E. Alvarez
aa6406874e
Document InstancePlaceholder.create_instance not being thread-safe. 
(cherry picked from commit a6f3ef3ac7)
 2020-11-17 12:01:58 +01:00
HaSa1002
18d65673af
Docs: MeshDataTool: showcase tool in code example 
(cherry picked from commit 4f9b993423)
 2020-11-17 12:01:58 +01:00
Rémi Verschelde
fc5b106369
Merge pull request #42168 from madmiraal/fix-42108-3.2 
[3.2]  Remove the unnecessary sync() and the restrictions it imposes on 3D Physics.
 2020-11-16 09:33:17 +01:00
Aaron Franke
9c83b8ed70
[3.2] Improve comments in Color documentation 2020-11-14 04:56:18 -05:00
Rémi Verschelde
a57b6eb211
doc: Sync classref with current source 
Move EditorSceneImporterFBX doc to its module folder.
 2020-11-11 17:00:41 +01:00
PouleyKetchoupp
9b64646bc3
Expose LineEdit scroll offset to scripts 
(cherry picked from commit 4775db1600)
 2020-11-11 15:44:18 +01:00
Tomasz Chabora
98774000e2
Add append_array() method to Array class 
(cherry picked from commit 9f23a94b8a)
 2020-11-11 15:44:14 +01:00
Tomasz Chabora
dc05beca80
Register methods for drawing 3D editor overlays 
(cherry picked from commit cbfbb4538b)
 2020-11-11 15:30:57 +01:00
Tomasz Chabora
da2ac44d77
Add docs for editor viewport drawing methods 
(cherry picked from commit 5d8b60ac3d)
 2020-11-11 15:30:57 +01:00
Rémi Verschelde
2652f6fc69
doc: Override default value for RandomNumberGenerator.seed 
It's non-deterministic so it's better to show a fixed value like 0 instead of
having it potentially change whenever `randomize()` is called.

Fixes #43317.

(cherry picked from commit 35e6070a35)
 2020-11-11 15:30:56 +01:00
Ryan Roden-Corrent
b472d5366c
Fix typo in Tabs doc. 
I don't know enough about grammar to say why the "ing" suffix is
correct, but I'm reasonably sure it is :)

(cherry picked from commit 3826f3348f)
 2020-11-11 15:30:56 +01:00
Rémi Verschelde
05143ca39a
Tooltips: Improve code clarity and docs 
The return type for `_make_custom_tooltip` is clarified as Control, and users
should make sure to return a visible node for proper size calculations.

Moreover in the current master branch, a PopupPanel will be added as parent
to the provided tooltip to make it a sub-window.

Clarifies documentation for `Control._make_custom_tooltip`, and shows how to
use the (until now undocumented) "TooltipPanel" and "TooltipLabel" theme types
to style tooltips.

Fixes #39677.

(cherry picked from commit c5d8dafec4)
 2020-11-11 15:30:56 +01:00
Hugo Locurcio
de96b29c58
Correct documentation about NinePatchRect stretch modes 
This closes https://github.com/godotengine/godot-docs/issues/4333.

(cherry picked from commit 82bfb6273b)
 2020-11-11 15:30:56 +01:00
Hugo Locurcio
10b1987fda
Fix a variable being redeclared in the HTTPRequest code sample 
(cherry picked from commit d7025c4167)
 2020-11-11 15:30:56 +01:00
SirQuartz
7dd5de5a57
Clarify what the "item_rect_changed" signal does 
(cherry picked from commit 120ef02ca3)
 2020-11-11 15:30:55 +01:00
Hugo Locurcio
7db872b55a
Add Image.load_bmp_from_buffer() for run-time BMP image loading 
This partially addresses
https://github.com/godotengine/godot-proposals/issues/676.

(cherry picked from commit 0209e3790e)
 2020-11-11 15:30:55 +01:00
Hugo Locurcio
2c6b3074fc
Increase the default HTTPClient download chunk size to 64 KiB 
This improves download speeds at the cost of increased memory usage.

This change also effects HTTPRequest automatically.

See #32807 and #33862.

(cherry picked from commit 13357095ee)
 2020-11-11 15:30:55 +01:00
Hugo Locurcio
b682df5653
Document the supported TLS versions in HTTPRequest 
See #42857.

(cherry picked from commit 0ebbc7602c)
 2020-11-11 15:30:55 +01:00
Hugo Locurcio
fb4b800507
Document how to interrupt PacketPeerUDP.wait() 
This closes #36335.

(cherry picked from commit 25777488fd)
 2020-11-11 15:30:54 +01:00
Hugo Locurcio
b62b71e140
Improve the documentation related to fullscreen and borderless settings 
(cherry picked from commit a1f81a52df)
 2020-11-11 15:12:01 +01:00
Enhex
7ec83ccb9f
Fix missing quote in documentation 
(cherry picked from commit aaf5a58b44)
 2020-11-11 15:12:01 +01:00
Hugo Locurcio
fab38f7cf1
Document AtlasTexture not supporting repetition 
See #5660.
 2020-11-02 18:29:27 +01:00
unknown
8d409423f7 Added a note to ImmediateGeometry regarding it's buffer limit 2020-10-30 16:43:48 +05:30
Rémi Verschelde
c43b2ab603
Merge pull request #42942 from Calinou/add-viewport-debanding-3.2 
Add a debanding property to Viewport for GLES3
 2020-10-30 11:47:57 +01:00
Hugo Locurcio
7746afec94
Document hiding a Control when its reference point is behind the camera 
See https://github.com/godotengine/godot/issues/1725.

(cherry picked from commit b3a6937c0c)
 2020-10-28 14:05:42 +01:00
Dustin Petersohn
a7609d9c49
Improved documentation for TileMap.cell_y_sort 
(cherry picked from commit 669f21d367)
 2020-10-28 14:05:42 +01:00
Andrii Doroshenko (Xrayez)
921046c822
Add border_width to ReferenceRect 
Exposes a hidden parameter behind `CanvasItem.draw_rect()`.

(cherry picked from commit aef00021a9)
 2020-10-28 14:05:40 +01:00
Andrii Doroshenko (Xrayez)
bdfa43ea63
Cross-reference ColorRect and ReferenceRect in the class reference 
They use the same underlying `CanvasItem.draw_rect()` API.

(cherry picked from commit 803b046b38)
 2020-10-28 14:05:40 +01:00
Hugo Locurcio
a5f98e915c
Document how to display the vertex color in SurfaceTool.add_color() 
This closes https://github.com/godotengine/godot-docs/issues/4083.

(cherry picked from commit 2f1d40367a)
 2020-10-28 14:05:39 +01:00
Rémi Verschelde
2e073ecbea
Merge pull request #42927 from lawnjelly/octree_default 
Change render octree balance default
 2020-10-21 10:19:34 +02:00
Hugo Locurcio
2dbc329704
Add a debanding property to Viewport for GLES3 
It can be enabled in the Project Settings
(`rendering/quality/filters/use_debanding`). It's disabled
by default as it has a small performance impact and can make
PNG screenshots much larger (due to how dithering works).

As a result, it should be enabled only when banding is noticeable enough.

Since debanding requires a HDR viewport to work, it's only supported
in the GLES3 backend.
 2020-10-20 19:07:15 +02:00
Rémi Verschelde
150f9ce807
Merge pull request #42009 from Calinou/theme-node-type-3.2 
Rename the `type` parameter to `node_type` in Theme and Control (3.2)
 2020-10-20 15:58:41 +02:00
Hugo Locurcio
af45c97652
Add fast approximate antialiasing (FXAA) to Viewport 
This backports FXAA from the `master` branch.

Co-authored-by: Clay John <claynjohn@gmail.com>
 2020-10-20 14:54:52 +02:00
Rémi Verschelde
04fb41a0f3
Merge pull request #42531 from BastiaanOlij/add_get_native_handle 
Add get native handle
 2020-10-20 13:27:07 +02:00
Bastiaan Olij
1ea7358405 Add get_native_handle to OS 2020-10-20 20:23:37 +11:00
lawnjelly
10cdfda894 Change render octree balance default 
Another bug in the octree has been discovered which can cause flickering in rare circumstances : #42895

For safety until this is fixed properly this PR reverts the default state of the octree to match the old behaviour, which doesn't appear exhibit the bug (or at least not as readily).
 2020-10-20 08:49:52 +01:00
Rémi Verschelde
a239894827
Merge pull request #42902 from akien-mga/3.2-cherrypicks 
Cherry-picks for the 3.2 branch (future 3.2.4) - 5th batch
 2020-10-19 22:14:05 +02:00
Juan Linietsky
388ebfb498
Merge pull request #41629 from JFonS/disable_baked_lights 
Disable lights for objects with baked lighting
 2020-10-19 14:12:50 -03:00
Rémi Verschelde
311bdbc16c
doc: Sync classref with current source 2020-10-19 17:13:30 +02:00
Rémi Verschelde
4028414e0e
Revert "Made toplevel a property for Node3D and CanvasItem" 
This reverts commit a726d011d5.
 2020-10-19 16:58:56 +02:00
Rémi Verschelde
4287af5148
doc: Make docs.godotengine.org links point to 3.2 branch 2020-10-19 16:10:01 +02:00
Aaron Franke
069ed4ec63
Link to demos from within the class reference 
(cherry picked from commit 439be614f4)
 2020-10-19 16:10:01 +02:00
Tomasz Chabora
d9bd61508b
Document that setting node name will remove @s 
(cherry picked from commit 02ce2f4bb9)
 2020-10-19 16:10:01 +02:00
Hugo Locurcio
8c6a5b06a2
Clarify that MultiMesh.set_instance_color() multiplies vertex colors 
This closes https://github.com/godotengine/godot-docs/issues/4273.

(cherry picked from commit 6975bd106a)
 2020-10-19 16:10:01 +02:00
Hugo Locurcio
8d445f3f9f
Link the Random number generation tutorial in the class reference 
(cherry picked from commit 802c1e4df1)
 2020-10-19 16:10:00 +02:00
Charles Merriam
1a25a301db
Fix typo in the ProjectSettings class documentation 
(cherry picked from commit 5160a9f650)
 2020-10-19 16:09:58 +02:00
Sniff
13e128b934
Docs change: More detailed description of StreamPeerTCP.is_connected_to_host() 
(cherry picked from commit 7970e4a433)
 2020-10-19 16:09:58 +02:00
Tomasz Chabora
f7ea1e6b38
Correct the doc about linear damping 
(cherry picked from commit ebca7d4e4e)
 2020-10-19 16:09:58 +02:00
Umang Kalra
9ec70c54ab
Explaining the behavior of focus & pressed stylebox overlap 
(cherry picked from commit 10a7eddc5e)
 2020-10-19 16:09:58 +02:00
Rémi Verschelde
123942f61f
Merge pull request #42119 from lawnjelly/ewok3 
Unified GLES3 / GLES2 Batching
 2020-10-19 15:01:10 +02:00
Hugo Locurcio
34ac0387d6
Deprecate the GIProbe Compress property due to known bugs 
This property introduced green artifacts in GI and didn't improve
performance.

The new GIProbe in `master` no longer has a Compress property.
 2020-10-19 14:51:23 +02:00
Rémi Verschelde
3495cb91d8
Merge pull request #41577 from FIF15/deprecate-redundant-property-enabled-focus-mode 
Deprecate Redundant property enabled_focus_mode
 2020-10-19 14:15:43 +02:00
Marcel Admiraal
b7d00a364e Set Bullet collision shape index to zero when using a single shape 
or ConcavePolygonShape.
 2020-10-19 11:50:29 +01:00
lawnjelly
c2290dbedd Unified GLES2 / GLES3 Batching 
Batching is mostly separated into a common template which can be used with multiple backends (GLES2 and GLES3 here). Only necessary specifics are in the backend files.

Batching is extended to cover more primitives.
 2020-10-16 10:34:47 +01:00
FIF15
8311a37ed9 Deprecate Redundant property enabled_focus_mode 
of BaseButton
see #41529 for details
this closes #41529
 2020-10-16 14:14:04 +08:00
Hugo Locurcio
009bf148b3
Document OmniLight/SpotLight rendering limitations 2020-10-15 22:14:08 +02:00
Marcel Admiraal
c7338b8cfc Update intersect_point documentation to mention solid shapes. 2020-10-15 16:46:16 +01:00
JFonS
fcb00ca048 Disable lights for objects with baked lighting 
Don't apply lighting to objects when they have a lightmap texture and
the light is set to BAKE_ALL. This prevents applying the same direct
light twice on the same object and makes setting up scenes with mixed
lighting much easier.
 2020-10-11 20:41:40 +02:00
PouleyKetchoupp
f9544716f4 Option for software skinning in MeshInstance 
Option in MeshInstance to enable software skinning, in order to test
against the current USE_SKELETON_SOFTWARE path which causes problems
with bad performance.

Co-authored-by: lawnjelly <lawnjelly@gmail.com>
 2020-10-08 16:14:55 +02:00
Marcel Admiraal
5d548d12aa
Remove reference to 3D shapes in RigidBody2D.xml contacts description. 
(cherry picked from commit e7edbcedc9)
 2020-10-04 20:54:16 +02:00
Anant Ahuja
55d756cbab
Updated NinePatchRect's patch margin descriptions 
(cherry picked from commit 00d9432f44)
 2020-10-04 20:53:31 +02:00
Andrii Doroshenko (Xrayez)
1a71792655
Cross-reference GDScript load and ResourceLoader.load in classref 
The GDScript `load` mention is moved from the class `ResourceLoader`
description to the `ResourceLoader.load` method description instead,
where it is more likely to be found.

(cherry picked from commit a8404cf56c)
 2020-10-04 20:51:40 +02:00
Ryan Roden-Corrent
d05a07235c
Fix bound return type on get_priority. 
Also adds a description explaining gizmo priority.

Inferred from:
e4363d001a/editor/plugins/spatial_editor_plugin.cpp (L5867-L5880)
e4363d001a/editor/plugins/spatial_editor_plugin.cpp (L6462-L6470)

(cherry picked from commit c6919a13da)
 2020-10-04 20:51:19 +02:00
lolligerjoj
0586c856f6
Expose Animation::value_track_interpolate to GDscript 
(cherry picked from commit ff4af94414)
 2020-10-04 20:50:34 +02:00
Rémi Verschelde
e35687a116
Merge pull request #42478 from bruvzg/macos_dpi_32 
[3.2] Fix `get_screen_dpi` on macOS.
 2020-10-01 23:03:28 +02:00
bruvzg
610728c9f1
[3.2] Fix get_screen_dpi on macOS for non fractional display scales and update documentation. 2020-10-01 22:55:54 +03:00
Ryan Roden-Corrent
35d58c4435
Clarify store_string vs store_line. 
While the behavior can be implied from the name, it seems worth stating
it explicitly.

(cherry picked from commit 2762821c08)
 2020-10-01 16:00:47 +02:00
Duroxxigar
a726d011d5
Made toplevel a property for Node3D and CanvasItem 
(cherry picked from commit 85a8dbb7b6)
 2020-10-01 16:00:47 +02:00
Hugo Locurcio
016ea497eb
Improve the String.is_valid_ip_address() documentation 
This closes https://github.com/godotengine/godot-docs/issues/4097.

(cherry picked from commit 00ade39389)
 2020-10-01 16:00:47 +02:00
Hugo Locurcio
867b0d57d6
Improve the String comparison methods' documentation 
This closes https://github.com/godotengine/godot-docs/issues/4096.

(cherry picked from commit a2271ba3bd)
 2020-10-01 16:00:47 +02:00
Wilson E. Alvarez
5766547e33
Make "function" a property of FuncRef 
(cherry picked from commit b4e7edabf3)
 2020-10-01 16:00:47 +02:00
Rémi Verschelde
4ad74609ce
Merge pull request #40205 from bruvzg/click-through-3 
[3.2] Add mouse event pass-through support for window.
 2020-10-01 13:58:24 +02:00
Rémi Verschelde
ef223f3aa7
Merge pull request #41185 from Chaosus/vs_uniform_ref_3.2 
[3.2] Added UniformRef visual shader node
 2020-10-01 13:50:08 +02:00
Sergey Minakov
42de81e235 iOS: move touch delay to settings 2020-10-01 12:36:57 +03:00
Rémi Verschelde
66cbcc1b7e
Merge pull request #41123 from lawnjelly/octree_fix 
Optimize octree and fix leak
 2020-09-30 23:11:31 +02:00
Rémi Verschelde
aaf0b32e91
doc: Sync classref with current source 2020-09-29 13:57:58 +02:00
follower
0d8cbd5d8c
Doc clarity/detail for extra spacing properties 
Re: Space spacing being in addition to character spacing see:

 * <d7b85fbaa1/scene/resources/dynamic_font.cpp (L858-L859)>

Re: Value being able to be negative see example here:

 * <https://github.com/godotengine/godot/issues/38630>

But also note that nodes other than `Label` may not currently render extra space spacing correctly.

(cherry picked from commit 2ef89e0b43)
 2020-09-29 13:57:58 +02:00
Megamega53
6bfaa8a8c9
doc: Some improvements to KinematicBody docs 
Co-authored-by: Marcel Admiraal <madmiraal@users.noreply.github.com>
Co-authored-by: Rémi Verschelde <rverschelde@gmail.com>
(cherry picked from commit ca5ae64525)
 2020-09-29 13:57:58 +02:00
Justin Lee
52b3324e58
doc: Improve distance_fade documentation 
Changed the documentation of distance_fade_max_distance and min
to be consistent with the behavior of the code as well as the user
documentation. Also noted the behavior of swapping max_distance and
min_distance (where max_distance < min_distance).

Fixes #36051.

Co-authored-by: Clay John <claynjohn@gmail.com>
(cherry picked from commit 90d1eda90e)
 2020-09-29 13:57:58 +02:00
andriyDev
98eb6e4af6
Added inspector_only option to inspect_object in EditorInterface. 
Updated docs to reflect change to inspect_object.

(cherry picked from commit 45a1c6f278)
 2020-09-29 13:57:57 +02:00
Hugo Locurcio
00e4be1926
Document the BaseMaterial3D billboard mode not being suited for VR 
See #41567.

(cherry picked from commit ecc47ce235)
 2020-09-29 13:57:57 +02:00
Haoyu Qiu
9bf09a909b
Surrounds boolean false with code tag 
(cherry picked from commit aa7ce12bee)
 2020-09-29 13:57:56 +02:00
skyace65
a2c4564dc3
Move note about using Resource in the File documentation 
(cherry picked from commit 75c5a8b354)
 2020-09-29 08:54:45 +02:00
skyace65
1257beac96
Add documentation for shelf filters 
(cherry picked from commit 75adefd4b6)
 2020-09-29 08:54:44 +02:00
Hugo Locurcio
28be48fb67
Reference the Color constants cheatsheet in the class reference 
(cherry picked from commit de49085567)
 2020-09-29 08:54:44 +02:00
Hugo Locurcio
c33373b80a
Reference the BaseButton class explicitly in button class documentations 
Users are sometimes confused as to the `pressed` property not being
visible in the Button class documentation. This is because `pressed`
is defined in BaseButton.

(cherry picked from commit 038baede5a)
 2020-09-24 14:43:12 +02:00
Hugo Locurcio
6036fdab70
Cross-reference AABB and Rect2 in the class reference 
(cherry picked from commit e9eddb4f1f)
 2020-09-24 14:43:12 +02:00
Hugo Locurcio
f568413e8d
Document RichTextLabel.append_bbcode() not closing previously open tags 
This closes #42216.

(cherry picked from commit 3e1457f517)
 2020-09-24 14:43:11 +02:00
Hugo Locurcio
575aa3efe3
Document that the JavaScript singleton may be disabled at build-time 
(cherry picked from commit 0422027f07)
 2020-09-24 14:43:11 +02:00
Leleat
27b09083fc
add description for ScriptEditor.open_script_create_dialog() 
(cherry picked from commit adb205a150)
 2020-09-24 14:43:11 +02:00
Hugo Locurcio
92a85b4445
Improve documentation about VideoPlayer video formats 
This closes https://github.com/godotengine/godot-docs/issues/4021.

(cherry picked from commit 1efe57848a)
 2020-09-24 14:43:11 +02:00
Michael Alexsander
2d848227cf
Add 'get_previous_tab()' to 'Tabs' 
(cherry picked from commit 2b319889cb)
 2020-09-24 14:43:10 +02:00
Jonathan Vice
96ca267209
Reorder sprite h_frames & v_frames 
(cherry picked from commit 28326aec60)
 2020-09-24 14:43:10 +02:00
Yilin Ma
d571de5f81
added load resource pack with offset feature 
(cherry picked from commit c524d50444)
 2020-09-24 14:43:09 +02:00
Hugo Locurcio
e07ac3d77e
Fix a typo in the Array class documentation 
This closes https://github.com/godotengine/godot-docs/issues/4049.

(cherry picked from commit 603eddce86)
 2020-09-24 14:43:07 +02:00
Somnath Sarkar
1f7a3e0f8d
Sort points in a Gradient for color and offset updates. 
(cherry picked from commit d5d832417e)
 2020-09-24 14:43:06 +02:00
Aaron Franke
76a8458753
Make the Import dock depend on the FileSystem dock 
(cherry picked from commit de6f8f9d21)
 2020-09-24 14:43:05 +02:00
Rémi Verschelde
c8859f0463
Fix typos with codespell 
Using codespell 1.17.1.

Method:
```
$ cat > ../godot-word-whitelist.txt << EOF
ang
curvelinear
dof
doubleclick
fave
findn
leapyear
lod
merchantibility
nd
numer
ois
ony
que
seeked
synching
te
uint
unselect
webp
EOF

$ codespell -w -q 3 -I ../godot-word-whitelist.txt --skip="./thirdparty,*.po"
$ git diff // undo unwanted changes
```
 2020-09-18 14:09:51 +02:00
Marcel Admiraal
fc72c3fdf5 Remove the unnecessary sync() and the restrictions it imposes on 3D Physics. 2020-09-18 10:42:59 +01:00
bruvzg
e51fed9d1b
[3.2] Add window click-through support. 2020-09-17 12:36:01 +03:00
Hugo Locurcio
939de03db7
Cross-reference AABB getter methods in the documentation 
This also clarifies that `get_aabb()` returns the AABB in local space.

See https://github.com/godotengine/godot/issues/42095.

(cherry picked from commit 9712f8fd2d)
 2020-09-16 16:22:39 +02:00
Hugo Locurcio
369e5a7f35
Mark InterpolatedCamera as deprecated 
InterpolatedCamera has already been removed from the `master` branch.
This adds a deprecation notice to inform people about the upcoming removal
in Godot 4.0.

Its functionality could be replicated in a GDScript add-on with relative
ease.
 2020-09-16 15:36:40 +02:00
Rémi Verschelde
16eb7b95be
Merge pull request #42102 from Calinou/doc-animationtreeplayer-deprecation 
Mention the AnimationTreePlayer deprecation in the class reference
 2020-09-16 08:13:27 +02:00
Hugo Locurcio
868776949b
Mention the AnimationTreePlayer deprecation in the class reference 
There's a node configuration warning already, but you can only
see it after adding the node to your scene.
 2020-09-16 00:19:32 +02:00
Hugo Locurcio
34a0af8343
Clarify that 2D cell sizes are defined in pixels 
See https://github.com/godotengine/godot/issues/40577#issuecomment-662329021.

(cherry picked from commit f83249f224)
 2020-09-15 19:26:43 +02:00
Danil Alexeev
06f3cd8bd8
Several documentation improvements 
(cherry picked from commit a4c5790350)
 2020-09-15 19:26:40 +02:00
Hugo Locurcio
738f6ea221
Document how to remove metadata from an Object 
This closes https://github.com/godotengine/godot-docs/issues/4010.

(cherry picked from commit cba4d73b71)
 2020-09-14 14:24:14 +02:00
Ebrahim Ebrahim
508dde662a
Clarify get_data Image method 
(cherry picked from commit b9764b6109)
 2020-09-14 11:00:50 +02:00
skyace65
de9a5b6229
Improve AudioEffectDistortion and AudioEffectFilter documentation 
(cherry picked from commit 959f2287f6)
 2020-09-14 11:00:49 +02:00
Hugo Locurcio
e36587751f
Rename the type parameter to node_type in Theme and Control 
This makes it clearer that it expects a node type as a string (such as "Label")
instead of a type like "TYPE_ARRAY". This is backwards-compatible since only
the name of the parameter is changed, not its order.

See https://github.com/godotengine/godot-proposals/issues/1495#issuecomment-691507839
 2020-09-12 18:42:45 +02:00
Hugo Locurcio
74952764f3
Improve documentation related to Array error handling 
This closes https://github.com/godotengine/godot-docs/issues/3834.

(cherry picked from commit 263f620421)
 2020-09-10 12:04:07 +02:00
Hugo Locurcio
2bc6298bce
Document that batching is only effective when using the GLES2 renderer 2020-09-09 00:58:25 +02:00
Rémi Verschelde
4a9264271d
doc: Sync classref with current source 2020-09-08 14:20:53 +02:00
Hugo Locurcio
77a6766b3e
Clarify the required child node type in the GridContainer documentation 
This closes #41822.

(cherry picked from commit 40b5331d79)
 2020-09-08 08:56:13 +02:00
Hugo Locurcio
c040e8f93a Document missing character behavior when drawing text with fonts 
See #40405.

(cherry picked from commit 7735d8d0ce)
 2020-09-04 08:50:32 +02:00
Yetizone
e882d535a7 Mention Viewport.render_target_clear_mode property is intended for 2D usage 2020-09-03 07:57:01 +03:00
Hugo Locurcio
d773de6d24
Document how renaming the project affects the user data path 
(cherry picked from commit 386f86cddf)
 2020-09-01 21:02:19 +02:00
Hugo Locurcio
be126bfd55
Document RigidBodies in character mode never sleeping automatically 
See #7996.

(cherry picked from commit 5fbf709ca2)
 2020-09-01 21:01:58 +02:00
umarcor
b0a6439df9
doc/FileDialog: warn about access limitations in sandboxed apps 
Co-authored-by: Rémi Verschelde <rverschelde@gmail.com>
(cherry picked from commit 1ddb0e56ac)
 2020-09-01 21:01:32 +02:00
Hugo Locurcio
ef7675a053
Document support for normal and specular maps in AnimatedSprite2D 
This closes #38509.

(cherry picked from commit 8d0099f5fc)
 2020-09-01 21:00:58 +02:00
Hugo Locurcio
cc3b69cf7b
Reference the online documentation in collision layer/mask properties 
See https://github.com/godotengine/godot-docs/pull/3863.

(cherry picked from commit c73c327bab)
 2020-08-31 15:55:11 +02:00
Andreas Gustafsson
727bce727b
OptionButton.xml word order fix 
Change word order of 'Emitted the when...' into 'Emitted when the...'

(cherry picked from commit 8f082d63c6)
 2020-08-31 15:29:44 +02:00
Tomasz Chabora
57810f851c
Explain editor usage of current_animation 
(cherry picked from commit 70ce86ad29)
 2020-08-31 15:29:43 +02:00
Maganty Rushyendra
fdb5561e55
Updated cursor positioning description for File open() 
Added more details about the cursor offsets for the different ModeFlags
in the `File` class.

(cherry picked from commit 5e77eea216)
 2020-08-31 15:29:43 +02:00
Hugo Locurcio
1f7f28a1eb
Document HTTPRequest not supporting request data with GET method 
This also improves the HTTPClient class documentation to be easier
to read and more informative.

This closes #40564.

(cherry picked from commit 2f577facc9)
 2020-08-31 15:29:43 +02:00
Hugo Locurcio
6eee52e49b
Improve the documentation related to overriding GUI theme items 
Overriding theme items is a common point of confusion.
Hopefully, these code samples should clear things up.

(cherry picked from commit 2a8bbda2a7)
 2020-08-31 15:29:43 +02:00
skyace65
92a1c168ea
Clarify get_data texture method 
(cherry picked from commit 635c9761a0)
 2020-08-31 15:29:43 +02:00
Hugo Locurcio
dd057d36dc
Document the GDScript debugger not supporting Thread yet 
See https://github.com/godotengine/godot/issues/2446.

(cherry picked from commit dec20883c1)
 2020-08-31 15:29:42 +02:00
Hugo Locurcio
a23c0aca87
Clarify that KEY_BACK is unrelated to the Back button on Android 
This closes #19325.

(cherry picked from commit 359c95156a)
 2020-08-31 15:29:42 +02:00
skyace65
dea530d5ca
Add information to get thread id 
(cherry picked from commit aa08023115)
 2020-08-31 15:29:42 +02:00
skyace65
14e1c83350
Improve touch screen button description 
(cherry picked from commit 416cac96fa)
 2020-08-31 15:29:42 +02:00
skyace65
45e596e02f
Document where the center of mass is for RigidBody nodes 
(cherry picked from commit 555f4f3e17)
 2020-08-31 15:29:42 +02:00
Hugo Locurcio
96ad9dc4c6
Document supported platforms for Input.get_accelerometer() and related 
This closes #41303.

(cherry picked from commit eee704e6f6)
 2020-08-31 15:29:41 +02:00
skyace65
8466f9147b
Mention listener node in AudioStreamPlayer3D description 
(cherry picked from commit 51367c1bcf)
 2020-08-31 15:29:41 +02:00
Michael Alexsander
d7065106ef
State how 'MOUSE_MODE_CAPTURED' actually works in the 'Input' docs 
(cherry picked from commit 4f13a7f47f)
 2020-08-31 15:29:41 +02:00
skyace65
2e1e1af1d2
Add defaults to tilemap set_cell function example 
(cherry picked from commit 43ab91ca02)
 2020-08-31 15:29:41 +02:00
Hugo Locurcio
b76aa91402
Mention performance caveats about find_node() and find_parent() 
See https://github.com/godotengine/godot-proposals/issues/1303.

(cherry picked from commit ab2f41f598)
 2020-08-31 15:29:31 +02:00
Rémi Verschelde
7d825e2c05
Merge pull request #41046 from Calinou/doc-windowdialog-exclusive 
Mention caveats for `popup_exclusive` in the WindowDialog documentation
 2020-08-31 13:24:09 +02:00
hhsdev
90ba819e7b Documentation: specify how WindowDialog's default title bar is made 2020-08-31 16:17:53 +06:30
Hugo Locurcio
3b080845a8
Link to 2D Sprite animation tutorial in relevant class documentations 
(cherry picked from commit 6d62e8b917)
 2020-08-25 12:58:31 +02:00
Tomasz Chabora
e880956943
Mention that body_set_state is deferred 
(cherry picked from commit 255129a5d9)
 2020-08-25 12:58:24 +02:00
Rémi Verschelde
dbb0ad3b59
doc: Sync classref with current source 2020-08-21 02:33:44 +02:00
skyace65
5954f82e44
Update CollisionShape2D doc 
(cherry picked from commit fe8d998858)
 2020-08-21 02:28:28 +02:00
skyace65
cd2da16d63
Clarify points in Line2D doc 
(cherry picked from commit 3c9c541c59)
 2020-08-21 02:28:18 +02:00
Hugo Locurcio
13175b6387
Document limitations related to centering text with RichTextLabel 
This is a relatively common question on various community channels.

(cherry picked from commit 95c2e43095)
 2020-08-21 02:28:18 +02:00
Hugo Locurcio
f90931c47a
Add more error explanations in the BMP image loader 
This closes #32166 and closes #30629.

(cherry picked from commit 40485e2479)
 2020-08-21 02:28:17 +02:00
Hugo Locurcio
a6f0810d51
Make the lack of AtlasTexture support in AnimatedTexture more prominent 
See https://github.com/godotengine/godot/issues/33855.

(cherry picked from commit a7ad7ce3bd)
 2020-08-21 02:28:17 +02:00
Yetizone
5bc06c7014 Viewport Usage enumeration 
Mention that 3D effects are not available when using USAGE_2D
 2020-08-20 17:54:14 +03:00
Rémi Verschelde
9bf5a0b791
Merge pull request #41081 from naithar/feature/ios-framework-import-3.2 
[iOS] [3.2] Export: Add a method to embed a framework
 2020-08-19 14:11:27 +02:00
Sergey Minakov
910c554a1a iOS Export: Add a method to embed a framework 
By default 'add_ios_framework' would not embed a framework to save previous behavior.
New 'add_ios_embedded_framework' would embed framework on export.
 2020-08-19 14:54:59 +03:00
Rémi Verschelde
5a3096a1cd
Merge pull request #41088 from clayjohn/DOCS-32-Sprite3D 
Update Sprite3D docs to reflect recent changes
 2020-08-18 23:38:58 +02:00
lawnjelly
667c970b77 Optimize octree and fix octree leak 
Prevents adding new octants until a limiting number of elements have been added to the current octant. This enables balancing the benefits of brute force against the benefits of spatial partitioning. The limit can be set per octree.

Project settings are added for rendering octree to set the best balance per project depending on number of tests per frame / tick, and the amount of editing of the octree.

Fixes octants being leaked when removing elements.

Optimize octree with cached linear lists

Storing elements in octants using linked lists is efficient for housekeeping but very slow for testing. This optimization stores additional local_vectors with Element pointers and AABBs which are cached and only updated when a dirty flag is set on the octant.

This is selectable with 2 versions of Octree : Octree and Octree_CL, Octree being the old behaviour. At present the cached list version is only used for the visual server octree (rendering) as it has only been demonstrated to be faster there so far.

This uses slightly more memory (probably a few kb in most cases) but can be significantly faster during testing (culling etc).

Co-authored-by: Sergey Minakov <naithar@icloud.com>
 2020-08-18 11:02:21 +01:00
Hugo Locurcio
62256e0b3a Reference Range signals in the Slider class documentations 
See https://github.com/godotengine/godot-docs/issues/3837.

(cherry picked from commit eaa52cbb36)
 2020-08-17 11:05:04 +02:00
Hugo Locurcio
d4740ee643 Document the lack of kerning support in DynamicFont 
(cherry picked from commit e506479fce)
 2020-08-17 11:04:32 +02:00
Rémi Verschelde
e283d4b5c8 Update AUTHORS and DONORS list 
New contributors added to AUTHORS:
@hinlopen, @naithar, @rrcore, @SkyLucilfer, @TwistedTwigleg

Thanks to all contributors and donors for making Godot possible!

---

Also changes to relevant code that parses the DONORS.md to match
the new tiers.

(cherry picked from commit d2d4c1c957)
 2020-08-14 00:32:05 +02:00
Tomasz Chabora
7ce476c425 Expose NOTIFICATION_POST_ENTER_TREE 
(cherry picked from commit 677796a2c3)
 2020-08-14 00:32:05 +02:00
Thakee Nathees
b62872d5bc Documentation: clarify the indent parameter of JSON.print 
(cherry picked from commit 3609351788)
 2020-08-14 00:32:05 +02:00
Tomasz Chabora
f592600ee8 Mention that Array.front/back throw error if empty 
(cherry picked from commit 4ff1a34171)
 2020-08-14 00:32:05 +02:00
Hazar
58a30199b4 grow_mask() description added 
Description;
> Applies morphological dilation to the bitmap. The first argument is the dilation amount, Rect2 is the area where the dilation will be applied.

(cherry picked from commit 1c61c8ab55)
 2020-08-14 00:32:05 +02:00
Tomasz Chabora
5433b8470c Improve Vector2.angle() description 
(cherry picked from commit a09078e64b)
 2020-08-14 00:32:05 +02:00
Yuri Roubinsky
d0c705781c [3.2] Added UniformRef visual shader node 2020-08-11 15:04:06 +03:00
Martin Capitanio
71bad8dba6 Add option to disable virtual keyboard for TextEdit 
Adding support for disabling virtual keyboard on mobile platforms, in
order to make it consistent with LineEdit.

It allows implementing a custom virtual keyboard.

See: https://github.com/godotengine/godot/pull/41139
 2020-08-09 18:22:11 +02:00
clayjohn
8fdbf61df8 Update Sprite3D docs to reflect recent changes 2020-08-06 13:10:39 -07:00
Hugo Locurcio
793694fc40
Mention caveats for popup_exclusive in the WindowDialog documentation 
This closes #41045.
 2020-08-05 12:01:31 +02:00
Hugo Locurcio
fc7451204e Improve JSON-related documentation 
This closes https://github.com/godotengine/godot-docs/issues/3848.

(cherry picked from commit 930e10ffff)
 2020-07-31 13:09:21 +02:00
codetorex
3869b82bc1 Added missing information about File.open_encrypted function to docs. 
(cherry picked from commit 3f6a7c74e3)
 2020-07-31 13:08:59 +02:00
TheDuriel
7e9b7b0462 Clarify TreeItem return values 
(cherry picked from commit 0ff1ca4655)
 2020-07-31 13:08:40 +02:00
Hugo Locurcio
7c728f0ee4 Add an example for creating a button in the Button class documentation 
This closes https://github.com/godotengine/godot-docs/issues/3798.

(cherry picked from commit 8836c7203b)
 2020-07-31 13:08:24 +02:00
Hugo Locurcio
2987fb3b45 Improve the EditorInterface.get_editor_viewport() description 
This closes https://github.com/godotengine/godot-docs/issues/1109.

(cherry picked from commit 60d40d8430)
 2020-07-30 16:27:11 +02:00
Hugo Locurcio
2494224f96 Link to Thread-safe APIs in the Thread class documentation 
This closes https://github.com/godotengine/godot-docs/issues/2276.

(cherry picked from commit f50a4b8a3b)
 2020-07-30 16:26:55 +02:00
Rémi Verschelde
6d2f8dd827 doc: Sync classref with current source 2020-07-30 16:26:45 +02:00
Rémi Verschelde
19802f7dc0
Merge pull request #33646 from NeoSpark314/gles2_highp 
Added option to enable high precision float in GLES2
 2020-07-30 07:52:29 +02:00
Holger Dammertz
efe6b50f17 Added option to enable high precision float in GLES2 
An additional project setting under rendering/gles2/compatibility with the name
enable_high_float.Android is introduced that enables #define USE_HIGHP_PRECISION
in GLES2 shader on Android when it is supported by the shader compiler.
This fixes #33633 and #32813 and also https://github.com/GodotVR/godot_oculus_mobile/issues/60
and https://github.com/GodotVR/godot_oculus_mobile/issues/68 on devices that
support the highp (high precision) modifier.
 2020-07-30 05:40:15 +02:00
Hugo Locurcio
4a0568b609 Document how to perform advanced string splitting using RegEx 
This closes https://github.com/godotengine/godot-docs/issues/3607.

(cherry picked from commit 5f2b6bd476)
 2020-07-29 18:24:00 +02:00
Hugo Locurcio
bd76fcd43b Add an example to the CanvasItem.draw_string() documentation 
This closes https://github.com/godotengine/godot-docs/issues/3374.

(cherry picked from commit 0c7735be5b)
 2020-07-29 18:23:45 +02:00
Hugo Locurcio
b3effe5faa Fix incorrect key name in the Animation documentation code sample 
This closes https://github.com/godotengine/godot-docs/issues/3841.

(cherry picked from commit 4257aa5c5c)
 2020-07-29 18:23:31 +02:00
Rémi Verschelde
36b746d903
Merge pull request #40822 from Calinou/doc-canvasitem-draw_multiline_colors-antialiased 
Document `CanvasItem.draw_multiline_colors()` not supporting width and AA
 2020-07-29 12:45:17 +02:00
Hugo Locurcio
39ec3ad2e5 Document CanvasItem.draw_multiline_colors() not supporting width and AA 2020-07-29 11:45:49 +02:00
Nathan Franke
9de0439a45
Revert "Follow-Up Fix Directory Open" 
This reverts commit ec787f0134.
 2020-07-28 13:53:57 -04:00
Rémi Verschelde
e82e9588fd doc: Sync classref with current source 2020-07-28 11:50:39 +02:00
Hugo Locurcio
451648c34d Improve visibility documentation for CanvasItem and Node3D 
This closes https://github.com/godotengine/godot-docs/issues/3840.

(cherry picked from commit 27b09dfc44)
 2020-07-28 00:53:16 +02:00
Marcel Admiraal
cdb3712992 Clarify the difference between contacts and collisions. 
(cherry picked from commit 6f1c99e5b4)
 2020-07-28 00:52:07 +02:00
Hugo Locurcio
b717a61903 Improve the Object, Reference and Resource class documentations 
(cherry picked from commit 4275e6aad5)
 2020-07-28 00:48:33 +02:00
Hugo Locurcio
508388a9fd Document an example dictionary returned by TileSet.tile_get_shapes() 
(cherry picked from commit 60bb80505f)
 2020-07-28 00:39:49 +02:00
Rémi Verschelde
400a780050 Revert "Allow Area2D and 3D mouse events without a collision layer" 
This reverts commit 15850687a8.
 2020-07-27 22:46:04 +02:00
Rémi Verschelde
a2edf04fd2
Merge pull request #40469 from nekomatata/virtual-keyboard-enter-fixes-3.2 
[3.2] Fix Return key events in LineEdit & TextEdit on Android
 2020-07-26 20:26:02 +02:00
Rémi Verschelde
b3d46d4809
Merge pull request #40675 from Calinou/doc-texturerect-viewporttexture 
Document ViewportTexture flipping in TextureRect
 2020-07-24 23:32:46 +02:00
Hugo Locurcio
5589529cf3
Document ViewportTexture flipping in TextureRect 2020-07-24 22:30:58 +02:00
Rémi Verschelde
b40f3f9740 Style: Sync other changes from new fix_style.sh and clang_format.sh 2020-07-24 10:39:18 +02:00
QbieShay
53a3476fc2 fixed documentation for get_hit_length of spring arm 3D 
Co-authored-by: Hugo Locurcio <hugo.locurcio@hugo.pro>
(cherry picked from commit d1bff73611)
 2020-07-24 10:31:57 +02:00
follower
0fdfa47929 Fix presumed copy/paste error: "Returns" -> "Sets" 
I might be going out on a limb here... :D

(cherry picked from commit e38b63400c)
 2020-07-24 10:31:57 +02:00
Hugo Locurcio
ad18e16389 Document polling rate limitations in InputEventMouseMotion 
This closes #40579.

(cherry picked from commit 924b7ea2f5)
 2020-07-24 10:31:57 +02:00
PouleyKetchoupp
930c880fa6 Add option to disable virtual keyboard for LineEdit 
Co-authored-by: Alexander Holland <alexander.holland@live.de>
(cherry picked from commit 0aa56e3ab8)
 2020-07-24 10:31:57 +02:00
Hugo Locurcio
7078d33fa1 Document HTML5 CORS restrictions in HTTPClient and HTTPRequest 
See https://github.com/godotengine/godot/issues/40247.

(cherry picked from commit 90db42d9db)
 2020-07-24 10:31:57 +02:00
Andrii Doroshenko (Xrayez)
6416df8e34 Document the process of parsing command-line arguments 
Co-authored-by: Hugo Locurcio <hugo.locurcio@hugo.pro>
(cherry picked from commit df80e259cd)
 2020-07-24 10:31:57 +02:00
Hugo Locurcio
606d4270c6 Document several editor-related classes to 100% completion 
(cherry picked from commit fb2e4d77eb)
 2020-07-24 10:31:57 +02:00
Hugo Locurcio
0e44834cd3 Improve the VisibilityNotifier and VisibilityEnabler class descriptions 
(cherry picked from commit ce57cc43dd)
 2020-07-24 10:31:57 +02:00
Hugo Locurcio
52a33a8066 Complete the EditorSettings class documentation 
EditorSettings is now 100% documented.

(cherry picked from commit 708a0a43fb)
 2020-07-24 10:31:57 +02:00
Hugo Locurcio
7e9a51cdd5 Mention toggled signal for pressed state in BaseButton documentation 
This closes #40455.

(cherry picked from commit 43dae28e9d)
 2020-07-24 10:31:57 +02:00
Hugo Locurcio
753ff1fad2 Mention the Data paths documentation in the File class 
This closes https://github.com/godotengine/godot-docs/issues/3799.

(cherry picked from commit d4085d6bfb)
 2020-07-24 10:31:57 +02:00
Ryan Roden-Corrent
c77492408a Clarify how to convert PrimitiveMesh to ArrayMesh. 
It took me a bit to figure this out, as I was initially doing something
more complicated like this before I realized I just had to pass
get_mesh_arrays directly to add_surface_from_arrays.

```
var arr_mesh = ArrayMesh.new()
var arrays = []
arrays.resize(ArrayMesh.ARRAY_MAX)
arrays[ArrayMesh.ARRAY_VERTEX] = c.get_mesh_arrays()
arr_mesh.add_surface_from_arrays(Mesh.PRIMITIVE_TRIANGLES, arrays)
```

(cherry picked from commit 933bf96523)
 2020-07-24 10:31:57 +02:00
Hugo Locurcio
5c7802a061 Document which escape sequences are supported by String.c_unescape() 
See https://github.com/godotengine/godot/issues/38716.

(cherry picked from commit 04b25108ac)
 2020-07-24 10:31:57 +02:00
Hugo Locurcio
11bceb3d62 Document caveats related to Control scaling 
This is a common topic of confusion. Clarifying its intended scope
should make things easier to understand.

(cherry picked from commit a36912b3cb)
 2020-07-24 10:31:56 +02:00
Aaron Franke
3ab5183ffa
[3.2] Backport core documentation changes to 3.2 
Also add AABB.abs()
 2020-07-21 21:22:54 -04:00
Rémi Verschelde
7b4b83e9dc
Merge pull request #39817 from yrk06/ExposeInertiaTensor 
Added Rigid Body Method "get_inverse_inertia_tensor"
 2020-07-21 16:50:56 +02:00
Pedro J. Estébanez
06904ac215 Add DynamicFont::get_available_chars() 2020-07-20 17:45:04 +02:00
Yerik
d09b16512b Added Method get_inverse_inertia_tensor 2020-07-19 13:51:32 -03:00
PouleyKetchoupp
c0b394572f Fix Return key events in LineEdit & TextEdit on Android 
Depending on the device implementation, editor actions could be
received with different action ids or not at all for multi-line.

Added a parameter to virtual keyboards to properly handle single-line
and multi-line cases in all situations.

Single-line:
Input type set to text without multiline to make sure actions are sent.
IME options are set to DONE action to force action id consistency.

Multi-line:
Input type set to text and multiline to make sure enter triggers new lines.
Actions are disabled by the multiline flag, so '\n' characters are
handled in text changed callbacks.
 2020-07-17 18:25:40 +02:00
Rémi Verschelde
2244841729 doc: Sync classref with current source 2020-07-15 12:56:16 +02:00
Hugo Locurcio
e41ab634c6 Mention C# gotchas in Object's dynamic call/set/connect methods 
This closes #34015.

(cherry picked from commit 878f03d8e3)
 2020-07-15 12:48:18 +02:00
Hugo Locurcio
f7021e57d7 Document VehicleBody3D and VehicleWheel3D limitations 
These classes have dozens of open bugs and missing features
which may not be fixed anytime soon.

It's probably better to document it upfront at this point.

(cherry picked from commit 0493e7c106)
 2020-07-15 12:48:18 +02:00
Fabio Alessandrelli
91b2d020a8 Document updated UDPServer interface. 
(cherry picked from commit 839c7b1ba3)
 2020-07-15 12:48:18 +02:00
Rémi Verschelde
3de89f78e5
Merge pull request #40265 from Calinou/doc-node-clarify-add-child-below-node 
Clarify the node parameters in `Node.add_child_below_node()` docs
 2020-07-14 09:41:57 +02:00
Hugo Locurcio
fb736018c5
Clarify the node parameters in Node.add_child_below_node() docs 
This closes https://github.com/godotengine/godot-docs/issues/3769.
 2020-07-11 12:23:41 +02:00
Tomasz Chabora
15850687a8 Allow Area2D and 3D mouse events without a collision layer 
Co-authored-by:    Tomasz Chabora <kobewi4e@gmail.com>
 2020-07-11 11:14:12 +01:00
Hugo Locurcio
c2a4ce9380 Enable file logging by default on desktops to help with troubleshooting 
- Use the `.log` file extension (recognized on Windows out of the box)
  to better hint that generated files are logs. Some editors provide
  dedicated syntax highlighting for those files.
- Use an underscore to separate the basename from the date and
  the date from the time in log filenames. This makes the filename
  easier to read.
- Keep only 5 log files by default to decrease disk usage in case
  messages are spammed.

(cherry picked from commit 20af28ec06)
 2020-07-10 11:03:32 +02:00
Nathan Franke
ec787f0134 Follow-Up Fix Directory Open 
(cherry picked from commit 6952458538)
 2020-07-10 10:21:39 +02:00
Hugo Locurcio
4a0fe1adb3 Add a POST request example to the HTTPRequest class documentation 
(cherry picked from commit 54db59be67)
 2020-07-10 10:09:01 +02:00
Bob Gardner
8f0d50c3ec Update Resource.xml to explain behavior of duplicate when subresources is true and a subresource contains further nested resources. 
Updated documentation for duplicate() on Resource to better explain the behavior. As per #30385.

(cherry picked from commit 660a780c3b)
 2020-07-10 09:00:02 +02:00
Hugo Locurcio
6eb1a2eacb Document how to instance a PackedScene and add it as a child 
This information was already present in `@GDScript.preload()`,
but it's not easy to find.

This closes https://github.com/godotengine/godot-docs/issues/3338.

(cherry picked from commit 23d929d540)
 2020-07-10 08:51:21 +02:00
Hugo Locurcio
81f448aa5d Mention SceneTree.create_timer() in the Timer class documentation 
This closes https://github.com/godotengine/godot-docs/issues/2349
(as the linked method already contains an example).

(cherry picked from commit 1261f47c35)
 2020-07-10 08:51:21 +02:00
bruvzg
e9ab41b71d
[macOS, 3.2] Implement seamless display scaling. 2020-07-07 22:54:33 +03:00
Rémi Verschelde
07b24de868
Merge pull request #38724 from madmiraal/fix-8368-3.2 
[3.2] Support SDL2 half axes and inverted axes mappings.
 2020-07-06 23:10:47 +02:00
Yuri Sizov
2b4773f0cf Expose methods to play scene from plugin code 
(cherry picked from commit 49f6dc5004)
 2020-07-06 19:00:56 +02:00
Rémi Verschelde
1f886d1f31
Merge pull request #39867 from clayjohn/Sprite3D-mesh 
Use mesh instead of immediate for drawing Sprite3D
 2020-07-06 16:36:27 +02:00
Rémi Verschelde
fcce1ca8c4 doc: Sync classref with current source 2020-07-06 14:32:13 +02:00
Hugo Locurcio
d4f4e0d7dc Fix String.capitalize() description to follow camelCase changes 
This closes #40093.

(cherry picked from commit 887099680a)
 2020-07-06 14:16:49 +02:00
Slooth
d4d57476ad Add documentation for minimap_draw and minimap_width 
(cherry picked from commit df8f0e6215)
 2020-07-06 14:14:23 +02:00
clayjohn
6c0ff26f35 Use mesh instead of immediate for drawing Sprite3D 2020-07-03 12:19:26 -06:00
Slooth
c29da0e2fe Update TextEdit select and select_all methods 
(cherry picked from commit b2471edf45)
 2020-07-03 15:37:58 +02:00
Slooth
62677d7da1 Add documentation for selecting_enabled 
(cherry picked from commit bc1ea1cbad)
 2020-07-03 15:37:58 +02:00
Slooth
a8d499723f Add documentation for center_viewport_to_cursor method 
(cherry picked from commit 654d33866b)
 2020-07-03 15:34:30 +02:00
Slooth
aacbdebda3 Add documentation for shortcut_keys_enabled 
(cherry picked from commit d838282191)
 2020-07-03 15:34:30 +02:00
Aaron Franke
3fd7c33f39 Fix incorrect documentation for Vector2.angle() 
(cherry picked from commit 299c3ec1c1)
 2020-07-03 15:34:30 +02:00
Andrii Doroshenko (Xrayez)
f50c88ba7b Clarify Geometry.offset_polygon_2d regarding vertices translation 
The method is used to either inflate or deflate a polygon.
For translating/transforming a polygon, use `Transform2D.xform`.

(cherry picked from commit 19b72da35d)
 2020-07-03 13:17:57 +02:00
Hugo Locurcio
8cc3d4bda6 Keep the bottom panel visible when enabling the distraction-free mode 
- Document the `EditorInterface.distraction_free_mode` property.

This closes https://github.com/godotengine/godot-proposals/issues/951.

(cherry picked from commit e6352d1daa)
 2020-06-29 10:46:05 +02:00
Marcel Admiraal
ebff150680 Support SDL2 half axes and inverted axes mappings. 2020-06-26 06:28:56 +01:00
Andreas Gustafsson
68c273fb09 Tween.xml word order fix 
Change the word order of '...the where...' into '...where the...'.

(cherry picked from commit 5181daaf9e)
 2020-06-24 22:52:05 +02:00
Meriipu
d2347bc4ec Clarify what a string being empty means 
Should close https://github.com/godotengine/godot-docs/issues/2432

(cherry picked from commit 2643b8fa5e)
 2020-06-24 22:52:05 +02:00
Dylan
198bd4cb0f Environment doc update regarding Viewport usage. 2020-06-22 17:59:44 -04:00
Rémi Verschelde
8fd861ab11 doc: Sync classref with current source 2020-06-22 13:24:11 +02:00
skyace65
0b1d9f9d88 Fix Joint2D doc 
(cherry picked from commit a94ba7be59)
 2020-06-22 08:37:57 +02:00
Hugo Locurcio
9889641bae Document how Vector2, Vector3 and Color behave in a boolean context 
See #39731.

(cherry picked from commit 227f12478d)
 2020-06-21 21:44:02 +02:00
Aaron Franke
d9beab34c5 Update bool documentation to be more clear 
(cherry picked from commit 08577fab14)
 2020-06-21 21:42:56 +02:00
Rémi Verschelde
8ac13e50cf Move Haiku platform port to external repository 
The Haiku port now resides at:
https://github.com/godotengine/godot-haiku-platform

While we're happy to support as many Free and Open Source platforms as we can,
we need to put the main focus on the platforms that we can reasonably maintain,
and for Haiku we have been lacking maintainers ever since the port was first
merged in 2015.

The Haiku code has not been compiling and much less working at least since the
release of Godot 3.0, and while some attempts have been made at fixing things,
it's still not functional today in the `3.2` branch (and much less in `master`,
understandably).

Having it in an external repository should hopefully enable Haiku contributors
to fix issues in their own time, and possibly tag versions compatible with
past Godot releases once they are ready.

(cherry picked from commit efcc508ee5)
 2020-06-21 21:42:26 +02:00
PouleyKetchoupp
b3af0b2a39 Option in RichTextLabel for height to fit content 
(cherry picked from commit ad8081216c)
 2020-06-19 16:17:27 +02:00
Ev1lbl0w
17c87d2ec1
Expose disable_render_loop property to GDScript 2020-06-18 11:59:29 +01:00
Rémi Verschelde
bf913d6917 DocData: Skip language-specific ClassDoc without methods/constants 
Removes the useless `@C#`, `@NativeScript` and `@VisualScript` entries.

(cherry picked from commit ba0db95909)
 2020-06-18 11:29:28 +02:00
Vorblen
f46624030c Add description for "absorbent" and "rough" 
(cherry picked from commit 8acdbaa4f2)
 2020-06-18 11:29:28 +02:00
Andrii Doroshenko (Xrayez)
5084043373 Bind Shape2D draw method 
(cherry picked from commit 430d1fd795)
 2020-06-18 10:51:44 +02:00
dominiks
ff185f715a Add note about automatic window title to FileDialog documentation. 
(cherry picked from commit d2250a2320)
 2020-06-15 14:34:35 +02:00
Hugo Locurcio
4c289058ed Clarify Node virtual methdods not being called if node is orphan 
This closes #39489.

(cherry picked from commit b2ba78ff0f)
 2020-06-15 14:34:35 +02:00
31
1b58f94296 Fix Image.create_from_data use_mipmaps doc 
The Image.create_from_data doc describes the "use_mipmaps" argument as a
way to generate mipmaps, but this method only allocates and loads data.
This can cause confusion, where this function reads more or less data
than expected. Update the doc to be more specific that create_from_data
is loading the mipmaps from the raw data.

(cherry picked from commit 09b324b5b6)
 2020-06-15 14:34:35 +02:00
Hugo Locurcio
469c1b5f5e Document how to resize a SubViewportContainer to avoid stretching 
This closes #27534.

(cherry picked from commit f818a99d0b)
 2020-06-15 14:34:35 +02:00
Ricardo Prins
d42f332fc7 Add description to TileSet.is_tile_bound() method 
(cherry picked from commit 00398abf77)
 2020-06-15 14:34:35 +02:00
31
42312d7d4d Fix Material.render_priority doc: no opaque sort 
Opaque objects are rendered using the depth buffer, so the end result
appears sorted, but the opaque objects themselves are not sorted.

(cherry picked from commit 608bc8f3dc)
 2020-06-15 14:34:35 +02:00
skyace65
b181b97b6c Fix label percent visible doc description 
(cherry picked from commit a09aeefa1d)
 2020-06-15 14:34:35 +02:00
Hugo Locurcio
5a1f94ba47 Document the in operator in String, Array and Dictionary classes 
This also clarifies the `in` operator behavior in Object.

(cherry picked from commit 7f01f68226)
 2020-06-15 14:34:34 +02:00
bruvzg
2256946f79
[3.2] Add keyboard layout enumeration / set / get functions (macOS, Windows, Linux/X11). 2020-06-13 11:01:49 +03:00
Rémi Verschelde
c80ab247b7 doc: Sync classref with current source 
(cherry picked from commit fef49bff0b)
 2020-06-11 10:00:07 +02:00
Victoria Fisher
aa448a2a07 Adds full description for AudioEffectRecord.xml 
(cherry picked from commit 718221a2ff)
 2020-06-11 10:00:06 +02:00
Hugo Locurcio
c87128fa06 Improve the 3D light documentations 
See https://github.com/godotengine/godot-docs/issues/3670.

(cherry picked from commit f7e21d8e88)
 2020-06-11 10:00:06 +02:00
SaviHex
fda49b74a1 Added a "title" attribute for the link tag in the docs xml 
(cherry picked from commit 18c08f65d6)
 2020-06-11 09:44:14 +02:00
Rémi Verschelde
3fb9c776ff
Merge pull request #39437 from akien-mga/3.2-cherrypicks 
Cherry-picks for the 3.2 branch (future 3.2.2) - 8th batch
 2020-06-10 17:33:50 +02:00
Rémi Verschelde
3c7e03510c
Merge pull request #39256 from lawnjelly/tilemap_pixel2 
GLES2 batching - Add UV precision adjustment for tilemaps
 2020-06-10 15:52:00 +02:00
Hugo Locurcio
8e8861ed06 Mention ordering caveats for Dictionary.hash() 
See https://github.com/godotengine/godot/issues/27615.

(cherry picked from commit 77b89263dd)
 2020-06-10 15:30:52 +02:00
Rémi Verschelde
3202df9b5c doc: Make File store/get integer methods clearer 
Add an example on how to store signed integers on less than 64 bits,
using one bit for the signedness.

(cherry picked from commit cd25d184a5)
 2020-06-10 15:30:52 +02:00
Marcel Admiraal
7200a0eac5 Update Rigidbody 2D and 3D sleep documentation. 
(cherry picked from commit 1b738a77c1)
 2020-06-10 15:30:52 +02:00
Rémi Verschelde
51de6732c9 AStar: Make get_closest_point() deterministic for equidistant points 
Closes godotengine/godot-docs#3667.
Supersedes #39405.

(cherry picked from commit 187ba4c5a8)
 2020-06-10 15:30:52 +02:00
Michael Alexsander
2652a2d184 Add generic file icon and its modulation to the 'FileDialog' 
(cherry picked from commit 637927f803)
 2020-06-10 15:30:52 +02:00
Hugo Locurcio
0832ecc4a3
Document enlarging Particles visibility AABB when they cast shadows 
This closes https://github.com/godotengine/godot/issues/17267.
 2020-06-07 21:35:40 +02:00
lawnjelly
275183ef15 GLES2 batching - Add UV precision adjustment for tilemaps 
Scaling tilemaps can cause border artifacts around the edges of tiles. This has been traced to precision issues in the GPU. This PR adds an adjustment to allow a minor contraction of the UVs of rects in order to compensate for the incorrect classification of texels across the UV border.
 2020-06-07 16:29:40 +01:00
Rémi Verschelde
6e1af78df4
Merge pull request #39068 from lawnjelly/kessel_settings_rename 
Rename batching project settings in preparation for GLES3
 2020-06-07 14:25:50 +02:00
Pedro J. Estébanez
1ff7b0a0a9 Add shader time scaling 
Shaders' `TIME` will be affected by the new shader time scale, that is set via the also new `VisualServer::set_time_scale()`.
 2020-06-06 23:59:48 +02:00
Maganty Rushyendra
b4ca613138 Clarify usage of AnimationPlayer with AnimationTree and fill in empty method descriptions 
Add clarification to docs to explain that when an `AnimationPlayer`
object is paired with an `AnimationTree`, several properties and
methods exposed by the `AnimationPlayer` class may not work as expected.
The issues occur because an `AnimationTree` runs independently, and
uses its member `AnimationPlayer* player` primarily for its
`Map<StringName, AnimationData> animation_set`.

Added descriptions for `root_motion_track` and `get_root_motion_transform`.

(cherry picked from commit 0451248ff1)
 2020-06-04 12:16:39 +02:00
Hugo Locurcio
61da4882aa Add performance hints to the DirectionalLight shadow mode property hint 
This also clarifies some parts in the DirectionalLight documentation.

(cherry picked from commit b46756c723)
 2020-06-04 12:16:39 +02:00
Hugo Locurcio
9e01a0cd28 Add a getter and property for the editor distraction-free mode 
(cherry picked from commit cc1859efed)
 2020-06-04 12:16:39 +02:00
Hugo Locurcio
d56b9d5ebf Disable antialiasing on the DynamicFont outline as well when requested 
This partially addresses
https://github.com/godotengine/godot-proposals/issues/943.

(cherry picked from commit 2919fc7317)
 2020-06-04 12:09:40 +02:00
Maganty Rushyendra
25af738762 Expose get_char_size() from Font instead of BitmapFont 
`get_char_size()` is a public virtual function defined in the `Font`
class. Implementations exist for both `BitmapFont` and `Dynamic Font`.
However, it was only exposed to the GDScript API through the Bitmap
Font, and not for Dynamic Font.

This commit exposes the function through `Font` instead.

Fixes #23967

(cherry picked from commit a4413710f9)
 2020-06-04 12:09:39 +02:00
Gustav
26c617654e Fix ProjectSettings.save_custom documentation 
(cherry picked from commit 728c0c1e14)
 2020-06-04 12:09:39 +02:00
Maganty Rushyendra
e51767b3c0 Document usage requirement for Viewport to sample ViewportTexture as HDR 
Modified class documentation to specify that `USAGE_3D` or
`USAGE_3D_NO_EFFECTS` is required in order to use HDR in a ViewPort.

Fixes #38702
 2020-05-29 08:05:35 +08:00
lawnjelly
c7d18dec70 Rename batching project settings in preparation for GLES3 
As it now seems like we will soon have GLES3 batching working using the same intermediate layer as GLES2, it makes more sense to reuse the same batching settings for both renderers rather than duplicate project settings for GLES2 and GLES3.
 2020-05-26 18:15:35 +01:00
Rémi Verschelde
acb83db1d1 doc: Sync classref with current source 2020-05-25 17:00:22 +02:00
Rémi Verschelde
11d6c0f20d
Merge pull request #38984 from Calinou/bakedlightmap-configuration-warning 
Document known bugs in BakedLightmap
 2020-05-25 11:28:16 +02:00
Hugo Locurcio
5fb5fb135a
Document known bugs in BakedLightmap 
See #30929.
 2020-05-24 21:29:12 +02:00
Rémi Verschelde
b6c551e864
Merge pull request #38875 from bruvzg/tab_drv_sel_32 
[Windows, 3.2] Add tablet driver selection.
 2020-05-20 13:58:26 +02:00
bruvzg
71b2abbfa3
[Windows, 3.2] Add tablet driver selection. 2020-05-20 09:36:56 +03:00
Hugo Locurcio
8ebcdeb3d7 Document that Dictionary is always passed as reference 
See #38792.

(cherry picked from commit 675fea1648)
 2020-05-18 16:40:33 +02:00
Max Hilbrunner
ebc63dac30
Merge pull request #38784 from remram44/patch-1 
[DOC] Update description of Object.free() method
 2020-05-17 20:33:57 +02:00
Fredia Huya-Kouadio
a71a338c59 Implementation of the Godot Android Plugin configuration file 2020-05-16 23:09:45 -07:00
Remi Rampin
ccf5703568
Update description of Object.free() method 
Clarify that variables pointing to an object don't become `null` when that object is freed, it just makes them invalid.
 2020-05-16 12:32:41 -04:00
Rémi Verschelde
d45b96d2b1 Android: Check for deprecated GodotPaymentV3 module, direct to new plugin 
Fixes #38581.
 2020-05-15 13:32:30 +02:00
Marcel Admiraal
dd7f9b1c08 Make it clear that PhysicsDirectSpaceState is only available from 
within _physics_process().

(cherry picked from commit bb9c104695)
 2020-05-13 16:13:47 +02:00
Hugo Locurcio
47d003fbb8 Clarify that the SSL certificate setting overrides the default bundle 
See https://github.com/godotengine/godot-docs/issues/2531.
 2020-05-12 11:52:57 +02:00
Hugo Locurcio
e77313b3ed Clarify the id parameter in TileMap.get_used_cells_by_id() 2020-05-12 09:26:38 +02:00
Chris Bradfield
752f61d4fe [DOCS] minor description changes 
(cherry picked from commit 975ed93794)
 2020-05-11 11:01:13 +02:00
Tomasz Chabora
79f3725bdd Add documentation for the VisualShader nodes 
(cherry picked from commit fecf79f287)
 2020-05-11 11:01:13 +02:00
lawnjelly
dcb19ed735 Add Nvidia Workaround for GLES3 
Ported GLES2 workaround code to GLES3.
 2020-05-07 14:54:14 +01:00
Rémi Verschelde
4daba9bfc5 doc: Sync classref with current source 2020-05-07 13:47:06 +02:00
Thakee Nathees
1a39b4ea22 method bind TextEdit::set_line() added 
(cherry picked from commit b9acf1cedf)
 2020-05-07 13:43:43 +02:00
Marcel Admiraal
87de81258d Make 2D and 3D KinematicBody stop_on_slope documentation the same. 
(cherry picked from commit da13b74cc8)
 2020-05-07 13:37:19 +02:00
follower
90f9f01a2f Fix suffix property doc typo: "prefix" -> "suffix" 
(cherry picked from commit ae067413a5)
 2020-05-06 23:30:45 +02:00
bruvzg
78266c09c4
Add support for the WinTab API for pen input. (3.2) 2020-05-05 14:56:02 +03:00
Hugo Locurcio
2293cf61c6 Document the expected normal map coordinate system where relevant 
(cherry picked from commit d8808fba85)
 2020-05-05 13:41:29 +02:00
Rémi Verschelde
ef715f37d5
Merge pull request #35091 from Faless/dtls/enet 
[3.2] DTLS support + optional ENet encryption
 2020-05-05 13:40:59 +02:00
lawnjelly
53f6dafdde Added 'disable_half_float' project setting to the class reference. 
Just forgot to do this in the original PR.
 2020-05-05 09:31:10 +01:00
Rémi Verschelde
e363b65b99 doc: Sync classref with current source 2020-05-04 16:10:57 +02:00
Bastiaan Olij
02b1a5de47 Added missing spring enums for generic_6dof_joint 
(cherry picked from commit 45d1f41837)
 2020-05-04 16:10:22 +02:00
Hugo Locurcio
23ee40deff Tweak Tween cheatsheet link formatting to avoid rST conversion bug 
reStructuredText doesn't allow embedding links in bold/italic text.

(cherry picked from commit e8a2fa6b7d)
 2020-05-04 16:10:22 +02:00
Rémi Verschelde
01a085d05f
Merge pull request #38320 from lawnjelly/kessel_pr_light_join 
GLES2 2D batching - item reordering, light joining and light modulate fix
 2020-05-01 15:03:03 +02:00
Revan Ji
6a7d50403a Add set_frame, pause, and oneshot to AnimatedTexture 
Add API documentation for said changes.

(cherry picked from commit f5029e18ca)
 2020-05-01 11:00:10 +02:00
Hugo Locurcio
be56ec9e65 Document the formats supported by Image.load() 
This partially addresses #32166.

(cherry picked from commit a26649de42)
 2020-05-01 10:56:58 +02:00
Hugo Locurcio
6fb6107e6a Warn when trying to open res:// or user:// with OS.shell_open() 
`OS.shell_open()` will pass on the path directly to the OS' shell
handler (which can handle file paths or URLs). It can't handle
Godot-specific paths, so these need to be converted with
`ProjectSettings.globalize_path()` first.

(cherry picked from commit d46e411b44)
 2020-05-01 10:56:58 +02:00
Bojidar Marinov
4b58d453d4 Expose the cell_size affecting VisibilityNotifier2D precision 
Refs: #4803
(cherry picked from commit d49ff7aff7)
 2020-05-01 10:56:58 +02:00
Hugo Locurcio
782d9536f3 Improve the compression project settings documentation 
(cherry picked from commit b2b8db7897)
 2020-05-01 10:56:58 +02:00
Tomasz Chabora
6bb87d7d23 Mention how to remove TreeItem from a Tree 
(cherry picked from commit f6aec99d27)
 2020-05-01 10:56:58 +02:00
Markus Sauermann
e88cde0415 Clarify Transform scaled Method description. 
(cherry picked from commit 19c8b0be45)
 2020-05-01 10:56:58 +02:00
Avantir-Chaosfire
fd6424aa04 doc: Improve Node2D to_local/to_global description 
(cherry picked from commit 5c6f824e71)
 2020-05-01 10:56:57 +02:00
Rhathe
768f4e684c Enable setting of collision iterations in Physics2DServer 
This allows fine-tuning of collision iterations for more
accurate collision physics with a performance cost.
 2020-05-01 03:49:21 -04:00
lawnjelly
451c3fc0fb GLES2 2D batching - item reordering, light joining and light modulate fix 
Although 2D draws in painters order with strict ordering, in certain circumstances items can be reordered to increase batching / decrease state changes, without affecting the end result. This can be determined by an overlap test.

In situation with item:
A-B-A
providing the third item does not overlap the second, they can be reordered:
A-A-B

Items already contain an AABB which can be used for this overlap test.

1)
To utilise this, I have implemented item reordering (only for single rects for now), with the lookahead adjustable in project settings. This can increase performance in situations where items may not be grouped in the scene tree by texture. It can also be switched off (by setting lookahead to 0).

2)
This same trick can be used to help join items that are lit. Lit items previously would prevent joining completely, thus missing out on performance gains other than multi-command items such as tilemaps.

In this PR, lights are assigned as bits in a bitfield (up to 64, the optimization is disabled above this), and on each try_item (for joining), the bitfield for lights and shadows is constructed and compared with the previous items. If these match the 2 items can potentially be joined. However, this can only be done without changing the rendered result if an overlap test is successful.

This overlap test can be adjusted to join items up to a specific number of item references, selectable in project settings, or turned off.

3)
The legacy uniform single rect drawing routine seems to have been identified as the source of flicker, particularly on nvidia. However, it can also be up to 2x as fast. Because of the speed the batching contains a fallback where it can use the legacy single rect method, but I have now added a project setting to make this switchable. In most cases with batching it should not be necessary (as single rects are drawn less frequently) and thus the flickering can be totally avoided.

4)
This PR also fixes a color modulate bug when drawing light passes, in certain situations (particularly custom _draw routines with multiple rects).

5)
This PR also fixes #38291, a bug in the legacy renderer where light passes could draw rects in wrong position.
 2020-05-01 07:47:33 +01:00
Fredia Huya-Kouadio
9b9f70bd20 Update the documentation for ExternalTexture to match the restriction on Android platforms 2020-04-28 08:04:41 -07:00
Hugo Locurcio
ae0bc06eba Improve pitch_scale descriptions in AudioStreamPlayer documentation 
This closes #29439.

Co-authored-by: Cheeseness <contact@jbushproductions.com>
(cherry picked from commit 4751dee7f4)
 2020-04-27 10:18:41 +02:00
Hugo Locurcio
24265c498b Improve the procedural geometry class documentations 
This references Godot's winding order at the top of every
procedural geometry class, as well as referencing other classes
within a given geometry class.

A warning about ImmediateGeometry3D performance was also added.

(cherry picked from commit ed7347d73d)
 2020-04-27 10:14:42 +02:00
Hugo Locurcio
bbd381c987 Add an easing/transition type cheatsheet to the Tween documentation 
Related to https://github.com/godotengine/godot-docs/pull/3403.

(cherry picked from commit 5972a9138e)
 2020-04-27 10:12:11 +02:00
Hugo Locurcio
f3cd7e3808 Document how some editor classes should be accessed as singletons only 
This closes #37687.

(cherry picked from commit a225265b0a)
 2020-04-27 10:11:53 +02:00
Rémi Verschelde
253fc093b8 DocData: Skip unexposed classes 
Properly expose classes that we actually want accessible.

(cherry picked from commit 0ef8bcac4d)
 2020-04-21 14:15:34 +02:00
Hugo Locurcio
469f398e70 Document how to workaround UI anchor issues when using BackBufferCopy 
This closes #6880.

(cherry picked from commit f8a413bb1f)
 2020-04-21 14:11:29 +02:00
Hugo Locurcio
e8ead37725 Check for errors when saving in the ResourceSaver example documentation 
This also replaces a non-breaking space that was accidentally added in
the EditorFeatureProfile documentation.

This closes #31393.

(cherry picked from commit 2f46f1e7b1)
 2020-04-21 14:11:15 +02:00
Hugo Locurcio
3a2cdf7d5b Improve the VisibilityEnabler and VisibilityNotifier documentations 
This closes #4803.

(cherry picked from commit 7f2d602106)
 2020-04-21 14:10:50 +02:00
Rémi Verschelde
faf858fe41 Revert "Made possible to specify where to dump the contents when loading a ".pck" file" 
This reverts commit ffcfd9c8ea.

This was not so useful as is due to the way dependency paths are stored
in scenes and resources.
 2020-04-20 13:48:02 +02:00
Dominik 'dreamsComeTrue' Jasiński
ac0a55ce75 Update TextEdit docs - explaining 'override_selected_font_color' role 
(cherry picked from commit 6a0e6c2852)
 2020-04-20 11:55:47 +02:00
Marcel Admiraal
339c10889d Correct the addition of a key and the duplication of a variable name 
in Dictionary class documentation.

(cherry picked from commit 4d41535fa3)
 2020-04-20 11:55:31 +02:00
Hugo Locurcio
4e73fcc959 Document DynamicFont limitations and a possible workaround 
This closes #30014.

(cherry picked from commit 46b8e108e2)
 2020-04-20 11:55:04 +02:00
Hugo Locurcio
4f7296a869 Document image size limits 
This closes #30238.

(cherry picked from commit 5497cec7a1)
 2020-04-20 11:54:47 +02:00
Hugo Locurcio
bb753aaf17 Clarify that angles must be specified as radians in the documentation 
This closes #36356.

(cherry picked from commit cae5260dab)
 2020-04-20 11:53:40 +02:00
Rémi Verschelde
50582446ad Sync classref with current source 2020-04-17 13:43:43 +02:00
Michael Alexsander
ffcfd9c8ea Made possible to specify where to dump the contents when loading a ".pck" file 
(cherry picked from commit 3c261e0dfa)
 2020-04-17 13:00:52 +02:00
Rémi Verschelde
008e0748c1
Merge pull request #37349 from lawnjelly/kessel32_1 
GLES2 2d Batch rendering (across items)
 2020-04-17 12:55:33 +02:00
lawnjelly
72adefa5cf Add frame diagnostics for GLES2 Batch renderer 
Added project setting to enable / disable print frame diagnostics every 10 seconds. This prints out a list of batches and info, which is useful to optimize games and identify performance problems.
 2020-04-17 08:54:33 +01:00
Rémi Verschelde
07aa524a42 doc: Sync classref with current source 2020-04-16 13:02:36 +02:00
Michael Alexsander
b4429c325a Fix incorrect TabContainer documentation for 'get_tab_control()' 
(cherry picked from commit 8f925b1970)
 2020-04-16 12:57:22 +02:00
Hugo Locurcio
26614a37b8 Mention keep_pressed_outside caveat in the BaseButton documentation 
This closes #37790.

(cherry picked from commit e799dc954e)
 2020-04-16 12:57:22 +02:00
Hugo Locurcio
6c4a0ec75a Improve the Dictionary class documentation 
This closes https://github.com/godotengine/godot-docs/issues/3376.

(cherry picked from commit 88da90f2bf)
 2020-04-16 12:57:22 +02:00
PouleyKetchoupp
eab7342321 More details in Rigid Body add_force documentation 
(cherry picked from commit 219c5712f0)
 2020-04-16 12:57:22 +02:00
Tomasz Chabora
edd5d9c78e Improve Camera2D documentation 
(cherry picked from commit 630096fa74)
 2020-04-16 12:57:22 +02:00
Hugo Locurcio
ab4ea9379c Improve the AudioStreamSample class documentation 
This closes #37915.

(cherry picked from commit 52786b54ef)
 2020-04-16 12:57:22 +02:00
Markus Sauermann
7607fafda1 Clarify documentation and indicate that rect_clip_content affects only CanvasItem based nodes. 
Resolves #37683

(cherry picked from commit 3f19b5e0b3)
 2020-04-16 12:47:18 +02:00
Nannaquin
27989ae8f8 Add reference of Color8 function to Color class documentation 
(cherry picked from commit 06aeff3044)
 2020-04-16 12:47:18 +02:00
lucaslcode
cd10966652 clarify autotile_coord in docs 
I had no idea what 'coordinate' meant in the context of autotiles, so just adding some clarification for future people who have the same problem.

(cherry picked from commit cbe73766e3)
 2020-04-16 12:47:18 +02:00
Zak Grumbles
294008015e Clarify Dictionary duplicate params godotengine#37162 
* Added additional clarification for the function of the 'deep'
parameter in the Dictionary's `duplicate` method.

(cherry picked from commit 469b7c948f)
 2020-04-16 12:02:18 +02:00
Zak Grumbles
5d9108c9c6 Fix OptionButton docs godotengine#36803 
* item_selected and item_focused docs incorrectly had 'id' as the parameter. Changed to
'index'.
* Fix parameter name in ADD_SIGNAL callin code.

(cherry picked from commit a8de034f78)
 2020-04-16 11:45:19 +02:00
Danil Alexeev
2ef1ee9da7 Improve the File.store_{8,16,32,64}() documentation 
Added information about the intervals of values that the functions
`store_{8,16,32,64}()` can correctly write to the file.

(cherry picked from commit 97e20b2f30)
 2020-04-16 11:44:58 +02:00
Yuri Roubinsky
5914fdc067 Implements estimate/compute_cost for AStar2D 
(cherry picked from commit bad77bcb52)
 2020-04-16 11:35:52 +02:00
Hugo Locurcio
e88cfedf0e Document the EditorFeatureProfile class 
(cherry picked from commit 7ab279403d)
 2020-04-06 20:58:21 +02:00
Zak Grumbles
011602447c Clarify docs for Thread.start() godotengine#36032 
* Updated docs for Thread.start() to specify that the method argument
must accept one parameter.

(cherry picked from commit d09644dff3)
 2020-04-06 18:17:43 +02:00
Nathan
679708aa8f Make note of 16 probe limit 
Godot by default has a limit of 16 reflection probes in a scene. this can be increased by increasing atlas subdiv. For 3.2 and possibly 4.0. This also fixes a spelling mistake

Update doc/classes/ReflectionProbe.xml

Fix from clayjohn, Directly link to settings

Co-Authored-By: Clay John <claynjohn@gmail.com>
 2020-04-05 04:41:00 -04:00
lawnjelly
45b0b8bff8 GLES2 2d Batch rendering (across items) 
2d rendering is currently bottlenecked by drawing primitives one at a time, limiting OpenGL efficiency. This PR batches primitives and renders in fewer drawcalls, resulting in significant performance improvements. This also speeds up text rendering.

This PR batches across canvas items as well as within items.

The code dynamically chooses between a vertex format with and without color, depending on the input data for a frame, in order to optimize throughput and maximize batch size. It also adds an option to use glScissor to reduce fillrate in light passes.
 2020-04-04 17:13:58 +01:00
Rémi Verschelde
fdd85311c3 Sync classref with current source 2020-03-25 11:42:15 +01:00
Andrea Catania
e30a0a30b6 Added new method to replace an already added node to the animation state machine 
(cherry picked from commit 422926cfc6)
 2020-03-25 11:38:54 +01:00
Umang Kalra
d7c6a42cbf Doc edit at InputEventMouseMotion 
Doc edit

(cherry picked from commit 052424c76d)
 2020-03-25 11:38:53 +01:00
Tomasz Chabora
8fd7efef84 Fix visibility enabler flag toggling 
(cherry picked from commit 2ccd1a7805)
 2020-03-25 11:38:53 +01:00
Hugo Locurcio
b5f1f7dfde Improve the Input.set_use_accumulated_input() documentation 
(cherry picked from commit 30961c60ab)
 2020-03-25 11:38:53 +01:00
Hugo Locurcio
f3d2c672e9 Document known performance issues with Sprite3D 
See https://github.com/godotengine/godot/issues/20855.

(cherry picked from commit 92fa3e076f)
 2020-03-25 09:40:09 +01:00
PouleyKetchoupp
82bee3f993 Added has_signal method for Object 
(cherry picked from commit 258d91f883)
 2020-03-25 09:36:41 +01:00
Rémi Verschelde
cc70b2fa0a
Merge pull request #36342 from m4gr3d/external_texture_support_for_godot_3_2 
Add support for opengl external textures
 2020-03-17 16:29:14 +01:00
Tomasz Chabora
3739f03d98 Add LOTS of missing docs 
(cherry picked from commit e103f21a40)
 2020-03-13 17:26:30 +01:00
Rémi Verschelde
df2a2ae0fc DocData: Fix serialization of Variant default values 
Co-authored-by: Bojidar Marinov <bojidar.marinov.bg@gmail.com>
(cherry picked from commit 788765709d)
 2020-03-09 11:36:57 +01:00
Rémi Verschelde
398de05dd6 doc: Sync classref with current source 2020-03-09 10:07:59 +01:00
Umang Kalra
f9dcc30566 Edited the KinematicBody and KinematicBody2D docs 
Explained the reason why move_and_slide should be used in _physics_process

(cherry picked from commit b7dbf41aa5)
 2020-03-06 23:54:56 +01:00
Rémi Verschelde
d4e6eff2de ConfigFile: Improve error messages and complete docs 
(cherry picked from commit f7c87ed3dd)
 2020-03-06 23:51:26 +01:00
Michael Alexsander
bd2a2a7e40 Turn Rect2's 'intersects_touch()' into an extra argument of 'intersects()' 
(cherry picked from commit 8c8c48a7ad)
 2020-03-06 23:51:26 +01:00
Aaron Franke
41e385cfac Document EditorPlugin get_plugin_icon and get_plugin_name 
The return value's type hint is now accurate.

(cherry picked from commit 68d73ecf60)
 2020-03-06 23:51:25 +01:00
fhuya
30d738eda7 Add support for opengl external textures as defined by https://www.khronos.org/registry/OpenGL/extensions/OES/OES_EGL_image_external.txt 2020-03-05 13:09:49 -08:00
Pierre Caye
1350c1371e add a precision about the intended use of the ConcavePolygonShape 
(cherry picked from commit 222a934e60)
 2020-03-04 14:12:19 +01:00
Bastiaan Olij
0ab8889c0d Exposing get_tracker_id for ARVRPositionalTracker to GDScript 
(cherry picked from commit f0b1edef8b)
 2020-03-04 12:52:47 +01:00
Aaron Franke
fa60e77964 Document that SpringArm exclusions only work with PhysicsBody objects 
(cherry picked from commit d961663707)
 2020-03-04 12:40:15 +01:00
Danil Alexeev
4bf0c52a30 Minor fix in Node class documentation 
The name of the property responsible for physics fps is fixed:
this is `Engine.iterations_per_second`, not `Engine.target_fps`.

(cherry picked from commit 6e5cd36b12)
 2020-03-04 12:40:15 +01:00
Hugo Locurcio
1191766609 doc: Mention concatenation using the + operator in Array 
This closes https://github.com/godotengine/godot-docs/issues/2452.

(cherry picked from commit 8d53562954)
 2020-03-04 12:40:15 +01:00
Hugo Locurcio
4e879ed803 Improve documentation related to fixed physics processing 
(cherry picked from commit b89a37269b)
 2020-03-04 12:40:14 +01:00
Mateo Dev .59
e13324a889 Core: Change _Marshall class inherit from Reference to Object 
(cherry picked from commit 9e8e5ebdc7)
 2020-03-04 12:40:14 +01:00
Hugo Locurcio
b80190721b Allow using MeshLibrary.get_item_preview() in non-editor builds again 
This closes #36268.

(cherry picked from commit 64fac9dd5d)
 2020-03-04 12:40:13 +01:00
Fabio Alessandrelli
3a73c3f260 Add documentation for new DTLS features. 2020-02-25 11:40:17 +01:00
Hugo Locurcio
1bc1939c63 Improve the PanoramaSky class documentation 
See https://github.com/godotengine/godot/issues/27835.

(cherry picked from commit 72ac757ad5)
 2020-02-20 08:01:18 +01:00
Rémi Verschelde
74738806f3 i18n: Sync translations with Weblate 2020-02-14 17:51:56 +01:00
muiroc
50727d7b22 Allow per pixel transparency in javascript platform 
(cherry picked from commit e51c6a0d28)
 2020-02-14 16:07:03 +01:00
Pedro J. Estébanez
541251dff7 Add ConfigFile::parse() 
(cherry picked from commit e5bd3b707f)
 2020-02-14 16:06:36 +01:00
clayjohn
31506ebe85 updated description of metallic in SpatialMaterial 2020-02-12 15:05:49 +01:00
Hugo Locurcio
f433c3656b Update EditorSceneImporterAssimp description to reflect current status 
(cherry picked from commit 95f6be365a)
 2020-02-12 15:05:16 +01:00
Haoyu Qiu
7cfcf1824b Completes doc for ItemList and Tree 
(cherry picked from commit 7a41c44be2)
 2020-02-12 15:05:02 +01:00
seenloitering
20d0034039 Add documentation for Skeleton2D 
Signal bone_setup_changed remains undocumented. I took a quick look at
the cpp code, but its purpose remained unclear to me. If anyone can
steer me in the right direction, I'm happy to flesh this out.

(cherry picked from commit 9151992432)
 2020-02-12 15:04:49 +01:00
Rémi Verschelde
4657daff05 doc: Add description for EditorInspector 
(cherry-picked from #35858)
 2020-02-12 15:04:19 +01:00
clayjohn
453babc60d Finish documenting BakedLightmap and TextureLayered 
(cherry picked from commit 5643bc71f7)
 2020-02-06 13:02:08 +01:00
Haoyu Qiu
11f012d2db Completes doc for button classes 
(cherry picked from commit db42d5ddff)
 2020-02-06 13:02:08 +01:00
Hugo Locurcio
47368f2b7c doc: Add an example for Array.sort() 
This may help people understand the difference between alphabetical
and natural order more quickly.

(cherry picked from commit 1de9118c5f)
 2020-02-06 13:02:08 +01:00
Hugo Locurcio
3410dd3a9e doc: Add a short AnimationPlayer versus Tween comparison 
Many newcomers are confused about which one to choose for animating
properties. This should help clarify the situation with regards
to AnimationPlayer versus Tween.

(cherry picked from commit 810b1341ce)
 2020-02-06 13:02:08 +01:00
Hugo Locurcio
cbd4784d14 Improve the CheckBox and CheckButton class documentations 
This makes the CheckBox and CheckButton classes 100% documented.

(cherry picked from commit c9946bc87e)
 2020-02-06 13:02:08 +01:00
Rémi Verschelde
68eae6b6e9 Fix some URLs to use HTTPS when available 2020-01-29 02:48:10 +01:00
Hugo Locurcio
8ea77b96b2
Mention 2D polygon limits and how to increase them in the documentation 
This closes #21793.
 2020-01-28 22:04:29 +01:00
Rémi Verschelde
658e44ee01 doc: Sync classref with current source 
Fix a few typos.
 2020-01-28 10:58:48 +01:00
Yuri Roubinsky
766d1ef276 Docs for some nodes in visual shader(part 2) 2020-01-28 12:16:09 +03:00
Yuri Roubinsky
9705d5587e Hide "control" methods from VisualShaderNodeGroupBase 2020-01-28 10:24:59 +03:00
Yuri Roubinsky
274f1d8610 Hide "editable" property from VisualShaderNodeGroupBase public interface 2020-01-28 09:43:07 +03:00
Yuri Roubinsky
796484d761 Added missing property "size" to VisualShaderNodeGroupBase 2020-01-27 19:18:48 +03:00
Yuri Roubinsky
3479cf4b42 Removed unused method "build" from VisualShaderNodeExpression 2020-01-27 18:24:39 +03:00
Tomasz Chabora
21dd35b611 Document theme_items of multiple classes 2020-01-27 02:15:37 +01:00
Hugo Locurcio
75185f87a3
doc: Remove mention of nonexistent StaticBody simulated motion mode 
The StaticBody2D documentation doesn't mention it, so it doesn't need
to be touched.

This closes #30560.
 2020-01-26 20:18:22 +01:00
Rémi Verschelde
4cee1cda5e
Merge pull request #35589 from akien-mga/doc-drop-category-property 
doc: Drop unused 'category' property from header
 2020-01-26 16:34:13 +01:00
Rémi Verschelde
09ced94dd4 doc: Do not expose Variant::NIL as a type in the class reference 
Fix signals Variant arguments incorrectly listed as Nil.

Fixes #12520.
 2020-01-26 16:08:11 +01:00