UI: Support page based scrolling in View2D #109154

Julian Eisel · 2023-06-20T12:13:14+02:00

Julian Eisel commented

2023-06-20 12:13:14 +02:00

No user visible changes expected. The feature is not exposed yet.

For the asset shelf (#102879), design is to use a paginated scrolling
style. That means, that any scrolling will always snap to a multiple of
the page size (the size used when pressing the Page Up/Down keys).
Together with strict region size snapping (implemented in the asset
shelf patch, #104831), this gives a clean scrolling experience where
partially visible rows are avoided (impossible even).

DPI scaling or thumbnail size changes work fine in #104831. Snapping
during zooming is not implemented, the asset-shelf doesn't need zooming.

Introduces:

View2D.flag value V2D_SNAP_TO_PAGESIZE_Y, which will cause any
scrolling to only use multiples of the page size.
A custom page size via View2D.page_size_y for when the full region
size is not the appropriate page size value.
API function UI_view2d_offset_y_snap_to_closest_page() to enforce
the snapping from outside View2D. The asset shelf uses this to keep
strict scrolling over DPI changes.

When scrolling with middle-mouse drag, a page is scrolled after half the
page size is dragged.

TODO:

Doesn't work well with touchpads & pen tablets yet.

No user visible changes expected. The feature is not exposed yet. For the asset shelf (#102879), design is to use a paginated scrolling style. That means, that any scrolling will always snap to a multiple of the page size (the size used when pressing the Page Up/Down keys). Together with strict region size snapping (implemented in the asset shelf patch, #104831), this gives a clean scrolling experience where partially visible rows are avoided (impossible even). <video src="https://projects.blender.org/attachments/4ba81c34-37e3-403d-99b2-5bfa561cb0d0" controls></video> DPI scaling or thumbnail size changes work fine in #104831. Snapping during zooming is not implemented, the asset-shelf doesn't need zooming. Introduces: - `View2D.flag` value `V2D_SNAP_TO_PAGESIZE_Y`, which will cause any scrolling to only use multiples of the page size. - A custom page size via `View2D.page_size_y` for when the full region size is not the appropriate page size value. - API function `UI_view2d_offset_y_snap_to_closest_page()` to enforce the snapping from outside View2D. The asset shelf uses this to keep strict scrolling over DPI changes. When scrolling with middle-mouse drag, a page is scrolled after half the page size is dragged. TODO: - Doesn't work well with touchpads & pen tablets yet.

asset-shelf-snapping-2023-06-20_12.52.36.mp4

1.2 MiB

❤️ 3

Julian Eisel added 1 commit 2023-06-20 12:13:26 +02:00

df7cbec6ad UI: Support page based scrolling in View2D

No user visible changes expected.

For the asset shelf (#102879), design is to use a paginated scrolling
style. That means, that any scrolling will always snap to a multiple of
the page size (the size used when pressing the Page Up/Down keys).
Together with strict region size snapping (implemented in the asset
shelf patch, #104831), this gives a clean scrolling experience where
partially visible rows are avoided (impossible even).

DPI scaling or thumbnail size changes work fine in #104831. Snapping
during zooming is not implemented, the asset-shelf doesn't need zooming.

Introduces:
- `View2D.flag` value `V2D_SNAP_TO_PAGESIZE_Y`, which will cause any
  scrolling to only use multiples of the page size.
- A custom page size via `View2D.page_size_y` for when the full region
  size is not the appropriate page size value.
- API function `UI_view2d_offset_y_snap_to_closest_page()` to enforce
  the snapping from outside View2D. The asset shelf uses this to keep
  strict scrolling over DPI changes.

TODO:
- Doesn't work well with touchpads & pen tablets yet.

Julian Eisel added the

Download

What's New

Blender Studio

Manual

Developers Blog

Documentation

Benchmark

Blender Conference

Development Fund

One-time Donations

UI: Support page based scrolling in View2D #109154