MAMultiPolyline.h 4.2 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677
  1. //
  2. // MAMultiPolyline.h
  3. // MapKit_static
  4. //
  5. // Created by yi chen on 12/11/15.
  6. // Copyright © 2016 Amap. All rights reserved.
  7. //
  8. #import "MAConfig.h"
  9. #if MA_INCLUDE_OVERLAY_MAMultiPolyline
  10. #import "MAPolyline.h"
  11. ///多彩线model类。此类用于定义一个由多个点相连的多段线,绘制时支持分段采用不同颜色(纹理)绘制,点与点之间尾部相连但第一点与最后一个点不相连, 通常MAMultiPolyline是MAMultiColoredPolylineRenderer(分段颜色绘制)或MAMultiTexturePolylineRenderer(分段纹理绘制)的model
  12. @interface MAMultiPolyline : MAPolyline
  13. /**
  14. 绘制索引数组(纹理、颜色索引数组), 成员为NSNumber, 且为非负数。
  15. 例子:[1,3,6] 表示 0-1使用第一种颜色\纹理,1-3使用第二种,3-6使用第三种,6-最后使用第四种。
  16. 在渐变模式下(MAMultiColoredPolylineRenderer.gradient = YES),0-1使用第一种颜色,3使用第二种,6-最后使用第四种,1-3,3-6使用渐变色进行填充。
  17. 注意:polyline在渲染时会进行抽稀以提高渲染效率,但是如果是设置为drawIndex的点,则不会被抽稀。
  18. 在每一个点都是索引点的极端情况下,则抽稀过程不会生效,点数量很多时会极大的影响渲染效率。所以请尽量少的设置索引点的数量。
  19. */
  20. @property (nonatomic, strong) NSArray<NSNumber *> *drawStyleIndexes;
  21. /**
  22. * @brief 多彩线,根据MAMapPoint数据生成多彩线
  23. *
  24. * 分段纹理绘制:其对应的MAMultiTexturePolylineRenderer必须设置strokeTextureImages属性; 否则使用默认的灰色纹理绘制。
  25. * 分段颜色绘制:其对应的MAMultiColoredPolylineRenderer必须设置strokeColors属性
  26. *
  27. * @param points 指定的直角坐标点数组,注意:如果有连续重复点,需要去重处理,只保留一个,否则会导致绘制有问题。
  28. * @param count 坐标点的个数
  29. * @param drawStyleIndexes 纹理索引数组(颜色索引数组)
  30. * @return 生成的折线对象
  31. */
  32. + (instancetype)polylineWithPoints:(MAMapPoint *)points count:(NSUInteger)count drawStyleIndexes:(NSArray<NSNumber *> *) drawStyleIndexes;
  33. /**
  34. * @brief 多彩线,根据经纬度坐标数据生成多彩线
  35. *
  36. * 分段纹理绘制:其对应的MAMultiTexturePolylineRenderer必须设置strokeTextureImages属性; 否则使用默认的灰色纹理绘制。
  37. * 分段颜色绘制:其对应的MAMultiColoredPolylineRenderer必须设置strokeColors属性。
  38. *
  39. * @param coords 指定的经纬度坐标点数组,注意:如果有连续重复点,需要去重处理,只保留一个,否则会导致绘制有问题。
  40. * @param count 坐标点的个数
  41. * @param drawStyleIndexes 纹理索引数组(颜色索引数组), 成员为NSNumber, 且为非负数。
  42. * @return 生成的折线对象
  43. */
  44. + (instancetype)polylineWithCoordinates:(CLLocationCoordinate2D *)coords count:(NSUInteger)count drawStyleIndexes:(NSArray<NSNumber *> *) drawStyleIndexes;
  45. /**
  46. * @brief 重新设置坐标点. since 5.0.0
  47. * @param points 指定的直角坐标点数组,C数组,内部会做copy,调用者负责内存管理。注意:如果有连续重复点,需要去重处理,只保留一个,否则会导致绘制有问题。
  48. * @param count 坐标点的个数
  49. * @param drawStyleIndexes 纹理索引数组(颜色索引数组), 成员为NSNumber, 且为非负数。
  50. * @return 是否设置成功
  51. */
  52. - (BOOL)setPolylineWithPoints:(MAMapPoint *)points
  53. count:(NSUInteger)count
  54. drawStyleIndexes:(NSArray<NSNumber *> *)drawStyleIndexes;
  55. /**
  56. * @brief 重新设置坐标点. since 5.0.0
  57. * @param coords 指定的经纬度坐标点数组,C数组,内部会做copy,调用者负责内存管理。注意:如果有连续重复点,需要去重处理,只保留一个,否则会导致绘制有问题。
  58. * @param count 坐标点的个数
  59. * @param drawStyleIndexes 纹理索引数组(颜色索引数组), 成员为NSNumber, 且为非负数。
  60. * @return 是否设置成功
  61. */
  62. - (BOOL)setPolylineWithCoordinates:(CLLocationCoordinate2D *)coords
  63. count:(NSUInteger)count
  64. drawStyleIndexes:(NSArray<NSNumber *> *)drawStyleIndexes;
  65. @end
  66. #endif