world_image_file

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 worldimagefile::WorldFile;

let contents = "32.0\n0.0\n0.0\n-32.0\n691200.0\n4576000.0\n";

let w = WorldFile::from_string(&contents).unwrap();

asserteq!(w.imagetoworld((171., 343.)), (696672., 4565024.)); asserteq!(w.worldtoimage((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 & Licence

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