orkid: Skill for Claude Code

Orkid EzApp Framework Reference

When answering questions about EzApp or application creation in orkid, consult these files.

Key Files

Component	Location
EzApp Header	ork.lev2/inc/ork/lev2/ezapp.h
EzApp Impl	ork.lev2/src/ezapp.cpp
EzTopWidget	ork.lev2/src/ezapp_topwidget.cpp
EzMainWin	ork.lev2/src/ezapp_mainwin.cpp
Secondary Windows	ork.lev2/src/ez_secondary_win.cpp
Python Bindings	ork.lev2/pyext/src/pyext_ezapp.cpp
CTXBASE (refresh)	ork.lev2/inc/ork/lev2/gfx/ctxbase.h
Tests	ork.lev2/pyext/tests/application/test_ezapp_creation.py

Architecture Overview

OrkEzApp Creation (Python)

from orkengine import lev2

class MyApp:
  def onGpuInit(self, ctx): ...
  def onUpdate(self, updinfo): ...
  def onDraw(self, draw_event): ...

app = MyApp()
ezapp = lev2.OrkEzApp.create(app,
  width=1280, height=720,
  fullscreen=False,
  enable_audio=True,
  use_subsystems=True,
  target_ups=60.0,
  target_fps=60.0)

ezapp.mainThreadLoop()  # Blocks until exit

Creation kwargs

• Window: name, left, top, width, height, fullscreen, fullscreen_monitor, offscreen
• Graphics: enable_graphics, msaa, ssaa, disable_mouse_cursor, fsmouse
• Audio: enable_audio, enable_audio_input/output, enable_audio_synth, audio_input/output_devname, audio_stream_sync
• Timing: freerun, target_ups, target_fps, enable_freerun_ups/fps, enable_lockstep_ups/fps
• Advanced: use_subsystems, drm_mode_id, movie_output_path, rcfd

Callback Detection (hasattr-based)

onAppInit()                    # Before main loop
onAppExit()                    # After main loop
onGpuInit(ctx)                 # GPU context ready
onGpuExit(ctx)                 # GPU cleanup
onGpuUpdate(ctx)               # Per GPU frame
onGpuPreFrame(ctx)             # Before draw
onGpuPostFrame(ctx)            # After draw
onUpdateInit()                 # Update thread start
onUpdateExit()                 # Update thread end
onUpdate(update_data)          # Per-frame logic (update thread)
onDraw(draw_event)             # Render frame (main thread)
onUiEvent(event)               # UI event handler
onAudioInit(audiodevice)       # Audio device ready
onAudioExit()                  # Audio cleanup
onSynthInit(synth)             # Synth ready
onSynthExit()                  # Synth cleanup