2. Godot Engine
3. Godot Class Reference
4. Ukrainian

[PackedDataContainer] can be used to efficiently store data from untyped containers. The data is packed into raw bytes and can be saved to file. Only [Array] and [Dictionary] can be stored this way.
You can retrieve the data by iterating on the container, which will work as if iterating on the packed data itself. If the packed container is a [Dictionary], the data can be retrieved by key names ([String]/[StringName] only).
[codeblock]
var data = { "key": "value", "another_key": 123, "lock": Vector2() }
var packed = PackedDataContainer.new()
packed.pack(data)
ResourceSaver.save(packed, "packed_data.res")
[/codeblock]
[codeblock]
var container = load("packed_data.res")
for key in container:
prints(key, container[key])
[/codeblock]
Prints:
[codeblock lang=text]
key value
lock (0, 0)
another_key 123
[/codeblock]
Nested containers will be packed recursively. While iterating, they will be returned as [PackedDataContainerRef].

[PackedDataContainer] можна використовувати для ефективного зберігання даних із нетипових контейнерів. Дані упаковуються в необроблені байти та можуть бути збережені у файлі. Таким чином можна зберігати лише [Масив] і [Словник].
Ви можете отримати дані шляхом ітерації контейнера, який працюватиме так, ніби ітерації самих упакованих даних. Якщо упакований контейнер є [словником], дані можна отримати за іменами ключів (лише [String]/[StringName]).
[codeblock]
var data = { "key": "value", "another_key": 123, "lock": Vector2() }
var packed = PackedDataContainer.new()
packed.pack(даніdata)
ResourceSaver.save(packed, "packed_data.res")
[/codeblock]
[codeblock]
var container = load("packed_data.res")
для ключа в контейнері:
prints(ключ, контейнер[ключfor key in container:
prints(key, container[key])
[/codeblock]
ПринтиPrint:
[codeblock lang=text]
ключове значення
замокkey valve
lock (0, 0)
another_key 123
[/codeblock]
Вкладені контейнери будуть упаковані рекурсивно. Під час ітерації вони повертатимуться як [PackedDataContainerRef].

Constructs a new [PackedColorArray]. Optionally, you can pass in a generic [Array] that will be converted.
[b]Note:[/b] When initializing a [PackedColorArray] with elements, it must be initialized with an [Array] of [Color] values:
[codeblock]
var array = PackedColorArray([Color(0.1, 0.2, 0.3), Color(0.4, 0.5, 0.6)])
[/codeblock]

БудуємоСтворює новий [PackedColorArray]. ДодатковоЗа бажанням ви можете пройти вередати загальній [Аррайий [Array], якаий буде перетворена.о.
[b]Note:[/b] ПриПримітка.[/b] Під час ініціалізації [PackedColorArray] з елементами, він повинен бути ініціалізований [Array] значень [Color]:
[блокування коду]codeblock]
var array = PackedColorArray([Color(0.,1, 0.,2, 0.,3), Колір(0.,4, 0.,5, 0.,6)])
[/codeblock]

Returns a hexadecimal representation of this array as a [String].
[codeblocks]
[gdscript]
var array = PackedByteArray([11, 46, 255])
print(array.hex_encode()) # Prints "0b2eff"
[/gdscript]
[csharp]
byte[] array = [11, 46, 255];
GD.Print(array.HexEncode()); // Prints "0b2eff"
[/csharp]
[/codeblocks]

Повертає шістнадцяткове представлення цього масиву як [String].
[codeblocks]
[gdscript]
var array = PackedByteArray([11, 46, 255])
print(array.hex_encode()) # Виводить "0b2eff"
[/gdscript]
[csharp]
byte[] array = [11, 46, 255];
GD.Print(array.HexEncode()); // Виводить "0b2eff"
[/csharp]
[/codeblocks]

Returns a hexadecimal representation of this array as a [String].
[codeblocks]
[gdscript]
var array = PackedByteArray([11, 46, 255])
print(array.hex_encode()) # Prints "0b2eff"
[/gdscript]
[csharp]
byte[] array = [11, 46, 255];
GD.Print(array.HexEncode()); // Prints "0b2eff"
[/csharp]
[/codeblocks]

Повертає шістнадцяткове представлення цього масиву як [String].
[codeblocks]
[gdscript]
var array = PackedByteArray([11, 46, 255])
print(array.hex_encode()) # Виводить "0b2eff"
[/gdscript]
[csharp]
масив byte[] = [11, 46, 255];
GD.Print(array.HexEncode()); // Виводить "0b2eff"
[/csharp]
[/codeblocks]

Moves the file or directory at the given [param path] to the system's recycle bin. See also [method DirAccess.remove].
The method takes only global paths, so you may need to use [method ProjectSettings.globalize_path]. Do not use it for files in [code]res://[/code] as it will not work in exported projects.
Returns [constant FAILED] if the file or directory cannot be found, or the system does not support this method.
[codeblocks]
[gdscript]
var file_to_remove = "user://slot1.save"
OS.move_to_trash(ProjectSettings.globalize_path(file_to_remove))
[/gdscript]
[csharp]
var fileToRemove = "user://slot1.save";
OS.MoveToTrash(ProjectSettings.GlobalizePath(fileToRemove));
[/csharp]
[/codeblocks]
[b]Note:[/b] This method is implemented on Android, Linux, macOS and Windows.
[b]Note:[/b] If the user has disabled the recycle bin on their system, the file will be permanently deleted instead.

Перемістітьщує файл або каталог нза заданій [параметр шляху] в рециркуляторим [param path] до кошика системи. Дивисьіться також [метод DirAccess.remove].
Метод приймає тількилише глобальні шляхи, тому вам потрібноможе знадобитися використовувати [методичного проектуНалаштуванняmethod ProjectSettings.globalize_path]. Не використовуйте його для файлів у [code]res://[/code], оскільки він не буде працюватиме в експортованих проектах.
Я
Повертає [константа FAILED], якщо файл абочи каталог не знайдено, або система не підтримує цей метод.
[блоки коду]
[видання]codeblocks]
[gdscript]
var файлfile_to_remove = "user://slot1.save"
OS.move_to_trash(ПроектиProjectSettings.globalize_path(file_to_remove)))
[/gdscript]
[csharp]
var файлfileToRemove = "user://slot1.save";
OS.MoveToTrash(ПроектиProjectSettings.GlobalizePath(fileToRemove));
[/csharp]
[/codeblocks]
[b]Примітка:.[/b] Цей метод реалізуєтьсяовано на Android, Linux, macOS таі Windows.
[b]Примітка:[/b] Яякщо користувач відключив в систему рециклопедію,имкнув кошик у своїй системі, замість цього файл буде назавждиостаточно видалено.

Returns the name of the host platform.
- On Windows, this is [code]"Windows"[/code].
- On macOS, this is [code]"macOS"[/code].
- On Linux-based operating systems, this is [code]"Linux"[/code].
- On BSD-based operating systems, this is [code]"FreeBSD"[/code], [code]"NetBSD"[/code], [code]"OpenBSD"[/code], or [code]"BSD"[/code] as a fallback.
- On Android, this is [code]"Android"[/code].
- On iOS, this is [code]"iOS"[/code].
- On Web, this is [code]"Web"[/code].
[b]Note:[/b] Custom builds of the engine may support additional platforms, such as consoles, possibly returning other names.
[codeblocks]
[gdscript]
match OS.get_name():
"Windows":
print("Welcome to Windows!")
"macOS":
print("Welcome to macOS!")
"Linux", "FreeBSD", "NetBSD", "OpenBSD", "BSD":
print("Welcome to Linux/BSD!")
"Android":
print("Welcome to Android!")
"iOS":
print("Welcome to iOS!")
"Web":
print("Welcome to the Web!")
[/gdscript]
[csharp]
switch (OS.GetName())
{
case "Windows":
GD.Print("Welcome to Windows");
break;
case "macOS":
GD.Print("Welcome to macOS!");
break;
case "Linux":
case "FreeBSD":
case "NetBSD":
case "OpenBSD":
case "BSD":
GD.Print("Welcome to Linux/BSD!");
break;
case "Android":
GD.Print("Welcome to Android!");
break;
case "iOS":
GD.Print("Welcome to iOS!");
break;
case "Web":
GD.Print("Welcome to the Web!");
break;
}
[/csharp]
[/codeblocks]
[b]Note:[/b] On Web platforms, it is still possible to determine the host platform's OS with feature tags. See [method has_feature].

Повертає назву хост-платформи.
- У Windows це [кодcode]"Windows"[/code].
- У macOS це [кодcode]"macOS"[/code].
- В операційних системах на основі Linux це [кодcode]"Linux"[/code].
- В операційних системах на основі BSD це [code]"FreeBSD"[/code], [code]"NetBSD"[/code], [code]"OpenBSD"[/code] або [code]"BSD"[/code] як запасний варіант.
– На Android це [кодcode]"Android"[/code].
- В iOS це [кодcode]"iOS"[/code].
- В Інтернеті це [кодcode]"Веб"[/кодcode].
[b]Примітка:[/b] Спеціальні збірки двигуна можуть підтримувати додаткові платформи, такі як консолі, імовірно повертаючи інші назви.
[кодові блокиcodeblocks]
[gdscript]
відповідатиmatch OS.get_name():
"ВікнаWindow s":
print("Ласкаво просимо до Windows!")
"macOS":
print("Ласкаво просимо до macOS!")
«Linux», «FreeBSD», «NetBSD», «OpenBSD», «BSD»:
print("Ласкаво просимо до Linux/BSD!")
"Android":
print("Ласкаво просимо до Android!")
"iOS":
print("Ласкаво просимо до iOS!")
"ПавутинаWevb":
print("Ласкаво просимо в Інтернет!")
[/gdscript]
[csharp]
перемикачswitch (OS.GetName())
{
case "Windows":
GD.Print("Ласкаво просимо до Windows");
розривbreak;
case "macOS":
GD.Print("Ласкаво просимо до macOS!");
розривbreak;
case "Linux":
case "FreeBSD":
case "NetBSD":
case "OpenBSD":
case "BSD":
GD.Print("Ласкаво просимо до Linux/BSD!");
break;
case "Android":
GD.Print("Ласкаво просимо в Android!");
break;
case "iOS":
GD.Print("Ласкаво просимо до iOS!");
break;
case «Web»:
GD.Print("Ласкаво просимо в Інтернет!");
break;
}
[/csharp]
[/codeblocks]
[b]Примітка.[/b] На веб-платформах усе ще можна визначити ОС хост-платформи за допомогою тегів функцій. Перегляньте [method has_feature].

Returns the name of the host platform.
- On Windows, this is [code]"Windows"[/code].
- On macOS, this is [code]"macOS"[/code].
- On Linux-based operating systems, this is [code]"Linux"[/code].
- On BSD-based operating systems, this is [code]"FreeBSD"[/code], [code]"NetBSD"[/code], [code]"OpenBSD"[/code], or [code]"BSD"[/code] as a fallback.
- On Android, this is [code]"Android"[/code].
- On iOS, this is [code]"iOS"[/code].
- On Web, this is [code]"Web"[/code].
[b]Note:[/b] Custom builds of the engine may support additional platforms, such as consoles, possibly returning other names.
[codeblocks]
[gdscript]
match OS.get_name():
"Windows":
print("Welcome to Windows!")
"macOS":
print("Welcome to macOS!")
"Linux", "FreeBSD", "NetBSD", "OpenBSD", "BSD":
print("Welcome to Linux/BSD!")
"Android":
print("Welcome to Android!")
"iOS":
print("Welcome to iOS!")
"Web":
print("Welcome to the Web!")
[/gdscript]
[csharp]
switch (OS.GetName())
{
case "Windows":
GD.Print("Welcome to Windows");
break;
case "macOS":
GD.Print("Welcome to macOS!");
break;
case "Linux":
case "FreeBSD":
case "NetBSD":
case "OpenBSD":
case "BSD":
GD.Print("Welcome to Linux/BSD!");
break;
case "Android":
GD.Print("Welcome to Android!");
break;
case "iOS":
GD.Print("Welcome to iOS!");
break;
case "Web":
GD.Print("Welcome to the Web!");
break;
}
[/csharp]
[/codeblocks]
[b]Note:[/b] On Web platforms, it is still possible to determine the host platform's OS with feature tags. See [method has_feature].

Повертає назву хост-платформи.
- У Windows це [codeкод]"Windows"[/code].
- У macOS це [codeкод]"macOS"[/code].
- В операційних системах на основі Linux це [codeкод]"Linux"[/code].
- В операційних системах на основі BSD це [code]"FreeBSD"[/code], [code]"NetBSD"[/code], [code]"OpenBSD"[/code] або [code]"BSD" [/code] як запасний варіант.
– На Android це [codeкод]"Android"[/code].
- В iOS це [codeкод]"iOS"[/code].
- В Інтернеті це [codeкод]"Веб"[/codeкод].
[b]Примітка:[/b] Спеціальні збірки механізмудвигуна можуть підтримувати додаткові платформи, такі як консолі, імовірно повертаючи інші назви.
[кодові блоки]
[gdscript]
відповідати OS.get_name():
"Вікна":
print("Ласкаво просимо до Windows!")
"macOS":
print("Ласкаво просимо до macOS!")
«Linux», «FreeBSD», «NetBSD», «OpenBSD», «BSD»:
print("Ласкаво просимо до Linux/BSD!")
"Android":
print("Ласкаво просимо до Android!")
"iOS":
print("Ласкаво просимо до iOS!")
"Павутина":
print("Ласкаво просимо в Інтернет!")
[/gdscript]
[csharp]
перемикач (OS.GetName())
{
корпус "Віндовсcase "Windows":
GD.Print("Ласкаво просимо до Windows");
розрив;
випадокcase "macOS":
GD.Print("Ласкаво просимо до macOS!");
розрив;
випадокcase "Linux":
випадокcase "FreeBSD":
випадокcase "NetBSD":
випадокcase "OpenBSD":
корпусcase "BSD":
GD.Print("Ласкаво просимо до Linux/BSD!");
розрив;
чохол "Андроїдbreak;
case "Android":
GD.Print("Ласкаво просимо в Android!");
розрив;
випадокbreak;
case "iOS":
GD.Print("Ласкаво просимо до iOS!");
розрив;
кейс «Павутинаbreak;
case «Web»:
GD.Print("Ласкаво просимо в Інтернет!");
розрив;break;
}
[/csharp]
[/codeblocks]
[b]Примітка.[/b] На веб-платформах усе ще можна визначити ОС хост-платформи за допомогою тегів функцій. Перегляньте [method has_feature].

Returns the given keycode as a [String].
[codeblocks]
[gdscript]
print(OS.get_keycode_string(KEY_C)) # Prints "C"
print(OS.get_keycode_string(KEY_ESCAPE)) # Prints "Escape"
print(OS.get_keycode_string(KEY_MASK_SHIFT | KEY_TAB)) # Prints "Shift+Tab"
[/gdscript]
[csharp]
GD.Print(OS.GetKeycodeString(Key.C)); // Prints "C"
GD.Print(OS.GetKeycodeString(Key.Escape)); // Prints "Escape"
GD.Print(OS.GetKeycodeString((Key)KeyModifierMask.MaskShift | Key.Tab)); // Prints "Shift+Tab"
[/csharp]
[/codeblocks]
See also [method find_keycode_from_string], [member InputEventKey.keycode], and [method InputEventKey.get_keycode_with_modifiers].

Поверненнятає заданогоий коду як [String ключа як [рядок].
[блоки коду]
[видання]
Друкcodeblocks]
[gdscript]
print(OS.get_keycode_string(KEY_C)) # Друки "C"
ДрукВиводить "C"
print(OS.get_keycode_string(KEY_ESCAPE)) # ДрукиВиводить "Escape"
Друк
print(OS.get_keycode_string(KEY_MASK_SHIFT | KEY_TAB)) # ДрукиВиводить "Shift+Tab"
[/gdscript]
[csharp]
GD.Print(OS.GetKeycodeString(Key.C)); // Друк // Виводить "C"
GD.Print(OS.GetKeycodeString(Key.Escape)); // Друки // Виводить "Escape"
GD.Print(OS.GetKeycodeString((Key)KeyModifierMask.MaskShift | Key.Tab)); // ДрукВиводить "Shift+Tab"
[/csharp]
[/codeblocks]
Дивисьіться також [метод пошукуfind_keycode_from_string], [пам'ятний вхідчлен InputEventKey.keycode], і [метод InputEventKey.get_keycode_with_modifiers].

Returns the command-line user arguments passed to the engine. User arguments are ignored by the engine and reserved for the user. They are passed after the double dash [code]--[/code] argument. [code]++[/code] may be used when [code]--[/code] is intercepted by another program (such as [code]startx[/code]).
[codeblock]
# Godot has been executed with the following command:
# godot --fullscreen -- --level=2 --hardcore

OS.get_cmdline_args() # Returns ["--fullscreen", "--level=2", "--hardcore"]
OS.get_cmdline_user_args() # Returns ["--level=2", "--hardcore"]
[/codeblock]
To get all passed arguments, use [method get_cmdline_args].

Повертає аргументи користувача командного рядка, передані до двигуна. Визначені аргументи, якісистемі. Аргументи користувача ігноруються двигунмеханізмом і зарезервованіуються для користувача. ПісляВони передаються після аргументу подвійного золи [codeтире [код]--[/codeкод]. [code]++[/code] можена використовуватися пр, коли [code]---[/code] перехоплюється іншою програмою (наприклад, [code]startx[/code]).
[блокування коду]
Нема Богот бувcodeblock]
# Godot було виконаний з наступним командуванням:
# godot - повноекранний -- --рівень=2 --хардкоро за такою командою:
# godot --fullscreen -- --level=2 --hardcore

OS.get_cmdline_args() # Повернення[тає ["--fullscreen", "--level=2", "-хардкор-hardcore"]
OS.get_cmdline_user_args() # Повернення[тає ["--level=2", "--хардкорhardcore"]
[/codeblock]
Щоб отримати всі передані аргументи, свикористаовуйтеся [метод get_cmdline_args].

Returns the command-line arguments passed to the engine.
Command-line arguments can be written in any form, including both [code]--key value[/code] and [code]--key=value[/code] forms so they can be properly parsed, as long as custom command-line arguments do not conflict with engine arguments.
You can also incorporate environment variables using the [method get_environment] method.
You can set [member ProjectSettings.editor/run/main_run_args] to define command-line arguments to be passed by the editor when running the project.
[b]Example:[/b] Parse command-line arguments into a [Dictionary] using the [code]--key=value[/code] form for arguments:
[codeblocks]
[gdscript]
var arguments = {}
for argument in OS.get_cmdline_args():
if argument.contains("="):
var key_value = argument.split("=")
arguments[key_value[0].trim_prefix("--")] = key_value[1]
else:
# Options without an argument will be present in the dictionary,
# with the value set to an empty string.
arguments[argument.trim_prefix("--")] = ""
[/gdscript]
[csharp]
var arguments = new Dictionary<string, string>();
foreach (var argument in OS.GetCmdlineArgs())
{
if (argument.Contains('='))
{
string[] keyValue = argument.Split("=");
arguments[keyValue[0].TrimPrefix("--")] = keyValue[1];
}
else
{
// Options without an argument will be present in the dictionary,
// with the value set to an empty string.
arguments[argument.TrimPrefix("--")] = "";
}
}
[/csharp]
[/codeblocks]
[b]Note:[/b] Passing custom user arguments directly is not recommended, as the engine may discard or modify them. Instead, pass the standard UNIX double dash ([code]--[/code]) and then the custom arguments, which the engine will ignore by design. These can be read via [method get_cmdline_user_args].

Повертає аргументи командного рядка, передані механізму.
Аргументи командного рядка можна записати в будь-якій формі, включаючи форми [code]--key=value[/code] і [code]--key=value[/code], щоб їх можна було правильно проаналізувати, за умови, що спеціальні аргументи командного рядка не конфліктують з аргументами механізму.
Ви також можете включити змінні середовища за допомогою методу [method get_environment].
Ви можете встановити [member ProjectSettings.editor/run/main_run_args], щоб визначити аргументи командного рядка, які передає редактор під час запуску проекту.
[b]Приклад:[/b] Розберіть аргументи командного рядка в [словник] за допомогою форми [код]--ключ=значення[/код] для аргументів:
[codeblocks]
[gdscript]
змінні аргументи = {}
для аргументу вvar arguments = {}
for argument in OS.get_cmdline_args():
if argument.contains("="):
var key_value = argument.split("=")
arguments[key_value[0].trim_prefix("--")] = key_value[1]
щеelse:
# Варіанти без аргументу будуть присутні в словнику,
# зі значенням, встановленим у порожній рядок.
аргументи[argument.trim_prefix("--")] = ""
[/gdscript]
[csharp]
var arguments = new Dictionary<string, string>();
foreach (аргумент var в OS.GetCmdlineArgs())
{
if (argument.Contains('='))
{
string[] keyValue = argument.Split("=");
arguments[keyValue[0].TrimPrefix("--")] = keyValue[1];
}
іншеelse
{
// Параметри без аргументу будуть присутні в словнику,
// зі значенням, встановленим у порожній рядок.
arguments[argument.TrimPrefix("--")] = "";
}
}
[/csharp]
[/codeblocks]
[b]Примітка:[/b] Не рекомендується передавати користувальницькі аргументи безпосередньо, оскільки система може їх відхилити або змінити. Замість цього передайте стандартне подвійне тире UNIX ([code]--[/code]), а потім спеціальні аргументи, які механізм ігноруватиме за задумом. Їх можна прочитати через [метод get_cmdline_user_args].