#geospatial #read-write #read-file #georeferencing #world-files

world_image_file

Read, write, and project with World Files for georeferenced images

1 unstable release

0.1.0 Jul 20, 2019

#205 in Geospatial


Used in slippy-map-tiles

AGPL-3.0+

15KB
107 lines

world_image_file

Build Status Crates.io Documentation

Read, writes and uses World Files for georeferenced images.

Example

A world file can be created from a string, or read from a file with WorldFile::from_path(&path):

use world_image_file::WorldFile;
let contents = "32.0\n0.0\n0.0\n-32.0\n691200.0\n4576000.0\n";
let w = WorldFile::from_string(&contents).unwrap();

Coordinates can be converted from image pixel to 'world' coordinates, and vice-versa.

# use world_image_file::WorldFile;
# let contents = "32.0\n0.0\n0.0\n-32.0\n691200.0\n4576000.0\n";
# let w = WorldFile::from_string(&contents).unwrap();
assert_eq!(w.image_to_world((171., 343.)), (696672., 4565024.));
assert_eq!(w.world_to_image((696672., 4565024.)), (171., 343.));

Pixel coordinates can be fractional. (10.0, 2.0) refers to the top left of pixel (10, 2). (10.5, 2.5) is in the middle of pixel (10, 2).

World Files do not store any SRID/spatial reference system (SRS)/coordinate reference system (CRS) data. World Files were originally defined by ESRI.

Currently Result<WorldFile, ()> is returned (i.e. all errors are flatted to ()), but this may change to be more descriptive, and would not be seen as a breaking change.

Copyright GNU Affero GPL v3 (or later). See the file LICENCE

No runtime deps