@evergis/common 1.0.4-alpha.1 → 1.0.4-alpha.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/dist/cog/cogLayerStyle.d.ts +16 -0
  2. package/dist/cog/colorRamp.d.ts +10 -0
  3. package/dist/cog/index.d.ts +5 -0
  4. package/dist/cog/isCogLayer.d.ts +8 -0
  5. package/dist/cog/rasterHistogram.d.ts +15 -0
  6. package/dist/cog/rasterStyle.d.ts +29 -0
  7. package/dist/common.esm.js +2825 -2661
  8. package/dist/common.esm.js.map +1 -1
  9. package/dist/constants/cog.d.ts +77 -0
  10. package/dist/constants/index.d.ts +2 -0
  11. package/dist/index.d.ts +2 -1
  12. package/dist/index.js +2859 -2663
  13. package/dist/index.js.map +1 -1
  14. package/dist/map/getMapView.d.ts +1 -1
  15. package/dist/map/index.d.ts +0 -2
  16. package/dist/{classification → styling}/ClientStyleValidator/ClientStyleValidator.d.ts +3 -0
  17. package/dist/types/cog.d.ts +84 -0
  18. package/dist/types/index.d.ts +2 -0
  19. package/package.json +1 -1
  20. /package/dist/{map/constants.d.ts → constants/map.d.ts} +0 -0
  21. /package/dist/{classification → styling}/ClientStyleValidator/constants.d.ts +0 -0
  22. /package/dist/{classification → styling}/ClientStyleValidator/index.d.ts +0 -0
  23. /package/dist/{classification → styling}/ClientStyleValidator/types.d.ts +0 -0
  24. /package/dist/{classification → styling}/combineInterpolateStops.d.ts +0 -0
  25. /package/dist/{classification → styling}/enrichStyleItemsWithIds.d.ts +0 -0
  26. /package/dist/{classification → styling}/enrichStyleModelsWithIds.d.ts +0 -0
  27. /package/dist/{classification → styling}/expressions/concat.d.ts +0 -0
  28. /package/dist/{classification → styling}/expressions/index.d.ts +0 -0
  29. /package/dist/{classification → styling}/findAttributeInExpression.d.ts +0 -0
  30. /package/dist/{classification → styling}/getActualExtrusionHeight.d.ts +0 -0
  31. /package/dist/{classification → styling}/getClassificationFromExpression.d.ts +0 -0
  32. /package/dist/{classification → styling}/getClassificationList.d.ts +0 -0
  33. /package/dist/{classification → styling}/getClientStyleItemId.d.ts +0 -0
  34. /package/dist/{classification → styling}/getInterpolateStops.d.ts +0 -0
  35. /package/dist/{classification → styling}/getLayerClientStyle.d.ts +0 -0
  36. /package/dist/{classification → styling}/getStyleAttributes.d.ts +0 -0
  37. /package/dist/{classification → styling}/getValuesFromExression.d.ts +0 -0
  38. /package/dist/{classification → styling}/index.d.ts +0 -0
  39. /package/dist/{classification → styling}/resyncStyleIcons.d.ts +0 -0
  40. /package/dist/{map/types.d.ts → types/map.d.ts} +0 -0
@@ -0,0 +1,16 @@
1
+ import { OgcGeometryType, QueryLayerServiceInfoDc } from '@evergis/api';
2
+ import { ClientStyle } from '../types';
3
+ /**
4
+ * Тип геометрии слоя-каталога снимков.
5
+ *
6
+ * У обычного слоя он лежит на верхнем уровне конфигурации, а у тайлового каталога — только в
7
+ * описании атрибутов. Без этого фолбэка слой выглядит «сломанным»: иконка становится
8
+ * предупреждающей, а карта отбрасывает слой как слой без геометрии.
9
+ */
10
+ export declare const cogGeometryType: (layer?: QueryLayerServiceInfoDc) => OgcGeometryType | undefined;
11
+ /**
12
+ * Стиль футпринтов сцен. У каталога снимков `clientStyle` разложен по типам геометрии
13
+ * (`{ Point, Polygon, LineString, MultiPolygon }`), а не хранит `items` на верхнем уровне,
14
+ * поэтому набор правил достаётся по типу геометрии слоя.
15
+ */
16
+ export declare const cogClientStyle: (layer?: QueryLayerServiceInfoDc) => ClientStyle | undefined;
@@ -0,0 +1,10 @@
1
+ import { RasterColorStop, RasterStyle } from '../types';
2
+ /** Всё, что нужно таблице цветов: остальное оформление на неё не влияет. */
3
+ type RasterScale = Pick<RasterStyle, "stops" | "interpolation">;
4
+ export declare const buildColorRamp: ({ stops, interpolation }: RasterScale) => Uint8ClampedArray;
5
+ /** Границы шкалы: значения первой и последней ступени. */
6
+ export declare const rampRange: (stops: RasterColorStop[]) => {
7
+ min: number;
8
+ max: number;
9
+ };
10
+ export {};
@@ -0,0 +1,5 @@
1
+ export * from './cogLayerStyle';
2
+ export * from './colorRamp';
3
+ export * from './isCogLayer';
4
+ export * from './rasterHistogram';
5
+ export * from './rasterStyle';
@@ -0,0 +1,8 @@
1
+ import { QueryLayerServiceInfoDc } from '@evergis/api';
2
+ /**
3
+ * Слой-каталог снимков COG: его фичи — футпринты сцен, а сами снимки лежат файлами рядом со слоем.
4
+ *
5
+ * Признак живёт в конфигурации тайлового каталога, поэтому union `configuration` сужается кастом:
6
+ * у остальных вариантов конфигурации такого поля нет.
7
+ */
8
+ export declare const isCogLayer: (layer?: QueryLayerServiceInfoDc) => boolean;
@@ -0,0 +1,15 @@
1
+ import { RasterHistogram } from '../types';
2
+ /**
3
+ * Разбирает статистику канала из PAM-файла GDAL (`warpedCog.tiff.aux.tiff`), который лежит рядом
4
+ * с каждым снимком. Там гистограмма на 256 корзин по каждому каналу и границы значений — этого
5
+ * хватает и на диапазон шкалы, и на растяжку контраста, а весит файл пару килобайт.
6
+ */
7
+ export declare const parseRasterHistograms: (pamXml: string) => RasterHistogram[];
8
+ /**
9
+ * Значение, ниже которого лежит заданная доля пикселей.
10
+ *
11
+ * Крайние значения растра почти всегда выбросы: у снимка это блики и тени, у рельефа единичные
12
+ * впадины. Поэтому диапазон шкалы берут не по min и max, а по перцентилям — иначе вся картинка
13
+ * укладывается в середину шкалы и выглядит однотонной.
14
+ */
15
+ export declare const histogramPercentile: ({ min, max, counts }: RasterHistogram, ratio: number) => number;
@@ -0,0 +1,29 @@
1
+ import { RasterColorStop, RasterHistogram, RasterStyle } from '../types';
2
+ /** Ступени шкалы: цвета раскладываются по диапазону значений равными шагами. */
3
+ export declare const colorStops: (min: number, max: number, colors?: string[]) => RasterColorStop[];
4
+ /**
5
+ * Рабочий диапазон шкалы: перцентили гистограммы.
6
+ *
7
+ * Крайние значения растра почти всегда выбросы, поэтому шкала строится от 2-го до 98-го
8
+ * перцентиля: иначе вся картинка укладывается в её середину и выглядит однотонной.
9
+ */
10
+ export declare const scaleRange: (histogram: RasterHistogram) => {
11
+ min: number;
12
+ max: number;
13
+ };
14
+ /**
15
+ * Оформление растра по статистике его каналов.
16
+ *
17
+ * Значения снимка неизвестны заранее (у геоида это метры со знаком, у температуры градусы, у
18
+ * снимка со спутника яркость), поэтому границы берутся из статистики, а не задаются числом.
19
+ * Одноканальный снимок раскрашивается шкалой, многоканальный собирается композитом; настройки
20
+ * обоих режимов заполняются сразу, чтобы переключение режима ничего не спрашивало.
21
+ */
22
+ export declare const defaultRasterStyle: (histograms: RasterHistogram[], colors?: string[]) => RasterStyle;
23
+ /**
24
+ * Ключ стиля для адреса тайла: меняется вместе с оформлением, чтобы карта перечитала тайлы.
25
+ *
26
+ * Прозрачность в него не входит намеренно — её применяет сама карта, и перечитывать ради неё
27
+ * снимок незачем. Настройки неактивного режима — тоже: на картинку они не влияют.
28
+ */
29
+ export declare const rasterStyleKey: ({ mode, band, stops, interpolation, bands, noData }: RasterStyle) => string;