Back when I first wrote this over a year ago, AutoFit didn't have all of the features that I wanted to use in my app, or it didn't apply the features properly. I decided to upload this after making some changes to the code recently to more efficiently support devices and targets where the dimensions can be resized at runtime. Today, I'm presuming that AutoFit can do most of the things AutoScale set out to do, but the features I had in mind when creating AutoScale were the following:
1. Aspect ratio preserving (and ignoring) resize ability
2. Sliding aspect-ratio preserved canvases to the center
3. Touch-based delta input values, in addition to mouse-based
4. a DeviceX() and DeviceY() function that returned values relative to DeviceWidth() and DeviceHeight(), in percentages, even when the rest of the screen is already scaled
5. Some way to apply letterboxing, when necessary.
The rest of the differences with AutoFit are mostly stylistic.
How to Use
InitAutoScale(width, height) should be called OnCreate, and ScaleScreen() should be called at the beginning of OnRender. ScreenWidth and ScreenHeight are the virtual screen dimensions. All dimensions in your app can be hardcoded relative to positions in your virtual screen, and will be scaled accordingly, but for mouse clicks and touches to register in the correct location, always poll dTouch or dMouse functions instead of the default ones. You can also use SetScaledScissor to perform a scissor operation in the virtual screen space.
No scissoring is done to provide any letterbox effect in AutoScale by default -- This may be a desired effect for some users. However, you can add your own letterbox effect with the new RenderLetterBox() function. Call it after all of your other rendering operations, supply it an instance of a LetterBoxer, and it automagically fills in the correct area.
There are 3 built-in types which extend LetterBoxer that are included: Color bars, stretched "book-end" images, and a tiled background. You can also make your own completely custom LetterBoxer -- the render routine gives you the correct draw rectangle and side, and SlideAxis will tell you how your letterbox should be oriented. Updates will be coming soon to make BookEndLetterBox be SlideAxis-aware.
Source code:
https://gist.github.com/nobuyukinyuu/8348382
|
