이 페이지에서

Qt3DCore::QSkeletonLoader Class

class Qt3DCore::QSkeletonLoader

파일에서 관절 스켈레톤을 불러오는 데 사용됩니다. 더 보기...

헤더: #include <QSkeletonLoader>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3DCore)
target_link_libraries(mytarget PRIVATE Qt6::3DCore)
qmake: QT += 3dcore
QML에서: SkeletonLoader
상속: Qt3DCore::QAbstractSkeleton
상태: 사용 중단됨

이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.

공개 유형

enum Status { NotReady, Ready, Error }

속성

공개 함수

QSkeletonLoader(Qt3DCore::QNode *parent = nullptr)
QSkeletonLoader(const QUrl &source, Qt3DCore::QNode *parent = nullptr)
bool isCreateJointsEnabled() const
Qt3DCore::QJoint *rootJoint() const
QUrl source() const
Qt3DCore::QSkeletonLoader::Status status() const

공개 슬롯

void setCreateJointsEnabled(bool enabled)
void setSource(const QUrl &source)

신호

void createJointsEnabledChanged(bool createJointsEnabled)
void rootJointChanged(Qt3DCore::QJoint *rootJoint)
void sourceChanged(const QUrl &source)
void statusChanged(Qt3DCore::QSkeletonLoader::Status status)

상세 설명

'Skeleton' 및 'Joints'를 사용하여 관절을 직접 생성하는 대신 파일에서 전체 스켈레톤을 불러오려면 ` SkeletonLoader `를 사용하십시오. 스켈레톤을 생성하고 메쉬의 정점을 스켈레톤에 바인딩하는 작업은 Blender와 같은 3D 디지털 콘텐츠 제작 도구에서 수행하는 것이 가장 쉽습니다. 이렇게 생성된 스켈레톤과 메쉬는 glTF 2와 같은 적절한 형식으로 내보내어 Qt 3D 에서 사용할 수 있습니다.

멤버 유형 문서

enum QSkeletonLoader::Status

이 열거형은 스켈레톤의 상태를 나타냅니다.

상수값설명
Qt3DCore::QSkeletonLoader::NotReady0스켈레톤이 아직 로드되지 않았습니다
Qt3DCore::QSkeletonLoader::Ready1스켈레톤이 성공적으로 로드됨
Qt3DCore::QSkeletonLoader::Error2스켈레톤을 불러오는 과정에서 오류가 발생했습니다

속성 설명

createJointsEnabled : bool

이 속성은 createJoints가 활성화되었는지 여부를 나타내는 부울 값을 저장합니다.

액세스 함수:

bool isCreateJointsEnabled() const
void setCreateJointsEnabled(bool enabled)

Notifier 신호:

void createJointsEnabledChanged(bool createJointsEnabled)

[read-only] rootJoint : Qt3DCore::QJoint*

이 속성은 골격을 구성하는 관절 계층 구조의 루트 관절을 저장합니다.

소스에서 불러온 스켈레톤 계층 구조의 루트 조인트를 저장합니다.

액세스 함수:

Qt3DCore::QJoint *rootJoint() const

알림 신호:

void rootJointChanged(Qt3DCore::QJoint *rootJoint)

source : QUrl

스켈레톤을 불러올 소스 URL을 저장합니다.

액세스 함수:

QUrl source() const
void setSource(const QUrl &source)

알림 신호:

void sourceChanged(const QUrl &source)

[read-only] status : Status

스켈레톤 로딩의 현재 상태를 보관합니다.

액세스 함수:

Qt3DCore::QSkeletonLoader::Status status() const

알림 신호:

void statusChanged(Qt3DCore::QSkeletonLoader::Status status)

멤버 함수 문서

[explicit] QSkeletonLoader::QSkeletonLoader(Qt3DCore::QNode *parent = nullptr)

parent 를 사용하여 새로운 QSkeletonLoader를 생성합니다.

[explicit] QSkeletonLoader::QSkeletonLoader(const QUrl &source, Qt3DCore::QNode *parent = nullptr)

parent 를 사용하여 새로운 QSkeletonLoader를 생성하고, source 을 설정합니다.

bool QSkeletonLoader::isCreateJointsEnabled() const

CreateJoints가 활성화되었는지 여부를 나타내는 부울 값을 반환합니다. 기본값은 ` false`입니다.

참고: createJointsEnabled 속성에 대한게터 함수입니다.

Qt3DCore::QJoint *QSkeletonLoader::rootJoint() const

골격을 구성하는 조인트 계층 구조의 루트 조인트를 반환합니다.

참고: rootJoint 속성에 대한게터 함수입니다.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.