Pigs In A Blanket Vita: Difference between revisions

Pigs in a Blanket
Pigs in a Blanket
General
Author	SonicMastr
Type	Developments
Version	2.0
License	LGPL-3.0
Last Updated	2020/12/09
Links
	Download
	Website
	Source

Latest revision as of 12:51, 25 October 2024

A Piglet/ShaccCg Wrapper Library for OpenGL ES 2.0 Support on the Vita. Now with System App and Experimental MSAAx4 Support.

This library is a developer focused wrapper which provides easy initialization and expandability, with some quality of life features, including supporting resolutions up to 1920x1080 native on the Playstion TV, and on the Vita with Sharpscale. Developers can choose make their applications with one resolution in mind, as all long as the code is made to scale by dimension, PIB will handle the rest with it's companion app, the PIB Configuration Tool Pigs in a Blanket Configuration Tool], which allows the user to specify their own preference of resultion that will automatically override the original settings. For more information about Piglet, you can check out our information about it on the forum post.

Note: Development Halted - Superceded by PVR_PSP2.

Compiling

With VDSuite

Install VDSuite
Install Taihen
Run cmake . -Bbuild -G Ninja (Recommend Ninja)
cd build and ninja install
Link libpib.a in your projects

With VitaSDK

Install VitaSDK
Run vdpm taihen to install libtaihen_stub
Run make -j4 install USE_VITASDK=1
Link libpib.a in your projects

Note when building your projects:

Always compile your project with unsafe. Doing otherwise will result in PIB failing.

With VitaSDK you can specify the SceLibc heap size by defining sceLibcHeapSize in your code:

unsigned int sceLibcHeapSize = 2 * 1024 * 1024;

Piglet needs an SceLibc heap size of at least 2MB to intialize. Without it, the module will fail to start. This heap needs to be larger if using -nostdlib as this becomes your main heap. More info on -nostdlib support in the headers.

You'll need to link your program with:

libpib.a
liblibScePiglet_stub.a
libSceShaccCg_stub.a
libtaihen_stub.a
libSceAppMgr_stub.a

For DolceSDK, you'll also need:

libSceSharedFb_stub.a
libSceGxmInternalForVsh_stub.a
libSceGxmInternal_stub.a

Check the "Samples" folder for examples of how to use PIB to initialize OpenGLES 2.0 with EGL or GLFW (GLFW3 port for the vita).

Note: Button mapping is perfect and there's full touchscreen support.

To install Piglet on your Vita, just use the Pigs in a Blanket Configuration Tool.

User guide

Supported Extensions

GL	EGL
GL_EXT_draw_instanced	EGL_SCE_piglet_sync
GL_EXT_instanced_arrays	EGL_SCE_piglet_vita_pre_swap_callback
GL_SCE_piglet_shader_binary	EGL_SCE_piglet_vita_vsync_callback
GL_SCE_texture_resource
GL_OES_texture_npot
GL_OES_rgb8_rgba8
GL_OES_depth_texture
GL_EXT_texture_format_BGRA8888
GL_EXT_read_format_bgra
GL_OES_texture_half_float
GL_OES_texture_half_float_linear
GL_OES_vertex_half_float
GL_OES_element_index_uint
GL_EXT_texture_compression_dxt1
GL_EXT_texture_compression_dxt3
GL_EXT_texture_compression_dxt5
GL_EXT_texture_compression_s3tc
GL_EXT_texture_storage
GL_IMG_texture_compression_pvrtc

Screenshots

Piglet

PSM

Credits

Special Thanks:

GrapheneCt - Finding the Piglet Module and being a main part of the Project in reverse engineering and testing.
dots-tb - Initial idea of using PSM and efforts in getting all of the names for Piglet, as well as being a main part of the Project in reverse engineering and testing.
cuevavirus - Help with debugging and sense of direction.
CreepNT - Help with debugging.
Princess-of-Sleeping - Dump tool and PrincessLog.
xyzz - Initial deep dive into how ShaccCg works.
Zer0xFF and masterzorag - Their amazing work on the PS4 Piglet reverse engineering.

GLSL to CG Conversion Resources:

Microsoft GLSL to HLSL: https://docs.microsoft.com/en-us/windows/uwp/gaming/glsl-to-hlsl-reference
Nvidia CG Standard Library: http://developer.download.nvidia.com/cg/index_stdlib.html
Nvidia CG GLSL Vert to CG: http://developer.download.nvidia.com/cg/glslv.html
Nvidia CG GLSL Frag to CG: http://developer.download.nvidia.com/cg/glslf.html

This requires both libshacccg.suprx and libScePiglet.suprx to be located in ur0:data/external

Changelog

v2.0

What's new?

System Application Support.
Fully Enabled Sony EGL Extensions (Common Dialog Support).
MSAA x4 Support.

Bugfixes:

Fixed incorrect usage of EGL 1.5's eglGetProcAddresss. Using EGL 1.5 features now has to be manually enabled using the PIB_GET_PROC_ADDR_CORE flag.
Fixed glGetBooleanv always returning GL_FALSE when using GL_SHADER_COMPILER as the symbolic constant and ShaccCg is enabled.
Fixed eglSwapInterval would always be locked to 1 no matter what value was entered.
Fixed Libc and FIOS2 always attempting to be started no matter what.
Fixed ability to double initialize/terminate.

v1.1

First Release.

External links

GitHub - https://github.com/SonicMastr/Pigs-In-A-Blanket
CBPS Forums - https://forum.devchroma.nl/index.php/topic,308.0.html
CBPS Forums - https://forum.devchroma.nl/index.php?topic=294.0

@@ Line 1: / Line 1: @@
-{{#seo:
-|title=Vita Homebrew PC Tools (Developments) - GameBrew!
-|title_mode=append
-|image=pigsinablanketvita.jpg
-|image_alt=Pigs in a Blanket
-}}
 {{Infobox Vita Homebrews
 |title=Pigs in a Blanket
-|image=pigsinablanketvita.jpg
+|image=pigsinablanketvita2.png
 |description=A Piglet/ShaccCg Wrapper Library for OpenGL ES 2.0 Support on the Vita
 |author=SonicMastr
@@ Line 14: / Line 8: @@
 |version=2.0
 |license=LGPL-3.0
-|download=https://dlhb.gamebrew.org/vitahomebrews/pigsinablanketvita.7z
+|download=https://dlhb.gamebrew.org/vitahomebrews/pigsinablanketvita.7z?k33p0fil35
 |website=https://forum.devchroma.nl/index.php/topic,308.0.html
 |source=https://github.com/SonicMastr/Pigs-In-A-Blanket
 }}
-A Piglet/ShaccCg Wrapper Library for OpenGL ES 2.0 Support on the Vita. Now with System App and Experimental MSAAx4 Support!
+{{obsolete}}
+{{#seo:
+|title=Vita Homebrew PC Tools (Developments) - GameBrew
+|title_mode=append
+|image=pigsinablanketvita2.png
+|image_alt=Pigs in a Blanket
+}}
-'''Note: Development Halted - Superceded by [[Pvr Psp2 Vita|PVR_PSP2]]'''.
+A Piglet/ShaccCg Wrapper Library for OpenGL ES 2.0 Support on the Vita. Now with System App and Experimental MSAAx4 Support.
-== What is Pigs in a Blanket? ==
+This library is a developer focused wrapper which provides easy initialization and expandability, with some quality of life features, including supporting resolutions up to 1920x1080 native on the Playstion TV, and on the Vita with [[Sharpscale Vita|Sharpscale]]. Developers can choose make their applications with one resolution in mind, as all long as the code is made to scale by dimension, PIB will handle the rest with it's companion app, the [[PIB Configuration Tool Vita|PIB Configuration Tool]] Pigs in a Blanket Configuration Tool], which allows the user to specify their own preference of resultion that will automatically override the original settings. For more information about Piglet, you can check out our information about it on the [https://forum.devchroma.nl/index.php/topic,294.msg902.html#msg902 forum post].
-This library is a developer focused wrapper which provides easy initialization and expandability, with some quality of life features, including supporting resolutions up to 1920x1080 native on the Playstion TV, and on the Vita with Sharpscale. Developers can choose make their applications with one resolution in mind, as all long as the code is made to scale by dimension, PIB will handle the rest with it's companion app, the [[Pib Configuration Tool Vita|PIB Configuration Tool]] Pigs in a Blanket Configuration Tool], which allows the user to specify their own preference of resultion that will automatically override the original settings. For more information aobut Piglet, you can check out our information about it on our [https://forum.devchroma.nl/index.php/topic,294.msg902.html#msg902 forum post].
+'''Note:''' Development Halted - Superceded by [[PVR_PSP2 Vita|PVR_PSP2]].
+== Compiling ==
+===With VDSuite ===
+* Install [https://github.com/Vita-Development-Suite/doc VDSuite]
+* Install [https://bin.shotatoshounenwachigau.moe/vita/taihen/ Taihen]
+* Run <code>cmake . -Bbuild -G Ninja</code> (Recommend Ninja)
+* <code>cd build</code> and <code>ninja install</code>
+* Link libpib.a in your projects
-It library doubles as the heart of Piglet's Shader compiling abilities, removed in the standalone module. I spent the time to rewrite the shader compiler code according to PSM specifications to re-enable the ShaccCg support that was removed. This includes proper return codes and regular log output, so you never have to wonder what's going on with your shaders. Piglet '''DOES NOT''' support GLSL shaders though, so you'll need to convert the shaders to CG. Check the resources at the end of this README for converting your shaders.
+=== With VitaSDK ===
+* Install [https://vitasdk.org/ VitaSDK]
+* Run <code>vdpm taihen</code> to install <code>libtaihen_stub</code>
+* Run <code>make -j4 install USE_VITASDK=1</code>
+* Link libpib.a in your projects
-This library also support EGL 1.5 <code>eglGetProcAddress</code> functionality using the <code>PIB_GET_PROC_ADDR_CORE</code> flag, as the orignal Piglet only returns extensions per EGL 1.4 standard. Thanks to dots-tb we were able to create a simple patch to support returning GLES functions as well.
+Note when building your projects:
-=== Custom Extension Support ===
+Always compile your project with unsafe. Doing otherwise will result in PIB failing.
-This library will allow us to add extensions using native functions as we feel fit. We'll accept the requests of any developers who have ideas of what extensions to add utilizing PIB, and they will all be able to be accessed via <code>eglGetProcAddress</code>.
-== Supported Extensions ==
+With VitaSDK you can specify the SceLibc heap size by defining <code>sceLibcHeapSize</code> in your code:
+<pre>unsigned int sceLibcHeapSize = 2 * 1024 * 1024;</pre>
+Piglet needs an SceLibc heap size of at least 2MB to intialize. Without it, the module will fail to start. This heap needs to be larger if using <code>-nostdlib</code> as this becomes your main heap. More info on <code>-nostdlib</code> support in the headers.
+You'll need to link your program with:
+* libpib.a
+* liblibScePiglet_stub.a
+* libSceShaccCg_stub.a
+* libtaihen_stub.a
+* libSceAppMgr_stub.a
+For DolceSDK, you'll also need:
+* libSceSharedFb_stub.a
+* libSceGxmInternalForVsh_stub.a
+* libSceGxmInternal_stub.a
+Check the "Samples" folder for examples of how to use PIB to initialize OpenGLES 2.0 with EGL or GLFW ([https://github.com/SonicMastr/glfw-vita GLFW3 port for the vita]).
+Note: Button mapping is perfect and there's full touchscreen support.
+To install Piglet on your Vita, just use the [[PIB Configuration Tool Vita|Pigs in a Blanket Configuration Tool]].
+==User guide==
+=== Supported Extensions ===
 {| class="wikitable"
@@ Line 96: / Line 135: @@
 |}
-==Screenshot==
+==Screenshots==
-[[image:pigsinablanketvita.jpg|600px]]
+'''Piglet''' <br>
+https://dlhb.gamebrew.org/vitahomebrews/pigsinablanketvita3.png
-== Compiling ==
-===With VDSuite ===
-* Install [[Vita Development Suite Vita|VDSuite]]
-* Install [[Taihen By Cuevavirus Vita|Taihen]]
-* Run <code>cmake . -Bbuild -G Ninja</code> (Recommend Ninja)
-* <code>cd build</code> and <code>ninja install</code>
-* Link libpib.a in your projects
-=== With VitaSDK ===
-* Install [https://vitasdk.org/ VitaSDK]
-* Run <code>vdpm taihen</code> to install <code>libtaihen_stub</code>
-* Run <code>make -j4 install USE_VITASDK=1</code>
-* Link libpib.a in your projects
-Note when building your projects:
-'''ALWAYS COMPILE YOUR PROJECTS WITH UNSAFE'''. Doing otherwise will result in PIB failing.
-With VitaSDK you can specify the SceLibc heap size by defining <code>sceLibcHeapSize</code> in your code:
-<pre>unsigned int sceLibcHeapSize = 2 * 1024 * 1024;</pre>
-Piglet needs an SceLibc heap size of at least 2MB to intialize. Without it, the module will fail to start. This heap needs to be larger if using <code>-nostdlib</code> as this becomes your main heap. More info on <code>-nostdlib</code> support in the headers.
-You'll need to link your program with:
+'''PSM''' <br>
+https://dlhb.gamebrew.org/vitahomebrews/pigsinablanketvita4.png
-* libpib.a
+==Credits==
-* liblibScePiglet_stub.a
+Special Thanks:
-* libSceShaccCg_stub.a
+* [https://github.com/GrapheneCt GrapheneCt] - Finding the Piglet Module and being a main part of the Project in reverse engineering and testing.
-* libtaihen_stub.a
+* [https://github.com/dots-tb dots-tb] - Initial idea of using PSM and efforts in getting all of the names for Piglet, as well as being a main part of the Project in reverse engineering and testing.
-* libSceAppMgr_stub.a
+* [https://github.com/cuevavirus cuevavirus] - Help with debugging and sense of direction.
+* [https://github.com/CreepNT CreepNT] - Help with debugging.
+* [https://github.com/Princess-of-Sleeping Princess-of-Sleeping] - Dump tool and PrincessLog.
+* [https://github.com/xyzz xyzz] - Initial deep dive into how ShaccCg works.
+* [https://github.com/Zer0xFF Zer0xFF] and [https://github.com/masterzorag masterzorag] - Their amazing work on the PS4 Piglet reverse engineering.
-For DolceSDK, you'll also need:
+GLSL to CG Conversion Resources:
-* libSceSharedFb_stub.a
-* libSceGxmInternalForVsh_stub.a
-* libSceGxmInternal_stub.a
-=== Check the &quot;Samples&quot; folder for examples of how to use PIB to initialize OpenGLES 2.0 with EGL or GLFW. ===
-Yes. We have a GLFW3 port for the vita. You can use it by simply including it in your project as normal or build it here: [[Glfw Vita]].<br />
-Note: Button mapping is perfect and there's full touchscreen support.
-To install Piglet on your Vita, just use the [[Pib Configuration Tool Vita|Pigs in a Blanket Configuration Tool]].
-Documentation Provided in the Headers. I'm clean.
-== Special Thanks ==
-* '''[https://github.com/GrapheneCt GrapheneCt]''' - Finding the Piglet Module and being a main part of the Project in reverse engineering and testing
-* '''[https://github.com/dots-tb dots-tb]''' - Initial idea of using PSM and efforts in getting all of the names for Piglet, as well as being a main part of the Project in reverse engineering and testing
-* '''[https://github.com/cuevavirus cuevavirus]''' - Help with debugging and sense of direction
-* '''[https://github.com/CreepNT CreepNT]''' - Help with debugging
-* '''[https://github.com/Princess-of-Sleeping Princess-of-Sleeping]''' - Dump tool and PrincessLog
-* '''[https://github.com/xyzz xyzz]''' - Initial deep dive into how ShaccCg works
-* '''[https://github.com/Zer0xFF Zer0xFF] and [https://github.com/masterzorag masterzorag]''' - Their amazing work on the PS4 Piglet reverse engineering
-== GLSL to CG Conversion Resources ==
 *Microsoft GLSL to HLSL: https://docs.microsoft.com/en-us/windows/uwp/gaming/glsl-to-hlsl-reference
 *Nvidia CG Standard Library: http://developer.download.nvidia.com/cg/index_stdlib.html
@@ Line 163: / Line 161: @@
 ==Changelog==
-'''(v.2.0)'''
+'''v2.0'''
-*What's new?
-**System Application Support
+What's new?
-**Fully Enabled Sony EGL Extensions (Common Dialog Support)
+*System Application Support.
-**MSAA x4 Support
+*Fully Enabled Sony EGL Extensions (Common Dialog Support).
-*Bugfixes
+*MSAA x4 Support.
-**Fixed incorrect usage of EGL 1.5's eglGetProcAddresss. Using EGL 1.5 features now has to be manually enabled using the PIB_GET_PROC_ADDR_CORE flag
-**Fixed glGetBooleanv always returning GL_FALSE when using GL_SHADER_COMPILER as the symbolic constant and ShaccCg is enabled
+Bugfixes:
-**Fixed eglSwapInterval would always be locked to 1 no matter what value was entered
+*Fixed incorrect usage of EGL 1.5's eglGetProcAddresss. Using EGL 1.5 features now has to be manually enabled using the PIB_GET_PROC_ADDR_CORE flag.
-**Fixed Libc and FIOS2 always attempting to be started no matter what
+*Fixed glGetBooleanv always returning GL_FALSE when using GL_SHADER_COMPILER as the symbolic constant and ShaccCg is enabled.
-**Fixed ability to double initialize/terminate
+*Fixed eglSwapInterval would always be locked to 1 no matter what value was entered.
+*Fixed Libc and FIOS2 always attempting to be started no matter what.
+*Fixed ability to double initialize/terminate.
-'''(v.1.1)'''
+'''v1.1'''
 * First Release.
 == External links ==
-* Official Website - https://forum.devchroma.nl/index.php/topic,308.0.html
+* GitHub - https://github.com/SonicMastr/Pigs-In-A-Blanket
-* Github - https://github.com/SonicMastr/Pigs-In-A-Blanket
+* CBPS Forums - https://forum.devchroma.nl/index.php/topic,308.0.html
+* CBPS Forums - https://forum.devchroma.nl/index.php?topic=294.0