InterfaceApplies a material variant to an entity hierarchy.
The entity root to which material variants will be applied.
Optionalname: stringThe name of the variant, as queried from getMaterialVariants, if null the variant will be reset to the default.
// load a glb file and instantiate an entity with a render component based on it
app.assets.loadFromUrl("statue.glb", "container", function (err, asset) {
const entity = asset.resource.instantiateRenderEntity({
castShadows: true
});
app.root.addChild(entity);
const materialVariants = asset.resource.getMaterialVariants();
asset.resource.applyMaterialVariant(entity, materialVariants[0]);
Applies a material variant to a set of mesh instances. Compared to the applyMaterialVariant, this method allows for setting the variant on a specific set of mesh instances instead of the whole entity.
An array of mesh instances.
Optionalname: stringThe name of the variant, as queried by getMaterialVariants. If null, the variant will be reset to the default.
// load a glb file and instantiate an entity with a render component based on it
app.assets.loadFromUrl("statue.glb", "container", function (err, asset) {
const entity = asset.resource.instantiateRenderEntity({
castShadows: true
});
app.root.addChild(entity);
const materialVariants = asset.resource.getMaterialVariants();
const renders = entity.findComponents("render");
for (let i = 0; i < renders.length; i++) {
const renderComponent = renders[i];
asset.resource.applyMaterialVariantInstances(renderComponent.meshInstances, materialVariants[0]);
}
Queries the list of available material variants.
An array of variant names.
Instantiates an entity with a model component.
Optionaloptions: anyThe initialization data for the model component type ModelComponent.
A single entity with a model component. Model component internally contains a hierarchy based on GraphNode.
Instantiates an entity with a render component.
Optionaloptions: anyThe initialization data for the render component type RenderComponent.
A hierarchy of entities with render components on entities containing renderable geometry.
// load a glb file and instantiate an entity with a render component based on it
app.assets.loadFromUrl("statue.glb", "container", function (err, asset) {
const entity = asset.resource.instantiateRenderEntity({
castShadows: true
});
app.root.addChild(entity);
// find all render components containing mesh instances, and change blend mode on their materials
const renders = entity.findComponents("render");
renders.forEach(function (render) {
render.meshInstances.forEach(function (meshInstance) {
meshInstance.material.blendType = pc.BLEND_MULTIPLICATIVE;
meshInstance.material.update();
});
});
});
Container for a list of animations, textures, materials, renders and a model.