--- title: "HillshadeStyleLayer | JavaScript maps SDK" description: "Documentation for MapTiler SDK" --- > For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL. # Class HillshadeStyleLayer A base class for style layers #### Hierarchy ([View Summary](https://docs.maptiler.com/sdk-js/api-reference/hierarchy/#Externals.HillshadeStyleLayer)) - [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/) - HillshadeStyleLayer ##### Index ### Constructors[](#constructors) [constructor](#constructor) ### Properties[](#properties) [filter](#filter) [id](#id) [layout](#layout) [maxzoom](#maxzoom) [metadata](#metadata) [minzoom](#minzoom) [onAdd](#onadd) [onRemove](#onremove) [paint](#paint) [source](#source) [sourceLayer](#sourcelayer) [type](#type) [visibility](#visibility) ### Methods[](#methods) [createBucket?](#createbucket) [fire](#fire) [getCrossfadeParameters](#getcrossfadeparameters) [getIlluminationProperties](#getilluminationproperties) [getLayoutAffectingGlobalStateRefs](#getlayoutaffectingglobalstaterefs) [getLayoutProperty](#getlayoutproperty) [getPaintAffectingGlobalStateRefs](#getpaintaffectingglobalstaterefs) [getPaintProperty](#getpaintproperty) [getVisibilityAffectingGlobalStateRefs](#getvisibilityaffectingglobalstaterefs) [hasOffscreenPass](#hasoffscreenpass) [hasTransition](#hastransition) [is3D](#is3d) [isHidden](#ishidden) [isStateDependent](#isstatedependent) [isTileClipped](#istileclipped) [listens](#listens) [off](#off) [on](#on) [once](#once) [queryIntersectsFeature?](#queryintersectsfeature) [queryRadius?](#queryradius) [recalculate](#recalculate) [recalculateVisibility](#recalculatevisibility) [resize](#resize) [serialize](#serialize) [setEventedParent](#seteventedparent) [setFilter](#setfilter) [setLayoutProperty](#setlayoutproperty) [setPaintProperty](#setpaintproperty) [updateTransitions](#updatetransitions) ## Constructors[](#constructors-1) ### constructor[](#constructor) - new HillshadeStyleLayer(     layer: [LayerSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/LayerSpecification/),     globalState: [Record](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.Record/), ): HillshadeStyleLayer[](#constructorhillshadestylelayer) #### Parameters - layer: [LayerSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/LayerSpecification/) - globalState: [Record](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.Record/) #### Returns HillshadeStyleLayer Overrides [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[constructor](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#constructor) ## Properties[](#properties-1) ### filter[](#filter) filter: void | [FilterSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/FilterSpecification/) Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[filter](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#filter) ### id[](#id) id: string Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[id](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#id) ### `Readonly`layout[](#layout) layout: unknown Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[layout](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#layout) ### maxzoom[](#maxzoom) maxzoom: number Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[maxzoom](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#maxzoom) ### metadata[](#metadata) metadata: unknown Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[metadata](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#metadata) ### minzoom[](#minzoom) minzoom: number Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[minzoom](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#minzoom) ### `Readonly`onAdd[](#onadd) onAdd: (map: [MapLibreMap](https://docs.maptiler.com/sdk-js/api-reference/classes/MapLibreMap/)) \=> void Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[onAdd](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#onadd) ### `Readonly`onRemove[](#onremove) onRemove: (map: [MapLibreMap](https://docs.maptiler.com/sdk-js/api-reference/classes/MapLibreMap/)) \=> void Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[onRemove](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#onremove) ### paint[](#paint) paint: [PossiblyEvaluated](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.PossiblyEvaluated/)<     [HillshadePaintProps](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.HillshadePaintProps/),     [HillshadePaintPropsPossiblyEvaluated](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.HillshadePaintPropsPossiblyEvaluated/), \> Overrides [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[paint](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#paint) ### source[](#source) source: string Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[source](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#source) ### sourceLayer[](#sourcelayer) sourceLayer: string Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[sourceLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#sourcelayer) ### type[](#type) type:     | "symbol"     | "custom"     | "fill"     | "line"     | "circle"     | "heatmap"     | "fill-extrusion"     | "raster"     | "hillshade"     | "color-relief"     | "background" Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[type](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#type) ### visibility[](#visibility) visibility: [VisibilitySpecification](https://docs.maptiler.com/sdk-js/api-reference/types/VisibilitySpecification/) Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[visibility](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#visibility) ## Methods[](#methods-1) ### `Optional`createBucket[](#createbucket) - createBucket?(parameters: [BucketParameters](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.BucketParameters/)): [Bucket](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Bucket/)[](#createbucket-1) #### Parameters - parameters: [BucketParameters](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.BucketParameters/) #### Returns [Bucket](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Bucket/) Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[createBucket](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#createbucket) ### fire[](#fire) - fire(event: string | [Event](https://docs.maptiler.com/sdk-js/api-reference/classes/Event/), properties?: any): this[](#fire-1) #### Parameters - event: string | [Event](https://docs.maptiler.com/sdk-js/api-reference/classes/Event/) - `Optional`properties: any #### Returns this Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[fire](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#fire) ### getCrossfadeParameters[](#getcrossfadeparameters) - getCrossfadeParameters(): [CrossfadeParameters](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.CrossfadeParameters/)[](#getcrossfadeparameters-1) #### Returns [CrossfadeParameters](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.CrossfadeParameters/) Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[getCrossfadeParameters](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#getcrossfadeparameters) ### getIlluminationProperties[](#getilluminationproperties) - getIlluminationProperties(): {     altitudeRadians: number\[\];     directionRadians: number\[\];     highlightColor: [Color](https://docs.maptiler.com/sdk-js/api-reference/classes/Color/)\[\];     shadowColor: [Color](https://docs.maptiler.com/sdk-js/api-reference/classes/Color/)\[\]; }[](#getilluminationproperties-1) #### Returns {     altitudeRadians: number\[\];     directionRadians: number\[\];     highlightColor: [Color](https://docs.maptiler.com/sdk-js/api-reference/classes/Color/)\[\];     shadowColor: [Color](https://docs.maptiler.com/sdk-js/api-reference/classes/Color/)\[\]; } ### getLayoutAffectingGlobalStateRefs[](#getlayoutaffectingglobalstaterefs) - getLayoutAffectingGlobalStateRefs(): Set[](#getlayoutaffectingglobalstaterefs-1) Get list of global state references that are used within layout or filter properties. This is used to determine if layer source need to be reloaded when global state property changes. #### Returns Set Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[getLayoutAffectingGlobalStateRefs](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#getlayoutaffectingglobalstaterefs) ### getLayoutProperty[](#getlayoutproperty) - getLayoutProperty(name: string): any[](#getlayoutproperty-1) #### Parameters - name: string #### Returns any Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[getLayoutProperty](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#getlayoutproperty) ### getPaintAffectingGlobalStateRefs[](#getpaintaffectingglobalstaterefs) - getPaintAffectingGlobalStateRefs(): Map[](#getpaintaffectingglobalstaterefs-1) Get list of global state references that are used within paint properties. This is used to determine if layer needs to be repainted when global state property changes. #### Returns Map Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[getPaintAffectingGlobalStateRefs](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#getpaintaffectingglobalstaterefs) ### getPaintProperty[](#getpaintproperty) - getPaintProperty(name: string): unknown[](#getpaintproperty-1) #### Parameters - name: string #### Returns unknown Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[getPaintProperty](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#getpaintproperty) ### getVisibilityAffectingGlobalStateRefs[](#getvisibilityaffectingglobalstaterefs) - getVisibilityAffectingGlobalStateRefs(): Set[](#getvisibilityaffectingglobalstaterefs-1) Get list of global state references that are used within visibility expression. This is used to determine if layer visibility needs to be updated when global state property changes. #### Returns Set Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[getVisibilityAffectingGlobalStateRefs](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#getvisibilityaffectingglobalstaterefs) ### hasOffscreenPass[](#hasoffscreenpass) - hasOffscreenPass(): boolean[](#hasoffscreenpass-1) #### Returns boolean Overrides [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[hasOffscreenPass](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#hasoffscreenpass) ### hasTransition[](#hastransition) - hasTransition(): boolean[](#hastransition-1) #### Returns boolean Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[hasTransition](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#hastransition) ### is3D[](#is3d) - is3D(): boolean[](#is3d-1) #### Returns boolean Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[is3D](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#is3d) ### isHidden[](#ishidden) - isHidden(zoom?: number, roundMinZoom?: boolean): boolean[](#ishidden-1) #### Parameters - `Optional`zoom: number - `Optional`roundMinZoom: boolean #### Returns boolean Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[isHidden](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#ishidden) ### isStateDependent[](#isstatedependent) - isStateDependent(): boolean[](#isstatedependent-1) #### Returns boolean Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[isStateDependent](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#isstatedependent) ### isTileClipped[](#istileclipped) - isTileClipped(): boolean[](#istileclipped-1) #### Returns boolean Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[isTileClipped](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#istileclipped) ### listens[](#listens) - listens(type: string): boolean[](#listens-1) Returns a true if this instance of Evented or any forwardeed instances of Evented have a listener for the specified type. #### Parameters - type: string The event type #### Returns boolean `true` if there is at least one registered listener for specified event type, `false` otherwise Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[listens](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#listens) ### off[](#off) - off(type: string, listener: [Listener](https://docs.maptiler.com/sdk-js/api-reference/types/Listener/)): this[](#off-1) Removes a previously registered event listener. #### Parameters - type: string The event type to remove listeners for. - listener: [Listener](https://docs.maptiler.com/sdk-js/api-reference/types/Listener/) The listener function to remove. #### Returns this Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[off](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#off) ### on[](#on) - on(type: string, listener: [Listener](https://docs.maptiler.com/sdk-js/api-reference/types/Listener/)): [Subscription](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Subscription/)[](#on-1) Adds a listener to a specified event type. #### Parameters - type: string The event type to add a listen for. - listener: [Listener](https://docs.maptiler.com/sdk-js/api-reference/types/Listener/) The function to be called when the event is fired. The listener function is called with the data object passed to `fire`, extended with `target` and `type` properties. #### Returns [Subscription](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Subscription/) Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[on](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#on) ### once[](#once) - once(type: string, listener?: [Listener](https://docs.maptiler.com/sdk-js/api-reference/types/Listener/)): Promise | HillshadeStyleLayer[](#once-1) Adds a listener that will be called only once to a specified event type. The listener will be called first time the event fires after the listener is registered. #### Parameters - type: string The event type to listen for. - `Optional`listener: [Listener](https://docs.maptiler.com/sdk-js/api-reference/types/Listener/) The function to be called when the event is fired the first time. #### Returns Promise | HillshadeStyleLayer `this` or a promise if a listener is not provided Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[once](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#once) ### `Optional`queryIntersectsFeature[](#queryintersectsfeature) - queryIntersectsFeature?(params: [QueryIntersectsFeatureParams](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.QueryIntersectsFeatureParams/)): number | boolean[](#queryintersectsfeature-1) #### Parameters - params: [QueryIntersectsFeatureParams](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.QueryIntersectsFeatureParams/) #### Returns number | boolean Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[queryIntersectsFeature](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#queryintersectsfeature) ### `Optional`queryRadius[](#queryradius) - queryRadius?(bucket: [Bucket](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Bucket/)): number[](#queryradius-1) #### Parameters - bucket: [Bucket](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Bucket/) #### Returns number Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[queryRadius](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#queryradius) ### recalculate[](#recalculate) - recalculate(parameters: [EvaluationParameters](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.EvaluationParameters/), availableImages: string\[\]): void[](#recalculate-1) #### Parameters - parameters: [EvaluationParameters](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.EvaluationParameters/) - availableImages: string\[\] #### Returns void Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[recalculate](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#recalculate) ### recalculateVisibility[](#recalculatevisibility) - recalculateVisibility(): void[](#recalculatevisibility-1) #### Returns void Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[recalculateVisibility](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#recalculatevisibility) ### resize[](#resize) - resize(): void[](#resize-1) #### Returns void Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[resize](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#resize) ### serialize[](#serialize) - serialize(): [LayerSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/LayerSpecification/)[](#serialize-1) #### Returns [LayerSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/LayerSpecification/) Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[serialize](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#serialize) ### setEventedParent[](#seteventedparent) - setEventedParent(parent?: [Evented](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.Evented/) | null, data?: any): this[](#seteventedparent-1) Bubble all events fired by this instance of Evented to this parent instance of Evented. #### Parameters - `Optional`parent: [Evented](https://docs.maptiler.com/sdk-js/api-reference/classes/Externals.Evented/) | null - `Optional`data: any #### Returns this Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[setEventedParent](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#seteventedparent) ### setFilter[](#setfilter) - setFilter(filter: void | [FilterSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/FilterSpecification/)): void[](#setfilter-1) #### Parameters - filter: void | [FilterSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/FilterSpecification/) #### Returns void Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[setFilter](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#setfilter) ### setLayoutProperty[](#setlayoutproperty) - setLayoutProperty(name: string, value: any, options?: [StyleSetterOptions](https://docs.maptiler.com/sdk-js/api-reference/types/StyleSetterOptions/)): void[](#setlayoutproperty-1) #### Parameters - name: string - value: any - `Optional`options: [StyleSetterOptions](https://docs.maptiler.com/sdk-js/api-reference/types/StyleSetterOptions/) #### Returns void Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[setLayoutProperty](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#setlayoutproperty) ### setPaintProperty[](#setpaintproperty) - setPaintProperty(     name: string,     value: unknown,     options?: [StyleSetterOptions](https://docs.maptiler.com/sdk-js/api-reference/types/StyleSetterOptions/), ): boolean[](#setpaintproperty-1) #### Parameters - name: string - value: unknown - `Optional`options: [StyleSetterOptions](https://docs.maptiler.com/sdk-js/api-reference/types/StyleSetterOptions/) #### Returns boolean Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[setPaintProperty](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#setpaintproperty) ### updateTransitions[](#updatetransitions) - updateTransitions(parameters: [TransitionParameters](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.TransitionParameters/)): void[](#updatetransitions-1) #### Parameters - parameters: [TransitionParameters](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.TransitionParameters/) #### Returns void Inherited from [StyleLayer](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/).[updateTransitions](https://docs.maptiler.com/sdk-js/api-reference/classes/StyleLayer/#updatetransitions)