Type Definitions
-
olx.style.AtlasManagerOptions{Object}
-
Properties:
Name Type Argument Description initialSize
number | undefined <optional>
The size in pixels of the first atlas image. If no value is given the
ol.INITIAL_ATLAS_SIZE
compile-time constant will be used.maxSize
number | undefined <optional>
The maximum size in pixels of atlas images. If no value is given then the
ol.MAX_ATLAS_SIZE
compile-time constant will be used. And ifol.MAX_ATLAS_SIZE
is set to-1
(the default) thenol.WEBGL_MAX_TEXTURE_SIZE
will used if WebGL is supported. Otherwise 2048 is used.space
number | undefined <optional>
The space in pixels between images (default: 1).
-
olx.style.CircleOptions{Object}
-
Properties:
Name Type Argument Description fill
ol.style.Fill | undefined <optional>
Fill style.
radius
number Circle radius. Required.
snapToPixel
boolean | undefined <optional>
If
true
integral numbers of pixels are used as the X and Y pixel coordinate when drawing the circle in the output canvas. Iffalse
fractional numbers may be used. Usingtrue
allows for "sharp" rendering (no blur), while usingfalse
allows for "accurate" rendering. Note that accuracy is important if the circle's position is animated. Without it, the circle may jitter noticeably. Default value istrue
.stroke
ol.style.Stroke | undefined <optional>
Stroke style.
atlasManager
ol.style.AtlasManager | undefined <optional>
The atlas manager to use for this circle. When using WebGL it is recommended to use an atlas manager to avoid texture switching. If an atlas manager is given, the circle is added to an atlas. By default no atlas manager is used.
-
olx.style.FillOptions{Object}
-
Properties:
Name Type Argument Description color
ol.Color | ol.ColorLike | undefined <optional>
A color, gradient or pattern. See
ol.color
andol.colorlike
for possible formats. Default null; if null, the Canvas/renderer default black will be used. -
olx.style.IconOptions{Object}
-
Properties:
Name Type Argument Description anchor
Array.<number> | undefined <optional>
Anchor. Default value is
[0.5, 0.5]
(icon center).anchorOrigin
ol.style.IconOrigin | undefined <optional>
Origin of the anchor:
bottom-left
,bottom-right
,top-left
ortop-right
. Default istop-left
.anchorXUnits
ol.style.IconAnchorUnits | undefined <optional>
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. Default is'fraction'
.anchorYUnits
ol.style.IconAnchorUnits | undefined <optional>
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. Default is'fraction'
.color
ol.Color | string | undefined <optional>
Color to tint the icon. If not specified, the icon will be left as is.
crossOrigin
null | string | undefined <optional>
The
crossOrigin
attribute for loaded images. Note that you must provide acrossOrigin
value if you are using the WebGL renderer or 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.img
Image | HTMLCanvasElement | undefined <optional>
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 theimgSize
option.offset
Array.<number> | undefined <optional>
Offset, which, together with the size and the offset origin, define the sub-rectangle to use from the original icon image. Default value is
[0, 0]
.offsetOrigin
ol.style.IconOrigin | undefined <optional>
Origin of the offset:
bottom-left
,bottom-right
,top-left
ortop-right
. Default istop-left
.opacity
number | undefined <optional>
Opacity of the icon. Default is
1
.scale
number | undefined <optional>
Scale. Default is
1
.snapToPixel
boolean | undefined <optional>
If
true
integral numbers of pixels are used as the X and Y pixel coordinate when drawing the icon in the output canvas. Iffalse
fractional numbers may be used. Usingtrue
allows for "sharp" rendering (no blur), while usingfalse
allows for "accurate" rendering. Note that accuracy is important if the icon's position is animated. Without it, the icon may jitter noticeably. Default value istrue
.rotateWithView
boolean | undefined <optional>
Whether to rotate the icon with the view. Default is
false
.rotation
number | undefined <optional>
Rotation in radians (positive rotation clockwise). Default is
0
.size
ol.Size | undefined <optional>
Icon size in pixel. Can be used together with
offset
to define the sub-rectangle to use from the origin (sprite) icon image.imgSize
ol.Size | undefined <optional>
Image size in pixels. Only required if
img
is set andsrc
is not, and for SVG images in Internet Explorer 11. The providedimgSize
needs to match the actual size of the image.src
string | undefined <optional>
Image source URI.
-
olx.style.RegularShapeOptions{Object}
-
Specify radius for regular polygons, or radius1 and radius2 for stars.
Properties:
Name Type Argument Description fill
ol.style.Fill | undefined <optional>
Fill style.
points
number Number of points for stars and regular polygons. In case of a polygon, the number of points is the number of sides. Required.
radius
number | undefined <optional>
Radius of a regular polygon.
radius1
number | undefined <optional>
Outer radius of a star.
radius2
number | undefined <optional>
Inner radius of a star.
angle
number | undefined <optional>
Shape's angle in radians. A value of 0 will have one of the shape's point facing up. Default value is 0.
snapToPixel
boolean | undefined <optional>
If
true
integral numbers of pixels are used as the X and Y pixel coordinate when drawing the shape in the output canvas. Iffalse
fractional numbers may be used. Usingtrue
allows for "sharp" rendering (no blur), while usingfalse
allows for "accurate" rendering. Note that accuracy is important if the shape's position is animated. Without it, the shape may jitter noticeably. Default value istrue
.stroke
ol.style.Stroke | undefined <optional>
Stroke style.
rotation
number | undefined <optional>
Rotation in radians (positive rotation clockwise). Default is
0
.rotateWithView
boolean | undefined <optional>
Whether to rotate the shape with the view. Default is
false
.atlasManager
ol.style.AtlasManager | undefined <optional>
The atlas manager to use for this symbol. When using WebGL it is recommended to use an atlas manager to avoid texture switching. If an atlas manager is given, the symbol is added to an atlas. By default no atlas manager is used.
-
olx.style.StrokeOptions{Object}
-
Properties:
Name Type Argument Description color
ol.Color | ol.ColorLike | undefined <optional>
A color, gradient or pattern. See
ol.color
andol.colorlike
for possible formats. Default null; if null, the Canvas/renderer default black will be used.lineCap
string | undefined <optional>
Line cap style:
butt
,round
, orsquare
. Default isround
.lineJoin
string | undefined <optional>
Line join style:
bevel
,round
, ormiter
. Default isround
.lineDash
Array.<number> | undefined <optional>
Line dash pattern. Default is
undefined
(no dash). Please note that Internet Explorer 10 and lower do not support thesetLineDash
method on theCanvasRenderingContext2D
and therefore this option will have no visual effect in these browsers.lineDashOffset
number | undefined <optional>
Line dash offset. Default is '0'.
miterLimit
number | undefined <optional>
Miter limit. Default is
10
.width
number | undefined <optional>
Width.
-
olx.style.StyleOptions{Object}
-
Properties:
Name Type Argument Description geometry
undefined | string | ol.geom.Geometry | ol.StyleGeometryFunction <optional>
Feature property or geometry or function returning a geometry to render for this style.
fill
ol.style.Fill | undefined <optional>
Fill style.
image
ol.style.Image | undefined <optional>
Image style.
renderer
ol.StyleRenderFunction | undefined <optional>
Custom renderer. When configured,
fill
,stroke
andimage
will be ignored, and the provided function will be called with each render frame for each geometry.stroke
ol.style.Stroke | undefined <optional>
Stroke style.
text
ol.style.Text | undefined <optional>
Text style.
zIndex
number | undefined <optional>
Z index.
-
olx.style.TextOptions{Object}
-
Properties:
Name Type Argument Description exceedLength
boolean | undefined <optional>
Deprecated. Use the
overflow
option instead.For polygon labels or when
placement
is set to'line'
, allow text to exceed the width of the polygon at the label position or the length of the path that it follows. Default isfalse
.font
string | undefined <optional>
Font style as CSS 'font' value, see: https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/font. Default is '10px sans-serif'
maxAngle
number | undefined <optional>
When
placement
is set to'line'
, allow a maximum angle between adjacent characters. The expected value is in radians, and the default is 45° (Math.PI / 4
).offsetX
number | undefined <optional>
Horizontal text offset in pixels. A positive will shift the text right. Default is
0
.offsetY
number | undefined <optional>
Vertical text offset in pixels. A positive will shift the text down. Default is
0
.overflow
boolean | undefined <optional>
For polygon labels or when
placement
is set to'line'
, allow text to exceed the width of the polygon at the label position or the length of the path that it follows. Default isfalse
.placement
ol.style.TextPlacement | undefined <optional>
Text placement.
scale
number | undefined <optional>
Scale.
rotateWithView
boolean | undefined <optional>
Whether to rotate the text with the view. Default is
false
.rotation
number | undefined <optional>
Rotation in radians (positive rotation clockwise). Default is
0
.text
string | undefined <optional>
Text content.
textAlign
string | undefined <optional>
Text alignment. Possible values: 'left', 'right', 'center', 'end' or 'start'. Default is 'center' for
placement: 'point'
. Forplacement: 'line'
, the default is to let the renderer choose a placement wheremaxAngle
is not exceeded.textBaseline
string | undefined <optional>
Text base line. Possible values: 'bottom', 'top', 'middle', 'alphabetic', 'hanging', 'ideographic'. Default is 'middle'.
fill
ol.style.Fill | undefined <optional>
Fill style. If none is provided, we'll use a dark fill-style (#333).
stroke
ol.style.Stroke | undefined <optional>
Stroke style.
backgroundFill
ol.style.Fill | undefined <optional>
Fill style for the text background when
placement
is'point'
. Default is no fill.backgroundStroke
ol.style.Stroke | undefined <optional>
Stroke style for the text background when
placement
is'point'
. Default is no stroke.padding
Array.<number> | undefined <optional>
Padding in pixels around the text for decluttering and background. The order of values in the array is
[top, right, bottom, left]
. Default is[0, 0, 0, 0]
.