ScePaf

Much of this page is wrong because much of the PAF is written in C++ but it works as a "function".

A good resource (to merge here) can be found at ScePaf-headers by Graphene.

Module

ScePaf is a C++ runtime.

This module has many virtual tables that point to exported functions. It would be great to start from marking which function belongs to which vtable. This way we can restore initial class structure.

Version	World	Privilege
1.69-3.740.011	Non-secure	User

Libraries

TOOL version of libpaf module is different from CEX and DEX ones as it has an additional library: ScePafAutoTestTty. Some TOOL system apps import this library and crash on CEX/DEX systems because of that missing library.

Known NIDs

Version	Name	World	Visibility	NID
3.60	ScePafLowlayer	Non-secure	User	0x2342266A
3.60	ScePafStdc	Non-secure	User	0xA7D28DAE
3.60	ScePafMisc	Non-secure	User	0x3D643CE8
3.60	ScePafCommon	Non-secure	User	0x3C1965CD
3.60	ScePafGraphics	Non-secure	User	0xA070D6A7
3.60	ScePafThread	Non-secure	User	0x54276D19
3.60	ScePafResource	Non-secure	User	0x2836DC9B
3.60	ScePafToplevel	Non-secure	User	0x4D9A9DD0
3.60	ScePafWidget	Non-secure	User	0x073F8C68
3.68 TOOL	ScePafAutoTestTty	Non-secure	User	0xC503BD7C

Types

typedef struct ScePafSha1Context { // size is 0x68
	uint32_t h[5];
	char unk[0x54];
} ScePafSha1Context;

typedef struct ScePafDateTime {
  SceDateTime data;
  int data_0x10;
  int data_0x14;
} ScePafDateTime;

typedef struct ScePafHeapContext { // size is 0x60
	void *vtable;
	void *heap;
	void *membase;
	SceSize size;
	char name[0x20];
	SceBool is_import_membase;
	char data_0x30[3];
	int data_0x34;
	SceKernelLwMutexWork lw_mtx;
	SceUID memblk_id;
	int data_0x5C;               // ex:1
} ScePafHeapContext;

typedef struct ScePafHeapOpt { // size is 0x14
	int a1;
	int a2;
	char a3[4];
	int a4;
	int a5;
} ScePafHeapOpt;

ScePafGraphics

scePafGraphicsUpdateCurrentWave

Version	NID
3.60	0x2E30F1B5

This a guessed name.

Updates the rendering wave to the wave at the given index.

int scePafGraphicsUpdateCurrentWave(SceUInt32 index, SceFloat32 update_interval);

scePafGraphicsCurrentWave

Version	NID
3.60	0xE71DB07B

This a guessed name.

extern SceUInt32 scePafGraphicsCurrentWave;

ScePafCommon

scePafCommonCreateStartEventWatchdogThread

Version	NID
3.60	0x6735B503

The created thread will run in loop.

int scePafCommonCreateStartEventWatchdogThread(void* eventWatchdogEntry, int unk);

scePafCommonFinalizeEventsWatchdogThread

Version	NID
3.60	0x4A8115D5

int scePafCommonFinalizeEventsWatchdogThread(void* eventWatchdogEntry, int unk);

ScePafMisc

scePafGetCurrentClockLocalTime

Version	NID
3.60	0x96345146

int scePafGetCurrentClockLocalTime(ScePafDateTime *data);

scePafCreateHeap

Version	NID
3.60	0xA2B0BF4D

void scePafCreateHeap(ScePafHeapContext *context, void *membase, SceSize size, const char *name, ScePafHeapOpt *opt);

scePafDeleteHeap

Version	NID
3.60	0x25238A3A

void scePafDeleteHeap(ScePafHeapContext *context);

scePafMallocWithContext

Version	NID
3.60	0x89A1CE78

void *scePafMallocWithContext(ScePafHeapContext *context, SceSize len);

scePafFreeWithContext

Version	NID
3.60	0xCE97B579

void scePafFreeWithContext(ScePafHeapContext *context, void *ptr);

scePafMallocAlignWithContext

Version	NID
3.60	0x04716F15

void *scePafMallocAlignWithContext(ScePafHeapContext *context, SceUInt32 align, SceSize len);

scePafReallocWithContext

Version	NID
3.60	0x74DB7F5D

void *scePafReallocWithContext(ScePafHeapContext *context, void *ptr, SceSize len);

scePafSha1Init

Version	NID
3.60	0xB38C53C0

int scePafSha1Init(ScePafSha1Context *context);

scePafSha1Update

Version	NID
3.60	0xE6BB459E

int scePafSha1Update(ScePafSha1Context *context, const void *data, SceSize length);

scePafSha1Result

Version	NID
3.60	0xB3BF59FC

int scePafSha1Result(ScePafSha1Context *context, void *dst);

ScePafStdc

scePafDefaultHeapInfo

Version	NID
3.60	0x261CAF72

void *scePafDefaultHeapInfo(void);

delete

Version	NID
3.60	0x347AFDD9

void delete(void *ptr);

sce_paf_memalign

Version	NID
3.60	0xAA9952E0

void *sce_paf_memalign(SceSize align, SceSize length);

ScePafResource

scePafResourceSearchIdByName

Version	NID
3.60	0x5F05DE68

This is a guessed name. Temp name was scePafResourceGetIdByName.

Searches using sha-1.

typedef struct ScePafWidgetMainParam {
	ScePafString name;
	int unk_08;
	unsigned int id;
} ScePafWidgetMainParam;

int scePafResourceSearchIdByName(ScePafWidgetMainParam* widgetToSearchFor, ScePafWidgetMainParam* widgetName);

ScePafToplevel

//ScePafToplevel_F5354FEF
SceInt32 SetInterface(SceUInt32 slot, ScePVoid interfaceTable);

//ScePafToplevel_1DF2C6FD
ScePVoid GetInterface(SceUInt32 slot);

//ScePafToplevel_A5560E60, size of the struct is 0x1C0
void* scePafToplevelInitializeSystemParam(void* pafSystemParam);

//ScePafToplevel_907BA948, fills pafSystemParam with system-specific info to prepare for top level init
void* scePafToplevelSetSystemParam(void* pafSystemParam);

//ScePafToplevel_E2860A99, main init function, buffer size must be 0x7C
void* scePafToplevelInitialize(void* pafInitBuf, void* pafSystemParam);

//ScePafToplevel_3F0DB1BF, name is official
scePafToplevelLoadCommonResourceAsync(void* pafTopLevel, ScePafLoadCRFinishCallback finish_callback);

//ScePafToplevel_400F84CE, size of struct is 0x94
scePafToplevelInitializeResourceInitParam(void* pafRcoParam);

//ScePafToplevel_004D98CC
scePafToplevelAssignResourceName(const char* name);

//ScePafToplevel_F702E40A, name is official
scePafToplevelLoadResourceAsync(void* pafRcoParam, ScePafLoadResourceFinishCallback finish_callback);

//ScePafToplevel_12E33958, thread that calls it becomes locked (does all drawing)
scePafToplevelStartDrawing(void* pafTopLevel);

//ScePafToplevel_9A4B0DC4
scePafTopLevelStopDrawing(void* pafTopLevel);

//ScePafToplevel_32CE0577
scePafTopLevelFinalize(void* pafTopLevel);

//ScePafToplevel_004D98CC, selects from resources registered with scePafToplevelAssignResourceName()
scePafTopLevelSelectResource(const char* resourceName);

//ScePafToplevel_34FE1331, struct size is 0x2C
scePafTopLevelInitializePageData(void* pageData);

//ScePafToplevel_30B442D9
scePafTopLevelLoadPage(void* widgetGroup, ScePafWidgetMainParam* pageParam, void* pageData);

ScePafWidget

widget

Type	widget ctx size (bytes)
Plane	0x280
Text	0x2D8

scePafWidgetCreateNewTextWidget

Version	NID
3.60	0x5C2962E1

Temp name was scePafWidgetCreateNewWidget.

/*
 * a2 is maybe parent widget?
 */
void *scePafWidgetCreateNewTextWidget(void *mem_ptr, void *a2, int a3);

scePafWidgetSetColor

Version	NID
3.60	0xCD20EF38

#define SCE_PAF_WIDGET_COLOR_UNKNOWN_1   (1)
#define SCE_PAF_WIDGET_COLOR_TEXT        (2)
#define SCE_PAF_WIDGET_COLOR_TEXT_SHADOW (3)
#define SCE_PAF_WIDGET_COLOR_BACK_BAR    (4)
#define SCE_PAF_WIDGET_COLOR_UNKNOWN_5   (5)

typedef struct ScePafWidgetColor {
  float red;
  float green;
  float blue;
  float alpha;
} ScePafWidgetColor;

/*
 * a2 - set SCE_PAF_WIDGET_COLOR
 * a3 - unknow, set 0
 * a4 - unknow, set 0
 */
int scePafWidgetSetColor(void *pWidget, int a2, int a3, int a4, const ScePafWidgetColor *pColoer);

ScePafWidget_DDB0437F

Version	NID
3.60	0xDDB0437F

A possible name could be scePafWidgetSetColorEnd.

int ScePafWidget_DDB0437F(void *pWidget);

scePafWidgetSetTextOption

Version	NID
3.60	0xF2A2E2E6

#define SCE_PAF_WIDGET_OPTION_TEXT_BOLD          (0x7)
#define SCE_PAF_WIDGET_OPTION_TEXT_SHADOW        (0xC)
#define SCE_PAF_WIDGET_OPTION_TEXT_EXTERNAL_LINE (0xD)

/*
 * a2 - set SCE_PAF_WIDGET_OPTION_TEXT
 * a3 - unknow, set 0
 * a4 - unknow, set 0
 */
int scePafWidgetSetTextOption(void *pWidget, int a2, int a3, int a4, int enable);

scePafWidgetSetTextOption2

Version	NID
3.60	0xCCD58ACB

int scePafWidgetSetTextOption2(void *pWidget, int a2, int a3, int a4);

Example of use

/*
 * Display bar color according to character width?
 * If this function is not used, are all character widths treated as lowercase?
 */
scePafWidgetSetTextOption2(p_widget, 2, 2, 0);

scePafWidgetTypeButton

Version	NID
3.60	0xB773464D

const char *scePafWidgetTypeButton(void);

scePafWidgetTypeText

Version	NID
3.60	0x723F6A4C

const char *scePafWidgetTypeText(void);

scePafWidgetTypeText2

Version	NID
3.60	0x45AA2058

same to scePafWidgetTypeText

const char *scePafWidgetTypeText2(void);

scePafWidgetTypeBusyIndicator1

Version	NID
3.60	0xDBCC58BB

const char *scePafWidgetTypeBusyIndicator1(void);

scePafWidgetTypeBusyIndicator2

Version	NID
3.60	0x1D1F5BF7

same to scePafWidgetTypeBusyIndicator1

const char *scePafWidgetTypeBusyIndicator2(void);

scePafWidgetCmpTypeBase

Version	NID
3.60	0x8EDFDE19

int scePafWidgetCmpTypeBase(void *pWidget, const char *type);

scePafWidgetCmpTypeBusyIndicator

Version	NID
3.60	0xB954B379

int scePafWidgetCmpTypeBusyIndicator(void *pWidget, const char *type);

scePafWidgetSetFontSize

Version	NID
3.60	0x39B15B98

int scePafWidgetSetFontSize(void *pWidget, float size, int unk, SceSize pos, SceSize len);

Example of use

// Set the font size of the entire text
scePafWidgetSetFontSize(p_widget, 22.0f, 1, 0, 0);

// When changing the font size only for the 7th character from the 4th character of the text
scePafWidgetSetFontSize(p_widget, 22.0f, 1, 4, 3);

scePafWidgetSetPosition

Version	NID
3.60	0xE29AB31F

Temp name was scePafWidgetAddWidget.

/*
     x -------------------------------->
    y|---------------------------------|
    ||                |                |
    ||     -x.x       |      +x.x      |
    ||     +y.y       |      +y.y      |
    ||                |                |
    ||----------------0----------------|
    ||                |                |
    ||     -x.x       |      +x.x      |
    ||     -y.y       |      -y.y      |
    ||                |                |
    v|---------------------------------|
*/

typedef struct ScePafWidgetPos {
  float x;      // Distance from display center
  float y;      // Distance from display center
  float z;
  int unk_0x0C; // set 0
} ScePafWidgetPos;

int scePafWidgetSetPosition(void *pWidget, ScePafWidgetPos *pWidgetPos, float a3, int a4, int a5, int a6, int a7, int a8);

Example of use

ScePafWidgetPos widget_pos;
widget_pos.x        = x_pos - (960.0f / 2.0f);
widget_pos.y        = (544.0f / 2.0f) - y_pos;
widget_pos.z        = 0.0f;
widget_pos.unk_0x08 = 0;
scePafWidgetSetPosition(p_widget, &widget_pos, 0.0f, 0, 0x10000, 0, 0, 0);

scePafWidgetSearchWidgetById

Version	NID
3.60	0x9D304F4A

Searches the widget corresponding to a2->id from the group of a1 and returns pWidgetCtx if found

typedef struct ScePafWidgetSearchParam {
	void *unk_0;
	unsigned int unk_4;
	void *unk_8;
	unsigned int id;
} ScePafWidgetSearchParam;

void *scePafWidgetSearchWidgetById(void *a1, ScePafWidgetSearchParam *a2, int a3);

scePafWidgetShowBusyIndicator

Version	NID
3.60	0x04310E14

void scePafWidgetShowBusyIndicator(void *pWidget);

scePafWidgetHideBusyIndicator

Version	NID
3.60	0x73D27A1B

void scePafWidgetHideBusyIndicator(void *pWidget);

ScePafAutoTestTty

ScePafAutoTestTty_9E10E873

Version	NID
3.68	0x9E10E873

Can serve both as normal debug printf and also dump some PAF objects as XML. On external version of libpaf this function does nothing because it does not open tty output.