This page has been translated automatically.
Видеоуроки
Интерфейс
Основы
Продвинутый уровень
Подсказки и советы
Основы
Программирование на C#
Рендеринг
Профессиональный уровень (SIM)
Принципы работы
Свойства (properties)
Компонентная Система
Рендер
Физика
Редактор UnigineEditor
Обзор интерфейса
Работа с ассетами
Контроль версий
Работа с проектами
Настройка параметров ноды
Setting Up Materials
Настройка свойств
Освещение
Sandworm
Использование инструментов редактора для конкретных задач
Расширение функционала редактора
Встроенные объекты
Ноды (Nodes)
Объекты (Objects)
Эффекты
Декали
Источники света
Geodetics
World-ноды
Звуковые объекты
Объекты поиска пути
Player-ноды
Программирование
Основы
Настройка среды разработки
Примеры использования
C++
C#
UnigineScript
Унифицированный язык шейдеров UUSL (Unified UNIGINE Shader Language)
Плагины
Форматы файлов
Материалы и шейдеры
Rebuilding the Engine Tools
Интерфейс пользователя (GUI)
Двойная точность координат
API
Animations-Related Classes
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
VR-Related Classes
Работа с контентом
Оптимизация контента
Материалы
Визуальный редактор материалов
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Учебные материалы
Внимание! Эта версия документация УСТАРЕЛА, поскольку относится к более ранней версии SDK! Пожалуйста, переключитесь на самую актуальную документацию для последней версии SDK.
Внимание! Эта версия документации описывает устаревшую версию SDK, которая больше не поддерживается! Пожалуйста, обновитесь до последней версии SDK.

Streaming

This section contains settings related to resource streaming.Этот раздел содержит настройки, связанные с потоковой передачей ресурсов.

Streaming settings

Streaming SettingsНастройки стриминга
First Frames Force number of frames to load immediately after the first frame. It will make the scene appear right at the application start-up.
Диапазон значений: [0, INT_MAX]. Значение по умолчанию : 60.
Консольная команда: render_streaming_first_frames_force (API)
Max Threads maximum number of threads used for streaming. Higher number of threads results in faster streaming, but may cause spikes in case of excessive consumption of GPU resources.
Диапазон значений: [1, 256]. Значение по умолчанию : 1.
Консольная команда: render_streaming_max_threads (API)
Particles Memory Limit cache memory limit for vertices of particle systems, in percentage of the total GPU memory.
Примечание
Setting a too low limit for a huge number of particle systems in the scene may lead to rendering only some of them.

Диапазон значений: [0, 100]. Значение по умолчанию : 3.
Консольная команда: render_streaming_particles_memory_limit (API)

Preload at World Loading#

Shaders
Консольная команда: render_shaders_preload (API)

Budgets
Budgets#

Loading time limit for loading graphics resources, in milliseconds per frame. Increasing the limit leads to increasing the streaming performance. However, memory consumption also increases due to a decrease in the resource loading speed.
Диапазон значений: [0.0f, inf]. Значение по умолчанию : 1.0f.
Консольная команда: render_streaming_budget_loading (API)
Textures Destroy time limit for deleting textures, in milliseconds per frame. The Engine will distribute the textures cleanup process by the required number frames in order to not exceed the time limit. The number of frames will also depend on the amount of content in the scene and the computing capacity. Increasing the limit leads to increasing the streaming performance. However, memory consumption also increases due to a decrease in the texture unloading speed.
Диапазон значений: [0.0f, inf]. Значение по умолчанию : 0.1f.
Консольная команда: render_streaming_budget_destroy_textures (API)
Meshes Destroy time limit for deleting meshes, in milliseconds per frame. The Engine will distribute the meshes cleanup process by the required number frames in order to not exceed the time limit. The number of frames will also depend on the amount of content in the scene and the computing capacity. Increasing the limit leads to increasing the streaming performance. However, memory consumption also increases due to a decrease in the mesh unloading speed.
Диапазон значений: [0.0f, inf]. Значение по умолчанию : 0.1f.
Консольная команда: render_streaming_budget_destroy_meshes (API)
Примечание
The graphic resources are regularly checked for being modified in order to be reloaded or deleted.Графические ресурсы регулярно проверяются на предмет их изменения, для обеспечения их своевременной перезагрузки или удаления.

Textures
Textures#

Streaming Mode streaming mode for textures. The following modes are available:
  • Async - asynchronous loading of textures.
  • Force - force-loading of textures required for each frame at ones.
Опция #1 установлена по умолчанию (см. выше).
Консольная команда: render_streaming_textures_mode (API)
Cache Resolution resolution for texture cache elements. These minimized copies of textures are used instead of the originals while the latter are loaded. Одно из следующих значений:
  • 8x8
  • 16x16 (по умолчанию)
  • 32x32
  • 64x64
  • 128x128
  • 256x256
  • 512x512

Консольная команда: render_streaming_textures_cache_resolution (API)
Memory Limit cache memory limit used for textures streaming. This is a recommended value to aim for. So, it can be exceeded if textures are required to render the current frame. The memory limit is associated with the lifetime: textures are deleted from video memory only when both values are exceeded.
Диапазон значений: [0, 100]. Значение по умолчанию : 65.
Консольная команда: render_streaming_textures_memory_limit (API)
Life Time lifetime of GPU cache used for textures rendering. The engine deletes textures after this time only if the specified memory limit for textures streaming is also exceeded.
Диапазон значений: [1, 60]. Значение по умолчанию : 4.
Консольная команда: render_streaming_textures_life_time (API)

Meshes GPU
Meshes GPU#

Streaming Mode streaming mode for loading meshes to video memory (VRAM). The following modes are available:
  • Async - asynchronous loading of meshes.
  • Force - force-loading of meshes required for the current frame at once.
  • All - loading all meshes available in the project on the application start-up. This mode is good for small projects with few meshes.
Опция #1 установлена по умолчанию (см. выше).
Консольная команда: render_streaming_meshes_mode_vram (API)
Memory Limit memory limit used for loading meshes to video memory (VRAM). This is a recommended value to aim for. So, it can be exceeded if meshes are required to render the current frame. The memory limit is associated with the lifetime: meshes are deleted from VRAM only when both values are exceeded.
Диапазон значений: [0, 100]. Значение по умолчанию : 4.
Консольная команда: render_streaming_meshes_limit_vram (API)
Life Time lifetime of meshes in video memory since the last time they were accessed. The engine deletes meshes after this time only if the specified VRAM limit is also exceeded.
Диапазон значений: [0, 60]. Значение по умолчанию : 4.
Консольная команда: render_streaming_meshes_life_time_vram (API)

Meshes CPU
Meshes CPU#

Streaming Mode streaming mode for loading meshes to memory (RAM). The following modes are available:
  • Async - asychronous loading of meshes.
  • Force - force-loading of meshes required for the current frame at once.
  • All - loading all meshes available in the project on the application start-up. This mode is good for small projects with few meshes.
Опция #1 установлена по умолчанию (см. выше).
Консольная команда: render_streaming_meshes_mode_ram (API)
Memory Limit memory limit used for loading meshes to memory (RAM). This is a recommended value to aim for. So, it can be exceeded if meshes are required for the current frame. The memory limit is associated with the lifetime: meshes are deleted from RAM only when both values are exceeded.
Диапазон значений: [1, 100]. Значение по умолчанию : 5.
Консольная команда: render_streaming_meshes_limit_ram (API)
Life Time lifetime of meshes in memory since the last time they were accessed. The engine deletes meshes after this time only if the RAM limit is also exceeded.
Диапазон значений: [1, 60]. Значение по умолчанию : 20.
Консольная команда: render_streaming_meshes_life_time_ram (API)

Prefetch CPU
Prefetch CPU#

Collision Mode mode of asynchronous pre-loading of meshes to memory before they are used. Pre-loading is available only for meshes, which have at least one surface with the Collision flag set. There are 3 modes of loading such meshes to RAM:
  • Disable - loading is disabled.
  • Radius - meshes within the prefetch radius are loaded.
  • Full - all meshes with the Collision flag are loaded.
This method should be used when the Async streaming mode for meshes is set. Опция #1 установлена по умолчанию (см. выше).
Консольная команда: render_streaming_meshes_prefetch_collision (API)
Intersection Mode mode of asynchronous pre-loading of meshes into memory before they are used. Pre-loading is available only for meshes, which have at least one surface with the Intersection flag set. There are 3 modes of loading such meshes to RAM:
  • Disable - loading is disabled.
  • Radius - all meshes within the prefetch radius are loaded.
  • Full - all meshes with the Intersection flag are loaded.
This method should be used when the Async streaming mode for meshes is set. Опция #1 установлена по умолчанию (см. выше).
Консольная команда: render_streaming_meshes_prefetch_intersection (API)
Radius radius within which meshes are pre-loaded into memory. The value should exceed the physics radius (for collisions) and/or the radius within which intersections are calculated.
Диапазон значений: [0.0f, inf]. Значение по умолчанию : 0.0f.
Консольная команда: render_streaming_meshes_prefetch_radius (API)

For OpenGL Only
For OpenGL Only#

The settings below are available for OpenGL API only.Приведенные ниже настройки доступны только для OpenGL API.

Примечание
These parameters should be carefully adjusted for each particular case and configuration as they are heavily dependent on hardware and driver used.Эти параметры следует тщательно настраивать для каждого конкретного случая и конфигурации, поскольку они сильно зависят от используемого оборудования и драйверов.
Async Buffer

Size of an intermediate buffer (between the CPU and new resource) used for mesh and texture streaming, in Mb. The size of this buffer must be equal to the size of the largest resource (mesh/texture), otherwise in case of a larger resource, the buffer will be resized causing a spike. Размер промежуточного буфера (между ЦП и новым ресурсом), используемого для потоковой передачи сетки и текстур, в МБ. Размер этого буфера должен быть равен размеру самого большого ресурса (сетка / текстура), иначе в случае большего ресурса размер буфера будет изменен, что приведет к скачку.

Примечание
Be aware, that the size of this intermediate buffer will be added to total memory consumption.Имейте в виду, что размер этого промежуточного буфера будет добавлен к общему потреблению памяти.
Async Buffer Indices

Size of an intermediate buffer, analogous to the Async Buffer above, used for mesh streaming (to store vertex indices of meshes), in Mb.Размер промежуточного буфера, аналогичного Async Buffer выше, используемого для потоковой передачи ячеек (для хранения индексов вершин ячеек), в мегабайтах.

Примечание
Be aware, that the size of this intermediate buffer will be added to total memory consumption.Имейте в виду, что размер этого промежуточного буфера будет добавлен к общему потреблению памяти.
Async Buffer Synchronization

Enable buffer synchronization for transferring data from the streaming thread to the main one. When disabled, both async buffer and async buffer for indices are created anew each time. This reduces the number of buffer synchronizations but increases the number of memory allocations.Включите синхронизацию буфера для передачи данных из потокового потока в основной. При отключении асинхронный буфер и асинхронный буфер для индексов каждый раз создаются заново. Это уменьшает количество синхронизаций буфера, но увеличивает количество выделений памяти.

Примечание
Sometimes (depending on the hardware/driver used, e.g. when the main thread is affected by sychronization primitives in other threads) memory allocation may be faster than synchronizations, in such cases, when streaming becomes unacceptably slow, it is recommended to disable buffer synchronization.Иногда (в зависимости от используемого оборудования / драйвера, например, когда на основной поток влияют примитивы синхронизации в других потоках) распределение памяти может быть быстрее, чем при синхронизации, в таких случаях, когда потоковая передача становится неприемлемо медленной, рекомендуется отключить синхронизацию буфера.
Последнее обновление: 19.04.2024
Build: ()