Editing OpenSimulator Internals/Connector Architecture/Gatekeeper Connector (section)

=== GetMapImage() ===

 public UUID GetMapImage(UUID regionID, string imageURL, string storagePath)

Downloads and stores a foreign region's map tile as an asset.

Sequence:
# If no AssetService: returns m_HGMapImage (00000000-0000-1111-9999-000000000013) immediately
# Builds filename: storagePath + regionID + ".jpg"
# If file not on disk: downloads from imageURL via WebClient.DownloadFile()
# Opens as Bitmap, encodes to JPEG2000 via OpenJPEG.EncodeFromImage()
# Stores as AssetType.Texture with random UUID, name "region {regionID}", creator = regionID
# Returns the stored asset UUID

Exception handling: entire sequence wrapped in bare catch -- logs "probably already in the cache" and returns m_HGMapImage. This catches OpenJPEG p/invoke failures specifically (comment says "LEGIT").

m_HGMapImage (00000000-0000-1111-9999-000000000013) is the fallback UUID returned on any failure.

----