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, screenPositionToMeters, metersToScreenPosition,
 * selectMapFeature, deselectMapFeature, deselectAllMapFeatures, selectedMapFeatures,
 * zoomFactor, minZoomFactor, maxZoomFactor
 */
class LocationWindowCommonExample {
 
    private var locationWindow: LocationWindow? = null
    private var userLocationView: UserLocationView? = null
    private var userLocationLayer: UserLocationLayer? = null
 
    init {
        demonstrateLocationWindowCommonMethods()
    }
 
    /**
     * Demonstrate LocationWindowCommon methods
     */
    fun demonstrateLocationWindowCommonMethods() {
        println("=== LocationWindowCommon Methods ===")
 
        demonstrateSetSublocationId()
        demonstrateSublocationQueries()
        demonstrateSublocationChangeListener()
        demonstrateUserLocationView()
        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 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(Point(0.0, 0.0), Point(20.0, 30.0))
        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 view properties
     */
    fun demonstrateUserLocationView() {
        println("--- UserLocationView ---")
 
        if (userLocationView == null) {
            println("UserLocationView not available yet")
            return
        }
 
        // [kotlin_UserLocationView_getArrow]
        val arrow = userLocationView!!.arrow
        println("Arrow icon object: $arrow")
        // [kotlin_UserLocationView_getArrow]
 
        // [kotlin_UserLocationView_getAccuracyCircle]
        val accuracyCircle = userLocationView!!.accuracyCircle
        println("Accuracy circle object: $accuracyCircle")
        // [kotlin_UserLocationView_getAccuracyCircle]
    }
 
    /**
     * 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_screenPositionToMeters]
        // Convert screen position to meters
        val screenPoint = Point(100.0, 200.0)
        val metersPoint = locationWindow!!.screenPositionToMeters(screenPoint)
        println("Screen position (${screenPoint.x}, ${screenPoint.y}) converted to meters: (${metersPoint.x}, ${metersPoint.y})")
        // [kotlin_LocationWindow_screenPositionToMeters]
 
        // [kotlin_LocationWindow_screenPositionToMeters_2]
        // Convert another screen position to meters
        val screenPoint2 = Point(500.0, 300.0)
        val metersPoint2 = locationWindow!!.screenPositionToMeters(screenPoint2)
        println("Screen position (${screenPoint2.x}, ${screenPoint2.y}) converted to meters: (${metersPoint2.x}, ${metersPoint2.y})")
        // [kotlin_LocationWindow_screenPositionToMeters_2]
 
        // [kotlin_LocationWindow_metersToScreenPosition]
        // Convert meters to screen position with clipping
        val metersPoint3 = Point(50.0, 75.0)
        val screenPoint3 = locationWindow!!.metersToScreenPosition(metersPoint3, true)
        println("Meters position (${metersPoint3.x}, ${metersPoint3.y}) converted to screen with clipping: (${screenPoint3.x}, ${screenPoint3.y})")
        // [kotlin_LocationWindow_metersToScreenPosition]
 
        // [kotlin_LocationWindow_metersToScreenPosition_2]
        // Convert meters to screen position without clipping
        val metersPoint4 = Point(150.0, 200.0)
        val screenPoint4 = locationWindow!!.metersToScreenPosition(metersPoint4, false)
        println("Meters position (${metersPoint4.x}, ${metersPoint4.y}) converted to screen without clipping: (${screenPoint4.x}, ${screenPoint4.y})")
        // [kotlin_LocationWindow_metersToScreenPosition_2]
 
        // Test coordinate conversion with different values
        val testScreenPoints = listOf(
            Point(0.0, 0.0),
            Point(250.0, 250.0),
            Point(1000.0, 600.0)
        )
 
        for ((index, screenPoint) in testScreenPoints.withIndex()) {
            val metersPoint = locationWindow!!.screenPositionToMeters(screenPoint)
            val backToScreen = locationWindow!!.metersToScreenPosition(metersPoint, false)
            println("Test $index: Screen (${screenPoint.x}, ${screenPoint.y}) -> Meters (${metersPoint.x}, ${metersPoint.y}) -> 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]
}