Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

VitaGrafix

From GameBrew
Revision as of 08:17, 11 December 2022 by HydeWing (talk | contribs)
VitaGrafix
File:Vitagrafixvita.jpg
General
AuthorElectry
TypePlugins
Version5.0.2
LicenseGPL-3.0
Last Updated2019/12/29
Links
Download
Source

VitaGrafix is a taiHEN plugin that allows you to change resolution and FPS cap of PS Vita games (to get better visuals, higher FPS or longer battery life).

VitaGrafix was originally, in it’s early days, based on vitaRescale by Rinnegatamante, with hardcoded patches only for a dozen of games.

The project has evolved quite a bit since then. It is now an independent taiHEN plugin with custom interpreter to easily support user-made patches. The official patchlist contains support for over 50 games.

It patches eboot.bin executable on game start-up, allowing us to alter game's graphics initialization and runtime code. Because each game does this differently, per-game patches are required.

Note: Per-game patches are required. Some are easy to patch, others plainly impossible.

Installation

Download latest VitaGrafix.suprx and ioPlus.skprx (v0.1).

If ux0:tai/config.txt file does exist:

  • Copy VitaGrafix.suprx and ioPlus.skprx to ux0:tai/ directory.
  • Open ux0:tai/config.txt in a text editor and add following lines to the file
*KERNEL
ux0:tai/ioPlus.skprx
*ALL
ux0:tai/VitaGrafix.suprx

Otherwise (e.g. if you are using SD2VITA mounted as ux0):

  • Copy VitaGrafix.suprx and ioPlus.skprx to ur0:tai/ directory.
  • Open ur0:tai/config.txt in a text editor and add following lines to the file.
*KERNEL
ur0:tai/ioPlus.skprx
*ALL
ur0:tai/VitaGrafix.suprx

Then create ux0:data/VitaGrafix/ folder.

Download patchlist.txt from here and move it to the folder.

Create and open ux0:data/VitaGrafix/config.txt file.

Add games to the config you wish to apply patches for (refer to your patchlist.txt).

User guide

Example config.txt

Below is a config.txt example that can be used as a guide for your game.

# This is a comment.
# The Legend of Heroes: Trails of Cold Steel II [JP 1.03]
[PCSG00354] # Game title ID
IB=640x352 # Set IB to 960x544 or less
FPS=60 # FPS value can be selected from 60, 30, 20
MSAA=4x # select MSAA from 4x, 2x, 1x (no AA)

# Set default options for all games
[MAIN]
FB=960x544
IB=960x544
FPS=60
MSAA=4x

Available options

The format for config.txt is OPTION=VALUE, each on a separate line.

Option Description Valid values Default
ENABLED Enables/disables game modifications (and OSD). ON: 1, on or true ON
OFF: 0, off or false
OSD Enables/disables the small overlay that is shown during first few seconds when starting a game. ON: 1, on or true ON
OFF: 0, off or false
LOG Enables/disables logging (to ux0:data/VitaGrafix/log.txt file). ON: 1, on or true ON
OFF: 0, off or false
FB Framebuffer resolution. ON:960x544, 720x408, 640x368 OFF
OFF: 0, off or false
IB Internal buffer resolution. ON: WxH (where: 1 <= W <= 960, 1 <= H <= 544). If patch supports multiple res. (e.g. dyn. res. scaling) use: WxH,WxH,... OFF
OFF: 0, off or false
FPS Frames per second cap (upper limit). ON: 60, 30, 20 OFF
OFF: 0, off or false
MSAA Multisample anti-aliasing. ON: 4x, 2x, 1x (no AA) OFF
OFF: 0, off or false

Tips:

  • If you leave some options out, the plugin will use their default values.
  • If patch supports multiple IB res. and you don't specify them all, the last WxH will be used for those that would go after. It is therefore perfectly fine to just use IB=960x544 to set them all to 960x544 (e.g. to disable dynamic res. scaling) in such situations.

Resources

Changelog

v5.0.2

  • Fixed a bug where "Your game version is not supported" message would not appear if you had a different game version to that of a patch.

v5.0.1

  • Fixed bug where last IB res. in config.txt was not propagated, causing crash in multi-res. games (e.g. those with dynamic scaling such as Wipeout 2048).
  • Added support for manual redirection to alternate patch file (aka. !USE directive in patchlist.txt).

v5.0.0

  • Vastly improved UX (UI, logging, error reporting, etc...).
  • Rewritten parser/interpreter from scratch - revamped patchlist.txt syntax (compatible with v4.x patches).
  • Added support for per-self headers in config.txt.
    • Now you can use separate options for each game in "collections" with single Title ID (e.g. GoW 1/2).
  • Added internal log buffer - reduced game startup times due to I/O stall.
  • Added config.txt option to disable logging altogether.
  • Added support for 20 FPS option in config.txt.
  • Added support for individual per-game patchlists (e.g. ux0:data/VitaGrafix/patch/PCSF00001.txt).
  • Added support for inline comments on the same line as code.
  • Bug fixes.

v4.1.1

  • Fixed bug where [MAIN] options were ignored in some occasions.
  • Minor UI QoL improvements.
  • Config/patchlist parsing is now case-insensitive.
  • [MAIN] accepts same options as GAME section - the latter takes precedence if both are present. You can set your FB/IB/FPS/etc.. in [MAIN], those will be used as default values.
  • Added support for Arm A2 MOVW encoding (a2_mov) in patchlist.txt.

v4.0

  • Hardcoded patches were removed, which means, updates to VitaGrafix plugin in the future will only bring new feature support / bug fixes.
  • All game related stuff, new game support, fixes, etc... will be available here: VitaGrafixPatchlist (changelog).
  • Download patchlist.txt (or make your own) and place it in ux0:data/VitaGrafix/.

(v.3.2)

Game support:

  • Wipeout 2048 [EU/US/JP/ASIA] - 14x IB resolution - game uses dynamic res. scaling, you can specify up to 14 IB resolutions to override the default ones (or just 1 to disable the scaling completely).
  • Fate/EXTELLA LINK [JP/ASIA] - IB resolution.
  • Assassin's Creed III: Liberation [EU/US] - IB resolution + FPS cap.

Thanks to @FormerNoob:

  • The Legend of Heroes: Trails of Cold Steel [EU/US/JP/ASIA] - IB resolution.
  • The Legend of Heroes: Trails of Cold Steel II [EU/US/JP/ASIA] - IB resolution.
  • Dead or Alive Xtreme 3: Venus [JP/ASIA] - 2x IB resolution - uses dynamic scaling.

Thanks to @nigelweng:

  • Resident Evil: Revelations 2 [EU/US/JP] - IB resolution.

v3.1.1

  • Fixed bug where Jak & Daxter Collection [EU/US] would show 'game version unsupported' message in the game shell (Jak 1, 2, 3 game selection menu).
  • Fixed crash when only one IB resolution was specified for Ninja Gaiden Sigma 2 Plus.
  • Fixed issue where World of Final Fantasy would not show any special effects at 960x544 (hopefully).
  • Fixed log messages line feed.

v3.1

  • The plugin now uses ioPlus v0.1. You will need to install ioPlus.skprx in order to use this version.
  • All game options (IB/FB/FPS) are now OFF by default. You will need to either configure them manually or using VitaGrafixConfigurator.

New game support:

  • Sly Cooper Collection (1, 2, 3) [EU/US] - FB res. + FPS cap
  • Sly Cooper Thieves in Time [EU/US] - FPS cap
  • Ninja Gaiden Sigma 2 Plus [EU/US/JP] - 2x IB res. (game uses dynamic scaling, you need to specify two res. e.g. IB=960x544,720x408)
  • Dragon Quest Builders [EU/US/JP/ASIA] - FPS cap (you can force 30 FPS lock)
  • Ratchet & Clank Collection (1, 2, 3) [EU/US] - FB res.
  • Ratchet & Clank Full Frontal Assault / QForce [EU/US] - FB res.
  • Utawarerumono: Chiriyuku Mono he no Komoriuta [JP] - IB res.
  • Dragon Ball Z: Battle of Z [EU/US/JP] - IB res.

New region support:

  • Borderlands 2 [EU-2] (PCSF00576) - FB res.

Fixes:

  • LEGO Star Wars: The Force Awakens [EU/US] - now playable at 960x544 without crashes.

Known issues:

  • Ratchet & Clank 2 + 3 has some UI clipping issues. #16.

v2.4

Game support:

  • Added Hatsune Miku: Project Diva f [EUR/USA/JPN] internal res. patch
  • Added Hatsune Miku: Project Diva f 2nd [EUR/USA/JPN/ASA] internal res. + FPS cap patch
  • Added Hatsune Miku: Project Diva X [EUR/USA/ASA] internal res. patch
  • Added The Amazing Spider-Man [EUR] internal res. + FPS cap patch
  • Added Sly Cooper and the Thievius Raccoonus [USA] framebuffer res. + FPS cap patch
  • Fixed the issue in Killzone: Mercenary where (controller) input didn't work at >59 fps.

Known issues:

  • The Amazing Spider-Man: Only few IB resolutions work properly. 960x544 causes GPU crash in some areas.

v2.3

Game support:

  • Added MotoGP 13 [EUR/USA] internal res. patch.
  • Added MotoGP 14 [USA] internal res. patch.
  • Added WRC 5 [EUR] framebuffer res. patch.
  • Added Utawarerumono: Mask of Deception [EUR] internal res. patch.
  • Added Utawarerumono: Mask of Truth [EUR/USA/JPN] internal res. patch.
  • Added Dragon Quest Builders [EUR/USA/JPN/ASA] internal res. patch.

v2.2

Game support:

  • Added Ridge Racer [EUR/USA/JPN] internal res. patch.
  • Added Utawarerumono: Mask of Deception [USA/JPN] internal res. patch.
  • Added World of Final Fantasy [JPN] internal res. patch.
  • Added Dead or Alive 5 Plus [EUR/USA/JPN] internal res. patch.
  • Added Miracle Girls Festival [JPN] internal res. patch.
  • Added Jak and Daxter Collection [EUR/USA] framebuffer res. patch.
  • Added Hatsune Miku: Project Diva f [EUR/USA/JPN] FPS cap patch.

Known issues:

  • World of Final Fantasy: Only few resolutions work properly. Default has been changed to 800x480 (known working res.).
  • LEGO Star Wars: The Force Awakens: Crashes at native res (when opening pause menu, and possibly at other times too). Default has been changed to 720x408 (still higher than original 640x384).
  • LittleBigPlanet: Particles don't render correctly at native res. Default has been changed to OFF.
  • Hatsune Miku: Project Diva f: 60 FPS doubles menu animations speed. Gameplay remains normal.

v2.1

Game support:

  • Added F1 2011 [EUR] internal resolution patch.
  • Added LittleBigPlanet [EUR/USA/JPN/ASA] internal resolution patch.
  • Added Borderlands 2 [EUR/USA] framebuffer resolution patch.
  • Added Asphalt: Injection [EUR/USA] internal resolution patch.
  • Added LEGO Star Wars: The Force Awakens [EUR/USA] internal resolution patch.
  • Added World of Final Fantasy [EUR/USA/ASA] internal resolution patch.

v2.0

Game support:

  • Added Killzone Mercenary [EUR/USA/JPN/ASA] internal resolution patch.
  • Added WRC 3 [EUR] internal resolution patch*.
  • Added WRC 4 [EUR/USA] internal resolution patch*.
  • Added Persona 4 Golden [JPN] (PCSG00004) internal resolution patch.
  • Added God of War Collection [EUR/USA/JPN] framebuffer resolution + FPS cap patch (GoW 1 + 2).
  • Added MUD - FIM Motocross World Championship [EUR] internal resolution patch.
  • Added MXGP: The Official Motocross Videogame [EUR/USA] internal resolution patch.
  • (Thanks to InquisitionImplied for finding the HEX edits.)

v1.3.1

  • Fixed P4G offsets for JPN+ASA (hopefully).

v1.3

  • Added Persona 4 Golden 476p -> 544p 3D resolution hack for ASA (PCSH00021) (thanks to /u/kane159).
  • The plugin now shows OSD for a few seconds after starting the game..

v1.2

  • Added Persona 4 Golden 476p -> 544p 3D resolution hack for USA + JPN versions.

v1.1

  • Added Persona 4 Golden [EUR] 476p -> 544p 3D resolution hack.

v1.0

  • Add Killzone Mercenary 60 fps patch.

Credits

Thanks to:

External links

Advertising: