vitasdk
Documentation of the vitasdk

Exports for User. More...

Data Structures

struct  SceMsgDialogButtonsParam
 
struct  SceMsgDialogUserMessageParam
 
struct  SceMsgDialogSystemMessageParam
 
struct  SceMsgDialogErrorCodeParam
 
struct  SceMsgDialogProgressBarParam
 
struct  SceMsgDialogParam
 
struct  SceMsgDialogResult
 

Macros

#define SCE_MSG_DIALOG_USER_MSG_SIZE   512
 Max length of a user message.
 

Enumerations

enum  SceMsgDialogErrorCode { SCE_MSG_DIALOG_ERROR_PARAM = 0x80100A01 }
 
enum  SceMsgDialogMode {
  SCE_MSG_DIALOG_MODE_INVALID = 0 , SCE_MSG_DIALOG_MODE_USER_MSG = 1 , SCE_MSG_DIALOG_MODE_SYSTEM_MSG = 2 , SCE_MSG_DIALOG_MODE_ERROR_CODE = 3 ,
  SCE_MSG_DIALOG_MODE_PROGRESS_BAR = 4
}
 
enum  SceMsgDialogSystemMessageType {
  SCE_MSG_DIALOG_SYSMSG_TYPE_INVALID = 0 , SCE_MSG_DIALOG_SYSMSG_TYPE_WAIT = 1 , SCE_MSG_DIALOG_SYSMSG_TYPE_NOSPACE = 2 , SCE_MSG_DIALOG_SYSMSG_TYPE_MAGNETIC_CALIBRATION = 3 ,
  SCE_MSG_DIALOG_SYSMSG_TYPE_WAIT_SMALL = 5 , SCE_MSG_DIALOG_SYSMSG_TYPE_WAIT_CANCEL = 6 , SCE_MSG_DIALOG_SYSMSG_TYPE_NEED_MC_CONTINUE = 7 , SCE_MSG_DIALOG_SYSMSG_TYPE_NEED_MC_OPERATION = 8 ,
  SCE_MSG_DIALOG_SYSMSG_TYPE_TRC_MIC_DISABLED = 100 , SCE_MSG_DIALOG_SYSMSG_TYPE_TRC_WIFI_REQUIRED_OPERATION = 101 , SCE_MSG_DIALOG_SYSMSG_TYPE_TRC_WIFI_REQUIRED_APPLICATION = 102 , SCE_MSG_DIALOG_SYSMSG_TYPE_TRC_EMPTY_STORE = 103
}
 
enum  SceMsgDialogButtonType {
  SCE_MSG_DIALOG_BUTTON_TYPE_OK = 0 , SCE_MSG_DIALOG_BUTTON_TYPE_YESNO = 1 , SCE_MSG_DIALOG_BUTTON_TYPE_NONE = 2 , SCE_MSG_DIALOG_BUTTON_TYPE_OK_CANCEL = 3 ,
  SCE_MSG_DIALOG_BUTTON_TYPE_CANCEL = 4 , SCE_MSG_DIALOG_BUTTON_TYPE_3BUTTONS = 5
}
 
enum  SceMsgDialogButtonId {
  SCE_MSG_DIALOG_BUTTON_ID_INVALID = 0 , SCE_MSG_DIALOG_BUTTON_ID_OK = 1 , SCE_MSG_DIALOG_BUTTON_ID_YES = 1 , SCE_MSG_DIALOG_BUTTON_ID_NO = 2 ,
  SCE_MSG_DIALOG_BUTTON_ID_RETRY = 3 , SCE_MSG_DIALOG_BUTTON_ID_BUTTON1 = 1 , SCE_MSG_DIALOG_BUTTON_ID_BUTTON2 = 2 , SCE_MSG_DIALOG_BUTTON_ID_BUTTON3 = 3
}
 
enum  SceMsgDialogProgressBarType { SCE_MSG_DIALOG_PROGRESSBAR_TYPE_PERCENTAGE = 0 }
 
enum  SceMsgDialogProgressBarTarget { SCE_MSG_DIALOG_PROGRESSBAR_TARGET_BAR_DEFAULT = 0 }
 
enum  SceMsgDialogEnvFlag { SCE_MSG_DIALOG_ENV_FLAG_DEFAULT = 0 }
 
enum  SceMsgDialogFontSize { SCE_MSG_DIALOG_FONT_SIZE_DEFAULT = 0 , SCE_MSG_DIALOG_FONT_SIZE_SMALL = 1 }
 

Functions

 VITASDK_BUILD_ASSERT_EQ (0x38, SceMsgDialogButtonsParam)
 
 VITASDK_BUILD_ASSERT_EQ (0x28, SceMsgDialogUserMessageParam)
 
 VITASDK_BUILD_ASSERT_EQ (0x28, SceMsgDialogSystemMessageParam)
 
 VITASDK_BUILD_ASSERT_EQ (0x24, SceMsgDialogErrorCodeParam)
 
 VITASDK_BUILD_ASSERT_EQ (0x50, SceMsgDialogProgressBarParam)
 
 VITASDK_BUILD_ASSERT_EQ (0x88, SceMsgDialogParam)
 
 VITASDK_BUILD_ASSERT_EQ (0x2C, SceMsgDialogResult)
 
int sceMsgDialogInit (const SceMsgDialogParam *param)
 
SceCommonDialogStatus sceMsgDialogGetStatus (void)
 
int sceMsgDialogAbort (void)
 
int sceMsgDialogGetResult (SceMsgDialogResult *result)
 
int sceMsgDialogTerm (void)
 
int sceMsgDialogClose (void)
 
int sceMsgDialogProgressBarInc (SceMsgDialogProgressBarTarget target, SceUInt32 delta)
 Increases the rate of the progress bar in the message dialog.
 
int sceMsgDialogProgressBarSetValue (SceMsgDialogProgressBarTarget target, SceUInt32 rate)
 Set the progress rate of the progress bar in the message dialog immediately.
 
int sceMsgDialogProgressBarSetMsg (SceMsgDialogProgressBarTarget target, const SceChar8 *barMsg)
 Set the string displayed in the progress bar of the message dialog immediately.
 

Variables

const char * SceMsgDialogButtonsParam::msg1
 Text of the first button.
 
SceInt32 SceMsgDialogButtonsParam::fontSize1
 Font size of the first button (one of SceMsgDialogFontSize)
 
const char * SceMsgDialogButtonsParam::msg2
 Text of the second button.
 
SceInt32 SceMsgDialogButtonsParam::fontSize2
 Font size of the second button (one of SceMsgDialogFontSize)
 
const char * SceMsgDialogButtonsParam::msg3
 Text of the third button.
 
SceInt32 SceMsgDialogButtonsParam::fontSize3
 Font size of the third button (one of SceMsgDialogFontSize)
 
SceChar8 SceMsgDialogButtonsParam::reserved [32]
 Reserved range.
 
SceInt32 SceMsgDialogUserMessageParam::buttonType
 Type of button set (one of SceMsgDialogButtonType)
 
const SceChar8SceMsgDialogUserMessageParam::msg
 Displayed message.
 
SceMsgDialogButtonsParamSceMsgDialogUserMessageParam::buttonParam
 Buttons parameters.
 
SceChar8 SceMsgDialogUserMessageParam::reserved [28]
 Reserved range.
 
SceInt32 SceMsgDialogSystemMessageParam::sysMsgType
 System message type (one of SceMsgDialogSystemMessageType)
 
SceInt32 SceMsgDialogSystemMessageParam::value
 Additional value.
 
SceChar8 SceMsgDialogSystemMessageParam::reserved [32]
 Reserved range.
 
SceInt32 SceMsgDialogErrorCodeParam::errorCode
 Displayed error code.
 
SceChar8 SceMsgDialogErrorCodeParam::reserved [32]
 Reserved range.
 
SceInt32 SceMsgDialogProgressBarParam::barType
 Progress bar type (one of SceMsgDialogProgressBarType)
 
SceMsgDialogSystemMessageParam SceMsgDialogProgressBarParam::sysMsgParam
 Displayed system message.
 
const SceChar8SceMsgDialogProgressBarParam::msg
 Displayed user message.
 
SceInt32 SceMsgDialogProgressBarParam::reserved [8]
 Reserved range.
 
SceUInt32 SceMsgDialogParam::sdkVersion
 Required to use MsgDialog. Just use NULL.
 
SceCommonDialogParam SceMsgDialogParam::commonParam
 Common parameter.
 
SceInt32 SceMsgDialogParam::mode
 Mode of function (one of SceMsgDialogMode)
 
SceMsgDialogUserMessageParamSceMsgDialogParam::userMsgParam
 Parameter for user message.
 
SceMsgDialogSystemMessageParamSceMsgDialogParam::sysMsgParam
 Parameter for system prepared message.
 
SceMsgDialogErrorCodeParamSceMsgDialogParam::errorCodeParam
 Parameter for display error code.
 
SceMsgDialogProgressBarParamSceMsgDialogParam::progBarParam
 Parameter for progress bar.
 
SceInt32 SceMsgDialogParam::flag
 Settings for dialog environment (one of SceMsgDialogEnvFlag)
 
SceChar8 SceMsgDialogParam::reserved [32]
 Reserved range.
 
SceInt32 SceMsgDialogResult::mode
 Mode of function (one of SceMsgDialogMode)
 
SceInt32 SceMsgDialogResult::result
 Result of executing function.
 
SceInt32 SceMsgDialogResult::buttonId
 Id of button user selected (one of SceMsgDialogButtonId)
 
SceChar8 SceMsgDialogResult::reserved [32]
 Reserved range.
 

Detailed Description

Exports for User.


Using this library in your project

Include the header file in your project:


Link the library to the executable:

SceCommonDialog_stub




Data Structure Documentation

◆ SceMsgDialogButtonsParam

struct SceMsgDialogButtonsParam
Data Fields
const char * msg1 Text of the first button.
SceInt32 fontSize1 Font size of the first button (one of SceMsgDialogFontSize)
const char * msg2 Text of the second button.
SceInt32 fontSize2 Font size of the second button (one of SceMsgDialogFontSize)
const char * msg3 Text of the third button.
SceInt32 fontSize3 Font size of the third button (one of SceMsgDialogFontSize)
SceChar8 reserved[32] Reserved range.

◆ SceMsgDialogUserMessageParam

struct SceMsgDialogUserMessageParam
Data Fields
SceInt32 buttonType Type of button set (one of SceMsgDialogButtonType)
const SceChar8 * msg Displayed message.
SceMsgDialogButtonsParam * buttonParam Buttons parameters.
SceChar8 reserved[28] Reserved range.

◆ SceMsgDialogSystemMessageParam

struct SceMsgDialogSystemMessageParam
Data Fields
SceInt32 sysMsgType System message type (one of SceMsgDialogSystemMessageType)
SceInt32 value Additional value.
SceChar8 reserved[32] Reserved range.

◆ SceMsgDialogErrorCodeParam

struct SceMsgDialogErrorCodeParam
Data Fields
SceInt32 errorCode Displayed error code.
SceChar8 reserved[32] Reserved range.

◆ SceMsgDialogProgressBarParam

struct SceMsgDialogProgressBarParam
Data Fields
SceInt32 barType Progress bar type (one of SceMsgDialogProgressBarType)
SceMsgDialogSystemMessageParam sysMsgParam Displayed system message.
const SceChar8 * msg Displayed user message.
SceInt32 reserved[8] Reserved range.

◆ SceMsgDialogParam

struct SceMsgDialogParam
Data Fields
SceUInt32 sdkVersion Required to use MsgDialog. Just use NULL.
SceCommonDialogParam commonParam Common parameter.
SceInt32 mode Mode of function (one of SceMsgDialogMode)
SceMsgDialogUserMessageParam * userMsgParam Parameter for user message.
SceMsgDialogSystemMessageParam * sysMsgParam Parameter for system prepared message.
SceMsgDialogErrorCodeParam * errorCodeParam Parameter for display error code.
SceMsgDialogProgressBarParam * progBarParam Parameter for progress bar.
SceInt32 flag Settings for dialog environment (one of SceMsgDialogEnvFlag)
SceChar8 reserved[32] Reserved range.

◆ SceMsgDialogResult

struct SceMsgDialogResult
Data Fields
SceInt32 mode Mode of function (one of SceMsgDialogMode)
SceInt32 result Result of executing function.
SceInt32 buttonId Id of button user selected (one of SceMsgDialogButtonId)
SceChar8 reserved[32] Reserved range.

Macro Definition Documentation

◆ SCE_MSG_DIALOG_USER_MSG_SIZE

#define SCE_MSG_DIALOG_USER_MSG_SIZE   512

Max length of a user message.

Enumeration Type Documentation

◆ SceMsgDialogErrorCode

Enumerator
SCE_MSG_DIALOG_ERROR_PARAM 

Illegal parameter.

◆ SceMsgDialogMode

Enumerator
SCE_MSG_DIALOG_MODE_INVALID 
SCE_MSG_DIALOG_MODE_USER_MSG 
SCE_MSG_DIALOG_MODE_SYSTEM_MSG 
SCE_MSG_DIALOG_MODE_ERROR_CODE 
SCE_MSG_DIALOG_MODE_PROGRESS_BAR 

◆ SceMsgDialogSystemMessageType

Enumerator
SCE_MSG_DIALOG_SYSMSG_TYPE_INVALID 
SCE_MSG_DIALOG_SYSMSG_TYPE_WAIT 

Displays "Please wait.".

SCE_MSG_DIALOG_SYSMSG_TYPE_NOSPACE 

Displays "There is not enough free space on the memory card.".

SCE_MSG_DIALOG_SYSMSG_TYPE_MAGNETIC_CALIBRATION 

Displays "Move away from the source of interference, or adjust the compass by moving your PS Vita system as shown below.".

SCE_MSG_DIALOG_SYSMSG_TYPE_WAIT_SMALL 

Displays "Please wait." in a small message dialog.

SCE_MSG_DIALOG_SYSMSG_TYPE_WAIT_CANCEL 

Displays "Please wait..." with a cancel button.

SCE_MSG_DIALOG_SYSMSG_TYPE_NEED_MC_CONTINUE 

Displays "Cannot continue the application. No memory card is inserted.".

SCE_MSG_DIALOG_SYSMSG_TYPE_NEED_MC_OPERATION 

Displays "Cannot perform this operation. No memory card is inserted.".

SCE_MSG_DIALOG_SYSMSG_TYPE_TRC_MIC_DISABLED 

Displays "You must enable the microphone.".

SCE_MSG_DIALOG_SYSMSG_TYPE_TRC_WIFI_REQUIRED_OPERATION 

Displays "You must use Wi-Fi to do this.".

SCE_MSG_DIALOG_SYSMSG_TYPE_TRC_WIFI_REQUIRED_APPLICATION 

Displays "You must use Wi-Fi to use this application.".

SCE_MSG_DIALOG_SYSMSG_TYPE_TRC_EMPTY_STORE 

Displays "No content is available yet.".

◆ SceMsgDialogButtonType

Enumerator
SCE_MSG_DIALOG_BUTTON_TYPE_OK 
SCE_MSG_DIALOG_BUTTON_TYPE_YESNO 
SCE_MSG_DIALOG_BUTTON_TYPE_NONE 
SCE_MSG_DIALOG_BUTTON_TYPE_OK_CANCEL 
SCE_MSG_DIALOG_BUTTON_TYPE_CANCEL 
SCE_MSG_DIALOG_BUTTON_TYPE_3BUTTONS 

◆ SceMsgDialogButtonId

Enumerator
SCE_MSG_DIALOG_BUTTON_ID_INVALID 
SCE_MSG_DIALOG_BUTTON_ID_OK 
SCE_MSG_DIALOG_BUTTON_ID_YES 
SCE_MSG_DIALOG_BUTTON_ID_NO 
SCE_MSG_DIALOG_BUTTON_ID_RETRY 
SCE_MSG_DIALOG_BUTTON_ID_BUTTON1 
SCE_MSG_DIALOG_BUTTON_ID_BUTTON2 
SCE_MSG_DIALOG_BUTTON_ID_BUTTON3 

◆ SceMsgDialogProgressBarType

Enumerator
SCE_MSG_DIALOG_PROGRESSBAR_TYPE_PERCENTAGE 

◆ SceMsgDialogProgressBarTarget

Enumerator
SCE_MSG_DIALOG_PROGRESSBAR_TARGET_BAR_DEFAULT 

◆ SceMsgDialogEnvFlag

Enumerator
SCE_MSG_DIALOG_ENV_FLAG_DEFAULT 

◆ SceMsgDialogFontSize

Enumerator
SCE_MSG_DIALOG_FONT_SIZE_DEFAULT 
SCE_MSG_DIALOG_FONT_SIZE_SMALL 

Function Documentation

◆ VITASDK_BUILD_ASSERT_EQ() [1/7]

VITASDK_BUILD_ASSERT_EQ ( 0x38  ,
SceMsgDialogButtonsParam   
)

◆ VITASDK_BUILD_ASSERT_EQ() [2/7]

VITASDK_BUILD_ASSERT_EQ ( 0x28  ,
SceMsgDialogUserMessageParam   
)

◆ VITASDK_BUILD_ASSERT_EQ() [3/7]

VITASDK_BUILD_ASSERT_EQ ( 0x28  ,
SceMsgDialogSystemMessageParam   
)

◆ VITASDK_BUILD_ASSERT_EQ() [4/7]

VITASDK_BUILD_ASSERT_EQ ( 0x24  ,
SceMsgDialogErrorCodeParam   
)

◆ VITASDK_BUILD_ASSERT_EQ() [5/7]

VITASDK_BUILD_ASSERT_EQ ( 0x50  ,
SceMsgDialogProgressBarParam   
)

◆ VITASDK_BUILD_ASSERT_EQ() [6/7]

VITASDK_BUILD_ASSERT_EQ ( 0x88  ,
SceMsgDialogParam   
)

◆ VITASDK_BUILD_ASSERT_EQ() [7/7]

VITASDK_BUILD_ASSERT_EQ ( 0x2C  ,
SceMsgDialogResult   
)

◆ sceMsgDialogInit()

int sceMsgDialogInit ( const SceMsgDialogParam param)

◆ sceMsgDialogGetStatus()

SceCommonDialogStatus sceMsgDialogGetStatus ( void  )

◆ sceMsgDialogAbort()

int sceMsgDialogAbort ( void  )

◆ sceMsgDialogGetResult()

int sceMsgDialogGetResult ( SceMsgDialogResult result)

◆ sceMsgDialogTerm()

int sceMsgDialogTerm ( void  )

◆ sceMsgDialogClose()

int sceMsgDialogClose ( void  )

◆ sceMsgDialogProgressBarInc()

int sceMsgDialogProgressBarInc ( SceMsgDialogProgressBarTarget  target,
SceUInt32  delta 
)

Increases the rate of the progress bar in the message dialog.

Parameters
target- Target progress bar
delta- Progress rate to increase (%)
Returns
0 on success, < 0 on error.
Note
- If NULL is provided as FrameBuf pointer, output is blacked out.

◆ sceMsgDialogProgressBarSetValue()

int sceMsgDialogProgressBarSetValue ( SceMsgDialogProgressBarTarget  target,
SceUInt32  rate 
)

Set the progress rate of the progress bar in the message dialog immediately.

Parameters
target- Target progress bar
delta- Progress rate to increase (%)
Returns
0 on success, < 0 on error.
Note
- If NULL is provided as FrameBuf pointer, output is blacked out.

◆ sceMsgDialogProgressBarSetMsg()

int sceMsgDialogProgressBarSetMsg ( SceMsgDialogProgressBarTarget  target,
const SceChar8 barMsg 
)

Set the string displayed in the progress bar of the message dialog immediately.

Parameters
target- Target progress bar
barMsg- The string displayed in the progress bar
Returns
0 on success, < 0 on error.
Note
- If NULL is provided as FrameBuf pointer, output is blacked out.

Variable Documentation

◆ msg1

const char* SceMsgDialogButtonsParam::msg1

Text of the first button.

◆ fontSize1

SceInt32 SceMsgDialogButtonsParam::fontSize1

Font size of the first button (one of SceMsgDialogFontSize)

◆ msg2

const char* SceMsgDialogButtonsParam::msg2

Text of the second button.

◆ fontSize2

SceInt32 SceMsgDialogButtonsParam::fontSize2

Font size of the second button (one of SceMsgDialogFontSize)

◆ msg3

const char* SceMsgDialogButtonsParam::msg3

Text of the third button.

◆ fontSize3

SceInt32 SceMsgDialogButtonsParam::fontSize3

Font size of the third button (one of SceMsgDialogFontSize)

◆ reserved [1/7]

SceChar8 SceMsgDialogButtonsParam::reserved[32]

Reserved range.

◆ buttonType

SceInt32 SceMsgDialogUserMessageParam::buttonType

Type of button set (one of SceMsgDialogButtonType)

◆ msg [1/2]

const SceChar8* SceMsgDialogUserMessageParam::msg

Displayed message.

◆ buttonParam

SceMsgDialogButtonsParam* SceMsgDialogUserMessageParam::buttonParam

Buttons parameters.

◆ reserved [2/7]

SceChar8 SceMsgDialogUserMessageParam::reserved[28]

Reserved range.

◆ sysMsgType

SceInt32 SceMsgDialogSystemMessageParam::sysMsgType

System message type (one of SceMsgDialogSystemMessageType)

◆ value

SceInt32 SceMsgDialogSystemMessageParam::value

Additional value.

◆ reserved [3/7]

SceChar8 SceMsgDialogSystemMessageParam::reserved[32]

Reserved range.

◆ errorCode

SceInt32 SceMsgDialogErrorCodeParam::errorCode

Displayed error code.

◆ reserved [4/7]

SceChar8 SceMsgDialogErrorCodeParam::reserved[32]

Reserved range.

◆ barType

SceInt32 SceMsgDialogProgressBarParam::barType

Progress bar type (one of SceMsgDialogProgressBarType)

◆ sysMsgParam [1/2]

SceMsgDialogSystemMessageParam SceMsgDialogProgressBarParam::sysMsgParam

Displayed system message.

◆ msg [2/2]

const SceChar8* SceMsgDialogProgressBarParam::msg

Displayed user message.

◆ reserved [5/7]

SceInt32 SceMsgDialogProgressBarParam::reserved[8]

Reserved range.

◆ sdkVersion

SceUInt32 SceMsgDialogParam::sdkVersion

Required to use MsgDialog. Just use NULL.

◆ commonParam

SceCommonDialogParam SceMsgDialogParam::commonParam

Common parameter.

◆ mode [1/2]

SceInt32 SceMsgDialogParam::mode

Mode of function (one of SceMsgDialogMode)

◆ userMsgParam

SceMsgDialogUserMessageParam* SceMsgDialogParam::userMsgParam

Parameter for user message.

◆ sysMsgParam [2/2]

SceMsgDialogSystemMessageParam* SceMsgDialogParam::sysMsgParam

Parameter for system prepared message.

◆ errorCodeParam

SceMsgDialogErrorCodeParam* SceMsgDialogParam::errorCodeParam

Parameter for display error code.

◆ progBarParam

SceMsgDialogProgressBarParam* SceMsgDialogParam::progBarParam

Parameter for progress bar.

◆ flag

SceInt32 SceMsgDialogParam::flag

Settings for dialog environment (one of SceMsgDialogEnvFlag)

◆ reserved [6/7]

SceChar8 SceMsgDialogParam::reserved[32]

Reserved range.

◆ mode [2/2]

SceInt32 SceMsgDialogResult::mode

Mode of function (one of SceMsgDialogMode)

◆ result

SceInt32 SceMsgDialogResult::result

Result of executing function.

◆ buttonId

SceInt32 SceMsgDialogResult::buttonId

Id of button user selected (one of SceMsgDialogButtonId)

◆ reserved [7/7]

SceChar8 SceMsgDialogResult::reserved[32]

Reserved range.