1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
/*
* BMKOverlayView.h
* BMapKit
*
* Copyright 2011 Baidu Inc. All rights reserved.
*
*/
#import <UIKit/UIKit.h>
#import "BMKOverlay.h"
/// 该类是地图覆盖物View的基类，提供绘制overlay的接口但本身并无实现，所有地图覆盖物View需要继承自此类
@interface BMKOverlayView : UIView
{
@package
id <BMKOverlay> _overlay;
BMKMapRect _boundingMapRect;
CGAffineTransform _mapTransform;
id _geometryDelegate;
id _canDrawCache;
BOOL keepScale;
CFTimeInterval _lastTile;
CFRunLoopTimerRef _scheduledScaleTimer;
struct {
unsigned int keepAlive:1;
unsigned int levelCrossFade:1;
unsigned int drawingDisabled:1;
unsigned int usesTiledLayer:1;
} _flags;
//@private
// int geometrylayerID;
}
/// 设置该overlay的GeometryDelegate
- (void)setGeometryDelegate:(id)delegate;
/**
*初始化并返回一个overlay view
*@param overlay 关联的overlay对象
*@return 初始化成功则返回overlay view,否则返回nil
*/
- (id)initWithOverlay:(id <BMKOverlay>)overlay;
///关联的overlay对象
@property (nonatomic, readonly) id <BMKOverlay> overlay;
/**
*将直角坐标转为overlay view坐标
*@param mapPoint 直角坐标
*@return 对应的view坐标
*/
- (CGPoint)pointForMapPoint:(BMKMapPoint)mapPoint;
/**
*将overlay view坐标转为直角坐标
*@param point view坐标
*@return 对应的直角坐标
*/
- (BMKMapPoint)mapPointForPoint:(CGPoint)point;
/**
*将二维地图投影矩形转为overlay view矩形
*@param mapRect 二维地图投影矩形
*@return 对应的view矩形
*/
- (CGRect)rectForMapRect:(BMKMapRect)mapRect;
/**
*将overlay view区域转为二维地图投影区域
*@param rect 指定的view矩形
*@return 对应的二维地图投影矩形
*/
- (BMKMapRect)mapRectForRect:(CGRect)rect;
/**
*判断ovlerlay view是否准备绘制内容
*默认返回YES，如果用户设为NO，当需要绘制内容时要显示调用setNeedsDisplayInMapRect:zoomScale:方法
*@param mapRect 需要更新的地图矩形区域
*@param zoomScale 当前的缩放因子
*@return 如果view准备好绘制内容，返回YES,否则返回NO
*/
- (BOOL)canDrawMapRect:(BMKMapRect)mapRect zoomScale:(BMKZoomScale)zoomScale;
/**
*绘制overlay view内容
*该方法默认不做任何事，子类需要重载该方法来绘制view的内容
*@param mapRect 需要更新的地图矩形区域
*@param zoomScale 当前的缩放因子
*@param context 使用的graphics context
*/
- (void)drawMapRect:(BMKMapRect)mapRect zoomScale:(BMKZoomScale)zoomScale inContext:(CGContextRef)context;
/**
*使view在给定矩形的区域无效,系统将重绘该区域
*@param mapRect 需要更新的区域
*/
- (void)setNeedsDisplayInMapRect:(BMKMapRect)mapRect;
/**
*使用OpenGLES 绘制线
@param points 直角坐标点
@param pointCount 点个数
@param strokeColor 线颜色
@param lineWidth OpenGLES支持线宽尺寸
@param looped 是否闭合, 如polyline会设置NO, polygon会设置YES.
*/
- (void)renderLinesWithPoints:(BMKMapPoint *)points pointCount:(NSUInteger)pointCount strokeColor:(UIColor *)strokeColor lineWidth:(CGFloat)lineWidth looped:(BOOL)looped;
/**
*使用OpenGLES 绘制线
@param points 直角坐标点
@param pointCount 点个数
@param strokeColor 线颜色
@param lineWidth OpenGLES支持线宽尺寸
@param looped 是否闭合, 如polyline会设置NO, polygon会设置YES.
@param lineDash 是否虚线样式
*/
- (void)renderLinesWithPoints:(BMKMapPoint *)points pointCount:(NSUInteger)pointCount strokeColor:(UIColor *)strokeColor lineWidth:(CGFloat)lineWidth looped:(BOOL)looped lineDash:(BOOL)lineDash;
/**
*使用OpenGLES 按指定纹理绘制线
@param points 直角坐标点
@param pointCount 点个数
@param lineWidth OpenGLES支持线宽尺寸
@param textureID 纹理ID,使用- (void)loadStrokeTextureImage:(UIImage *)textureImage;加载
@param looped 是否闭合, 如polyline会设置NO, polygon会设置YES.
*/
- (void)renderTexturedLinesWithPoints:(BMKMapPoint *)points pointCount:(NSUInteger)pointCount lineWidth:(CGFloat)lineWidth textureID:(GLuint)textureID looped:(BOOL)looped;
/**
*使用OpenGLES 分段纹理绘制线
@param partPt 分段直角坐标点
@param lineWidth OpenGLES支持线宽尺寸
@param textureIndexs 分段纹理索引,使用- (void)loadStrokeTextureImage:(UIImage *)textureImage;加载
@param isFoucs 是否使用分段纹理绘制
*/
-(void)renderTexturedLinesWithPartPoints:(NSArray*)partPt lineWidth:(CGFloat)lineWidth textureIndexs:(NSArray*)textureIndexs isFocus:(BOOL) isFoucs;
/**
*使用OpenGLES 绘制区域
@param points 直角坐标点
@param pointCount 点个数
@param fillColor 填充颜色
@param usingTriangleFan YES对应GL_TRIANGLE_FAN, NO对应GL_TRIANGLES
*/
- (void)renderRegionWithPoints:(BMKMapPoint *)points pointCount:(NSUInteger)pointCount fillColor:(UIColor *)fillColor usingTriangleFan:(BOOL)usingTriangleFan;
/**
*使用OpenGLES 绘制区域（支持凹多边形）
@param points 直角坐标点
@param pointCount 点个数
@param fillColor 填充颜色
@param usingTriangleFan YES对应GL_TRIANGLE_FAN, NO对应GL_TRIANGLES
*/
- (void)renderATRegionWithPoint:(BMKMapPoint *)points pointCount:(NSUInteger)pointCount fillColor:(UIColor *)fillColor usingTriangleFan:(BOOL)usingTriangleFan;
/**
*绘制函数(子类需要重载来实现)
*/
- (void)glRender;
///关联的纹理对象ID
@property (nonatomic, readonly) GLuint strokeTextureID;
/**
*加载纹理图片
@param textureImage 图片对象，opengl要求图片宽高必须是2的n次幂，如果图片对象为nil，则清空原有纹理
@return openGL纹理ID, 若纹理加载失败返回0
*/
- (GLuint)loadStrokeTextureImage:(UIImage *)textureImage;
/**
*加载分段纹理绘制 所需的纹理图片
@param textureImages 必须UIImage数组，opengl要求图片宽高必须是2的n次幂，否则，返回NO，无法分段纹理绘制
@return 是否成功
*/
- (BOOL)loadStrokeTextureImages:(NSArray *)textureImages;
@end