flightgear/utils/fgqcanvas/README.md
2022-10-20 20:29:11 +08:00

1.2 KiB

FGQCanvas

A Qt-based remote canvas application for FlightGear. This app can connect to a FlightGear instance which has the built-in HTTPD server enabled and display any canvas in real-time.

Usage

Start FlightGear with the '--httpd' option, passing a port number. This can be done in the 'additional options' box if using the launcher.

  • --httpd=8080

Start FGQCanvas and enter the WebSocket url, with a suitable host-name and port. Provide the path to the Canvas you want to display (this part will become smarter in the future!)

Examples URLs:

  • ws://localhost:8080/PropertyTreeMirror
  • ws://mycomputer.local:8001/PropertyTreeMirror

Example Canvas path:

  • /canvas/by-index/texture[0]/

Limitations

  • Clipping is still being worked on
  • Fonts are not loaded from the host instance yet
  • Image loading is still being worked on, no support for remote image loading yet.
  • Performance is mediocre due to proof-of-concept implementation
  • No input event support yet

Future plans

  • Finish image, clip and font loading
  • Switch to OpenGL rendering
  • Support event-input to the Canvas
  • Rewrite to use Skia

Questions / support

Ask on the developer mailing list!