qt 3d basics - kdab · everything is a qnode qt 3d ecs explained p.24 qt3dcore::qnode is the base...

Qt3DBasicsKévinOttens,SoftwareCraftsmanatKDAB

Qt3DBasics

Qt3DBasics p.2

FeatureSet

EntityComponentSystem?Kezaco?

HelloDonut

Qt3DECSExplained

InputHandling

DrawingBasics

BeyondtheTipoftheIceberg

TheFutureofQt3D

Qt3DBasics

FeatureSet p.3

FeatureSet


HelloDonut

Qt3DECSExplained

InputHandling

DrawingBasics


TheFutureofQt3D

WhatisQt3D?

FeatureSet p.4

Itisnotabout3D!

Multi-purpose,notjustagameengine

Softreal-timesimulationengine

Designedtobescalable

Extensibleandflexible

SimulationEngine

FeatureSet p.5

Thecoreisnotinherentlyabout3D

ItcandealwithseveraldomainsatonceAI,logic,audio,etc.Andofcourseitcontainsa3Drenderertoo!

AllyouneedforacomplexsystemsimulationMechanicalsystemsPhysics...andalsogames

Scalability

FeatureSet p.6

Frontend/backendsplitFrontendislightweightandonthemainthreadBackendexecutedinasecondarythreadWheretheactualsimulationruns

Non-blockingfrontend/backendcommunication

Backendmaximizesthroughputviaathreadpool

ExtensibilityandFlexibility

FeatureSet p.7

Domainscanbeaddedviaindependentaspects...onlyifthere'snotsomethingfittingyourneedsalready

ProvidebothC++andQMLAPIs

IntegrateswellwiththerestofQtPullingyoursimulationdatafromadatabaseanyone?

EntityComponentSystemisusedtocombinebehaviorinyourownobjectsNodeepinheritancehierarchy

Qt3DBasics

EntityComponentSystem?Kezaco? p.8

FeatureSet


HelloDonut

Qt3DECSExplained

InputHandling

DrawingBasics


TheFutureofQt3D

ECS:Definitions


ECSisanarchitecturalpatternPopularingameenginesFavorscompositionoverinheritance

Anentityisageneralpurposeobject

Anentitygetsitsbehaviorbycombiningdata

Datacomesfromtypedcomponents

CompositionvsInheritance


Let'sanalyseafamiliarexample:SpaceInvaders

CompositionvsInheritancecont'd


Typicalinheritancehierarchy



Allfineuntilcustomerrequiresnewfeature:



Typicalsolution:Addfeaturetobaseclass



Doesn'tscale:



Whataboutmultipleinheritance?



Whataboutmix-inmultipleinheritance?



Doesitscale?



Isinheritanceflexibleenough?



Inheritance:Relationshipsbakedinatdesigntime.Complexinheritancehierarchies:deep,wide,multipleinheritanceFeaturestendtomigratetobaseclass

EntityComponentSystemAllowschangesatruntimeAvoidsinheritancelimitationsHasadditionalcosts:MoreQObjectsDifferenttomostOOPdeveloper'sexperience

Wedon'thavetobakeinassumptionstoQt3Dthatwecan'tlaterchangewhenaddingfeatures.

Qt3DBasics

HelloDonut p.20

FeatureSet


HelloDonut

Qt3DECSExplained

InputHandling

DrawingBasics


TheFutureofQt3D

HelloDonut(QML)

HelloDonut p.21

GoodpracticehavingrootEntitytorepresentthescene

OneEntityper"object"inthescene

Objectsgivenbehaviorbyattachingcomponentsubclasses

ForanEntitytobedrawnitneeds:AmeshgeometrydescribingitsshapeAmaterialdescribingitssurfaceappearance

Demoqt3d/ex-hellodonut-qml

qmlElement://Entity

qmlElement://Entity

qmlElement://Entity

C++APIvsQMLAPI

HelloDonut p.22

QMLAPIisamirroroftheC++API

C++classnamesliketherestofQt

QMLelementnamesjustdon'thavetheQinfrontQt3DCore::QNodevsNodeQt3DCore::QEntityvsEntity...

class://Qt3DCore::QNode

qmlElement://Node

class://Qt3DCore::QEntity

qmlElement://Entity

Qt3DBasics

Qt3DECSExplained p.23

FeatureSet


HelloDonut

Qt3DECSExplained

InputHandling

DrawingBasics


TheFutureofQt3D

EverythingisaQNode


Qt3DCore::QNodeisthebasetypeforeverythingItinheritsfromQObjectandallitsfeaturesInternallyimplementsthefrontend/backendcommunication

Qt3DCore::QEntity

ItinheritsfromQt3DCore::QNodeItjustaggregatesQt3DCore::QComponents

Qt3DCore::QComponent

ItinheritsfromQt3DCore::QNodeActualdataisprovidedbyitssubclasses

Qt3DCore::QTransformQt3DRender::QMeshQt3DRender::QMaterial

...


class://QObject



class://Qt3DCore::QComponent



class://Qt3DCore::QTransform

class://Qt3DRender::QMesh

class://Qt3DRender::QMaterial

EverythingisaQNodecont'd


YouStillNeedaSystem


ThesimulationisexecutedbyQt3DCore::QAspectEngine

Qt3DCore::QAbstractAspectsubclassinstancesareregisteredontheengineBehaviorcomesfromtheaspectsprocessingcomponentdataAspectscontrolthedomainsmanipulatedbyyoursimulation

Qt3DprovidesQt3DRender::QRenderAspectQt3DInput::QInputAspectQt3DLogic::QLogicAspect

NotethataspectshavenoAPIoftheirownItisallprovidedbyQt3DCore::QComponentsubclasses

class://Qt3DCore::QAspectEngine

class://Qt3DCore::QAbstractAspect

class://Qt3DRender::QRenderAspect

class://Qt3DInput::QInputAspect

class://Qt3DLogic::QLogicAspect


Qt3DBasics

InputHandling p.27

FeatureSet


HelloDonut

Qt3DECSExplained

InputHandling

DrawingBasics


TheFutureofQt3D

PhysicalDevices

InputHandling p.28

Tohandleinputwefirstneedtogenerateinputevents

SubclassesofQt3DInput::QAbstractPhysicalDevicerepresentinputdevices

Qt3DInput::QKeyboardDeviceQt3DInput::QMouseDevice

Otherscanbeaddedlater

Onit'sownadevicedoesn'tdomuchInputhandlersexposesignalsemittedinresponsetoevents

class://Qt3DInput::QAbstractPhysicalDevice

class://Qt3DInput::QKeyboardDevice

class://Qt3DInput::QMouseDevice

Picking

InputHandling p.29

HighlevelpickingprovidedbyQt3DRender::QObjectPickercomponentImplicitlyassociatedwithmousedeviceUsesray-castbasedpicking

Qt3DRender::QObjectPickeremitssignalsforyoutohandle:pressed(),released(),clicked()

moved()-onlywhendragEnabledistrueentered(),exited()-onlywhenhoverEnabledistrue

ThecontainsMousepropertyprovidesamoredeclarativealternativetoentered(),exited()

class://Qt3DRender::QObjectPicker

class://Qt3DRender::QObjectPicker

PhysicalDevicesvsLogicalDevices

InputHandling p.30

Physicaldevicesprovideonlydiscreteevents

Hardtousethemtocontrolavalueovertime

Logicaldeviceprovidesawayto:HaveananalogviewonaphysicaldeviceAggregateseveralphysicaldevicesinaunifieddevice

LogicalInputAction

InputHandling p.31

Qt3DInput::QActionprovidesabinaryvalue

Itisactivatedbysomeinput,canbe:AsinglebuttoninputwithQt3DInput::QActionInputAsimultaneouscombinationofbuttoninputswithQt3DInput::QInputChord

AsequenceofbuttoninputswithQt3DInput::QInputSequence

Whentheactionstatechangestheactivepropertyistoggled

Demoqt3d/ex-logical-input-qml

class://Qt3DInput::QAction

class://Qt3DInput::QActionInput

class://Qt3DInput::QInputChord

class://Qt3DInput::QInputSequence

LogicalInputAxis

InputHandling p.32

Qt3DInput::QAxisprovidesananalogvaluebetween-1and1

Itvariesovertimewhensomeinputisgenerated,canbe:WhenaphysicalaxisvarieswithQt3DInput::QAnalogAxisInputWhileabuttonispressedwithQt3DInput::QButtonAxisInput

Whentheaxisstatechangesthevaluepropertychanges

Demoqt3d/ex-logical-axes-qml

class://Qt3DInput::QAxis

class://Qt3DInput::QAnalogAxisInput

class://Qt3DInput::QButtonAxisInput

PuttingitAllTogether:MovingBoxes

InputHandling p.33

Focusmanagedusingtab

Focusedboxappearsbigger

Thearrowsmovetheboxontheplane

Pageup/downrotatetheboxonitsYaxis

Boxeslightupwhenonmousehover

Clickingonaboxgivesitthefocus

Boxescanbemovedaroundwiththemouse

Demoqt3d/sol-moving-boxes-qml-step3

Qt3DBasics

DrawingBasics p.34

FeatureSet


HelloDonut

Qt3DECSExplained

InputHandling

DrawingBasics


TheFutureofQt3D

TheSceneGraph

DrawingBasics p.35

ThescenegraphprovidesthespatialrepresentationofthesimulationQt3DCore::QEntity:whattakespartinthesimulationQt3DCore::QTransform:whereitis,whatscaleitis,whatorientationithas

Hierarchicaltransformsarecontrolledbytheparent/childrelationshipSimilartoQWidget,QQuickItem,etc.

Ifthesceneisrendered,weneedapointofviewonitThisisprovidedbyQt3DRender::QCamera


class://Qt3DCore::QTransform

class://QWidget

class://QQuickItem

class://Qt3DRender::QCamera

Qt3DCore::QTransform

DrawingBasics p.36

InheritsfromQt3DCore::QComponent

Representsanaffinetransformation

Threewaysofusingit:Throughproperties:scale3D,rotation,translationThroughhelperfunctions:rotateAround()Throughthematrixproperty

Transformationsareapplied:toobjectsinScale/Rotation/TranslationordertocoordinatesystemsinTranslation/Rotation/Scaleorder

Transformationsaremultipliedalongtheparent/childrelationship


Transformscont'd

DrawingBasics p.37

1 importQt3D.Core2.023 Entity{4 components:[5 Transform{6 scale3D:Qt.vector3d(1,2,1.5)7 translation:Qt.vector3d(0,0,-1)8 }9 ]1011 Entity{12 components:[13 Transform{translation:Qt.vector3d(0,1,0)}14 ]15 }16 }

Geometries

DrawingBasics p.38

Qt3DRender::QRenderAspectdrawsQt3DCore::QEntityswithashape

Qt3DRender::QGeometryRenderer'sgeometrypropertyspecifiestheshape

Qt3DprovidesconveniencesubclassesofQt3DRender::QGeometryRenderer:

Qt3DExtras::QSphereMeshQt3DExtras::QCuboidMeshQt3DExtras::QPlaneMeshQt3DExtras::QTorusMeshQt3DExtras::QConeMeshQt3DExtras::QCylinderMesh

QtDemoexamples/qt3d/basicshapes-cpp

class://Qt3DRender::QRenderAspect


class://Qt3DRender::QGeometryRenderer

class://Qt3DRender::QGeometryRenderer

class://Qt3DExtras::QSphereMesh

class://Qt3DExtras::QCuboidMesh

class://Qt3DExtras::QPlaneMesh

class://Qt3DExtras::QTorusMesh

class://Qt3DExtras::QConeMesh

class://Qt3DExtras::QCylinderMesh

Materials

DrawingBasics p.39

IfaQt3DCore::QEntityonlyhasashapeitwillappearblack

TheQt3DRender::QMaterialcomponentprovidesasurfaceappearance

Qt3DprovidesconveniencesubclassesofQt3DRender::QMaterial:

Qt3DExtras::QPhongMaterialQt3DExtras::QPhongAlphaMaterialQt3DExtras::QDiffuseMapMaterialQt3DExtras::QDiffuseSpecularMapMaterialQt3DExtras::QGoochMaterial

...

Demoqt3d/sol-textured-scene




class://Qt3DExtras::QPhongMaterial

class://Qt3DExtras::QPhongAlphaMaterial

class://Qt3DExtras::QDiffuseMapMaterial

class://Qt3DExtras::QDiffuseSpecularMapMaterial

class://Qt3DExtras::QGoochMaterial

Lights

DrawingBasics p.40

Evenwithshapesandmaterialswewouldseenothing

Weneedsomelights...luckilyQt3Dsetsadefaultoneforusifnoneisprovided

Ingeneralwewantsomecontrolofthescenelighting

Qt3Dprovidesthefollowinglighttypes:DirectionalLightPointLightSpotLight

Labqt3d/ex-lights-qml

qmlElement://DirectionalLight

qmlElement://PointLight

qmlElement://SpotLight

Qt3DBasics

BeyondtheTipoftheIceberg p.41

FeatureSet


HelloDonut

Qt3DECSExplained

InputHandling

DrawingBasics


TheFutureofQt3D

MakingyourOwnGeometries


UsingQt3DRender::QBufferwecancreateourownvertices

GeometryRenderercontrolshowbuffersarecombinedandparsed

Usefultomakeyouowngeometriesprogrammatically:FromafunctionFromdatasetsFromuserinteraction

Demoqt3d/ex-surface-function

class://Qt3DRender::QBuffer

qmlElement://GeometryRenderer

TextureCompositionandFiltering


Possibletosampleseveraltexturesinasinglematerial

Alsoeasytoreusestocklightingmodel

Thenyoucanblendasyouseefitintheshader

Demoqt3d/sol-earth

ProceduralTextures


LotsofexamplesavailableontheInternethttps://www.shadertoy.com/

UsuallywrittenforWebGLorOpenGLES2MayrequiresomeadaptationManyarefarfromsimple!

ButtheyareeasytoplugintheMaterialsystemandtoparameterize

Demoqt3d/ex-plasma

https://www.shadertoy.com/

qmlElement://Material

IntegratingwithQtQuickusingScene3D


ProvidedbytheQtQuick.Scene3Dmodule

TakesanEntityaschildwhichwillbeyourwholescene

Loadedaspectsarecontrolledwiththeaspectsproperty

HovereventsareonlyacceptedifthehoverEnabledpropertyistrue

Demoqt3d/ex-controls-overlay

qmlElement://QtQuick.Scene3D

qmlElement://Entity

Andmore...


Layermanagement

Ownmaterialsandlightingmodels

Texturemipmaps

CubeMaps

PortabilityofyourcodeaccrossseveralOpenGLversions

Completecontrolovertherenderingalgorithm

Loadingcompleteobjectsorscenesfromfiles(3ds,collada,qml...)

Post-processingeffects(singleormulti-pass)

Instancedrendering

etc.

Demoqt3d/ex-multiple-effects

Demoqt3d/sol-asteroids

Qt3DBasics

TheFutureofQt3D p.47

FeatureSet


HelloDonut

Qt3DECSExplained

InputHandling

DrawingBasics


TheFutureofQt3D

WhatdoesthefutureholdforQt3D?


Qt3DCoreEfficiencyimprovemmentsBackendthreadpoolandjobhandlingimprovements-jobsspawningjobs

Qt3DRenderUseQtQuickorQPaintertorenderintoatextureEmbedQtQuickintoQt3DincludinginputhandlingLevelofDetail(LOD)supportformeshesBillboards-camerafacingentitiesTextsupport-2Dand3DAdditionalmaterialssuchasPhysicsBasedRendering(PBR)materialsParticlesystems

Qt3DInputAxisinputsthatapplycumulativeaxisvaluesasposition,velocityoraccelerationAdditionalinputdevicesupport3Dmousecontrollers,gamecontrollers

Enumeratedinputssuchas8-waybuttons,hatswitchesordials

WhatdoesthefutureholdforQt3D?


Newaspects:CollisionDetectionAspectAllowstodetectwhenentitiescollideorenter/exitvolumesinspace

AnimationAspectKeyframeanimationSkeletalanimationMorphtargetanimationRemovesanimationworkloadfrommainthread

PhysicsAspectRigidbodyandsoftbodyphysicssimulation

AIAspect,3DPositionalAudioAspect...

Tooling:Designtimetooling-sceneeditorBuildtimetooling-assetconditionersformeshes,texturesetc.

Thankyou!

www.kdab.com

[email protected]

qt 3d basics - kdab · everything is a qnode qt 3d ecs explained p.24 qt3dcore::qnode is the base...

Documents