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

19
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.
$(NOTE
Unfortunately, there are no universally applicable naming conventions for these modes. Unfortunately, there are no universally applicable naming conventions for these modes.
In fact, different implementations tend to contradict each other. 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