@mapcatch/util 1.0.0

package/.eslintrc.js

@@ -0,0 +1,53 @@
+module.exports = {
+  root: true,
+  env: {
+    node: true,
+    browser: true,
+  },
+  extends: ['eslint:recommended'],
+  parser: 'babel-eslint',
+  rules: {
+    'no-extra-semi': 'error',
+    'no-console': ['error', { allow: ['warn', 'error'] }],
+    quotes: [
+      'error',
+      'single',
+      {
+        avoidEscape: true,
+        allowTemplateLiterals: true,
+      },
+    ],
+    semi: ['error', 'never'],
+    indent: [
+      'error',
+      2,
+      {
+        SwitchCase: 1,
+        flatTernaryExpressions: true,
+      },
+    ],
+    'comma-dangle': ['error', 'never'],
+    'no-multi-spaces': [
+      'error',
+      {
+        ignoreEOLComments: true,
+      },
+    ],
+    'space-infix-ops': 'error',
+    'space-unary-ops': [
+      'error',
+      {
+        words: true,
+        nonwords: false,
+      },
+    ],
+    'space-before-function-paren': 'error',
+  },
+  globals: {
+    echarts: true,
+  },
+  parserOptions: {
+    ecmaVersion: 7,
+    sourceType: 'module',
+  },
+}

package/.prettierrc

@@ -0,0 +1,4 @@
+{
+  "singleQuote": true,
+  "semi": false
+}

package/README.md

@@ -0,0 +1,44 @@
+# catchUtil
+  Mapcatch系列产品的公共函数、js工具以及相关的配置信息。
+
+## 使用方法
+
+### cdn引入
+```html
+<script src="//unpkg.com/@mapcatch/util@latest/dist/catchUtil.min.js"></script>
+
+<script>
+// 解析jpg中的exif信息
+catchUtil.getPhotoTags(file).then(info => {
+  console.log(info)
+})
+// 生成随机Id
+catchUtil.generateId()
+</script>
+
+```
+
+### 通过npm安装
+```
+npm install @mapcatch/util
+```
+
+```js
+import {getPhotoTags, generateId} from '@mapcatch/util'
+
+// 解析jpg中的exif信息
+getPhotoTags(file).then(info => {
+  console.log(info)
+})
+// 生成随机Id
+generateId()
+```
+## 文档
+更多文档查看[在线文档](./docs/Catolog.md)
+
+## 开发
+```bash
+yarn
+
+yarn build
+```

package/docs/Catolog.md

@@ -0,0 +1,24 @@
+## 目录
+
+catchUtil主要包括四个部分：
+
+- [工具函数](./Util.md)
+
+- [事件管理类](./Event.md)
+
+- [栅格瓦片自定义样式重渲染](./GlOptions.md)
+
+- [常量和配置项](./Constant.md)
+
+### 基本用法
+
+```js
+import {getPhotoTags, generateId} from '@mapcatch/util'
+
+// 解析jpg中的exif信息
+getPhotoTags(file).then(info => {
+  console.log(info)
+})
+// 生成随机Id
+generateId()
+```

package/docs/Util.md

@@ -0,0 +1,170 @@
+## 工具函数
+
+基本用法：
+
+```js
+// 完整引入
+import * as catchUtil from '@mapcatch/util'
+// 或者按需引入
+import {getPhotoTags} from '@mapcatch/util'
+```
+
+### `getPhotoTags(file)`
+
+获取照片文件中的exif信息，例如GPS位置、拍摄的设备型号等。为加快解析速度，可以只截取图片的前64kB进行解析，而不用传整个文件进来解析。
+
+**参数**
+
+*file* `File` 需要解析的文件，必须是HTML5的File对象
+
+**返回值**
+
+`Promise`: 一个Promise对象，用来获取解析结果
+
+**示例**
+
+```js
+getPhotoTags(file).then(info => {
+  console.log(info)
+}).catch(err => {
+  throw err
+})
+```
+
+### `generateId()`
+
+生成一个随机id字符串
+
+**返回值**
+
+`uuid`: 使用uuidv4生成一个随机id
+
+### `formatDate(date)`
+
+将数据库的日期字符串格式化用来前端显示。
+
+**参数**
+
+*date* `Date String` 日期字符串
+
+**返回值**
+
+`String` 格式化以后的日期，如`2023-08-01 12:56:32`
+
+### `formatLocalDate()`
+
+将当前的本地时间转为字符串，这个函数主要是为了解决`.toLocaleDateString()`在不同浏览器结果可能不一致的问题。
+
+**返回值**
+
+`String` 格式化以后的日期，如`2023/8/1 12:56:32`
+
+### `formatFileSize(size)`
+
+将以字节为单位的文件大小自动转为`KB`、`MB`等用来显示。
+
+**参数**
+
+*size* `Number` 文件大小
+
+**返回值**
+
+`String` 格式化以后文件大小，例如`342KB`
+
+### `getPhotoInfo(file)`
+
+获取照片文件的拍摄日期、相机型号和GPS位置信息，与`getPhotoTags(file)`不同，该函数只获取这三个属性，并会将位置信息格式化为十进制度。
+
+**参数**
+
+*file* `File` 需要解析的文件，必须是HTML5的File对象
+
+**返回值**
+
+`Promise`: 一个Promise对象，用来获取解析结果
+
+**示例**
+
+```js
+let info = await getPhotoInfo(file)
+
+/*
+{
+  date: '2020-04-21',
+  Model: 'FC6310R',
+  position: {
+    lng: 110.3456,
+    lat: 32.56434526,
+    alt: 78.432
+  }
+}
+*/
+```
+
+### `getPhotoMeta(file)`
+
+获取照片文件的元数据信息，包括md5和原始exif信息。
+
+> 注意，为了提高解析性能，该接口只计算文件前64KB的md5，用于确保文件的唯一性，但无法保证文件的完整性。
+
+**参数**
+
+*file* `File` 需要解析的文件，必须是HTML5的File对象
+
+**返回值**
+
+`Promise`: 一个Promise对象，用来获取解析结果
+
+**示例**
+
+```js
+let info = await getPhotoMeta(file)
+
+/*
+{
+  md5: '.....',
+  exif: {...}
+}
+*/
+```
+
+### `getGeoCoordOperator(flag)`
+
+一般照片GPS位置中的经纬度用`N`和`E`来表示北纬和东经，但我们程序中通常用带有正负号的十进制度表示，此接口用来根据这些标识来获取正负号。
+
+**参数**
+
+*flag* `String` 经纬度的标识字符
+
+**返回值**
+
+`number`: 1或者-1
+
+**示例**
+
+```js
+getGeoCoordOperator('N')
+// 1
+getGeoCoordOperator('S')
+// -1
+```
+
+### `toRadian(arr)`
+
+将数组表示的度分秒转为带小数的度。
+
+**参数**
+
+*arr* `Array` 度分秒数组
+
+**返回值**
+
+`number`: 十进制度
+
+**示例**
+
+```js
+let arr = [110, 30, 20]
+toRadian(arr)
+// 110.5055555555
+```

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@mapcatch/util",
+  "version": "1.0.0",
+  "main": "./src/index.js",
+  "repository": "",
+  "author": "wanyanyan",
+  "license": "MIT",
+  "scripts": {
+    "build": "vite build",
+    "start": "vite --host",
+    "lint": "eslint src/ --fix",
+    "format": "prettier-eslint --write src/*.js"
+  },
+  "dependencies": {
+    "@turf/turf": "^6.5.0",
+    "gl-matrix": "^3.4.3",
+    "glsl-float-to-rgba": "^1.0.0",
+    "glsl-rgba-to-float": "^1.0.0",
+    "lodash": "^4.17.21",
+    "moment": "^2.29.4",
+    "regl": "^2.1.0",
+    "spark-md5": "^3.0.2",
+    "upng-js": "^2.1.0",
+    "uuid": "^9.0.0"
+  },
+  "devDependencies": {
+    "vite": "^3.0.9",
+    "vite-plugin-glslify": "^2.0.2"
+  }
+}

package/src/constants/cameras.js

@@ -0,0 +1,5 @@
+export default {
+  normal: ['FC6310R', 'FC6310'],
+  infrared: ['M3T'],
+  multispectral: ['FC6360']
+}

package/src/constants/index.js

@@ -0,0 +1 @@
+export {default as cameras} from './cameras'

package/src/event.js

@@ -0,0 +1,205 @@
+// @flow
+
+
+let clickPoint = null
+
+function _addEventListener (type, listener, listenerList) {
+  listenerList[type] = listenerList[type] || []
+  listenerList[type].push(listener)
+}
+
+function _removeEventListener (type, listener, listenerList) {
+  if (listenerList && listenerList[type]) {
+    const index = listenerList[type].indexOf(listener)
+    if (index !== -1) {
+      listenerList[type].splice(index, 1)
+    }
+  }
+}
+
+function extend (dest, ...sources) {
+  for (const src of sources) {
+    for (const k in src) {
+      dest[k] = src[k]
+    }
+  }
+  return dest
+}
+function endsWith (string, suffix) {
+  return string.indexOf(suffix, string.length - suffix.length) !== -1
+}
+
+/**
+ * Methods mixed in to other classes for event capabilities.
+ *
+ * @mixin Evented
+ */
+class Event {
+  constructor () {
+    this._listeners = []
+    this._oneTimeListeners = []
+    this._eventedParent = null
+    this._eventedParentData = null
+  }
+
+  /**
+   * Adds a listener to a specified event type.
+   *
+   * @param {string} type The event type to add a listen for.
+   * @param {Function} 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 {Object} `this`
+   */
+  on (type, listener) {
+    this._listeners = this._listeners || {}
+    //将this._listeners 添加listener事件
+    _addEventListener(type, listener, this._listeners)
+    //返回的this 就是实例Vmap
+    return this
+  }
+
+  /**
+   * Removes a previously registered event listener.
+   *
+   * @param {string} type The event type to remove listeners for.
+   * @param {Function} listener The listener function to remove.
+   * @returns {Object} `this`
+   */
+  off (type, listener) {
+    if (!listener) {
+      this._listeners = {}
+      this._oneTimeListeners = {}
+      return
+    }
+    _removeEventListener(type, listener, this._listeners)
+    _removeEventListener(type, listener, this._oneTimeListeners)
+
+    return this
+  }
+
+  /**
+   * 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.
+   *
+   * @param {string} type The event type to listen for.
+   * @param {Function} listener The function to be called when the event is fired the first time.
+   * @returns {Object} `this`
+   */
+  once (type, listener) {
+    this._oneTimeListeners = this._oneTimeListeners || {}
+    _addEventListener(type, listener, this._oneTimeListeners)
+
+    return this
+  }
+
+  /**
+   * Fires an event of the specified type.
+   *
+   * @param {string} type The type of event to fire.
+   * @param {Object} [data] Data to be passed to any listeners.
+   * @returns {Object} `this`
+   */
+  fire (type, data) {
+    if (this.listens(type)) {
+      data = extend({}, data, { type: type, target: this })
+      //通过判断点击的点位置是否相同来进行e的输出
+      if (clickPoint) {
+        if(data.point && (clickPoint === (data.point.x + data.point.y))) {
+          if (clickPoint === (data.point.x + data.point.y)){
+            return
+          } else {
+            clickPoint = data.point.x + data.point.y
+          }
+        } else if (data.feature) {
+          if (clickPoint === (data.x + data.y)){
+            return
+          } else {
+            clickPoint = data.x + data.y
+          }
+        }
+      } else {
+        if(data.point) {
+          clickPoint = data.point.x + data.point.y
+        } else if (data.feature) {
+          clickPoint = data.x + data.y
+        }
+      }
+
+      // make sure adding or removing listeners inside other listeners won't cause an infinite loop
+      const listeners =
+        this._listeners && this._listeners[type]
+          ? this._listeners[type].slice()
+          : []
+
+      for (let i = 0; i < listeners.length; i++) {
+        listeners[i].call(this, data)
+      }
+
+      const oneTimeListeners =
+        this._oneTimeListeners && this._oneTimeListeners[type]
+          ? this._oneTimeListeners[type].slice()
+          : []
+
+      for (let i = 0; i < oneTimeListeners.length; i++) {
+        oneTimeListeners[i].call(this, data)
+        _removeEventListener(type, oneTimeListeners[i], this._oneTimeListeners)
+      }
+
+      if (this._eventedParent) {
+        this._eventedParent.fire(
+          type,
+          extend(
+            {},
+            data,
+            typeof this._eventedParentData === 'function'
+              ? this._eventedParentData()
+              : this._eventedParentData
+          )
+        )
+      }
+
+      // To ensure that no error events are dropped, print them to the
+      // console if they have no listeners.
+    } else if (endsWith(type, 'error')) {
+      // eslint-disable-next-line
+      console.error((data && data.error) || data || 'Empty error event')
+    }
+
+    return this
+  }
+
+  /**
+   * Returns a true if this instance of Evented or any forwardeed instances of Evented have a listener for the specified type.
+   *
+   * @param {string} type The event type
+   * @returns {boolean} `true` if there is at least one registered listener for specified event type, `false` otherwise
+   */
+  listens (type) {
+    return (
+      (this._listeners &&
+        this._listeners[type] &&
+        this._listeners[type].length > 0) ||
+      (this._oneTimeListeners &&
+        this._oneTimeListeners[type] &&
+        this._oneTimeListeners[type].length > 0) ||
+      (this._eventedParent && this._eventedParent.listens(type))
+    )
+  }
+
+  /**
+   * Bubble all events fired by this instance of Evented to this parent instance of Evented.
+   *
+   * @private
+   * @returns {Object} `this`
+   */
+  setEventedParent (parent, data) {
+    this._eventedParent = parent
+    this._eventedParentData = data
+
+    return this
+  }
+}
+
+export default Event

package/src/exif/exif.js

@@ -0,0 +1,37 @@
+import util from './util'
+
+export const getTag = function (img, tag) {
+  if (!util.imageHasData(img)) return;
+  return img.exifdata[tag];
+}
+
+export const getIptcTag = function (img, tag) {
+  if (!util.imageHasData(img)) return;
+  return img.iptcdata[tag];
+}
+
+export const getAllTags = function (img) {
+  if (!util.imageHasData(img)) return {};
+  var a,
+    data = img.exifdata,
+    tags = {};
+  for (a in data) {
+    if (data.hasOwnProperty(a)) {
+      tags[a] = data[a];
+    }
+  }
+  return tags;
+}
+
+export const getAllIptcTags = function (img) {
+  if (!imageHasData(img)) return {};
+  var a,
+    data = img.iptcdata,
+    tags = {};
+  for (a in data) {
+    if (data.hasOwnProperty(a)) {
+      tags[a] = data[a];
+    }
+  }
+  return tags;
+}

package/src/exif/gps_tags.js

@@ -0,0 +1,33 @@
+export default {
+  0x0000: "GPSVersionID",
+  0x0001: "GPSLatitudeRef",
+  0x0002: "GPSLatitude",
+  0x0003: "GPSLongitudeRef",
+  0x0004: "GPSLongitude",
+  0x0005: "GPSAltitudeRef",
+  0x0006: "GPSAltitude",
+  0x0007: "GPSTimeStamp",
+  0x0008: "GPSSatellites",
+  0x0009: "GPSStatus",
+  0x000A: "GPSMeasureMode",
+  0x000B: "GPSDOP",
+  0x000C: "GPSSpeedRef",
+  0x000D: "GPSSpeed",
+  0x000E: "GPSTrackRef",
+  0x000F: "GPSTrack",
+  0x0010: "GPSImgDirectionRef",
+  0x0011: "GPSImgDirection",
+  0x0012: "GPSMapDatum",
+  0x0013: "GPSDestLatitudeRef",
+  0x0014: "GPSDestLatitude",
+  0x0015: "GPSDestLongitudeRef",
+  0x0016: "GPSDestLongitude",
+  0x0017: "GPSDestBearingRef",
+  0x0018: "GPSDestBearing",
+  0x0019: "GPSDestDistanceRef",
+  0x001A: "GPSDestDistance",
+  0x001B: "GPSProcessingMethod",
+  0x001C: "GPSAreaInformation",
+  0x001D: "GPSDateStamp",
+  0x001E: "GPSDifferential"
+};

package/src/exif/ifd1_tags.js

@@ -0,0 +1,22 @@
+export default {
+  0x0100: "ImageWidth",
+  0x0101: "ImageHeight",
+  0x0102: "BitsPerSample",
+  0x0103: "Compression",
+  0x0106: "PhotometricInterpretation",
+  0x0111: "StripOffsets",
+  0x0112: "Orientation",
+  0x0115: "SamplesPerPixel",
+  0x0116: "RowsPerStrip",
+  0x0117: "StripByteCounts",
+  0x011A: "XResolution",
+  0x011B: "YResolution",
+  0x011C: "PlanarConfiguration",
+  0x0128: "ResolutionUnit",
+  0x0201: "JpegIFOffset",    // When image format is JPEG, this value show offset to JPEG data stored.(aka "ThumbnailOffset" or "JPEGInterchangeFormat")
+  0x0202: "JpegIFByteCount", // When image format is JPEG, this value shows data size of JPEG image (aka "ThumbnailLength" or "JPEGInterchangeFormatLength")
+  0x0211: "YCbCrCoefficients",
+  0x0212: "YCbCrSubSampling",
+  0x0213: "YCbCrPositioning",
+  0x0214: "ReferenceBlackWhite"
+};

package/src/exif/index.js

@@ -0,0 +1,16 @@
+import {getData} from './parse_image'
+import {getAllTags} from './exif'
+
+export const getPhotoTags = (file) => {
+  return new Promise((resolve, reject) => {
+    getData(file, function (img, err) {
+      if (err) {
+        reject(err)
+        return
+      }
+      let info = getAllTags(img)
+      let exif = JSON.parse(JSON.stringify(info).replaceAll('\\u0000', '')) || {}
+      resolve(exif)
+    })
+  })
+}

package/src/exif/iptc_field_map.js

@@ -0,0 +1,12 @@
+export default {
+  0x78: 'caption',
+  0x6E: 'credit',
+  0x19: 'keywords',
+  0x37: 'dateCreated',
+  0x50: 'byline',
+  0x55: 'bylineTitle',
+  0x7A: 'captionWriter',
+  0x69: 'headline',
+  0x74: 'copyright',
+  0x0F: 'category'
+};