Class BugReport

java.lang.Object
eu.svjatoslav.aukio.e3d.gui.BugReport
public final class BugReport extends Object
Writes a self-contained bug report directory the user can point a developer (or an AI assistant) at.

A new directory bugreport-<timestamp> is created under the configured bugreport.dir containing:

  • description.txt — what the user wrote in the popup
  • info.txt — camera pose, view/screen resolution, heap, telemetry snapshot, java/os versions, effective config
  • screenshot.png — a copy of the last rendered frame
  • aukio.log / aukio.log.1 — the persistent logs, including output from a session that froze before the report could be made
  • histogram.txt — live-object histogram from jcmd <pid> GC.class_histogram (the OOM smoking gun; skipped when jcmd is unavailable)
  • threads.txt — full thread dump (hang diagnosis)

  • Method Details

    • create

      public static File create(ViewPanel viewPanel, String description) throws IOException
      Creates a bug report for the given view.
      Parameters:
      viewPanel - the view whose camera and last frame to capture (may be null — screenshot/camera are then skipped)
      description - free-form user description of the problem
      Returns:
      the created report directory
      Throws:
      IOException