Enhancements to copy different geospatial extents to the clipboard

Author: hamiltoncj

Makefile

@@ -1,6 +1,6 @@
 PLUGINNAME = latlontools
 PLUGINS = "$(HOME)"/AppData/Roaming/QGIS/QGIS3/profiles/default/python/plugins/$(PLUGINNAME)
-PY_FILES = latLonTools.py __init__.py copyLatLonTool.py captureCoordinate.py zoomToLatLon.py settings.py multizoom.py mgrs.py showOnMapTool.py mapProviders.py tomgrs.py mgrstogeom.py digitizer.py util.py geom2field.py field2geom.py olc.py provider.py pluscodes.py utm.py coordinateConverter.py geohash.py maidenhead.py latLonFunctions.py
+PY_FILES = latLonTools.py __init__.py copyLatLonTool.py captureCoordinate.py zoomToLatLon.py settings.py multizoom.py mgrs.py showOnMapTool.py mapProviders.py tomgrs.py mgrstogeom.py digitizer.py util.py geom2field.py field2geom.py olc.py provider.py pluscodes.py utm.py coordinateConverter.py geohash.py maidenhead.py latLonFunctions.py captureExtent.py
 EXTRAS = metadata.txt
 
 deploy:

captureExtent.py

@@ -0,0 +1,78 @@
+from qgis.PyQt.QtCore import Qt
+from qgis.PyQt.QtWidgets import QApplication
+from qgis.core import Qgis, QgsCoordinateTransform, QgsCoordinateReferenceSystem, QgsProject
+from qgis.gui import QgsMapToolExtent
+# import traceback
+from .util import epsg4326
+from .settings import settings, CopyExtent
+
+def getExtentString(bbox, src_crs, dst_crs):
+    if src_crs != dst_crs:
+        transform = QgsCoordinateTransform(src_crs, dst_crs, QgsProject.instance())
+        bbox = transform.transformBoundingBox(bbox)
+    delim = settings.bBoxDelimiter
+    prefix = settings.bBoxPrefix
+    suffix = settings.bBoxSuffix
+    precision = settings.bBoxDigits
+    outStr = ''
+    minX = bbox.xMinimum()
+    minY = bbox.yMinimum()
+    maxX = bbox.xMaximum()
+    maxY = bbox.yMaximum()
+    if settings.bBoxFormat == CopyExtent.WSEN:  # minX,minY,maxX,maxY (W,S,E,N)
+        outStr = '{:.{prec}f}{}{:.{prec}f}{}{:.{prec}f}{}{:.{prec}f}'.format(
+            minX, delim, minY, delim, maxX, delim, maxY, prec=precision)
+    elif settings.bBoxFormat == CopyExtent.WESN:  # minX,maxX,minY,maxY (W,E,S,N)
+        outStr = '{:.{prec}f}{}{:.{prec}f}{}{:.{prec}f}{}{:.{prec}f}'.format(
+            minX, delim, maxX, delim, minY, delim, maxY, prec=precision)
+    elif settings.bBoxFormat == CopyExtent.SWNE:  # minY,minX,maxY,maxX (S,W,N,E)
+        outStr = '{:.{prec}f}{}{:.{prec}f}{}{:.{prec}f}{}{:.{prec}f}'.format(
+            minY, delim, minX, delim, maxY, delim, maxX, prec=precision)
+    elif settings.bBoxFormat == CopyExtent.Poly1:  # x1 y1,x2 y2,x3 y3,x4 y4,x1 y1 - Polygon format
+        outStr = '{:.{prec}f} {:.{prec}f},{:.{prec}f} {:.{prec}f},{:.{prec}f} {:.{prec}f},{:.{prec}f} {:.{prec}f},{:.{prec}f} {:.{prec}f}'.format(
+            minX, minY, minX, maxY, maxX, maxY, maxX, minY, minX, minY, prec=precision)
+    elif settings.bBoxFormat == CopyExtent.Poly2:  # x1,y1 x2,y2 x3,y3 x4,y4 x1,y1 - Polygon format
+        outStr = '{:.{prec}f},{:.{prec}f} {:.{prec}f},{:.{prec}f} {:.{prec}f},{:.{prec}f} {:.{prec}f},{:.{prec}f} {:.{prec}f},{:.{prec}f}'.format(
+            minX, minY, minX, maxY, maxX, maxY, maxX, minY, minX, minY, prec=precision)
+    elif settings.bBoxFormat == CopyExtent.PolyWkt:  # WKT Polygon
+        outStr = bbox.asWktPolygon()
+    elif settings.bBoxFormat == CopyExtent.MapProxy:  # bbox: [minX, minY, maxX, maxY] - MapProxy
+        outStr = 'bbox: [{}, {}, {}, {}]'.format(
+            minX, minY, maxX, maxY)
+    elif settings.bBoxFormat == CopyExtent.GeoServer:  # bbox=minX,minY,maxX,maxY - GeoServer
+        outStr = 'bbox={},{},{},{}'.format(
+            minX, minY, maxX, maxY)
+    outStr = '{}{}{}'.format(prefix, outStr, suffix)
+    return(outStr)
+
+class CaptureExtentTool(QgsMapToolExtent):
+    def __init__(self, iface, parent):
+        self.iface = iface
+        self.canvas = iface.mapCanvas()
+        QgsMapToolExtent.__init__(self, self.canvas)
+        self.extentChanged.connect(self.getExtent)
+
+    def activate(self):
+        '''When activated set the cursor to a crosshair.'''
+        self.canvas.setCursor(Qt.CrossCursor)
+
+    def deactivate(self):
+        QgsMapToolExtent.deactivate(self)
+        action = self.action()
+        if action:
+            action.setChecked(False)
+        
+    def getExtent(self, bbox):
+        if bbox.isNull():
+            return
+        canvasCRS = self.canvas.mapSettings().destinationCrs()
+        if settings.bBoxCrs == 0:
+            dstCRS = epsg4326
+        else:
+            dstCRS = canvasCRS
+
+        outStr = getExtentString(bbox, canvasCRS, dstCRS)
+
+        clipboard = QApplication.clipboard()
+        clipboard.setText(outStr)
+        self.iface.messageBar().pushMessage("", "'{}' copied to the clipboard".format(outStr), level=Qgis.Info, duration=4)

doc/menu.jpg

@@ -40,6 +40,9 @@ <h1>Lat Lon Tools Plugin</h1>
 <p><strong><em>Lat Lon Tools</em></strong> makes it easy to capture, zoom to coordinates, convert coordinates in text fields into new point layers, export point geometry into text fields, and interact with other on-line mapping tools. It adds MGRS, Standard UTM, Geohash, and Plus Code (Open Location Code) coordinate support to QGIS. When working with <strong>Google Earth</strong>, <strong>Google Maps</strong> or other on-line mapping tools, coordinates are specified in the order of 'Latitude, Longitude'. By default <strong><em>Lat Lon Tools</em></strong> uses the standard Google Map format, but is very flexible and can use virtually any projection and coordinate format for input and output. The following tools are available in <strong><em>Lat Lon Tools</em></strong>.</p>
 <div style="text-align:center"><img src="doc/menu.jpg" alt="Lat Lon Tools Plugin"></div>
 
+<p>Here are the expanded <strong><em>Copy Extents to Clipboard</em></strong> menu items.</p>
+<div style="text-align:center"><img src="doc/menu2.jpg" alt="Lat Lon Tools Plugin"></div>
+
 <p>Some of the functions can be accessed from the <strong><em>Lat Lon Tools</em></strong> toolbar. If for some reason the toolbar is missing, select the menu item <strong><em>View-&gt;Toolbars</em></strong> and make sure <strong><em>Lat Lon Tools Toolbar</em></strong> is enabled. The conversion algorithms can be run from the QGIS Processing Toolbox.</p>
 <div style="text-align:center"><img src="doc/toolbar.jpg" alt="Lat Lon Tools toolbar"></div>
 
@@ -93,6 +96,15 @@ <h1>Lat Lon Tools Plugin</h1>
 </ul>
 </li>
 <li>
+<p><strong><em>Copy Extents to Clipboard</em></strong> - There are four tools used to copy a bounding box extent to the clipboard. The bounding box format is determined in settings dialog. The output CRS for the bounding box extent is either that of the QGIS project or EPSG:4326. The four copy extent tools are:</p>
+<ul>
+<li><img src="images/copycanvas.png" alt="Copy canvas bounding box"> - Copy the canvas bounding box extent to the clipboard.</li>
+<li><img src="images/copyextent.png" alt="Copy selected area to an extent"> - Interactively select a region on the map to extract its bounding box extent and copy it to the clipboard.</li>
+<li><img src="images/copylayerextent.png" alt="Copy selected area to an extent"> - Copy the selected layer's extent. In some vector layers, this value may be estimated and not exact depending on how the layer was imported into QGIS.</li>
+<li><img src="images/copyselectedlayerextent.png" alt="Copy selected area to an extent"> - Copy the bounding box extent of selected features in a vector layer. If no features are selected then nothing will be copied. If the layer is not a vector layer, then the bounding box extent of the layer will be copied. In some vector layers, the bounding box extent may be estimated and not exact depending on how the layer was imported into QGIS.</li>
+</ul>
+</li>
+<li>
 <p><img src="doc/conversion.jpg" alt="Coordinate Conversion"> <strong><em>Coordinate Conversion Tool</em></strong> - This dialog provides a way to either type in a coordinate or grab a coordinate from the map and convert it to a number of different formats.</p>
 <p><div style="text-align:center"><img src="doc/coordinateConversion.jpg" alt="Coordinate Conversion"></div></p>
 <p>Type in a coordinate in any one of the formats listed and then press the enter button or click on the green check box next to the coordinate field and all the other coordinates will be populated. Here are the functions of the following icons:</p>
@@ -155,9 +167,6 @@ <h1>Lat Lon Tools Plugin</h1>
 <p><div style="text-align:center"><img src="doc/geom2pluscodes.jpg" alt="Point layer to Plus Codes"></div></p>
 </li>
 <li>
-<p><img src="images/copycanvas.png" alt="Copy canvas bounding box"> <strong><em>Copy Canvas Bounding Box</em></strong> - Copy the canvas bounding box to the clipboard using one of the formats in settings.</p>
-</li>
-<li>
 <p><img src="doc/settings.png" alt="Settings"> <strong><em>Settings</em></strong> - Displays the settings dialog box (see below).</p>
 </li>
 <li><img src="images/help.png" alt="Help"> <strong><em>Help</em></strong> - Displays this help page.</li>
@@ -307,7 +316,7 @@ <h3>Multi-location Zoom Settings</h3>
 <ul>
 <li><strong><em>Number of extra data fields</em></strong> - Besides <em>Latitude</em>, <em>Longitude</em>, and <em>Label</em>, the user can add up to 10 additional data fields which are labeled as <em>Data1</em>, <em>Data2</em>, ... <em>Data10</em>. By default this is set to 0.</li>
 </ul>
-<h3>BBox Capture Settings</h3>
+<h3>BBox (Bounding Box Extent) Capture Settings</h3>
 <div style="text-align:center"><img src="doc/settings5.jpg" alt="BBOX Capture Settings"></div>
 
 <p>These are the settings for the bounding box capture to clipboard tool.</p>