feat: adds warnings w/ defaults when using settings; uses same calculation basis for text speeds/times; changes time units to ms

This commit is contained in:
Duncan Brown
2022-12-02 18:20:10 -05:00
committed by Julian Murgia
parent e4414141cb
commit f64b59621d
3 changed files with 115 additions and 35 deletions

View File

@@ -8,8 +8,8 @@ const MANAGER_CLASS="res://addons/escoria-dialog-simple/esc_dialog_simple.gd"
const SETTINGS_ROOT="escoria/dialog_simple"
const AVATARS_PATH = "%s/avatars_path" % SETTINGS_ROOT
const TEXT_SPEED_PER_CHARACTER = "%s/text_speed_per_character" % SETTINGS_ROOT
const FAST_TEXT_SPEED_PER_CHARACTER = "%s/fast_text_speed_per_character" % SETTINGS_ROOT
const TEXT_TIME_PER_LETTER_MS = "%s/text_time_per_letter_ms" % SETTINGS_ROOT
const TEXT_TIME_PER_LETTER_MS_FAST = "%s/text_time_per_fast_letter_ms" % SETTINGS_ROOT
const READING_SPEED_IN_WPM = "%s/reading_speed_in_wpm" % SETTINGS_ROOT
const CLEAR_TEXT_BY_CLICK_ONLY = "%s/clear_text_by_click_only" % SETTINGS_ROOT
const LEFT_CLICK_ACTION = "%s/left_click_action" % SETTINGS_ROOT
@@ -19,6 +19,8 @@ const LEFT_CLICK_ACTION_INSTANT_FINISH = "Instant finish"
const LEFT_CLICK_ACTION_NOTHING = "None"
const READING_SPEED_IN_WPM_DEFAULT_VALUE = 200
const TEXT_TIME_PER_LETTER_MS_DEFAULT_VALUE = 100
const TEXT_TIME_PER_LETTER_MS_FAST_DEFAULT_VALUE = 25
var leftClickActions: Array = [
@@ -45,11 +47,11 @@ func disable_plugin():
)
ESCProjectSettingsManager.remove_setting(
TEXT_SPEED_PER_CHARACTER
TEXT_TIME_PER_LETTER_MS
)
ESCProjectSettingsManager.remove_setting(
FAST_TEXT_SPEED_PER_CHARACTER
TEXT_TIME_PER_LETTER_MS_FAST
)
ESCProjectSettingsManager.remove_setting(
@@ -90,16 +92,16 @@ func enable_plugin():
)
ESCProjectSettingsManager.register_setting(
TEXT_SPEED_PER_CHARACTER,
0.1,
TEXT_TIME_PER_LETTER_MS,
TEXT_TIME_PER_LETTER_MS_DEFAULT_VALUE,
{
"type": TYPE_REAL
}
)
ESCProjectSettingsManager.register_setting(
FAST_TEXT_SPEED_PER_CHARACTER,
0.25,
TEXT_TIME_PER_LETTER_MS_FAST,
TEXT_TIME_PER_LETTER_MS_FAST_DEFAULT_VALUE,
{
"type": TYPE_REAL
}

View File

@@ -10,10 +10,10 @@ signal say_visible
# The text speed per character for normal display
var _text_speed_per_character
var _text_time_per_character: float
# The text speed per character if the dialog line is skipped
var _fast_text_speed_per_character
var _fast_text_time_per_character: float
# The reading speed to be used in determining the length of time text remains
# on the screen.
@@ -25,6 +25,9 @@ var _word_regex: RegEx = RegEx.new()
# Whether the current dialog is speeding up
var _is_speeding_up: bool = false
# The current line of text being displayed.
var _current_line: String
# The node holding the avatar
onready var avatar_node = $Panel/MarginContainer/HSplitContainer/VBoxContainer\
@@ -43,12 +46,38 @@ onready var is_paused: bool = true
# Build up the UI
func _ready():
_text_speed_per_character = ProjectSettings.get_setting(
SimpleDialogPlugin.TEXT_SPEED_PER_CHARACTER
_text_time_per_character = ProjectSettings.get_setting(
SimpleDialogPlugin.TEXT_TIME_PER_LETTER_MS
)
_fast_text_speed_per_character = ProjectSettings.get_setting(
SimpleDialogPlugin.FAST_TEXT_SPEED_PER_CHARACTER
if _text_time_per_character < 0:
escoria.logger.warn(
self,
"%s setting must be a non-negative number. Will use default value of %s." %
[
SimpleDialogPlugin.TEXT_TIME_PER_LETTER_MS,
SimpleDialogPlugin.TEXT_TIME_PER_LETTER_MS_DEFAULT_VALUE
]
)
_text_time_per_character = SimpleDialogPlugin.TEXT_TIME_PER_LETTER_MS_DEFAULT_VALUE
_fast_text_time_per_character = ProjectSettings.get_setting(
SimpleDialogPlugin.TEXT_TIME_PER_LETTER_MS_FAST
)
if _fast_text_time_per_character < 0:
escoria.logger.warn(
self,
"%s setting must be a non-negative number. Will use default value of %s." %
[
SimpleDialogPlugin.TEXT_TIME_PER_LETTER_MS_FAST,
SimpleDialogPlugin.TEXT_TIME_PER_LETTER_MS_FAST_DEFAULT_VALUE
]
)
_fast_text_time_per_character = SimpleDialogPlugin.TEXT_TIME_PER_LETTER_MS_FAST_DEFAULT_VALUE
_reading_speed_in_wpm = ProjectSettings.get_setting(
SimpleDialogPlugin.READING_SPEED_IN_WPM
)
@@ -93,6 +122,10 @@ func set_current_character(name: String):
]
if ResourceLoader.exists(avatar):
avatar_node.texture = ResourceLoader.load(avatar)
if avatar_node.texture is AnimatedTexture:
avatar_node.texture.current_frame = 0
avatar_node.texture.pause = false
else:
escoria.logger.warn(self, "Unable to load avatar '%s': Resource not found in path '%s'" %
[name, ProjectSettings.get_setting("escoria/dialog_simple/avatars_path")])
@@ -104,6 +137,8 @@ func set_current_character(name: String):
# - character: The global id of the character speaking
# - line: Line to say
func say(character: String, line: String):
_current_line = line
_is_speeding_up = false
popup_centered()
set_current_character(character)
@@ -111,7 +146,7 @@ func say(character: String, line: String):
text_node.bbcode_text = tr(line)
text_node.percent_visible = 0.0
var time_show_full_text = _text_speed_per_character * len(line)
var time_show_full_text = _text_time_per_character / 1000 * len(line)
tween.interpolate_property(text_node, "percent_visible",
0.0, 1.0, time_show_full_text,
@@ -123,9 +158,10 @@ func say(character: String, line: String):
func speedup():
if not _is_speeding_up:
_is_speeding_up = true
var time_show_full_text = _fast_text_time_per_character / 1000 * len(_current_line)
tween.remove_all()
tween.interpolate_property(text_node, "percent_visible",
text_node.percent_visible, 1.0, _fast_text_speed_per_character,
text_node.percent_visible, 1.0, time_show_full_text,
Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)
tween.start()
@@ -143,10 +179,9 @@ func finish():
func _on_dialog_line_typed(object, key):
text_node.visible_characters = -1
if not ESCProjectSettingsManager.get_setting(SimpleDialogPlugin.CLEAR_TEXT_BY_CLICK_ONLY):
var time_to_disappear: float = _calculate_time_to_disappear()
$Timer.start(time_to_disappear)
$Timer.connect("timeout", self, "_on_dialog_finished")
var time_to_disappear: float = _calculate_time_to_disappear()
$Timer.start(time_to_disappear)
$Timer.connect("timeout", self, "_on_dialog_finished")
emit_signal("say_visible")
@@ -161,8 +196,14 @@ func _get_number_of_words() -> int:
# Ending the dialog
func _on_dialog_finished():
emit_signal("say_finished")
queue_free()
if avatar_node.texture is AnimatedTexture:
avatar_node.texture.current_frame = 0
avatar_node.texture.pause = true
# Only trigger to clear the text if we aren't limiting the clearing trigger to a click.
if not ESCProjectSettingsManager.get_setting(SimpleDialogPlugin.CLEAR_TEXT_BY_CLICK_ONLY):
emit_signal("say_finished")
queue_free()
# Handler managing pause notification from Escoria

View File

@@ -10,10 +10,10 @@ signal say_visible
# The text speed per character for normal display
var _text_speed_per_character
var _text_time_per_character: float
# The text speed per character if the dialog line is skipped
var _fast_text_speed_per_character
var _fast_text_time_per_character: float
# The reading speed to be used in determining the length of time text remains
# on the screen.
@@ -29,6 +29,9 @@ var _current_character
# Whether the current dialog is speeding up
var _is_speeding_up: bool = false
# The current line of text being displayed.
var _current_line: String
# Tween node for text animation
onready var tween: Tween = $Tween
@@ -42,12 +45,38 @@ onready var is_paused: bool = true
# Enable bbcode and catch the signal when a tween completed
func _ready():
_text_speed_per_character = ProjectSettings.get_setting(
SimpleDialogPlugin.TEXT_SPEED_PER_CHARACTER
_text_time_per_character = ProjectSettings.get_setting(
SimpleDialogPlugin.TEXT_TIME_PER_LETTER_MS
)
_fast_text_speed_per_character = ProjectSettings.get_setting(
SimpleDialogPlugin.FAST_TEXT_SPEED_PER_CHARACTER
if _text_time_per_character < 0:
escoria.logger.warn(
self,
"%s setting must be a non-negative number. Will use default value of %s." %
[
SimpleDialogPlugin.TEXT_TIME_PER_LETTER_MS,
SimpleDialogPlugin.TEXT_TIME_PER_LETTER_MS_DEFAULT_VALUE
]
)
_text_time_per_character = SimpleDialogPlugin.TEXT_TIME_PER_LETTER_MS_DEFAULT_VALUE
_fast_text_time_per_character = ProjectSettings.get_setting(
SimpleDialogPlugin.TEXT_TIME_PER_LETTER_MS_FAST
)
if _fast_text_time_per_character < 0:
escoria.logger.warn(
self,
"%s setting must be a non-negative number. Will use default value of %s." %
[
SimpleDialogPlugin.TEXT_TIME_PER_LETTER_MS_FAST,
SimpleDialogPlugin.TEXT_TIME_PER_LETTER_MS_FAST_DEFAULT_VALUE
]
)
_fast_text_time_per_character = SimpleDialogPlugin.TEXT_TIME_PER_LETTER_MS_FAST_DEFAULT_VALUE
_reading_speed_in_wpm = ProjectSettings.get_setting(
SimpleDialogPlugin.READING_SPEED_IN_WPM
)
@@ -74,6 +103,8 @@ func _ready():
escoria.connect("paused", self, "_on_paused")
escoria.connect("resumed", self, "_on_resumed")
_current_line = ""
func _process(delta):
if _current_character.is_inside_tree() and \
@@ -99,6 +130,8 @@ func _process(delta):
# - character: The global id of the character speaking
# - line: Line to say
func say(character: String, line: String) :
_current_line = line
show()
_is_speeding_up = false
@@ -135,7 +168,7 @@ func say(character: String, line: String) :
_current_character.start_talking()
text_node.percent_visible = 0.0
var time_show_full_text = _text_speed_per_character * len(line)
var time_show_full_text = _text_time_per_character / 1000 * len(_current_line)
tween.interpolate_property(text_node, "percent_visible",
0.0, 1.0, time_show_full_text,
@@ -148,9 +181,11 @@ func say(character: String, line: String) :
func speedup():
if not _is_speeding_up:
_is_speeding_up = true
var time_show_full_text = _fast_text_time_per_character / 1000 * len(_current_line)
tween.remove_all()
tween.interpolate_property(text_node, "percent_visible",
text_node.percent_visible, 1.0, _fast_text_speed_per_character,
text_node.percent_visible, 1.0, time_show_full_text,
Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)
tween.start()
@@ -168,10 +203,9 @@ func finish():
func _on_dialog_line_typed(object, key):
text_node.visible_characters = -1
if not ESCProjectSettingsManager.get_setting(SimpleDialogPlugin.CLEAR_TEXT_BY_CLICK_ONLY):
var time_to_disappear: float = _calculate_time_to_disappear()
$Timer.start(time_to_disappear)
$Timer.connect("timeout", self, "_on_dialog_finished")
var time_to_disappear: float = _calculate_time_to_disappear()
$Timer.start(time_to_disappear)
$Timer.connect("timeout", self, "_on_dialog_finished")
emit_signal("say_visible")
@@ -187,7 +221,10 @@ func _get_number_of_words() -> int:
# Ending the dialog
func _on_dialog_finished():
_stop_character_talking()
emit_signal("say_finished")
# Only trigger to clear the text if we aren't limiting the clearing trigger to a click.
if not ESCProjectSettingsManager.get_setting(SimpleDialogPlugin.CLEAR_TEXT_BY_CLICK_ONLY):
emit_signal("say_finished")
# Handler managing pause notification from Escoria