mirror of
https://github.com/4ian/GDevelop.git
synced 2025-10-15 10:19:04 +00:00
71e3b65134
* This object displays a field where the player can type a text. * The cursor can be moved and the text can be selected and entered like any other input field according to the platform. For example, you can use all the usual keyboard shortcuts or emoji pickers on desktop. On mobile, all the usual gestures are supported, emoji pickers, text selection, clipboard... * You can choose between different input field types: text, text area, email, password, phone number... This allows the keyboards to be adapted on mobile devices. The password field will also hide what is entered by the user. * Because the object is way more convenient to use (and actually works on mobile devices) than the Text Entry object, it is recommended you use it almost always instead of the Text Entry object. * This object has 2 limitations, because it's using the native capabilities of the platform to display a "native" input field: the Z order can't be changed (the object is *always* displayed on top of the game) and no effects can be displayed. Because it's handled by the operating system, it may also slightly differ on each platform. * It's recommended you avoid displaying the object outside of a menu or a static UI, as it may not always display exactly at a position synchronised with the rest of the rendering of the game, especially if used in a fast paced or moving scene.
216 lines
7.8 KiB
C++
216 lines
7.8 KiB
C++
/*
|
|
* GDevelop Core
|
|
* Copyright 2008-2016 Florian Rival (Florian.Rival@gmail.com). All rights
|
|
* reserved. This project is released under the MIT License.
|
|
*/
|
|
#include "InstructionMetadata.h"
|
|
|
|
#include <algorithm>
|
|
|
|
#include "GDCore/CommonTools.h"
|
|
#include "GDCore/Serialization/SerializerElement.h"
|
|
#include "GDCore/Tools/Localization.h"
|
|
#include "GDCore/Tools/Log.h"
|
|
#include "ParameterMetadata.h"
|
|
|
|
namespace gd {
|
|
InstructionMetadata::InstructionMetadata()
|
|
: sentence("Unknown or unsupported instruction"), // Avoid translating this
|
|
// string, so that it's
|
|
// safe and *fast* to use
|
|
// a InstructionMetadata.
|
|
canHaveSubInstructions(false),
|
|
hidden(true),
|
|
usageComplexity(5),
|
|
isPrivate(false),
|
|
isObjectInstruction(false),
|
|
isBehaviorInstruction(false) {}
|
|
|
|
InstructionMetadata::InstructionMetadata(const gd::String& extensionNamespace_,
|
|
const gd::String& name_,
|
|
const gd::String& fullname_,
|
|
const gd::String& description_,
|
|
const gd::String& sentence_,
|
|
const gd::String& group_,
|
|
const gd::String& icon_,
|
|
const gd::String& smallIcon_)
|
|
: fullname(fullname_),
|
|
description(description_),
|
|
helpPath(""),
|
|
sentence(sentence_),
|
|
group(group_),
|
|
iconFilename(icon_),
|
|
smallIconFilename(smallIcon_),
|
|
canHaveSubInstructions(false),
|
|
extensionNamespace(extensionNamespace_),
|
|
hidden(false),
|
|
usageComplexity(5),
|
|
isPrivate(false),
|
|
isObjectInstruction(false),
|
|
isBehaviorInstruction(false) {}
|
|
|
|
InstructionMetadata& InstructionMetadata::AddParameter(
|
|
const gd::String& type,
|
|
const gd::String& description,
|
|
const gd::String& supplementaryInformation,
|
|
bool parameterIsOptional) {
|
|
ParameterMetadata info;
|
|
info.type = type;
|
|
info.description = description;
|
|
info.codeOnly = false;
|
|
info.optional = parameterIsOptional;
|
|
info.supplementaryInformation =
|
|
// For objects/behavior, the supplementary information
|
|
// parameter is an object/behavior type...
|
|
(gd::ParameterMetadata::IsObject(type) ||
|
|
gd::ParameterMetadata::IsBehavior(type))
|
|
? (supplementaryInformation.empty()
|
|
? ""
|
|
: extensionNamespace +
|
|
supplementaryInformation //... so prefix it with the
|
|
// extension
|
|
// namespace.
|
|
)
|
|
: supplementaryInformation; // Otherwise don't change anything
|
|
|
|
// TODO: Assert against supplementaryInformation === "emsc" (when running with
|
|
// Emscripten), and warn about a missing argument when calling addParameter.
|
|
|
|
parameters.push_back(info);
|
|
return *this;
|
|
}
|
|
|
|
InstructionMetadata& InstructionMetadata::AddCodeOnlyParameter(
|
|
const gd::String& type, const gd::String& supplementaryInformation) {
|
|
ParameterMetadata info;
|
|
info.type = type;
|
|
info.codeOnly = true;
|
|
info.supplementaryInformation = supplementaryInformation;
|
|
|
|
parameters.push_back(info);
|
|
return *this;
|
|
}
|
|
|
|
InstructionMetadata& InstructionMetadata::UseStandardOperatorParameters(
|
|
const gd::String& type) {
|
|
SetManipulatedType(type);
|
|
|
|
if (type == "boolean") {
|
|
AddParameter("yesorno", _("New value"));
|
|
size_t valueParamIndex = parameters.size() - 1;
|
|
|
|
if (isObjectInstruction || isBehaviorInstruction) {
|
|
gd::String templateSentence = _("Set _PARAM0_ as <subject>: <value>");
|
|
|
|
sentence =
|
|
templateSentence
|
|
.FindAndReplace("<subject>", sentence)
|
|
.FindAndReplace("<value>",
|
|
"_PARAM" + gd::String::From(valueParamIndex) + "_");
|
|
} else {
|
|
gd::String templateSentence = _("Change <subject>: <value>");
|
|
|
|
sentence =
|
|
templateSentence
|
|
.FindAndReplace("<subject>", sentence)
|
|
.FindAndReplace("<value>",
|
|
"_PARAM" + gd::String::From(valueParamIndex) + "_");
|
|
}
|
|
} else {
|
|
AddParameter("operator", _("Modification's sign"), type);
|
|
AddParameter(type == "number" ? "expression" : type, _("Value"));
|
|
|
|
size_t operatorParamIndex = parameters.size() - 2;
|
|
size_t valueParamIndex = parameters.size() - 1;
|
|
|
|
if (isObjectInstruction || isBehaviorInstruction) {
|
|
gd::String templateSentence = _("Change <subject> of _PARAM0_: <operator> <value>");
|
|
|
|
sentence =
|
|
templateSentence.FindAndReplace("<subject>", sentence)
|
|
.FindAndReplace(
|
|
"<operator>",
|
|
"_PARAM" + gd::String::From(operatorParamIndex) + "_")
|
|
.FindAndReplace("<value>",
|
|
"_PARAM" + gd::String::From(valueParamIndex) + "_");
|
|
} else {
|
|
gd::String templateSentence = _("Change <subject>: <operator> <value>");
|
|
|
|
sentence =
|
|
templateSentence.FindAndReplace("<subject>", sentence)
|
|
.FindAndReplace(
|
|
"<operator>",
|
|
"_PARAM" + gd::String::From(operatorParamIndex) + "_")
|
|
.FindAndReplace("<value>",
|
|
"_PARAM" + gd::String::From(valueParamIndex) + "_");
|
|
}
|
|
}
|
|
|
|
return *this;
|
|
}
|
|
|
|
InstructionMetadata&
|
|
InstructionMetadata::UseStandardRelationalOperatorParameters(
|
|
const gd::String& type) {
|
|
SetManipulatedType(type);
|
|
|
|
if (type == "boolean") {
|
|
if (isObjectInstruction || isBehaviorInstruction) {
|
|
gd::String templateSentence = _("_PARAM0_ is <subject>");
|
|
|
|
sentence =
|
|
templateSentence
|
|
.FindAndReplace("<subject>", sentence);
|
|
} else {
|
|
gd::String templateSentence = _("<subject>");
|
|
|
|
sentence =
|
|
templateSentence.FindAndReplace("<subject>", sentence);
|
|
}
|
|
} else {
|
|
AddParameter("relationalOperator", _("Sign of the test"), type);
|
|
AddParameter(type == "number" ? "expression" : type, _("Value to compare"));
|
|
size_t operatorParamIndex = parameters.size() - 2;
|
|
size_t valueParamIndex = parameters.size() - 1;
|
|
|
|
if (isObjectInstruction || isBehaviorInstruction) {
|
|
gd::String templateSentence = _("<subject> of _PARAM0_ <operator> <value>");
|
|
|
|
sentence =
|
|
templateSentence.FindAndReplace("<subject>", sentence)
|
|
.FindAndReplace(
|
|
"<operator>",
|
|
"_PARAM" + gd::String::From(operatorParamIndex) + "_")
|
|
.FindAndReplace("<value>",
|
|
"_PARAM" + gd::String::From(valueParamIndex) + "_");
|
|
} else {
|
|
gd::String templateSentence = _("<subject> <operator> <value>");
|
|
|
|
sentence =
|
|
templateSentence.FindAndReplace("<subject>", sentence)
|
|
.FindAndReplace(
|
|
"<operator>",
|
|
"_PARAM" + gd::String::From(operatorParamIndex) + "_")
|
|
.FindAndReplace("<value>",
|
|
"_PARAM" + gd::String::From(valueParamIndex) + "_");
|
|
}
|
|
}
|
|
|
|
return *this;
|
|
}
|
|
|
|
InstructionMetadata& InstructionMetadata::SetRequiresBaseObjectCapability(
|
|
const gd::String& capability) {
|
|
if (!IsObjectInstruction() && !IsBehaviorInstruction()) {
|
|
gd::LogError("Tried to add capability \"" + capability +
|
|
"\" to instruction named \"" + fullname +
|
|
"\", which is not an object or behavior instruction.");
|
|
return *this;
|
|
}
|
|
|
|
requiredBaseObjectCapability = capability;
|
|
return *this;
|
|
}
|
|
|
|
} // namespace gd
|