Skip to content

GUI: Display

Dimitris Panokostas edited this page Nov 11, 2023 · 4 revisions

PanelDisplay

In this panel, you can configure the various Display options for Amiberry.

Amiga Screen

  • Fullscreen: only active if the Screen mode is set to Fullscreen. Configures the resolution that Amiberry will use, for Fullscreen mode. The list of available resolutions is currently hard-coded.

  • Screen mode: This allows you to select which screen mode Amiberry will use, to show you the emulated environment. The options available are

  • Windowed: Only useful when Amiberry is running in a graphical environment (i.e. not in a console one). Will show the Amiberry screen in a resizable window. The size of the window can be configured with the Width/Height values below.

  • Fullscreen: Amiberry will switch resolution and use the configured one set above, in the Fullscreen dropdown. This is useful if you want to use a different resolution that the one you are currently running under on Linux/MacOS.

  • Full-window: Amiberry will use the native resolution currently configured, and open a full-window scaled to fill the whole picture. This is usually the best option in most cases.

  • Width: Set the emulated screen width, in pixels. Even though there is a slider to help you easily set the most common values, you can also type any value you want in the textbox next to it.

  • Height: Set the emulated screen height, in pixels. As in width, you can use the slider but you can also type in any value you want in the textbox, as well.

  • Auto Crop: This feature enables a special function in Amiberry, which will try to detect the drawn width/height for each frame, and crop the image to those values accordingly. The result is that you can eliminate black borders that appear in some games/demos, which didn't use the full width/height of the screen. However, please keep in mind that this is not possible in all situations and it may show incorrect results in some cases. You can also assign this function to a custom control, and use it once with a press of a button, instead of having it permanently turned on here.

  • Borderless: Only useful in a graphical environment (i.e. not when running in console). This will make the Amiberry window Borderless, with no window controls around it.

  • VSync: enabling VSync will use the refresh rate of your monitor to do screen updates. This might reduce tearing, but requires that your monitor supports the same refresh rate that's being emulated (e.g. 50Hz for PAL).

  • H. Offset / V. Offset: These options allow you to manually fine-tune the offset of the generated screen, both horizontally and vertically. It might be useful in cases where you don't want to use Centering, but instead manually adjust where the image is shown.

  • Scaling Method: This option allows you to select which scaling method Amiberry will use, when scaling the native resolutions to full screen. The available options are: Auto (automatically choose between Pixelated and Smooth, depending on the aspect ratio of the resolution. If it can be shown without distortion using Pixelated, it will prefer that), Pixelated (use nearest neighbor scaling always) or Smooth (use linear scaling always).

  • Resolution: This option determines how the lines will be drawn for native modes. The default option is HighRes, which is the normal mode of operation. You can change it to LowRes or SuperHiRes instead.

  • Blacker than black: Even though the name is a bit misleading, this has been kept for consistency with WinUAE. This option boosts the gamma for the black areas, so that the border around them will look darker.

  • Filtered Low Res: This option enables filtering when LowRes is selected in the Resolution option above. It will make the output look smoother, instead of pixelated, with LowRes.

  • Correct Aspect Ratio: If this option is enabled the aspect ratio of the emulated resolution will be kept. If you disable it, the image will be scaled/stretched to fill the whole screen.

  • Remove interlace artifacts: This option enables a special feature internally, to eliminate the artifacts produced by Interlace modes. It might cause issues in some applications, so keep that in mind.

  • Refresh: If this option is enabled, it allows you to modify the refresh rate of the emulation, from the full frame rate that it's running normally. When the option is disabled, the value will be set to 1, which represents that every 1 frame will be drawn/shown. If you enable the option, the value will be changed to 2, which means that 1 out of every 2 frames will be drawn, instead (essentially what is known as "frame-skip"). Increasing this value further, will increase the frame-skipping to draw one frame out of X (where X = the value you set it to). This can be useful in situations where you are doing high computational work (like 3D-rendering) and you don't care about the redraw on the screen.

  • Brightness: Allows you to adjust the brightness of the output image, from -200 to 200.

  • Centering: These options allow you to enable automatic centering, for Horizontal and Vertical axes. This can be useful but keep in mind that especially the vertical centering might cause issues in some games/demos. If that happens, try disabling it and adjust the Width/Height (in combination with H/V offset if you want), instead.

Line mode

  • Single: This will draw single lines only, which will be stretched vertically to fill the screen when necessary (e.g. when showing a 640x256 resolution in a 640x512 window).
  • Double: This option will draw every line twice which will take up a bit more resources, but looks better since they don't have to be stretched vertically. It also enables the options for the Interlace line mode, below.
  • Scanlines: This option will also draw double the lines, but will try to replicate the scanlines effect shown in CRT monitors. Please note that this is not a shader, so the output might not be perfect in all resolutions.
  • Double, fields:
  • Double, fields+:

Interlaced line mode

  • Single: Draw single lines, interlace modes will flicker as in the real hardware
  • Double, frames: Only useful in Interlace modes,
  • Double, fields: Only useful in Interlace modes
  • Double, fields+: Only useful in Interlace modes
Clone this wiki locally