// SPDX-License-Identifier: MIT // // EmulationStation Desktop Edition // TextEditComponent.cpp // // Component for editing text fields in menus. // #include "components/TextEditComponent.h" #include "utils/StringUtil.h" #define TEXT_PADDING_HORIZ 10.0f #define TEXT_PADDING_VERT 2.0f #define CURSOR_REPEAT_START_DELAY 500 #define CURSOR_REPEAT_SPEED 28 // Lower is faster. TextEditComponent::TextEditComponent(Window* window) : GuiComponent(window) , mBox(window, ":/graphics/textinput.svg") , mFocused(false) , mScrollOffset(0.0f, 0.0f) , mCursor(0) , mEditing(false) , mFont(Font::get(FONT_SIZE_MEDIUM, FONT_PATH_LIGHT)) , mCursorRepeatDir(0) { addChild(&mBox); onFocusLost(); mResolutionAdjustment = -(34.0f * Renderer::getScreenWidthModifier() - 34.0f); setSize(4096, mFont->getHeight() + (TEXT_PADDING_VERT * Renderer::getScreenHeightModifier())); } void TextEditComponent::onFocusGained() { mFocused = true; mBox.setImagePath(":/graphics/textinput_focused.svg"); } void TextEditComponent::onFocusLost() { mFocused = false; mBox.setImagePath(":/graphics/textinput.svg"); } void TextEditComponent::onSizeChanged() { mBox.fitTo(mSize, glm::vec3({}), glm::vec2(-34.0f + mResolutionAdjustment, -32.0f - (TEXT_PADDING_VERT * Renderer::getScreenHeightModifier()))); onTextChanged(); // Wrap point probably changed. } void TextEditComponent::setValue(const std::string& val) { mText = val; mTextOrig = val; onTextChanged(); } void TextEditComponent::textInput(const std::string& text) { if (mEditing) { mCursorRepeatDir = 0; if (text[0] == '\b') { if (mCursor > 0) { size_t newCursor = Utils::String::prevCursor(mText, mCursor); mText.erase(mText.begin() + newCursor, mText.begin() + mCursor); mCursor = static_cast(newCursor); } } else { mText.insert(mCursor, text); mCursor += static_cast(text.size()); } } onTextChanged(); onCursorChanged(); } void TextEditComponent::startEditing() { if (!isMultiline()) setCursor(mText.size()); SDL_StartTextInput(); mEditing = true; updateHelpPrompts(); } void TextEditComponent::stopEditing() { SDL_StopTextInput(); mEditing = false; updateHelpPrompts(); } bool TextEditComponent::input(InputConfig* config, Input input) { bool const cursor_left = (config->getDeviceId() != DEVICE_KEYBOARD && config->isMappedLike("left", input)) || (config->getDeviceId() == DEVICE_KEYBOARD && input.id == SDLK_LEFT); bool const cursor_right = (config->getDeviceId() != DEVICE_KEYBOARD && config->isMappedLike("right", input)) || (config->getDeviceId() == DEVICE_KEYBOARD && input.id == SDLK_RIGHT); bool const cursor_up = (config->getDeviceId() != DEVICE_KEYBOARD && config->isMappedLike("up", input)) || (config->getDeviceId() == DEVICE_KEYBOARD && input.id == SDLK_UP); bool const cursor_down = (config->getDeviceId() != DEVICE_KEYBOARD && config->isMappedLike("down", input)) || (config->getDeviceId() == DEVICE_KEYBOARD && input.id == SDLK_DOWN); bool const shoulder_left = (config->isMappedLike("leftshoulder", input)); bool const shoulder_right = (config->isMappedLike("rightshoulder", input)); bool const trigger_left = (config->isMappedLike("lefttrigger", input)); bool const trigger_right = (config->isMappedLike("righttrigger", input)); if (input.value == 0) { if (cursor_left || cursor_right || cursor_up || cursor_down || shoulder_left || shoulder_right | trigger_left || trigger_right) { mCursorRepeatDir = 0; } return false; } if ((config->isMappedTo("a", input) || (config->getDeviceId() == DEVICE_KEYBOARD && input.id == SDLK_RETURN)) && mFocused && !mEditing) { startEditing(); return true; } if (mEditing) { if (config->getDeviceId() == DEVICE_KEYBOARD && input.id == SDLK_RETURN) { if (isMultiline()) textInput("\n"); else stopEditing(); return true; } // Done editing (accept changes). if ((config->getDeviceId() == DEVICE_KEYBOARD && input.id == SDLK_ESCAPE) || (config->getDeviceId() != DEVICE_KEYBOARD && (config->isMappedTo("a", input) || config->isMappedTo("b", input)))) { mTextOrig = mText; stopEditing(); return true; } else if (cursor_left || cursor_right) { mCursorRepeatDir = cursor_left ? -1 : 1; mCursorRepeatTimer = -(CURSOR_REPEAT_START_DELAY - CURSOR_REPEAT_SPEED); moveCursor(mCursorRepeatDir); } else if (cursor_up) { // TODO } else if (cursor_down) { // TODO } else if (shoulder_left || shoulder_right) { mCursorRepeatDir = shoulder_left ? -10 : 10; mCursorRepeatTimer = -(CURSOR_REPEAT_START_DELAY - CURSOR_REPEAT_SPEED); moveCursor(mCursorRepeatDir); } // Jump to beginning of text. else if (trigger_left) { setCursor(0); } // Jump to end of text. else if (trigger_right) { setCursor(mText.length()); } else if (config->getDeviceId() != DEVICE_KEYBOARD && config->isMappedTo("y", input)) { textInput("\b"); } else if (config->getDeviceId() == DEVICE_KEYBOARD) { switch (input.id) { case SDLK_HOME: { setCursor(0); break; } case SDLK_END: { setCursor(std::string::npos); break; } case SDLK_DELETE: { if (mCursor < mText.length()) { // Fake as Backspace one char to the right. moveCursor(1); textInput("\b"); } break; } } } // Consume all input when editing text. return true; } return false; } void TextEditComponent::update(int deltaTime) { updateCursorRepeat(deltaTime); GuiComponent::update(deltaTime); } void TextEditComponent::updateCursorRepeat(int deltaTime) { if (mCursorRepeatDir == 0) return; mCursorRepeatTimer += deltaTime; while (mCursorRepeatTimer >= CURSOR_REPEAT_SPEED) { moveCursor(mCursorRepeatDir); mCursorRepeatTimer -= CURSOR_REPEAT_SPEED; } } void TextEditComponent::moveCursor(int amt) { mCursor = static_cast(Utils::String::moveCursor(mText, mCursor, amt)); onCursorChanged(); } void TextEditComponent::setCursor(size_t pos) { if (pos == std::string::npos) mCursor = static_cast(mText.length()); else mCursor = static_cast(pos); moveCursor(0); } void TextEditComponent::onTextChanged() { std::string wrappedText = (isMultiline() ? mFont->wrapText(mText, getTextAreaSize().x) : mText); mTextCache = std::unique_ptr( mFont->buildTextCache(wrappedText, 0.0f, 0.0f, 0x77777700 | getOpacity())); if (mCursor > static_cast(mText.length())) mCursor = static_cast(mText.length()); } void TextEditComponent::onCursorChanged() { if (isMultiline()) { glm::vec2 textSize = mFont->getWrappedTextCursorOffset(mText, getTextAreaSize().x, mCursor); // Need to scroll down? if (mScrollOffset.y + getTextAreaSize().y < textSize.y + mFont->getHeight()) mScrollOffset.y = textSize.y - getTextAreaSize().y + mFont->getHeight(); // Need to scroll up? else if (mScrollOffset.y > textSize.y) mScrollOffset.y = textSize.y; } else { glm::vec2 cursorPos = mFont->sizeText(mText.substr(0, mCursor)); if (mScrollOffset.x + getTextAreaSize().x < cursorPos.x) mScrollOffset.x = cursorPos.x - getTextAreaSize().x; else if (mScrollOffset.x > cursorPos.x) mScrollOffset.x = cursorPos.x; } } void TextEditComponent::render(const glm::mat4& parentTrans) { glm::mat4 trans = getTransform() * parentTrans; renderChildren(trans); // Text + cursor rendering. // Offset into our "text area" (padding). trans = glm::translate(trans, glm::vec3(getTextAreaPos().x, getTextAreaPos().y, 0.0f)); Vector2i clipPos(static_cast(trans[3].x), static_cast(trans[3].y)); // Use "text area" size for clipping. glm::vec3 dimScaled {}; dimScaled.x = std::fabs(trans[3].x + getTextAreaSize().x); dimScaled.y = std::fabs(trans[3].y + getTextAreaSize().y); Vector2i clipDim(static_cast(dimScaled.x - trans[3].x), static_cast(dimScaled.y - trans[3].y)); Renderer::pushClipRect(clipPos, clipDim); trans = glm::translate(trans, glm::vec3(-mScrollOffset.x, -mScrollOffset.y, 0.0f)); Renderer::setMatrix(trans); if (mTextCache) mFont->renderTextCache(mTextCache.get()); // Pop the clip early to allow the cursor to be drawn outside of the "text area". Renderer::popClipRect(); // Draw cursor. if (mEditing) { glm::vec2 cursorPos; if (isMultiline()) { cursorPos = mFont->getWrappedTextCursorOffset(mText, getTextAreaSize().x, mCursor); } else { cursorPos = mFont->sizeText(mText.substr(0, mCursor)); cursorPos[1] = 0; } float cursorHeight = mFont->getHeight() * 0.8f; Renderer::drawRect(cursorPos.x, cursorPos.y + (mFont->getHeight() - cursorHeight) / 2.0f, 2.0f * Renderer::getScreenWidthModifier(), cursorHeight, 0x000000FF, 0x000000FF); } } glm::vec2 TextEditComponent::getTextAreaPos() const { return glm::vec2( (-mResolutionAdjustment + (TEXT_PADDING_HORIZ * Renderer::getScreenWidthModifier())) / 2.0f, (TEXT_PADDING_VERT * Renderer::getScreenHeightModifier()) / 2.0f); } glm::vec2 TextEditComponent::getTextAreaSize() const { return glm::vec2(mSize.x + mResolutionAdjustment - (TEXT_PADDING_HORIZ * Renderer::getScreenWidthModifier()), mSize.y - (TEXT_PADDING_VERT * Renderer::getScreenHeightModifier())); } std::vector TextEditComponent::getHelpPrompts() { std::vector prompts; if (mEditing) { prompts.push_back(HelpPrompt("up/down/left/right", "move cursor")); prompts.push_back(HelpPrompt("y", "backspace")); prompts.push_back(HelpPrompt("a", "accept changes")); prompts.push_back(HelpPrompt("b", "accept changes")); } else { prompts.push_back(HelpPrompt("a", "edit")); } return prompts; }