Viewport

public Viewport.AnisotropicFiltering AnisotropicFilteringLevel { get; set; }

Устанавливает максимальное количество выборок при использовании анизотропной фильтрации текстур (как степень двойки). Большее количество выборок приведет к более резким текстурам под косыми углами, но это более затратно для вычисления. Значение 0 принудительно отключает анизотропную фильтрацию, даже для материалов, где она включена. Уровень анизотропной фильтрации также влияет на декали и проекторы света, если они настроены на использование анизотропной фильтрации. См. ProjectSettings.rendering/textures/decals/filter и ProjectSettings.rendering/textures/light_projectors/filter. Примечание: В 3D, чтобы эта настройка имела эффект, установите BaseMaterial3D.TextureFilter на BaseMaterial3D.TextureFilterEnum.LinearWithMipmapsAnisotropic или BaseMaterial3D.TextureFilterEnum.NearestWithMipmapsAnisotropic для материалов. Примечание: В 2D, чтобы эта настройка имела эффект, установите CanvasItem.TextureFilter на CanvasItem.TextureFilterEnum.LinearWithMipmapsAnisotropic или CanvasItem.TextureFilterEnum.NearestWithMipmapsAnisotropic на узле CanvasItem, отображающем текстуру (или в CanvasTexture). Однако анизотропная фильтрация редко бывает полезна в 2D, поэтому включайте ее для текстур в 2D только в том случае, если это создает значимую визуальную разницу.

public bool AudioListenerEnable2D { get; set; }

Если true, область просмотра будет обрабатывать 2D-аудиопотоки.

public bool AudioListenerEnable3D { get; set; }

Если true, область просмотра будет обрабатывать 3D-аудиопотоки.

public uint CanvasCullMask { get; set; }

Слои рендеринга, в которых этот Viewport отображает узлы CanvasItem. Примечание: CanvasItem не наследует слои видимости своих родительских элементов. Подробности см. в описании CanvasItem.VisibilityLayer.

public Viewport.DefaultCanvasItemTextureFilter CanvasItemDefaultTextureFilter { get; set; }

Режим фильтрации по умолчанию, используемый узлами CanvasItem в этом окне просмотра.

public Viewport.DefaultCanvasItemTextureRepeat CanvasItemDefaultTextureRepeat { get; set; }

Режим повтора по умолчанию, используемый узлами CanvasItem в этом окне просмотра.

public Transform2D CanvasTransform { get; set; }

Преобразование холста вьюпорта, полезное для изменения положения на экране всех дочерних CanvasItem. Это относительно глобального преобразования холста вьюпорта.

public Viewport.DebugDrawEnum DebugDraw { get; set; }

Режим наложения для тестирования визуализированной геометрии в целях отладки.

public bool Disable3D { get; set; }

Отключить 3D-рендеринг (но сохранить 2D-рендеринг).

public float FsrSharpness { get; set; }

Параметр резкости FSR, отдельный от Scaling3DScale. Сам по себе не включает FSR и не подтверждает доступность upscaler. По исходникам отрицательное значение заменяется на 0; изменение качества при разных значениях этим примером не проверено.

public Transform2D GlobalCanvasTransform { get; set; }

Глобальное преобразование холста вьюпорта. Преобразование холста относительно этого.

public bool GuiDisableInput { get; set; }

Отключает входной путь ввода viewport. Несмотря на имя, PushInput прекращается до _Input и GUI, а не только для элементов интерфейса. Не является выключателем отрисовки или _Process.

public int GuiDragThreshold { get; set; }

Минимальное расстояние, на которое должен переместиться курсор мыши при нажатии, прежде чем начнется операция перетаскивания.

public bool GuiEmbedSubwindows { get; set; }

Если true, подокна (всплывающие окна и диалоги) будут встроены в окно приложения как узлы, подобные элементам управления. Если false, они будут отображаться как отдельные окна, управляемые операционной системой.

public bool GuiSnapControlsToPixels { get; set; }

Если true, элементы управления графическим интерфейсом в области просмотра будут располагаться идеально по пикселям.

public bool HandleInputLocally { get; set; }

Если true, эта область просмотра будет отмечать входящие события ввода как обработанные ею самой. Если false, это будет сделано первой родительской областью просмотра, которая настроена на локальную обработку ввода. SubViewportContainer автоматически установит это свойство в false для Viewport, содержащегося внутри него. См. также Viewport.SetInputAsHandled и Viewport.IsInputHandled.

public float MeshLodThreshold { get; set; }

Экранный порог выбора автоматического mesh LOD. Ноль отключает выбор упрощённых уровней; увеличение порога допускает более грубую геометрию. Не создаёт LOD-данные отсутствующего ресурса и не отключает Entity. Пример сравнивает 0 и 1.

public Viewport.Msaa Msaa2D { get; set; }

Режим MSAA для геометрии 2D/canvas этого Viewport. Не заменяет фильтрацию текстур или сглаживание узоров внутри шейдера. В проверенной сборке 1.0.0 Compatibility/OpenGL выдаёт предупреждение и не меняет край 2D-меша, даже если свойство читает Msaa4X. Эффект Msaa4X подтверждён отдельно в Forward+/Vulkan. Msaa3D управляет другой настройкой.

Полный пример и ограничения.

public Viewport.Msaa Msaa3D { get; set; }

Запрошенное MSAA для 3D. Проверенный Msaa4X добавляет частичное покрытие геометрических краёв в Compatibility/OpenGL и Forward+/Vulkan. Не сглаживает автоматически все детали шейдера или текстуры. Фактическая поддержка и число samples зависят от устройства; getter не измеряет буфер GPU.

public bool Oversampling { get; set; }

Если true и выполняется одно из следующих условий: установлены SubViewport.Size2DOverrideStretch и SubViewport.Size2DOverride, установлен Window.ContentScaleFactor и включено масштабирование, установлен Viewport.OversamplingOverride, включены передискретизация шрифта и DpiTexture.

public float OversamplingOverride { get; set; }

Если значение больше нуля, это значение используется как коэффициент передискретизации шрифта, в противном случае передискретизация равна масштабу области просмотра.

public bool OwnWorld3D { get; set; }

Использует собственный эффективный 3D-мир вместо назначенного/унаследованного. При назначенном World3D может дублировать этот ресурс; исходное свойство World3D и FindWorld3D тогда различаются. Не клонирует Entity. Отключение возвращает назначенный/унаследованный мир.

public bool PhysicsObjectPicking { get; set; }

Если true, объекты, передающиеся в результате просмотра, становятся объектами процесса отбора мышей. Примечание: Число CanvasItems Поддается отбору одним входом только 64, и они выбираются в недетерминистском порядке. Количество поддающихся отбору 3D объектов не ограничено.

public bool PhysicsObjectPickingFirstOnly { get; set; }

Если true, сигнал ввода_изобретения будет отправлен только на один физический объект в процессе отбора мыши. Если вы хотите получить только верхний объект, вы должны также предусмотреть Viewport.PhysicsObjectPickingSort. Если false, сигнал ввода_event будет отправлен всем объектам физики в процессе отбора мыши. Это касается CanvasItem Выбираю только.

public bool PhysicsObjectPickingSort { get; set; }

Если true, объекты получают сборку мыши, сортируемую главным образом по их CanvasItem.ZIndex и, во-вторых, по их положению на дереве сцены. false, приказ не детерминистский. Примечание: Эта установка отключена по умолчанию из-за ее потенциальной дорогостоящей вычислительной стоимости. Примечание: Сортировка происходит после выбора поддающихся отбору объектов. При превышении максимального 64 CanvasItems Поддается отбору при помощи одного входа, не гарантируется, что объект с наивысшим значением CanvasItem.ZIndex принимает мероприятие по отбору.

public bool PositionalShadowAtlas16Bits { get; set; }

Используйте 16 бит для карты глубины тени omni/spot. Включение этого параметра приводит к снижению точности теней и может привести к появлению акне в тенях, но может привести к повышению производительности на некоторых устройствах.

public Viewport.PositionalShadowAtlasQuadrantSubdiv PositionalShadowAtlasQuad0 { get; set; }

Величина подразделения первого квадранта на теневом атласе.

public Viewport.PositionalShadowAtlasQuadrantSubdiv PositionalShadowAtlasQuad1 { get; set; }

Величина подразделения второго квадранта на теневом атласе.

public Viewport.PositionalShadowAtlasQuadrantSubdiv PositionalShadowAtlasQuad2 { get; set; }

Величина подразделения третьего квадранта на теневом атласе.

public Viewport.PositionalShadowAtlasQuadrantSubdiv PositionalShadowAtlasQuad3 { get; set; }

Величина подразделения четвертого квадранта на теневом атласе.

public int PositionalShadowAtlasSize { get; set; }

Размер общего shadow atlas для позиционных источников этого viewport: OmniLight3D и SpotLight3D. Для теней также нужен ShadowEnabled у источника. Пример задаёт 1024 и проверяет уменьшение синей подсветки за непрозрачной стеной при включении теней. Это не размер отдельной карты каждого источника и не atlas направленного света.

public Viewport.Scaling3DModeEnum Scaling3DMode { get; set; }

Запрошенный алгоритм масштабирования 3D. Bilinear/Nearest проверены в OpenGL и Vulkan; Fsr/Fsr2 — в Forward+. В текущем Compatibility запрос Fsr2 отклоняется с сохранением прежнего фильтра renderer, но getter C# показывает Fsr2. Не выдавайте это за автоматически применённый алгоритм.

public float Scaling3DScale { get; set; }

Линейный масштаб внутреннего 3D-разрешения. Для конечных значений Viewport ограничивает диапазон 0.1..2. При выходе 512×384 scale 0.5 даёт внутренние 256×192; выходная текстура и canvas UI сохраняют размер. Scale 2 даёт 1024×768 с последующим уменьшением. Это не обещание изменения FPS.

public Viewport.ScreenSpaceAAEnum ScreenSpaceAA { get; set; }

Запрошенное экранное AA: Disabled, Fxaa или Smaa. В текущем Compatibility renderer отклоняет FXAA/SMAA, хотя C#-свойство сохраняет запрос. В Forward+/Vulkan оба режима изменили реальные края примера. Проверяйте renderer и кадр, а не только getter.

public Viewport.SdfOversizeEnum SdfOversize { get; set; }

Управляет тем, какая часть исходного размера области просмотра должна быть покрыта 2D-полем расстояния со знаком. Этот SDF может быть выбран в шейдерах CanvasItem и также используется для столкновения GpuParticles2D. Более высокие значения позволяют учитывать части окклюдеров, расположенных за пределами области просмотра, в сгенерированном поле расстояния со знаком, за счет производительности. Если вы заметили, что частицы падают через LightOccluder2D, когда окклюдеры покидают область просмотра, увеличьте этот параметр. Процент добавляется на каждой оси и с обеих сторон. Например, при значении по умолчанию Viewport.SdfOversizeEnum.Oversize120Percent поле расстояния со знаком будет покрывать 20% размера области просмотра за пределами области просмотра с каждой стороны (сверху, справа, снизу, слева).

public Viewport.SdfScaleEnum SdfScale { get; set; }

Масштаб разрешения для использования в 2D-поле расстояний со знаком. Более высокие значения приводят к более точному и стабильному полю расстояний со знаком при движении камеры, за счет производительности.

public bool Snap2DTransformsToPixel { get; set; }

Если true, узлы CanvasItem будут внутренне привязаны к полным пикселям. Их положение все еще может быть субпиксельным, но десятичные знаки не будут иметь эффекта. Это может привести к более четкому виду за счет менее плавного движения, особенно если включено сглаживание Camera2D.

public bool Snap2DVerticesToPixel { get; set; }

Если true, вершины узлов CanvasItem будут привязаны к полным пикселям. Влияет только на конечные положения вершин, а не на преобразования. Это может привести к более четкому виду за счет менее плавного движения, особенно если включено сглаживание Camera2D.

public float TextureMipmapBias { get; set; }

Добавочный bias выбора mip-уровня текстур. Renderer также учитывает масштаб 3D при настройке эффективного bias. Это не геометрическое AA и не замена корректным mipmaps; текущий пример использует одноцветные меши без проверки текстурного aliasing.

public bool TransparentBg { get; set; }

Если true, то фон окна просмотра должен быть прозрачным. Примечание: Из-за технических ограничений некоторые функции рендеринга отключаются, когда окно просмотра имеет прозрачный фон. В настоящее время это относится к отражениям в экранном пространстве, рассеиванию под поверхностью и глубине резкости (DOF).

public bool UseDebanding { get; set; }

При использовании рендереров Mobile или Forward+ установите параметр Viewport.UseDebanding, чтобы включить или отключить функцию устранения полос в этом Viewport. Если Viewport.UseHdr2D имеет значение false, 2D-рендеринг не затрагивается устранением полос, если только Environment.BackgroundMode не имеет значения Environment.BGMode.Canvas. Если Viewport.UseHdr2D имеет значение true, устранение полос будет применяться только в том случае, если это корневой Viewport, и повлияет на весь 2D и 3D рендеринг, включая элементы холста. Параметр Viewport.UseDebanding не оказывает никакого эффекта при использовании метода рендеринга Compatibility. Мобильный рендерер также может использовать сглаживание материалов, которое можно установить с помощью RenderingServer.MaterialSetUseDebanding или настроить с помощью ProjectSettings.rendering/anti_aliasing/quality/use_debanding. См. также ProjectSettings.rendering/anti_aliasing/quality/use_debanding, RenderingServer.MaterialSetUseDebanding и RenderingServer.ViewportSetUseDebanding.

public bool UseHdr2D { get; set; }

Если true, 2D-передача будет осуществляться с использованием высокодинамичных диапазонов (ГДР) RGBA16 Кроме того, 2D-передача будет производиться на линейных значениях и будет преобразовываться с использованием соответствующей функции передачи непосредственно перед нанесением на экран (если Viewport прикрепляется к экрану). В практическом плане это означает, что конечный результат Viewport не будет зажиматься 0-1 дальность и может использоваться при 3D-продукции без корректировки цветов. Это позволяет 2D-диапазону использовать эффект, требующий высокого динамического диапазона (например, 2D свечения), а также существенно улучшает внешний вид эффектов, требующих очень подробных градиентов.

public bool UseOcclusionCulling { get; set; }

Включает отсечение полностью закрытых объектов для данного viewport при доступной реализации. Нужен действующий OccluderInstance3D; одна непрозрачная MeshInstance3D-стена не создаёт его автоматически. Проверяйте список отрисовки и корректность изображения, не только bool.

public bool UseTaa { get; set; }

Запрос временного AA, поддержанного текущим Forward+. В Compatibility значение может читаться как true без эффекта renderer. Статические края проверены после накопления истории; качество движения и ghosting не проверены. При временном upscaler renderer отключает отдельное TAA внутри.

public bool UseXR { get; set; }

Если true, область просмотра будет использовать основной интерфейс XR для рендеринга вывода XR. Когда это применимо, это может привести к стереоскопическому изображению и полученному рендеру, выводимому на гарнитуру.

public Viewport.VrsModeEnum VrsMode { get; set; }

Режим Изменчивый курс (VRS), используемый для этого окна просмотра. Обратите внимание, если оборудование не поддерживает VRS, это свойство игнорируется.

public Texture2D VrsTexture { get; set; }

Texture использовать время Viewport.VrsMode установлен следующим образом: Viewport.VrsTexture. Текстура * должна* использовать без потерь формат сжатия, с тем чтобы цвета могли точно соответствовать друг другу. Нижеследующие значения плотности VRS картируются в различных цветах с более яркими цветами, представляющими более низкий уровень точности затенения:

- 1×1 = rgb(0, 0, 0)     - #000000
- 1×2 = rgb(0, 85, 0)    - #005500
- 2×1 = rgb(85, 0, 0)    - #550000
- 2×2 = rgb(85, 85, 0)   - #555500
- 2×4 = rgb(85, 170, 0)  - #55aa00
- 4×2 = rgb(170, 85, 0)  - #aa5500
- 4×4 = rgb(170, 170, 0) - #aaaa00
- 4×8 = rgb(170, 255, 0) - #aaff00 - Not supported on most hardware
- 8×4 = rgb(255, 170, 0) - #ffaa00 - Not supported on most hardware
- 8×8 = rgb(255, 255, 0) - #ffff00 - Not supported on most hardware

public Viewport.VrsUpdateModeEnum VrsUpdateMode { get; set; }

Устанавливает режим обновления для Изменчивый курс (VRS) для области просмотра. VRS требует, чтобы входная текстура была преобразована в формат, используемый методом VRS, поддерживаемым оборудованием. Режим обновления определяет, как часто это происходит. Если графический процессор не поддерживает VRS или VRS не включен, это свойство игнорируется.

public World2D World2D { get; set; }

Ресурс 2D-мира. У новых viewport по умолчанию разные World2D; для совместного 2D-содержимого назначьте один ресурс явно. Совместный World2D не объединяет выбор камер или 3D-миры.

public World3D World3D { get; set; }

Явно назначенный 3D-мир viewport. В примере SubViewport получает новый World3D, чтобы его камера и окружение были отделены от родительского мира. Для получения фактически найденного мира используйте FindWorld3D: он также может искать у viewport-предков.

public World2D FindWorld2D();

Возвращает эффективный 2D-мир viewport. Новые viewport имеют отдельные World2D по умолчанию; для совместного содержимого нужен явный общий ресурс.

public World3D FindWorld3D();

Ищет доступный World3D у этого viewport и его viewport-предков. Это разрешение мира для работы, а не создание независимого мира. Для изоляции отдельной камеры назначьте SubViewport.World3D явно; проверенный пример использует new World3D().

public AudioListener2D GetAudioListener2D();

Возвращает текущий активный прослушиватель 2D-аудио. Возвращает null, если нет активных прослушивателей 2D-аудио, в этом случае активная 2D-камера будет рассматриваться как прослушиватель.

public AudioListener3D GetAudioListener3D();

Возвращает текущий активный прослушиватель 3D-аудио. Возвращает null, если нет активных прослушивателей 3D-аудио, в этом случае активная 3D-камера будет рассматриваться как прослушиватель.

public Camera2D GetCamera2D();

Возвращает текущую активную 2D-камеру. Возвращает null, если активных камер нет. Примечание: Если этот метод вызывается, когда в редакторе активна система Переопределения камеры, он вернет внутренне управляемую камеру переопределения. Поэтому рекомендуется избегать кэширования возвращаемого значения или перед использованием убедиться, что кэшированное значение по-прежнему является допустимым экземпляром и текущей камерой. См. @GlobalScope.is_instance_valid и Camera2D.IsCurrent.

public Camera3D GetCamera3D();

Возвращает текущую 3D-камеру этого viewport. Выбор текущей камеры независим от другого viewport, даже при общем World3D.

public bool GetCanvasCullMaskBit(uint layer);

Возвращает отдельный бит в маске слоя рендеринга.

public Reckfell.Collections.Array<Window> GetEmbeddedSubwindows();

Возвращает список видимых встроенных Window внутри области просмотра. Примечание: Window внутри других областей просмотра не будут перечислены.

public Transform2D GetFinalTransform();

Возвращает преобразование из системы координат области просмотра в систему координат средства внедрения.

public Vector2 GetMousePosition();

Возвращает положение мыши в этом Viewport, используя систему координат этого Viewport.

public Viewport.Msaa GetMsaa2D();

Читает выбранную настройку Msaa2D. Это не запрос фактической поддержки MSAA и не измерение сглаживания пикселей.

public Viewport.Msaa GetMsaa3D();

Читает запрошенный уровень MSAA объекта Viewport. Проверка фактического GPU-результата и возможностей устройства выполняется отдельно.

public float GetOversampling();

Возвращает коэффициент передискретизации области просмотра.

public Viewport.PositionalShadowAtlasQuadrantSubdiv GetPositionalShadowAtlasQuadrantSubdiv(int quadrant);

Возвращает позиционное подразделение квадранта теневого атласа указанного квадранта.

public int GetPositionalShadowAtlasSize();

Читает сохранённую настройку размера atlas объекта Viewport. Не проверяет, что конкретный источник отбрасывает тень или что GPU выделил точно такой буфер.

public int GetRenderInfo(Viewport.RenderInfoType type, Viewport.RenderInfo info);

Читает статистику отрисовки выбранного viewport и прохода. Счётчики обновляются кадрами; сравнивайте стабильные конфигурации после обновления. Не являются замером FPS, количеством Entity в дереве или стоимостью всей игры.

public Viewport.Scaling3DModeEnum GetScaling3DMode();

Читает запрошенный режим объекта Viewport. Не является запросом фактически выбранного внутреннего алгоритма renderer после отказа или fallback.

public Viewport.ScreenSpaceAAEnum GetScreenSpaceAA();

Читает запрошенную настройку экранного AA. C#-значение не подтверждает, что renderer принял запрос.

public Transform2D GetScreenTransform();

Возвращает трансформацию из Viewportкоординаты к экранным координатам окна, в котором находится окно управления окном.

public Transform2D GetStretchTransform();

Возвращает автоматически вычисленное 2D-преобразование растяжения, принимая во внимание настройки растяжения Viewport. Конечное значение умножается на Window.ContentScaleFactor, но только для корневого окна просмотра. Если этот метод вызывается для SubViewport (например, в дереве сцены с SubViewportContainer и SubViewport), коэффициент масштабирования корневого окна не будет применен. Используя Transform2D.get_scale для возвращаемого значения, это можно использовать для компенсации масштабирования при масштабировании узла Camera2D или для уменьшения масштаба TextureRect до пиксельного совершенства независимо от автоматически вычисленного коэффициента масштабирования. Примечание: Из-за того, как работает масштабирование пикселей, масштаб возвращаемого преобразования по осям X и Y может немного отличаться, даже если Window.ContentScaleAspect установлен в режим, который сохраняет соотношение сторон пикселей. Если Window.ContentScaleAspect равен Window.ContentScaleAspectEnum.Ignore, масштабы X и Y могут отличаться значительно.

public ViewportTexture GetTexture();

Получает выходную текстуру viewport, а не прямую текстуру внутреннего 3D-буфера. Для свежего readback дождитесь завершённого кадра; не считайте полученный размер доказательством внутреннего resolution scale.

public Rid GetViewportRid();

Возвращает RID области просмотра из RenderingServer.

public Rect2 GetVisibleRect();

Возвращает видимый прямоугольник в глобальных экранных координатах.

public World2D GetWorld2D();

Возвращает запрошенное значение World2D. Ресурс 2D-мира. У новых viewport по умолчанию разные World2D; для совместного 2D-содержимого назначьте один ресурс явно. Совместный World2D не объединяет выбор камер или 3D-миры.

public World3D GetWorld3D();

Возвращает запрошенное значение World3D. Явно назначенный ресурс 3D-мира. Может быть null при наследовании эффективного мира от родителя; для разрешения используйте FindWorld3D. OwnWorld3D может иметь приоритет над этим источником. Не является ресурсом иерархии сцены.

public void GuiCancelDrag();

Отменяет операцию перетаскивания, которая была ранее запущена с помощью Control._GetDragData или принудительно запущена с помощью Control.ForceDrag.

public Variant GuiGetDragData();

Возвращает данные перетаскивания из графического интерфейса пользователя, которые ранее возвращались Control._GetDragData.

public string GuiGetDragDescription();

Возвращает удобочитаемое описание данных перетаскивания, используемое в вспомогательных приложениях.

public Control GuiGetFocusOwner();

Возвращает текущий сфокусированный Control в этом окне просмотра. Если нет сфокусированного Control, возвращает null.

public Control GuiGetHoveredControl();

Возвращает Control, над которым в данный момент находится мышь в этом окне просмотра. Если ни один Control не имеет курсора, возвращает null. Обычно это листовой узел Control или самый глубокий уровень поддерева, который заявляет наведение. Это очень полезно при использовании вместе с Entity.IsAncestorOf, чтобы определить, находится ли мышь в дереве элементов управления.

public bool GuiIsDragSuccessful();

Возвращает true, если операция перетаскивания прошла успешно.

public bool GuiIsDragging();

Возвращает true, если операция перетаскивания в данный момент выполняется и где действие сброса может произойти в этом окне просмотра. Альтернатива Entity.NotificationDragBegin и Entity.NotificationDragEnd, когда вы предпочитаете опрос значения.

public void GuiReleaseFocus();

Удаляет фокус с текущего сфокусированного Control в этом окне просмотра. Если фокуса нет ни у одного Control, ничего не делает.

public void GuiSetDragDescription(string description);

Устанавливает удобочитаемое описание данных перетаскивания в значение description, используемое в вспомогательных приложениях.

public bool IsInputDisabled();

Возвращает запрошенное значение GuiDisableInput. Отключает входной путь ввода viewport. Несмотря на имя, PushInput прекращается до _Input и GUI, а не только для элементов интерфейса. Не является выключателем отрисовки или _Process.

public bool IsInputHandled();

Проверяет, поглощено ли текущее событие в используемой цепочке ввода. При HandleInputLocally=false состояние может разрешаться через родительский viewport; это не журнал всех прошлых событий.

public bool IsUsingOwnWorld3D();

Возвращает запрошенное значение OwnWorld3D. Использует собственный эффективный 3D-мир вместо назначенного/унаследованного. При назначенном World3D может дублировать этот ресурс; исходное свойство World3D и FindWorld3D тогда различаются. Не клонирует Entity. Отключение возвращает назначенный/унаследованный мир.

public void NotifyMouseEntered();

Сообщите Viewport, что мышь вошла в его область. Используйте эту функцию перед отправкой InputEventMouseButton или InputEventMouseMotion в Viewport с помощью Viewport.PushInput. См. также Viewport.NotifyMouseExited. Примечание: В большинстве случаев нет необходимости вызывать эту функцию, поскольку узлы SubViewport, которые являются дочерними элементами SubViewportContainer, уведомляются автоматически. Это необходимо только при взаимодействии с viewport нестандартными способами, например, как текстуры в TextureRect или с Area3D, который пересылает события ввода.

public void NotifyMouseExited();

Сообщить Viewport, что мышь покинула его область. Используйте эту функцию, когда узел, отображающий viewport, замечает, что мышь покинула область отображаемого viewport. См. также Viewport.NotifyMouseEntered. Примечание: В большинстве случаев нет необходимости вызывать эту функцию, поскольку узлы SubViewport, которые являются дочерними элементами SubViewportContainer, уведомляются автоматически. Это необходимо только при взаимодействии с viewports нестандартными способами, например, как текстуры в TextureRect или с Area3D, который пересылает события ввода.

public void PushInput(InputEvent @event, bool inLocalCoords = false);

Передаёт событие в цепочку ввода viewport: _Input, GUI и необработанные этапы до поглощения. Viewport должен быть в дереве; GuiDisableInput блокирует этот вход. Для текстуры на меше преобразование UV/экранных координат выполняет вызывающий код.

public void PushTextInput(string text);

Метод помощи, который называет set_text() в отношении нынешнего целевого Control, при условии, что он определен (например, если фокус Control это Button или LineEdit).

public void PushUnhandledInput(InputEvent @event, bool inLocalCoords = false);

Запускает заданное event в этом Viewport. Это можно использовать для передачи InputEvent между viewport или для локального применения входных данных, отправленных по сети или сохраненных в файле. Если in_local_coords равно false, позиция события находится в координатах встраиваемого устройства и будет преобразована в координаты viewport. Если in_local_coords равно true, позиция события находится в координатах viewport. Вызов этого метода распространит вызовы дочерних узлов для следующих методов в указанном порядке:

• Entity._ShortcutInput
• Entity._UnhandledKeyInput
• Entity._UnhandledInput Если более ранний метод помечает ввод как обработанный с помощью Viewport.SetInputAsHandled, любой более поздний метод в этом списке не будет вызван. Если ни один из методов не обрабатывает событие и Viewport.PhysicsObjectPicking равен true, событие используется для выбора физического объекта. Примечание: Этот метод не распространяет события ввода на встроенные Window или SubViewport.

public void SetCanvasCullMaskBit(uint layer, bool enable);

Установить/снять отдельные биты на маске слоя рендеринга. Это упрощает редактирование слоев этого Viewport.

public void SetDisableInput(bool disable);

Задаёт GuiDisableInput. Отключает входной путь ввода viewport. Несмотря на имя, PushInput прекращается до _Input и GUI, а не только для элементов интерфейса. Не является выключателем отрисовки или _Process.

public void SetInputAsHandled();

Помечает текущее событие обработанным, чтобы последующие необработанные этапы этой цепочки не вызывались. Не отменяет уже выполненные обработчики. Учитывайте HandleInputLocally и родительский viewport.

public void SetMsaa2D(Viewport.Msaa msaa);

Задаёт Msaa2D этого Viewport. Принятое значение настройки не доказывает поддержку эффекта рендерером: Compatibility/OpenGL проверенной сборки сообщает об отсутствии поддержки. Для подтверждённого Msaa4X использован Forward+/Vulkan.

public void SetPositionalShadowAtlasQuadrantSubdiv(int quadrant, Viewport.PositionalShadowAtlasQuadrantSubdiv subdiv);

Устанавливает количество подразделов для использования в указанном квадранте. Большее количество подразделов позволяет иметь больше теней в сцене одновременно, но снижает качество теней. Хорошей практикой является наличие квадрантов с различным количеством подразделов и как можно меньшим количеством подразделов.

public void SetPositionalShadowAtlasSize(int size);

Задаёт размер общего atlas позиционных теней. Ноль отключает его; увеличение может повысить доступную детализацию, но расходует ресурсы и не исправляет LightCullMask, CastShadow или неверное положение источника.

public void SetScaling3DMode(Viewport.Scaling3DModeEnum scaling3DMode);

Запрашивает алгоритм. В текущем renderer-setter неподдержанный FSR-запрос может быть отклонён без смены прежнего режима; C#-объект всё равно хранит новое запрошенное значение. Проверяйте доступность до изменения интерфейса игры.

public void SetScaling3DScale(float scale);

Задаёт масштаб внутреннего 3D-рендера, не размер окна и не масштаб canvas. Последующее обновление renderer меняет буферы; не считывайте кадр до завершения обновления.

public void SetScreenSpaceAA(Viewport.ScreenSpaceAAEnum screenSpaceAA);

Выбирает экранное AA для этого viewport. Текущий Compatibility принимает Disabled, но отклоняет FXAA/SMAA. В Forward+/Vulkan проверено реальное изменение геометрических краёв обоими методами.

public void SetUseOwnWorld3D(bool enable);

Задаёт OwnWorld3D. Использует собственный эффективный 3D-мир вместо назначенного/унаследованного. При назначенном World3D может дублировать этот ресурс; исходное свойство World3D и FindWorld3D тогда различаются. Не клонирует Entity. Отключение возвращает назначенный/унаследованный мир.

public void SetUseTaa(bool enable);

Запрашивает TAA. Текущий renderer применяет его только в Forward+; C#-getter может хранить true даже после отказа в другом режиме. Для FSR2 используйте собственную временную реконструкцию upscaler, не отдельное TAA поверх неё.

public void SetWorld2D(World2D world2D);

Задаёт World2D. Ресурс 2D-мира. У новых viewport по умолчанию разные World2D; для совместного 2D-содержимого назначьте один ресурс явно. Совместный World2D не объединяет выбор камер или 3D-миры.

public void SetWorld3D(World3D world3D);

Задаёт World3D. Явно назначенный ресурс 3D-мира. Может быть null при наследовании эффективного мира от родителя; для разрешения используйте FindWorld3D. OwnWorld3D может иметь приоритет над этим источником. Не является ресурсом иерархии сцены.

public void UpdateMouseCursorState();

Принудительно мгновенно обновлять дисплей на основе текущего положения курсора мыши. Это включает обновление формы курсора мыши и отправку необходимых сигналов Control.MouseEntered, CollisionObject2D.MouseEntered, CollisionObject3D.MouseEntered и Window.MouseEntered и их соответствующих аналогов mouse_exited.

public void WarpMouse(Vector2 position);

Перемещает указатель мыши в указанную позицию в этом Viewport, используя систему координат этого Viewport. Примечание: Viewport.WarpMouse поддерживается только в Windows, macOS и Linux. Он не действует на Android, iOS и Web.

public event Viewport.GuiFocusChangedEventHandler GuiFocusChanged;

Принимается, когда: Control Узел захватывает клавиатуру. Примечание: A Control Узел, теряющий фокус, не вызывает этот сигнал.

public event Action SizeChanged;

Выдается при изменении размера области просмотра, будь то изменение размера окна или каким-либо другим способом.