Struct Transform 

pub struct Transform { /* private fields */ }

A reusable coordinate transformation between two CRS.

Implementations

impl Transform

pub fn new(from_crs: &str, to_crs: &str) -> Result<Self>

Create a transform from authority code strings (e.g., "EPSG:4326").

pub fn with_selection_options( from_crs: &str, to_crs: &str, options: SelectionOptions, ) -> Result<Self>

Create a transform with explicit selection options.

pub fn from_operation( operation_id: CoordinateOperationId, from_crs: &str, to_crs: &str, ) -> Result<Self>

Create a transform from an explicit registry operation id.

pub fn from_epsg(from: u32, to: u32) -> Result<Self>

Create a transform from EPSG codes directly.

pub fn from_crs_defs(from: &CrsDef, to: &CrsDef) -> Result<Self>

Create a transform from explicit CRS definitions.

pub fn from_crs_defs_with_selection_options( from: &CrsDef, to: &CrsDef, options: SelectionOptions, ) -> Result<Self>

Create a transform from explicit CRS definitions with operation-selection options.

Use this when a custom CRS references grid resources and the transform needs an application-supplied crate::grid::GridProvider.

pub fn convert<T: Transformable>(&self, coord: T) -> Result<T>

Transform a single coordinate.

pub fn convert_3d<T: Transformable3D>(&self, coord: T) -> Result<T>

Transform a single 3D coordinate.

pub fn convert_with_diagnostics<T: Transformable>( &self, coord: T, ) -> Result<TransformOutcome<T>>

Transform a single coordinate and report the operation actually used.

When the selected grid-backed operation misses grid coverage, this reports the coverage misses and the lower-ranked fallback operation that produced the result.

pub fn convert_3d_with_diagnostics<T: Transformable3D>( &self, coord: T, ) -> Result<TransformOutcome<T>>

Transform a single 3D coordinate and report the operation actually used.

When the selected grid-backed operation misses grid coverage, this reports the coverage misses and the lower-ranked fallback operation that produced the result.

pub fn source_crs(&self) -> &CrsDef

Return the source CRS definition for this transform.

pub fn target_crs(&self) -> &CrsDef

Return the target CRS definition for this transform.

pub fn selected_operation(&self) -> &CoordinateOperationMetadata

Return metadata for the selected coordinate operation.

pub fn selection_diagnostics(&self) -> &OperationSelectionDiagnostics

Return selection diagnostics for this transform.

pub fn inverse(&self) -> Result<Self>

Build the inverse transform by swapping the source and target CRS.

pub fn transform_bounds( &self, bounds: Bounds, densify_points: usize, ) -> Result<Bounds>

Reproject a 2D bounding box by sampling its perimeter.

pub fn convert_batch<T: Transformable + Clone>( &self, coords: &[T], ) -> Result<Vec<T>>

Batch transform (sequential).

pub fn convert_batch_3d<T: Transformable3D + Clone>( &self, coords: &[T], ) -> Result<Vec<T>>

Batch transform of 3D coordinates (sequential).

pub fn convert_coords_in_place(&self, coords: &mut [Coord]) -> Result<()>

Transform 2D coordinates in place without allocating.

Coordinates before a failing coordinate are left converted; the failing coordinate and subsequent coordinates are left unchanged.

pub fn convert_coords_3d_in_place(&self, coords: &mut [Coord3D]) -> Result<()>

Transform 3D coordinates in place without allocating.

Coordinates before a failing coordinate are left converted; the failing coordinate and subsequent coordinates are left unchanged.

pub fn convert_coords_into( &self, input: &[Coord], output: &mut [Coord], ) -> Result<()>

Transform 2D coordinates from input into an existing output slice.

output must have exactly the same length as input. This API performs no allocation and does not require cloning input coordinates.

pub fn convert_coords_3d_into( &self, input: &[Coord3D], output: &mut [Coord3D], ) -> Result<()>

Transform 3D coordinates from input into an existing output slice.

output must have exactly the same length as input. This API performs no allocation and does not require cloning input coordinates.

pub fn convert_batch_parallel<T: Transformable + Send + Sync + Clone>( &self, coords: &[T], ) -> Result<Vec<T>>

Batch transform with Rayon parallelism.

pub fn convert_batch_parallel_3d<T: Transformable3D + Send + Sync + Clone>( &self, coords: &[T], ) -> Result<Vec<T>>

Batch transform of 3D coordinates with adaptive Rayon parallelism.