rastergeoref.h File Reference

#include <QString>
#include <QStringList>

Include dependency graph for rastergeoref.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	openswmmvis::io::rastergeoref::WorldFileParams
	The six lines of an ESRI world file, in file order. More...
struct	openswmmvis::io::rastergeoref::GeorefProbe
	What a cheap read-only open reveals about a raster's georeferencing — for dialog prefill/validation. More...

Namespaces
namespace	openswmmvis
namespace	openswmmvis::io
namespace	openswmmvis::io::rastergeoref

Functions
bool	openswmmvis::io::rastergeoref::parseWorldFile (const QString &path, WorldFileParams *out, QString *err)
	Parses a world file: six whitespace/newline-separated doubles.
QStringList	openswmmvis::io::rastergeoref::worldFileCandidates (const QString &imagePath)
	Conventional world-file sidecar paths for imagePath, in priority order.
void	openswmmvis::io::rastergeoref::worldFileToGeoTransform (const WorldFileParams &wf, double gt[6])
	Converts world-file parameters to a GDAL GeoTransform.
bool	openswmmvis::io::rastergeoref::applyPamGeoref (const QString &imagePath, const double *gt6, const QString &crsWkt, QString *err)
	Persists georeferencing on imagePath so every later plain GDAL open sees it.
GeorefProbe	openswmmvis::io::rastergeoref::probeGeoref (const QString &imagePath)
	Probes imagePath read-only; never fails (an unopenable file simply yields a default-constructed probe).
QString	openswmmvis::io::rastergeoref::authCodeToWkt (const QString &authCode, QString *err)
	Resolves a CRS identifier ("EPSG:26985" or anything else OGRSpatialReference::SetFromUserInput accepts) to WKT.

Detailed Description

Author

SWMMVis

Date

2026

License\n GPL-3.0-or-later

World-file parsing and GDAL PAM georeferencing helpers for local raster basemaps (LOCAL_RASTER_BASEMAP plan, Phase 2).

A plain image (PNG/JPEG/BMP, or a CRS-less GeoTIFF) carries no georeferencing of its own. These free functions parse the conventional ESRI world-file sidecar, convert its pixel-CENTER anchor to the GDAL GeoTransform's pixel-CORNER anchor, and persist SRS + GeoTransform so that every subsequent plain GDAL open — the initial open, the pooled tile-warp handles, overview builds, project restore — sees the georeferencing with no changes to GISRasterLayer's open paths. Persistence goes through the driver's native update path when it supports one (GTiff), or the standard PAM sidecar "<image>.aux.xml" otherwise (PNG/JPEG refuse update opens).