VitaGrafix

VitaGrafix
File:Vitagrafixvita.jpg
General
Author	Electry
Type	Plugins
Version	5.0.2
License	GPL-3.0
Last Updated	2019/12/29
Links
Download
Source

VitaGrafix is allowing user to change games resolution/FPS cap.

What is VitaGrafix?

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 (which was unfortunately quickly abandoned), 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.

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

What VitaGrafix does

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.

Screenshots

How To Install VitaGrafix

1. Download latest VitaGrafix.suprx on gamebrew or from the releases section and ioPlus.skprx (v0.1) from ioPlus Vita
2. If ux0:tai/config.txt file does exist
   1. Copy VitaGrafix.suprx and ioPlus.skprx to ux0:tai/ directory
   2. Open ux0:tai/config.txt in a text editor
   3. Add following lines to the file

*KERNEL
ux0:tai/ioPlus.skprx
*ALL
ux0:tai/VitaGrafix.suprx

3. Otherwise (e.g. if you are using SD2VITA mounted as ux0)
   1. Copy VitaGrafix.suprx and ioPlus.skprx to ur0:tai/ directory
   2. Open ur0:tai/config.txt in a text editor
   3. Add following lines to the file

*KERNEL
ur0:tai/ioPlus.skprx
*ALL
ur0:tai/VitaGrafix.suprx

4. Create ux0:data/VitaGrafix/ folder
5. Download patchlist.txt from HERE and move it to the folder
6. Create and open ux0:data/VitaGrafix/config.txt file
7. Add games to the config you wish to apply patches for (refer to your patchlist.txt)

VitaGrafix's Configuration

You can configure every game separately using unified configuration file.
ux0:data/VitaGrafix/config.txt

MAIN section

• This section applies to all games, unless specific entry for a game exists. Available options are listed below.

[MAIN]
# Same options as in GAME section are permitted here.

GAME section

• This section applies to a single game. These options override the [MAIN] section (for that game). Each game supports different options! Refer to the compatibility table of your patchlist.txt

Example:

[PCSA00001]
# options...

TIP: Because collections share one TITLE ID for multiple games, you might want to configure each game individually. To do that you need to specify game's .self path/name (and optionally NID). If you're not sure what those are, check patchlist.txt, it uses the same header format.

[PCSA00001, GOW1.self, 0x12345678]

↑
PCSA00001	game's TITLE ID	required
GOW1.self	a part of executable's full path	optional
0x12345678	main module NID, 8 hex digits with '0x' prefix	optional

Patchlist For VitaGrafix

Collection of patches for VitaGrafix below.

How To Install VitaGrafix's Patchlist

1. Download raw patchlist.txt
   • optionally download files in patch/ folder, these are separated due to their larger size (100+ lines for one game)
2. Copy it to ux0:/data/VitaGrafix/
   • patch/ files go into ux0:/data/VitaGrafix/patch/
3. Configure your game by editing ux0:/data/VitaGrafix/config.txt or by using VitaGrafixConfigurator

Supported games

	Game	Title ID(s)	Supported features	Game defaults	Notes..............
	Assassin's Creed III: Liberation	PCSB00074 PCSE00053 PCSG00116	Internal res. FPS cap.	720x408 30
	Asphalt: Injection	PCSB00040 PCSE00007	Framebuffer FPS cap	720x408 50
	Atelier Firis: The Alchemist and the Mysterious Journey	PCSB01087 PCSE01044 PCSG00929 PCSH10026	Internal res.	960x442
	Atelier Lydie & Soeur: Fushigi na Kaiga no Renkinjutsu Samurai	PCSG01116	Internal res.	960x442
	Atelier Shallie Plus: Alchemists of the Dusk Sea	PCSB01043 PCSE00998 PCSG00821	Internal res.	960x408
	Atelier Sophie: The Alchemist of the Mysterious Book	PCSB00973 PCSE00892 PCSG00694 PCSH00220	Internal res.	960x442
	Blue Reflection: Maboroshi ni Mau - Shoujo no Ken	PCSG00987	Internal res.	960x442
	Borderlands 2	PCSF00570 PCSF00576 PCSE00383 PCSG00400	Framebuffer	960x544
	Catherine: Full Body	PCSG01179	Internal res.	720x408
	Dead or Alive 5 Plus	PCSB00296 PCSE00235 PCSG00167	Internal res.	720x408
	Dead or Alive Xtreme 3: Venus	PCSG00773 PCSH00250 PCSH00281	2x Internal res.	736x416, 640x368
	Deception IV: Blood Ties Kagero: Darkside Princess	PCSB00499 PCSE00401 PCSG00304	3x Internal res.	960x544, 720x408, 640x368
	Deception IV: The Nightmare Princess Kagero: Mou Hitori no Princess	PCSB00829 PCSE00743 PCSG00565	3x Internal res.	960x544, 720x408, 640x368
	Disney Epic Mickey 2: The Power of Two	PCSF00308 PCSF00309 PCSA00110	Internal res.	720x408
	Dragon Ball Z: Battle of Z	PCSB00396 PCSE00305 PCSG00213	Internal res.	704x448
	Dragon Quest Builders	PCSB00981 PCSE00912 PCSG00697 PCSH00221	Internal res. FPS cap	720x408 60
	Dungeon Hunter: Alliance	PCSB00041 PCSE00008	Internal res.	702x408
	Fantasy Hero: Unsigned Legacy	PCSB00663 PCSE00536 PCSG00280 PCSH00157	Framebuffer	720x408
	Fate/EXTELLA (The Umbral Star)	PCSB01030 PCSE00928 PCSH00299 PCSG00600	Internal res.	720x408
	Fate/EXTELLA LINK	PCSE01254 PCSG01091 PCSH10121	Internal res.	720x408
	F1 2011	PCSB00027 PCSE00002	Internal res.	640x384
	God of War Collection	PCSF00438 PCSA00126 PCSC00059	Framebuffer FPS cap	720x408 30
	Gundam Breaker 2	PCSG00412 PCSH00132	Internal res.	720x408
	Hatsune Miku: Project Diva f	PCSB00419 PCSE00326 PCSG00074	Internal res. FPS cap	640x352 30	#120, #81
	Hatsune Miku: Project Diva f 2nd	PCSB00554 PCSE00434 PCSG00205 PCSH00088	Internal res. FPS cap	720x408 30	#120, #80
	Hatsune Miku: Project Diva X	PCSB01007 PCSE00867 PCSH00176 PCSG00683	Internal res.	720x408
	Helldivers	PCSF00465 PCSA00134 PCSC00078 PCSD00086 PCSD00097	Framebuffer	960x544	#82
	I am Setsuna	PCSG00756	FPS cap	30
	Injustice: Gods Among Us	PCSB00356 PCSE00271	Framebuffer	720x408	#82
	Jak and Daxter: The Precursor Legacy	PCSF00247 PCSF00248 PCSA00080	Framebuffer FPS cap	720x408 20
	Jak II	PCSF00247 PCSF00249 PCSA00080	Framebuffer	720x408
	Jak 3	PCSF00247 PCSF00250 PCSA00080	Framebuffer	720x408
	J-Stars Victory Vs	PCSG00300	Internal res.	768x448
	J-Stars Victory Vs+	PCSB00713 PCSE00595 PCSH00136	Internal res.	768x448
	Kidou Senshi Gundam Seed: Battle Destiny	PCSG00040	Internal res. FPS cap	704x384 30
	Killzone: Mercenary	PCSF00243 PCSF00403 PCSA00107 PCSC00045 PCSD00071	Internal res. FPS cap	Dynamic 30
	LEGO Batman 3: Beyond Gotham	PCSB00563 PCSE00442	Internal res.	640x368
	LEGO Harry Potter: Years 5–7	PCSB00103 PCSE00057	Framebuffer	640x368	#3
	LEGO Jurassic World	PCSB00703 PCSE00587	Internal res.	640x368
	LEGO Marvel Super Heroes: Universe in Peril	PCSB00315 PCSE00250	Internal res.	640x368
	LEGO Marvel's Avengers	PCSB00764 PCSE00670	Internal res.	640x368
	LEGO Ninjago: Shadow of Ronin	PCSB00706 PCSE00534	Internal res.	640x368
	LEGO Star Wars: The Force Awakens	PCSB00877 PCSE00791	Internal res.	640x368
	LEGO The Hobbit	PCSB00503 PCSE00390	Internal res.	640x368
	LittleBigPlanet	PCSF00021 PCSA00017 PCSC00013 PCSD00006	Internal res.	720x408	#24
	Lumines: Electronic Symphony	PCSB00061 PCSE00009 PCSG00014	FPS cap	30
	Macross Delta Scramble	PCSG00947	Internal res.	800x448
	Mahouka Koukou no Rettousei: Out of Order	PCSG00456	Internal res. FPS cap	720x408 30
	Minecraft: PlayStation Vita Edition	PCSB00560 PCSE00491 PCSG00302	Framebuffer FPS cap	720x408 60
	Miracle Girls Festival	PCSG00610	Internal res.	720x408
	MotoGP 13	PCSB00316 PCSE00409	Internal res.	704x448
	MotoGP 14	PCSB00498 PCSE00529	Internal res.	704x448
	MUD - FIM Motocross World Championship	PCSB00182 PCSE00219	Internal res.	704x448
	MXGP: The Official Motocross Videogame	PCSB00470 PCSE00530	Internal res.	704x448
	Need for Speed: Most Wanted	PCSB00183 PCSE00089 PCSG00106	Internal res.	640x368
	Nelke to Densetsu no Renkinjutsushi Tachi: Aratana Daichi no Atelier	PCSG01223	Internal res.	960x442
	Ninja Gaiden Sigma 2 Plus	PCSB00294 PCSE00233 PCSG00157	2x Internal res.	864x480, 640x416
	Oddworld: Munch's Oddysee HD	PCSB00275 PCSE00369	FPS cap	30
	One Piece: Burning Blood	PCSB00893 PCSE00808 PCSH00202	Internal res.	704x384
	Persona 4 Golden	PCSB00245 PCSE00120 PCSG00004 PCSG00563 PCSH00021	Internal res.	840x476
	Phantasy Star Nova	PCSG00351 PCSH00143	Internal res.	960x544
	Project Root	PCSB00650 PCSE00486 PCSG00783	FPS cap	30
	Puella Magi Madoka Magica: The Battle Pentagram	PCSG00214	Internal res. FPS cap	704x448 30
	Ratchet & Clank	PCSF00484 PCSF00482 PCSA00133	Framebuffer	720x408
	Ratchet & Clank 2: Locked and Loaded / Going Commando	PCSF00485 PCSF00482 PCSA00133	Framebuffer	720x408
	Ratchet & Clank 3 / Up Your Arsenal	PCSF00486 PCSF00482 PCSA00133	Framebuffer	720x408
	Ratchet & Clank: QForce / Full Frontal Assault	PCSF00191 PCSA00086 PCSC00041	Framebuffer	720x408
	Resident Evil: Revelations 2	PCSF00728 PCSE00608 PCSG00594 PCSH00187	Internal res.	720x408
	RESOGUN	PCSF00262 PCSA00103 PCSC00088	Framebuffer	720x408
	Ridge Racer	PCSB00048 PCSE00001 PCSG00001	Internal res.	720x408
	Sly Cooper and the Thievius Raccoonus	PCSF00269 PCSF00338 PCSA00095 PCSA00096	Framebuffer FPS cap	720x408 30
	Sly Cooper 2: Band of Thieves	PCSF00270 PCSF00338 PCSA00095 PCSA00097	Framebuffer FPS cap	960x544 30
	Sly Cooper 3: Honor Among Thieves	PCSF00271 PCSF00338 PCSA00095 PCSA00098	Framebuffer FPS cap	960x544 30
	Sly Cooper: Thieves in Time	PCSF00156 PCSF00206 PCSF00207 PCSF00208 PCSF00209 PCSA00068	FPS cap	30
	Soul Sacrifice	PCSF00178 PCSA00092 PCSD00065 PCSC00039	Internal res.	720x408
	Soul Sacrifice Delta	PCSF00532 PCSA00152 PCSD00079 PCSC00049	Internal res.	720x408
	Spy Hunter	PCSB00166 PCSE00068	Framebuffer FPS cap MSAA	640x368 30 4x
	SteamWorld Heist	PCSB00693 PCSE00583	FPS cap	30
	Street Fighter X Tekken	PCSB00144 PCSE00005 PCSG00063	Internal res.	640x480
	Summon Night 6: Lost Borders	PCSB01013 PCSE00951 PCSG00827 PCSH00225	MSAA	2x
	Supremacy MMA: Unrestricted	PCSE00012	Internal res.	720x408
	The Amazing Spider-Man	PCSB00428 PCSE00333	Internal res. FPS cap	704x400 60
	The Legend of Heroes: Trails of Cold Steel Eiyuu Densetsu: Sen no Kiseki	PCSB00866 PCSE00786 PCSG00195 PCSH00074	Internal res.	720x408
	The Legend of Heroes: Trails of Cold Steel II Eiyuu Densetsu: Sen no Kiseki II	PCSB01016 PCSE00896 PCSG00354 PCSH00075	Internal res. MSAA	720x408 2x
	The LEGO Movie Videogame	PCSB00553 PCSE00353	Internal res.	640x368
	Tokyo Xanadu	PCSB01062 PCSE00893 PCSG00608 PCSH10009	Internal res. MSAA	720x408 2x
	Ukiyo no Roushi	PCSG00480	Internal res. FPS cap	704x384 30
	Urban Trial Freestyle	PCSB00038 PCSE00051 PCSG00231	Framebuffer	720x408
	Utawarerumono: Mask of Deception / Itsuwari no Kamen	PCSB01093 PCSE00959 PCSG00617	Internal res.	672x384
	Utawarerumono: Mask of Truth / Futari no Hakuoro	PCSB01145 PCSE01102 PCSG00838	Internal res.	672x384
	Utawarerumono: Chiriyuku Mono he no Komoriuta	PCSG01079	Internal res.	672x384
	Valhalla Knights 3	PCSB00432 PCSE00244 PCSG00076	Internal res.	640x384
	Valhalla Knights 3 GOLD	PCSG00307	Internal res. FPS cap	640x384 30
	Wipeout 2048	PCSF00007 PCSA00015 PCSC00006 PCSD00005	14x Internal res. FPS cap	up to 960x544 30
	World of Final Fantasy	PCSB00951 PCSE00880 PCSH00223 PCSG00709	Internal res.	640x384
	WRC 3: FIA World Rally Championship	PCSB00204 PCSE00242	Internal res.	704x448
	WRC 4: FIA World Rally Championship	PCSB00345 PCSE00411 PCSG00376	Internal res.	704x448
	WRC 5: FIA World Rally Championship	PCSB00762 PCSE00667	Framebuffer	960x544
	Ys: Memories of Celceta	PCSB00497 PCSE00245 PCSH00181 PCSG00105	Internal res.	720x408
	Ys Origin	PCSB01081 PCSE01033 PCSH10049	FPS cap	30
	Ys VIII: Lacrimosa of Dana	PCSB01128 PCSE01103 PCSG00881 PCSH00297	3x Internal res. FPS cap	960x512, 840x476, 720x320 30

Supported games (patch/)

These require patchlist.txt as well as additional files located in patch/ folder.

	Game	Title ID(s)	Supported features	Game defaults	Notes..............
	Mortal Kombat	PCSB00106 PCSE00023	Framebuffer	640x368	PCSB00106.txt PCSE00023.txt
	Uncharted: Golden Abyss	PCSF00001 PCSF00012 PCSA00029 PCSD00001	Internal res.	768x384	PCSF00001.txt

• no known issues
• playable, but with some minor issues (check Issues section)

Adding support for each and every game requires manual disassembly of game's binary to find addresses in the game code where the resolution is set. Some are easy to patch, others plainly impossible.

FAQ

• Encountered a bug? Feel free to open a Github issue here.
• Found a new patch? I'll gladly include it in here :) Just open a new issue or create a merge request.

Available options When Using VitaGrafix

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

TIP: If you leave some options out, the plugin will use their default values.
TIP: 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.

Comments

Comments always start with # character. They can, but don't need to be on a separate line.

# This is a comment
[PCSA00001] # This is also a valid comment
...

Example config.txt

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

# Persona 4 Golden [EU], disable osd
# Notice that IB=960x544 is redundant here as it is
#  the same resolution as the 'fallback' one in [MAIN] section above.
#  This of course doesn't cause any harm.
[PCSB00245]
OSD=0
IB=960x544

# Ninja Gaiden Sigma 2 Plus, uses dynamic resolution scaling
#  and switches between two specified IB resolutions when patched
#  (based on framerate)
# Override the [MAIN] IB resolution(s) for this game.
[PCSB00294]
IB=960x544,720x408

# LittleBigPlanet res. patch introduces some glitches,
#  let's disable it here.
[PCSA00017]
ENABLED=0

# GoW 2 won't reach 60 FPS @ 960x544 very often, so let's
#  keep it locked to 30 (default FPS cap).
[PCSF00438, GOW2.self]
FPS=OFF

# I think you get what this does by now.
[PCSB00204]
IB=OFF

Advanced - The VG Language

To facilitate user-made game patches without having to recompile the whole plugin, a domain specific language was created. Similar, but somewhat simplified to that of VitaCheat.

Written in patchlist.txt, patches are parsed and applied during game boot-up.

Section header

A patch for each game starts with a header. Header identifies SKU/region (TITLE ID), the executable name (because several “collections” use the same TITLE ID for multiple games in their series) and the game version (indirectly, in a form of module NID).

[PCSA00001, eboot.bin, 0x12345678]

↑
PCSA00001	game's TITLE ID	required
eboot.bin	a part of executable's full path	recommended
0x12345678	main module NID, 8 hex digits with '0x' prefix	recommended

Executable name/path is used to differentiate between games that share a single TITLE ID (e.g. collections).

NID is used to inform user about potentional version mismatch (e.g. when game gets a new update), instead of applying patches to wrong/old memory addresses and then crashing.

If multiple regions/SKUs share the same offsets, having to duplicate patches would be wasteful. You can freely stack multiple headers after each other, like shown below. Patches will then be applied for all matching games/regions.

[PCSA00001, eboot.bin, 0x12345678]
[PCSB00023, eboot.bin, 0x87654321]
...

Feature type

Header is followed by patch feature/type marking. This indicates that subsequent patches shall only be applied if user has enabled said feature in their configuration file.

Use one of the following:

@FB
@IB
@FPS
@MSAA

Patches

The rules for patches are simple. Each patched memory location is on a separate line, starts with a relative address (segment:offset) followed by the new value.

0:0x1234 0xDEADBEEF

Datatypes

VitaGrafix internally always works with one of the following datatypes:

• Primitive types:
  • int (32-bit signed integer)
  • uint (32-bit unsigned integer)
  • float (32-bit floating point number)
• Raw type:
  • bytes (size up to 32 B)

You can cast between those types freely using casting functions (see Explicit type conversion).

Immediate values are always parsed as

• int – when + or - sign precedes 1 or more decimal digits (with no space inbetween)
  • OK - +1, -1
  • KO - + 1
• uint – when:
  • hex number is prefixed with 0x or 0X
  • octal number is prefixed with 0
  • decimal integer does not have prefix or suffix
  • OK - 0xCAFE, 0876, 123
  • KO - CAFE
• float – when 1 or more decimal digits (optionally with preceding + or - sign) are followed by:
  • . and optionally:
    • 1 or more digits after the decimal point and optionally f
    • f
  • f
  • OK - 1., 1.2, 1.2f, 1f, 1.f, -1.0, -2f, +123.4f
  • KO - .1, .1f, 1 . 0 f
• bytes – when 1 or more (up to 32) 8-bit hex values (without the 0x prefix) are followed by r
  • OK - DEADr, DE AD r
  • KO - DEAD, 0xDEADr, 0xDE 0xAD r

Implicit type conversion

The interpreter makes use of implicit conversion when necessary. This is done when applying infix operator or math function (arity >= 2) to following operand types (in no particular order):

operand 1	operand 2, 3, ...		result	example
float	int or uint	all casted to float	float	100 / 2.0 equals 50.0
int	uint	all casted to int	int	100 / -2 equals -50
uint	uint	ONLY if result is < 0	int	1 - 2 equals -1
any	any	ONLY when applying . (concat)	bytes	1 . 2 equals 0100000002000000r

Explicit type conversion

While working with values, changing the datatype manually might sometimes be desirable.

To convert value of any type to one of the primitive types use following functions:

function	argument type	result type	example
int(value)	any	int	int(-2.0) equals -2
uint(value)	any	uint	uint(FFr) equals 255
float(value)	any	float	float(2) equals 2.0

To convert value of any type to raw type use:

function	argument type	result type	result size (B)	example
int8(value)	any	bytes	1	int8(-128) equals 80 r
int16(value)	any	bytes	2	int16(-32768) equals 00 80 r
int32(value)	any	bytes	4	int32(-2147483648) equals 00 00 00 80 r
uint8(value)	any	bytes	1	uint8(255) equals FF r
uint16(value)	any	bytes	2	uint16(65535) equals FF FF r
uint32(value)	any	bytes	4	uint32(4294967295) equals FF FF FF FF r
fl32(value)	any	bytes	4	fl32(12345.0) equals 00 E4 40 46 r

If you don't wish to cast the value, but rather just reinterpret bytes, use:

function	value type	result type	result size (B)	example
raw(value)	any	bytes	sizeof(value)	raw(1.0 >> 16) equals 80 3F 00 00 r
rawn(value, n)	any	bytes	n	rawn(1.0 >> 16, 2) equals 80 3F r

Infix operators

Operator precedence is honored, order is similar to C-like languages. Brackets (parentheses) are allowed and evaluated first.

operator	operand type	description	example
+	primitive	addition	1 + 2 equals 3
-	primitive	subtraction	1 - 2 equals -1
*	primitive	multiplication	2 * 3 equals 6
/	primitive	division	3 / 2.0 equals 1.5
%	int or uint	modulo (division remainder)	123 % 23 equals 8
|	primitive	bitwise OR	5 equals 15
^	primitive	bitwise XOR	14 ^ 5 equals 11
&	primitive	bitwise AND	14 & 5 equals 4
<<	primitive	bitwise left shift	14 >> 2 equals 3
>>	primitive	bitwise right shift	14 << 2 equals 56
.	raw	concatenation	DEr . ADr equals DE AD r
*	primitive * raw	raw repeat	nop * 2 equals 00 BF 00 BF r

Math functions

function	description	example
abs(value)	absolute value	abs(-1.0) equals 1.0
acos(rad)	arc cosine (inverse cosine) in radians	acos(-0.5) equals 2.094395
align(value, al)	aligns value to a multiple of al	align(720, 32) equals 736
asin(rad)	arc sine (inverse sine) in radians	asin(0.5) equals 0.523599
atan(rad)	arc tangent (inverse tangent) in radians	atan(1.0) equals 0.785398
atan2(y, x)	arc tangent of y/x in radians	atan2(0.5, 0.4) equals 0.896055
ceil(value)	nearest integer greater than value	ceil(1.23) equals 2.0
cos(rad)	cosine in radians	cos(0.5) equals 0.877583
cosh(rad)	hyperbolic cosine in radians	cosh(0.5) equals 1.127626
exp(value)	exponential (Euler's number) raised to value	exp(2.0) equals 7.389056
floor(value)	nearest integer lesser than value	floor(1.23) equals 1.0
ln(value)	natural logarithm of value	ln(10.0) equals 2.302585
log10(value)	base 10 logarithm of value	log10(10.0) equals 1.0
min(a, b)	the smaller of a and b	min(123, 23) equals 23
max(a, b)	the greater of a and b	max(123, 23) equals 123
pow(base, power)	base raised to the power	pow(2, 4) equals 16
round(value)	nearest integer to value (0.5 rounds up)	round(1.23) equals 1.0
sin(rad)	sine in radians	sin(0.5) equals 0.479426
sinh(rad)	hyperbolic sine in radians	sinh(0.5) equals 0.521095
sqrt(value)	square root of value	sqrt(10.0) equals 3.162278
tan(rad)	tangent in radians	tan(0.5) equals 0.546302
tanh(rad)	hyperbolic tangent in radians	tanh(0.5) equals 0.462117

Math constants

constant	description	defined as
pi	The number π	3.141593
e	Euler's number	2.718282

User configuration macros

These return values based on user configuration entry (in config.txt) for current game.

macro	description	config option
fb_w	Framebuffer width in pixels	FB
fb_h	Framebuffer height in pixels	FB
ib_w	Internal buf. width in pixels	IB
ib_h	Internal buf. height in pixels	IB
ib_wi(index)	Internal buf. width in pixels (indexed from 0)	IB (multiple)
ib_hi(index)	Internal buf. height in pixels (indexed from 0)	IB (multiple)
vblank	Vertical blanking interval (1 for 60Hz, 2 for 30, etc...)	FPS
msaa	SceGxmMultisampleMode (0 for no MSAA, 1 for 2x, 2 for 4x)	MSAA

Instruction encoders

These encode few of the commonly used instructions. Result type is always raw, size depends on encoder. All are unconditional.

Register arguments are expected to be decimal integers.
ARM within 0 <= reg <= 14 range, where 0 denotes R0 or A1, 13 = SP and 14 = LR.
VFP within 0 <= reg <= 31 range, where 0 denotes S0.

encoder	description	instr. set (enc.)	size (B)
t1_mov(reg, imm)	Insert an immediate value to a register. MOV <Rd>,#<imm8> reg - destination imm - immediate value (up to 8-bit)	Thumb (T1)	2
t2_mov(sf, reg, imm)	Insert an immediate value to a register. MOV{S}.W <Rd>,#<const> sf - set condition flags (0 = MOV.W, 1 = MOVS.W) reg - destination imm - immediate value (constant)	Thumb-2 (T2)	4
t3_mov(reg, imm)	Insert an immediate value to a register. MOVW <Rd>,#<imm16> reg - destination imm - immediate value (up to 16-bit)	Thumb-2 (T3)	4
t1_movt(reg, imm)	Insert 16-bit immediate value to the top halfword of a register. Bottom halfword is not affected. MOVT <Rd>,#<imm16> reg - destination imm - immediate value (up to 16-bit)	Thumb-2 (T1)	4
mov32(reg, imm, gap)	Pseduo-instruction, generates MOVW, MOVT pair, allows you to load any 32-bit value into a register. MOVW <Rd>,#<imm16> ... MOVT <Rd>,#<imm16> reg - destination imm - immediate value (up to 32-bit) gap - gap size (in bytes) between MOVW and MOVT (max. 24 B)	Thumb-2 (T3 + T1)	4 + gap + 4
a1_mov(sf, reg, imm)	Insert an immediate value to a register. MOV{S} <Rd>,#<const> sf - set condition flags (0 = MOV, 1 = MOVS) reg - destination imm - immediate value (constant)	Arm (A1)	4
a2_mov(reg, imm)	Insert an immediate value to a register. MOVW <Rd>,#<imm16> reg - destination imm - immediate value (up to 16-bit)	Arm (A2)	4
t2_vmov(reg, imm)	Insert a floating-point immediate value in a single-precision register. VMOV.F32 <Sd>, #<imm> reg - destination (VFP) imm - float immediate (+/-n * 2^-r, 16 <= n <= 31, 0 <= r <= 7)	VFPv3 (T2/A2)	4
bkpt	Breakpoint (enter debug state). BKPT #0	Thumb (T1)	2
nop	No operation. NOP	Thumb-2 (T1)	2

Comments

Comments always start with # character. They can, but don't need to be on a separate line.

# This is a comment
[PCSA00001, eboot.bin, 0x12345678] # This is also a valid comment
...

Backwards compatibility with v4.x

All older patches are compatible with v5.x, however, support for the old syntax/style might be dropped in future versions. It is highly advised to use the new syntax for new patches.

Changes:

v4.x: nop() and bkpt() encoders must have brackets
v5.x: nop and bkpt encoders are classified as constants, constants do not have brackets
example:

• nop() => nop

v4.x: no support for math operators/fns/precedence, macros start with < and end with >
v5.x: infix operators and math functions are available
example:

• <+,1,2> => 1 + 2
• <*,<&,<+,<fb_w>,31>,0xFFFFFFE0>,4> => align(fb_w, 32) * 4

v4.x: config-option macros start with < and end with >
v5.x: config-option macros are used just like regular constants and functions
example:

• <fb_w> => fb_w
• <ib_w> => ib_w
• <ib_w,2> => ib_wi(2)

v4.x: no extra spaces are allowed, comments have to be on a separate line
v5.x: spaces are ignored, anything after # too (until EOL)
example:

• t2_mov(1,1,<fb_w>) => t2_mov(1, 1, fb_w)
• # Comment
  

0:0x1234 nop is valid just like 0:0x1234 nop # Comment

v4.x: bytes() is used to parse raw bytes
v5.x: r suffix is used to parse raw bytes, raw() is used for reinterpreting/conversion
example:

• bytes(DE AD BE EF) => DEADBEEF r

and more...

Examples

Here are some examples of valid patches.

[PCSF00243,eboot.bin]            # Killzone Mercenary [EU 1.12]
[PCSF00403,eboot.bin]            # Killzone Mercenary [EU 1.12]
[PCSA00107,eboot.bin,0x0F9D3B7C] # Killzone Mercenary [US 1.12]
[PCSC00045,eboot.bin]            # Killzone Mercenary [JP 1.12]
[PCSD00071,eboot.bin]            # Killzone Mercenary [ASIA 1.12]
@IB
0:0x15A5C8 nop *4
1:0xD728 uint32(ib_w) . uint32(ib_h)
1:0xD730 uint32(ib_w) . uint32(ib_h)

# God of War Collection [EU 1.00]
[PCSF00438,GOW1.self,0x8638ffed]
@FB
0:0x9E212 t2_mov(1, 4, fb_w)
0:0x9E21A t2_mov(1, 2, fb_h)
0:0x9F0F0 t2_mov(1, 0, fb_w)
0:0x9F0F8 t2_mov(1, 1, fb_h)
0:0xA31C6 t2_mov(1, 7, fb_w)
0:0xA31CC t2_mov(1, 1, fb_h)
0:0xCEF06 t2_mov(1, 0, fb_w)
0:0xCEF0E t2_mov(1, 2, fb_h)
0:0xA1098 t2_mov(1, 14, fb_h)
@FPS
0:0x9E228 t1_mov(0, vblank)

# LEGO Star Wars: The Force Awakens [EU 1.00]
[PCSB00877,eboot.bin]
@IB
0:0x2241C4 t2_mov(1, 1, 0xA00000)
0:0x1F313E t2_mov(1, 4, ib_w)
0:0x1F3144 t2_mov(1, 5, ib_h)
1:0x4650 uint32(ib_w) . uint32(ib_h)
# Fix touchscreen/touchpad pos calc
0:0x223AF6 t2_mov(0, 0, 640) . nop *3
0:0x223B36 t2_mov(0, 0, 368) . nop *3

IO/patcher/syntax errors

The parser will try to warn you if you make a mistake. Nevertheless, it isn't perfect so you shouldn't rely on it.

Example:

Changelog

(v.5.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

(v.5.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)

(v.5.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

(v.4.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

(v.4.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

(v.3.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.

(v.3.1)

• 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

(v.2.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.

(v.2.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

(v.2.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.

(v.2.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

(v.2.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

(v.1.3.1)

• Fixed P4G offsets for JPN+ASA (hopefully)

(v.1.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.

(v.1.2)

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

(v.1.1)

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

(v.1.0)

• Add Killzone Mercenary 60 fps patch

Credits

I'd like to thank the following people who made this possible:

• Team Molecule for HENkaku/taiHEN
• Rinnegatamante for vitaRescale
• dots_tb for ioPlus Vita
• Gontko Productions for the VitaGrafix logo
• all the supporters and patch-makers :)

External links

• Github - https://github.com/Electry/VitaGrafix
• VitaDB - https://vitadb.rinnegatamante.it/#/info/396
• VitaGrafixPatchlist - https://github.com/Electry/VitaGrafixPatchlist