import { BaseGcpTransformer } from './BaseGcpTransformer.js'; import { BaseTransformation } from '../transformation-types/BaseTransformation.js'; import type { Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon, Geometry, TypedLineString, TypedPolygon, TypedMultiPoint, TypedMultiLineString, TypedMultiPolygon, TypedGeometry, Bbox } from '@allmaps/types'; import type { GeneralGcp, GeneralGcpAndDistortions, TransformationType, GeneralGcpTransformerOptions, GeneralGcpTransformOptions } from '../shared/types.js'; /** * Class for General Ground Control Point Transformers. * * A General GCP Transformer can transform input geometries between 'source' and 'destination' spaces. * * It does this using a transformation (of a certain type) built from * a set of General Ground Control Points (with coordinates in * source and destination space) and a transformation type. * * It has a method to transform 'Forward' (from source to destination space) * and 'Backward' (from destination to source space), * * The extending GeneralGcpTransform class handles the general case where: * - We read in Ground Control Points using the GeneralGcp type, with `source` and `destination` fields. * - We use the terms 'forward' and 'backward' for the two transformations. * - Both source and destination space are exected to be 2D cartesian spaces with the same handedness (x- and y-axes have the same orientations). * */ export declare class GeneralGcpTransformer extends BaseGcpTransformer { /** * Create a GeneralGcpTransformer * * @param generalGcps - An array of General Ground Control Points (GCPs) * @param type - The transformation type * @param partialGeneralGcpTransformerOptions - General GCP Transformer options */ constructor(generalGcps: GeneralGcp[], type?: TransformationType, partialGeneralGcpTransformerOptions?: Partial); get generalGcps(): GeneralGcp[]; /** * Get the forward transformation. Create if it doesn't exist yet. */ getForwardTransformation(): BaseTransformation; /** * Get the backward transformation. Create if it doesn't exist yet. */ getBackwardTransformation(): BaseTransformation; /** * Get the resolution of the forward transformation in source space, within a given bbox. * * This informs you in how fine the warping is, in source space. * It can be useful e.g. to create a triangulation in source space * that is fine enough for this warping. * * It is obtained by transforming forward two linestring, * namely the horizontal and vertical midlines of the given bbox. * The forward transformation will refine these lines: * it will break them in small enough pieces to obtain a near continuous result. * Returned in the length of the shortest piece, measured in source coordinates. * * @param sourceBbox - BBox in source space where the resolution is requested * @param partialGeneralGcpTransformOptions - General GCP Transform options to consider during the transformation * @returns Resolution of the forward transformation in source space */ getForwardTransformationResolution(sourceBbox: Bbox, partialGeneralGcpTransformOptions: Partial): number | undefined; /** * Get the resolution of the backward transformation in destination space, within a given bbox. * * This informs you in how fine the warping is, in destination space. * It can be useful e.g. to create a triangulation in destination space * that is fine enough for this warping. * * It is obtained by transforming backward two linestring, * namely the horizontal and vertical midlines of the given bbox. * The backward transformation will refine these lines: * it will break them in small enough pieces to obtain a near continuous result. * Returned in the length of the shortest piece, measured in destination coordinates. * * @param destinationBbox - BBox in destination space where the resolution is requested * @param partialGeneralGcpTransformOptions - General GCP Transform options to consider during the transformation * @returns Resolution of the backward transformation in destination space */ getBackwardTransformationResolution(destinationBbox: Bbox, partialGeneralGcpTransformOptions: Partial): number | undefined; transformForward

(point: Point, partialGeneralGcpTransformOptions?: Partial, generalGcpToP?: (generalGcp: GeneralGcpAndDistortions) => P): P; transformForward

(lineString: LineString, partialGeneralGcpTransformOptions?: Partial, generalGcpToP?: (generalGcp: GeneralGcpAndDistortions) => P): TypedLineString

; transformForward

(polygon: Polygon, partialGeneralGcpTransformOptions?: Partial, generalGcpToP?: (generalGcp: GeneralGcpAndDistortions) => P): TypedPolygon

; transformForward

(multiPoint: MultiPoint, partialGeneralGcpTransformOptions?: Partial, generalGcpToP?: (generalGcp: GeneralGcpAndDistortions) => P): TypedMultiPoint

; transformForward

(multiLineString: MultiLineString, partialGeneralGcpTransformOptions?: Partial, generalGcpToP?: (generalGcp: GeneralGcpAndDistortions) => P): TypedMultiLineString

; transformForward

(multiPolygon: MultiPolygon, partialGeneralGcpTransformOptions?: Partial, generalGcpToP?: (generalGcp: GeneralGcpAndDistortions) => P): TypedMultiPolygon

; transformForward

(geometry: Geometry, partialGeneralGcpTransformOptions?: Partial, generalGcpToP?: (generalGcp: GeneralGcpAndDistortions) => P): TypedGeometry

; transformBackward

(point: Point, partialGeneralGcpTransformOptions?: Partial, generalGcpToP?: (generalGcp: GeneralGcpAndDistortions) => P): P; transformBackward

(lineString: LineString, partialGeneralGcpTransformOptions?: Partial, generalGcpToP?: (generalGcp: GeneralGcpAndDistortions) => P): TypedLineString

; transformBackward

(polygon: Polygon, partialGeneralGcpTransformOptions?: Partial, generalGcpToP?: (generalGcp: GeneralGcpAndDistortions) => P): TypedPolygon

; transformBackward

(multiPoint: MultiPoint, partialGeneralGcpTransformOptions?: Partial, generalGcpToP?: (generalGcp: GeneralGcpAndDistortions) => P): TypedMultiPoint

; transformBackward

(multiLineString: MultiLineString, partialGeneralGcpTransformOptions?: Partial, generalGcpToP?: (generalGcp: GeneralGcpAndDistortions) => P): TypedMultiLineString

; transformBackward

(multiPolygon: MultiPolygon, partialGeneralGcpTransformOptions?: Partial, generalGcpToP?: (generalGcp: GeneralGcpAndDistortions) => P): TypedMultiPolygon

; transformBackward

(geometry: Geometry, partialGeneralGcpTransformOptions?: Partial, generalGcpToP?: (generalGcp: GeneralGcpAndDistortions) => P): TypedGeometry

; }