qcapsuleshape.cpp

Go to the documentation of this file.

// Copyright (C) 2021 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
// Qt-Security score:significant reason:default
 
#include "qcapsuleshape_p.h"
 
#include <QtQuick3D/QQuick3DGeometry>
#include <geometry/PxCapsuleGeometry.h>
 
QT_BEGIN_NAMESPACE
 
/*!
    \qmltype CapsuleShape
    \inherits CollisionShape
    \inqmlmodule QtQuick3D.Physics
    \since 6.4
    \brief Defines a pill-like shape.
 
    This type defines a capsule shape. This is a cylinder with a hemisphere at each end.
    The origin is at the center of the capsule. The capsule is specified by \l diameter, which
    determines the diameter of the cylinder and the hemispheres; and \l height, which
    determines the height of the cylinder.
 
    \note When using scaling transformations with this shape, the x component will be used to scale the height and
    the y component will be used to scale the diameter. The cylinder will always be perfectly circular even if the
    scaling transformation is non-uniform.
 
    \sa {Qt Quick 3D Physics Shapes, Bodies and Joints}
*/
 
/*!
    \qmlproperty real CapsuleShape::diameter
    This property defines the diameter of the capsule
 
    Default value: \c{100}
*/
 
/*!
    \qmlproperty real CapsuleShape::height
    This property defines the height of the capsule
 
    Default value: \c{100}
*/
 
QCapsuleShape::QCapsuleShape() = default;
 
QCapsuleShape::~QCapsuleShape()
{
    delete m_physXGeometry;
}
 
physx::PxGeometry *QCapsuleShape::getPhysXGeometry()
{
    if (!m_physXGeometry || m_scaleDirty) {
        updatePhysXGeometry();
    }
 
    return m_physXGeometry;
}
 
float QCapsuleShape::diameter() const
{
    return m_diameter;
}
 
void QCapsuleShape::setDiameter(float newDiameter)
{
    if (!qIsFinite(newDiameter) || newDiameter <= 0.f) {
        qWarning() << "CapsuleShape: diameter must be finite and greater than zero, ignoring"
                   << newDiameter;
        return;
    }
 
    if (qFuzzyCompare(m_diameter, newDiameter))
        return;
    m_diameter = newDiameter;
    updatePhysXGeometry();
 
    emit needsRebuild(this);
    emit diameterChanged();
}
 
float QCapsuleShape::height() const
{
    return m_height;
}
 
void QCapsuleShape::setHeight(float newHeight)
{
    if (!qIsFinite(newHeight) || newHeight <= 0.f) {
        qWarning() << "CapsuleShape: height must be finite and greater than zero, ignoring"
                   << newHeight;
        return;
    }
 
    if (qFuzzyCompare(m_height, newHeight))
        return;
    m_height = newHeight;
    updatePhysXGeometry();
 
    emit needsRebuild(this);
    emit heightChanged();
}
 
void QCapsuleShape::updatePhysXGeometry()
{
    delete m_physXGeometry;
    m_physXGeometry = nullptr;
    m_scaleDirty = false;
 
    QVector3D s = sceneScale();
    const float radius = s.y() * m_diameter * 0.5f;
    const float halfHeight = s.x() * m_height * 0.5f;
    if (!qIsFinite(radius) || radius <= 0.f || !qIsFinite(halfHeight) || halfHeight <= 0.f) {
        qWarning() << "CapsuleShape: scaled radius/height must be finite and greater than "
                      "zero, ignoring.";
        return;
    }
    m_physXGeometry = new physx::PxCapsuleGeometry(radius, halfHeight);
}
 
QT_END_NAMESPACE