RMShape Class Reference
| Inherits from | RMMapLayer : CAScrollLayer |
| Declared in | RMShape.h |
Overview
An RMShape object is used to represent a line, polygon, or other shape composed of two or more points connected by lines. An RMShape object changes visible size in response to map zooms in order to consistently represent coverage of the same geographic area.
Tasks
Creating Shape Objects
Accessing the Drawing Properties
-
lineColorproperty -
fillColorproperty -
fillPatternImageproperty -
lineWidthproperty -
pathBoundingBoxproperty -
additionalTouchPaddingproperty
Drawing Shapes
-
– moveToProjectedPoint: -
– moveToScreenPoint: -
– moveToCoordinate: -
– addLineToProjectedPoint: -
– addLineToScreenPoint: -
– addLineToCoordinate: -
– addCurveToCoordinate:controlCoordinate1:controlCoordinate2: -
– addQuadCurveToCoordinate:controlCoordinate: -
– addCurveToProjectedPoint:controlProjectedPoint1:controlProjectedPoint2: -
– addQuadCurveToProjectedPoint:controlProjectedPoint: -
– performBatchOperations: -
– closePath
Properties
additionalTouchPadding
An additional pixel area around the shape that is applied to touch hit testing events. Defaults to none.
@property (nonatomic, assign) CGFloat additionalTouchPaddingDiscussion
An additional pixel area around the shape that is applied to touch hit testing events. Defaults to none.
Declared In
RMShape.hfillColor
The fill color of the shape. Defaults to clear.
@property (nonatomic, strong) UIColor *fillColorDiscussion
The fill color of the shape. Defaults to clear.
Declared In
RMShape.hfillPatternImage
The fill pattern image of the shape. If set, the fillColor is set to nil.
@property (nonatomic, strong) UIImage *fillPatternImageDiscussion
The fill pattern image of the shape. If set, the fillColor is set to nil.
Declared In
RMShape.hlineColor
The line color of the shape. Defaults to black.
@property (nonatomic, strong) UIColor *lineColorDiscussion
The line color of the shape. Defaults to black.
Declared In
RMShape.hInstance Methods
addCurveToCoordinate:controlCoordinate1:controlCoordinate2:
Draw a curve from the current pen location to a coordinate.
- (void)addCurveToCoordinate:(CLLocationCoordinate2D)coordinate controlCoordinate1:(CLLocationCoordinate2D)controlCoordinate1 controlCoordinate2:(CLLocationCoordinate2D)controlCoordinate2Parameters
- coordinate
The coordinate to draw to.
- controlCoordinate1
The first control coordinate.
- controlCoordinate2
The second control coordinate.
Discussion
Draw a curve from the current pen location to a coordinate.
Declared In
RMShape.haddCurveToProjectedPoint:controlProjectedPoint1:controlProjectedPoint2:
Draw a curve from the current pen location to a projected point.
- (void)addCurveToProjectedPoint:(RMProjectedPoint)projectedPoint controlProjectedPoint1:(RMProjectedPoint)controlProjectedPoint1 controlProjectedPoint2:(RMProjectedPoint)controlProjectedPoint2Parameters
- projectedPoint
The projected point to draw to.
- controlProjectedPoint1
The first control projected point.
- controlProjectedPoint2
The second control projected point.
Discussion
Draw a curve from the current pen location to a projected point.
Declared In
RMShape.haddLineToCoordinate:
Draw a line from the current pen location to a coordinate.
- (void)addLineToCoordinate:(CLLocationCoordinate2D)coordinateParameters
- coordinate
The coordinate to draw to.
Discussion
Draw a line from the current pen location to a coordinate.
Declared In
RMShape.haddLineToProjectedPoint:
Draw a line from the current pen location to a projected point.
- (void)addLineToProjectedPoint:(RMProjectedPoint)projectedPointParameters
- projectedPoint
The projected point to draw to.
Discussion
Draw a line from the current pen location to a projected point.
Declared In
RMShape.haddLineToScreenPoint:
Draw a line from the current pen location to a screen point.
- (void)addLineToScreenPoint:(CGPoint)pointParameters
- point
The screen point to draw to.
Discussion
Draw a line from the current pen location to a screen point.
Declared In
RMShape.haddQuadCurveToCoordinate:controlCoordinate:
Draw a quad curve from the current pen location to a coordinate.
- (void)addQuadCurveToCoordinate:(CLLocationCoordinate2D)coordinate controlCoordinate:(CLLocationCoordinate2D)controlCoordinateParameters
- coordinate
The coordinate to draw to.
- controlCoordinate
The control coordinate.
Discussion
Draw a quad curve from the current pen location to a coordinate.
Declared In
RMShape.haddQuadCurveToProjectedPoint:controlProjectedPoint:
Draw a quad curve from the current pen location to a projected point.
- (void)addQuadCurveToProjectedPoint:(RMProjectedPoint)projectedPoint controlProjectedPoint:(RMProjectedPoint)controlProjectedPointParameters
- projectedPoint
The projected point to draw to.
- controlProjectedPoint
The control projected point.
Discussion
Draw a quad curve from the current pen location to a projected point.
Declared In
RMShape.hclosePath
Closes the path, connecting the last point to the first. After this action, no further points can be added to the path.
- (void)closePathDiscussion
Closes the path, connecting the last point to the first. After this action, no further points can be added to the path.
There is no requirement that a path be closed.
Declared In
RMShape.hinitWithView:
Initializes and returns a newly allocated shape object for the specified map view.
- (id)initWithView:(RMMapView *)aMapViewParameters
- aMapView
The map view the shape should be drawn on.
Discussion
Initializes and returns a newly allocated shape object for the specified map view.
Declared In
RMShape.hmoveToCoordinate:
Move the drawing pen to a coordinate.
- (void)moveToCoordinate:(CLLocationCoordinate2D)coordinateParameters
- coordinate
The coordinate to move to.
Discussion
Move the drawing pen to a coordinate.
Declared In
RMShape.hmoveToProjectedPoint:
Move the drawing pen to a projected point.
- (void)moveToProjectedPoint:(RMProjectedPoint)projectedPointParameters
- projectedPoint
The projected point to move to.
Discussion
Move the drawing pen to a projected point.
Declared In
RMShape.hmoveToScreenPoint:
Move the drawing pen to a screen point.
- (void)moveToScreenPoint:(CGPoint)pointParameters
- point
The screen point to move to.
Discussion
Move the drawing pen to a screen point.
Declared In
RMShape.hperformBatchOperations:
Alter the path without rerecalculating the geometry. Recommended for many operations in order to increase performance.
- (void)performBatchOperations:(void ( ^ ) ( RMShape *aShape ))blockParameters
- block
A block containing the operations to perform.
Discussion
Alter the path without rerecalculating the geometry. Recommended for many operations in order to increase performance.
Declared In
RMShape.h