MCubeJNILib  

It provides interface list which controls Mcube 3D Map engine.
Through various interface, users can develop their own Mcube 3D Map.

  1. Fields
  2. static Bitmap mImgNaviStart Start from preview. Save initial location image that will be used in image preview.
    static Bitmap mImgNaviFinish Arrival image in Preview. Save an arrival location image shown in the preview.
    static ArrayList<Bitmap> mImgNaviFlagList Multi-path destination image list for multi-path. It sets distination location image for multiple route.
  3.  
  4. Methods
  5. static void CameraReset() Reset the camera view.
    static void CancelRoute() Cancel the navigation.
    static MCubeJNILib.LicenceResult CheckLicence(String authKey) Determine whether it is an authorized use by issued authentication key.
    static int CheckLicence(String authKey, String deviceId, String licencePath, String packageName)
    static void DeleteMainScene() Closing MapView screen. Close the screen by calling MapView screen in application closing period.
    static MRoute FindPath(int floorSeq, float x, float y) Find route with flloor sequnence number and location vaule.
    static MRoute FindPathMulti(ArrayList<Integer> labels) Search and load multiple routes.
    static int GetCurrentFloorSeq() Bring currently shown serial number.
    static MPosition GetCurrentPosition() Bring current location value.
    static float GetDistance() Return distance value between center points of camera and view.
    static int getFilterValue(EnumSet<MCubeJNILib.POIType> filter) Bring POI filter value. It brings filter value when POI is set to show.
    static int GetFloorSeq(int buildingSeq, int floorNo) Bring floor seqeunce number with building sequence number and floor number.
    static MLabel GetLabel(int labelSeq) Provides MLabel with label sequency numebr.
    static MPoi GetPoi(int poiSeq) Provides MPoil with label sequency numebr.
    static float GetRotateAngle() Return map's horizaontal rotation value.
    static int GetTrackingLevel() Bring tracking level value.
    static float GetVerticalAngle() Return map's vertical rotation value.
    static int HitTestLabel(int x, int y) Check whether it is touched in the labeled area.
    static int HitTestPOI(int x, int y) Check whether it is touched in the POI area.
    static void InitMainScene() Reset MapView screen. It is called when resetting the screen.
    static void LoadFloor(int floorSeq) Load map with floor sequence number.
    static void LoadFloorNo(int floorNo) Load map with floor number.
    static void MouseButton(int button, int action) It is called when the screen is touched.
    static void MouseMove(int x, int y) When touched, it moves received coordinates.
    static void MoveCameraToCurrentPosition() Set the camera view to current location.
    static void PrepareData()
    static void Render() Renders the map.
    static void Scale(float scale) Set scale of the screen.
    static void Scroll(float scrx, float scry) Set scroll of the screen.
    static MRoute SetCurrentPosition(float x, float y) Set current location as World coordinate.
    static MRoute SetCurrentPositionInView(float x, float y) Set current location with coordinates on the view.
    static void SetDensity(float density)
    static void SetDistance(float distance) Return distance value between center points of camera and view.
    static void SetForwardAngle(float angle) Set the route direction's rotation value.
    static void SetInitCameraPosition(float x, float y, float z) Set camera's location when reset.
    static void SetMCubeDB(String dbName)
    static void SetPoiTypeFilter(int filter) Set POIType filter.
    static void SetRotateAngle(float angle) Set map's horizontal rotatoin value.
    static void SetScreenSize(int width, int height) Set map's screen size.
    static void SetTrackingLevel(int level) Set tracking level.
    static void SetVerticalAngle(float vangle) Set map's vertical rotatoin value.
    static void SetWorkingDirectory(String basePath)
    static void ShowCurrentPosition(boolean show)
    static void StartRoute() Start navigation.
    static int ValidFindPath(int floorSeq, float x, float y) Check compeletion status of route finding.
  6.  
  7. Method Details
  8.  
  9. public static MCubeJNILib.LicenceResult CheckLicence(String authKey)

    Determine whether it is an authorized use by issued authentication key.
    If authorized- Success : 0,
    wrong auth key-Invalid: -1,
    If exceed user no. : Return Overflow -2.

    Parameters:

    authKey

  10.  
  11. public static int getFilterValue(EnumSet<MCubeJNILib.POIType> filter)

    Bring POI filter value. It brings filter value when POI is set to show.

    Parameters:

    filter

  12.  
  13. public static void InitMainScene()

    Reset MapView screem: Called when the screen is reset.

  14.  
  15. public static void DeleteMainScene()

    Closing MapView screen: Close the screen by calling MapView screen in application closing period.

  16.  
  17. public static void LoadFloorNo(int floorNo)

    Load map with floor number.

    Parameters:

    floorNo - floor number

  18.  
  19. public static void LoadFloor(int floorSeq)

    Load map with floor sequence number.

    Parameters:

    floorSeq - sequence number

  20.  
  21. public static int GetCurrentFloorSeq()

    Bring the serial number of current floor.

    Parameters:

    Integer

  22.  
  23. public static int GetFloorSeq(int buildingSeq, int floorNo)

    Bring sequence number from building sequence no. or floor no.

    Parameters:

    buildingSeq

    floorNo

  24.  
  25. public static void SetScreenSize(int width, int height)

    Set the size of map screen.

    Parameters:

    width

    height

  26.  
  27. public static void Render()

    Render the map.

  28.  
  29. public static void MouseMove(int x, int y)

    When touched, it moves received coordinates.

    Parameters:

    x - X coordinate

    y - Y coordinate

  30.  
  31. public static void MouseButton(int button, int action)

    It is called when tapping the screen.

    Parameters:

    button - always 1

    action - touchDown = 1, touchUp = 0

  32.  
  33. public static void Scroll(float scrx, float scry)

    Set scroll of the screen.

    Parameters:

    scrx

    scry

  34.  
  35. public static void Scale(float scale)

    Set scale of the screen.

    Parameters:

    scale

  36.  
  37. public static void SetInitCameraPosition(float x, float y, float z)

    Set camera location when resetting.

    Parameters:

    x

    y

    z

  38.  
  39. public static void CameraReset()

    Reset camera view. Move the view to the originally set value.

  40.  
  41. public static float GetDistance()

    Return distance value between center points of camera and view.

    Parameters:

    Distance (Unit: m)

  42.  
  43. public static void SetDistance(float distance)

    Set distance value between center points of camera and view. Set distance which maintains vertical/horizontal angle.

    Parameters:

    distance

  44.  
  45. public static void SetPoiTypeFilter(int filter)

    Set POIType filter. Set POI type which shows in the screen. Set MCBPOIType flag which shows on the screen.

    Parameters:

    filter

  46.  
  47. public static float GetVerticalAngle()

    Return map's vertical rotation value.

    Parameters:

    수직 기울기 각도 - 0~90

  48.  
  49. public static float GetRotateAngle()

    Return map's horizontal rotation value.

    Parameters:

    Vertical rotation value (0~90)

  50.  
  51. public static void SetVerticalAngle(float vangle)

    Set map's vertical rotation value.

  52.  
  53. public static void SetRotateAngle(float angle)

    Set map's horizontal rotation value.

    Parameters:

    angle - horizontal rotation value (0~360)

  54.  
  55. public static int HitTestPOI(int x, int y)

    Check whether POI area is touched.

    Parameters:

    x - X coordinate

    y - Y coordinate

    Returns:

    Sequence No.

  56.  
  57. public static int HitTestLabel(int x, int y)

    Check whether labeled area is touched.

    x - X coordinate

    y - Y coordinate

    Returns:

    Sequence No.

  58.  
  59. public static int GetTrackingLevel()

    Bring tracking level value.

    Returns:

    0: Deactivate tracking.
    1: The tracking is on-going and current location is always on the center.
    2. Current location always set as the center and direction always points the top.

  60.  
  61. public static void SetTrackingLevel(int level)

    Set tracking level value.

    Parameters:

    level - 0: Deactivate tracking.
    1: The tracking is on-going and current location is always on the center.
    2. Current location always set as the center and direction always points the top.

  62.  
  63. public static void MoveCameraToCurrentPosition()

    Set the camera view to current location. Move the camera view to current location. Vertical angle is set vertical to floor plane.

  64.  
  65. public static MRoute SetCurrentPositionInView(float x, float y)

    Set current location with coordinates on the view.

    Parameters:

    x - X coordinate

    y - Y coordinate

    Returns:

    Route data for destination

  66.  
  67. public static MRoute SetCurrentPosition(float x, float y)

    Set current location as World coordinate.

    Parameters:

    x - X coordinate

    y - Y coordinate

    Returns:

    Route data for destination

  68.  
  69. public static MPosition GetCurrentPosition()

    Load current location value. Return current location value. It loads or sets current location on the map.

    Returns:

    MCBPosition locatino data

  70.  
  71. public static void SetForwardAngle(float angle)

    Set the route direction's rotation value.

    Parameters:

    angle - route direction's rotation value (0~360)

  72.  
  73. public static int ValidFindPath(int floorSeq, float x, float y)

    Check completion status of route finding.

    Parameters:

    floorSeq - floor sequence number

    x - X coordinate

    y - Y coordinate

  74.  
  75. public static MPoi GetPoi(int poiSeq)

    Provides MPoi from POI sequence number.

    Parameters:

    poiSeq - MPoi data object

    Returns:

    MPoi

  76.  
  77. public static MLabel GetLabel(int labelSeq)

    Provides MLabel from Label sequence number.

    Parameters:

    labelSeq

    Returns:

    MLabel

  78.  
  79. public static MRoute FindPath(int floorSeq, float x, float y)

    Find route with flloor sequnence number and location vaule.

    Parameters:

    floorSeq - floor sequence number

    x - X coordinate

    y - Y coordinate

    Returns:

    Route data for destination

  80.  
  81. public static MRoute FindPathMulti(ArrayList<Integer> labels)

    Search and load multiple routes.

    Parameters:

    labels - arraylist

    Returns:

    Route data for destination

  82.  
  83. public static void StartRoute()

    Start navigation. Shows navigation on the screen using value previously searched.

  84.  
  85. public static void CancelRoute()

    End navigation. It hides route from the map by canceling navigation.