/** * @file swkbd.h * @brief Wrapper for using the swkbd (software keyboard) LibraryApplet. * @author yellows8 * @copyright libnx Authors */ #pragma once #include "../types.h" #include "../services/applet.h" /// Output result returned by \ref SwkbdTextCheckCb. typedef enum { SwkbdTextCheckResult_OK = 0, ///< Success, valid string. SwkbdTextCheckResult_Bad = 1, ///< Failure, invalid string. Error message is displayed in a message-box, pressing OK will return to swkbd again. SwkbdTextCheckResult_Prompt = 2, ///< Failure, invalid string. Error message is displayed in a message-box, pressing Cancel will return to swkbd again, while pressing OK will continue as if the text was valid. SwkbdTextCheckResult_Silent = 3, ///< Failure, invalid string. With value 3 and above, swkbd will silently not accept the string, without displaying any error. } SwkbdTextCheckResult; /// Type of keyboard. typedef enum { SwkbdType_Normal = 0, ///< Normal keyboard. SwkbdType_NumPad = 1, ///< Number pad. The buttons at the bottom left/right are only available when they're set by \ref swkbdConfigSetLeftOptionalSymbolKey / \ref swkbdConfigSetRightOptionalSymbolKey. SwkbdType_QWERTY = 2, ///< QWERTY (and variants) keyboard only. SwkbdType_Unknown3 = 3, ///< The same as SwkbdType_Normal keyboard. SwkbdType_Latin = 4, ///< All Latin like languages keyboard only (without CJK keyboard). SwkbdType_ZhHans = 5, ///< Chinese Simplified keyboard only. SwkbdType_ZhHant = 6, ///< Chinese Traditional keyboard only. SwkbdType_Korean = 7, ///< Korean keyboard only. SwkbdType_All = 8, ///< All language keyboards. SwkbdType_Unknown9 = 9, ///< Unknown } SwkbdType; /// Bitmask for SwkbdArgCommon::keySetDisableBitmask. This disables keys on the keyboard when the corresponding bit(s) are set. enum { SwkbdKeyDisableBitmask_Space = BIT(1), ///< Disable space-bar. SwkbdKeyDisableBitmask_At = BIT(2), ///< Disable '@'. SwkbdKeyDisableBitmask_Percent = BIT(3), ///< Disable '%'. SwkbdKeyDisableBitmask_ForwardSlash = BIT(4), ///< Disable '/'. SwkbdKeyDisableBitmask_Backslash = BIT(5), ///< Disable '\'. SwkbdKeyDisableBitmask_Numbers = BIT(6), ///< Disable numbers. SwkbdKeyDisableBitmask_DownloadCode = BIT(7), ///< Used for \ref swkbdConfigMakePresetDownloadCode. SwkbdKeyDisableBitmask_UserName = BIT(8), ///< Used for \ref swkbdConfigMakePresetUserName. Disables '@', '%', and '\'. }; /// Value for SwkbdArgCommon::textDrawType. Only applies when stringLenMax is 1..32, otherwise swkbd will only use SwkbdTextDrawType_Box. typedef enum { SwkbdTextDrawType_Line = 0, ///< The text will be displayed on a line. Also enables displaying the Header and Sub text. SwkbdTextDrawType_Box = 1, ///< The text will be displayed in a box. SwkbdTextDrawType_DownloadCode = 2, ///< Used by \ref swkbdConfigMakePresetDownloadCode on [5.0.0+]. Enables using \ref SwkbdArgV7 unk_x3e0. } SwkbdTextDrawType; /// SwkbdInline Interactive input storage request ID. typedef enum { SwkbdRequestCommand_Finalize = 0x4, SwkbdRequestCommand_SetUserWordInfo = 0x6, SwkbdRequestCommand_SetCustomizeDic = 0x7, SwkbdRequestCommand_Calc = 0xA, SwkbdRequestCommand_SetCustomizedDictionaries = 0xB, SwkbdRequestCommand_UnsetCustomizedDictionaries = 0xC, SwkbdRequestCommand_SetChangedStringV2Flag = 0xD, SwkbdRequestCommand_SetMovedCursorV2Flag = 0xE, } SwkbdRequestCommand; /// SwkbdInline Interactive output storage reply ID. typedef enum { SwkbdReplyType_FinishedInitialize = 0x0, SwkbdReplyType_ChangedString = 0x2, SwkbdReplyType_MovedCursor = 0x3, SwkbdReplyType_MovedTab = 0x4, SwkbdReplyType_DecidedEnter = 0x5, SwkbdReplyType_DecidedCancel = 0x6, SwkbdReplyType_ChangedStringUtf8 = 0x7, SwkbdReplyType_MovedCursorUtf8 = 0x8, SwkbdReplyType_DecidedEnterUtf8 = 0x9, SwkbdReplyType_UnsetCustomizeDic = 0xA, SwkbdReplyType_ReleasedUserWordInfo = 0xB, SwkbdReplyType_UnsetCustomizedDictionaries = 0xC, SwkbdReplyType_ChangedStringV2 = 0xD, SwkbdReplyType_MovedCursorV2 = 0xE, SwkbdReplyType_ChangedStringUtf8V2 = 0xF, SwkbdReplyType_MovedCursorUtf8V2 = 0x10, } SwkbdReplyType; /// SwkbdInline State typedef enum { SwkbdState_Inactive = 0x0, ///< Default state from \ref swkbdInlineCreate, before a state is set by \ref swkbdInlineUpdate when a reply is received. Also indicates that the applet is no longer running. SwkbdState_Initialized = 0x1, ///< Applet is initialized but hidden. SwkbdState_Appearing = 0x2, ///< Applet is appearing. SwkbdState_Shown = 0x3, ///< Applet is fully shown and ready to accept text input. SwkbdState_Disappearing = 0x4, ///< The user pressed the ok or cancel button, causing the applet to disappear. SwkbdState_Unknown5 = 0x5, SwkbdState_Unknown6 = 0x6, } SwkbdState; /// Value for \ref SwkbdInitializeArg mode. Controls the LibAppletMode when launching the applet. typedef enum { SwkbdInlineMode_UserDisplay = 0, ///< LibAppletMode_BackgroundIndirect. This is the default. The user-process must handle displaying the swkbd gfx on the screen, by loading the image with \ref swkbdInlineGetImage. SwkbdInlineMode_AppletDisplay = 1, ///< LibAppletMode_Background. The applet will handle displaying gfx on the screen. } SwkbdInlineMode; /// TextCheck callback set by \ref swkbdConfigSetTextCheckCallback, for validating the input string when the swkbd ok-button is pressed. This buffer contains an UTF-8 string. This callback should validate the input string, then return a \ref SwkbdTextCheckResult indicating success/failure. On failure, this function must write an error message to the tmp_string buffer, which will then be displayed by swkbd. typedef SwkbdTextCheckResult (*SwkbdTextCheckCb)(char* tmp_string, size_t tmp_string_size); /// User dictionary word. typedef struct { u8 unk_x0[0x64]; } SwkbdDictWord; /// Input data for SwkbdInline request SetCustomizeDic. typedef struct { u8 unk_x0[0x70]; } SwkbdCustomizeDicInfo; typedef struct { void* buffer; ///< 0x1000-byte aligned buffer. u32 buffer_size; ///< 0x1000-byte aligned buffer size. u64 entries[0x18]; u16 total_entries; } PACKED SwkbdCustomizedDictionarySet; /// Base swkbd arg struct. typedef struct { SwkbdType type; ///< See \ref SwkbdType. u16 okButtonText[18/2]; u16 leftButtonText; u16 rightButtonText; u8 dicFlag; ///< Enables dictionary usage when non-zero (including the system dictionary). u8 pad_x1b; u32 keySetDisableBitmask; ///< See SwkbdKeyDisableBitmask_*. u32 initialCursorPos; ///< Initial cursor position in the string: 0 = start, 1 = end. u16 headerText[130/2]; u16 subText[258/2]; u16 guideText[514/2]; u16 pad_x3aa; u32 stringLenMax; ///< When non-zero, specifies the max string length. When the input is too long, swkbd will stop accepting more input until text is deleted via the B button (Backspace). See also \ref SwkbdTextDrawType. u32 stringLenMin; ///< When non-zero, specifies the min string length. When the input is too short, swkbd will display an icon and disable the ok-button. u32 passwordFlag; ///< Use password: 0 = disable, 1 = enable. SwkbdTextDrawType textDrawType; ///< See \ref SwkbdTextDrawType. u16 returnButtonFlag; ///< Controls whether the Return button is enabled, for newlines input. 0 = disabled, non-zero = enabled. u8 blurBackground; ///< When enabled with value 1, the background is blurred. u8 pad_x3bf; u32 initialStringOffset; u32 initialStringSize; u32 userDicOffset; s32 userDicEntries; u8 textCheckFlag; } SwkbdArgCommon; typedef struct { SwkbdArgCommon arg; u8 pad_x3d1[7]; SwkbdTextCheckCb textCheckCb; ///< This really doesn't belong in a struct sent to another process, but official sw does this. } SwkbdArgV0; /// Arg struct for version 0x30007+. typedef struct { SwkbdArgV0 arg; u32 textGrouping[8]; ///< When set and enabled via \ref SwkbdTextDrawType, controls displayed text grouping (inserts spaces, without affecting output string). } SwkbdArgV7; /// Arg struct for version 0x6000B+. typedef struct { SwkbdArgCommon arg; u8 pad_x3d1[3]; u32 textGrouping[8]; ///< Same as SwkbdArgV7::textGrouping. u64 entries[0x18]; ///< This is SwkbdCustomizedDictionarySet::entries. u8 total_entries; ///< This is SwkbdCustomizedDictionarySet::total_entries. u8 unkFlag; ///< [8.0.0+] u8 pad_x4b6[0xD]; u8 trigger; ///< [8.0.0+] u8 pad_x4c4[4]; } SwkbdArgVB; typedef struct { SwkbdArgV7 arg; u8* workbuf; size_t workbuf_size; s32 max_dictwords; SwkbdCustomizedDictionarySet customizedDictionarySet; u8 unkFlag; u8 trigger; u32 version; } SwkbdConfig; /// Rect typedef struct { s16 x; ///< X s16 y; ///< Y s16 width; ///< Width s16 height; ///< Height } SwkbdRect; /// InitializeArg for SwkbdInline. typedef struct { u32 unk_x0; u8 mode; ///< See \ref SwkbdInlineMode. (u8 bool) u8 unk_x5; ///< Only set on [5.0.0+]. u8 pad[2]; } SwkbdInitializeArg; typedef struct { SwkbdType type; ///< See \ref SwkbdType. u16 okButtonText[9]; u16 leftButtonText; u16 rightButtonText; u8 dicFlag; ///< Enables dictionary usage when non-zero (including the system dictionary). u8 unk_x1b; u32 keySetDisableBitmask; ///< See SwkbdKeyDisableBitmask_*. s32 stringLenMax; ///< When non-negative and non-zero, specifies the max string length. When the input is too long, swkbd will stop accepting more input until text is deleted via the B button (Backspace). s32 stringLenMin; ///< When non-negative and non-zero, specifies the min string length. When the input is too short, swkbd will display an icon and disable the ok-button. u8 returnButtonFlag; ///< Controls whether the Return button is enabled, for newlines input. 0 = disabled, non-zero = enabled. u8 unk_x29; ///< [10.0.0+] When value 1-2, \ref swkbdInlineAppear / \ref swkbdInlineAppearEx will set keytopAsFloating=0 and footerScalable=1. u8 unk_x2a; u8 unk_x2b; u32 flags; ///< Bitmask 0x4: unknown. u8 unk_x30; u8 unk_x31[0x17]; } SwkbdAppearArg; typedef struct { u32 unk_x0; u16 size; ///< Size of this struct. u8 unk_x6; u8 unk_x7; u64 flags; SwkbdInitializeArg initArg; ///< Flags bitmask 0x1. float volume; ///< Flags bitmask 0x2. s32 cursorPos; ///< Flags bitmask 0x10. SwkbdAppearArg appearArg; u16 inputText[0x3f4/2]; ///< Flags bitmask 0x8. u8 utf8Mode; ///< Flags bitmask 0x20. u8 unk_x45d; u8 enableBackspace; ///< Flags bitmask 0x8000. Only available with [5.0.0+]. u8 unk_x45f[3]; u8 keytopAsFloating; ///< Flags bitmask 0x200. u8 footerScalable; ///< Flags bitmask 0x100. u8 alphaEnabledInInputMode; ///< Flags bitmask 0x100. u8 inputModeFadeType; ///< Flags bitmask 0x100. u8 disableTouch; ///< Flags bitmask 0x200. u8 disableHardwareKeyboard; ///< Flags bitmask 0x800. u8 unk_x468[5]; u8 unk_x46d; u8 unk_x46e; u8 unk_x46f; float keytopScaleX; ///< Flags bitmask 0x200. float keytopScaleY; ///< Flags bitmask 0x200. float keytopTranslateX; ///< Flags bitmask 0x200. float keytopTranslateY; ///< Flags bitmask 0x200. float keytopBgAlpha; ///< Flags bitmask 0x100. float footerBgAlpha; ///< Flags bitmask 0x100. float balloonScale; ///< Flags bitmask 0x200. float unk_x48c; u8 unk_x490[0xc]; u8 seGroup; ///< Flags bitmask: enable=0x2000, disable=0x4000. Only available with [5.0.0+]. u8 triggerFlag; ///< [6.0.0+] Enables using the trigger field when set. u8 trigger; ///< [6.0.0+] Trigger u8 pad_x49f; } SwkbdInlineCalcArg; /// Struct data for SwkbdInline Interactive reply storage ChangedString*, at the end following the string. typedef struct { u32 stringLen; ///< String length in characters, without NUL-terminator. s32 dicStartCursorPos; ///< Starting cursorPos for the current dictionary word in the current text string. -1 for none. s32 dicEndCursorPos; ///< Ending cursorPos for the current dictionary word in the current text string. -1 for none. s32 cursorPos; ///< Cursor position. } SwkbdChangedStringArg; /// Struct data for SwkbdInline Interactive reply storage MovedCursor*, at the end following the string. typedef struct { u32 stringLen; ///< String length in characters, without NUL-terminator. s32 cursorPos; ///< Cursor position. } SwkbdMovedCursorArg; /// Struct data for SwkbdInline Interactive reply storage MovedTab*, at the end following the string. typedef struct { u32 unk_x0; u32 unk_x4; } SwkbdMovedTabArg; /// Struct data for SwkbdInline Interactive reply storage DecidedEnter*, at the end following the string. typedef struct { u32 stringLen; ///< String length in characters, without NUL-terminator. } SwkbdDecidedEnterArg; /// This callback is used by \ref swkbdInlineUpdate when handling ChangedString* replies (text changed by the user or by \ref swkbdInlineSetInputText). /// str is the UTF-8 string for the current text. typedef void (*SwkbdChangedStringCb)(const char* str, SwkbdChangedStringArg* arg); /// This callback is used by \ref swkbdInlineUpdate when handling ChangedString*V2 replies (text changed by the user or by \ref swkbdInlineSetInputText). /// str is the UTF-8 string for the current text. typedef void (*SwkbdChangedStringV2Cb)(const char* str, SwkbdChangedStringArg* arg, bool flag); /// This callback is used by \ref swkbdInlineUpdate when handling MovedCursor* replies. /// str is the UTF-8 string for the current text. typedef void (*SwkbdMovedCursorCb)(const char* str, SwkbdMovedCursorArg* arg); /// This callback is used by \ref swkbdInlineUpdate when handling MovedCursor*V2 replies. /// str is the UTF-8 string for the current text. typedef void (*SwkbdMovedCursorV2Cb)(const char* str, SwkbdMovedCursorArg* arg, bool flag); /// This callback is used by \ref swkbdInlineUpdate when handling MovedTab* replies. /// str is the UTF-8 string for the current text. typedef void (*SwkbdMovedTabCb)(const char* str, SwkbdMovedTabArg* arg); /// This callback is used by \ref swkbdInlineUpdate when handling DecidedEnter* replies (when the final text was submitted via the button). /// str is the UTF-8 string for the current text. typedef void (*SwkbdDecidedEnterCb)(const char* str, SwkbdDecidedEnterArg* arg); /// InlineKeyboard typedef struct { u32 version; AppletHolder holder; SwkbdInlineCalcArg calcArg; bool directionalButtonAssignFlag; SwkbdState state; bool dicCustomInitialized; bool customizedDictionariesInitialized; AppletStorage dicStorage; bool wordInfoInitialized; AppletStorage wordInfoStorage; u8* interactive_tmpbuf; size_t interactive_tmpbuf_size; char* interactive_strbuf; size_t interactive_strbuf_size; VoidFn finishedInitializeCb; VoidFn decidedCancelCb; SwkbdChangedStringCb changedStringCb; SwkbdChangedStringV2Cb changedStringV2Cb; SwkbdMovedCursorCb movedCursorCb; SwkbdMovedCursorV2Cb movedCursorV2Cb; SwkbdMovedTabCb movedTabCb; SwkbdDecidedEnterCb decidedEnterCb; VoidFn releasedUserWordInfoCb; } SwkbdInline; /** * @brief Creates a SwkbdConfig struct. * @param c SwkbdConfig struct. * @param max_dictwords Max \ref SwkbdDictWord entries, 0 for none. */ Result swkbdCreate(SwkbdConfig* c, s32 max_dictwords); /** * @brief Closes a SwkbdConfig struct. * @param c SwkbdConfig struct. */ void swkbdClose(SwkbdConfig* c); /** * @brief Clears the args in the SwkbdConfig struct and initializes it with the Default Preset. * @note Do not use this before \ref swkbdCreate. * @note Uses the following: swkbdConfigSetType() with \ref SwkbdType_QWERTY, swkbdConfigSetInitialCursorPos() with value 1, swkbdConfigSetReturnButtonFlag() with value 1, and swkbdConfigSetBlurBackground() with value 1. Pre-5.0.0: swkbdConfigSetTextDrawType() with \ref SwkbdTextDrawType_Box. * @param c SwkbdConfig struct. */ void swkbdConfigMakePresetDefault(SwkbdConfig* c); /** * @brief Clears the args in the SwkbdConfig struct and initializes it with the Password Preset. * @note Do not use this before \ref swkbdCreate. * @note Uses the following: swkbdConfigSetType() with \ref SwkbdType_QWERTY, swkbdConfigSetInitialCursorPos() with value 1, swkbdConfigSetPasswordFlag() with value 1, and swkbdConfigSetBlurBackground() with value 1. * @param c SwkbdConfig struct. */ void swkbdConfigMakePresetPassword(SwkbdConfig* c); /** * @brief Clears the args in the SwkbdConfig struct and initializes it with the UserName Preset. * @note Do not use this before \ref swkbdCreate. * @note Uses the following: swkbdConfigSetType() with \ref SwkbdType_Normal, swkbdConfigSetKeySetDisableBitmask() with SwkbdKeyDisableBitmask_UserName, swkbdConfigSetInitialCursorPos() with value 1, and swkbdConfigSetBlurBackground() with value 1. * @param c SwkbdConfig struct. */ void swkbdConfigMakePresetUserName(SwkbdConfig* c); /** * @brief Clears the args in the SwkbdConfig struct and initializes it with the DownloadCode Preset. * @note Do not use this before \ref swkbdCreate. * @note Uses the following: swkbdConfigSetType() with \ref SwkbdType_Normal (\ref SwkbdType_QWERTY on [5.0.0+]), swkbdConfigSetKeySetDisableBitmask() with SwkbdKeyDisableBitmask_DownloadCode, swkbdConfigSetInitialCursorPos() with value 1, and swkbdConfigSetBlurBackground() with value 1. [5.0.0+]: swkbdConfigSetStringLenMax() with value 16, swkbdConfigSetStringLenMin() with value 1, and swkbdConfigSetTextDrawType() with SwkbdTextDrawType_DownloadCode. Uses swkbdConfigSetTextGrouping() for [0-2] with: 0x3, 0x7, and 0xb. * @param c SwkbdConfig struct. */ void swkbdConfigMakePresetDownloadCode(SwkbdConfig* c); /** * @brief Sets the Ok button text. The default is "". * @param c SwkbdConfig struct. * @param str UTF-8 input string. */ void swkbdConfigSetOkButtonText(SwkbdConfig* c, const char* str); /** * @brief Sets the LeftOptionalSymbolKey, for \ref SwkbdType_NumPad. The default is "". * @param c SwkbdConfig struct. * @param str UTF-8 input string. */ void swkbdConfigSetLeftOptionalSymbolKey(SwkbdConfig* c, const char* str); /** * @brief Sets the RightOptionalSymbolKey, for \ref SwkbdType_NumPad. The default is "". * @param c SwkbdConfig struct. * @param str UTF-8 input string. */ void swkbdConfigSetRightOptionalSymbolKey(SwkbdConfig* c, const char* str); /** * @brief Sets the Header text. The default is "". * @note See SwkbdArgCommon::stringLenMax. * @param c SwkbdConfig struct. * @param str UTF-8 input string. */ void swkbdConfigSetHeaderText(SwkbdConfig* c, const char* str); /** * @brief Sets the Sub text. The default is "". * @note See SwkbdArgCommon::stringLenMax. * @param c SwkbdConfig struct. * @param str UTF-8 input string. */ void swkbdConfigSetSubText(SwkbdConfig* c, const char* str); /** * @brief Sets the Guide text. The default is "". * @note The swkbd applet only displays this when the current displayed cursor position is 0. * @param c SwkbdConfig struct. * @param str UTF-8 input string. */ void swkbdConfigSetGuideText(SwkbdConfig* c, const char* str); /** * @brief Sets the Initial text. The default is "". * @param c SwkbdConfig struct. * @param str UTF-8 input string. */ void swkbdConfigSetInitialText(SwkbdConfig* c, const char* str); /** * @brief Sets the user dictionary. * @param c SwkbdConfig struct. * @param input Input data. * @param entries Total entries in the buffer. */ void swkbdConfigSetDictionary(SwkbdConfig* c, const SwkbdDictWord *input, s32 entries); /** * @brief Sets the CustomizedDictionaries. * @note Only available on [6.0.0+]. * @param c SwkbdConfig struct. * @param dic Input \ref SwkbdCustomizedDictionarySet */ Result swkbdConfigSetCustomizedDictionaries(SwkbdConfig* c, const SwkbdCustomizedDictionarySet *dic); /** * @brief Sets the TextCheck callback. * @param c SwkbdConfig struct. * @param cb \ref SwkbdTextCheckCb callback. */ void swkbdConfigSetTextCheckCallback(SwkbdConfig* c, SwkbdTextCheckCb cb); /** * @brief Sets SwkbdArgCommon::SwkbdType. * @param c SwkbdConfig struct. * @param type \ref SwkbdType */ static inline void swkbdConfigSetType(SwkbdConfig* c, SwkbdType type) { c->arg.arg.arg.type = type; } /** * @brief Sets SwkbdArgCommon::dicFlag. * @param c SwkbdConfig struct. * @param flag Flag */ static inline void swkbdConfigSetDicFlag(SwkbdConfig* c, u8 flag) { c->arg.arg.arg.dicFlag = flag; } /** * @brief Sets SwkbdArgCommon::keySetDisableBitmask. * @param c SwkbdConfig struct. * @param keySetDisableBitmask keySetDisableBitmask */ static inline void swkbdConfigSetKeySetDisableBitmask(SwkbdConfig* c, u32 keySetDisableBitmask) { c->arg.arg.arg.keySetDisableBitmask = keySetDisableBitmask; } /** * @brief Sets SwkbdArgCommon::initialCursorPos. * @param c SwkbdConfig struct. * @param initialCursorPos initialCursorPos */ static inline void swkbdConfigSetInitialCursorPos(SwkbdConfig* c, u32 initialCursorPos) { c->arg.arg.arg.initialCursorPos = initialCursorPos; } /** * @brief Sets SwkbdArgCommon::stringLenMax. * @param c SwkbdConfig struct. * @param stringLenMax stringLenMax */ static inline void swkbdConfigSetStringLenMax(SwkbdConfig* c, u32 stringLenMax) { c->arg.arg.arg.stringLenMax = stringLenMax; } /** * @brief Sets SwkbdArgCommon::stringLenMin. * @param c SwkbdConfig struct. * @param stringLenMin stringLenMin */ static inline void swkbdConfigSetStringLenMin(SwkbdConfig* c, u32 stringLenMin) { c->arg.arg.arg.stringLenMin = stringLenMin; } /** * @brief Sets SwkbdArgCommon::passwordFlag. * @param c SwkbdConfig struct. * @param flag Flag */ static inline void swkbdConfigSetPasswordFlag(SwkbdConfig* c, u32 flag) { c->arg.arg.arg.passwordFlag = flag; } /** * @brief Sets SwkbdArgCommon::textDrawType. * @param c SwkbdConfig struct. * @param textDrawType \ref SwkbdTextDrawType */ static inline void swkbdConfigSetTextDrawType(SwkbdConfig* c, SwkbdTextDrawType textDrawType) { c->arg.arg.arg.textDrawType = textDrawType; } /** * @brief Sets SwkbdArgCommon::returnButtonFlag. * @param c SwkbdConfig struct. * @param flag Flag */ static inline void swkbdConfigSetReturnButtonFlag(SwkbdConfig* c, u16 flag) { c->arg.arg.arg.returnButtonFlag = flag; } /** * @brief Sets SwkbdArgCommon::blurBackground. * @param c SwkbdConfig struct. * @param blurBackground blurBackground */ static inline void swkbdConfigSetBlurBackground(SwkbdConfig* c, u8 blurBackground) { c->arg.arg.arg.blurBackground = blurBackground; } /** * @brief Sets SwkbdArgV7::textGrouping. * @param index Array index. * @param value Value to write. */ static inline void swkbdConfigSetTextGrouping(SwkbdConfig* c, u32 index, u32 value) { if (index >= sizeof(c->arg.textGrouping)/sizeof(u32)) return; c->arg.textGrouping[index] = value; } /** * @brief Sets SwkbdConfig::unkFlag, default is 0. Copied to SwkbdArgVB::unkFlag with [8.0.0+]. * @param flag Flag */ static inline void swkbdConfigSetUnkFlag(SwkbdConfig* c, u8 flag) { c->unkFlag = flag; } /** * @brief Sets SwkbdConfig::trigger, default is 0. Copied to SwkbdArgVB::trigger with [8.0.0+]. * @param trigger Trigger */ static inline void swkbdConfigSetTrigger(SwkbdConfig* c, u8 trigger) { c->trigger = trigger; } /** * @brief Launch swkbd with the specified config. This will return once swkbd is finished running. * @note The string buffer is also used for the buffer passed to the \ref SwkbdTextCheckCb, when it's set. Hence, in that case this buffer should be large enough to handle TextCheck string input/output. The size passed to the callback is the same size passed here, -1. * @param c SwkbdConfig struct. * @param out_string UTF-8 Output string buffer. * @param out_string_size UTF-8 Output string buffer size, including NUL-terminator. */ Result swkbdShow(SwkbdConfig* c, char* out_string, size_t out_string_size); /** * @brief Creates a SwkbdInline object. Only available on [2.0.0+]. * @note This is essentially an asynchronous version of the regular swkbd. * @note This calls \ref swkbdInlineSetUtf8Mode internally with flag=true. * @param s SwkbdInline object. */ Result swkbdInlineCreate(SwkbdInline* s); /** * @brief Closes a SwkbdInline object. If the applet is running, this will tell the applet to exit, then wait for the applet to exit + applet exit handling. * @param s SwkbdInline object. */ Result swkbdInlineClose(SwkbdInline* s); /** * @brief Does setup for \ref SwkbdInitializeArg and launches the applet with the SwkbdInline object. * @note The initArg is cleared, and on [5.0.0+] unk_x5 is set to 1. * @param s SwkbdInline object. */ Result swkbdInlineLaunch(SwkbdInline* s); /** * @brief Same as \ref swkbdInlineLaunch, except mode and unk_x5 for \ref SwkbdInitializeArg are set to the input params. * @param s SwkbdInline object. * @param mode Value for SwkbdInitializeArg::mode. * @param unk_x5 Value for SwkbdInitializeArg::unk_x5. */ Result swkbdInlineLaunchForLibraryApplet(SwkbdInline* s, u8 mode, u8 unk_x5); /** * @brief GetWindowSize * @param[out] width Output width. * @param[out] height Output height. */ NX_CONSTEXPR void swkbdInlineGetWindowSize(s32 *width, s32 *height) { *width = 1280; *height = 720; } /** * @brief GetImageMemoryRequirement * @note Wrapper for \ref viGetIndirectLayerImageRequiredMemoryInfo. * @param[out] out_size Output size. * @param[out] out_alignment Output alignment. */ Result swkbdInlineGetImageMemoryRequirement(u64 *out_size, u64 *out_alignment); /** * @brief GetImage * @note Only available with ::SwkbdInlineMode_UserDisplay. * @note For width/height, see \ref swkbdInlineGetWindowSize. * @param s SwkbdInline object. * @param[out] buffer Output RGBA8 image buffer, this must use the alignment from \ref swkbdInlineGetImageMemoryRequirement. * @param[in] size Output buffer size, this must match the size from \ref swkbdInlineGetImageMemoryRequirement. * @param[out] data_available Whether data is available. */ Result swkbdInlineGetImage(SwkbdInline* s, void* buffer, u64 size, bool *data_available); /** * @brief Gets the image max height, relative to the bottom of the screen. * @param s SwkbdInline object. */ s32 swkbdInlineGetMaxHeight(SwkbdInline* s); /** * @brief Gets the MiniaturizedHeight, relative to the bottom of the screen. * @param s SwkbdInline object. */ s32 swkbdInlineGetMiniaturizedHeight(SwkbdInline* s); /** * @brief GetTouchRectangles. Returns number of valid Rects: 1 for only keytop, 2 for keytop/footer. * @param s SwkbdInline object. * @param[out] keytop \ref SwkbdRect for keytop. Optional, can be NULL. * @param[out] footer \ref SwkbdRect for footer. Optional, can be NULL. */ s32 swkbdInlineGetTouchRectangles(SwkbdInline* s, SwkbdRect *keytop, SwkbdRect *footer); /** * @brief Gets whether the input x/y are within the output from \ref swkbdInlineGetTouchRectangles. * @param s SwkbdInline object. * @param[out] x X * @param[out] y Y */ bool swkbdInlineIsUsedTouchPointByKeyboard(SwkbdInline* s, s32 x, s32 y); /** * @brief Handles updating SwkbdInline state, this should be called periodically. * @note Handles applet exit if needed, and also sends the \ref SwkbdInlineCalcArg to the applet if needed. Hence, this should be called at some point after writing to \ref SwkbdInlineCalcArg. * @note Handles applet Interactive storage output when needed. * @param s SwkbdInline object. * @param out_state Optional output \ref SwkbdState. */ Result swkbdInlineUpdate(SwkbdInline* s, SwkbdState* out_state); /** * @brief Sets the FinishedInitialize callback, used by \ref swkbdInlineUpdate. The default is NULL for none. * @param s SwkbdInline object. * @param cb Callback */ void swkbdInlineSetFinishedInitializeCallback(SwkbdInline* s, VoidFn cb); /** * @brief Sets the DecidedCancel callback, used by \ref swkbdInlineUpdate. The default is NULL for none. * @param s SwkbdInline object. * @param cb Callback */ void swkbdInlineSetDecidedCancelCallback(SwkbdInline* s, VoidFn cb); /** * @brief Sets the ChangedString callback, used by \ref swkbdInlineUpdate. The default is NULL for none. * @note This clears the callback set by \ref swkbdInlineSetChangedStringV2Callback. * @note This should be called after \ref swkbdInlineLaunch / \ref swkbdInlineLaunchForLibraryApplet. * @param s SwkbdInline object. * @param cb \ref SwkbdChangedStringCb Callback */ void swkbdInlineSetChangedStringCallback(SwkbdInline* s, SwkbdChangedStringCb cb); /** * @brief Sets the ChangedStringV2 callback, used by \ref swkbdInlineUpdate. The default is NULL for none. * @note Only available with [8.0.0+]. * @note This must be called after \ref swkbdInlineLaunch / \ref swkbdInlineLaunchForLibraryApplet. * @param s SwkbdInline object. * @param cb \ref SwkbdChangedStringV2Cb Callback */ void swkbdInlineSetChangedStringV2Callback(SwkbdInline* s, SwkbdChangedStringV2Cb cb); /** * @brief Sets the MovedCursor callback, used by \ref swkbdInlineUpdate. The default is NULL for none. * @note This clears the callback set by \ref swkbdInlineSetMovedCursorV2Callback. * @note This should be called after \ref swkbdInlineLaunch / \ref swkbdInlineLaunchForLibraryApplet. * @param s SwkbdInline object. * @param cb \ref SwkbdMovedCursorCb Callback */ void swkbdInlineSetMovedCursorCallback(SwkbdInline* s, SwkbdMovedCursorCb cb); /** * @brief Sets the MovedCursorV2 callback, used by \ref swkbdInlineUpdate. The default is NULL for none. * @note Only available with [8.0.0+]. * @note This must be called after \ref swkbdInlineLaunch / \ref swkbdInlineLaunchForLibraryApplet. * @param s SwkbdInline object. * @param cb \ref SwkbdMovedCursorV2Cb Callback */ void swkbdInlineSetMovedCursorV2Callback(SwkbdInline* s, SwkbdMovedCursorV2Cb cb); /** * @brief Sets the MovedTab callback, used by \ref swkbdInlineUpdate. The default is NULL for none. * @param s SwkbdInline object. * @param cb \ref SwkbdMovedTabCb Callback */ void swkbdInlineSetMovedTabCallback(SwkbdInline* s, SwkbdMovedTabCb cb); /** * @brief Sets the DecidedEnter callback, used by \ref swkbdInlineUpdate. The default is NULL for none. * @param s SwkbdInline object. * @param cb \ref SwkbdDecidedEnterCb Callback */ void swkbdInlineSetDecidedEnterCallback(SwkbdInline* s, SwkbdDecidedEnterCb cb); /** * @brief Sets the ReleasedUserWordInfo callback, used by \ref swkbdInlineUpdate. The default is NULL for none. * @param s SwkbdInline object. * @param cb Callback */ void swkbdInlineSetReleasedUserWordInfoCallback(SwkbdInline* s, VoidFn cb); /** * @brief Appear the kbd and set \ref SwkbdAppearArg. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @note Wrapper for \ref swkbdInlineAppearEx, with trigger=0. * @param s SwkbdInline object. * @param arg Input SwkbdAppearArg. */ void swkbdInlineAppear(SwkbdInline* s, const SwkbdAppearArg* arg); /** * @brief Appear the kbd and set \ref SwkbdAppearArg. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @param s SwkbdInline object. * @param arg Input SwkbdAppearArg. * @param trigger Trigger, default is 0. Requires [6.0.0+], on eariler versions this will always use value 0 internally. */ void swkbdInlineAppearEx(SwkbdInline* s, const SwkbdAppearArg* arg, u8 trigger); /** * @brief Disappear the kbd. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @param s SwkbdInline object. */ void swkbdInlineDisappear(SwkbdInline* s); /** * @brief Creates a \ref SwkbdAppearArg which can then be passed to \ref swkbdInlineAppear. arg is initialized with the defaults, with type being set to the input type. * @param arg Output \ref SwkbdAppearArg. * @param type \ref SwkbdType type */ void swkbdInlineMakeAppearArg(SwkbdAppearArg* arg, SwkbdType type); /** * @brief Sets okButtonText for the specified SwkbdAppearArg, which was previously initialized with \ref swkbdInlineMakeAppearArg. * @param arg \ref SwkbdAppearArg * @param str Input UTF-8 string for the Ok button text, this can be empty/NULL to use the default. */ void swkbdInlineAppearArgSetOkButtonText(SwkbdAppearArg* arg, const char* str); /** * @brief Sets the LeftButtonText, for \ref SwkbdType_NumPad. The default is "". Equivalent to \ref swkbdConfigSetLeftOptionalSymbolKey. * @param arg \ref SwkbdAppearArg, previously initialized by \ref swkbdInlineMakeAppearArg. * @param str UTF-8 input string. */ void swkbdInlineAppearArgSetLeftButtonText(SwkbdAppearArg* arg, const char* str); /** * @brief Sets the RightButtonText, for \ref SwkbdType_NumPad. The default is "". Equivalent to \ref swkbdConfigSetRightOptionalSymbolKey. * @param arg \ref SwkbdAppearArg, previously initialized by \ref swkbdInlineMakeAppearArg. * @param str UTF-8 input string. */ void swkbdInlineAppearArgSetRightButtonText(SwkbdAppearArg* arg, const char* str); /** * @brief Sets the stringLenMax for the specified SwkbdAppearArg, which was previously initialized with \ref swkbdInlineMakeAppearArg. * @param arg \ref SwkbdAppearArg * @param stringLenMax Max string length */ static inline void swkbdInlineAppearArgSetStringLenMax(SwkbdAppearArg* arg, s32 stringLenMax) { arg->stringLenMax = stringLenMax; } /** * @brief Sets the stringLenMin for the specified SwkbdAppearArg, which was previously initialized with \ref swkbdInlineMakeAppearArg. * @param arg \ref SwkbdAppearArg * @param stringLenMin Min string length */ static inline void swkbdInlineAppearArgSetStringLenMin(SwkbdAppearArg* arg, s32 stringLenMin) { arg->stringLenMin = stringLenMin; } /** * @brief Sets the audio volume. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @param s SwkbdInline object. * @param volume Volume */ void swkbdInlineSetVolume(SwkbdInline* s, float volume); /** * @brief Sets the current input text string. Overrides the entire user input string if the user previously entered any text. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @note This will not affect the cursor position, see \ref swkbdInlineSetCursorPos for that. * @param s SwkbdInline object. * @param str UTF-8 input string. */ void swkbdInlineSetInputText(SwkbdInline* s, const char* str); /** * @brief Sets the cursor character position in the string. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @param s SwkbdInline object. * @param pos Position */ void swkbdInlineSetCursorPos(SwkbdInline* s, s32 pos); /** * @brief Sets the UserWordInfo. * @note Not available when \ref SwkbdState is above ::SwkbdState_Initialized. Can't be used if this was already used previously. * @note The specified buffer must not be used after this, until \ref swkbdInlineClose is used. * @note \ref swkbdInlineUpdate must be called at some point afterwards. * @note If input==NULL or total_entries==0, this will just call \ref swkbdInlineUnsetUserWordInfo internally. * @param s SwkbdInline object. * @param input Input data. * @param entries Total entries in the buffer. */ Result swkbdInlineSetUserWordInfo(SwkbdInline* s, const SwkbdDictWord *input, s32 entries); /** * @brief Request UnsetUserWordInfo. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @note Not available when \ref SwkbdState is above ::SwkbdState_Initialized. * @param s SwkbdInline object. */ Result swkbdInlineUnsetUserWordInfo(SwkbdInline* s); /** * @brief Sets the utf8Mode. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @note Automatically used internally by \ref swkbdInlineCreate. * @param s SwkbdInline object. * @param flag Flag */ void swkbdInlineSetUtf8Mode(SwkbdInline* s, bool flag); /** * @brief Sets the CustomizeDic. * @note Not available when \ref SwkbdState is above ::SwkbdState_Initialized. Can't be used if this or \ref swkbdInlineSetCustomizedDictionaries was already used previously. * @note The specified buffer must not be used after this, until \ref swkbdInlineClose is used. However, it will also become available once \ref swkbdInlineUpdate handles SwkbdReplyType_UnsetCustomizeDic internally. * @param s SwkbdInline object. * @param buffer 0x1000-byte aligned buffer. * @param size 0x1000-byte aligned buffer size. * @param info Input \ref SwkbdCustomizeDicInfo */ Result swkbdInlineSetCustomizeDic(SwkbdInline* s, void* buffer, size_t size, SwkbdCustomizeDicInfo *info); /** * @brief Request UnsetCustomizeDic. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @note Not available when \ref SwkbdState is above ::SwkbdState_Initialized. * @param s SwkbdInline object. */ void swkbdInlineUnsetCustomizeDic(SwkbdInline* s); /** * @brief Sets the CustomizedDictionaries. * @note Not available when \ref SwkbdState is above ::SwkbdState_Initialized. Can't be used if this or \ref swkbdInlineSetCustomizeDic was already used previously. * @note The specified buffer in dic must not be used after this, until \ref swkbdInlineClose is used. However, it will also become available once \ref swkbdInlineUpdate handles SwkbdReplyType_UnsetCustomizedDictionaries internally. * @note Only available on [6.0.0+]. * @param s SwkbdInline object. * @param dic Input \ref SwkbdCustomizedDictionarySet */ Result swkbdInlineSetCustomizedDictionaries(SwkbdInline* s, const SwkbdCustomizedDictionarySet *dic); /** * @brief Request UnsetCustomizedDictionaries. * @note Not available when \ref SwkbdState is above ::SwkbdState_Initialized. * @note Only available on [6.0.0+]. * @param s SwkbdInline object. */ Result swkbdInlineUnsetCustomizedDictionaries(SwkbdInline* s); /** * @brief Sets InputModeFadeType. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @param s SwkbdInline object. * @param type Type */ void swkbdInlineSetInputModeFadeType(SwkbdInline* s, u8 type); /** * @brief Sets AlphaEnabledInInputMode. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @param s SwkbdInline object. * @param flag Flag */ void swkbdInlineSetAlphaEnabledInInputMode(SwkbdInline* s, bool flag); /** * @brief Sets KeytopBgAlpha. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @param s SwkbdInline object. * @param alpha Alpha, clamped to range 0.0f..1.0f. */ void swkbdInlineSetKeytopBgAlpha(SwkbdInline* s, float alpha); /** * @brief Sets FooterBgAlpha. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @param s SwkbdInline object. * @param alpha Alpha, clamped to range 0.0f..1.0f. */ void swkbdInlineSetFooterBgAlpha(SwkbdInline* s, float alpha); /** * @brief Sets gfx scaling. Configures KeytopScale* and BalloonScale based on the input value. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @note The BalloonScale is not updated when \ref SwkbdState is above ::SwkbdState_Initialized. * @param s SwkbdInline object. * @param scale Scale */ void swkbdInlineSetKeytopScale(SwkbdInline* s, float scale); /** * @brief Sets gfx translation for the displayed swkbd image position. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @param s SwkbdInline object. * @param x X * @param y Y */ void swkbdInlineSetKeytopTranslate(SwkbdInline* s, float x, float y); /** * @brief Sets KeytopAsFloating. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @note Not available when \ref SwkbdState is above ::SwkbdState_Initialized. * @param s SwkbdInline object. * @param flag Flag */ void swkbdInlineSetKeytopAsFloating(SwkbdInline* s, bool flag); /** * @brief Sets FooterScalable. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @param s SwkbdInline object. * @param flag Flag */ void swkbdInlineSetFooterScalable(SwkbdInline* s, bool flag); /** * @brief Sets whether touch is enabled. The default is enabled. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @param s SwkbdInline object. * @param flag Flag */ void swkbdInlineSetTouchFlag(SwkbdInline* s, bool flag); /** * @brief Sets whether Hardware-keyboard is enabled. The default is enabled. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @param s SwkbdInline object. * @param flag Flag */ void swkbdInlineSetHardwareKeyboardFlag(SwkbdInline* s, bool flag); /** * @brief Sets whether DirectionalButtonAssign is enabled. The default is disabled. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @note Only available on [4.0.0+]. * @param s SwkbdInline object. * @param flag Flag */ void swkbdInlineSetDirectionalButtonAssignFlag(SwkbdInline* s, bool flag); /** * @brief Sets whether the specified SeGroup (sound effect) is enabled. The default is enabled. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. If called again with a different seGroup, \ref swkbdInlineUpdate must be called prior to calling this again. * @note Only available on [5.0.0+]. * @param s SwkbdInline object. * @param seGroup SeGroup * @param flag Flag */ void swkbdInlineSetSeGroup(SwkbdInline* s, u8 seGroup, bool flag); /** * @brief Sets whether the backspace button is enabled. The default is enabled. * @note \ref swkbdInlineUpdate must be called at some point afterwards for this to take affect. * @note Only available on [5.0.0+]. * @param s SwkbdInline object. * @param flag Flag */ void swkbdInlineSetBackspaceFlag(SwkbdInline* s, bool flag);