Skip to content

Gamelist Views

lantzelot-swe edited this page Oct 13, 2023 · 13 revisions

There are eleven gamelist views available by default: "All games" and Favorites 1-10. The number of favorites gamelists to use can be configured in the preferences (File/Preferences... menu item).

To manage the gamelist views, press the "..." button to the left of the gamelist view dropdown box:

image

A gamelist view has a name and two sets of filters for different game fields. The first set includes filters that must match, the second set contains filters where at least one must match. This corresponds to AND and OR conditions for the db query that is generated for the view.

Example: To create a gamelist view that lists all C64 games where title starts with “a” or “b” you create a filter “System contains text 64” in the “must match” set and two filters “title begins with text a” and “title begins with text b” in the "any" filter set.

View tag field

In the UI there is a special field named "View tag" which can be used for creating gamelist views for games where other fields doesn't match in a good way. The View tag value is only used by the game manager and is not exported or used in a carousel.

Example: GB64 contains more that 1100 Boulder Dash clones. Many of those uses custom graphics. If you want to create a gamelist view for Boulder Dash games that only uses original graphics you can add a custom value to the View Tag field and create a filter that uses that. Mark all games with the same tag to have it shown in the gamelist view.

Working with favorites

There are ten different favorite views where you can add any game you like. There are separate menu options in the "Edit" menu for tagging/un-tagging a game as a favorite (shortcuts are CTRL+F1, CTRL+F2 etc.). A game can only be tagged to one favorite gamelist view at a time. The favorite gamelist views are useful when you want to choose specific games manually for a carousel. Games marked as favorites will appear in other views also if the filters match. It is possible to rename a favorite view by giving it an alias by pressing the “...” button to the left of the gamelist view dropdown box. The menu items for adding/removing a game and for clearing the favorites view are also renamed. The alias is stored in the pcu.properties file. Aliases for all 10 favorites views can also be edited in the preferences dialog. Leave the aliases fields empty to use the default names.

Gamelist info slots

You can create info slots for a gamelist view with the "Add info slot for current view" menu option in the File menu. An info slot is like a title for the carousel which lists the most important shortcut keys for PCUAE. An info slot is only shown for the gamelist view it is created for. You can customize it in any way you like. When adding a custom screenshot to an info slot you can choose to include the info slot title as an overlay if you like. The author, composer, genre, year and description fields for an infoslot can be configured in the preferences.

An info slot is identified by the manager by the View tag field. It looks for the value "GIS:<gamelistviewId>". Removing this tag will make the Manager treat the info slot as any other game entry.

When creating an infoslot for a gamelist view that contains 16 games or more the Manager will create screenshots with 16 thumbs each (randomized) based on the available screenshots for games in the view. If there are less than 16 games a default screenshot is used instead.