godotengine / godotengine/godot-docs

Clarify whether `DisplayServer.tts_speak()` uses a linear volume scale or a decibel scale

Open
#11,663 1 comment 0 reactions 0 assignees View on GitHub
area:class reference enhancement topic:audio topic:platforms
Dominant language
reStructuredText
Stars
5.7k
Forks
3.8k
Avg merge
1d 20h
Merged PRs (30d)
25

Description

**Your Godot version:**
Godot v4.6.beta3

**Issue description:**
The documentation for `DisplayServer.tts_speak()` is ambiguous whether the volume parameter is linear or some sort of decibel scale.

> `volume` ranges from `0` (lowest) to `100` (highest).

Elsewhere, documentation suggests using `linear_to_db()` in order to convert from linear energy values to a decibel float; it is unclear whether such a conversion is needed for this value if we are setting its value using a linear slider interface.
https://docs.godotengine.org/en/stable/classes/class_%40globalscope.html#class-globalscope-method-linear-to-db

**URL to the documentation page (if already existing):**
https://docs.godotengine.org/en/latest/classes/class_displayserver.html#class-displayserver-method-tts-speak

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.