Convert your project display resolution

Use the Convert Resolution tool to convert your project's display resolution to a different size. All of the existing project screens will be resized proportionally.

Before you begin this task, you should manually back up your entire project. It is not absolutely necessary to do so, because the existing project screens will be automatically backed up before they are resized, but if you are not satisfied with the results of the conversion, it might be easier to start over from your backup than it would be to restore the screens.

You selected your project's display resolution when you created the project. The display resolution is used as the default size for new project screens. For more information, see Creating a new project.

You can also check your project's display resolution in the project settings. For more information, see Options tab.

When you convert your project's display resolution, all of the existing project screens will also be resized proportionally. For example, if you convert from 1280x800 to 640x480, all of the screens — not just those that are 1280x800 — will be resized to 50% of their original height and 60% of their original width.

By default, the screen objects in those screens will also be resized and repositioned according to the same proportions, but that means the resized objects might be distorted somewhat. For example, squares might become rectangles and circles might become ellipses, depending on what the new proportions are. As such, you have the option to keep the original aspect ratio for each object; it will still be resized, but not necessarily by the same proportions as the entire screen.

The screen objects are repositioned according to their center points, rather than according to any of their corners. This can affect how the objects are distributed in the resized screen. For example, if you have several objects that are top-aligned (that is, aligned so that their top edges all have the same Y position) but of different heights, they will be vertically distributed in the resized screen.

Keep in mind that you can group several screen objects together so that the entire group is resized/repositioned as a single object. Symbols are considered groups for this purpose.

Convert your project display resolution and resize the existing project screens:

1. Close all open screens and worksheets.

2. On the Home tab of the ribbon, in the Tools group, click Convert Resolution.

   The Convert Resolution dialog box is displayed.

   

3. In the From area, specify the display resolution that you want to convert from: either select the resolution from the list, or type the width and height (in pixels).

   By default, the From resolution is your project's current display resolution, but you can specify another resolution if you want a different proportion for resizing screens.

4. In the To area, specify the display resolution that you want to convert to: either select the resolution from the list, or type the width and height (in pixels).

   By default, the To resolution is the same as the display resolution of the computer on which you are running Studio and editing your project.

5. If you do not want to resize the screen objects in the existing project screens, select Keep original aspect ratio for each object.

6. Click Convert.

   The display resolution is converted and the project screens are resized. The progress is displayed at the bottom of the dialog box.

7. Click Close to exit the dialog box.

Be aware that using this feature might disrupt the layout of some screens but not others, depending on how those screens are designed, so you should review all of the resized screens when you are done.

The existing project screens were automatically backed up before they were resized. You can find the backups in your project folder at <project name>\Screen\Backup. To restore them, exit Studio and then copy the backups to <project name>\Screen, so that they replace the resized screens.

Change your project display resolution without resizing existing project screens:

If you want to change your project display resolution without resizing the existing project screens, do not use this feature. Instead, you can manually edit the project file to change the setting

8. Close the project and exit Studio

9. Open the project file (<project name>.app) in a text editor, and edit the following property:

   [Info]

   AppResolution=<width in pixels> <height in pixels>

10. Save and close the project file and open the project.