Files
QFT/IMPLEMENTATION_STATUS.md
T
2026-08-10 17:09:30 +08:00

3.0 KiB
Raw Blame History

QFT v0.4.0-rc2 implementation status

Windows → Android optical

  • QFT2 manifest/data/end frame format
  • QFT2 Base45 text layer; Android Result.text decode
  • QFT1 legacy receive compatibility
  • CRC32 per frame + SHA-256 whole file
  • single large QR only; 2×2 / 4-channel removed
  • default 450-byte DATA payload
  • QR-L + complete 4-module quiet zone
  • Windows target display 5~60 FPS
  • draggable control/QR split pane
  • focus-QR mode and QR zoom
  • Rayon background pre-encoding
  • reused egui GPU TextureHandle / NEAREST sampling
  • positioned source reads; no whole-file mmap
  • bounded pre-render cache; 1100 MiB process design budget
  • Android centered acquisition + finder-point ROI lock
  • smoothed moving ROI + progressive miss expansion/reacquire
  • dynamic overlay: search/green lock/yellow miss/outside dim
  • lock-centered periodic AF/AE
  • Android 640×480 ImageAnalysis + KEEP_ONLY_LATEST
  • Camera2Interop advertised AE FPS range request up to 60
  • automatic fallback when an OEM rejects explicit FPS/stream combination
  • reusable Y-plane GrayFrameBuffer
  • GlobalHistogram hot path + sparse Hybrid fallback
  • duplicate decoded optical frames suppressed before assembler
  • runtime camera FPS / decoded/s / distinct-new-frame/s / decode-ms UI
  • synthetic QFT2 v15 full-frame + ROI visual decode test
  • physical 30/45/60Hz display × Android camera throughput matrix

Android → Windows

  • QFTPAIR2 compact pairing QR
  • persistent per-PC Direct AP identity + per-session token
  • Windows Wi-Fi Direct Legacy AP implementation
  • Android 10+ WifiNetworkSpecifier path
  • Android 7~9 legacy Wi-Fi path
  • wait for actual IPv4/link route before discovery
  • UDP QFTDISC2 receiver discovery
  • QR endpoint + gateway + directed broadcast + subnet fallback
  • HTTP bound to selected Android Network
  • local cleartext network security config
  • local/private IPv4 + session-token validation
  • Parallel v2 init/chunk/finish
  • adaptive 4/8/16 MiB chunks
  • up to 8 Android workers per file
  • Windows positioned concurrent writes
  • temporary .qftpart, final SHA-256 and rename
  • loopback UDP + HTTP + out-of-order parallel integration test
  • physical Windows Wi-Fi Direct adapter / driver / firewall matrix

Android compatibility

  • minSdk 24 (Android 7.0)
  • WRITE_EXTERNAL_STORAGE <= Android 9
  • MediaStore Downloads >= Android 10
  • ACCESS_FINE_LOCATION compatibility <= Android 12
  • NEARBY_WIFI_DEVICES >= Android 13
  • no java.util.Base64 dependency in app source
  • host Kotlin QFT2/Base45 + LockRect runtime smoke
  • host Kotlin QrAnalyzer type-check with CameraX/ZXing-shaped stubs
  • real Android Gradle APK build in this container (SDK unavailable here)
  • install/runtime matrix on physical Android 7→latest devices

See TEST_REPORT.md and TEST_RESULTS.txt for executed evidence and limitations.