pixelperfectengine icon indicating copy to clipboard operation
pixelperfectengine copied to clipboard

New user problems

Open Kapendev opened this issue 11 months ago • 1 comments

Hi. I tried to use PixelPerfectEngine from DUB for the first time and wrote some notes while doing that. The notes:

  • Can't compile on Ubuntu without libevdev-dev and there is no info about this on the README.
  • Running dub build :wmfc --compiler=ldc2 will not work if you don't clone the repo.
  • Running dub build pixelperfectengine:wmfc --compiler=ldc2 will not run or create any files. This can be confusing.
  • No hello-world example on the README. test0 might be it, but there is no link to the file.
  • It is not clear that you can run examples with dub run pixelperfectengine:test0.
  • Example test0 is nice, but too noisy for a hello-world example if you think as a user that this is the hello-world example.
  • Resizing the window shows a white color. Can this be changed to black?
  • No simple example to write something in app.d and run.

I hope this helps.

Kapendev avatar Feb 10 '25 13:02 Kapendev

Thank you for your input, I'll be rectifying these issues as soon as I have the time for them.

I'll be adding some clearer "Hello World" style examples, while the "test" ones will be for testing the API, benchmarking, etc.

The resizing under Linux will be dependent on your window manager/graphics environment. On Mint/XFCE/XWayland, I don't have this issue, but will have some XWayland related bugs instead. On RaspberryPi OS/X11, I do. Since it's a minor issue compared to all the others, it's a low priority one, if it even can be fixed.

I usually don't use dub run, since my primary usecase involves me running the executable in a debugger.

ZILtoid1991 avatar Feb 10 '25 13:02 ZILtoid1991