MSFFreeRoamMode

Objective-C

enum MSFFreeRoamMode : NSInteger {}

Swift

enum MSFFreeRoamMode : Int, @unchecked Sendable

Possible free roam modes: what a one-finger drag does, and which camera model the tilt and the rotation follow.

  • Off: the standard map gestures. A one-finger drag pans the map.

    Declaration

    Objective-C

    MSF_FREE_ROAM_MODE_OFF

    Swift

    case FREE_ROAM_MODE_OFF = 0
  • Look: a one-finger drag looks around instead of panning - sideways turns the heading about the camera, up and down tilts the map the way the two-finger tilt does, so the camera still orbits its focus point. Panning moves to a two-finger drag; pinch and two-finger rotation are unchanged.

    Declaration

    Objective-C

    MSF_FREE_ROAM_MODE_LOOK

    Swift

    case FREE_ROAM_MODE_LOOK = 1
  • First person: the camera stops orbiting anything. A one-finger drag turns the view about the CAMERA on both axes, like a mouse in a first person game - the position never changes - and a two-finger drag moves, forward/back and strafing, the way the keys would. Pinch and two-finger rotation are off, since neither belongs to that control scheme.

    The camera model applies to every source, not just to touch: setTilt and setMapRotation turn the view in place too, so a camera driven by the device’s orientation behaves exactly like the drag.

    Declaration

    Objective-C

    MSF_FREE_ROAM_MODE_FIRST_PERSON

    Swift

    case FREE_ROAM_MODE_FIRST_PERSON = 2