create and document an ugly knob

akkartik

Apr 17, 2025, 4:34 PM

MLE6GJNUEIW7COKKDZXXGJLP37OITTODNK6OBAQE42MFKT5BKDLQC

Dependencies

• [2] 5UNXE4KM on error, switch to a whole other event loop
• [3] HATSIZ4A simplify
• [4] LRDM35CE app running again
• [*] N2NUGNN4 include a brief reference enabling many useful apps
• [*] Z2VZTIXY redo version checks

Change contents

• edit in reference.md at line 26
  [7.143]

  [7.143]
  +

  + ## Variables you can set/read

  +

  + * `Disallow_error_recovery_on_key_release` -- set this when you detect

  + hard-to-recover-from errors. Right now I'm only aware of one such (see

  + driver.love): calls to `love.graphics.newCanvas` can fail at the SDL2 layer

  + if a computer doesn't have enough video RAM to perform them. In response,

  + set this variable before and unset after to prevent the system from

  + repeatedly retrying something that is unlikely to recover. In particular,

  + prevent settings from being saved to disk during an error state, thereby

  + perpetuating the error.

  +

  + This variable is subject to removal if I can come up with a better approach,

  + but I'll document it here as long as I support it. Please

  + [let me know](http://akkartik.name/contact) if you find a new need to read

  + or write it.
• replacement in live.lua at line 397
  [2.659]→[2.659:737](∅→∅)
  − error_frame_keys_down[a] = nil

  − App.run_frame = main_run_frame
  [2.659]

  [2.737]
  + if not Disallow_error_recovery_on_key_release then

  + error_frame_keys_down[a] = nil

  + App.run_frame = main_run_frame

  + end