External/pspsdk
1
0
Fork 0
mirror of https://github.com/pspdev/pspsdk.git synced 2025-10-03 08:41:34 +00:00
Code Issues Packages Projects Releases Wiki Activity

Improve pixelMask example and documentation

Browse Source
This commit is contained in:
Francisco Javier Trujillo Mata
2025-08-17 18:47:05 +02:00
parent cfb7fc37c5
commit 5943f71329
2 changed files with 17 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
src/gu/pspgu.h
View File

@@ -964,6 +964,13 @@ void sceGuClearStencil(unsigned int stencil);
* Set mask for which bits of the pixels to write
*
* @param mask - Which bits to filter against writes
* @note The representation of the mask is in the format 0xAABBGGRR: 1-bits prevent writes to that bit, 0-bits allow writes.
* @note If you have a draw format using less than 8 bits per channel, you need to mask the higher bits as less significant bits aren't used.
* @example With a draw format of GU_PSM_5650:
* sceGuPixelMask(0x00000000); // All channels writable
* sceGuPixelMask(0x0000FCF8); // Only Blue (+Alpha) writable
* sceGuPixelMask(0x00F800F8); // Only Green (+Alpha) writable
* sceGuPixelMask(0x00F8FC00); // Only Red (+Alpha) writable
*
**/
void sceGuPixelMask(unsigned int mask);

20
src/samples/gu/pixelmask/pixelmask.c
View File

@@ -38,13 +38,15 @@ typedef struct PixelMaskMode
} PixelMaskMode;
#define TEXTURE_FORMAT GU_PSM_8888
#define DRAW_FORMAT GU_PSM_5650
// In mask 0xAABBGGRR: 1-bits prevent writes to that bit, 0-bits allow writes.
// If you have a pixel format using less than 8 bits per channel, you need to mask the higher bits.
// Keep AA=0x00 so alpha writes remain enabled for all modes in this sample.
static const PixelMaskMode modes[] = {
{"Mask 0x00000000: All channels writable", 0x00000000},
{"Mask 0x0000FFFF: Only Blue (+Alpha) writable", 0x0000FFFF}, // R=0xFF, G=0xFF, B=0x00, A=0x00
{"Mask 0x00FF00FF: Only Green (+Alpha) writable", 0x00FF00FF}, // R=0xFF, G=0x00, B=0xFF, A=0x00
{"Mask 0x00FFFF00: Only Red (+Alpha) writable", 0x00FFFF00}, // R=0x00, G=0xFF, B=0xFF, A=0x00
{"Mask 0x0000FCF8: Only Blue (+Alpha) writable", 0x0000FCF8},
{"Mask 0x00F800F8: Only Green (+Alpha) writable", 0x00F800F8},
{"Mask 0x00F8FC00: Only Red (+Alpha) writable", 0x00F8FC00},
};
// GU_PSM_8888, 8x8. Where the 2 first columns are red and the 2 last columns are green.
@@ -88,20 +90,20 @@ int main(int argc, char *argv[])
{
int mode_index = 0;
int frame_counter = 0;
int drawFormat = GU_PSM_5650;
pspDebugScreenInit();
setupCallbacks();
// Setup GU
void *fbp0 = guGetStaticVramBuffer(BUF_WIDTH, SCR_HEIGHT, drawFormat);
void *fbp1 = guGetStaticVramBuffer(BUF_WIDTH, SCR_HEIGHT, drawFormat);
void *fbp0 = guGetStaticVramBuffer(BUF_WIDTH, SCR_HEIGHT, DRAW_FORMAT);
void *fbp1 = guGetStaticVramBuffer(BUF_WIDTH, SCR_HEIGHT, DRAW_FORMAT);
pspDebugScreenInitEx(fbp0, DRAW_FORMAT, 1);
sceGuInit();
sceGuStart(GU_DIRECT, list);
sceGuDrawBuffer(drawFormat, fbp0, BUF_WIDTH);
sceGuDrawBuffer(DRAW_FORMAT, fbp0, BUF_WIDTH);
sceGuDispBuffer(SCR_WIDTH, SCR_HEIGHT, fbp1, BUF_WIDTH);
sceGuOffset(2048 - (SCR_WIDTH / 2), 2048 - (SCR_HEIGHT / 2));
sceGuViewport(2048, 2048, SCR_WIDTH, SCR_HEIGHT);
@@ -123,8 +125,6 @@ int main(int argc, char *argv[])
sceKernelDcacheWritebackAll();
pspDebugScreenInitEx(fbp0, drawFormat, 1);
while (running())
{
sceGuStart(GU_DIRECT, list);