@dlr-eoc/utils-maps

dlr-eoc/utils-maps

This library contains a collection of utilities that do not themselves depend on angular.

ol

Utilities that help in the management of openlayers.

• flattenLayers: layers can be arbitrarily nested. This function flattens such a nested collection.

Utilities for copying the images of openlayers' multiple canvases into one, ready to download.

• mapToSingleCanvas
• scaledMapToSingleCanvas
• simpleMapToCanvas

Example usage:

  previewButton.addEventListener('click', () => {
    simpleMapToCanvas(map, previewCanvas, paper.widthPx, paper.heightPx, (updated) => {
        console.log('done');
    });
  });
  downloadButton.addEventListener('click', () => {
     downloadUrl(previewCanvas.toDataURL('image/png'), 'full');
  });

Custom renderers. Openlayers allows us to define our own, custom renderers. Currently we have:

• minimal_renderer contains an absolute minimal example of what is required to create a custom renderer
• dtm_renderer illustrates how WebGL can make use of normal-maps
• particle_renderer procedurally generates little white particles that move along a force-field (that the user may change at any point)
• interpolation_renderer does an inverse distance interpolation between a set of data-points on a per-pixel basis.

webgl

This is a simple object-oriented abstraction of the webgl-api.

• webgl.ts contains a very simple wrapper around the native webgl-api-calls. It only attempts to group commonly associated operations and abstract away the details of data-assignment.
• engine.core.ts is a object-oriented wrapper around webgl.ts. Creating an instance of the class Shader will make sure the programmer has provided all the required attributes, uniforms, textures and indices, and also simplify binding and drawing. There's even some - limited - glsl-parsing to avoid the most common errors in shader-programming.
• engine.shapes.ts contains a few commonly used vertex-primitives like triangles, rectangles, boxes, etc., as well as shape-building helpers like a Bezier-curve creator.

Development

The utils libraries are all designed to have no production dependencies on angular. The primary objective here is to create utilities that can be used in other frameworks or framework-independent. Such utilities might take on the form of libraries of webcomponents.

Inspired by clarity-design's shift to a framework-independent core, we strive to make those utilities available outside of angular, while at the same time cause minimal disruptions in the current usage of all those outsourced tools.

We intend to obtain this goal by:

• Minimal disruptions to the current usage: When a components or parts of them are moved to a utils-library, we maintain a wrapper that keeps the angular-template syntax. We strive to minimize breaking changes.
• Minimal external dependencies: We hope to make our utils as atomic as possible, meaning that we'll avoid external dependencies where possible. We will, of course, still use very important libraries like openlayers, but avoid others that are less vital.
• Unopinionated: These utilities are intended to be used in any framework. As such, we try to avoid any Angular- or UKIS-specific idioms that might not fit in with another users idea of how a certain tool is best used.
• Gradual transition: As UKIS matures, we will move more and more functionality out of angular-components and into utility-libraries.
• Keeping up with web-standards: One core motivation for the creation of the utils-libraries was our objective of using some functionality of Ukis within other applications (like static site generators, django, CMS etc) as web components. As a consequence, we intend to design the utilities with modern web-standards and -api's in mind.

Changelog

12.0.0 (2023-12-12) (map-ol, map-cesium and map-maplibre)

Breaking Changes

• Update angular from ^14.2.11 to ^16.2.1 automatic migrations are made by ng update. See update angular from 14.0-15.0 and 14.0-15.0.
• Update @clr/angular and @clr/ui from ^13.17.0 to ^15.12.0. See releases Breaking Changes. Fixes in styles have been made so update the styles folder from projects/core-ui/schematics/ng-add/files/src/styles and also add class="content-area map-view" for content areas that include a map.
• Update rxjs from ^6.6.7 to ~7.8.0. Fixes of deprecations forkJoin(obs,obs) to forkJoin([obs,obs]) and retryWhen() to retry({count: number deley: ()=> }) and combineLatest() to combineLatestWith() and of<T>() to of().

• @dlr-eoc/map-cesium:

  • Remove exported type Tgroupfiltertype. Use Tgroupfiltertype = TFiltertypesUncap | TFiltertypes and import them from @dlr-eoc/services-layers.

• @dlr-eoc/map-ol:

  • Remove exported type Tgroupfiltertype. Use Tgroupfiltertype = TFiltertypesUncap | TFiltertypes and import them from @dlr-eoc/services-layers.
  • Remove color and event from properties passed to raster layer popup. Now IPopupParams is passed so you can use IPopupParams.color and IPopupParams.mapEvent. For the remaining properties, use IPopupParams.properties, which contains feature properties and async data.
  • The parameters of the MapOlService.addPopup function are changed as follows addPopup(popupParams: IPopupParams, popupObj?: popup, html?: string, event?: 'click' | 'move', removePopups?: boolean).
  • The interfaces IPopupArgs and IDynamicPopupArgs have been removed. Use IPopupParams now
  • The dynamic popup now gets IPopupParams instead of IDynamicPopupArgs - popup.dynamicPopup.getAttributes(params:IPopupParams)
  • Not used notifier is removed from MapOlService.setZoom(zoom: number)

• @dlr-eoc/map-tools:

  • Input 'mapSvc' of ProjectionSwitchComponent become mandatory and not optional
  • Additional mandatory input in ProjectionSwitchComponent "mapStateSvc" and optional "fitViewToNewExtent"

Features

• @dlr-eoc/utilities:

  • New UKIS library export utilities for other libraries.

• @dlr-eoc/map-maplibre:

  • A example has been added to the demo-maps to show how to work with the new maplibre library.
  • New UKIS library for working with maplibre was added.

• @dlr-eoc/map-cesium:

  • New UKIS library for working with CesiumJS was added.
  • A new example has been added to the demo-maps to show how to work with the new cesium library.
  • The GeoJsonDatasource in map-cesium was updated and styling of vector layers is now possible.

• @dlr-eoc/services-layers:

  • The layer.popup gets more types and uses IPopupParams which will be applied to all popups.
  • Export new type TFiltertypesUncap to use with TFiltertypes. So Tgroupfiltertype = TFiltertypesUncap | TFiltertypes is usable in maps.

• @dlr-eoc/map-ol:

  • Popup events can be observed by MapOlService.popupEvents: Subject<IPopupEvent>. For this add asObservable: true to a popup object, you will then be able to subscribe to the event instead of having a popup container being added to the map.
  • A new Interface IPopupEvent is exposed.
  • Add groupID to olLayers (layer.groupID) to check if a layer was in an olLayerGroup.

• @dlr-eoc/map-tools:

  • Optional parameter "fitViewToNewExtent" in the ProjectionSwitchComponent to adjust map view extent