feat: In-App-Hilfe und Anleitung
- ?-Button in der Statusleiste oeffnet 'Hilfe & Annahmen' - Erklaert Base Value, Level aus Features, Adult-Kategorien, Pruefung, PCS-Annahme und Sturzabzug inklusive Grenzen - docs/manual.md als ausfuehrliche Anleitung, README verlinkt - Whiteboard-Tests auf 281 Assertions erweitert (1025 gesamt) - Doku und Findings aktualisiert
This commit is contained in:
parent
ef1a01d5b3
commit
e1f543cb66
10 changed files with 360 additions and 6 deletions
|
|
@ -502,6 +502,14 @@ theme_override_font_sizes/font_size = 15
|
|||
text = "Abschnitt 1 · 0 Segmente"
|
||||
vertical_alignment = 1
|
||||
|
||||
[node name="HelpButton" type="Button" parent="Layout/StatusBar/StatusBarContent"]
|
||||
unique_name_in_owner = true
|
||||
custom_minimum_size = Vector2(56, 56)
|
||||
layout_mode = 2
|
||||
theme_override_font_sizes/font_size = 18
|
||||
text = "?"
|
||||
tooltip_text = "Hilfe und Annahmen"
|
||||
|
||||
[node name="AdultCategoryOption" type="OptionButton" parent="Layout/StatusBar/StatusBarContent"]
|
||||
unique_name_in_owner = true
|
||||
custom_minimum_size = Vector2(170, 56)
|
||||
|
|
@ -1027,3 +1035,19 @@ theme_override_colors/font_color = Color(0.580392, 0.639216, 0.721569, 1)
|
|||
theme_override_font_sizes/font_size = 13
|
||||
text = "Grobe Schätzung: PCS = Durchschnitt × 3 Komponenten × Kategorie-Faktor. Abzug = Stürze × Kategorie-Abzug. GOE ist nicht enthalten."
|
||||
autowrap_mode = 3
|
||||
|
||||
[node name="HelpDialog" type="AcceptDialog" parent="."]
|
||||
unique_name_in_owner = true
|
||||
title = "Hilfe & Annahmen"
|
||||
size = Vector2i(820, 680)
|
||||
ok_button_text = "Schließen"
|
||||
|
||||
[node name="HelpText" type="RichTextLabel" parent="HelpDialog"]
|
||||
unique_name_in_owner = true
|
||||
offset_left = 12.0
|
||||
offset_top = 12.0
|
||||
offset_right = 808.0
|
||||
offset_bottom = 616.0
|
||||
bbcode_enabled = true
|
||||
scroll_active = true
|
||||
selection_enabled = true
|
||||
|
|
|
|||
|
|
@ -129,6 +129,9 @@ const COMPACT_LAYOUT_WIDTH := 1280.0
|
|||
@onready var pcs_average_spin: SpinBox = %PcsAverageSpin
|
||||
@onready var falls_spin: SpinBox = %FallsSpin
|
||||
@onready var apply_score_assumptions_button: Button = %ApplyScoreAssumptionsButton
|
||||
@onready var help_button: Button = %HelpButton
|
||||
@onready var help_dialog: AcceptDialog = %HelpDialog
|
||||
@onready var help_text: RichTextLabel = %HelpText
|
||||
@onready var element_duration_spin: SpinBox = %ElementDurationSpin
|
||||
@onready var segment_label_dialog: ConfirmationDialog = %SegmentLabelDialog
|
||||
@onready var segment_label_edit: LineEdit = %SegmentLabelEdit
|
||||
|
|
@ -287,6 +290,7 @@ func _ready() -> void:
|
|||
validation_button.pressed.connect(open_validation_dialog)
|
||||
validation_text.meta_clicked.connect(_on_validation_meta_clicked)
|
||||
apply_score_assumptions_button.pressed.connect(_apply_score_assumptions)
|
||||
help_button.pressed.connect(open_help_dialog)
|
||||
element_type_option.item_selected.connect(_on_element_type_selected)
|
||||
|
||||
resized.connect(_apply_responsive_layout)
|
||||
|
|
@ -761,6 +765,144 @@ static func _format_duration(seconds: int) -> String:
|
|||
return "%d:%02d" % [seconds / 60, seconds % 60]
|
||||
|
||||
|
||||
func open_help_dialog() -> void:
|
||||
help_text.text = _help_content()
|
||||
var target := Vector2i(820, 680)
|
||||
var viewport_size := Vector2i(get_viewport_rect().size)
|
||||
if viewport_size.x > 0:
|
||||
target.x = mini(target.x, viewport_size.x)
|
||||
if viewport_size.y > 0:
|
||||
target.y = mini(target.y, viewport_size.y)
|
||||
help_dialog.popup_centered(target)
|
||||
|
||||
|
||||
func _help_content() -> String:
|
||||
var lines := PackedStringArray()
|
||||
lines.append("[b][font_size=22]Hilfe & Annahmen[/font_size][/b]")
|
||||
lines.append(
|
||||
"Diese Hilfe erklärt die Annahmen und Prüfungen der App. Sie ist "
|
||||
+ "keine offizielle ISU-Auslegung."
|
||||
)
|
||||
lines.append("")
|
||||
lines.append("[b][font_size=18]1. Kürzel und Base Value[/font_size][/b]")
|
||||
lines.append(
|
||||
"- Das Kürzel bezeichnet die Elementfamilie, z. B. 3Lz, CCoSp oder StSq."
|
||||
)
|
||||
lines.append(
|
||||
"- Der Level ist die Schwierigkeitsstufe. Bei Pirouetten und "
|
||||
+ "Schrittsequenzen folgt er aus den Features."
|
||||
)
|
||||
lines.append(
|
||||
"- Der Base Value wird aus Kürzel und Level im Saisonkatalog 2026/27 "
|
||||
+ "nachgeschlagen (ISU Communication 2786)."
|
||||
)
|
||||
lines.append(
|
||||
"- Sprünge haben keinen Level; ihr Base Value hängt von Rotation und "
|
||||
+ "Sprungtyp ab."
|
||||
)
|
||||
lines.append(
|
||||
"- ChSq (Choreo-Sequenz) und ChSp (Choreographic Spin) sind fest "
|
||||
+ "Level 1."
|
||||
)
|
||||
lines.append(
|
||||
"- Unbekannte Freitext-Codes haben keinen Katalogwert und werden in "
|
||||
+ "der Schätzung nicht gewertet."
|
||||
)
|
||||
lines.append("")
|
||||
lines.append("[b][font_size=18]2. Level aus Features[/font_size][/b]")
|
||||
lines.append(
|
||||
"- Pirouetten haben 15 Features, Schrittsequenzen 5 "
|
||||
+ "(ISU Communication 2788)."
|
||||
)
|
||||
lines.append(
|
||||
"- 0 Features = Base, 1 = Level 1, 2 = Level 2, 3 = Level 3, "
|
||||
+ "4 oder mehr = Level 4."
|
||||
)
|
||||
lines.append(
|
||||
"- Level 4 bei Pirouetten verlangt zusätzlich eines von: schwieriger "
|
||||
+ "Ausgang, Kantenänderung, beide Richtungen, Temposteigerung, "
|
||||
+ "schwieriger Flug-Eingang oder Windmills."
|
||||
)
|
||||
lines.append(
|
||||
"- Bei Schrittsequenzen ist Feature 1 (Vielfalt) Pflicht."
|
||||
)
|
||||
lines.append(
|
||||
"- Features beschreiben die Ausführung. Die App kann sie nicht aus "
|
||||
+ "der gezeichneten Linie ableiten; sie werden im Element-Dialog "
|
||||
+ "ausgewählt."
|
||||
)
|
||||
lines.append("")
|
||||
lines.append("[b][font_size=18]3. Adult-Kategorie[/font_size][/b]")
|
||||
lines.append(
|
||||
"- Die Kategorie wird in der Statusleiste gewählt und mit der Kür "
|
||||
+ "gespeichert."
|
||||
)
|
||||
lines.append(
|
||||
"- Gold: max. 5 Sprünge, keine 2F/2Lz/2A/Triple, 3 Pirouetten inkl. "
|
||||
+ "ChSp, 1 Schrittsequenz, 2:50 ±10 s, Spins bis Level 3, Sequenz bis "
|
||||
+ "Level 2."
|
||||
)
|
||||
lines.append(
|
||||
"- Silver: max. 4 Einfachsprünge inkl. 1A, 2 Pirouetten, 1 ChSq, "
|
||||
+ "2:00 ±10 s, Level bis 2."
|
||||
)
|
||||
lines.append(
|
||||
"- Bronze: max. 4 Einfachsprünge ohne Axel, 1 Sprungkombination, "
|
||||
+ "2 Pirouetten, 1 ChSq, 1:40 ±10 s, Level bis 1."
|
||||
)
|
||||
lines.append(
|
||||
"- PCS-Faktor und Sturzabzug stehen in den Kategorie-Daten "
|
||||
+ "(Gold 2,67 und 1,0; Silver/Bronze 2,00 und 0,5)."
|
||||
)
|
||||
lines.append("")
|
||||
lines.append("[b][font_size=18]4. Punktschätzung[/font_size][/b]")
|
||||
lines.append(
|
||||
"- Basiswert: Summe der Base Values aller Elemente mit gültigem "
|
||||
+ "Katalogwert."
|
||||
)
|
||||
lines.append(
|
||||
"- PCS-Annahme: Durchschnitt pro Komponente × 3 Komponenten × "
|
||||
+ "Kategorie-Faktor."
|
||||
)
|
||||
lines.append(
|
||||
"- Der PCS-Durchschnitt ist eine Planungsannahme, kein Judge-Wert. "
|
||||
+ "Startwert 5,00; er kann über „Annahmen ändern“ angepasst werden."
|
||||
)
|
||||
lines.append(
|
||||
"- Sturzabzug: Anzahl Stürze × Kategorie-Abzug."
|
||||
)
|
||||
lines.append(
|
||||
"- Nicht enthalten: GOE, 1,1-Faktor, nicht katalogisierte "
|
||||
+ "Kombinationen und die offizielle Wettkampfwertung."
|
||||
)
|
||||
lines.append(
|
||||
"- Beispiel Gold: 5,00 × 3 × 2,67 = 40,05 PCS; Basiswert 9,50; "
|
||||
+ "geschätzte Summe 49,55."
|
||||
)
|
||||
lines.append("")
|
||||
lines.append("[b][font_size=18]5. Prüfung[/font_size][/b]")
|
||||
lines.append(
|
||||
"- Der Button „Prüfen“ zeigt Kürzel-, Level-, Feature- und "
|
||||
+ "Kategorie-Prüfungen sowie die Punktschätzung."
|
||||
)
|
||||
lines.append(
|
||||
"- Warnungen blockieren Speichern und Export nicht. Sie sind "
|
||||
+ "Planungshinweise."
|
||||
)
|
||||
lines.append(
|
||||
"- Wiederholungen: max. 2-mal pro gelistetem Sprung; "
|
||||
+ "Kombinationsbestandteile zählen mit."
|
||||
)
|
||||
lines.append("")
|
||||
lines.append("[b]Tipp:[/b] Für eine realistische PCS-Annahme helfen "
|
||||
+ "Protokolle früherer Wettkämpfe. Der Durchschnitt sollte zu deinem "
|
||||
+ "aktuellen Leistungsstand passen, nicht zum Wunschziel.")
|
||||
lines.append("")
|
||||
lines.append("[b]Quellen:[/b] ISU Communication 2786 (SoV 2026/27), "
|
||||
+ "2788 (Levels/GOE 2026/27), IAFSC Technical Announcement 2026/27.")
|
||||
return "\n".join(lines)
|
||||
|
||||
|
||||
func _on_validation_meta_clicked(meta: Variant) -> void:
|
||||
var key := str(meta)
|
||||
if key == "score_info":
|
||||
|
|
|
|||
|
|
@ -91,6 +91,8 @@ func _capture() -> void:
|
|||
controller.element_button.pressed.emit()
|
||||
elif args.size() > 3 and args[3] == "validate":
|
||||
controller.open_validation_dialog()
|
||||
elif args.size() > 3 and args[3] == "help":
|
||||
controller.help_button.pressed.emit()
|
||||
elif args.size() > 3 and args[3] == "adultgold":
|
||||
controller.set_adult_category("gold")
|
||||
controller.open_validation_dialog()
|
||||
|
|
|
|||
|
|
@ -1397,6 +1397,17 @@ func _run() -> void:
|
|||
)
|
||||
controller.validation_dialog.hide()
|
||||
|
||||
controller.help_button.pressed.emit()
|
||||
_check(controller.help_dialog.visible, "help button opens the help dialog")
|
||||
_check(
|
||||
controller.help_text.text.contains("Hilfe & Annahmen")
|
||||
and controller.help_text.text.contains("PCS-Annahme")
|
||||
and controller.help_text.text.contains("Gold")
|
||||
and controller.help_text.text.contains("Level 4"),
|
||||
"help dialog explains base value, levels, categories and PCS"
|
||||
)
|
||||
controller.help_dialog.hide()
|
||||
|
||||
scene.queue_free()
|
||||
await process_frame
|
||||
_finish()
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue