c7d7319c77
* [ios, macos] Fix querying features returning nil when features available. * [ios, macos] Copyedited changelogs Also, macOS SDK v0.5.1 has yet to be released, because none of the changes that went into iOS SDK v3.6.1 were relevant to macOS.
78 lines
2.5 KiB
Objective-C
78 lines
2.5 KiB
Objective-C
#import "MGLSource.h"
|
||
|
||
#include <memory>
|
||
|
||
NS_ASSUME_NONNULL_BEGIN
|
||
|
||
namespace mbgl {
|
||
namespace style {
|
||
class Source;
|
||
}
|
||
}
|
||
|
||
// A struct to be stored in the `peer` member of mbgl::style::Source, in order to implement
|
||
// object identity. We don't store a MGLSource pointer directly because that doesn't
|
||
// interoperate with ARC. The inner pointer is weak in order to avoid a reference cycle for
|
||
// "pending" MGLSources, which have a strong owning pointer to the mbgl::style::Source.
|
||
struct SourceWrapper {
|
||
__weak MGLSource *source;
|
||
};
|
||
|
||
@class MGLMapView;
|
||
|
||
@interface MGLSource (Private)
|
||
|
||
/**
|
||
Initializes and returns a source with a raw pointer to the backing store,
|
||
associated with a style.
|
||
*/
|
||
- (instancetype)initWithRawSource:(mbgl::style::Source *)rawSource mapView:(nullable MGLMapView *)mapView;
|
||
|
||
/**
|
||
Initializes and returns a source with an owning pointer to the backing store,
|
||
unassociated from a style.
|
||
*/
|
||
- (instancetype)initWithPendingSource:(std::unique_ptr<mbgl::style::Source>)pendingSource;
|
||
|
||
/**
|
||
A raw pointer to the mbgl object, which is always initialized, either to the
|
||
value returned by `mbgl::Map getSource`, or for independently created objects,
|
||
to the pointer value held in `pendingSource`. In the latter case, this raw
|
||
pointer value stays even after ownership of the object is transferred via
|
||
`mbgl::Map addSource`.
|
||
*/
|
||
@property (nonatomic, readonly) mbgl::style::Source *rawSource;
|
||
|
||
/**
|
||
The map view whose style currently contains the source.
|
||
|
||
If the source is not currently part of any map view’s style, this property is
|
||
set to `nil`.
|
||
*/
|
||
@property (nonatomic, readonly, weak) MGLMapView *mapView;
|
||
|
||
/**
|
||
Adds the mbgl source that this object represents to the mbgl map.
|
||
|
||
Once a mbgl source is added, ownership of the object is transferred to the
|
||
`mbgl::Map` and this object no longer has an active unique_ptr reference to the
|
||
`mbgl::Source`. If this object's mbgl source is in that state, the mbgl source
|
||
can still be changed but the changes will not be visible until the `MGLSource`
|
||
is added back to the map via `-[MGLStyle addSource:]` and styled with a
|
||
`MGLLayer`.
|
||
*/
|
||
- (void)addToMapView:(MGLMapView *)mapView;
|
||
|
||
/**
|
||
Removes the mbgl source that this object represents from the mbgl map.
|
||
|
||
When a mbgl source is removed, ownership of the object is transferred back
|
||
to the `MGLSource` instance and the unique_ptr reference is valid again. It is
|
||
safe to add the source back to the style after it is removed.
|
||
*/
|
||
- (void)removeFromMapView:(MGLMapView *)mapView;
|
||
|
||
@end
|
||
|
||
NS_ASSUME_NONNULL_END
|