Skip to content

Conversation

@clewis7
Copy link
Member

@clewis7 clewis7 commented Jun 7, 2024

based on graphic features refactor

closes #510

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

are these auto-generated?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no, pygfx had them as static images stored in their docs so I did the same

@kushalkolar
Copy link
Member

A section on the spaces would be very useful. There exists world space, data space (which is basically world space + offset and rotation), and screen space. There's a help func to map from screen space to world space that's useful for interacting with graphics.

@kushalkolar
Copy link
Member

A section on using it interactively would be very useful, similar what's on wgpu docs: https://wgpu-py.readthedocs.io/en/stable/gui.html#using-wgpu-interactively

basically:

  • in jupyter
    • if nothing special is done, uses remote frame buffer, display in cell output or side
    • %gui qt before importing fastplotlib will use qt
    • Figure(canvas="glfw") should force glfw
    • Do not mix or switch between gui backends, ex. if you want to use qt use %gui qt at the start of the notebook, and then do not try to force another backend such as jupyter_rfb (remote frame buffeR)
  • in ipython
    • can use qt or glfw, same was as above

"python": ("https://docs.python.org/3", None),
"numpy": ("https://numpy.org/doc/stable/", None),
"pygfx": ("https://pygfx.com/latest", None),
"pygfx": ("https://pygfx.com/stable", None),
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we should link to latest

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

before when I had it at latest it failed to build

clewis7 and others added 2 commits June 22, 2024 11:33
Co-authored-by: Kushal Kolar <kushalkolar@gmail.com>
@kushalkolar kushalkolar marked this pull request as ready for review June 22, 2024 16:38
Copy link
Member

@kushalkolar kushalkolar left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yay

@kushalkolar
Copy link
Member

I'm going to merge but those warnings and images have to be fixed.

@kushalkolar kushalkolar merged commit d0b8bb1 into main Jun 22, 2024
@kushalkolar kushalkolar deleted the guide branch July 1, 2024 20:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

add "Guide" to docs

3 participants