Pegasus theme development general

fluffypillow

@SinisterSpatula just tried the file, I see now what you mean:

<image> tags always default into boxfront, since it can't be deduced what might be on the image
in theory the <thumbnail> is supposed to be a small sized variant of the <image>, and so this tag is not used by Pegasus
there's no (documented) tag for storing fanart in ES XMLs

@xFJSx hi, collections are always sorted by name by default, but you can reorder or filter them on the theme side however you like. You can use either SortFilter for that, or just plain JavaScript sort, eg. api.collections.slice().sort(function(a, b){ ... }).

AndersHP

@SinisterSpatula
Having just finished my own Gameboy build I cannot wait to get away from Emulation Station and onto Pegasus like my arcade cabinet. How far is this theme from being downloadable? Looks great!

SinisterSpatula

@AndersHP It's making leaps and bounds, I'm working on it like a mad man LOL. Currently I'm building a settings screen for it, then I want to make a favorites view, and I think after that I'll be happy with it. Once settings is working, I'll post another up to date video. The grid is now aligned perfectly, the console logo's when switching systems is now full screen and presented longer, the theme settings are going to have highlight color, game description scrolling speed, (oh yeah and the description is scrolling up and down with D-pad now too), toggle wheel art on the game grid, toggle fan art in the background, hopefully a self update function (just a git pull, and that's only if executing bash commands via Qprocess is allowed).

fluffypillow

Before you all start writing overly complex things, please note that theme-specific settings and an auto updater will come eventually to Pegasus :)

SinisterSpatula

Oh for sure! I don't mind really, because it's getting me to learn QML/QT, it's a fun practice exercise, looking forward to the official implementation and removing my old one.

SinisterSpatula

Some progress on my settings screen.

SinisterSpatula

@fluffypillow I'm trying to use the api.memory.get() and api.memory.set() but it does not seem to be doing anything. Here's the code I'm trying (in theme.qml), and then I go look at ~/.config/pegasus-frontend/theme_settings/gameOS.json and it never updates, none of my stored values appear in there. Not sure what I'm doing wrong. Maybe I can only pass it actual variables and not values? Nope, that didn't make any difference either. I tried renaming gameOS.json expecting for it to be replaced on the next api.memory.set() but it did not. Really can't figure this out. OKAY! Haha I figured something out I think. It seemed to only work when I switched the theme away from gameOS and back to gameOS. After more testing of it, looks like it does not store the setting from api.memory.set() unless and until you switch theme's away from it and on to a different one. Is there a function I need to call to tell it to write the change to the file immediately? Or it's a bug?

  Component.onCompleted: {
    collectionIndex = api.memory.get('collectionIndex') || 0;
    currentGameIndex = api.memory.get('gameCollIndex' + collectionIndex) || 0;
    gamesettings.favorites = api.memory.get('settingsFavorites') || false;
    gamesettings.highlight = api.memory.get('settingsHighlight') || "#FF9E12";
    gamesettings.scrollSpeed = api.memory.get('settingScrollSpeed') || 300;
    gamesettings.wheelArt = api.memory.get('settingsWheelArt') || true;
    gamesettings.fanArt = api.memory.get('settingsFanArt') || true;
    
    if (!api.memory.has('settingsFavorites')) {api.memory.set('settingsFavorites', false)}
    if (!api.memory.has('settingsHighlight')) {api.memory.set('settingsHighlight', "#FF9E12")}
    if (!api.memory.has('settingScrollSpeed')) {api.memory.set('settingScrollSpeed', 300)}
    if (!api.memory.has('settingsWheelArt')) {api.memory.set('settingsWheelArt', true)}
    if (!api.memory.has('settingsFanArt')) {api.memory.set('settingsFanArt', true)}
  }

fluffypillow

@SinisterSpatula yes, the settings are saved on theme change and when closing Pegasus. Though now that I think about it, it might be better to save on change, like program settings, but it's still interesting that the file is not created for you.

EDIT: Ah yes on some platforms there's a crash on exit (a Qt bug), that might be the cause of it.

fluffypillow

Ok, the latest version now saves the memory on change, let's see how it turns out.

SinisterSpatula

Awesome! One thing that I wanted to ask about, and I know it's probably not a priority, because not many users are using it with small screen devices yet, is increasing the font size of the pegasus front end menu's. For now, the theme is properly sized but any of the pegasus menu's are tiny and mostly unreadable. If it's something you want to add to the future changes list, I don't expect it to be something that get's attention right away or anything.
alt text

fluffypillow

@SinisterSpatula and here I was thinking it's too big :) Yes, I think I can make make it depend on the screen resolution, but that may need some work.

SinisterSpatula

Still working on the theme mod. Today the settings menu is fully working, Settings menu has Highlight color, Background color, Game Description scrolling speed [fast, med, slow], which art to show in the background [Default, Fan Art, Screenshot, solid color], Wheel art cropping [crop, fit], and updating info (tells you the command to run from SSH to grab updates -- I'd love to add the code for doing it automagically but it seemed a bit over my head when I read about Qprocess). To do: Support Game "Tile" art as an alternate option from wheel art, which will be a composite of screenshot + wheel art, to give a "steam tiles" appearance. The settings menu might get a beautification. I'd still like to implement a favorites only view. I still need to finish the guide about how to do the composite game tiles via an "XML" recipe/custom mix. [I'm preferring to do it this way instead of having two layered images displayed theme-side, because of performance, it's better to bake the images together and optimize the size for the fastest loading and navigating of the grid on a pi zero.] Latest screenshots: https://imgur.com/a/yMaIvna

I have a work in progress guide I plan to provide to Gpi users who want to try it, and I'm sure the info in it is probably not correct or could be better. If anyone more familiar with Pegasus has any insight on how I can improve the guide: https://sinisterspatula.github.io/RetroflagGpiGuides/Pegasus

P.S. How do I filter and show just the favorites? I looked at the docs and example info but I really didn't quite understand, and couldn't find any other themes that already did this to gain insight from. I think my brain is having a hard time with -- how I would tell the grid to use the filtered collection instead of the one that the platform menu gave it.

fluffypillow

@SinisterSpatula Nice progress! For creating the favorites list, basically when you have a list of items like api.allGames, you can create a filter object over it, which produces a list that only contains the items matching a particular condition. In this case, it would look something like this:

// at the top of the file
import SortFilterProxyModel 0.2

...

// somewhere in the file
SortFilterProxyModel {
    id: filteredGames // the new model's name
    sourceModel: api.allGames // the original model
    filters: ValueFilter { // the filtering condition(s)
      roleName: "favorite"  // "compare this field of each Game"
      value: true // "to this value, and include the Game in the new list if they match"
      enabled: mySettings.showOnlyFavs // optional: turn on/off this filter depending on some variable
    }
}

// then, in some other object that uses models
GridView {
    model: filteredGames // the filter object above
    ...
}

Sorting can be done similarly as well, and it's also possible to have multiple filters, or combine more than one of such filter objects. In most cases, the sorter/filter you want to use is RoleSorter and ValueFilter.

SinisterSpatula

Hi @fluffypillow thanks for the info on favorites, I'm going to see if I can do that now. I'm having some problems using metadata and asset files I'm hoping you can help me. I am so stuck and confused right now. So, I'm trying to use cartridge artwork. I'm using source: game.assets.cartridge and in my metadata.pegasus.txt I have: assets.cartridge: media/cartridge/Bomberman Max - Blue Champion (USA).png and I verify that everything is valid, true, and correct, and it mentions in the documentation that cartridge is supposed to be a valid asset, yet none of them are loading. The true path on the SD card is: /home/pi/RetroPie/roms/genesis/media/cartridge/ I guess for now I'll look at finding a different asset that will work, like poster perhaps. Unless I'm just missing something. In fact, all the various media when using the pegasus metadata all seem to not work, I must be missing something.

SinisterSpatula