mirror of
https://github.com/kuhyx/utils.git
synced 2026-11-17 21:45:08 +01:00
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WzxdWXs4gEhEUMr9rgYG9V
91 lines
3.3 KiB
GDScript
91 lines
3.3 KiB
GDScript
extends RefCounted
|
|
## Writes one feedback as a bundle FOLDER:
|
|
## screenshot.png the frozen frame as it was
|
|
## annotated.png the same frame with the red marks burned in
|
|
## report.json the record (marks in annotated.png pixels, note, game,
|
|
## variant, player pose, settings, build, session id, files)
|
|
## game.log the tail of the run's dev.log
|
|
## snapshot.json the play state (every item and slot, judged)
|
|
## `dir` is injected, so tests use a temp dir and never the real feedback
|
|
## folder (R11). No class_name (dev files reach each other with preload).
|
|
|
|
|
|
## A file name base (local time, `YYYY-MM-DDTHH-MM-SS-mmm`) for the unix time
|
|
## `unix_time` (seconds, fractional); a negative value means now.
|
|
static func stamp(unix_time: float = -1.0) -> String:
|
|
return _stamp_ms(_unix_ms(unix_time))
|
|
|
|
|
|
## A bundle folder under `root` that does not exist yet. A clash moves to the
|
|
## next free millisecond, so the name keeps the form feedback_inbox accepts.
|
|
static func bundle_dir(root: String, unix_time: float = -1.0) -> String:
|
|
var total_ms := _unix_ms(unix_time)
|
|
var dir := root.path_join(_stamp_ms(total_ms))
|
|
while DirAccess.dir_exists_absolute(dir):
|
|
total_ms += 1
|
|
dir = root.path_join(_stamp_ms(total_ms))
|
|
return dir
|
|
|
|
|
|
static func _unix_ms(unix_time: float) -> int:
|
|
if unix_time < 0.0:
|
|
unix_time = Time.get_unix_time_from_system()
|
|
return int(floor(unix_time * 1000.0))
|
|
|
|
|
|
static func _stamp_ms(total_ms: int) -> String:
|
|
var local_secs := total_ms / 1000 + int(Time.get_time_zone_from_system()["bias"]) * 60
|
|
var text := Time.get_datetime_string_from_unix_time(local_secs).replace(":", "-")
|
|
return "%s-%03d" % [text, total_ms % 1000]
|
|
|
|
|
|
## Writes the bundle into `dir` (either image may be null). Returns the record
|
|
## with its `files` (absolute paths of what was written) filled in.
|
|
static func save(
|
|
dir: String,
|
|
record: Dictionary,
|
|
annotated: Image,
|
|
raw: Image,
|
|
game_log: String,
|
|
snapshot: Dictionary
|
|
) -> Dictionary:
|
|
DirAccess.make_dir_recursive_absolute(dir)
|
|
var files := {}
|
|
if annotated != null and annotated.save_png(dir.path_join("annotated.png")) == OK:
|
|
files["annotated"] = dir.path_join("annotated.png")
|
|
record["image"] = [annotated.get_width(), annotated.get_height()]
|
|
if raw != null and raw.save_png(dir.path_join("screenshot.png")) == OK:
|
|
files["screenshot"] = dir.path_join("screenshot.png")
|
|
if _write(dir.path_join("game.log"), game_log):
|
|
files["game_log"] = dir.path_join("game.log")
|
|
if _write(dir.path_join("snapshot.json"), JSON.stringify(snapshot, "\t")):
|
|
files["snapshot"] = dir.path_join("snapshot.json")
|
|
files["report"] = dir.path_join("report.json")
|
|
record["files"] = files
|
|
if not _write(files["report"], JSON.stringify(record, "\t")):
|
|
push_warning("feedback: cannot write %s" % files["report"])
|
|
files.erase("report")
|
|
return record
|
|
|
|
|
|
## The feedback.jsonl line of one saved bundle (the recorder stamps it on the
|
|
## video as an "annotation" moment).
|
|
static func log_entry(dir: String, record: Dictionary, marks: int) -> Dictionary:
|
|
var files: Dictionary = record.get("files", {})
|
|
return {
|
|
"event": "annotation",
|
|
"bundle": dir,
|
|
"image": files.get("annotated", ""),
|
|
"report": files.get("report", ""),
|
|
"marks": marks,
|
|
}
|
|
|
|
|
|
static func _write(path: String, text: String) -> bool:
|
|
var file := FileAccess.open(path, FileAccess.WRITE)
|
|
if file == null:
|
|
return false
|
|
file.store_string(text)
|
|
file.close()
|
|
return true
|