En esta página

Qt Quick 3D: ejemplo de material basado en principios

Muestra el uso de los materiales basados en principios.

Vista previa del material con panel de control y controles deslizantes de propiedades

Este ejemplo sirve como documentación interactiva sobre el uso de « PrincipledMaterial ». Cada propiedad de « PrincipledMaterial » incluye una explicación sobre cómo se utiliza, así como una forma de experimentar con el ajuste de cada propiedad.

Uso

Este ejemplo se divide en dos vistas: la documentación interactiva y los controles a la izquierda, y el visor 3D a la derecha. El visor 3D es interactivo, lo que permite girar la cámara alrededor del modelo de interés. Para volver a enfocar un modelo concreto, basta con tocar o hacer clic en el modelo que se desee enfocar. La división entre las dos vistas se puede ajustar arrastrando la barra situada entre ellas.

El ejemplo se divide en varias secciones que agrupan las distintas características de « PrincipledMaterial » en partes manejables. Se puede acceder a cada sección haciendo clic en las pestañas situadas en la parte superior del área de explicación.

SpecularGlossyMaterial

Además de mostrar el flujo de trabajo PBR de Metalness/Roughness que ofrece PrincipledMaterial, es posible cambiar al flujo de trabajo Specular/Glossy, que utiliza el « SpecularGlossyMaterial ». Esto se puede hacer mediante un selector en la sección «Basics».

Cargador de recursos

La mayor complejidad de este ejemplo también brinda la oportunidad de demostrar el uso del componente « ResourceLoader ». Cuando un modelo deja de ser visible en la escena, Qt Quick 3D liberará todos los recursos asociados a dicho modelo (siempre que ninguno de esos recursos sea utilizado por otros modelos de la escena). En este ejemplo, es posible ocultar el modelo de la cortina y, al hacerlo, se liberarían 2 mallas y 2 texturas de la memoria de la GPU. Sin embargo, la próxima vez que la cortina se haga visible, estos recursos tendrían que volver a cargarse en la GPU. En algunos equipos, esta carga puede provocar una caída momentánea de la tasa de fotogramas, por lo que, para mitigar esto, se utiliza un componente « ResourceLoader » dentro del componente «BackgroundCurtain».

ResourceLoader {
    meshSources: [
        frame.source,
        curtain.source
    ]
    textures: [
        tilePatternTexture,
        curtainNormalTexture
    ]
}

Model {
    id: frame
    z: -1.95
    source: "meshes/frame.mesh"

    PrincipledMaterial {
        id: frame_material
        baseColor: "#ffcccccc"
        metalness: 1
        roughness: 0.259091
        alphaMode: PrincipledMaterial.Opaque
    }
    materials: [
        frame_material
    ]
}
Model {
    id: curtain
    y: 3.02413
    z: 2.04922
    source: "meshes/curtain.mesh"

    PrincipledMaterial {
        id: curtain_material
        baseColorMap: Texture {
            id: tilePatternTexture
            source: "maps/tilepattern.png"
            generateMipmaps: true
            mipFilter: Texture.Linear
        }
        opacityChannel: Material.A
        roughness: 0.5
        normalMap: Texture {
            id: curtainNormalTexture
            source: "maps/curtain_normal.jpg"
            generateMipmaps: true
            mipFilter: Texture.Linear
        }
        cullMode: Material.NoCulling
        alphaMode: PrincipledMaterial.Opaque
    }
    materials: [
        curtain_material
    ]
}

Aquí, tanto los archivos de malla como las texturas se registran mediante « ResourceLoader ». « ResourceLoader » garantiza que cualquier recurso registrado esté siempre listo para su uso en la memoria de la GPU, por lo que, independientemente de la visibilidad de «BackgroundCurtain», sus recursos se conservarán.

El método `ResourceLoaded` también se puede utilizar para precargar recursos, tal y como se muestra con las mallas de puntos y líneas en la pestaña «Special».

ResourceLoader {
    meshSources: [
        "meshes/logo_lines.mesh",
        "meshes/logo_points.mesh"
    ]
}

Aquí se enumeran directamente los « QUrl » de los archivos de malla. No es necesario que los recursos estén asociados a un «Model» para que un « ResourceLoader » pueda utilizarlos.

Proyecto de ejemplo en code.qt.io

© 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.