mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2026-01-05 14:10:19 +03:00
197 lines
11 KiB
ReStructuredText
197 lines
11 KiB
ReStructuredText
:github_url: hide
|
||
|
||
.. _class_GLTFBufferView:
|
||
|
||
GLTFBufferView
|
||
==============
|
||
|
||
**Наследует:** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
|
||
|
||
Представляет - представление буфера glTF.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Описание
|
||
----------------
|
||
|
||
GLTFBufferView — это структура данных, представляющая glTF ``bufferView``, которая будет найдена в массиве ``"bufferViews"``. Буфер — это блок двоичных данных. Представление буфера — это срез буфера, который можно использовать для идентификации и извлечения данных из буфера.
|
||
|
||
Для большинства пользовательских применений буферов требуется использовать только :ref:`buffer<class_GLTFBufferView_property_buffer>`, :ref:`byte_length<class_GLTFBufferView_property_byte_length>` и :ref:`byte_offset<class_GLTFBufferView_property_byte_offset>`. Свойства :ref:`byte_stride<class_GLTFBufferView_property_byte_stride>` и :ref:`indexes<class_GLTFBufferView_property_indexes>` предназначены для более сложных случаев использования, таких как данные сетки с чередованием, закодированные для GPU.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Обучающие материалы
|
||
--------------------------------------
|
||
|
||
- `Буферы, BufferViews и Accessors в спецификации Khronos glTF <https://github.com/KhronosGroup/glTF-Tutorials/blob/master/gltfTutorial/gltfTutorial_005_BuffersBufferViewsAccessors.md>`__
|
||
|
||
- :doc:`Загрузка и сохранение файла времени выполнения <../tutorials/io/runtime_file_loading_and_saving>`
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Свойства
|
||
----------------
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+-------------------------+---------------------------------------------------------------------------+-----------+
|
||
| :ref:`int<class_int>` | :ref:`buffer<class_GLTFBufferView_property_buffer>` | ``-1`` |
|
||
+-------------------------+---------------------------------------------------------------------------+-----------+
|
||
| :ref:`int<class_int>` | :ref:`byte_length<class_GLTFBufferView_property_byte_length>` | ``0`` |
|
||
+-------------------------+---------------------------------------------------------------------------+-----------+
|
||
| :ref:`int<class_int>` | :ref:`byte_offset<class_GLTFBufferView_property_byte_offset>` | ``0`` |
|
||
+-------------------------+---------------------------------------------------------------------------+-----------+
|
||
| :ref:`int<class_int>` | :ref:`byte_stride<class_GLTFBufferView_property_byte_stride>` | ``-1`` |
|
||
+-------------------------+---------------------------------------------------------------------------+-----------+
|
||
| :ref:`bool<class_bool>` | :ref:`indices<class_GLTFBufferView_property_indices>` | ``false`` |
|
||
+-------------------------+---------------------------------------------------------------------------+-----------+
|
||
| :ref:`bool<class_bool>` | :ref:`vertex_attributes<class_GLTFBufferView_property_vertex_attributes>` | ``false`` |
|
||
+-------------------------+---------------------------------------------------------------------------+-----------+
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Методы
|
||
------------
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+-----------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+
|
||
| :ref:`PackedByteArray<class_PackedByteArray>` | :ref:`load_buffer_view_data<class_GLTFBufferView_method_load_buffer_view_data>`\ (\ state\: :ref:`GLTFState<class_GLTFState>`\ ) |const| |
|
||
+-----------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Описания свойств
|
||
--------------------------------
|
||
|
||
.. _class_GLTFBufferView_property_buffer:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`int<class_int>` **buffer** = ``-1`` :ref:`🔗<class_GLTFBufferView_property_buffer>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_buffer**\ (\ value\: :ref:`int<class_int>`\ )
|
||
- :ref:`int<class_int>` **get_buffer**\ (\ )
|
||
|
||
Индекс буфера, на который ссылается это буферное представление. Если ``-1``, это буферное представление не ссылается ни на какой буфер.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_GLTFBufferView_property_byte_length:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`int<class_int>` **byte_length** = ``0`` :ref:`🔗<class_GLTFBufferView_property_byte_length>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_byte_length**\ (\ value\: :ref:`int<class_int>`\ )
|
||
- :ref:`int<class_int>` **get_byte_length**\ (\ )
|
||
|
||
Длина, в байтах, этого буферного представления. Если ``0``, это буферное представление пусто.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_GLTFBufferView_property_byte_offset:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`int<class_int>` **byte_offset** = ``0`` :ref:`🔗<class_GLTFBufferView_property_byte_offset>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_byte_offset**\ (\ value\: :ref:`int<class_int>`\ )
|
||
- :ref:`int<class_int>` **get_byte_offset**\ (\ )
|
||
|
||
Смещение в байтах от начала буфера до начала этого представления буфера.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_GLTFBufferView_property_byte_stride:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`int<class_int>` **byte_stride** = ``-1`` :ref:`🔗<class_GLTFBufferView_property_byte_stride>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_byte_stride**\ (\ value\: :ref:`int<class_int>`\ )
|
||
- :ref:`int<class_int>` **get_byte_stride**\ (\ )
|
||
|
||
Шаг, в байтах, между чередующимися данными. Если ``-1``, это представление буфера не чередуется.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_GLTFBufferView_property_indices:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **indices** = ``false`` :ref:`🔗<class_GLTFBufferView_property_indices>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_indices**\ (\ value\: :ref:`bool<class_bool>`\ )
|
||
- :ref:`bool<class_bool>` **get_indices**\ (\ )
|
||
|
||
``true``, если тип буфера OpenGL GPU GLTFBufferView — это ``ELEMENT_ARRAY_BUFFER``, используемый для индексов вершин (целочисленная константа ``34963``). ``false``, если тип буфера — это любое другое значение. См. `Buffers, BufferViews и Accessors <https://github.com/KhronosGroup/glTF-Tutorials/blob/master/gltfTutorial/gltfTutorial_005_BuffersBufferViewsAccessors.md>`__ для возможных значений. Это свойство задается при импорте и используется при экспорте.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_GLTFBufferView_property_vertex_attributes:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **vertex_attributes** = ``false`` :ref:`🔗<class_GLTFBufferView_property_vertex_attributes>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_vertex_attributes**\ (\ value\: :ref:`bool<class_bool>`\ )
|
||
- :ref:`bool<class_bool>` **get_vertex_attributes**\ (\ )
|
||
|
||
``true``, если тип буфера OpenGL GPU GLTFBufferView — это ``ARRAY_BUFFER``, используемый для атрибутов вершин (целочисленная константа ``34962``). ``false``, если тип буфера — это любое другое значение. См. `Buffers, BufferViews и Accessors <https://github.com/KhronosGroup/glTF-Tutorials/blob/master/gltfTutorial/gltfTutorial_005_BuffersBufferViewsAccessors.md>`__ для возможных значений. Это свойство задается при импорте и используется при экспорте.
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Описания метода
|
||
------------------------------
|
||
|
||
.. _class_GLTFBufferView_method_load_buffer_view_data:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
:ref:`PackedByteArray<class_PackedByteArray>` **load_buffer_view_data**\ (\ state\: :ref:`GLTFState<class_GLTFState>`\ ) |const| :ref:`🔗<class_GLTFBufferView_method_load_buffer_view_data>`
|
||
|
||
Загружает данные представления буфера из буфера, на который ссылается это представление буфера в заданном :ref:`GLTFState<class_GLTFState>`. Перемежающиеся данные с шагом байта пока не поддерживаются этим методом. Данные возвращаются как :ref:`PackedByteArray<class_PackedByteArray>`.
|
||
|
||
.. |virtual| replace:: :abbr:`virtual (Этот метод обычно должен быть переопределен пользователем, чтобы иметь какой-либо эффект.)`
|
||
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
|
||
.. |const| replace:: :abbr:`const (Этот метод не имеет побочных эффектов. Он не изменяет ни одну из переменных-членов экземпляра.)`
|
||
.. |vararg| replace:: :abbr:`vararg (Этот метод принимает любое количество аргументов после описанных здесь.)`
|
||
.. |constructor| replace:: :abbr:`constructor (Этот метод используется для создания типа.)`
|
||
.. |static| replace:: :abbr:`static (Этот метод не нуждается в вызове экземпляра, поэтому его можно вызвать напрямую, используя имя класса.)`
|
||
.. |operator| replace:: :abbr:`operator (Этот метод описывает допустимый оператор для использования с этим типом в качестве левого операнда.)`
|
||
.. |bitfield| replace:: :abbr:`BitField (Это значение является целым числом, составленным как битовая маска следующих флагов.)`
|
||
.. |void| replace:: :abbr:`void (Нет возвращаемого значения.)`
|