MAMultiPolyline.h
4.19 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
//
// MAMultiPolyline.h
// MapKit_static
//
// Created by yi chen on 12/11/15.
// Copyright © 2016 Amap. All rights reserved.
//
#import "MAConfig.h"
#if MA_INCLUDE_OVERLAY_MAMultiPolyline
#import "MAPolyline.h"
///多彩线model类。此类用于定义一个由多个点相连的多段线，绘制时支持分段采用不同颜色（纹理）绘制，点与点之间尾部相连但第一点与最后一个点不相连, 通常MAMultiPolyline是MAMultiColoredPolylineRenderer（分段颜色绘制）或MAMultiTexturePolylineRenderer（分段纹理绘制）的model
@interface MAMultiPolyline : MAPolyline
/**
绘制索引数组(纹理、颜色索引数组), 成员为NSNumber, 且为非负数。
例子：[1,3,6] 表示 0-1使用第一种颜色\纹理，1-3使用第二种，3-6使用第三种，6-最后使用第四种。
在渐变模式下（MAMultiColoredPolylineRenderer.gradient = YES），0-1使用第一种颜色，3使用第二种，6-最后使用第四种，1-3，3-6使用渐变色进行填充。
注意：polyline在渲染时会进行抽稀以提高渲染效率，但是如果是设置为drawIndex的点，则不会被抽稀。
在每一个点都是索引点的极端情况下，则抽稀过程不会生效，点数量很多时会极大的影响渲染效率。所以请尽量少的设置索引点的数量。
*/
@property (nonatomic, strong) NSArray<NSNumber *> *drawStyleIndexes;
/**
* @brief 多彩线，根据MAMapPoint数据生成多彩线
*
* 分段纹理绘制：其对应的MAMultiTexturePolylineRenderer必须设置strokeTextureImages属性; 否则使用默认的灰色纹理绘制。
* 分段颜色绘制：其对应的MAMultiColoredPolylineRenderer必须设置strokeColors属性
*
* @param points 指定的直角坐标点数组，注意：如果有连续重复点，需要去重处理，只保留一个，否则会导致绘制有问题。
* @param count 坐标点的个数
* @param drawStyleIndexes 纹理索引数组(颜色索引数组)
* @return 生成的折线对象
*/
+ (instancetype)polylineWithPoints:(MAMapPoint *)points count:(NSUInteger)count drawStyleIndexes:(NSArray<NSNumber *> *) drawStyleIndexes;
/**
* @brief 多彩线，根据经纬度坐标数据生成多彩线
*
* 分段纹理绘制：其对应的MAMultiTexturePolylineRenderer必须设置strokeTextureImages属性; 否则使用默认的灰色纹理绘制。
* 分段颜色绘制：其对应的MAMultiColoredPolylineRenderer必须设置strokeColors属性。
*
* @param coords 指定的经纬度坐标点数组，注意：如果有连续重复点，需要去重处理，只保留一个，否则会导致绘制有问题。
* @param count 坐标点的个数
* @param drawStyleIndexes 纹理索引数组(颜色索引数组), 成员为NSNumber, 且为非负数。
* @return 生成的折线对象
*/
+ (instancetype)polylineWithCoordinates:(CLLocationCoordinate2D *)coords count:(NSUInteger)count drawStyleIndexes:(NSArray<NSNumber *> *) drawStyleIndexes;
/**
* @brief 重新设置坐标点. since 5.0.0
* @param points 指定的直角坐标点数组,C数组，内部会做copy，调用者负责内存管理。注意：如果有连续重复点，需要去重处理，只保留一个，否则会导致绘制有问题。
* @param count 坐标点的个数
* @param drawStyleIndexes 纹理索引数组(颜色索引数组), 成员为NSNumber, 且为非负数。
* @return 是否设置成功
*/
- (BOOL)setPolylineWithPoints:(MAMapPoint *)points
count:(NSUInteger)count
drawStyleIndexes:(NSArray<NSNumber *> *)drawStyleIndexes;
/**
* @brief 重新设置坐标点. since 5.0.0
* @param coords 指定的经纬度坐标点数组,C数组，内部会做copy，调用者负责内存管理。注意：如果有连续重复点，需要去重处理，只保留一个，否则会导致绘制有问题。
* @param count 坐标点的个数
* @param drawStyleIndexes 纹理索引数组(颜色索引数组), 成员为NSNumber, 且为非负数。
* @return 是否设置成功
*/
- (BOOL)setPolylineWithCoordinates:(CLLocationCoordinate2D *)coords
count:(NSUInteger)count
drawStyleIndexes:(NSArray<NSNumber *> *)drawStyleIndexes;
@end
#endif