[general]
name=Export 2KML
qgisMinimumVersion=3.0
qgisMaximumVersion=4.99
description=Batch‐export vector and raster layers into a single KML or KMZ with QGIS styling. Part of MAS Vector Processing tools.
version=1.1.2
author=Mirjan Ali Sha
email=mastools.help@gmail.com
about=Export 2KML lets you pick any combination of vector and raster layers (with QGIS styling) and generate a single KML (if only vectors) or KMZ (if rasters are involved). Rasters are rendered into opaque PNG overlays so Google Earth will show them properly.
    
    📋 How to Use:
    1. Install the plugin from QGIS Plugin Manager or ZIP file
    2. Add your vector/raster layers to QGIS and apply desired symbology
    3. Access the tool via:
       • Toolbar: "MAS Vector Processing" toolbar icon
       • Menu: Vector → MAS Vector Processing → Export 2KML... or Raster → MAS Raster Processing → Export 2KML...
       • Right-click: Select vector/raster layers in Layer Panel → Export to KML/KMZ
    4. Configure export options:
       • Select layers to export (checkbox column)
       • Click "HTML Table Editor..." button in Description column for advanced styling
       • Set Fill Mode per layer (Auto/Fill/Hollow)
       • Right-click layer rows for per-layer settings (Transparency, Stroke Scale, Labels)
       • Enable "Render as Image" for pattern/complex symbology
       • Map KML properties (Name, Description, etc.) to layer fields
    5. Choose output location (KML for vectors only, KMZ for rasters/images)
    6. Click Export and open in Google Earth!
    
    ⭐ If this plugin helps you, please rate it on the Plugin Repository!
    📧 Feedback/Requests: mastools.help@gmail.com
    ** MAS refers to "Mirjan Ali Sha"
tracker=https://github.com/Mirjan-Ali-Sha/export2kml/issues
repository=https://github.com/Mirjan-Ali-Sha/export2kml

hasProcessingProvider=no
category=Vector
icon=export2kml.png
experimental=False
deprecated=False
server=False
changelog=

    1.1.2 - 2026-08-09
        • QGIS 4 and Qt6 compatibility updates
        • Fixed all Bandit security audit issues
    1.1.1 - Raster Context Menu & Raw Export Enhancements:
        - NEW: Enabled right-click context menu "Export to KML/KMZ" for raster layers and mixed layer selections in the Layer Tree
        - NEW: Added "Export 2KML..." action to the top-level QGIS Raster menu (Raster → MAS Raster Processing)
        - NEW: Added "Original (TIFF)" option to Image Format dropdown and set PNG as the default lossless format for Raw Raster mode (ensuring 100%% KML/KMZ compatibility without pixel manipulation)
    1.1.0 - Feature & Performance Improvements:
        - IMPROVED: Added proper table header to the default HTML table.
    1.0.4 - Plugin Packaging Improvements:
        - FIXED: Multiline f-string issues with flake8 fixes
    1.0.3 - HTML Description Editor:
        - NEW: Rich HTML template editor for feature descriptions
        - WYSIWYG-style editor with formatting tools
        - Supports all HTML table features with field placeholders
        - Auto-generated HTML table templates
        - Preview before exporting
    1.0.2 - Per-Layer Fill Mode Control:
        - NEW: "Fill Mode" dropdown per layer (Auto/Fill/Hollow)
        - Works for both vector KML and "Render as Image" modes
        - Hollow option removes polygon fill for image rendering
        - Transparent background for image export fixed
    1.0.1 - Hollow Polygon Fixes:
        - Added "Force Hollow Polygons" checkbox option for explicit control
        - Fixed transparent background for vector-as-image rendering
        - Improved hollow polygon detection (checks brushStyle and alpha)
        - Uses QgsMapRendererCustomPainterJob for proper transparency
    1.0.0 - Complex Symbology & Layer Order:
        - New "Render Vectors as Images" option for complex symbology
        - Preserves patterns, gradients, SVG markers, geometry generators
        - Layer order now preserved (bottom-to-top processing)
        - Top layers in QGIS appear on top in Google Earth
        - Fixed hollow polygon symbology (outline-only polygons)
    0.7 - Raster KMZ Export Fix:
        - Fixed "Zero positional arguments expected" error for rasters
        - Transparency/nodata preservation (no more white backgrounds)
        - Large raster support (auto-scales to max 4096px)
        - Progress feedback during raster processing
        - Better error handling with user-friendly messages
    0.6 - Context Menu & Bug Fixes:
        - Added right-click context menu in Layer panel
        - Support for multiple layer selection export
        - Fixed duplicate toolbar icons on plugin reload
    0.5 - Major Update:
        - Added QGIS Symbology Preservation (colors, line widths, fills)
        - Supports Single Symbol, Categorized, and Graduated renderers
        - StyleMap for normal/highlight states in Google Earth
        - Custom Point Icons: QGIS markers rendered to PNG in KMZ
        - Added "Export Selected Features Only" option
        - Progress bar for export status
        - Label styles included with point features
        - QGIS Message Log integration
    0.4 - Adding Layer's current CRS.
        - Fixed Some issues related to CRS.

tags=kml, kmz, export, raster, vector, QGIS, plugin, symbology, style, Google Earth
homepage=https://github.com/Mirjan-Ali-Sha/export2kml/wiki

