forks
/
arsd
mirror of https://github.com/adamdruppe/arsd.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Rename "integerFP" scaling mode to "intHybrid"

This commit is contained in:
Elias Batek 2023-12-27 18:19:35 +01:00
parent 8f6f14dcfc
commit 9756f48dee
1 changed files with 17 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
pixmappresenter.d
View File

@ -163,14 +163,16 @@ import arsd.simpledisplay;
/* /*
## TODO ## TODO
- Complete documentation - More comprehensive documentation
- Additional renderer implementations: - Additional renderer implementations:
- a `ScreenPainter`-based renderer - a `ScreenPainter`-based renderer
- a legacy OpenGL renderer (maybe) - a legacy OpenGL renderer (maybe)
- Is there something in arsd that serves a similar purpose to `Pixmap`? - Is there something in arsd that serves a similar purpose to `Pixmap`?
- Can we convert to/from it?
- Minimum window size - Minimum window size
- or something similar
- to ensure `Scaling.integer` doesn’t break “unexpectedly” - to ensure `Scaling.integer` doesn’t break “unexpectedly”
- More control over timing
- that’s a simpledisplay thing, though
*/ */
/// ///
@ -336,8 +338,10 @@ private @safe pure nothrow @nogc {
Each scaling modes has unique behavior for different window-size to pixmap-size ratios. Each scaling modes has unique behavior for different window-size to pixmap-size ratios.
Unfortunately, there are no universally applicable naming conventions for these modes. $(NOTE
In fact, different implementations tend to contradict each other. Unfortunately, there are no universally applicable naming conventions for these modes.
In fact, different implementations tend to contradict each other.
)
$(SMALL_TABLE $(SMALL_TABLE
Mode feature matrix Mode feature matrix
@ -346,10 +350,17 @@ private @safe pure nothrow @nogc {
`stretch` | no | no | no | none | `stretch` | no | no | no | none |
`contain` | preserved | no | no | 2 | Letterboxing/Pillarboxing `contain` | preserved | no | no | 2 | Letterboxing/Pillarboxing
`integer` | preserved | preserved | no | 4 | Works only if `window.size >= pixmap.size`. `integer` | preserved | preserved | no | 4 | Works only if `window.size >= pixmap.size`.
`integerFP` | preserved | when up | no | 4 or 2 | Hybrid: int upscaling, floating-point downscaling `intHybrid` | preserved | when up | no | 4 or 2 | Hybrid: int upscaling, decimal downscaling
`cover` | preserved | no | yes | none | `cover` | preserved | no | yes | none |
) )
$(NOTE
Integer scaling – Note that the resulting integer ratio of a window smaller than a pixmap is `0`.
Use `intHybrid` to prevent the pixmap from disappearing on disproportionately small window sizes.
It uses $(I integer)-mode for upscaling and the regular $(I contain)-mode for downscaling.
)
$(SMALL_TABLE $(SMALL_TABLE
Feature | Definition Feature | Definition
Aspect Ratio | Whether the original aspect ratio (width ÷ height) of the input frame is preserved Aspect Ratio | Whether the original aspect ratio (width ÷ height) of the input frame is preserved
@ -367,7 +378,7 @@ enum Scaling {
stretch, /// stretch, ///
contain, /// contain, ///
integer, /// integer, ///
integerFP, /// intHybrid, ///
cover, /// cover, ///
// aliases // aliases