Тип QML AbstractRayCaster

Абстрактный базовый класс для расчета лучей в 3d-сценах. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• filterMode : перечисление
• hits : массив
• runMode : перечисление

Подробное описание

AbstractRayCaster — абстрактный базовый класс для расчета лучей в 3d-сцене. AbstractRayCaster не может быть непосредственно создан, а только через свои подклассы. QAbstractRayCaster определяет общие свойства для всех расчётчиков лучей, такие как режим работы и обработка слоёв, оставляя детали фактического расчета лучей подклассам.

Расчет лучей отличается от выбора (используя ObjectPicker) тем, что не требует событий мыши для запуска.

По умолчанию экземпляры AbstractRayCaster отключены. При включении указанный луч будет проверен на пересечение с объектами в каждом кадре. Свойство AbstractRayCaster.hits будет обновлено результатами расчета лучей, даже если объекты не найдены.

Qt3D.Render::PickingSettings может использоваться для управления расчетом лучей, например, для выбора проверяемых примитивов и способов возврата результатов.

Кроме того, компоненты Qt3D.Render::Layer могут использоваться для управления тем, как сущности или подграфы сущностей реагируют на расчёт лучей.

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

См. также Qt3D.Render::RayCaster, Qt3D.Render::ScreenRayCaster, Qt3D.Render::ObjectPicker, Qt3D.Render::PickingSettings и Qt3D.Render::NoPicking.

Документация по свойствам

filterMode : перечисление

Содержит режим фильтрации, определяющий сущности для выбора в тестах расчета лучей.

Значение по умолчанию — AbstractRayCaster.AcceptMatchingLayers.

hits : массив

Содержит результаты последнего теста расчета лучей в виде массива javascript-объектов. Поля, определённые в объектах, определены ниже.

{
    type // enum value of RayCasterHit.HitType
    entity // entity that was intersected
    distance // distance from ray origin to intersection
    localIntersection.x: // coordinate of intersection in the entity's coordinate system
    localIntersection.y
    localIntersection.z
    worldIntersection.x // coordinate of intersection in the model's coordinate system
    worldIntersection.y
    worldIntersection.z
    primitiveIndex // index of the primitive (triangle, line, point) that was intersected;
                   // (undefined if the picking mode is set to bounding volume)
    vertex1Index // index of the first point of the triangle or line that was intersected
                 // (undefined if the picking mode is set to bounding volume or points)
    vertex2Index // index of the second point of the triangle or line that was intersected
                 // (undefined if the picking mode is set to bounding volume or points)
    vertex3Index // index of the second point of the triangle that was intersected
                 // (undefined if the picking mode is set to bounding volume, points or lines)
}

Обратите внимание, что даже если последовательные тесты возвращают точно такие же результаты (или пустые результаты), уведомление об изменении будет отправлено в каждом тесте.

runMode : перечисление

Содержит режим работы, контролирующий частоту выполнения тестов расчета лучей.