OffscreenSurface (JNaviCore SDK Documentation)

java.lang.Object
- com.mapbar.map.OffscreenSurface

所有已实现的接口:: MapRenderer.Listener

public class OffscreenSurface
extends java.lang.Object
implements MapRenderer.Listener

后台渲染器

嵌套类概要

嵌套类
限定符和类型类和说明

static interface OffscreenSurface.Listener
事件监听

嵌套类
限定符和类型	类和说明
`static interface`	`OffscreenSurface.Listener` 事件监听

构造器概要

构造器
构造器和说明

OffscreenSurface(int width, int height, MapRenderer mapRenderer)
构造方法，需要指定后台渲染表面的宽高

构造器
构造器和说明
`OffscreenSurface(int width, int height, MapRenderer mapRenderer)` 构造方法，需要指定后台渲染表面的宽高

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`MapRenderer`	`getMapRenderer()` 获取地图渲染器 `MapRenderer`
`void`	`onAnnotationClicked(Annotation annot, int area)` 点击`Annotation`时触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中，在点击`Annotation`或其弹出气泡时被调用
`void`	`onAnnotationDeselected(Annotation annot)` 当`Annotation`未被选中时触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中
`void`	`onAnnotationSelected(Annotation annot)` 当`Annotation`被选中时触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中，当`Annotation`的图标被点击，但它的弹出气泡没有想显示的情况下出发此回调。
`void`	`onCameraAnimationEnded()` 摄像机变换动画结束后的回调函数
`void`	`onCameraChanged(int changeType)` 相机状态发生改变时触发的回调
`void`	`onFocusChanged(int prevFocusedType, int curFocusedType)` 新的`Annotation`,`Overlay`和POI被选中成为焦点时被触发
`void`	`onGestureAnimationEvent(boolean animStarted)` 手势动画开始和结束时的回调
`void`	`onLayerTilesLoaded(int[] layerTypes)` 在新的镜头视角下，至少一块地图分块数据加载完毕时触发，如，基础地图数据和TMC底图数据此方法是在`MapRenderer.draw()`中调用的，所以是在绘图线程中被调用
`void`	`onLayerTilesReadyForDraw(int[] layerTypes)` 监测状态中`MapRenderer.monitorDataReadiness()` ，当前比例尺下所有格子的某一图层数据准备好时触发，所有图层数据准备好时结束。
`void`	`onNeedsDisplay()` 刷新回调，每次刷新时都会回调此函数无特殊情况，不应在此函数中添加处理逻辑，会影响刷新速度
`void`	`onOnlineDataVersionChecked(boolean upgraded)` 在线地图数据版本升级检测回调
`void`	`onOverlayClicked(Overlay overlay, int area)` 点击`Overlay`时触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中，在点击`Overlay`或其弹出气泡时被调用
`void`	`onOverlayDeselected(Overlay overlay)` 当`Overlay`由被选中状态到反选时触发此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中
`void`	`onOverlaySelected(Overlay overlay, android.graphics.Point grabbedPoint)` 当`Overlay`被选中是触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中
`void`	`onOverlaySelectedNds(Overlay overlay, NdsPoint grabbedPoint)` 当`Overlay`被选中是触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中
`void`	`onPause()` 暂停后台渲染
`void`	`onPoiClicked(java.lang.String name, android.graphics.Point pos)` 点击POI时触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中
`void`	`onPoiDeselected(java.lang.String name, android.graphics.Point pos)` 反选POI时触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中
`void`	`onPoiDeselectedNds(java.lang.String name, NdsPoint pos)` 反选POI时触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中
`void`	`onPoiSelected(java.lang.String name, android.graphics.Point pos)` 选中POI时触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中
`void`	`onPoiSelectedNds(java.lang.String name, NdsPoint pos)` 选中POI时触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中
`void`	`onResume()` 恢复后台渲染
`void`	`onTileLoadingFinished()` 地图分块数据加载完毕时触发，如，基础地图数据和TMC底图数据此方法是在`MapRenderer.draw()`中调用的，所以是在绘图线程中被调用
`void`	`onUserRasterDataUpdated(int fromSource)` 用户栅格数据更新，调用`MapRenderer#setDataPreference(int)`和`MapRenderer#setDataUrlPrefix(int, String)` 时触发，说明读取栅格数据时的数据来源
`android.graphics.Bitmap`	`screenShot()` 截图，只能在`OffscreenSurface.Listener.onDrawFrame(GL10)`中调用
`void`	`setListener(OffscreenSurface.Listener listener)` 设置监听
`void`	`setRenderInterval(int interval)` 设置帧之间的等待间隔
`void`	`setViewport(android.graphics.Rect viewport)` 设置地图渲染器的绘制区域
`void`	`start()` 初始化后台渲染环境，并开始绘制。
`void`	`stop()` 结束渲染

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - OffscreenSurface
```
public OffscreenSurface(int width,
                        int height,
                        MapRenderer mapRenderer)
```
    构造方法，需要指定后台渲染表面的宽高
    
    参数:
    
    width - 宽
    
    height - 高
    
    mapRenderer - 渲染器
- 方法详细资料
  - getMapRenderer
```
public MapRenderer getMapRenderer()
```
    获取地图渲染器 MapRenderer
    
    返回:
    
    MapRenderer
  - start
```
public void start()
```
    初始化后台渲染环境，并开始绘制。须在MapView的渲染线程创建完之后使用。
  - stop
```
public void stop()
```
    结束渲染
  - setRenderInterval
```
public void setRenderInterval(int interval)
```
    设置帧之间的等待间隔
    
    参数:
    
    interval - 间隔，单位：ms
  - setListener
```
public void setListener(OffscreenSurface.Listener listener)
```
    设置监听
    
    参数:
    
    listener - OffscreenSurface.Listener
  - setViewport
```
public void setViewport(android.graphics.Rect viewport)
```
    设置地图渲染器的绘制区域
    
    参数:
    
    viewport - 绘制区域
  - screenShot
```
public android.graphics.Bitmap screenShot()
```
    截图，只能在OffscreenSurface.Listener.onDrawFrame(GL10)中调用
    
    返回:
    
    截图后的内容
  - onPause
```
public void onPause()
```
    暂停后台渲染
  - onResume
```
public void onResume()
```
    恢复后台渲染
  - onNeedsDisplay
```
public void onNeedsDisplay()
```
    从接口复制的说明: MapRenderer.Listener
    
    刷新回调，每次刷新时都会回调此函数
    无特殊情况，不应在此函数中添加处理逻辑，会影响刷新速度
    
    指定者:
    
    onNeedsDisplay 在接口中 MapRenderer.Listener
  - onAnnotationClicked
```
public void onAnnotationClicked(Annotation annot,
                                int area)
```
    从接口复制的说明: MapRenderer.Listener
    
    点击Annotation时触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中，在点击Annotation或其弹出气泡时被调用
    
    指定者:
    
    onAnnotationClicked 在接口中 MapRenderer.Listener
    
    参数:
    
    annot - 被点击的Annotation
    
    area - 被点击的区域Annotation.Area，如果area为Annotation.Area.icon，表示点击的是Annotation的图标本身
    
    另请参阅:
    
    Annotation, Annotation.Area
  - onAnnotationSelected
```
public void onAnnotationSelected(Annotation annot)
```
    从接口复制的说明: MapRenderer.Listener
    
    当Annotation被选中时触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中，当Annotation的图标被点击，但它的弹出气泡没有想显示的情况下出发此回调。
    
    指定者:
    
    onAnnotationSelected 在接口中 MapRenderer.Listener
    
    参数:
    
    annot - 当前被选中的Annotation
    
    另请参阅:
    
    Annotation
  - onAnnotationDeselected
```
public void onAnnotationDeselected(Annotation annot)
```
    从接口复制的说明: MapRenderer.Listener
    
    当Annotation未被选中时触发的回调此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中
    
    指定者:
    
    onAnnotationDeselected 在接口中 MapRenderer.Listener
    
    参数:
    
    annot - 当前取消选中状态的Annotation
    
    另请参阅:
    
    Annotation
  - onFocusChanged
```
public void onFocusChanged(int prevFocusedType,
                           int curFocusedType)
```
    从接口复制的说明: MapRenderer.Listener
    
    新的Annotation,Overlay和POI被选中成为焦点时被触发
    
    指定者:
    
    onFocusChanged 在接口中 MapRenderer.Listener
    
    参数:
    
    prevFocusedType - 前一个焦点的类型 MapRenderer.FocusedObjType
    
    curFocusedType - 当前焦点类型MapRenderer.FocusedObjType,前后焦点所在的poi, annotation和overlay可以通过onxxSelected和onxxDeselected获取
  - onOverlayClicked
```
public void onOverlayClicked(Overlay overlay,
                             int area)
```
    从接口复制的说明: MapRenderer.Listener
    
    点击Overlay时触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中，在点击Overlay或其弹出气泡时被调用
    
    指定者:
    
    onOverlayClicked 在接口中 MapRenderer.Listener
    
    参数:
    
    overlay - 被点击的Overlay
    
    area - 被点击的区域Annotation.Area，如果回调的area为Annotation.Area.icon，表示点击的是Overlay本身
    
    另请参阅:
    
    Overlay, Annotation.Area
  - onOverlaySelected
```
public void onOverlaySelected(Overlay overlay,
                              android.graphics.Point grabbedPoint)
```
    从接口复制的说明: MapRenderer.Listener
    
    当Overlay被选中是触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中
    
    指定者:
    
    onOverlaySelected 在接口中 MapRenderer.Listener
    
    参数:
    
    overlay - 被点击的Overlay
    
    grabbedPoint - 距离点击点最近的有效点坐标，通常情况下，这个点就是点击点本身，但是对于PolylineOverlay或者RouteOverlay可能不是点击点
  - onOverlaySelectedNds
```
public void onOverlaySelectedNds(Overlay overlay,
                                 NdsPoint grabbedPoint)
```
    从接口复制的说明: MapRenderer.Listener
    
    当Overlay被选中是触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中
    
    指定者:
    
    onOverlaySelectedNds 在接口中 MapRenderer.Listener
    
    参数:
    
    overlay - 被点击的Overlay
    
    grabbedPoint - 距离点击点最近的有效Nds坐标，通常情况下，这个点就是点击点本身，但是对于PolylineOverlay或者RouteOverlay可能不是点击点
  - onOverlayDeselected
```
public void onOverlayDeselected(Overlay overlay)
```
    从接口复制的说明: MapRenderer.Listener
    
    当Overlay由被选中状态到反选时触发
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中
    
    指定者:
    
    onOverlayDeselected 在接口中 MapRenderer.Listener
    
    参数:
    
    overlay - 触发事件的Overlay
  - onPoiSelected
```
public void onPoiSelected(java.lang.String name,
                          android.graphics.Point pos)
```
    从接口复制的说明: MapRenderer.Listener
    
    选中POI时触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中
    
    指定者:
    
    onPoiSelected 在接口中 MapRenderer.Listener
    
    参数:
    
    name - POI名称
    
    pos - POI所在位置经纬度坐标
  - onPoiDeselected
```
public void onPoiDeselected(java.lang.String name,
                            android.graphics.Point pos)
```
    从接口复制的说明: MapRenderer.Listener
    
    反选POI时触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中
    
    指定者:
    
    onPoiDeselected 在接口中 MapRenderer.Listener
    
    参数:
    
    name - POI名称
    
    pos - POI所在位置经纬度坐标值
  - onPoiSelectedNds
```
public void onPoiSelectedNds(java.lang.String name,
                             NdsPoint pos)
```
    从接口复制的说明: MapRenderer.Listener
    
    选中POI时触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中
    
    指定者:
    
    onPoiSelectedNds 在接口中 MapRenderer.Listener
    
    参数:
    
    name - POI名称
    
    pos - POI所在的NDS坐标
  - onPoiDeselectedNds
```
public void onPoiDeselectedNds(java.lang.String name,
                               NdsPoint pos)
```
    从接口复制的说明: MapRenderer.Listener
    
    反选POI时触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中
    
    指定者:
    
    onPoiDeselectedNds 在接口中 MapRenderer.Listener
    
    参数:
    
    name - POI名称
    
    pos - POI所在位置的NDS坐标值
  - onPoiClicked
```
public void onPoiClicked(java.lang.String name,
                         android.graphics.Point pos)
```
    从接口复制的说明: MapRenderer.Listener
    
    点击POI时触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中
    
    指定者:
    
    onPoiClicked 在接口中 MapRenderer.Listener
    
    参数:
    
    name - POI名称
    
    pos - POI所在位置的坐标
  - onCameraChanged
```
public void onCameraChanged(int changeType)
```
    从接口复制的说明: MapRenderer.Listener
    
    相机状态发生改变时触发的回调
    
    指定者:
    
    onCameraChanged 在接口中 MapRenderer.Listener
    
    参数:
    
    changeType - 相机参数改变类型MapRenderer.CameraSetting
    
    另请参阅:
    
    MapRenderer.CameraSetting
  - onGestureAnimationEvent
```
public void onGestureAnimationEvent(boolean animStarted)
```
    从接口复制的说明: MapRenderer.Listener
    
    手势动画开始和结束时的回调
    
    指定者:
    
    onGestureAnimationEvent 在接口中 MapRenderer.Listener
    
    参数:
    
    animStarted - 动画开始时为true，结束时为false
  - onCameraAnimationEnded
```
public void onCameraAnimationEnded()
```
    从接口复制的说明: MapRenderer.Listener
    
    摄像机变换动画结束后的回调函数
    
    指定者:
    
    onCameraAnimationEnded 在接口中 MapRenderer.Listener
  - onTileLoadingFinished
```
public void onTileLoadingFinished()
```
    从接口复制的说明: MapRenderer.Listener
    
    地图分块数据加载完毕时触发，如，基础地图数据和TMC底图数据
    此方法是在MapRenderer.draw()中调用的，所以是在绘图线程中被调用
    
    指定者:
    
    onTileLoadingFinished 在接口中 MapRenderer.Listener
  - onLayerTilesLoaded
```
public void onLayerTilesLoaded(int[] layerTypes)
```
    从接口复制的说明: MapRenderer.Listener
    
    在新的镜头视角下，至少一块地图分块数据加载完毕时触发，如，基础地图数据和TMC底图数据
    此方法是在MapRenderer.draw()中调用的，所以是在绘图线程中被调用
    
    指定者:
    
    onLayerTilesLoaded 在接口中 MapRenderer.Listener
    
    参数:
    
    layerTypes - 已经加载完成的图层瓦片对象 count，加载完成的图层瓦片数量
  - onLayerTilesReadyForDraw
```
public void onLayerTilesReadyForDraw(int[] layerTypes)
```
    从接口复制的说明: MapRenderer.Listener
    
    监测状态中MapRenderer.monitorDataReadiness() ，当前比例尺下所有格子的某一图层数据准备好时触发，所有图层数据准备好时结束。
    
    指定者:
    
    onLayerTilesReadyForDraw 在接口中 MapRenderer.Listener
    
    参数:
    
    layerTypes - 数据准备好的图层LayerType
  - onOnlineDataVersionChecked
```
public void onOnlineDataVersionChecked(boolean upgraded)
```
    从接口复制的说明: MapRenderer.Listener
    
    在线地图数据版本升级检测回调
    
    指定者:
    
    onOnlineDataVersionChecked 在接口中 MapRenderer.Listener
    
    参数:
    
    upgraded - 是否升级，如果升级则返回true，否则返回false
  - onUserRasterDataUpdated
```
public void onUserRasterDataUpdated(int fromSource)
```
    从接口复制的说明: MapRenderer.Listener
    
    用户栅格数据更新，调用MapRenderer#setDataPreference(int)和MapRenderer#setDataUrlPrefix(int, String) 时触发，说明读取栅格数据时的数据来源
    
    指定者:
    
    onUserRasterDataUpdated 在接口中 MapRenderer.Listener
    
    参数:
    
    fromSource - 数据来源DataPreference

类 OffscreenSurface

嵌套类概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

OffscreenSurface

方法详细资料

getMapRenderer

start

stop

setRenderInterval

setListener

setViewport

screenShot

onPause

onResume

onNeedsDisplay

onAnnotationClicked

onAnnotationSelected

onAnnotationDeselected

onFocusChanged

onOverlayClicked

onOverlaySelected

onOverlaySelectedNds

onOverlayDeselected

onPoiSelected

onPoiDeselected

onPoiSelectedNds

onPoiDeselectedNds

onPoiClicked

onCameraChanged

onGestureAnimationEvent

onCameraAnimationEnded

onTileLoadingFinished

onLayerTilesLoaded

onLayerTilesReadyForDraw

onOnlineDataVersionChecked

onUserRasterDataUpdated