MAOverlayRenderer.h
13.8 KB
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
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
//
// MAOverlayRenderer.h
// MAMapKit
//
//
// Copyright (c) 2011年 Amap. All rights reserved.
//
#import "MAConfig.h"
#import <UIKit/UIKit.h>
#import "MAOverlay.h"
#import "MALineDrawType.h"
#define kMAOverlayRendererDefaultStrokeColor [UIColor colorWithRed:0.3 green:0.63 blue:0.89 alpha:0.8]
#define kMAOverlayRendererDefaultFillColor [UIColor colorWithRed:0.77 green:0.88 blue:0.94 alpha:0.8]
@protocol MAOverlayRenderDelegate;
///该类是地图覆盖物Renderer的基类, 提供绘制overlay的接口但并无实际的实现（render相关方法只能在重写后的glRender方法中使用）
@interface MAOverlayRenderer : NSObject {
@protected
GLuint _strokeTextureID;
CGSize _strokeTextureSize;
BOOL _needsUpdate;
BOOL _needsLoadStrokeTexture;
}
///由地图添加时，不要手动设置。如果不是使用mapview进行添加，则需要手动设置。（since 5.1.0）
@property (nonatomic, weak) id<MAOverlayRenderDelegate> rendererDelegate;
///关联的overlay对象
@property (nonatomic, readonly, retain) id <MAOverlay> overlay;
///用于生成笔触纹理id的图片（支持非PowerOfTwo图片; 如果您需要减轻绘制产生的锯齿,您可以参考AMap.bundle中的traffic_texture_blue.png的方式,在image两边增加部分透明像素.)。（since 5.3.0）
@property (nonatomic, strong) UIImage *strokeImage;
///笔触纹理id, 修改纹理id参考, 如果strokeImage未指定、尚未加载或加载失败返回0
@property (nonatomic, readonly) GLuint strokeTextureID;
///透明度[0，1]，默认为1. 使用MAOverlayRenderer类提供的渲染接口会自动应用此属性。（since 5.1.0）
@property (nonatomic, assign) CGFloat alpha;
///overlay渲染的scale。（since 5.1.0）
@property (nonatomic, readonly) CGFloat contentScale;
/**
* @brief 初始化并返回一个Overlay Renderer
* @param overlay 关联的overlay对象
* @return 初始化成功则返回overlay view,否则返回nil
*/
- (instancetype)initWithOverlay:(id<MAOverlay>)overlay;
/**
* @brief 获取当前地图view矩阵，数组长度为16，无需外界释放. 需要添加至地图后，才能获取有效矩阵数据，否则返回NULL
* @return 矩阵数组
*/
- (float *)getViewMatrix;
/**
* @brief 获取当前地图projection矩阵，数组长度为16，无需外界释放. 需要添加至地图后，才能获取有效矩阵数据，否则返回NULL
* @return 矩阵数组
*/
- (float *)getProjectionMatrix;
/**
* @brief 获取当前地图中心点偏移，用以把地图坐标转换为gl坐标。需要添加到地图获取才有效。（since 5.1.0）
* @return 偏移
*/
- (MAMapPoint)getOffsetPoint;
/**
* @brief 获取当前地图缩放级别，需要添加到地图获取才有效。（since 5.1.0）
* @return 缩放级别
*/
- (CGFloat)getMapZoomLevel;
/**
* @brief 将MAMapPoint转换为opengles可以直接使用的坐标
* @param mapPoint MAMapPoint坐标
* @return 直接支持的坐标
*/
- (CGPoint)glPointForMapPoint:(MAMapPoint)mapPoint;
/**
* @brief 批量将MAMapPoint转换为opengles可以直接使用的坐标
* @param mapPoints MAMapPoint坐标数据指针
* @param count 个数
* @return 直接支持的坐标数据指针(需要调用者手动释放)
*/
- (CGPoint *)glPointsForMapPoints:(MAMapPoint *)mapPoints count:(NSUInteger)count;
/**
* @brief 将屏幕尺寸转换为OpenGLES尺寸
* @param windowWidth 屏幕尺寸
* @return OpenGLES尺寸
*/
- (CGFloat)glWidthForWindowWidth:(CGFloat)windowWidth;
/**
* @brief 使用OpenGLES 绘制线
* @param points OpenGLES坐标系点指针, 参考- (CGPoint)glPointForMapPoint:(MAMapPoint)mapPoint, - (CGPoint *)glPointsForMapPoints:(MAMapPoint *)mapPoints count:(NSUInteger)count
* @param pointCount 点个数
* @param strokeColor 线颜色
* @param lineWidth OpenGLES支持线宽尺寸, 参考 - (CGFloat)glWidthForWindowWidth:(CGFloat)windowWidth
* @param looped 是否闭合, 如polyline会设置NO, polygon会设置YES
*/
- (void)renderLinesWithPoints:(CGPoint *)points
pointCount:(NSUInteger)pointCount
strokeColor:(UIColor *)strokeColor
lineWidth:(CGFloat)lineWidth
looped:(BOOL)looped __attribute__((deprecated("已废弃")));;
/**
* @brief 使用OpenGLES 绘制线
* @param points OpenGLES坐标系点指针, 参考- (CGPoint)glPointForMapPoint:(MAMapPoint)mapPoint, - (CGPoint *)glPointsForMapPoints:(MAMapPoint *)mapPoints count:(NSUInteger)count
* @param pointCount 点个数
* @param strokeColor 线颜色
* @param lineWidth OpenGLES支持线宽尺寸, 参考 - (CGFloat)glWidthForWindowWidth:(CGFloat)windowWidth
* @param looped 是否闭合, 如polyline会设置NO, polygon会设置YES
* @param lineJoinType 线连接点样式
* @param lineCapType 线端点样式
* @param lineDash 虚线类型
*/
- (void)renderLinesWithPoints:(CGPoint *)points
pointCount:(NSUInteger)pointCount
strokeColor:(UIColor *)strokeColor
lineWidth:(CGFloat)lineWidth
looped:(BOOL)looped
LineJoinType:(MALineJoinType)lineJoinType
LineCapType:(MALineCapType)lineCapType
lineDash:(MALineDashType)lineDash __attribute__((deprecated("已废弃")));
/**
* @brief 使用OpenGLES 按指定纹理绘制线
* @param points OpenGLES坐标系点指针, 参考- (CGPoint)glPointForMapPoint:(MAMapPoint)mapPoint, - (CGPoint *)glPointsForMapPoints:(MAMapPoint *)mapPoints count:(NSUInteger)count
* @param pointCount 点个数
* @param lineWidth 线OpenGLES支持线宽尺寸, 参考 - (CGFloat)glWidthForWindowWidth:(CGFloat)windowWidth
* @param textureID 指定的纹理
* @param looped 是否闭合, 如polyline会设置NO, polygon会设置YES
*/
- (void)renderTexturedLinesWithPoints:(CGPoint *)points
pointCount:(NSUInteger)pointCount
lineWidth:(CGFloat)lineWidth
textureID:(GLuint)textureID
looped:(BOOL)looped __attribute__((deprecated("已废弃")));
/**
* @brief 使用OpenGLES 绘制多纹理线
* @param points OpenGLES坐标系点指针, 参考- (CGPoint)glPointForMapPoint:(MAMapPoint)mapPoint, - (CGPoint *)glPointsForMapPoints:(MAMapPoint *)mapPoints count:(NSUInteger)count
* @param pointCount 点个数
* @param lineWidth 线OpenGLES支持线宽尺寸, 参考 - (CGFloat)glWidthForWindowWidth:(CGFloat)windowWidth
* @param textureIDs 各段指定的纹理 使用- (BOOL)loadStrokeTextureImages:(NSArray *)textureImages;加载,在strokeTextureIDs属性中获取
* @param drawStyleIndexes 纹理索引数组，成员为NSNumber,且为非负数，负数按0处理
* @param looped 是否闭合, 如polyline会设置NO, polygon会设置YES
*/
- (void)renderTexturedLinesWithPoints:(CGPoint *)points
pointCount:(NSUInteger)pointCount
lineWidth:(CGFloat)lineWidth
textureIDs:(NSArray *)textureIDs
drawStyleIndexes:(NSArray *)drawStyleIndexes
looped:(BOOL)looped __attribute__((deprecated("已废弃")));
/**
* @brief 使用OpenGLES 绘制多段颜色线
* @param points OpenGLES坐标系点指针, 参考- (CGPoint)glPointForMapPoint:(MAMapPoint)mapPoint, - (CGPoint *)glPointsForMapPoints:(MAMapPoint *)mapPoints count:(NSUInteger)count
* @param pointCount 点个数
* @param strokeColors 各段指定的颜色
* @param drawStyleIndexes 颜色索引数组，成员为NSNumber,且为非负数，负数按0处理
* @param isGradient 颜色是否渐变
* @param lineWidth 线OpenGLES支持线宽尺寸, 参考 - (CGFloat)glWidthForWindowWidth:(CGFloat)windowWidth
* @param looped 是否闭合, 如polyline会设置NO, polygon会设置YES
* @param lineJoinType 线连接点样式
* @param lineCapType 线端点样式
* @param lineDash 虚线类型
*/
- (void)renderLinesWithPoints:(CGPoint *)points
pointCount:(NSUInteger)pointCount
strokeColors:(NSArray *)strokeColors
drawStyleIndexes:(NSArray *)drawStyleIndexes
isGradient:(BOOL)isGradient
lineWidth:(CGFloat)lineWidth
looped:(BOOL)looped
LineJoinType:(MALineJoinType)lineJoinType
LineCapType:(MALineCapType)lineCapType
lineDash:(MALineDashType)lineDash __attribute__((deprecated("已废弃")));
/**
* @brief 使用OpenGLES 绘制区域
* @param points OpenGLES坐标系点指针, 参考- (CGPoint)glPointForMapPoint:(MAMapPoint)mapPoint, - (CGPoint *)glPointsForMapPoints:(MAMapPoint *)mapPoints count:(NSUInteger)count
* @param pointCount 点个数
* @param fillColor 填充颜色
* @param usingTriangleFan 若必为凸多边形输入YES，可能为凹多边形输入NO
*/
- (void)renderRegionWithPoints:(CGPoint *)points
pointCount:(NSUInteger)pointCount
fillColor:(UIColor *)fillColor
usingTriangleFan:(BOOL)usingTriangleFan __attribute__((deprecated("已废弃")));
/**
* @brief 使用OpenGLES 绘制区域(带轮廓线) \n注意：strokeLineWidth为0 或 strokeColor为nil 时不绘制轮廓线。
* @param points OpenGLES坐标系点指针, 参考- (CGPoint)glPointForMapPoint:(MAMapPoint)mapPoint, - (CGPoint *)glPointsForMapPoints:(MAMapPoint *)mapPoints count:(NSUInteger)count
* @param pointCount 点个数
* @param fillColor 填充颜色
* @param strokeColor 轮廓线颜色
* @param strokeLineWidth 轮廓线宽。OpenGLES支持线宽尺寸, 参考 - (CGFloat)glWidthForWindowWidth:(CGFloat)windowWidth
* @param strokeLineJoinType 轮廓线连接点样式
* @param strokeLineDash 轮廓虚线类型
* @param usingTriangleFan 若必为凸多边形输入YES，可能为凹多边形输入NO
*/
- (void)renderStrokedRegionWithPoints:(CGPoint *)points pointCount:(NSUInteger)pointCount
fillColor:(UIColor *)fillColor
strokeColor:(UIColor *)strokeColor
strokeLineWidth:(CGFloat)strokeLineWidth
strokeLineJoinType:(MALineJoinType)strokeLineJoinType
strokeLineDash:(MALineDashType)strokeLineDash
usingTriangleFan:(BOOL)usingTriangleFan __attribute__((deprecated("已废弃")));
/**
* @brief 使用OpenGLES 绘制区域(带纹理轮廓线) \n注意：strokeLineWidth为0 或 strokeTexture为0 时不绘制轮廓线。
* @param points OpenGLES坐标系点指针, 参考- (CGPoint)glPointForMapPoint:(MAMapPoint)mapPoint, - (CGPoint *)glPointsForMapPoints:(MAMapPoint *)mapPoints count:(NSUInteger)count
* @param pointCount 点个数
* @param fillColor 填充颜色
* @param strokeLineWidth 轮廓线宽。OpenGLES支持线宽尺寸, 参考 - (CGFloat)glWidthForWindowWidth:(CGFloat)windowWidth
* @param strokeTexture 轮廓线纹理。使用- (void)loadStrokeTextureImage:(UIImage *)textureImage;加载
* @param usingTriangleFan 若必为凸多边形输入YES，可能为凹多边形输入NO
*/
- (void)renderTextureStrokedRegionWithPoints:(CGPoint *)points
pointCount:(NSUInteger)pointCount
fillColor:(UIColor *)fillColor
strokeTineWidth:(CGFloat)strokeLineWidth
strokeTextureID:(GLuint)strokeTexture
usingTriangleFan:(BOOL)usingTriangleFan __attribute__((deprecated("已废弃")));
/**
* @brief 使用OpenGLES 绘制图片
* @param textureID OpenGLES纹理ID
* @param points OpenGLES坐标系点指针,纹理矩形的四个顶点坐标,其第一个坐标为图片左上角，依次顺时针传入其他顶点 ,参考- (CGPoint)glPointForMapPoint:(MAMapPoint)mapPoint, - (CGPoint *)glPointsForMapPoints:(MAMapPoint *)mapPoints count:(NSUInteger)count
*/
- (void)renderIconWithTextureID:(GLuint)textureID points:(CGPoint *)points __attribute__((deprecated("已废弃")));
/**
* @brief 使用OpenGLES 绘制图片
* @param textureID OpenGLES纹理ID
* @param points OpenGLES坐标系点指针,纹理矩形的四个顶点坐标,其第一个坐标为图片左上角，依次顺时针传入其他顶点 ,参考- (CGPoint)glPointForMapPoint:(MAMapPoint)mapPoint, - (CGPoint *)glPointsForMapPoints:(MAMapPoint *)mapPoints count:(NSUInteger)count
* @param modulateColor 调节颜色值, 最终颜色 = 纹理色 * modulateColor. 如只需要调节alpha的话就设置为[red=1, green=1, blue=1, alpha=0.5]
*/
- (void)renderIconWithTextureID:(GLuint)textureID points:(CGPoint *)points modulateColor:(UIColor *)modulateColor __attribute__((deprecated("已废弃")));
/**
* @brief 绘制函数(子类需要重载来实现)
*/
- (void)glRender;
/**
* @brief 加载纹理图片，纹理ID存储在成员strokeTextureID中。纹理图片为nil时，清空原有纹理
* @param textureImage 纹理图片（需满足：长宽相等，且宽度值为2的次幂）。若为nil，则清空原有纹理
* @return openGL纹理ID, 若纹理加载失败返回0
*/
- (GLuint)loadStrokeTextureImage:(UIImage *)textureImage __attribute__((deprecated("已废弃, 请通过属性strokeImage设置")));
/**
* @brief 加载纹理图片（since 5.1.0）
* @param textureImage 纹理图片（需满足：长宽相等，且宽度值为2的次幂)
* @return openGL纹理ID, 若纹理加载失败返回0
*/
- (GLuint)loadTexture:(UIImage *)textureImage;
/**
@brief 删除纹理（since 5.1.0）
@param textureId 纹理ID
*/
- (void)deleteTexture:(GLuint)textureId;
/**
* @brief 当关联overlay对象有更新时，调用此接口刷新. since 5.0.0
*/
- (void)setNeedsUpdate;
@end