LocationWindowCommonExample.kt

Go to the documentation of this file.

import kotlinx.coroutines.delay
import kotlinx.coroutines.runBlocking
 
import com.navigine.idl.kotlin.DebugFlag
import com.navigine.idl.kotlin.LocationWindow
 
/**
 * LocationWindowCommon usage example for Kotlin
 * Demonstrates specific methods: setSublocationId, screenPositionToGlobal, globalToScreenPosition,
 * selectMapFeature, deselectMapFeature, deselectAllMapFeatures, selectedMapFeatures,
 * zoomFactor, minZoomFactor, maxZoomFactor
 */
class LocationWindowCommonExample {
 
    private var locationWindow: LocationWindow? = null
    private var userLocationLayer: UserLocationLayer? = null
 
    init {
        demonstrateLocationWindowCommonMethods()
    }
 
    /**
     * Demonstrate LocationWindowCommon methods
     */
    fun demonstrateLocationWindowCommonMethods() {
        println("=== LocationWindowCommon Methods ===")
 
        demonstrateSetSublocationId()
        demonstrateOperatingMode()
        demonstrateSublocationQueries()
        demonstrateSublocationChangeListener()
        demonstrateUserLocationLayer()
        demonstrateCoordinateConversion()
        demonstrateMapFeatureSelection()
        demonstrateApplyLayerFilter()
        demonstrateDebugFlags()
        demonstrateZoomProperties()
    }
 
    /**
     * Demonstrate debug overlay flags (static LocationWindow API).
     */
    fun demonstrateDebugFlags() {
        println("--- Debug flags ---")
 
        // [kotlin_DebugFlag_enum]
        val allFlags = listOf(
            DebugFlag.NONE,
            DebugFlag.INFOS,
            DebugFlag.STATS,
            DebugFlag.LABELS,
            DebugFlag.DRAW_ALL_LABELS,
            DebugFlag.SELECTION_BUFFER
        )
        println("Debug flag enum values: ${allFlags.size}")
        // [kotlin_DebugFlag_enum]
 
        // [kotlin_LocationWindow_setDebugFlag]
        LocationWindow.setDebugFlag(DebugFlag.INFOS, true)
        LocationWindow.setDebugFlag(DebugFlag.STATS, false)
        println("Updated debug flags on LocationWindow")
        // [kotlin_LocationWindow_setDebugFlag]
 
        // [kotlin_LocationWindow_getDebugFlag]
        val infosOn = LocationWindow.getDebugFlag(DebugFlag.INFOS)
        println("Debug flag INFOS enabled: $infosOn")
        // [kotlin_LocationWindow_getDebugFlag]
    }
 
 
    /**
     * Demonstrate operating mode (indoor / outdoor basemap).
     */
    fun demonstrateOperatingMode() {
        println("--- Operating Mode ---")
 
        if (locationWindow == null) {
            println("LocationWindow not available yet")
            return
        }
 
        // [kotlin_OperatingMode_enum]
        val modes = listOf(
            OperatingMode.INDOOR_ONLY,
            OperatingMode.OUTDOOR,
            OperatingMode.OUTDOOR_INDOOR
        )
        println("Operating modes: ${modes.size}")
        // [kotlin_OperatingMode_enum]
 
        // [kotlin_LocationWindow_setOperatingMode]
        locationWindow!!.setOperatingMode(OperatingMode.OUTDOOR_INDOOR)
        println("Set operating mode to OUTDOOR_INDOOR")
        // [kotlin_LocationWindow_setOperatingMode]
 
        // [kotlin_LocationWindow_getOperatingMode]
        val currentMode = locationWindow!!.operatingMode
        println("Current operating mode: $currentMode")
        // [kotlin_LocationWindow_getOperatingMode]
 
        // [kotlin_AttributionAlignment_record]
        val alignment = AttributionAlignment(
            AttributionHorizontalAlignment.RIGHT,
            AttributionVerticalAlignment.BOTTOM)
        // [kotlin_AttributionAlignment_record]
 
        // [kotlin_LocationWindow_setAttributionAlignment]
        locationWindow!!.attributionAlignment = alignment
        // [kotlin_LocationWindow_setAttributionAlignment]
 
        // [kotlin_LocationWindow_getAttribution]
        val attribution = locationWindow!!.attribution
        println("Attribution: $attribution")
        // [kotlin_LocationWindow_getAttribution]
    }
 
    /**
     * Demonstrate setSublocationId method
     */
    fun demonstrateSetSublocationId() {
        println("--- setSublocationId Method ---")
 
        if (locationWindow == null) {
            println("LocationWindow not available yet")
            return
        }
 
        // [kotlin_LocationWindow_setSublocationId]
        // Set sublocation ID to switch between floors
        locationWindow!!.setSublocationId(1)
        println("Set sublocation ID to 1 (first floor)")
        // [kotlin_LocationWindow_setSublocationId]
 
        // [kotlin_LocationWindow_setSublocationId_2]
        // Set sublocation ID to another floor
        locationWindow!!.setSublocationId(2)
        println("Set sublocation ID to 2 (second floor)")
        // [kotlin_LocationWindow_setSublocationId_2]
 
        // [kotlin_LocationWindow_setSublocationId_3]
        // Set sublocation ID to ground floor
        locationWindow!!.setSublocationId(0)
        println("Set sublocation ID to 0 (ground floor)")
        // [kotlin_LocationWindow_setSublocationId_3]
 
        // Test with different sublocation IDs
        val sublocationIds = listOf(1, 2, 3, 0, 5)
        for (id in sublocationIds) {
            locationWindow!!.setSublocationId(id)
            println("Switched to sublocation ID: $id")
        }
    }
 
    /**
     * Demonstrate getters for sublocation and enclosing camera
     */
    fun demonstrateSublocationQueries() {
        println("--- getSublocationId & getEnclosingCamera ---")
 
        if (locationWindow == null) {
            println("LocationWindow not available yet")
            return
        }
 
        // [kotlin_LocationWindow_getSublocationId]
        val currentId = locationWindow!!.getSublocationId()
        if (currentId != null) {
            println("Current sublocation id: $currentId")
        } else {
            println("Current sublocation id is not set")
        }
        // [kotlin_LocationWindow_getSublocationId]
 
        // [kotlin_LocationWindow_getEnclosingCamera]
        val boundingBox = BoundingBox(GlobalPoint(55.75, 37.61), GlobalPoint(55.76, 37.63))
        val camera = locationWindow!!.getEnclosingCamera(boundingBox)
        println("Camera that fits bounding box: $camera")
        // [kotlin_LocationWindow_getEnclosingCamera]
    }
 
    /**
     * Demonstrate sublocation change listener usage
     */
    fun demonstrateSublocationChangeListener() {
        println("--- Sublocation Change Listener ---")
 
        if (locationWindow == null) {
            println("LocationWindow not available yet")
            return
        }
 
        val listener = DemoSublocationChangeListener()
 
        // [kotlin_LocationWindow_addSublocationChangeListener]
        locationWindow!!.addSublocationChangeListener(listener)
        println("Added sublocation change listener")
        // [kotlin_LocationWindow_addSublocationChangeListener]
 
        locationWindow!!.setSublocationId(1)
        locationWindow!!.setSublocationId(2)
 
        // [kotlin_LocationWindow_removeSublocationChangeListener]
        locationWindow!!.removeSublocationChangeListener(listener)
        println("Removed sublocation change listener")
        // [kotlin_LocationWindow_removeSublocationChangeListener]
    }
 
    /**
     * Demonstrate user location layer controls
     */
    fun demonstrateUserLocationLayer() {
        println("--- UserLocationLayer ---")
 
        if (userLocationLayer == null) {
            println("UserLocationLayer not available yet")
            return
        }
 
        // [kotlin_UserLocationLayer_setVisible]
        userLocationLayer!!.setVisible(true)
        println("User location layer set visible")
        // [kotlin_UserLocationLayer_setVisible]
 
        // [kotlin_UserLocationLayer_isVisible]
        val visible = userLocationLayer!!.isVisible
        println("User location layer is visible: $visible")
        // [kotlin_UserLocationLayer_isVisible]
 
        // [kotlin_UserLocationLayer_setAnchor]
        val anchor = ScreenPoint(100.0f, 200.0f)
        userLocationLayer!!.setAnchor(anchor)
        println("Set user location anchor to: (${anchor.x}, ${anchor.y})")
        // [kotlin_UserLocationLayer_setAnchor]
 
        // [kotlin_UserLocationLayer_anchorEnabled]
        val anchorEnabled = userLocationLayer!!.anchorEnabled
        println("Anchor enabled: $anchorEnabled")
        // [kotlin_UserLocationLayer_anchorEnabled]
 
        // [kotlin_UserLocationLayer_resetAnchor]
        userLocationLayer!!.resetAnchor()
        println("Anchor reset to default")
        // [kotlin_UserLocationLayer_resetAnchor]
    }
 
    /**
     * Demonstrate coordinate conversion methods
     */
    fun demonstrateCoordinateConversion() {
        println("--- Coordinate Conversion Methods ---")
 
        if (locationWindow == null) {
            println("LocationWindow not available yet")
            return
        }
 
        // [kotlin_LocationWindow_screenPositionToGlobal]
        val screenPoint = ScreenPoint(100.0, 200.0)
        val globalPoint = locationWindow!!.screenPositionToGlobal(screenPoint)
        println("Screen position (${screenPoint.x}, ${screenPoint.y}) converted to WGS84: (${globalPoint.latitude}, ${globalPoint.longitude})")
        // [kotlin_LocationWindow_screenPositionToGlobal]
 
        // [kotlin_LocationWindow_globalToScreenPosition]
        val globalPoint2 = GlobalPoint(55.7558, 37.6176)
        val screenPoint2 = locationWindow!!.globalToScreenPosition(globalPoint2, true)
        println("WGS84 (${globalPoint2.latitude}, ${globalPoint2.longitude}) converted to screen with clipping: (${screenPoint2.x}, ${screenPoint2.y})")
        // [kotlin_LocationWindow_globalToScreenPosition]
 
        // Test coordinate conversion with different values
        val testScreenPoints = listOf(
            ScreenPoint(0.0, 0.0),
            ScreenPoint(250.0, 250.0),
            ScreenPoint(1000.0, 600.0)
        )
 
        for ((index, screenPoint) in testScreenPoints.withIndex()) {
            val global = locationWindow!!.screenPositionToGlobal(screenPoint)
            val backToScreen = locationWindow!!.globalToScreenPosition(global, false)
            println("Test $index: Screen (${screenPoint.x}, ${screenPoint.y}) -> WGS84 (${global.latitude}, ${global.longitude}) -> Screen (${backToScreen.x}, ${backToScreen.y})")
        }
    }
 
    /**
     * Demonstrate map feature selection methods
     */
    fun demonstrateMapFeatureSelection() {
        println("--- Map Feature Selection Methods ---")
 
        if (locationWindow == null) {
            println("LocationWindow not available yet")
            return
        }
 
        // [kotlin_LocationWindow_selectMapFeature]
        // Select map feature by ID
        val featureId = "room_101"
        val selected = locationWindow!!.selectMapFeature(featureId)
        println("Selected map feature $featureId: $selected")
        // [kotlin_LocationWindow_selectMapFeature]
 
        // [kotlin_LocationWindow_selectMapFeature_2]
        // Select another map feature
        val featureId2 = "office_205"
        val selected2 = locationWindow!!.selectMapFeature(featureId2)
        println("Selected map feature $featureId2: $selected2")
        // [kotlin_LocationWindow_selectMapFeature_2]
 
        // [kotlin_LocationWindow_getSelectedMapFeatures]
        // Get list of selected map features
        val selectedFeatures = locationWindow!!.selectedMapFeatures
        println("Currently selected map features: ${selectedFeatures.size} features")
        for (feature in selectedFeatures) {
            println("  - $feature")
        }
        // [kotlin_LocationWindow_getSelectedMapFeatures]
 
        // [kotlin_LocationWindow_deselectMapFeature]
        // Deselect specific map feature
        val deselected = locationWindow!!.deselectMapFeature(featureId)
        println("Deselected map feature $featureId: $deselected")
        // [kotlin_LocationWindow_deselectMapFeature]
 
        // [kotlin_LocationWindow_deselectMapFeature_2]
        // Deselect another map feature
        val deselected2 = locationWindow!!.deselectMapFeature(featureId2)
        println("Deselected map feature $featureId2: $deselected2")
        // [kotlin_LocationWindow_deselectMapFeature_2]
 
        // [kotlin_LocationWindow_deselectAllMapFeatures]
        // Deselect all map features
        locationWindow!!.deselectAllMapFeatures()
        println("Deselected all map features")
        // [kotlin_LocationWindow_deselectAllMapFeatures]
 
        // [kotlin_LocationWindow_getSelectedMapFeatures_2]
        // Verify all features are deselected
        val remainingFeatures = locationWindow!!.selectedMapFeatures
        println("Remaining selected features after deselect all: ${remainingFeatures.size} features")
        // [kotlin_LocationWindow_getSelectedMapFeatures_2]
 
        // Test multiple feature selection and deselection
        val testFeatureIds = listOf("room_101", "office_205", "meeting_room_301", "cafe_401")
 
        // Select multiple features
        for (featureId in testFeatureIds) {
            val success = locationWindow!!.selectMapFeature(featureId)
            println("Selected feature $featureId: $success")
        }
 
        // Check selected features
        val allSelected = locationWindow!!.selectedMapFeatures
        println("All selected features: ${allSelected.size} features")
 
        // Deselect all at once
        locationWindow!!.deselectAllMapFeatures()
        println("Deselected all features at once")
    }
 
    /**
     * Demonstrate applyLayerFilter method
     */
    fun demonstrateApplyLayerFilter() {
        println("--- applyLayerFilter Method ---")
 
        if (locationWindow == null) {
            println("LocationWindow not available yet")
            return
        }
 
        // [kotlin_MapFilterCondition_constructor]
        // Create filter condition: show only venues with category "Toilet" or "Cafe"
        val condition = MapFilterCondition("category", listOf("Toilet", "Cafe"))
        // [kotlin_MapFilterCondition_constructor]
 
        // [kotlin_LocationWindow_applyLayerFilter]
        // Apply filter to venues layer
        val conditions = listOf(MapFilterCondition("category", listOf("Toilet", "Cafe")))
        locationWindow!!.applyLayerFilter("venues", conditions)
        println("Applied layer filter: show venues with category Toilet or Cafe")
        // [kotlin_LocationWindow_applyLayerFilter]
 
        // Reset filter (show all venues)
        locationWindow!!.applyLayerFilter("venues", emptyList())
        println("Reset layer filter: show all venues")
    }
 
    /**
     * Demonstrate zoom properties
     */
    fun demonstrateZoomProperties() {
        println("--- Zoom Properties ---")
 
        if (locationWindow == null) {
            println("LocationWindow not available yet")
            return
        }
 
        // [kotlin_LocationWindow_getZoomFactor]
        // Get current zoom factor
        val currentZoom = locationWindow!!.zoomFactor
        println("Current zoom factor: $currentZoom")
        // [kotlin_LocationWindow_getZoomFactor]
 
        // [kotlin_LocationWindow_setZoomFactor]
        // Set zoom factor
        locationWindow!!.zoomFactor = 150.0
        println("Set zoom factor to 150.0")
        // [kotlin_LocationWindow_setZoomFactor]
 
        // [kotlin_LocationWindow_getMinZoomFactor]
        // Get minimum zoom factor
        val minZoomFactor = locationWindow!!.minZoomFactor
        println("Minimum zoom factor: $minZoomFactor")
        // [kotlin_LocationWindow_getMinZoomFactor]
 
        // [kotlin_LocationWindow_setMinZoomFactor]
        // Set minimum zoom factor
        locationWindow!!.minZoomFactor = 50.0
        println("Set minimum zoom factor to 50.0")
        // [kotlin_LocationWindow_setMinZoomFactor]
 
        // [kotlin_LocationWindow_getMaxZoomFactor]
        // Get maximum zoom factor
        val maxZoomFactor = locationWindow!!.maxZoomFactor
        println("Maximum zoom factor: $maxZoomFactor")
        // [kotlin_LocationWindow_getMaxZoomFactor]
 
        // [kotlin_LocationWindow_setMaxZoomFactor]
        // Set maximum zoom factor
        locationWindow!!.maxZoomFactor = 300.0
        println("Set maximum zoom factor to 300.0")
        // [kotlin_LocationWindow_setMaxZoomFactor]
 
        // Test zoom factor changes
        val testZoomFactors = listOf(100.0, 125.0, 150.0, 200.0, 250.0)
        for (zoom in testZoomFactors) {
            locationWindow!!.zoomFactor = zoom
            println("Changed zoom factor to: ${locationWindow!!.zoomFactor}")
        }
 
        // Test zoom limits
        println("Testing zoom limits...")
        locationWindow!!.zoomFactor = locationWindow!!.minZoomFactor
        println("Set to minimum zoom: ${locationWindow!!.zoomFactor}")
 
        locationWindow!!.zoomFactor = locationWindow!!.maxZoomFactor
        println("Set to maximum zoom: ${locationWindow!!.zoomFactor}")
 
        // Reset to default
        locationWindow!!.zoomFactor = 100.0
        println("Reset zoom factor to default: ${locationWindow!!.zoomFactor}")
    }
 
    /**
     * Main demonstration method
     */
    suspend fun runExample() {
        println("=== LocationWindowCommon Example ===")
 
        // Simulate LocationWindow initialization
        delay(500)
 
        // TODO: User will implement LocationWindow initialization here
        // locationWindow = getLocationWindow()
 
        // Run demonstrations
        demonstrateLocationWindowCommonMethods()
 
        println("=== Example completed ===")
    }
}
 
/**
 * Function to run the example
 */
fun main() = runBlocking {
    val example = LocationWindowCommonExample()
    example.runExample()
}
 
class DemoSublocationChangeListener : SublocationChangeListener {
    // [kotlin_SublocationChangeListener_onActiveSublocationChanged]
    override fun onActiveSublocationChanged(sublocationId: Int) {
        println("Active sublocation changed to: $sublocationId")
    }
    // [kotlin_SublocationChangeListener_onActiveSublocationChanged]
}