@playcanvas/web-components 0.12.0 → 0.13.1

package/dist/material.d.cts

@@ -0,0 +1,1011 @@
+import { Color, StandardMaterial, Vec2 } from 'playcanvas';
+type BlendType = 'none' | 'normal' | 'additive' | 'additive-alpha' | 'premultiplied' | 'multiplicative' | 'multiplicative-2x' | 'screen' | 'min' | 'max' | 'subtractive';
+type CullMode = 'none' | 'back' | 'front' | 'front-and-back';
+type FresnelModel = 'none' | 'schlick';
+type OccludeSpecular = 'none' | 'ao' | 'gloss-dependent';
+type OpacityDither = 'none' | 'bayer8' | 'bluenoise' | 'ignnoise';
+type ColorChannel = 'r' | 'g' | 'b' | 'a' | 'rgb';
+type ScalarChannel = 'r' | 'g' | 'b' | 'a';
+/**
+ * The MaterialElement interface provides properties and methods for manipulating
+ * {@link https://developer.playcanvas.com/user-manual/web-components/tags/pc-material/ | `<pc-material>`} elements.
+ * The MaterialElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
+ *
+ * A `pc-material` must be a direct child of `pc-app` — elements placed elsewhere log a warning
+ * and never create a material. Elements inserted while the application is already running are
+ * created on insertion.
+ *
+ * The element is metal/rough by default: unlike a bare `StandardMaterial` it enables the metalness
+ * workflow, which is what the `metalness-*` attributes assume and what glTF means by PBR. It also
+ * defaults `metalness` to 0 rather than the engine's 1, because those two defaults have to be
+ * chosen together - the engine's 1 is unreachable under its own `useMetalness` of false, and with
+ * the workflow on it would make every material fully metallic, so `<pc-material diffuse="crimson">`
+ * would render as dark tinted reflections of an environment that may not exist rather than as a
+ * crimson surface. `metalness="1"` remains one attribute away.
+ *
+ * The `roughness` and `roughness-map` attributes are aliases for `gloss` and `gloss-map` that
+ * additionally invert the gloss channel; do not mix the two families on one element.
+ *
+ * The two aliases are documented here rather than on an accessor, because they resolve to the
+ * `gloss` properties and would otherwise inherit gloss's description - which reads inverted.
+ *
+ * @attribute {number} roughness - The roughness of the material, from 0 (shiny) to 1 (rough). An
+ * alias for `gloss` that also inverts it, so do not combine it with the `gloss` attributes.
+ * @attribute {string} roughness-map - The id of the `pc-asset` to use as the roughness map. An
+ * alias for `gloss-map` that also inverts the gloss channel, so do not combine it with the `gloss`
+ * attributes.
+ */
+declare class MaterialElement extends HTMLElement {
+    private _alphaTest;
+    private _alphaToCoverage;
+    private _aoIntensity;
+    private _aoMap;
+    private _aoMapChannel;
+    private _aoMapOffset;
+    private _aoMapRotation;
+    private _aoMapTiling;
+    private _aoMapUv;
+    private _blendType;
+    private _bumpiness;
+    private _cull;
+    private _depthBias;
+    private _depthTest;
+    private _depthWrite;
+    private _diffuse;
+    private _diffuseMap;
+    private _diffuseMapChannel;
+    private _diffuseMapOffset;
+    private _diffuseMapRotation;
+    private _diffuseMapTiling;
+    private _diffuseMapUv;
+    private _emissive;
+    private _emissiveIntensity;
+    private _emissiveMap;
+    private _emissiveMapChannel;
+    private _emissiveMapOffset;
+    private _emissiveMapRotation;
+    private _emissiveMapTiling;
+    private _emissiveMapUv;
+    private _enableGGXSpecular;
+    private _fresnelModel;
+    private _gloss;
+    private _glossInvert;
+    private _glossMap;
+    private _glossMapChannel;
+    private _glossMapOffset;
+    private _glossMapRotation;
+    private _glossMapTiling;
+    private _glossMapUv;
+    private _heightMap;
+    private _heightMapChannel;
+    private _heightMapFactor;
+    private _heightMapOffset;
+    private _heightMapRotation;
+    private _heightMapTiling;
+    private _heightMapUv;
+    private _metalness;
+    private _metalnessMap;
+    private _metalnessMapChannel;
+    private _metalnessMapOffset;
+    private _metalnessMapRotation;
+    private _metalnessMapTiling;
+    private _metalnessMapUv;
+    private _normalMap;
+    private _normalMapOffset;
+    private _normalMapRotation;
+    private _normalMapTiling;
+    private _normalMapUv;
+    private _occludeDirect;
+    private _occludeSpecular;
+    private _opacity;
+    private _opacityDither;
+    private _opacityFadesSpecular;
+    private _opacityMap;
+    private _opacityMapChannel;
+    private _opacityMapOffset;
+    private _opacityMapRotation;
+    private _opacityMapTiling;
+    private _opacityMapUv;
+    private _slopeDepthBias;
+    private _specular;
+    private _specularityFactor;
+    private _twoSidedLighting;
+    private _useFog;
+    private _useLighting;
+    private _useMetalness;
+    private _useMetalnessSpecularColor;
+    private _useSkybox;
+    private _useTonemap;
+    /**
+     * Pending `load` handlers, one per texture slot. A slot's handler is torn down when the slot is
+     * reassigned or the element disconnects, so a late-arriving asset can never write a texture the
+     * element no longer wants.
+     */
+    private _mapHandles;
+    private _updateScheduled;
+    private _glossConflictWarned;
+    /**
+     * The material. `null` until the containing application has created it — an element present
+     * at startup has its material once the application is ready.
+     */
+    material: StandardMaterial | null;
+    connectedCallback(): Promise<void>;
+    disconnectedCallback(): void;
+    /**
+     * Coalesces `material.update()` across a burst of attribute or property writes, so that setting
+     * a dozen attributes in one parse costs one update rather than a dozen.
+     */
+    private _scheduleUpdate;
+    /**
+     * Warns when a `roughness-*` attribute is combined with one that carries the opposite
+     * interpretation of the same value. They write the same engine properties but disagree about
+     * whether the channel is inverted, so the result would depend on attribute order rather than
+     * on intent.
+     *
+     * Called from both families rather than only from the roughness branches, because the two
+     * orderings are equally wrong and only one of them would otherwise be caught. The conflict is
+     * a property of the element rather than of any one write - and an upgrading element already
+     * has all of its attributes, so every branch would otherwise report the same clash - so the
+     * warning latches and reports once per episode, clearing when the clash is resolved.
+     */
+    private _warnGlossConflict;
+    /**
+     * Points a texture slot at the resource of a `pc-asset`, waiting for the asset to load when it
+     * has not already. An empty id clears the slot.
+     *
+     * @param id - The id of the `pc-asset`, or an empty string to clear the slot.
+     * @param slot - The material property to write.
+     */
+    private _setMap;
+    /**
+     * @param slot - The material property to write.
+     * @param texture - The loaded texture, applied with its sampler state untouched - anisotropy
+     * and friends belong to the `pc-asset`'s texture options.
+     */
+    private _applyMap;
+    /**
+     * Sets the alpha test reference value. Fragments with an opacity below this value are discarded.
+     * @param value - The alpha test reference value.
+     */
+    set alphaTest(value: number);
+    /**
+     * Gets the alpha test reference value.
+     * @returns The alpha test reference value.
+     */
+    get alphaTest(): number;
+    /**
+     * Sets whether to use alpha to coverage, which resolves transparency using multisampling.
+     * @param value - The alpha to coverage flag.
+     */
+    set alphaToCoverage(value: boolean);
+    /**
+     * Gets whether to use alpha to coverage.
+     * @returns The alpha to coverage flag.
+     */
+    get alphaToCoverage(): boolean;
+    /**
+     * Sets the strength of the ambient occlusion map, from 0 to 1.
+     * @param value - The ambient occlusion intensity.
+     */
+    set aoIntensity(value: number);
+    /**
+     * Gets the strength of the ambient occlusion map.
+     * @returns The ambient occlusion intensity.
+     */
+    get aoIntensity(): number;
+    /**
+     * Sets the id of the `pc-asset` to use as the ambient occlusion map.
+     * @param value - The asset id.
+     */
+    set aoMap(value: string);
+    /**
+     * Gets the id of the `pc-asset` used as the ambient occlusion map.
+     * @returns The asset id.
+     */
+    get aoMap(): string;
+    /**
+     * Sets the color channel of the ambient occlusion map to sample.
+     * @param value - The channel.
+     */
+    set aoMapChannel(value: ScalarChannel);
+    /**
+     * Gets the color channel of the ambient occlusion map to sample.
+     * @returns The channel.
+     */
+    get aoMapChannel(): ScalarChannel;
+    /**
+     * Sets the 2D offset of the ambient occlusion map.
+     * @param value - The offset.
+     */
+    set aoMapOffset(value: Vec2);
+    /**
+     * Gets the 2D offset of the ambient occlusion map.
+     * @returns The offset.
+     */
+    get aoMapOffset(): Vec2;
+    /**
+     * Sets the 2D rotation of the ambient occlusion map, in degrees.
+     * @param value - The rotation.
+     */
+    set aoMapRotation(value: number);
+    /**
+     * Gets the 2D rotation of the ambient occlusion map.
+     * @returns The rotation.
+     */
+    get aoMapRotation(): number;
+    /**
+     * Sets the 2D tiling of the ambient occlusion map.
+     * @param value - The tiling.
+     */
+    set aoMapTiling(value: Vec2);
+    /**
+     * Gets the 2D tiling of the ambient occlusion map.
+     * @returns The tiling.
+     */
+    get aoMapTiling(): Vec2;
+    /**
+     * Sets the UV channel the ambient occlusion map samples.
+     * @param value - The UV channel.
+     */
+    set aoMapUv(value: number);
+    /**
+     * Gets the UV channel the ambient occlusion map samples.
+     * @returns The UV channel.
+     */
+    get aoMapUv(): number;
+    /**
+     * Sets how the material is blended with the scene behind it.
+     * @param value - The blend type.
+     */
+    set blendType(value: BlendType);
+    /**
+     * Gets how the material is blended with the scene behind it.
+     * @returns The blend type.
+     */
+    get blendType(): BlendType;
+    /**
+     * Sets the strength of the normal map, where 0 is flat and 1 is the map's full effect.
+     * @param value - The bumpiness.
+     */
+    set bumpiness(value: number);
+    /**
+     * Gets the strength of the normal map.
+     * @returns The bumpiness.
+     */
+    get bumpiness(): number;
+    /**
+     * Sets which faces of a mesh are culled.
+     * @param value - The cull mode.
+     */
+    set cull(value: CullMode);
+    /**
+     * Gets which faces of a mesh are culled.
+     * @returns The cull mode.
+     */
+    get cull(): CullMode;
+    /**
+     * Sets the offset applied to the depth of a fragment, used to resolve z-fighting.
+     * @param value - The depth bias.
+     */
+    set depthBias(value: number);
+    /**
+     * Gets the offset applied to the depth of a fragment.
+     * @returns The depth bias.
+     */
+    get depthBias(): number;
+    /**
+     * Sets whether fragments are tested against the depth buffer.
+     * @param value - The depth test flag.
+     */
+    set depthTest(value: boolean);
+    /**
+     * Gets whether fragments are tested against the depth buffer.
+     * @returns The depth test flag.
+     */
+    get depthTest(): boolean;
+    /**
+     * Sets whether fragments write to the depth buffer.
+     * @param value - The depth write flag.
+     */
+    set depthWrite(value: boolean);
+    /**
+     * Gets whether fragments write to the depth buffer.
+     * @returns The depth write flag.
+     */
+    get depthWrite(): boolean;
+    /**
+     * Sets the diffuse color of the material. With the metalness workflow this doubles as the
+     * specular color where the surface is metallic.
+     * @param value - The diffuse color.
+     */
+    set diffuse(value: Color);
+    /**
+     * Gets the diffuse color of the material.
+     * @returns The diffuse color.
+     */
+    get diffuse(): Color;
+    /**
+     * Sets the id of the `pc-asset` to use as the diffuse map.
+     * @param value - The asset id.
+     */
+    set diffuseMap(value: string);
+    /**
+     * Gets the id of the `pc-asset` used as the diffuse map.
+     * @returns The asset id.
+     */
+    get diffuseMap(): string;
+    /**
+     * Sets the color channels of the diffuse map to sample.
+     * @param value - The channels.
+     */
+    set diffuseMapChannel(value: ColorChannel);
+    /**
+     * Gets the color channels of the diffuse map to sample.
+     * @returns The channels.
+     */
+    get diffuseMapChannel(): ColorChannel;
+    /**
+     * Sets the 2D offset of the diffuse map.
+     * @param value - The offset.
+     */
+    set diffuseMapOffset(value: Vec2);
+    /**
+     * Gets the 2D offset of the diffuse map.
+     * @returns The offset.
+     */
+    get diffuseMapOffset(): Vec2;
+    /**
+     * Sets the 2D rotation of the diffuse map, in degrees.
+     * @param value - The rotation.
+     */
+    set diffuseMapRotation(value: number);
+    /**
+     * Gets the 2D rotation of the diffuse map.
+     * @returns The rotation.
+     */
+    get diffuseMapRotation(): number;
+    /**
+     * Sets the 2D tiling of the diffuse map.
+     * @param value - The tiling.
+     */
+    set diffuseMapTiling(value: Vec2);
+    /**
+     * Gets the 2D tiling of the diffuse map.
+     * @returns The tiling.
+     */
+    get diffuseMapTiling(): Vec2;
+    /**
+     * Sets the UV channel the diffuse map samples.
+     * @param value - The UV channel.
+     */
+    set diffuseMapUv(value: number);
+    /**
+     * Gets the UV channel the diffuse map samples.
+     * @returns The UV channel.
+     */
+    get diffuseMapUv(): number;
+    /**
+     * Sets the emissive color of the material, which is added to the lit result.
+     * @param value - The emissive color.
+     */
+    set emissive(value: Color);
+    /**
+     * Gets the emissive color of the material.
+     * @returns The emissive color.
+     */
+    get emissive(): Color;
+    /**
+     * Sets the multiplier applied to the emissive color and map.
+     * @param value - The emissive intensity.
+     */
+    set emissiveIntensity(value: number);
+    /**
+     * Gets the multiplier applied to the emissive color and map.
+     * @returns The emissive intensity.
+     */
+    get emissiveIntensity(): number;
+    /**
+     * Sets the id of the `pc-asset` to use as the emissive map.
+     * @param value - The asset id.
+     */
+    set emissiveMap(value: string);
+    /**
+     * Gets the id of the `pc-asset` used as the emissive map.
+     * @returns The asset id.
+     */
+    get emissiveMap(): string;
+    /**
+     * Sets the color channels of the emissive map to sample.
+     * @param value - The channels.
+     */
+    set emissiveMapChannel(value: ColorChannel);
+    /**
+     * Gets the color channels of the emissive map to sample.
+     * @returns The channels.
+     */
+    get emissiveMapChannel(): ColorChannel;
+    /**
+     * Sets the 2D offset of the emissive map.
+     * @param value - The offset.
+     */
+    set emissiveMapOffset(value: Vec2);
+    /**
+     * Gets the 2D offset of the emissive map.
+     * @returns The offset.
+     */
+    get emissiveMapOffset(): Vec2;
+    /**
+     * Sets the 2D rotation of the emissive map, in degrees.
+     * @param value - The rotation.
+     */
+    set emissiveMapRotation(value: number);
+    /**
+     * Gets the 2D rotation of the emissive map.
+     * @returns The rotation.
+     */
+    get emissiveMapRotation(): number;
+    /**
+     * Sets the 2D tiling of the emissive map.
+     * @param value - The tiling.
+     */
+    set emissiveMapTiling(value: Vec2);
+    /**
+     * Gets the 2D tiling of the emissive map.
+     * @returns The tiling.
+     */
+    get emissiveMapTiling(): Vec2;
+    /**
+     * Sets the UV channel the emissive map samples.
+     * @param value - The UV channel.
+     */
+    set emissiveMapUv(value: number);
+    /**
+     * Gets the UV channel the emissive map samples.
+     * @returns The UV channel.
+     */
+    get emissiveMapUv(): number;
+    /**
+     * Sets whether to use the GGX specular model, which supports anisotropy.
+     * @param value - The GGX specular flag.
+     */
+    set enableGGXSpecular(value: boolean);
+    /**
+     * Gets whether to use the GGX specular model.
+     * @returns The GGX specular flag.
+     */
+    get enableGGXSpecular(): boolean;
+    /**
+     * Sets the Fresnel model used for specular reflections at grazing angles.
+     * @param value - The Fresnel model.
+     */
+    set fresnelModel(value: FresnelModel);
+    /**
+     * Gets the Fresnel model used for specular reflections at grazing angles.
+     * @returns The Fresnel model.
+     */
+    get fresnelModel(): FresnelModel;
+    /**
+     * Sets the glossiness of the material, from 0 (rough) to 1 (shiny). See also `roughness`.
+     * @param value - The gloss.
+     */
+    set gloss(value: number);
+    /**
+     * Gets the glossiness of the material.
+     * @returns The gloss.
+     */
+    get gloss(): number;
+    /**
+     * Sets whether the gloss value and map are inverted, which makes the material treat them as
+     * roughness. Setting `roughness` or `roughness-map` enables this automatically.
+     * @param value - The gloss invert flag.
+     */
+    set glossInvert(value: boolean);
+    /**
+     * Gets whether the gloss value and map are inverted.
+     * @returns The gloss invert flag.
+     */
+    get glossInvert(): boolean;
+    /**
+     * Sets the id of the `pc-asset` to use as the gloss map. See also `roughnessMap`.
+     * @param value - The asset id.
+     */
+    set glossMap(value: string);
+    /**
+     * Gets the id of the `pc-asset` used as the gloss map.
+     * @returns The asset id.
+     */
+    get glossMap(): string;
+    /**
+     * Sets the color channel of the gloss map to sample.
+     * @param value - The channel.
+     */
+    set glossMapChannel(value: ScalarChannel);
+    /**
+     * Gets the color channel of the gloss map to sample.
+     * @returns The channel.
+     */
+    get glossMapChannel(): ScalarChannel;
+    /**
+     * Sets the 2D offset of the gloss map.
+     * @param value - The offset.
+     */
+    set glossMapOffset(value: Vec2);
+    /**
+     * Gets the 2D offset of the gloss map.
+     * @returns The offset.
+     */
+    get glossMapOffset(): Vec2;
+    /**
+     * Sets the 2D rotation of the gloss map, in degrees.
+     * @param value - The rotation.
+     */
+    set glossMapRotation(value: number);
+    /**
+     * Gets the 2D rotation of the gloss map.
+     * @returns The rotation.
+     */
+    get glossMapRotation(): number;
+    /**
+     * Sets the 2D tiling of the gloss map.
+     * @param value - The tiling.
+     */
+    set glossMapTiling(value: Vec2);
+    /**
+     * Gets the 2D tiling of the gloss map.
+     * @returns The tiling.
+     */
+    get glossMapTiling(): Vec2;
+    /**
+     * Sets the UV channel the gloss map samples.
+     * @param value - The UV channel.
+     */
+    set glossMapUv(value: number);
+    /**
+     * Gets the UV channel the gloss map samples.
+     * @returns The UV channel.
+     */
+    get glossMapUv(): number;
+    /**
+     * Sets the id of the `pc-asset` to use as the height map, which drives parallax mapping.
+     * @param value - The asset id.
+     */
+    set heightMap(value: string);
+    /**
+     * Gets the id of the `pc-asset` used as the height map.
+     * @returns The asset id.
+     */
+    get heightMap(): string;
+    /**
+     * Sets the color channel of the height map to sample.
+     * @param value - The channel.
+     */
+    set heightMapChannel(value: ScalarChannel);
+    /**
+     * Gets the color channel of the height map to sample.
+     * @returns The channel.
+     */
+    get heightMapChannel(): ScalarChannel;
+    /**
+     * Sets the strength of the parallax effect driven by the height map.
+     * @param value - The height map factor.
+     */
+    set heightMapFactor(value: number);
+    /**
+     * Gets the strength of the parallax effect driven by the height map.
+     * @returns The height map factor.
+     */
+    get heightMapFactor(): number;
+    /**
+     * Sets the 2D offset of the height map.
+     * @param value - The offset.
+     */
+    set heightMapOffset(value: Vec2);
+    /**
+     * Gets the 2D offset of the height map.
+     * @returns The offset.
+     */
+    get heightMapOffset(): Vec2;
+    /**
+     * Sets the 2D rotation of the height map, in degrees.
+     * @param value - The rotation.
+     */
+    set heightMapRotation(value: number);
+    /**
+     * Gets the 2D rotation of the height map.
+     * @returns The rotation.
+     */
+    get heightMapRotation(): number;
+    /**
+     * Sets the 2D tiling of the height map.
+     * @param value - The tiling.
+     */
+    set heightMapTiling(value: Vec2);
+    /**
+     * Gets the 2D tiling of the height map.
+     * @returns The tiling.
+     */
+    get heightMapTiling(): Vec2;
+    /**
+     * Sets the UV channel the height map samples.
+     * @param value - The UV channel.
+     */
+    set heightMapUv(value: number);
+    /**
+     * Gets the UV channel the height map samples.
+     * @returns The UV channel.
+     */
+    get heightMapUv(): number;
+    /**
+     * Sets how metallic the surface is, from 0 (dielectric) to 1 (metal).
+     * @param value - The metalness.
+     */
+    set metalness(value: number);
+    /**
+     * Gets how metallic the surface is.
+     * @returns The metalness.
+     */
+    get metalness(): number;
+    /**
+     * Sets the id of the `pc-asset` to use as the metalness map.
+     * @param value - The asset id.
+     */
+    set metalnessMap(value: string);
+    /**
+     * Gets the id of the `pc-asset` used as the metalness map.
+     * @returns The asset id.
+     */
+    get metalnessMap(): string;
+    /**
+     * Sets the color channel of the metalness map to sample.
+     * @param value - The channel.
+     */
+    set metalnessMapChannel(value: ScalarChannel);
+    /**
+     * Gets the color channel of the metalness map to sample.
+     * @returns The channel.
+     */
+    get metalnessMapChannel(): ScalarChannel;
+    /**
+     * Sets the 2D offset of the metalness map.
+     * @param value - The offset.
+     */
+    set metalnessMapOffset(value: Vec2);
+    /**
+     * Gets the 2D offset of the metalness map.
+     * @returns The offset.
+     */
+    get metalnessMapOffset(): Vec2;
+    /**
+     * Sets the 2D rotation of the metalness map, in degrees.
+     * @param value - The rotation.
+     */
+    set metalnessMapRotation(value: number);
+    /**
+     * Gets the 2D rotation of the metalness map.
+     * @returns The rotation.
+     */
+    get metalnessMapRotation(): number;
+    /**
+     * Sets the 2D tiling of the metalness map.
+     * @param value - The tiling.
+     */
+    set metalnessMapTiling(value: Vec2);
+    /**
+     * Gets the 2D tiling of the metalness map.
+     * @returns The tiling.
+     */
+    get metalnessMapTiling(): Vec2;
+    /**
+     * Sets the UV channel the metalness map samples.
+     * @param value - The UV channel.
+     */
+    set metalnessMapUv(value: number);
+    /**
+     * Gets the UV channel the metalness map samples.
+     * @returns The UV channel.
+     */
+    get metalnessMapUv(): number;
+    /**
+     * Sets the id of the `pc-asset` to use as the normal map.
+     * @param value - The asset id.
+     */
+    set normalMap(value: string);
+    /**
+     * Gets the id of the `pc-asset` used as the normal map.
+     * @returns The asset id.
+     */
+    get normalMap(): string;
+    /**
+     * Sets the 2D offset of the normal map.
+     * @param value - The offset.
+     */
+    set normalMapOffset(value: Vec2);
+    /**
+     * Gets the 2D offset of the normal map.
+     * @returns The offset.
+     */
+    get normalMapOffset(): Vec2;
+    /**
+     * Sets the 2D rotation of the normal map, in degrees.
+     * @param value - The rotation.
+     */
+    set normalMapRotation(value: number);
+    /**
+     * Gets the 2D rotation of the normal map.
+     * @returns The rotation.
+     */
+    get normalMapRotation(): number;
+    /**
+     * Sets the 2D tiling of the normal map.
+     * @param value - The tiling.
+     */
+    set normalMapTiling(value: Vec2);
+    /**
+     * Gets the 2D tiling of the normal map.
+     * @returns The tiling.
+     */
+    get normalMapTiling(): Vec2;
+    /**
+     * Sets the UV channel the normal map samples.
+     * @param value - The UV channel.
+     */
+    set normalMapUv(value: number);
+    /**
+     * Gets the UV channel the normal map samples.
+     * @returns The UV channel.
+     */
+    get normalMapUv(): number;
+    /**
+     * Sets whether ambient occlusion also attenuates direct lighting.
+     * @param value - The occlude direct flag.
+     */
+    set occludeDirect(value: boolean);
+    /**
+     * Gets whether ambient occlusion also attenuates direct lighting.
+     * @returns The occlude direct flag.
+     */
+    get occludeDirect(): boolean;
+    /**
+     * Sets how specular reflections are occluded.
+     * @param value - The specular occlusion mode.
+     */
+    set occludeSpecular(value: OccludeSpecular);
+    /**
+     * Gets how specular reflections are occluded.
+     * @returns The specular occlusion mode.
+     */
+    get occludeSpecular(): OccludeSpecular;
+    /**
+     * Sets the opacity of the material, from 0 (transparent) to 1 (opaque), which requires a
+     * `blend-type` other than `none` to have any visible effect.
+     * @param value - The opacity.
+     */
+    set opacity(value: number);
+    /**
+     * Gets the opacity of the material, which requires a `blend-type` other than `none` to have
+     * any visible effect.
+     * @returns The opacity.
+     */
+    get opacity(): number;
+    /**
+     * Sets the dithering used to render opacity, which approximates transparency without blending.
+     * @param value - The dither mode.
+     */
+    set opacityDither(value: OpacityDither);
+    /**
+     * Gets the dithering used to render opacity.
+     * @returns The dither mode.
+     */
+    get opacityDither(): OpacityDither;
+    /**
+     * Sets whether specular highlights fade out as the material becomes transparent.
+     * @param value - The opacity fades specular flag.
+     */
+    set opacityFadesSpecular(value: boolean);
+    /**
+     * Gets whether specular highlights fade out as the material becomes transparent.
+     * @returns The opacity fades specular flag.
+     */
+    get opacityFadesSpecular(): boolean;
+    /**
+     * Sets the id of the `pc-asset` to use as the opacity map.
+     * @param value - The asset id.
+     */
+    set opacityMap(value: string);
+    /**
+     * Gets the id of the `pc-asset` used as the opacity map.
+     * @returns The asset id.
+     */
+    get opacityMap(): string;
+    /**
+     * Sets the color channel of the opacity map to sample.
+     * @param value - The channel.
+     */
+    set opacityMapChannel(value: ScalarChannel);
+    /**
+     * Gets the color channel of the opacity map to sample.
+     * @returns The channel.
+     */
+    get opacityMapChannel(): ScalarChannel;
+    /**
+     * Sets the 2D offset of the opacity map.
+     * @param value - The offset.
+     */
+    set opacityMapOffset(value: Vec2);
+    /**
+     * Gets the 2D offset of the opacity map.
+     * @returns The offset.
+     */
+    get opacityMapOffset(): Vec2;
+    /**
+     * Sets the 2D rotation of the opacity map, in degrees.
+     * @param value - The rotation.
+     */
+    set opacityMapRotation(value: number);
+    /**
+     * Gets the 2D rotation of the opacity map.
+     * @returns The rotation.
+     */
+    get opacityMapRotation(): number;
+    /**
+     * Sets the 2D tiling of the opacity map.
+     * @param value - The tiling.
+     */
+    set opacityMapTiling(value: Vec2);
+    /**
+     * Gets the 2D tiling of the opacity map.
+     * @returns The tiling.
+     */
+    get opacityMapTiling(): Vec2;
+    /**
+     * Sets the UV channel the opacity map samples.
+     * @param value - The UV channel.
+     */
+    set opacityMapUv(value: number);
+    /**
+     * Gets the UV channel the opacity map samples.
+     * @returns The UV channel.
+     */
+    get opacityMapUv(): number;
+    /**
+     * Sets the roughness of the material, from 0 (shiny) to 1 (rough). This is an alias for `gloss`
+     * that also inverts the gloss channel, so do not combine it with the `gloss` attributes.
+     * @param value - The roughness.
+     */
+    set roughness(value: number);
+    /**
+     * Gets the roughness of the material.
+     * @returns The roughness.
+     */
+    get roughness(): number;
+    /**
+     * Sets the id of the `pc-asset` to use as the roughness map. This is an alias for `glossMap`
+     * that also inverts the gloss channel, so do not combine it with the `gloss` attributes.
+     * @param value - The asset id.
+     */
+    set roughnessMap(value: string);
+    /**
+     * Gets the id of the `pc-asset` used as the roughness map.
+     * @returns The asset id.
+     */
+    get roughnessMap(): string;
+    /**
+     * Sets the depth offset applied in proportion to a surface's slope, used to resolve z-fighting.
+     * @param value - The slope depth bias.
+     */
+    set slopeDepthBias(value: number);
+    /**
+     * Gets the depth offset applied in proportion to a surface's slope.
+     * @returns The slope depth bias.
+     */
+    get slopeDepthBias(): number;
+    /**
+     * Sets the specular color of the material, which applies only when the metalness workflow is
+     * disabled or `use-metalness-specular-color` is enabled.
+     * @param value - The specular color.
+     */
+    set specular(value: Color);
+    /**
+     * Gets the specular color of the material, which applies only when the metalness workflow is
+     * disabled or `use-metalness-specular-color` is enabled.
+     * @returns The specular color.
+     */
+    get specular(): Color;
+    /**
+     * Sets the strength of specular reflections at direct angles, from 0 to 1, which applies only
+     * when `use-metalness-specular-color` is enabled.
+     * @param value - The specularity factor.
+     */
+    set specularityFactor(value: number);
+    /**
+     * Gets the strength of specular reflections at direct angles, which applies only when
+     * `use-metalness-specular-color` is enabled.
+     * @returns The specularity factor.
+     */
+    get specularityFactor(): number;
+    /**
+     * Sets whether back faces are lit as though their normals were flipped.
+     * @param value - The two sided lighting flag.
+     */
+    set twoSidedLighting(value: boolean);
+    /**
+     * Gets whether back faces are lit as though their normals were flipped.
+     * @returns The two sided lighting flag.
+     */
+    get twoSidedLighting(): boolean;
+    /**
+     * Sets whether the material is affected by scene fog.
+     * @param value - The use fog flag.
+     */
+    set useFog(value: boolean);
+    /**
+     * Gets whether the material is affected by scene fog.
+     * @returns The use fog flag.
+     */
+    get useFog(): boolean;
+    /**
+     * Sets whether the material is affected by scene lights. When disabled the material renders
+     * unlit, using the diffuse color and map alone.
+     * @param value - The use lighting flag.
+     */
+    set useLighting(value: boolean);
+    /**
+     * Gets whether the material is affected by scene lights.
+     * @returns The use lighting flag.
+     */
+    get useLighting(): boolean;
+    /**
+     * Sets whether to use the metalness workflow rather than the older specular workflow. Unlike a
+     * bare `StandardMaterial` this defaults to `true`, because the `metalness-*` attributes have no
+     * effect without it.
+     * @param value - The use metalness flag.
+     */
+    set useMetalness(value: boolean);
+    /**
+     * Gets whether to use the metalness workflow.
+     * @returns The use metalness flag.
+     */
+    get useMetalness(): boolean;
+    /**
+     * Sets whether the specular color tints reflections while the metalness workflow is in use.
+     * @param value - The use metalness specular color flag.
+     */
+    set useMetalnessSpecularColor(value: boolean);
+    /**
+     * Gets whether the specular color tints reflections while the metalness workflow is in use.
+     * @returns The use metalness specular color flag.
+     */
+    get useMetalnessSpecularColor(): boolean;
+    /**
+     * Sets whether the material is lit by the scene's skybox.
+     * @param value - The use skybox flag.
+     */
+    set useSkybox(value: boolean);
+    /**
+     * Gets whether the material is lit by the scene's skybox.
+     * @returns The use skybox flag.
+     */
+    get useSkybox(): boolean;
+    /**
+     * Sets whether the camera's tone mapping is applied to the material.
+     * @param value - The use tonemap flag.
+     */
+    set useTonemap(value: boolean);
+    /**
+     * Gets whether the camera's tone mapping is applied to the material.
+     * @returns The use tonemap flag.
+     */
+    get useTonemap(): boolean;
+    /**
+     * Returns the {@link StandardMaterial} created by the `<pc-material>` element with the given
+     * `id`, or `undefined` if there is no such element or its material has not been created yet.
+     *
+     * @param id - The `id` of the `<pc-material>` element.
+     * @returns The material, or `undefined`.
+     */
+    static get(id: string): StandardMaterial | null | undefined;
+    static get observedAttributes(): string[];
+    attributeChangedCallback(name: string, _oldValue: string | null, newValue: string | null): void;
+}
+export { MaterialElement };