You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
257 lines
8.7 KiB
257 lines
8.7 KiB
export default Icon;
|
|
/**
|
|
* Anchor unit can be either a fraction of the icon size or in pixels.
|
|
*/
|
|
export type IconAnchorUnits = 'fraction' | 'pixels';
|
|
/**
|
|
* Icon origin. One of 'bottom-left', 'bottom-right', 'top-left', 'top-right'.
|
|
*/
|
|
export type IconOrigin = 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right';
|
|
export type Options = {
|
|
/**
|
|
* Anchor. Default value is the icon center.
|
|
*/
|
|
anchor?: number[] | undefined;
|
|
/**
|
|
* Origin of the anchor: `bottom-left`, `bottom-right`,
|
|
* `top-left` or `top-right`.
|
|
*/
|
|
anchorOrigin?: IconOrigin | undefined;
|
|
/**
|
|
* Units in which the anchor x value is
|
|
* specified. A value of `'fraction'` indicates the x value is a fraction of the icon. A value of `'pixels'` indicates
|
|
* the x value in pixels.
|
|
*/
|
|
anchorXUnits?: IconAnchorUnits | undefined;
|
|
/**
|
|
* Units in which the anchor y value is
|
|
* specified. A value of `'fraction'` indicates the y value is a fraction of the icon. A value of `'pixels'` indicates
|
|
* the y value in pixels.
|
|
*/
|
|
anchorYUnits?: IconAnchorUnits | undefined;
|
|
/**
|
|
* Color to tint the icon. If not specified,
|
|
* the icon will be left as is.
|
|
*/
|
|
color?: string | import("../color.js").Color | undefined;
|
|
/**
|
|
* The `crossOrigin` attribute for loaded images. Note that you must provide a
|
|
* `crossOrigin` value if you want to access pixel data with the Canvas renderer.
|
|
* See https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image for more detail.
|
|
*/
|
|
crossOrigin?: string | null | undefined;
|
|
/**
|
|
* Image object for the icon. If the `src` option is not provided then the
|
|
* provided image must already be loaded. And in that case, it is required
|
|
* to provide the size of the image, with the `imgSize` option.
|
|
*/
|
|
img?: HTMLCanvasElement | HTMLImageElement | undefined;
|
|
/**
|
|
* Image size in pixels. Only required if `img` is set and `src` is not.
|
|
* The provided `imgSize` needs to match the actual size of the image.
|
|
*/
|
|
imgSize?: import("../size.js").Size | undefined;
|
|
/**
|
|
* Displacement of the icon in pixels.
|
|
* Positive values will shift the icon right and up.
|
|
*/
|
|
displacement?: number[] | undefined;
|
|
/**
|
|
* Opacity of the icon.
|
|
*/
|
|
opacity?: number | undefined;
|
|
/**
|
|
* Scale.
|
|
*/
|
|
scale?: number | import("../size.js").Size | undefined;
|
|
/**
|
|
* Whether to rotate the icon with the view.
|
|
*/
|
|
rotateWithView?: boolean | undefined;
|
|
/**
|
|
* Rotation in radians (positive rotation clockwise).
|
|
*/
|
|
rotation?: number | undefined;
|
|
/**
|
|
* Offset which, together with `size` and `offsetOrigin`, defines the
|
|
* sub-rectangle to use from the original (sprite) image.
|
|
*/
|
|
offset?: number[] | undefined;
|
|
/**
|
|
* Origin of the offset: `bottom-left`, `bottom-right`,
|
|
* `top-left` or `top-right`.
|
|
*/
|
|
offsetOrigin?: IconOrigin | undefined;
|
|
/**
|
|
* Icon size in pixels. Used together with `offset` to define the
|
|
* sub-rectangle to use from the original (sprite) image.
|
|
*/
|
|
size?: import("../size.js").Size | undefined;
|
|
/**
|
|
* Image source URI.
|
|
*/
|
|
src?: string | undefined;
|
|
/**
|
|
* Declutter mode.
|
|
*/
|
|
declutterMode?: "declutter" | "obstacle" | "none" | undefined;
|
|
};
|
|
/**
|
|
* @typedef {'fraction' | 'pixels'} IconAnchorUnits
|
|
* Anchor unit can be either a fraction of the icon size or in pixels.
|
|
*/
|
|
/**
|
|
* @typedef {'bottom-left' | 'bottom-right' | 'top-left' | 'top-right'} IconOrigin
|
|
* Icon origin. One of 'bottom-left', 'bottom-right', 'top-left', 'top-right'.
|
|
*/
|
|
/**
|
|
* @typedef {Object} Options
|
|
* @property {Array<number>} [anchor=[0.5, 0.5]] Anchor. Default value is the icon center.
|
|
* @property {IconOrigin} [anchorOrigin='top-left'] Origin of the anchor: `bottom-left`, `bottom-right`,
|
|
* `top-left` or `top-right`.
|
|
* @property {IconAnchorUnits} [anchorXUnits='fraction'] Units in which the anchor x value is
|
|
* specified. A value of `'fraction'` indicates the x value is a fraction of the icon. A value of `'pixels'` indicates
|
|
* the x value in pixels.
|
|
* @property {IconAnchorUnits} [anchorYUnits='fraction'] Units in which the anchor y value is
|
|
* specified. A value of `'fraction'` indicates the y value is a fraction of the icon. A value of `'pixels'` indicates
|
|
* the y value in pixels.
|
|
* @property {import("../color.js").Color|string} [color] Color to tint the icon. If not specified,
|
|
* the icon will be left as is.
|
|
* @property {null|string} [crossOrigin] The `crossOrigin` attribute for loaded images. Note that you must provide a
|
|
* `crossOrigin` value if you want to access pixel data with the Canvas renderer.
|
|
* See https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image for more detail.
|
|
* @property {HTMLImageElement|HTMLCanvasElement} [img] Image object for the icon. If the `src` option is not provided then the
|
|
* provided image must already be loaded. And in that case, it is required
|
|
* to provide the size of the image, with the `imgSize` option.
|
|
* @property {import("../size.js").Size} [imgSize] Image size in pixels. Only required if `img` is set and `src` is not.
|
|
* The provided `imgSize` needs to match the actual size of the image.
|
|
* @property {Array<number>} [displacement=[0, 0]] Displacement of the icon in pixels.
|
|
* Positive values will shift the icon right and up.
|
|
* @property {number} [opacity=1] Opacity of the icon.
|
|
* @property {number|import("../size.js").Size} [scale=1] Scale.
|
|
* @property {boolean} [rotateWithView=false] Whether to rotate the icon with the view.
|
|
* @property {number} [rotation=0] Rotation in radians (positive rotation clockwise).
|
|
* @property {Array<number>} [offset=[0, 0]] Offset which, together with `size` and `offsetOrigin`, defines the
|
|
* sub-rectangle to use from the original (sprite) image.
|
|
* @property {IconOrigin} [offsetOrigin='top-left'] Origin of the offset: `bottom-left`, `bottom-right`,
|
|
* `top-left` or `top-right`.
|
|
* @property {import("../size.js").Size} [size] Icon size in pixels. Used together with `offset` to define the
|
|
* sub-rectangle to use from the original (sprite) image.
|
|
* @property {string} [src] Image source URI.
|
|
* @property {"declutter"|"obstacle"|"none"|undefined} [declutterMode] Declutter mode.
|
|
*/
|
|
/**
|
|
* @classdesc
|
|
* Set icon style for vector features.
|
|
* @api
|
|
*/
|
|
declare class Icon extends ImageStyle {
|
|
/**
|
|
* @param {Options} [options] Options.
|
|
*/
|
|
constructor(options?: Options | undefined);
|
|
/**
|
|
* @private
|
|
* @type {Array<number>}
|
|
*/
|
|
private anchor_;
|
|
/**
|
|
* @private
|
|
* @type {Array<number>}
|
|
*/
|
|
private normalizedAnchor_;
|
|
/**
|
|
* @private
|
|
* @type {IconOrigin}
|
|
*/
|
|
private anchorOrigin_;
|
|
/**
|
|
* @private
|
|
* @type {IconAnchorUnits}
|
|
*/
|
|
private anchorXUnits_;
|
|
/**
|
|
* @private
|
|
* @type {IconAnchorUnits}
|
|
*/
|
|
private anchorYUnits_;
|
|
/**
|
|
* @private
|
|
* @type {?string}
|
|
*/
|
|
private crossOrigin_;
|
|
/**
|
|
* @private
|
|
* @type {import("../size.js").Size|undefined}
|
|
*/
|
|
private imgSize_;
|
|
/**
|
|
* @private
|
|
* @type {import("../color.js").Color}
|
|
*/
|
|
private color_;
|
|
/**
|
|
* @private
|
|
* @type {import("./IconImage.js").default}
|
|
*/
|
|
private iconImage_;
|
|
/**
|
|
* @private
|
|
* @type {Array<number>}
|
|
*/
|
|
private offset_;
|
|
/**
|
|
* @private
|
|
* @type {IconOrigin}
|
|
*/
|
|
private offsetOrigin_;
|
|
/**
|
|
* @private
|
|
* @type {Array<number>}
|
|
*/
|
|
private origin_;
|
|
/**
|
|
* @private
|
|
* @type {import("../size.js").Size}
|
|
*/
|
|
private size_;
|
|
/**
|
|
* Clones the style. The underlying Image/HTMLCanvasElement is not cloned.
|
|
* @return {Icon} The cloned style.
|
|
* @api
|
|
*/
|
|
clone(): Icon;
|
|
/**
|
|
* Set the anchor point. The anchor determines the center point for the
|
|
* symbolizer.
|
|
*
|
|
* @param {Array<number>} anchor Anchor.
|
|
* @api
|
|
*/
|
|
setAnchor(anchor: Array<number>): void;
|
|
/**
|
|
* Get the icon color.
|
|
* @return {import("../color.js").Color} Color.
|
|
* @api
|
|
*/
|
|
getColor(): import("../color.js").Color;
|
|
/**
|
|
* Get the image icon.
|
|
* @param {number} pixelRatio Pixel ratio.
|
|
* @return {HTMLImageElement|HTMLCanvasElement} Image or Canvas element.
|
|
* @api
|
|
*/
|
|
getImage(pixelRatio: number): HTMLImageElement | HTMLCanvasElement;
|
|
/**
|
|
* @return {HTMLImageElement|HTMLCanvasElement} Image element.
|
|
*/
|
|
getHitDetectionImage(): HTMLImageElement | HTMLCanvasElement;
|
|
/**
|
|
* Get the image URL.
|
|
* @return {string|undefined} Image src.
|
|
* @api
|
|
*/
|
|
getSrc(): string | undefined;
|
|
}
|
|
import ImageStyle from "./Image.js";
|
|
//# sourceMappingURL=Icon.d.ts.map
|