Commit Graph

3507 Commits

Author SHA1 Message Date
rafallus 92073c2fcd
Fix `input_ray_pickable` documentation for `CollisionObject3D`
(cherry picked from commit ba7d3f8331)
2022-01-25 18:45:35 +01:00
kobewi 8db41cf94d
Clarify to_float() and to_int() methods
(cherry picked from commit 7bb682651f)
2022-01-25 18:44:49 +01:00
bruvzg d0d1e81696
[Documentation] Add instruction how to execute built-in commands of various shells.
(cherry picked from commit 9faf1e027a)
2022-01-25 18:44:25 +01:00
kobewi 7fade16b55
Mention that modifying text erases BBCode stacks
(cherry picked from commit 3f0e9da5a4)
2022-01-25 18:42:41 +01:00
QueenOfSquiggles c7a9ec4c29
Fixed a typo in BakedLightmap documentation
"capture_propagation" member documentation description was missing the second 'p' in "propagation". Fixed this minor typo
Also resubmitting pull request to 3.x branch as per @Calinou's recommendation.

(cherry picked from commit cab89124ff)
2022-01-25 18:41:33 +01:00
Haoyu Qiu 73d5851232
Expose `Image.COMPRESS_SOURCE_LAYERED` to scripting
(cherry picked from commit 7f49e5beec)
2022-01-25 18:41:18 +01:00
Hugo Locurcio de148fe51d
Document using SpriteBase3D's `modulate` property with material override
(cherry picked from commit 027a584faf)
2022-01-25 18:38:19 +01:00
Rémi Verschelde 71066cd63b
Update copyright statements to 2022
Happy new year to the wonderful Godot community!

(cherry picked from commit a627cdafc5)
2022-01-13 16:00:37 +01:00
skyace65 3f7cb6231d
Fix normal map description
(cherry picked from commit d856074488)
2022-01-12 17:35:00 +01:00
kobewi 90525d5781
Improve FileDialog filters
(cherry picked from commit b403954e41)
2022-01-12 17:34:06 +01:00
kobewi 8012a48585
Improve description of mouse_exited signal
(cherry picked from commit 4eec0032ea)
2022-01-12 17:28:52 +01:00
Hugo Locurcio 9a26e95d5c
Warn when using GPU-based particles on macOS due to low performance
On macOS, Particles rendering is much slower than CPUParticles
due to transform feedback being implemented on the CPU instead
of the GPU.

(cherry picked from commit 299d277c9c)
2022-01-12 16:51:41 +01:00
zacryol f999fe471d
List AnimatedSprite3D in SpriteFrames description
Both AnimatedSprite2D and AnimatedSprite3D use a SpriteFrames resource, but the SpriteFrames
class description currently only lists being used with the 2D variant.

(cherry picked from commit 4391f6a5b5)
2022-01-12 16:44:27 +01:00
Sam ad00d99b49
Fixed typos in MeshDataTool documentation
- Fixed missing "be" typo in MeshDataTool's get_face_edge function
- Corrected documentation to say negative values aren't valid

(cherry picked from commit bc9df365b0)
2022-01-12 16:41:33 +01:00
zacryol 3839342175
Update description of FileDialog `filters` property
specify that multiple filetypes/extensions can be included in one filter within the
PackedStringArray, and provide an example

(cherry picked from commit 123cfb4759)
2022-01-12 16:36:46 +01:00
Arnav Vijaywargiya 596bf6bdaa
Fixed incorrect property types
(cherry picked from commit 0c46f73b5e)
2022-01-12 16:34:07 +01:00
bruvzg b7fbfc2776
Add joystick button index boundary check. Increase max. button number to 128 (max. buttons supported by DirectInput).
(cherry picked from commit 61ea8f8337)
2022-01-12 16:29:19 +01:00
skyace65 e0ea177cf9
Add note om when tween methods return false (3.x)
(cherry picked from commit 4bd1ce49e6)
2022-01-12 16:28:53 +01:00
skyace65 e62363ec89
Document how to erase project settings with set_setting
(cherry picked from commit 290038952f)
2022-01-12 16:16:07 +01:00
David Cambré dd9121040e
Update default port_grab_distance_vertical
(cherry picked from commit 38ad72af44)
2022-01-12 16:03:28 +01:00
Wilson E. Alvarez 2106c5175a
Expose autotile_coord parameter in TileMap.set_cellv
(cherry picked from commit 4106f95f30)
2022-01-12 16:03:02 +01:00
follower 74b1560672
Fix the "AudioEffectRecord" descriptions.
The `AudioEffectRecord` effect has no microphone capture-specific functionality--it can be used with any audio bus.

This patch attempts to clarify this fact (so people like me who want to capture audio output know they're in the right place) while still providing a pointer use of the effect with `AudioStreamMicrophone` for microphone capture.

(cherry picked from commit 022f49437b)
2022-01-12 16:01:18 +01:00
Rémi Verschelde 2e8fdd0112
Fix typos with codespell
Using codespell 2.1.0.

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

$ codespell -w -q 3 -I ../godot-word-whitelist.txt --skip="./thirdparty,*.po"
$ git diff // undo unwanted changes
```

(cherry picked from commit b197de6f5f)
2022-01-07 00:17:47 +01:00
bruvzg cb6d82a111
Fix multiple missing UTF-8 decoding.
(cherry picked from commit c69e0d16bc)
2022-01-06 21:30:41 +01:00
kobewi 7324ad6462
Fix get_v_scroll() desctiption in ItemList
(cherry picked from commit f97ab4a0e4)
2022-01-06 00:58:33 +01:00
Lertsenem e807d2e6f0
Fix error in Vector2.reflect() description
The description was probably copied from Vector3.reflect(), and
unfortunately did not match the 2D behaviour (where n is apparently the
direction vector of the symmetry line, not the normal).

(cherry picked from commit e1bf428cdc)
2022-01-06 00:58:33 +01:00
Hugo Locurcio 02b549e9ea
Document keyboard ghosting caveats in Input and InputEvent
This also adds recommendations for choosing between
`is_physical_key_pressed()` and `is_key_pressed()`.

(cherry picked from commit d01e22f187)
2022-01-06 00:58:32 +01:00
Hugo Locurcio dd0206c5ad
Improve the CameraServer and CameraFeed class documentations
This closes https://github.com/godotengine/godot-docs/issues/3255.

(cherry picked from commit 73ec2c6ece)
2022-01-06 00:58:32 +01:00
Hugo Locurcio 575b2a23fa
Document the expected format of anisotropy flowmaps in SpatialMaterial
(cherry picked from commit 9937f7f50d)
2022-01-06 00:58:31 +01:00
skyace65 2ebe0e48b9
Add warning to only use convex hull points when setting the point property for convex polygon shape
(cherry picked from commit 6b18614de7)
2022-01-06 00:58:31 +01:00
skyace65 51f99586ee
State that get static memory usage only works in debug
(cherry picked from commit 32b4edbe4e)
2022-01-06 00:58:30 +01:00
kobewi f054563bf4
Improve docs about plugin registration
(cherry picked from commit 4fc795194b)
2022-01-06 00:58:30 +01:00
Haoyu Qiu 702bff0b42
Use tool instead of at-tool in 3.x documentation
(cherry picked from commit 7b83b5ea3c)
2022-01-06 00:58:30 +01:00
Haoyu Qiu 6bbfec2e9d
Alpha channel indicates opacity, not transparency
(cherry picked from commit bb1eb84da4)
2022-01-06 00:58:30 +01:00
skyace65 f726bf49dd
Improve mouse input event class reference
(cherry picked from commit 37dfe5c706)
2022-01-06 00:58:30 +01:00
belzecue 3adc308254
Update CharFXTransform: explain "relative index"/"absolute index" (previously identical)
Confusingly, these two properties had identical descriptions even though they measure different things.

"relative_index" measures character count from the custom effect's bbcode opening tag.
"absolute_index" measures character count from the start of the bbcode text that includes the custom effect.

See the code author's own explanation here: https://github.com/godotengine/godot/pull/23658

NOTE: Doco for CharFXTransform.xml has changed significantly in 4.0, where terminology has changed to "glyph".  Therefore, proposing this change for 3.x branch only.
(cherry picked from commit 89cebd79e8)
2022-01-06 00:58:29 +01:00
snailrhymer 94ef24dd88
Fix descriptions of set_cell and set_cellv in TileMap.xml
Swap the first lines of the descriptions for set_cell and set_cellv to correctly describe which accepts x and y as separate arguments and which accepts a Vector2.

Fix not relevant to master branch due to changes to TileMap.

(cherry picked from commit 73f4531c97)
2022-01-06 00:58:29 +01:00
Hugo Locurcio 08256e0e16
Improve the CanvasItem class documentation
(cherry picked from commit ccd8cdc363)
2022-01-06 00:58:29 +01:00
Rémi Verschelde eb4816ee13
i18n: Sync classref translations with Weblate 2021-12-21 12:23:51 +01:00
Rémi Verschelde dbfe36728e
i18n: Remove line numbers from classref PO files
It's useful context for translators but it generates very spammy diffs whenever
a line is added or removed, changing the comments for hundreds or thousands of
msgids needlessly.

We still have the file names so it's relatively easy to search in file to find
the location of the source string.
2021-12-21 12:23:45 +01:00
kobewi 563de4c6f4
Mention what happens if find_node() fails
(cherry picked from commit e7722a9a7b)
2021-12-16 23:00:28 +01:00
Haoyu Qiu e28860d003
Fix indentations in class reference XMLs
(cherry picked from commit b225fec1de)
2021-12-16 22:59:04 +01:00
Hugo Locurcio b8c1453f49
Improve the ReflectionProbe class documentation
(cherry picked from commit 2fbf880912)
2021-12-16 22:58:29 +01:00
Hugo Locurcio ecdd46ff22
Document sampling a TextureArray with sRGB -> linear conversion
This is required when sampling an albedo map from a texture array
in 3D. Otherwise, colors will look washed out.

(cherry picked from commit 491acf346d)
2021-12-16 22:58:10 +01:00
Hugo Locurcio e058748d06
Document physics simulation being limited to 8 ticks per rendered frame
(cherry picked from commit bfe77b8fab)
2021-12-16 22:57:53 +01:00
Haoyu Qiu b90bec546d
Make `--doctool` locale aware
* Adds `indent(prefix)` to `String`
* Moves the loading of tool/doc translation into
  `editor/editor_translation.{h,cpp}`
* Makes use of doc translation when generating XML class references, and
  setup the translation locale based on `-l LOCALE` CLI parameter.

The XML class reference won't be translated if `-l LOCALE` parameter is
not given, or when it's `-l en`.

(cherry picked from commit c11b1850c4)
2021-12-16 17:06:52 +01:00
Rémi Verschelde f8b4412b51
i18n: Sync classref translations with current docs 2021-12-16 17:05:08 +01:00
Rémi Verschelde 9f838dbece
i18n: Sync classref translations with Weblate 2021-12-16 15:10:54 +01:00
Rémi Verschelde 69585b0516
SceneTree: Document font oversampling, remove warnings
(cherry picked from commit 35b79284cc)
2021-12-14 17:33:21 +01:00
Ryan Roden-Corrent 6a230c0cd3
Document how to autoscroll ScrollContainer.
It is not uncommon to want to scroll to the most recently added child of
a ScrollContainer (e.g. a chat box or activity log). This is a little
tricky, since `ensure_control_visible` will not work on a node on the
same frame as you add it. Let's at least document that you need to wait
until the next frame.

Relates to https://github.com/godotengine/godot-proposals/issues/3629.

Backport of https://github.com/godotengine/godot/pull/55609.

Co-authored-by: Yuri Sizov <pycbouh@users.noreply.github.com>
(cherry picked from commit 22fb04bddf)
2021-12-14 17:31:00 +01:00