Example: 74 * 640 400 => * 20 * *
The option viewport specifies a crop rectangle to apply to the Amiga
video-out. The default, if not specified, is to calculate this automatically
(auto-scaling). To force an uncropped viewport (and effectively disable
autoscaling), you can specify:
viewport = * * * * => 0 0 752 574
If auto-scaling does not work perfectly for a game, and you want a cropped
output, you can specify any crop rectangle (x y width height), The following
viewport is appropriate for many games:
viewport = * * * * => 74 36 640 400
Often, Amiga games have viewports with varying size and position. The default
auto-scaling system works well with many games, but not all. You can modify
the auto-scaling algorithm by specifying patterns to replace. The viewport
setting will be consulted each time the auto-scaling algorithm chooses a
Here are some examples:
The following viewport pattern will match if the auto-scaling algorithm
thinks the viewport should be 640×400 and start at 74 from the left. The
top can be anything (*). Now, the top parameter will be forced to 20.
A * on the right side of => means to keep the existing value, while
a * on the left side means to match any value.
viewport = 74 * 640 400 => * 20 * *
The following viewport specification does nothing:
* * * * => * * * *
This following viewport is a simple translation
(74 40 640 400 => * 36 * * would behave the same):
74 40 640 400 => 74 36 640 400
You can specify more than one pattern by separating them with commas.
In this case, the first matching pattern will be used. Here is a viewport
specification which works perfectly with Pinball Dreams: (this basically
says: keep the viewport 74 28 640 524 as it is, and all other viewports
will be forced to 74 36 640 512.
viewport = 74 28 640 524 => * * * *, * * * * => 74 36 640 512
This one is great for Turrican II:
viewport = 74 * 640 384 => 74 36 640 424
But rembember, many games work perfectly with the builtin viewport detection,
and if you do not want auto-scaling, you can disable it by specifying a fixed
viewport of your choice.