41b7366285
Co-authored-by: Bart Louwers <bart.louwers@gmail.com> Co-authored-by: Bart Louwers <bart@emeel.net>
113 lines
4.1 KiB
Objective-C
113 lines
4.1 KiB
Objective-C
#import "MLNSource.h"
|
||
|
||
#import "MLNFoundation.h"
|
||
#import "MLNTypes.h"
|
||
#import "MLNGeometry.h"
|
||
|
||
NS_ASSUME_NONNULL_BEGIN
|
||
|
||
MLN_EXPORT
|
||
/**
|
||
`MLNImageSource` is a content source that is used for a georeferenced raster
|
||
image to be shown on the map. The georeferenced image scales and rotates as the
|
||
user zooms and rotates the map. Images may also be used as icons or patterns
|
||
in a style layer. To register an image for use as an icon or pattern,
|
||
use the `-[MLNStyle setImage:forName:]` method. To configure a point
|
||
annotation’s image, use the `MLNAnnotationImage` class.
|
||
|
||
The geographic location of the raster image content, supplied with
|
||
`MLNCoordinateQuad`, can be non-axis aligned.
|
||
`MLNImageSource` supports raster content from `NSURL`, `NSImage` (macOS), or
|
||
`UIImage` (iOS).
|
||
An image source is added to an `MLNStyle` object along with one or more
|
||
`MLNRasterStyleLayer` objects. Use a raster style layer to control the
|
||
appearance of content supplied by the image source.
|
||
|
||
Each
|
||
<a href="https://maplibre.org/maplibre-style-spec/#sources-image"><code>image</code></a>
|
||
source defined by the style JSON file is represented at runtime by an
|
||
`MLNImageSource` object that you can use to initialize new style layers. You
|
||
can also add and remove sources dynamically using methods such as
|
||
`-[MLNStyle addSource:]` and `-[MLNStyle sourceWithIdentifier:]`.
|
||
|
||
### Example
|
||
|
||
```swift
|
||
let coordinates = MLNCoordinateQuad(
|
||
topLeft: CLLocationCoordinate2D(latitude: 46.437, longitude: -80.425),
|
||
bottomLeft: CLLocationCoordinate2D(latitude: 37.936, longitude: -80.425),
|
||
bottomRight: CLLocationCoordinate2D(latitude: 37.936, longitude: -71.516),
|
||
topRight: CLLocationCoordinate2D(latitude: 46.437, longitude: -71.516))
|
||
let source = MLNImageSource(identifier: "radar", coordinateQuad: coordinates, url: URL(string: "https://maplibre.org/maplibre-gl-js-docs/assets/radar.gif")!)
|
||
mapView.style?.addSource(source)
|
||
```
|
||
|
||
#### Related examples
|
||
TODO: Add an image, learn how to add an image to your map using `MLNImageSource`.
|
||
*/
|
||
MLN_EXPORT
|
||
@interface MLNImageSource : MLNSource
|
||
|
||
// MARK: Initializing a Source
|
||
|
||
/**
|
||
Returns a georeferenced image source with an identifier, coordinates and a URL.
|
||
|
||
@param identifier A string that uniquely identifies the source.
|
||
@param coordinateQuad the top left, top right, bottom right, and bottom left coordinates for the image.
|
||
@param url An HTTP(S) URL, absolute file URL, or local file URL relative to the
|
||
current application’s resource bundle.
|
||
@return An initialized shape source.
|
||
*/
|
||
- (instancetype)initWithIdentifier:(NSString *)identifier coordinateQuad:(MLNCoordinateQuad)coordinateQuad URL:(NSURL *)url;
|
||
|
||
/**
|
||
Returns a georeferenced image source with an identifier, coordinates and an image.
|
||
|
||
@param identifier A string that uniquely identifies the source.
|
||
@param coordinateQuad The top left, top right, bottom right, and bottom left coordinates for the image.
|
||
@param image The image to display for the source.
|
||
@return An initialized shape source.
|
||
*/
|
||
- (instancetype)initWithIdentifier:(NSString *)identifier coordinateQuad:(MLNCoordinateQuad)coordinateQuad image:(MLNImage *)image;
|
||
|
||
// MARK: Accessing a Source’s Content
|
||
|
||
/**
|
||
The URL to the source image.
|
||
|
||
If the receiver was initialized using `-initWithIdentifier:coordinateQuad:image:` or
|
||
the `image` property is set, this property is set to `nil`.
|
||
*/
|
||
@property (nonatomic, copy, nullable)NSURL *URL;
|
||
|
||
/**
|
||
Sets the URL for the image source, performing necessary validations.
|
||
|
||
@param url The URL to set for the image source.
|
||
*/
|
||
- (void)setURL:(NSURL *)url;
|
||
|
||
/**
|
||
The source image.
|
||
|
||
If the receiver was initialized using `-initWithIdentifier:coordinateQuad:URL:` or if the `URL` property is set, this property is set to `nil`.
|
||
*/
|
||
@property (nonatomic, retain, nullable)MLNImage *image;
|
||
|
||
/**
|
||
The coordinates at which the corners of the source image will be placed.
|
||
*/
|
||
@property (nonatomic) MLNCoordinateQuad coordinates;
|
||
|
||
/**
|
||
Sets the coordinates for the image source.
|
||
|
||
@param coordinateQuad The coordinates to set for the image source.
|
||
*/
|
||
- (void)setCoordinates:(MLNCoordinateQuad)coordinateQuad;
|
||
|
||
@end
|
||
|
||
NS_ASSUME_NONNULL_END
|