As of late 2021, we are in the process of updating Stencylpedia and fixing up outdated & broken content. Thanks for your patience!







App Scaling

by Jon (Updated on 2015-10-15)


  • Introduction
  • The Approach
  • Two Key Principles
  • Scale Modes
  • Scaling on iOS
  • Scaling on Android
  • FAQ


Every year, many new mobile devices get introduced with flagship devices from Apple, Google and Samsung getting refreshed annually. With each new generation comes different screen sizes to support. How do you make your app look good on each device in a consistent and satisfactory way?

The Approach

To make a game fit each device's screen, we need to do two things:

  1. Resize the game to fill/fit each device's screen. This is what our Scale Modes do.

  2. Use higher resolution graphics on higher resolution screens. The original iPhone sported a 480 x 320 resolution. Today's flagships are up to 1920 x 1080 or even higher. Higher-resolution graphics are necessary to keep a game looking crisp.

Two Key Principles

Design the game at 1x (Standard) resolution.

Regardless of what the game is targeted towards, you'll be designing your game at a standard (1x) resolution. This means that, if your game was designed to be a 480 x 320 game (to fit the original iPhone), the game size is 480 x 320. The scaling happens automatically at runtime depending on the device used to play the game, so for example, it would run at 1x scale on the original iPhone, at 2x scale on an iPhone 4 and at 4x scale on an iPad Air.

Draw and import your graphics at 4x resolution.

In contrast, you'll want to draw your graphics as large as you can. If your base resolution is 480 x 320, then quadruple that is 1920 x 1280, which will accomodate recent iPads and Android flagships.

Note: When you import your graphics (at 4x - the default), Stencyl will automatically generate a set of 1x, 1.5, 2x, 3x graphics to use on lower-resolution devices.

Scale Modes - What to do with the extra space?

In a perfect world, every device would be an exact multiple of the base resolution (480 x 320). Unfortunately, this isn't the case because each device's aspect ratio is different. This means that after using high-res graphics to scale a game up to 2x or 4x, some extra space can remain.

Under Settings > Mobile > Display is a Scale Mode dropdown for both iOS and Android. This dropdown controls how the extra space is handled.


No Scaling (Letterboxing)

After selecting the multiple to draw at, this mode will will not perform any resizing. The unused space is left blank.

Full Screen

After selecting the multiple to draw at, this mode will display the game "as is" without any further scaling. Anchors to the top-left. This will cause more of the game to be shown on certain device and less on others.

Stretch to Fit

Stretches the game to fill the entire screen. If the aspect ratio of the screen and game differ, this will slightly distort the image.

Scale to Fit (Letterbox)

Stretches the game until the larger game dimension fits the screen, while preserving the game's aspect ratio. Because of this, a small portion of the screen will remain blank.

Scale to Fit (Fill)

Stretches the game until the smaller game dimension fits the screen, while preserving the game's aspect ratio. Because of this, a small portion of the game will be chopped off.

Scale to Fit (Full Screen) <-- RECOMMENDED FOR MOST GAMES

Acts just like Letterbox, except that the extra portions of the screen are displayed. This will cause more of the game to be shown on certain device and less on others. (Added in Stencyl 3.1. Isn't part of the demo above.)

Scaling on iOS

The following table lists what scales each iOS device will run at.


Device Screen Resolution Scale
iPhone Original/3G/3GS 480 x 320 1x
iPhone 4/4S 960 x 640 2x
iPhone 5/5S/5C 1136 x 640 2x
iPhone 6/6S 1334 x 750 2x
iPhone 6/6S Plus 1920 x 1080 3x


Device Screen Resolution Scale
iPod Touch 2/3 480 x 320 1x
iPod Touch 4 960 x 640 2x
iPod Touch 5/6 1136 x 640 2x


Device Screen Resolution Scale
iPad 1/2 1024 x 768 2x
iPad Mini 1024 x 768 2x
iPad 3/4
iPad Air 1/2
2048 x 1536 4x
iPad Mini 2/3/4 2048 x 1536 4x
iPad Pro 2732 x 2048 4x

Scaling on Android

The following table lists what scales common Android devices will run at. Instead of covering everything, we've picked out devices that are representative of that class and tried to hit all the major screen resolutions.

Device Screen Resolution Scale
First-Gen Devices 480 x 320 1x
Nexus S 800 x 480 1.5x
Moto E 960 x 540 1.5x
Nexus 7 (2012) 1280 x 800 2x
Moto G 1280 x 720 2x
Moto X (2014) 1920 x 1080 3x
Nexus 6 2560 x 1440 4x


Do I absolutely have to design my graphics at 4x?

You can import at a lower scale such as 1x or 2x (you can tell Stencyl what scale you are importing at, at the time that you import), and Stencyl will generate the hi-res variants. This is useful for retro games.

What does the Phone-Only mode do?

It forces the game to max out at 2x resolution, even on tablets and smartphones where a higher resolution could be used. With most device resolutions trending well past the 2x point now, we think this isn't all that useful and may remove it in the future.

What does Tablet-Only mode do?

Tablet-only mode is useful for tablet-only games. You still must import your graphics at 4x, but we’ll omit the inapplicable (1x) sets from the app at publication time to save you a little bit of space.

Print Article Edit Article How to Edit an Article
Disclaimer: Use comments to provide feedback and point out issues with the article (typo, wrong info, etc.). If you're seeking help for your game, please ask a question on the forums. Thanks!


Will importing graphics at 4x instead of say 2x effect the frame rate?
0 9 years, 9 months ago
Just to clarify. To take advantage of scaling, I would need to create a 4x sceen, and have every component at the 4x resolution? Does the scaling work at the testing on devices stage?


0 9 years, 9 months ago
Vadim Va
for John:
Excuse me, my friend, but I need the help of experts "Stencyl".
It is on the scale when the game starts.
This article and this ll-screen-mode/ did not help me find the answer.
If you are not very difficult to read my question to the forum php/topic,33146.0.html and help me, please! :)

0 9 years, 10 months ago
In 3.1, we've added a Scale to Fit (Full Screen) mode that is like Scale to Fit (Letterbox) without the letterboxing. Turns out that this is what most people want and think of when they try to use our existing Full Screen mode. php/topic,31729.0.html

0 9 years, 12 months ago
Jon, is it possible for you to add a few HUD elements in the demo and include a link to download it and check the code.
Items to include are HUD elements. In the top-left, top-right, top-centre, bottom-left, bottom-right and bottom-centre.

Having the above HUD elements in the demo will allow us to work out how to re-position elements to still be visible, on different devices. From my understanding, there is no block which allows you to grab the mobile devices screen resolution in pixels? This could help with positioning elements on the screen...

0 10 years, 1 month ago
Say my Character is 32x32, and each tile is 32x32, do i have to draw 4x that? and import that as 4x res?
1 10 years, 1 month ago
In the revised article, I've altered the explanations, especially for Full Screen. It would be misinterpreted before but should be crystal clear now.
0 10 years, 2 months ago
I just tried the various scaling mode which I originally made for the iPad2 and ported the same game to Android, Samsung S3. All you have to do is do a Stretch to Fit Scaling.
0 10 years, 6 months ago
There needs to be a clearer explanation of what each scaling mode does. I have tried all scaling options on a Samsung S3, and the results are not as listed above - especially the "Full Screen" option. When I set the scale mode to "Full Screen", the result is a game that is Positioned at the top-centre of the phone, and is displaying the top and sides of the game only. The bottom part of the game is not visible.

It would be good to have a few demo games that demonstrate best practices.

0 10 years, 8 months ago

Sign In to Comment