Pixel Vision 8 and the Pixel Vision OS are constantly being updated based on the new feature backlog, bugs that need fixing and optimizing the underlying codebase. Because of this, the goal is to release new versions as often as possible. If you are new to Pixel Vision 8 or looking to understand what has changed since the last release, you can find the most recent changes below, broken down by the version number.
There are some major API changes in this version that may impact reinstalling Pixel Vision OS on a previous install and how your games run. Here is a list of major changes and ways to migrate your existing games over to the latest version.
Issue - If you have a previous version of Pixel Vision OS you’ll get an error after booting into the Workspace Tool. This has to do with the fact that the
ReadMetaData() API has now been changed to
ReadMetadata(). This will impact the logic that checks if the Explorer Tool should prompt the user to upgrade to the newer OS.
Fix - Make sure to back up your entire Workspace, then boot up Pixel Vision 8 v0.9.7 while holding down the Shift key to enter safe mode. This will load up the OS Installer Tool. Check "clean install" then reinstall Pixel Vision OS. You’ll need to also reinstall your copy of the Pro Tools as well.
Issue - When you run your games in Pixel Vision 8 v0.9.7, you may notice the timing is off. The game’s
Update() now returns
timeDelta as an
int instead of a float which was used in previous versions.
Fix - If you are using the
timeDeltain your game’s
Update() function, add
timeDelta = timeDelta/1000 to the top of the
Update() function which will convert the value back to a
float. This should allow your game to run correctly until you have time to make the required adjustments to any
Here is a complete list of the API changes that are new in v0.9.7:
TotalSprites & TotalColors now default to false. Supplying true will return a total ignoring any empty sprites or colors.
UpdateTiles API changed from:
UpdateTiles(int column, int row, int columns, int ids, int? colorOffset = null, int? flag = null)
UpdateTiles(int ids, int? colorOffset = null, int? flag = null)
StopSound() was added to the Lua APIs.
SpriteSize() no longer accepts a width and height parameter since changing sprite sizes wasn’t supported previously. Removed
Sprites() API. Changed
ReadAllMetadata() API Changed
WriteMetadata() respectively. Added
IsChannelPlaying() to Lua API Remove
drawMode parameter from
DrawTilemap(). It now automatically selected the correct
drawMode by default. Changed
PlayPatterns()from the API. Latest Fixes This is currently a beta release of Pixel Vision 8. You can now log bugs specific to Pixel Vision OS here or to the core MonoGame Runner here. There is also a dedicated Discord Server for community, help, and sharing work. Below are the issues that have been addressed in this release: