RenderingDevice

public void Barrier(RenderingDevice.BarrierMask from = RenderingDevice.BarrierMask.AllBarriers, RenderingDevice.BarrierMask to = RenderingDevice.BarrierMask.AllBarriers);

Этот метод ничего не даёт.

public Error BlasBuild(Rid blas);

Создаёт blas.

public Rid BlasCreate(Reckfell.Collections.Array<RDAccelerationStructureGeometry> geometries, RenderingDevice.AccelerationStructureFlagBits flags);

Создает новую структуру ускорения низового уровня (БЛАС). RID ..вернёмся. Как только закончите с вашим RIDВы захотите освободить RID с использованием RenderingDevice's RenderingDevice.FreeRid Метод.

public Error BufferClear(Rid buffer, uint offset, uint sizeBytes);

Очищает содержимое buffer, очищая size_bytes байт, начиная с offset. Выводит ошибку, если:

• размер не кратен четырем
• область, указанная offset + size_bytes, превышает буфер
• в данный момент активен список отрисовки (создан RenderingDevice.DrawListBegin)
• в данный момент активен список вычислений (создан RenderingDevice.ComputeListBegin)

public Error BufferClear(Rid buffer, uint offset, uint sizeBytes, RenderingDevice.BarrierMask postBarrier);

Очищает содержимое buffer, очищая size_bytes байт, начиная с offset. Выводит ошибку, если:

• размер не кратен четырем
• область, указанная offset + size_bytes, превышает буфер
• в данный момент активен список отрисовки (создан RenderingDevice.DrawListBegin)
• в данный момент активен список вычислений (создан RenderingDevice.ComputeListBegin)

public Error BufferCopy(Rid srcBuffer, Rid dstBuffer, uint srcOffset, uint dstOffset, uint size);

Копирует size байт из src_buffer в src_offset в dst_buffer в dst_offset. Выводит ошибку, если:

• size превышает размер src_buffer или dst_buffer в соответствующих смещениях
• в данный момент активен список отрисовки (создан методом RenderingDevice.DrawListBegin)
• в данный момент активен список вычислений (создан методом RenderingDevice.ComputeListBegin)

public byte[] BufferGetData(Rid buffer, uint offsetBytes = 0, uint sizeBytes = 0);

Блокирующее чтение буфера в новый byte[] с ожиданием работы устройства. Смещение и размер в байтах; sizeBytes=0 выбирает полный размер буфера, не остаток после произвольного смещения. Для частичного чтения задавайте размер явно.

public Error BufferGetDataAsync(Rid buffer, Callable callback, uint offsetBytes = 0, uint sizeBytes = 0);

Асинхронная версия RenderingDevice.BufferGetData. RenderingDevice вызовет callback в определенном количестве кадров с данными, которые были в буфере на момент запроса. Примечание: На данный момент задержка соответствует количеству кадров, указанному ProjectSettings.rendering/rendering_device/vsync/frame_queue_size. Примечание: Загрузка больших буферов может иметь непомерно высокую стоимость для реального времени даже при использовании асинхронного метода из-за ограничений пропускной способности оборудования. При работе с большими ресурсами вы можете настроить такие параметры, как ProjectSettings.rendering/rendering_device/staging_buffer/block_size_kb, чтобы улучшить скорость передачи за счет дополнительной памяти.

public ulong BufferGetDeviceAddress(Rid buffer);

Возвращает адрес указанного buffer, который может быть передан шейдерам любым способом для доступа к базовым данным. Буфер должен быть создан с включенной этой функцией. Примечание: Вы должны проверить, поддерживает ли графический процессор эту функцию, вызвав RenderingDevice.HasFeature с RenderingDevice.Features.BufferDeviceAddress в качестве параметра.

public Error BufferUpdate(Rid buffer, uint offset, uint sizeBytes, byte[] data);

Записывает sizeBytes байтов в буфер со смещения offset. Вызывайте вне активного compute/draw/raytracing list, передайте достаточно исходных байтов и оставайтесь в пределах выделенного буфера. Это не число элементов.

public Error BufferUpdate(Rid buffer, uint offset, uint sizeBytes, byte[] data, RenderingDevice.BarrierMask postBarrier);

Обновляет область размером size_bytes байт, начиная с offset, в буфере с указанными data. Выводит ошибку, если:

• область, указанная offset + size_bytes, превышает буфер
• в данный момент активен список отрисовки (создан RenderingDevice.DrawListBegin)
• в данный момент активен список вычислений (создан RenderingDevice.ComputeListBegin)

public Error BufferUpdate(Rid buffer, uint offset, uint sizeBytes, ReadOnlySpan<byte> data);

Обновляет область размером size_bytes байт, начиная с offset, в буфере с указанными data. Выводит ошибку, если:

• область, указанная offset + size_bytes, превышает буфер
• в данный момент активен список отрисовки (создан RenderingDevice.DrawListBegin)
• в данный момент активен список вычислений (создан RenderingDevice.ComputeListBegin)

public Error BufferUpdate(Rid buffer, uint offset, uint sizeBytes, ReadOnlySpan<byte> data, RenderingDevice.BarrierMask postBarrier);

Обновляет область размером size_bytes байт, начиная с offset, в буфере с указанными data. Выводит ошибку, если:

• область, указанная offset + size_bytes, превышает буфер
• в данный момент активен список отрисовки (создан RenderingDevice.DrawListBegin)
• в данный момент активен список вычислений (создан RenderingDevice.ComputeListBegin)

public void CaptureTimestamp(string name);

Создает маркер временной метки с указанным name. Используется для отчетов о производительности с методами RenderingDevice.GetCapturedTimestampCpuTime, RenderingDevice.GetCapturedTimestampGpuTime и RenderingDevice.GetCapturedTimestampName.

public void ComputeListAddBarrier(long computeList);

Повышает вычислительный барьер Vulkan в указанном compute_list.

public long ComputeListBegin();

Начинает запись compute list в потоке устройства. Одновременно допускается один активный compute list; после привязки pipeline и ресурсов завершите запись через ComputeListEnd.

public long ComputeListBegin(bool allowDrawOverlap);

Начинает список команд вычислений, созданных с помощью методов compute_*. Возвращаемое значение должно быть передано другим функциям compute_list_*. Нельзя одновременно создавать несколько списков вычислений; сначала необходимо завершить предыдущий список вычислений с помощью RenderingDevice.ComputeListEnd. Простая операция вычислений может выглядеть следующим образом (код не является полным примером):

public void ComputeListBindComputePipeline(long computeList, Rid computePipeline);

Привязывает compute pipeline того же устройства к активному списку. До dispatch также задайте совместимые наборы ресурсов и требуемые шейдером параметры.

public void ComputeListBindUniformSet(long computeList, Rid uniformSet, uint setIndex);

Привязывает uniform set к номеру set активного compute pipeline. setIndex соответствует GLSL set, а не RDUniform.Binding; layout должен быть совместим с шейдером pipeline.

public void ComputeListDispatch(long computeList, uint xGroups, uint yGroups, uint zGroups);

Записывает запуск указанного числа рабочих групп, не отдельных потоков. Числа групп должны быть положительными и укладываться в лимиты устройства; неполную последнюю группу ограничивайте проверкой индекса в шейдере.

public void ComputeListDispatchIndirect(long computeList, Rid buffer, uint offset);

Отправляет список вычислений для обработки на GPU с заданными числами групп, сохраненными в buffer по адресу offset. Буфер должен быть создан с флагом RenderingDevice.StorageBufferUsage.Indirect.

public void ComputeListEnd();

Завершает запись активного compute list. Это не ожидание GPU: локальное устройство требует отправки Submit и подходящей синхронизации до использования результата на CPU.

public void ComputeListEnd(RenderingDevice.BarrierMask postBarrier);

Завершает список команд вычисления, созданных с помощью методов compute_*.

public void ComputeListSetPushConstant(long computeList, byte[] buffer, uint sizeBytes);

Устанавливает данные константы push в buffer для указанного compute_list. Шейдер определяет, как используются эти двоичные данные. Размер буфера в байтах также должен быть указан в size_bytes (его можно получить, вызвав метод PackedByteArray.size для переданного buffer).

public void ComputeListSetPushConstant(long computeList, ReadOnlySpan<byte> buffer, uint sizeBytes);

Устанавливает данные константы push в buffer для указанного compute_list. Шейдер определяет, как используются эти двоичные данные. Размер буфера в байтах также должен быть указан в size_bytes (его можно получить, вызвав метод PackedByteArray.size для переданного buffer).

public Rid ComputePipelineCreate(Rid shader, Reckfell.Collections.Array<RDPipelineSpecializationConstant> specializationConstants = null);

Создаёт compute pipeline из compute-шейдера того же устройства. Обычный графический шейдер не подходит. Pipeline можно повторно использовать с совместимыми наборами ресурсов.

public bool ComputePipelineIsValid(Rid computePipeline);

Возвращает true, если вычислительный конвейер, указанный RID compute_pipeline, действителен, в противном случае — false.

public RenderingDevice CreateLocalDevice();

Создайте новый локальный RenderingDevice. Это наиболее полезно для выполнения вычислительных операций на GPU независимо от остального движка.

public void DrawCommandBeginLabel(string name, Color color);

Создайте область метки отладки буфера команд, которая может отображаться в сторонних инструментах, таких как RenderDoc(https://renderdoc.org/). Все области должны заканчиваться вызовом RenderingDevice.DrawCommandEndLabel. При просмотре линейной серии отправок в одну очередь вызовы RenderingDevice.DrawCommandBeginLabel и RenderingDevice.DrawCommandEndLabel должны быть согласованы и сбалансированы. Расширение Vulkan VK_EXT_DEBUG_UTILS_EXTENSION_NAME должно быть доступно и включено для работы области метки отладки буфера команд. См. также RenderingDevice.DrawCommandEndLabel.

public void DrawCommandEndLabel();

Завершает область метки отладки буфера команд, начатую вызовом RenderingDevice.DrawCommandBeginLabel.

public void DrawCommandInsertLabel(string name, Color color);

Этот метод ничего не даёт.

public long DrawListBegin(Rid framebuffer, RenderingDevice.DrawFlags drawFlags = RenderingDevice.DrawFlags.DefaultAll, Color[] clearColorValues = null, float clearDepthValue = 1f, uint clearStencilValue = 0, Rect2? region = default, uint breadcrumb = 0);

Начинает список команд растрового рисования, созданных с помощью методов draw_*. Возвращаемое значение должно быть передано другим функциям draw_list_*. Нельзя одновременно создавать несколько списков рисования; сначала необходимо завершить предыдущий список рисования с помощью RenderingDevice.DrawListEnd. Простая операция рисования может выглядеть так (код не является полным примером):

draw_flags указывает, следует ли очищать или игнорировать прикрепленные текстуры буфера кадра. Для каждого отдельного прикрепления можно использовать только один из двух флагов. Игнорирование прикрепления означает, что любое содержимое, существовавшее до списка отрисовки, будет полностью отброшено, что снижает пропускную способность памяти, используемую проходом рендеринга, но приводит к мусорным результатам, если пиксели не заменяются. Поведение по умолчанию позволяет движку определять правильную операцию для использования, если текстура отбрасывается, что может привести к повышению производительности. См. RDTextureFormat или RenderingDevice.TextureSetDiscardable. Параметр breadcrumb может быть произвольным 32-битным целым числом, полезным для диагностики сбоев GPU. Если Reckfell собран в режиме разработки или отладки; при сбое GPU Reckfell выведет дамп всех шейдеров, которые выполнялись во время сбоя, а breadcrumb полезен для диагностики того, к каким проходам относятся эти шейдеры. Он не влияет на поведение рендеринга и может быть установлен на 0. Рекомендуется использовать перечисления RenderingDevice.BreadcrumbMarker для согласованности, но это не обязательно. Также возможно использовать побитовые операции для добавления дополнительных данных. Пример:

rd.draw_list_begin(fb[i], RenderingDevice.CLEAR_COLOR_ALL, clear_colors, true, 1.0f, true, 0, Rect2(), RenderingDevice.OPAQUE_PASS | 5)

public long DrawListBegin(Rid framebuffer, RenderingDevice.DrawFlags drawFlags, ReadOnlySpan<Color> clearColorValues, float clearDepthValue, uint clearStencilValue, Rect2? region, uint breadcrumb);

Начинает список команд растрового рисования, созданных с помощью методов draw_*. Возвращаемое значение должно быть передано другим функциям draw_list_*. Нельзя одновременно создавать несколько списков рисования; сначала необходимо завершить предыдущий список рисования с помощью RenderingDevice.DrawListEnd. Простая операция рисования может выглядеть так (код не является полным примером):

draw_flags указывает, следует ли очищать или игнорировать прикрепленные текстуры буфера кадра. Для каждого отдельного прикрепления можно использовать только один из двух флагов. Игнорирование прикрепления означает, что любое содержимое, существовавшее до списка отрисовки, будет полностью отброшено, что снижает пропускную способность памяти, используемую проходом рендеринга, но приводит к мусорным результатам, если пиксели не заменяются. Поведение по умолчанию позволяет движку определять правильную операцию для использования, если текстура отбрасывается, что может привести к повышению производительности. См. RDTextureFormat или RenderingDevice.TextureSetDiscardable. Параметр breadcrumb может быть произвольным 32-битным целым числом, полезным для диагностики сбоев GPU. Если Reckfell собран в режиме разработки или отладки; при сбое GPU Reckfell выведет дамп всех шейдеров, которые выполнялись во время сбоя, а breadcrumb полезен для диагностики того, к каким проходам относятся эти шейдеры. Он не влияет на поведение рендеринга и может быть установлен на 0. Рекомендуется использовать перечисления RenderingDevice.BreadcrumbMarker для согласованности, но это не обязательно. Также возможно использовать побитовые операции для добавления дополнительных данных. Пример:

rd.draw_list_begin(fb[i], RenderingDevice.CLEAR_COLOR_ALL, clear_colors, true, 1.0f, true, 0, Rect2(), RenderingDevice.OPAQUE_PASS | 5)

public long DrawListBegin(Rid framebuffer, RenderingDevice.InitialAction initialColorAction, RenderingDevice.FinalAction finalColorAction, RenderingDevice.InitialAction initialDepthAction, RenderingDevice.FinalAction finalDepthAction, Color[] clearColorValues, float clearDepth, uint clearStencil, Rect2? region);

Начинает список команд растрового рисования, созданных с помощью методов draw_*. Возвращаемое значение должно быть передано другим функциям draw_list_*. Нельзя одновременно создавать несколько списков рисования; сначала необходимо завершить предыдущий список рисования с помощью RenderingDevice.DrawListEnd. Простая операция рисования может выглядеть так (код не является полным примером):

draw_flags указывает, следует ли очищать или игнорировать прикрепленные текстуры буфера кадра. Для каждого отдельного прикрепления можно использовать только один из двух флагов. Игнорирование прикрепления означает, что любое содержимое, существовавшее до списка отрисовки, будет полностью отброшено, что снижает пропускную способность памяти, используемую проходом рендеринга, но приводит к мусорным результатам, если пиксели не заменяются. Поведение по умолчанию позволяет движку определять правильную операцию для использования, если текстура отбрасывается, что может привести к повышению производительности. См. RDTextureFormat или RenderingDevice.TextureSetDiscardable. Параметр breadcrumb может быть произвольным 32-битным целым числом, полезным для диагностики сбоев GPU. Если Reckfell собран в режиме разработки или отладки; при сбое GPU Reckfell выведет дамп всех шейдеров, которые выполнялись во время сбоя, а breadcrumb полезен для диагностики того, к каким проходам относятся эти шейдеры. Он не влияет на поведение рендеринга и может быть установлен на 0. Рекомендуется использовать перечисления RenderingDevice.BreadcrumbMarker для согласованности, но это не обязательно. Также возможно использовать побитовые операции для добавления дополнительных данных. Пример:

rd.draw_list_begin(fb[i], RenderingDevice.CLEAR_COLOR_ALL, clear_colors, true, 1.0f, true, 0, Rect2(), RenderingDevice.OPAQUE_PASS | 5)

public long DrawListBegin(Rid framebuffer, RenderingDevice.InitialAction initialColorAction, RenderingDevice.FinalAction finalColorAction, RenderingDevice.InitialAction initialDepthAction, RenderingDevice.FinalAction finalDepthAction, Color[] clearColorValues, float clearDepth, uint clearStencil, Rect2? region, Reckfell.Collections.Array storageTextures);

Начинает список команд растрового рисования, созданных с помощью методов draw_*. Возвращаемое значение должно быть передано другим функциям draw_list_*. Нельзя одновременно создавать несколько списков рисования; сначала необходимо завершить предыдущий список рисования с помощью RenderingDevice.DrawListEnd. Простая операция рисования может выглядеть так (код не является полным примером):

draw_flags указывает, следует ли очищать или игнорировать прикрепленные текстуры буфера кадра. Для каждого отдельного прикрепления можно использовать только один из двух флагов. Игнорирование прикрепления означает, что любое содержимое, существовавшее до списка отрисовки, будет полностью отброшено, что снижает пропускную способность памяти, используемую проходом рендеринга, но приводит к мусорным результатам, если пиксели не заменяются. Поведение по умолчанию позволяет движку определять правильную операцию для использования, если текстура отбрасывается, что может привести к повышению производительности. См. RDTextureFormat или RenderingDevice.TextureSetDiscardable. Параметр breadcrumb может быть произвольным 32-битным целым числом, полезным для диагностики сбоев GPU. Если Reckfell собран в режиме разработки или отладки; при сбое GPU Reckfell выведет дамп всех шейдеров, которые выполнялись во время сбоя, а breadcrumb полезен для диагностики того, к каким проходам относятся эти шейдеры. Он не влияет на поведение рендеринга и может быть установлен на 0. Рекомендуется использовать перечисления RenderingDevice.BreadcrumbMarker для согласованности, но это не обязательно. Также возможно использовать побитовые операции для добавления дополнительных данных. Пример:

rd.draw_list_begin(fb[i], RenderingDevice.CLEAR_COLOR_ALL, clear_colors, true, 1.0f, true, 0, Rect2(), RenderingDevice.OPAQUE_PASS | 5)

public long DrawListBegin(Rid framebuffer, RenderingDevice.InitialAction initialColorAction, RenderingDevice.FinalAction finalColorAction, RenderingDevice.InitialAction initialDepthAction, RenderingDevice.FinalAction finalDepthAction, Color[] clearColorValues, float clearDepth, uint clearStencil, Rect2? region, Reckfell.Collections.Array<Rid> storageTextures);

Начинает список команд растрового рисования, созданных с помощью методов draw_*. Возвращаемое значение должно быть передано другим функциям draw_list_*. Нельзя одновременно создавать несколько списков рисования; сначала необходимо завершить предыдущий список рисования с помощью RenderingDevice.DrawListEnd. Простая операция рисования может выглядеть так (код не является полным примером):

draw_flags указывает, следует ли очищать или игнорировать прикрепленные текстуры буфера кадра. Для каждого отдельного прикрепления можно использовать только один из двух флагов. Игнорирование прикрепления означает, что любое содержимое, существовавшее до списка отрисовки, будет полностью отброшено, что снижает пропускную способность памяти, используемую проходом рендеринга, но приводит к мусорным результатам, если пиксели не заменяются. Поведение по умолчанию позволяет движку определять правильную операцию для использования, если текстура отбрасывается, что может привести к повышению производительности. См. RDTextureFormat или RenderingDevice.TextureSetDiscardable. Параметр breadcrumb может быть произвольным 32-битным целым числом, полезным для диагностики сбоев GPU. Если Reckfell собран в режиме разработки или отладки; при сбое GPU Reckfell выведет дамп всех шейдеров, которые выполнялись во время сбоя, а breadcrumb полезен для диагностики того, к каким проходам относятся эти шейдеры. Он не влияет на поведение рендеринга и может быть установлен на 0. Рекомендуется использовать перечисления RenderingDevice.BreadcrumbMarker для согласованности, но это не обязательно. Также возможно использовать побитовые операции для добавления дополнительных данных. Пример:

rd.draw_list_begin(fb[i], RenderingDevice.CLEAR_COLOR_ALL, clear_colors, true, 1.0f, true, 0, Rect2(), RenderingDevice.OPAQUE_PASS | 5)

public long DrawListBegin(Rid framebuffer, RenderingDevice.InitialAction initialColorAction, RenderingDevice.FinalAction finalColorAction, RenderingDevice.InitialAction initialDepthAction, RenderingDevice.FinalAction finalDepthAction, Color[] clearColorValues, float clearDepth, uint clearStencil, Rect2? region, uint breadcrumb);

Начинает список команд растрового рисования, созданных с помощью методов draw_*. Возвращаемое значение должно быть передано другим функциям draw_list_*. Нельзя одновременно создавать несколько списков рисования; сначала необходимо завершить предыдущий список рисования с помощью RenderingDevice.DrawListEnd. Простая операция рисования может выглядеть так (код не является полным примером):

draw_flags указывает, следует ли очищать или игнорировать прикрепленные текстуры буфера кадра. Для каждого отдельного прикрепления можно использовать только один из двух флагов. Игнорирование прикрепления означает, что любое содержимое, существовавшее до списка отрисовки, будет полностью отброшено, что снижает пропускную способность памяти, используемую проходом рендеринга, но приводит к мусорным результатам, если пиксели не заменяются. Поведение по умолчанию позволяет движку определять правильную операцию для использования, если текстура отбрасывается, что может привести к повышению производительности. См. RDTextureFormat или RenderingDevice.TextureSetDiscardable. Параметр breadcrumb может быть произвольным 32-битным целым числом, полезным для диагностики сбоев GPU. Если Reckfell собран в режиме разработки или отладки; при сбое GPU Reckfell выведет дамп всех шейдеров, которые выполнялись во время сбоя, а breadcrumb полезен для диагностики того, к каким проходам относятся эти шейдеры. Он не влияет на поведение рендеринга и может быть установлен на 0. Рекомендуется использовать перечисления RenderingDevice.BreadcrumbMarker для согласованности, но это не обязательно. Также возможно использовать побитовые операции для добавления дополнительных данных. Пример:

rd.draw_list_begin(fb[i], RenderingDevice.CLEAR_COLOR_ALL, clear_colors, true, 1.0f, true, 0, Rect2(), RenderingDevice.OPAQUE_PASS | 5)

public long DrawListBegin(Rid framebuffer, RenderingDevice.InitialAction initialColorAction, RenderingDevice.FinalAction finalColorAction, RenderingDevice.InitialAction initialDepthAction, RenderingDevice.FinalAction finalDepthAction, ReadOnlySpan<Color> clearColorValues, float clearDepth, uint clearStencil, Rect2? region);

Начинает список команд растрового рисования, созданных с помощью методов draw_*. Возвращаемое значение должно быть передано другим функциям draw_list_*. Нельзя одновременно создавать несколько списков рисования; сначала необходимо завершить предыдущий список рисования с помощью RenderingDevice.DrawListEnd. Простая операция рисования может выглядеть так (код не является полным примером):

draw_flags указывает, следует ли очищать или игнорировать прикрепленные текстуры буфера кадра. Для каждого отдельного прикрепления можно использовать только один из двух флагов. Игнорирование прикрепления означает, что любое содержимое, существовавшее до списка отрисовки, будет полностью отброшено, что снижает пропускную способность памяти, используемую проходом рендеринга, но приводит к мусорным результатам, если пиксели не заменяются. Поведение по умолчанию позволяет движку определять правильную операцию для использования, если текстура отбрасывается, что может привести к повышению производительности. См. RDTextureFormat или RenderingDevice.TextureSetDiscardable. Параметр breadcrumb может быть произвольным 32-битным целым числом, полезным для диагностики сбоев GPU. Если Reckfell собран в режиме разработки или отладки; при сбое GPU Reckfell выведет дамп всех шейдеров, которые выполнялись во время сбоя, а breadcrumb полезен для диагностики того, к каким проходам относятся эти шейдеры. Он не влияет на поведение рендеринга и может быть установлен на 0. Рекомендуется использовать перечисления RenderingDevice.BreadcrumbMarker для согласованности, но это не обязательно. Также возможно использовать побитовые операции для добавления дополнительных данных. Пример:

rd.draw_list_begin(fb[i], RenderingDevice.CLEAR_COLOR_ALL, clear_colors, true, 1.0f, true, 0, Rect2(), RenderingDevice.OPAQUE_PASS | 5)

public long DrawListBegin(Rid framebuffer, RenderingDevice.InitialAction initialColorAction, RenderingDevice.FinalAction finalColorAction, RenderingDevice.InitialAction initialDepthAction, RenderingDevice.FinalAction finalDepthAction, ReadOnlySpan<Color> clearColorValues, float clearDepth, uint clearStencil, Rect2? region, Reckfell.Collections.Array<Rid> storageTextures);

Начинает список команд растрового рисования, созданных с помощью методов draw_*. Возвращаемое значение должно быть передано другим функциям draw_list_*. Нельзя одновременно создавать несколько списков рисования; сначала необходимо завершить предыдущий список рисования с помощью RenderingDevice.DrawListEnd. Простая операция рисования может выглядеть так (код не является полным примером):

draw_flags указывает, следует ли очищать или игнорировать прикрепленные текстуры буфера кадра. Для каждого отдельного прикрепления можно использовать только один из двух флагов. Игнорирование прикрепления означает, что любое содержимое, существовавшее до списка отрисовки, будет полностью отброшено, что снижает пропускную способность памяти, используемую проходом рендеринга, но приводит к мусорным результатам, если пиксели не заменяются. Поведение по умолчанию позволяет движку определять правильную операцию для использования, если текстура отбрасывается, что может привести к повышению производительности. См. RDTextureFormat или RenderingDevice.TextureSetDiscardable. Параметр breadcrumb может быть произвольным 32-битным целым числом, полезным для диагностики сбоев GPU. Если Reckfell собран в режиме разработки или отладки; при сбое GPU Reckfell выведет дамп всех шейдеров, которые выполнялись во время сбоя, а breadcrumb полезен для диагностики того, к каким проходам относятся эти шейдеры. Он не влияет на поведение рендеринга и может быть установлен на 0. Рекомендуется использовать перечисления RenderingDevice.BreadcrumbMarker для согласованности, но это не обязательно. Также возможно использовать побитовые операции для добавления дополнительных данных. Пример:

rd.draw_list_begin(fb[i], RenderingDevice.CLEAR_COLOR_ALL, clear_colors, true, 1.0f, true, 0, Rect2(), RenderingDevice.OPAQUE_PASS | 5)

public long DrawListBegin(Rid framebuffer, RenderingDevice.InitialAction initialColorAction, RenderingDevice.FinalAction finalColorAction, RenderingDevice.InitialAction initialDepthAction, RenderingDevice.FinalAction finalDepthAction, ReadOnlySpan<Color> clearColorValues, float clearDepth, uint clearStencil, Rect2? region, uint breadcrumb);

Начинает список команд растрового рисования, созданных с помощью методов draw_*. Возвращаемое значение должно быть передано другим функциям draw_list_*. Нельзя одновременно создавать несколько списков рисования; сначала необходимо завершить предыдущий список рисования с помощью RenderingDevice.DrawListEnd. Простая операция рисования может выглядеть так (код не является полным примером):

draw_flags указывает, следует ли очищать или игнорировать прикрепленные текстуры буфера кадра. Для каждого отдельного прикрепления можно использовать только один из двух флагов. Игнорирование прикрепления означает, что любое содержимое, существовавшее до списка отрисовки, будет полностью отброшено, что снижает пропускную способность памяти, используемую проходом рендеринга, но приводит к мусорным результатам, если пиксели не заменяются. Поведение по умолчанию позволяет движку определять правильную операцию для использования, если текстура отбрасывается, что может привести к повышению производительности. См. RDTextureFormat или RenderingDevice.TextureSetDiscardable. Параметр breadcrumb может быть произвольным 32-битным целым числом, полезным для диагностики сбоев GPU. Если Reckfell собран в режиме разработки или отладки; при сбое GPU Reckfell выведет дамп всех шейдеров, которые выполнялись во время сбоя, а breadcrumb полезен для диагностики того, к каким проходам относятся эти шейдеры. Он не влияет на поведение рендеринга и может быть установлен на 0. Рекомендуется использовать перечисления RenderingDevice.BreadcrumbMarker для согласованности, но это не обязательно. Также возможно использовать побитовые операции для добавления дополнительных данных. Пример:

rd.draw_list_begin(fb[i], RenderingDevice.CLEAR_COLOR_ALL, clear_colors, true, 1.0f, true, 0, Rect2(), RenderingDevice.OPAQUE_PASS | 5)

public long DrawListBeginForScreen(int screen = 0, Color? clearColor = default);

Высокоуровневый вариант RenderingDevice.DrawListBegin, с параметрами, автоматически настраиваемыми для рисования в окне, указанном идентификатором screen. Примечание: Не может использоваться с локальными RenderingDevices, так как у них нет экрана. При вызове на локальном RenderingDevice RenderingDevice.DrawListBeginForScreen возвращает RenderingDevice.InvalidId.

public long[] DrawListBeginSplit(Rid framebuffer, uint splits, RenderingDevice.InitialAction initialColorAction, RenderingDevice.FinalAction finalColorAction, RenderingDevice.InitialAction initialDepthAction, RenderingDevice.FinalAction finalDepthAction, Color[] clearColorValues = null, float clearDepth = 1f, uint clearStencil = 0, Rect2? region = default, Reckfell.Collections.Array<Rid> storageTextures = null);

Этот метод ничего не делает и всегда возвращает пустой long[].

public long[] DrawListBeginSplit(Rid framebuffer, uint splits, RenderingDevice.InitialAction initialColorAction, RenderingDevice.FinalAction finalColorAction, RenderingDevice.InitialAction initialDepthAction, RenderingDevice.FinalAction finalDepthAction, ReadOnlySpan<Color> clearColorValues, float clearDepth, uint clearStencil, Rect2? region, Reckfell.Collections.Array<Rid> storageTextures);

Этот метод ничего не делает и всегда возвращает пустой long[].

public void DrawListBindIndexArray(long drawList, Rid indexArray);

Связывает index_array с указанным draw_list.

public void DrawListBindRenderPipeline(long drawList, Rid renderPipeline);

Связывает render_pipeline с указанным draw_list.

public void DrawListBindUniformSet(long drawList, Rid uniformSet, uint setIndex);

Связывает uniform_set с указанным draw_list. Также необходимо указать set_index, который представляет собой идентификатор, начинающийся с 0, который должен соответствовать ожидаемому списку отрисовки.

public void DrawListBindVertexArray(long drawList, Rid vertexArray);

Связывает vertex_array с указанным draw_list.

public void DrawListBindVertexBuffersFormat(long drawList, long vertexFormat, uint vertexCount, Reckfell.Collections.Array<Rid> vertexBuffers, long[] offsets = null);

Привязывает набор из vertex_buffers непосредственно к указанному draw_list с использованием vertex_format без создания RID массива вершин. Укажите количество вершин в vertex_count; также могут быть указаны необязательные байты для каждого буфера offsets.

public void DrawListBindVertexBuffersFormat(long drawList, long vertexFormat, uint vertexCount, Reckfell.Collections.Array<Rid> vertexBuffers, ReadOnlySpan<long> offsets);

Привязывает набор из vertex_buffers непосредственно к указанному draw_list с использованием vertex_format без создания RID массива вершин. Укажите количество вершин в vertex_count; также могут быть указаны необязательные байты для каждого буфера offsets.

public void DrawListDisableScissor(long drawList);

Удаляет и отключает прямоугольник ножниц для указанного draw_list. См. также RenderingDevice.DrawListEnableScissor.

public void DrawListDraw(long drawList, bool useIndices, uint instances, uint proceduralVertexCount = 0);

Отправляет draw_list для рендеринга на GPU. Это растровый эквивалент RenderingDevice.ComputeListDispatch.

public void DrawListDrawIndirect(long drawList, bool useIndices, Rid buffer, uint offset = 0, uint drawCount = 1, uint stride = 0);

Отправляет draw_list для рендеринга на GPU с заданными параметрами, сохраненными в buffer по адресу offset. Параметры являются целыми числами: количество вершин, количество экземпляров, первая вершина, первый экземпляр. А при использовании индексов: количество индексов, количество экземпляров, первый индекс, смещение вершин, первый экземпляр. Буфер должен быть создан с флагом RenderingDevice.StorageBufferUsage.Indirect.

public void DrawListEnableScissor(long drawList, Rect2? rect = default);

Создает прямоугольник-ножницы и включает его для указанного draw_list. Прямоугольники-ножницы используются для обрезки путем отбрасывания фрагментов, которые выходят за пределы указанной прямоугольной части экрана. См. также RenderingDevice.DrawListDisableScissor. Примечание: Указанный rect автоматически пересекается с размерами экрана, что означает, что он не может превышать размеры экрана.

public void DrawListEnd();

Завершает список команд растрового рисования, созданных с помощью методов draw_*.

public void DrawListEnd(RenderingDevice.BarrierMask postBarrier);

Завершает список команд растрового рисования, созданных с помощью методов draw_*.

public void DrawListSetBlendConstants(long drawList, Color color);

Устанавливает константы смешивания для указанного draw_list в color. Константы смешивания используются только в том случае, если графический конвейер создан с установленным флагом RenderingDevice.PipelineDynamicStateFlags.BlendConstants.

public void DrawListSetPushConstant(long drawList, byte[] buffer, uint sizeBytes);

Устанавливает данные константы push в buffer для указанного draw_list. Шейдер определяет, как используются эти двоичные данные. Размер буфера в байтах также должен быть указан в size_bytes (его можно получить, вызвав метод PackedByteArray.size для переданного buffer).

public void DrawListSetPushConstant(long drawList, ReadOnlySpan<byte> buffer, uint sizeBytes);

Устанавливает данные константы push в buffer для указанного draw_list. Шейдер определяет, как используются эти двоичные данные. Размер буфера в байтах также должен быть указан в size_bytes (его можно получить, вызвав метод PackedByteArray.size для переданного buffer).

public long DrawListSwitchToNextPass();

Переключается на следующий проход розыгрыша.

public long[] DrawListSwitchToNextPassSplit(uint splits);

Этот метод ничего не делает и всегда возвращает пустой long[].

public Rid FramebufferCreate(Reckfell.Collections.Array<Rid> textures, long validateWithFormat = -1, uint viewCount = 1);

Создаёт новый рам-бюффер. Доступ к нему можно получить с помощью RID ..вернёмся. Как только закончите с вашим RIDВы захотите освободить RID с использованием RenderingDevice's RenderingDevice.FreeRid Метод. Это будет автоматически освобождено, когда любой из textures освободился.

public Rid FramebufferCreateEmpty(Vector2I size, RenderingDevice.TextureSamples samples = RenderingDevice.TextureSamples.Samples1, long validateWithFormat = -1);

Создает новый пустой буфер кадра. К нему можно получить доступ с помощью возвращаемого RID. После завершения работы с RID вам нужно будет освободить RID с помощью метода RenderingDevice.FreeRid RenderingDevice.

public Rid FramebufferCreateMultipass(Reckfell.Collections.Array<Rid> textures, Reckfell.Collections.Array<RDFramebufferPass> passes, long validateWithFormat = -1, uint viewCount = 1);

Создать новый многопассный рамкабуффер. Доступ к нему можно получить с помощью RID ..вернёмся. Как только закончите с вашим RIDВы захотите освободить RID с использованием RenderingDevice's RenderingDevice.FreeRid Метод. Это будет автоматически освобождено, когда любой из textures освободился.

public long FramebufferFormatCreate(Reckfell.Collections.Array<RDAttachmentFormat> attachments, uint viewCount = 1);

Создать новый формат makebuffer с указанным attachments и view_count. Возвращает уникальный идентификатор формата рамбуффера. Если view_count больше или равно 2, позволяет мультивидение, которое используется для VR-просмотра. Это требует поддержки для расширения Мультивидение Vulkan.

public long FramebufferFormatCreateEmpty(RenderingDevice.TextureSamples samples = RenderingDevice.TextureSamples.Samples1);

Создает новый пустой формат буфера кадра с указанным числом samples и возвращает его идентификатор.

public long FramebufferFormatCreateMultipass(Reckfell.Collections.Array<RDAttachmentFormat> attachments, Reckfell.Collections.Array<RDFramebufferPass> passes, uint viewCount = 1);

Создать формат многопассажирского рамного буффера с указанным форматом attachments, passes и view_count и возвращает ID. view_count больше или равно 2, позволяет мультивидение, которое используется для VR-просмотра. Это требует поддержки для расширения Мультивидение Vulkan.

public RenderingDevice.TextureSamples FramebufferFormatGetTextureSamples(long format, uint renderPass = 0);

Возвращает количество образцов текстуры, используемых для заданного идентификатора буфера кадра format (возвращается RenderingDevice.FramebufferGetFormat).

public long FramebufferGetFormat(Rid framebuffer);

Возвращает идентификатор формата буфера кадра, заданного RID framebuffer. Этот идентификатор гарантированно уникален для тех же форматов и не требует освобождения.

public bool FramebufferIsValid(Rid framebuffer);

Возвращает true, если буфер кадра, указанный в RID framebuffer, действителен, в противном случае — false.

public void FreeRid(Rid rid);

Освобождает принадлежащий этому RenderingDevice ресурс. Учитывайте зависимости и завершение работы; не используйте освобождённый RID. Ненулевой Rid.IsValid сам по себе не доказывает, что ресурс ещё существует.

public void FullBarrier();

Этот метод ничего не даёт.

public ulong GetCapturedTimestampCpuTime(uint index);

Возвращает временную метку в процессорном времени для шага рендеринга, указанного index (в микросекундах с момента запуска движка). См. также RenderingDevice.GetCapturedTimestampGpuTime и RenderingDevice.CaptureTimestamp.

public ulong GetCapturedTimestampGpuTime(uint index);

Возвращает время в времени GPU для этапа отображения, указанного index (в наносекундах с момента запуска двигателя). См. также RenderingDevice.GetCapturedTimestampCpuTime и RenderingDevice.CaptureTimestamp.

public string GetCapturedTimestampName(uint index);

Возвращает имя временной метки для шага рендеринга, указанного index. См. также RenderingDevice.CaptureTimestamp.

public uint GetCapturedTimestampsCount();

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

public ulong GetCapturedTimestampsFrame();

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

public ulong GetDeviceAllocationCount();

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

public ulong GetDeviceAllocsByObjectType(uint type);

То же, что и RenderingDevice.GetDeviceAllocationCount, но отфильтровано для заданного типа объекта. Аргумент типа должен быть в диапазоне [RenderingDevice.GetTrackedObjectTypeCount`](/ru/docs/api/renderingdevice#member-gettrackedobjecttypecount-6ea83230eb) равен 0, то аргумент типа игнорируется и всегда возвращает 0. Это используется только Vulkan в отладочных сборках и может возвращать 0, когда эта информация не отслеживается или неизвестна.

public ulong GetDeviceMemoryByObjectType(uint type);

То же, что и RenderingDevice.GetDeviceTotalMemory, но отфильтровано для заданного типа объекта. Аргумент типа должен быть в диапазоне [RenderingDevice.GetTrackedObjectTypeCount`](/ru/docs/api/renderingdevice#member-gettrackedobjecttypecount-6ea83230eb) равен 0, то аргумент типа игнорируется и всегда возвращает 0. Это используется только Vulkan в отладочных сборках и может возвращать 0, когда эта информация не отслеживается или неизвестна.

public string GetDeviceName();

Возвращает имя видеоадаптера (например, "GeForce GTX 1080/PCIe/SSE2"). Эквивалентно RenderingServer.GetVideoAdapterName. См. также RenderingDevice.GetDeviceVendorName.

public string GetDevicePipelineCacheUuid();

Возвращает универсальный уникальный идентификатор для кэша конвейера. Он используется для кэширования файлов шейдеров на диске, что позволяет избежать перекомпиляции шейдеров при последующих запусках движка. Этот UUID зависит от модели видеокарты, а также от версии драйвера. Поэтому обновление графических драйверов сделает кэш шейдеров недействительным.

public ulong GetDeviceTotalMemory();

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

public string GetDeviceVendorName();

Возвращает поставщика видеоадаптера (например, "Корпорация NVIDIA"). Эквивалентно RenderingServer.GetVideoAdapterVendor. См. также RenderingDevice.GetDeviceName.

public ulong GetDriverAllocationCount();

Возвращает количество выделений, выполненных драйвером GPU для внутренних структур драйвера. Используется Vulkan только в отладочных сборках и может возвращать 0, если эта информация не отслеживается или неизвестна.

public ulong GetDriverAllocsByObjectType(uint type);

То же, что и RenderingDevice.GetDriverAllocationCount, но отфильтровано для заданного типа объекта. Аргумент типа должен быть в диапазоне [RenderingDevice.GetTrackedObjectTypeCount`](/ru/docs/api/renderingdevice#member-gettrackedobjecttypecount-6ea83230eb) равен 0, то аргумент типа игнорируется и всегда возвращает 0. Это используется только Vulkan в отладочных сборках и может возвращать 0, когда эта информация не отслеживается или неизвестна.

public string GetDriverAndDeviceMemoryReport();

Возвращает строковый отчет в формате CSV, используя следующие методы:

• RenderingDevice.GetTrackedObjectName
• RenderingDevice.GetTrackedObjectTypeCount
• RenderingDevice.GetDriverTotalMemory
• RenderingDevice.GetDriverAllocationCount
• RenderingDevice.GetDriverMemoryByObjectType
• RenderingDevice.GetDriverAllocsByObjectType
• RenderingDevice.GetDeviceTotalMemory
• RenderingDevice.GetDeviceAllocationCount
• RenderingDevice.GetDeviceMemoryByObjectType
• RenderingDevice.GetDeviceAllocsByObjectType Это используется только Vulkan в отладочных сборках. Reckfell также должен быть запущен с --extra-gpu-memory-tracking Командный аргумент.

public ulong GetDriverMemoryByObjectType(uint type);

То же, что и RenderingDevice.GetDriverTotalMemory, но отфильтровано для заданного типа объекта. Аргумент типа должен быть в диапазоне [RenderingDevice.GetTrackedObjectTypeCount`](/ru/docs/api/renderingdevice#member-gettrackedobjecttypecount-6ea83230eb) равен 0, то аргумент типа игнорируется и всегда возвращает 0. Это используется только Vulkan в отладочных сборках и может возвращать 0, когда эта информация не отслеживается или неизвестна.

public ulong GetDriverResource(RenderingDevice.DriverResource resource, Rid rid, ulong index);

Возвращает уникальный ID идентификатор драйвера resource для указанного rid. Некоторые типы ресурсов драйвера игнорируют указанный rid. index всегда игнорируется, но должен быть указан в любом случае.

public ulong GetDriverTotalMemory();

Возвращает, сколько байтов драйвер GPU использует для внутренних структур драйвера. Используется только Vulkan в отладочных сборках и может возвращать 0, если эта информация не отслеживается или неизвестна.

public uint GetFrameDelay();

Возвращает количество кадров, хранящееся в графическом API. Более высокие значения приводят к более высокой задержке ввода, но с более стабильной пропускной способностью. Для основного RenderingDevice кадры циклически повторяются (обычно 3 с включенной тройной буферизацией V-Sync). Однако локальные RenderingDevice имеют только 1 кадр.

public ulong GetMemoryUsage(RenderingDevice.MemoryType type);

Возвращает использование памяти в байтах, соответствующих указанному type. При использовании Vulkan эта статистика рассчитывается с помощью Отправитель памяти Вулкана.

public string GetPerfReport();

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

public string GetTrackedObjectName(uint typeIndex);

Возвращает имя типа объекта для заданного type_index. Это значение должно быть в диапазоне [RenderingDevice.GetTrackedObjectTypeCount](/ru/docs/api/renderingdevice#member-gettrackedobjecttypecount-6ea83230eb) равен 0, то аргумент type игнорируется и всегда возвращает одну и ту же строку. Возвращаемое значение важно, поскольку оно придает смысл типам, переданным в [RenderingDevice.GetDriverMemoryByObjectType](/ru/docs/api/renderingdevice#member-getdrivermemorybyobjecttype-f8ed5453a7), [RenderingDevice.GetDriverAllocsByObjectType](/ru/docs/api/renderingdevice#member-getdriverallocsbyobjecttype-0caddbe283), [RenderingDevice.GetDeviceMemoryByObjectType](/ru/docs/api/renderingdevice#member-getdevicememorybyobjecttype-3861f5f55f) и [RenderingDevice.GetDeviceAllocsByObjectType`](/ru/docs/api/renderingdevice#member-getdeviceallocsbyobjecttype-341591375f). Примеры строк, которые он может возвращать (не исчерпывающие):

• DEVICE_MEMORY
• PIPELINE_CACHE
• SWAPCHAIN_KHR
• COMMAND_POOL Таким образом, если, например, get_tracked_object_name(5) возвращает "COMMAND_POOL", затем get_device_memory_by_object_type(5) возвращает байты, используемые GPU для пулов команд. Это используется только Vulkan в отладочных сборках. Reckfell также должен быть запущен с --extra-gpu-memory-tracking аргументом командной строки.

public ulong GetTrackedObjectTypeCount();

Возвращает количество типов отслеживаемых объектов. Используется только Vulkan в отладочных сборках. Reckfell также должен быть запущен с --extra-gpu-memory-tracking аргументом командной строки.

public bool HasFeature(RenderingDevice.Features feature);

Возвращает true, если feature поддерживается графическим процессором.

public Rid HitSbtCreate(Rid raytracingPipeline, uint initialHitGroupCapacity);

Создаёт новую связную таблицу хит-тенера (SBT). RID ..вернёмся. Как только закончите с вашим RIDВы захотите освободить RID с использованием RenderingDevice's RenderingDevice.FreeRid Метод. Это будет автоматически освобождено, когда raytracing_pipeline освободился. Поражённый SBT переизменяется по мере необходимости. initial_hit_group_capacity используется для передачи первоначальной памяти поддержки.

public long HitSbtRangeAlloc(Rid hitSbt, uint hitGroupCount);

Выделяет непрерывный диапазон записей SBT из hit_sbt. Возвращаемое значение должно быть присвоено RDAccelerationStructureInstance.HitSbtRange. Во время трассировки лучей индекс группы попаданий вычисляется как: (индекс геометрии в RDAccelerationStructureInstance.Blas) × (шаг SBT, используемый в traceRayEXT)

• (смещение SBT, используемое в traceRayEXT)
• (смещение диапазона) hit_group_count должно быть достаточно большим, чтобы покрыть все записи SBT, которые могут быть проиндексированы этим уравнением. Обычно это соответствует: (количество геометрий в RDAccelerationStructureInstance.Blas) × (шаг SBT, используемый в traceRayEXT) Выделенный диапазон не инициализирован и должен быть заполнен с помощью RenderingDevice.HitSbtRangeUpdate.

public Error HitSbtRangeFree(Rid hitSbt, long range);

Освобождает диапазон SBT попаданий, ранее выделенный с помощью RenderingDevice.HitSbtRangeAlloc. После освобождения диапазон не должен использоваться какой-либо структурой ускорения.

public Error HitSbtRangeUpdate(Rid hitSbt, long range, uint offset, int[] hitGroupIndices);

Обновляет содержимое диапазона SBT попаданий. hit_group_indices задаёт индексы в массиве групп попаданий, предоставленном в RenderingDevice.RaytracingPipelineCreate. Параметр offset определяет, с какого места в выделенном диапазоне начинается запись. Это позволяет выполнять частичные обновления диапазона. Однако полный диапазон должен быть полностью инициализирован перед использованием в диспетчеризации трассировки лучей.

public Error HitSbtRangeUpdate(Rid hitSbt, long range, uint offset, ReadOnlySpan<int> hitGroupIndices);

Обновляет содержимое диапазона SBT попаданий. hit_group_indices задаёт индексы в массиве групп попаданий, предоставленном в RenderingDevice.RaytracingPipelineCreate. Параметр offset определяет, с какого места в выделенном диапазоне начинается запись. Это позволяет выполнять частичные обновления диапазона. Однако полный диапазон должен быть полностью инициализирован перед использованием в диспетчеризации трассировки лучей.

public Error HitSbtSetPipeline(Rid hitSbt, Rid raytracingPipeline);

Устанавливает новый raytracing_pipeline для hit_sbt. Новый конвейер должен быть надмножеством предыдущего. Существующие группы попаданий должны сохранять тот же порядок, а новые группы попаданий должны добавляться в конец. Это сохраняет существующие записи SBT. Предыдущий конвейер должен оставаться действительным во время вызова.

public Rid IndexArrayCreate(Rid indexBuffer, uint indexOffset, uint indexCount);

Создать новый индексный массив. Доступ к нему можно получить с помощью RID ..вернёмся. Как только закончите с вашим RIDВы захотите освободить RID с использованием RenderingDevice's RenderingDevice.FreeRid Метод. Это будет автоматически освобождено, когда index_buffer освободился.

public Rid IndexBufferCreate(uint sizeIndices, RenderingDevice.IndexBufferFormat format, byte[] data, bool useRestartIndices);

Создает новый буфер индекса. К нему можно получить доступ с помощью возвращаемого RID. После завершения работы с RID вам нужно будет освободить RID с помощью метода RenderingDevice.FreeRid RenderingDevice.

public Rid IndexBufferCreate(uint sizeIndices, RenderingDevice.IndexBufferFormat format, byte[] data = null, bool useRestartIndices = false, RenderingDevice.BufferCreationBits creationBits = (RenderingDevice.BufferCreationBits)0);

Создает новый буфер индекса. К нему можно получить доступ с помощью возвращаемого RID. После завершения работы с RID вам нужно будет освободить RID с помощью метода RenderingDevice.FreeRid RenderingDevice.

public Rid IndexBufferCreate(uint sizeIndices, RenderingDevice.IndexBufferFormat format, ReadOnlySpan<byte> data, bool useRestartIndices);

Создает новый буфер индекса. К нему можно получить доступ с помощью возвращаемого RID. После завершения работы с RID вам нужно будет освободить RID с помощью метода RenderingDevice.FreeRid RenderingDevice.

public Rid IndexBufferCreate(uint sizeIndices, RenderingDevice.IndexBufferFormat format, ReadOnlySpan<byte> data, bool useRestartIndices, RenderingDevice.BufferCreationBits creationBits);

Создает новый буфер индекса. К нему можно получить доступ с помощью возвращаемого RID. После завершения работы с RID вам нужно будет освободить RID с помощью метода RenderingDevice.FreeRid RenderingDevice.

public ulong LimitGet(RenderingDevice.Limit limit);

Запрашивает аппаратное ограничение активного устройства. Например, MaxTextureSize2D задаёт предел размера 2D-текстуры, но не обещает успешное выделение ресурса этого размера. Значения зависят от устройства и драйвера; не являются текущим остатком памяти или общим пределом всех типов текстур.

public long RaytracingListBegin();

Запускает список команд трассировки лучей. Возвращаемое значение должно передаваться в другие функции raytracing_list_*. Нельзя создавать несколько списков трассировки одновременно; сначала необходимо завершить предыдущий список с помощью RenderingDevice.RaytracingListEnd. Простая операция трассировки лучей может выглядеть так (код не является полным примером):

public void RaytracingListBindRaytracingPipeline(long raytracingList, Rid raytracingPipeline);

Привязывает raytracing_pipeline к указанному raytracing_list.

public void RaytracingListBindUniformSet(long raytracingList, Rid uniformSet, uint setIndex);

Привязывает uniform_set к этому raytracing_list.

public void RaytracingListEnd();

Завершает список команд трассировки, созданный с помощью методов raytracing_*.

public void RaytracingListSetPushConstant(long raytracingList, byte[] buffer, uint sizeBytes);

Устанавливает данные константы push в buffer для указанного raytracing_list. Шейдер определяет, как используются эти двоичные данные. Размер буфера в байтах также должен быть указан в size_bytes (его можно получить, вызвав метод PackedByteArray.size для переданного buffer).

public void RaytracingListSetPushConstant(long raytracingList, ReadOnlySpan<byte> buffer, uint sizeBytes);

Устанавливает данные константы push в buffer для указанного raytracing_list. Шейдер определяет, как используются эти двоичные данные. Размер буфера в байтах также должен быть указан в size_bytes (его можно получить, вызвав метод PackedByteArray.size для переданного buffer).

public void RaytracingListTraceRays(long raytracingList, uint raygenShaderIndex, Rid hitSbt, uint width, uint height, uint depth);

Инициализирует диспетчеризацию трассировки лучей для raytracing_list, запуская width × height × depth лучей. raygen_shader_index выбирает шейдер генерации лучей из конвейера, привязанного с помощью RenderingDevice.RaytracingListBindRaytracingPipeline. hit_sbt должен использовать тот же конвейер, который привязан к raytracing_list.

public Rid RaytracingPipelineCreate(Reckfell.Collections.Array<RDPipelineShader> raygenShaders, Reckfell.Collections.Array<RDPipelineShader> missShaders, Reckfell.Collections.Array<RDHitGroup> hitGroups, uint maxTraceRecursionDepth);

Создаёт новый трассирующий трубопровод. RID ..вернёмся. Как только закончите с вашим RIDВы захотите освободить RID с использованием RenderingDevice's RenderingDevice.FreeRid Метод. Каждый из них должен обеспечивать требуемую стадию. На всех этапах должны использоваться совместимые конфигурации трубопровода. Input Последовательность определяет стабильные индексы, используемые API:

• raygen_shaders индексируется в RenderingDevice.RaytracingListTraceRays.
• miss_shaders индексируется в traceRayEXT.
• hit_groups индексируется в RenderingDevice.HitSbtRangeUpdate.

public bool RaytracingPipelineIsValid(Rid raytracingPipeline);

Возвращает true, если конвейер трассировки, указанный в raytracing_pipeline RID, действителен, в противном случае false.

public Rid RenderPipelineCreate(Rid shader, long framebufferFormat, long vertexFormat, RenderingDevice.RenderPrimitive primitive, RDPipelineRasterizationState rasterizationState, RDPipelineMultisampleState multisampleState, RDPipelineDepthStencilState stencilState, RDPipelineColorBlendState colorBlendState, RenderingDevice.PipelineDynamicStateFlags dynamicStateFlags = (RenderingDevice.PipelineDynamicStateFlags)0, uint forRenderPass = 0, Reckfell.Collections.Array<RDPipelineSpecializationConstant> specializationConstants = null);

Создаёт новый трубопровод для дорожки. RID ..вернёмся. Как только закончите с вашим RIDВы захотите освободить RID с использованием RenderingDevice's RenderingDevice.FreeRid Метод. Это будет автоматически освобождено, когда shader освободился.

public bool RenderPipelineIsValid(Rid renderPipeline);

Возвращает true, если конвейер рендеринга, указанный в render_pipeline RID, действителен, в противном случае false.

public Rid SamplerCreate(RDSamplerState state);

Создает новый сэмплер. К нему можно получить доступ с помощью возвращаемого RID. После завершения работы с RID вам нужно будет освободить RID с помощью метода RenderingDevice.FreeRid RenderingDevice.

public bool SamplerIsFormatSupportedForFilter(RenderingDevice.DataFormat format, RenderingDevice.SamplerFilter samplerFilter);

Возвращает true, если реализация поддерживает использование текстуры format с заданным sampler_filter.

public long ScreenGetFramebufferFormat();

Возвращает формат буфера кадра заданного экрана. Примечание: Только основной RenderingDevice, возвращаемый RenderingServer.GetRenderingDevice, имеет формат. При вызове на локальном RenderingDevice этот метод выводит ошибку и возвращает RenderingDevice.InvalidId.

public long ScreenGetFramebufferFormat(int screen = 0);

Возвращает формат буфера кадра заданного экрана. Примечание: Только основной RenderingDevice, возвращаемый RenderingServer.GetRenderingDevice, имеет формат. При вызове на локальном RenderingDevice этот метод выводит ошибку и возвращает RenderingDevice.InvalidId.

public int ScreenGetHeight(int screen = 0);

Возвращает высоту окна, соответствующую графическому API-контексту для заданного идентификатора окна (в пикселях). Несмотря на то, что параметр назван screen, он возвращает размер window. См. также RenderingDevice.ScreenGetWidth. Примечание: Только основной RenderingDevice, возвращаемый RenderingServer.GetRenderingDevice, имеет высоту. При вызове на локальном RenderingDevice этот метод выводит ошибку и возвращает RenderingDevice.InvalidId.