#import "MLNParticleFieldRuntime.h" #import "MLNMapView_Private.h" #import #include #include #include #include #include #include #include #include #include #include #include #include NSErrorDomain const MLNParticleFieldRuntimeErrorDomain = @"org.maplibre.MLNParticleFieldRuntime"; namespace { constexpr NSUInteger MaxEncodedIdentifierUTF8Bytes = 64; constexpr NSUInteger MaxContractUTF8Bytes = 256 * 1024; constexpr NSUInteger MaxQbinBytes = 64 * 1024 * 1024; constexpr NSUInteger MaxMetadataUTF8Bytes = 1024 * 1024; void setError(NSError **error, MLNParticleFieldRuntimeErrorCode code, NSString *description) { if (error) *error = [NSError errorWithDomain:MLNParticleFieldRuntimeErrorDomain code:code userInfo:@{NSLocalizedDescriptionKey: description}]; } bool hasValidIdentifier(NSString *value) { return value && value.length > 0 && [value lengthOfBytesUsingEncoding:NSUTF8StringEncoding] <= MaxEncodedIdentifierUTF8Bytes; } bool hasValidContract(NSString *value) { return value && value.length > 0 && [value lengthOfBytesUsingEncoding:NSUTF8StringEncoding] <= MaxContractUTF8Bytes; } std::string stringFromNSString(NSString *value) { const char *utf8 = value.UTF8String; return utf8 ? std::string(utf8) : std::string(); } MLNParticleFieldRuntimeCommandResult commandResult(bool accepted) { return accepted ? MLNParticleFieldRuntimeCommandResultAccepted : MLNParticleFieldRuntimeCommandResultRejected; } bool validFloat(float value) { return std::isfinite(value); } std::vector charsFromData(NSData *data) { std::vector value(data.length); [data getBytes:value.data() length:value.size()]; return value; } } // namespace @implementation MLNParticleWeatherColorStop - (instancetype)initWithValue:(float)value red:(float)red green:(float)green blue:(float)blue alpha:(float)alpha { if ((self = [super init])) { _value = value; _red = red; _green = green; _blue = blue; _alpha = alpha; } return self; } @end @implementation MLNParticleFieldRuntimeConfiguration - (instancetype)initWithSourceIdentifier:(NSString *)sourceIdentifier weatherColorLayerIdentifier:(NSString *)weatherColorLayerIdentifier particleLayerIdentifier:(NSString *)particleLayerIdentifier { NSParameterAssert(sourceIdentifier.length > 0); NSParameterAssert(weatherColorLayerIdentifier.length > 0); NSParameterAssert(particleLayerIdentifier.length > 0); if (sourceIdentifier.length == 0 || weatherColorLayerIdentifier.length == 0 || particleLayerIdentifier.length == 0) { [NSException raise:NSInvalidArgumentException format:@"Particle field runtime identifiers must be non-empty."]; } if ((self = [super init])) { _sourceIdentifier = [sourceIdentifier copy]; _weatherColorLayerIdentifier = [weatherColorLayerIdentifier copy]; _particleLayerIdentifier = [particleLayerIdentifier copy]; } return self; } - (id)copyWithZone:(NSZone *)zone { return [[[self class] allocWithZone:zone] initWithSourceIdentifier:_sourceIdentifier weatherColorLayerIdentifier:_weatherColorLayerIdentifier particleLayerIdentifier:_particleLayerIdentifier]; } @end @interface MLNParticleFieldRuntime () { __weak MLNMapView *_mapView; BOOL _disposed; MLNParticleFieldRuntimeState _state; MLNParticleFieldRuntimePlaybackState _playbackState; MLNParticleFieldRuntimeTargetFps _targetFps; BOOL _weatherColorVisible; BOOL _particleVisible; NSString *_v4ParticleBindingFieldKey; NSMutableSet *_submittedEncodedFieldKeys; BOOL _v4ForecastPlaying; NSTimer *_v4CadenceTimer; } - (BOOL)isV4ParticleCadenceReady; - (void)refreshV4CadenceWake; - (void)runV4CadenceWake:(NSTimer *)timer; - (instancetype)initWithMapView:(MLNMapView *)mapView configuration:(MLNParticleFieldRuntimeConfiguration *)configuration error:(NSError **)error; @end @implementation MLNParticleFieldRuntime - (instancetype)initWithMapView:(MLNMapView *)mapView configuration:(MLNParticleFieldRuntimeConfiguration *)configuration error:(NSError **)error { if ((self = [super init])) { _mapView = mapView; _configuration = [configuration copy]; _state = MLNParticleFieldRuntimeStateWaitingForFields; _playbackState = MLNParticleFieldRuntimePlaybackStatePause; _targetFps = MLNParticleFieldRuntimeTargetFpsAuto; _weatherColorVisible = YES; _particleVisible = YES; _submittedEncodedFieldKeys = [NSMutableSet set]; if (![self withCurrentSource:error action:^bool(mln::style::RasterArraySource &, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &) { return true; }]) return nil; } return self; } - (BOOL)isDisposed { return _disposed; } - (MLNParticleFieldRuntimeState)state { return _state; } - (MLNParticleFieldRuntimePlaybackState)playbackState { return _playbackState; } - (MLNParticleFieldRuntimeTargetFps)targetFps { return _targetFps; } - (BOOL)disposeWithError:(NSError **)error { if (_disposed) return YES; // A terminal dispose must clear the Source while the map and Style are valid. // Otherwise the Source outlives this ObjC runtime and retains V4 field windows. [_v4CadenceTimer invalidate]; _v4CadenceTimer = nil; _v4ForecastPlaying = NO; const BOOL completed = [self withCurrentSource:error action:^bool( mln::style::RasterArraySource &source, mln::style::WeatherColorLayer &weather, mln::style::RasterParticleLayer &particle) { weather.setVisibility(mln::style::VisibilityType::None); particle.setVisibility(mln::style::VisibilityType::None); return source.resetWeatherRuntimeState(); }]; if (!completed) return NO; [_submittedEncodedFieldKeys removeAllObjects]; _v4ParticleBindingFieldKey = nil; _playbackState = MLNParticleFieldRuntimePlaybackStatePause; _state = MLNParticleFieldRuntimeStateDisabled; _disposed = YES; _mapView = nil; return YES; } - (void)dispose { NSError *error = nil; if (![self disposeWithError:&error]) { NSLog(@"WeatherRuntime: legacy dispose cleanup failed: %@", error.localizedDescription ?: @"unknown"); } } - (void)refreshV4CadenceWake { [_v4CadenceTimer invalidate]; _v4CadenceTimer = nil; const BOOL forecastWake = _v4ForecastPlaying && _submittedEncodedFieldKeys.count > 0; if (_disposed || _state == MLNParticleFieldRuntimeStateDisabled || (!forecastWake && (![self isV4ParticleCadenceReady] || !_particleVisible || _targetFps == MLNParticleFieldRuntimeTargetFpsAuto))) return; const NSTimeInterval interval = _targetFps == MLNParticleFieldRuntimeTargetFps60 ? 0.017 : 0.034; _v4CadenceTimer = [NSTimer scheduledTimerWithTimeInterval:interval target:self selector:@selector(runV4CadenceWake:) userInfo:nil repeats:NO]; } - (void)runV4CadenceWake:(NSTimer *)timer { if (timer != _v4CadenceTimer) return; _v4CadenceTimer = nil; if (_disposed) return; [_mapView triggerRepaint]; [self refreshV4CadenceWake]; } - (BOOL)isV4ParticleCadenceReady { return _state != MLNParticleFieldRuntimeStateDisabled && _state != MLNParticleFieldRuntimeStateError && _v4ParticleBindingFieldKey && [_submittedEncodedFieldKeys containsObject:_v4ParticleBindingFieldKey]; } - (BOOL)withCurrentSource:(NSError **)error action:(bool (^)(mln::style::RasterArraySource &, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &))action { if (_disposed) { setError(error, MLNParticleFieldRuntimeErrorDisposed, @"Particle field runtime has been disposed."); return NO; } MLNMapView *mapView = _mapView; if (!mapView) { setError(error, MLNParticleFieldRuntimeErrorMapUnavailable, @"The owning map view is no longer available."); return NO; } @try { auto& style = [mapView mbglMap].getStyle(); const auto sourceID = stringFromNSString(_configuration.sourceIdentifier); auto *untypedSource = style.getSource(sourceID); auto *source = untypedSource ? untypedSource->as() : nullptr; if (!source) { setError(error, untypedSource ? MLNParticleFieldRuntimeErrorSourceTypeMismatch : MLNParticleFieldRuntimeErrorSourceMissing, untypedSource ? @"The configured source is not a raster-array source." : @"The configured raster-array source is missing from the current style."); return NO; } const auto weatherID = stringFromNSString(_configuration.weatherColorLayerIdentifier); auto *untypedWeather = style.getLayer(weatherID); auto *weather = untypedWeather && mln::style::layerTypeInfoEquals(untypedWeather->getTypeInfo(), mln::style::WeatherColorLayer::Impl::staticTypeInfo()) ? static_cast(untypedWeather) : nullptr; if (!weather) { setError(error, untypedWeather ? MLNParticleFieldRuntimeErrorWeatherColorLayerTypeMismatch : MLNParticleFieldRuntimeErrorWeatherColorLayerMissing, untypedWeather ? @"The configured weather-color layer has the wrong Core type." : @"The configured weather-color layer is missing from the current style."); return NO; } const auto particleID = stringFromNSString(_configuration.particleLayerIdentifier); auto *untypedParticle = style.getLayer(particleID); auto *particle = untypedParticle && mln::style::layerTypeInfoEquals(untypedParticle->getTypeInfo(), mln::style::RasterParticleLayer::Impl::staticTypeInfo()) ? static_cast(untypedParticle) : nullptr; if (!particle) { setError(error, untypedParticle ? MLNParticleFieldRuntimeErrorParticleLayerTypeMismatch : MLNParticleFieldRuntimeErrorParticleLayerMissing, untypedParticle ? @"The configured raster-particle layer has the wrong Core type." : @"The configured raster-particle layer is missing from the current style."); return NO; } if (weather->getSourceID() != sourceID || particle->getSourceID() != sourceID) { setError(error, MLNParticleFieldRuntimeErrorLayerSourceMismatch, @"Configured particle layers do not reference the configured raster-array source."); return NO; } return action(*source, *weather, *particle); } @catch (NSException *exception) { setError(error, MLNParticleFieldRuntimeErrorMapUnavailable, exception.reason ?: @"The underlying map is unavailable."); return NO; } } - (MLNParticleEncodedFieldSubmitResult)submitEncodedFieldWithFieldKey:(NSString *)fieldKey fieldID:(NSString *)fieldID generation:(uint64_t)generation dataVersion:(uint64_t)dataVersion contractJSON:(NSString *)contractJSON qbin:(NSData *)qbin error:(NSError **)error { if (_state == MLNParticleFieldRuntimeStateDisabled) { setError(error, MLNParticleFieldRuntimeErrorDisposed, @"Particle field runtime is disabled; enable it before submitting fields."); return MLNParticleEncodedFieldSubmitResultNone; } if (!hasValidIdentifier(fieldKey) || !hasValidIdentifier(fieldID) || !hasValidContract(contractJSON) || generation == 0 || qbin.length == 0 || qbin.length > MaxQbinBytes) { setError(error, MLNParticleFieldRuntimeErrorInvalidArgument, @"Encoded field arguments violate the V4 transport contract."); return MLNParticleEncodedFieldSubmitResultNone; } const auto contract = mln::particle::parseResolvedFieldProfileContractJson(stringFromNSString(contractJSON)); if (!contract || !hasValidIdentifier([NSString stringWithUTF8String:contract->profileID.c_str()])) { setError(error, MLNParticleFieldRuntimeErrorInvalidArgument, @"contractJSON is not a valid V4 field profile contract."); return MLNParticleEncodedFieldSubmitResultNone; } std::vector bytes(qbin.length); [qbin getBytes:bytes.data() length:bytes.size()]; __block MLNParticleEncodedFieldSubmitResult result = MLNParticleEncodedFieldSubmitResultNone; const BOOL completed = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &source, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &) { const auto coreResult = source.submitEncodedField(stringFromNSString(fieldKey), {stringFromNSString(fieldID), generation, dataVersion}, *contract, bytes); result = static_cast(coreResult); return true; }]; if (completed && result > MLNParticleEncodedFieldSubmitResultNone) { [_submittedEncodedFieldKeys addObject:fieldKey]; [self refreshV4CadenceWake]; } return completed ? result : MLNParticleEncodedFieldSubmitResultNone; } - (BOOL)setEncodedColorBindingWithFieldKey:(NSString *)fieldKey semanticID:(uint16_t)semanticID groupID:(uint16_t)groupID expectedValueClass:(MLNParticleFieldValueClass)expectedValueClass expectedUnitID:(uint16_t)expectedUnitID error:(NSError **)error { if (!hasValidIdentifier(fieldKey) || semanticID == 0 || expectedValueClass < MLNParticleFieldValueClassScalar || expectedValueClass > MLNParticleFieldValueClassDirectionAngle) { setError(error, MLNParticleFieldRuntimeErrorInvalidArgument, @"Invalid encoded color binding."); return NO; } const BOOL completed = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &source, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &) { source.setColorBinding({stringFromNSString(fieldKey), {semanticID, groupID}, static_cast(expectedValueClass), expectedUnitID}); return true; }]; return completed; } - (BOOL)setEncodedParticleBindingWithFieldKey:(NSString *)fieldKey mode:(MLNParticleEncodedParticleBindingMode)mode uSemanticID:(uint16_t)uSemanticID uGroupID:(uint16_t)uGroupID vSemanticID:(uint16_t)vSemanticID vGroupID:(uint16_t)vGroupID directionSemanticID:(uint16_t)directionSemanticID directionGroupID:(uint16_t)directionGroupID expectedUnitID:(uint16_t)expectedUnitID error:(NSError **)error { if (!hasValidIdentifier(fieldKey)) { setError(error, MLNParticleFieldRuntimeErrorInvalidArgument, @"Invalid encoded particle field key."); return NO; } const bool vector = mode == MLNParticleEncodedParticleBindingModeVectorComponents && uSemanticID != 0 && vSemanticID != 0 && directionSemanticID == 0 && directionGroupID == 0; const bool direction = mode == MLNParticleEncodedParticleBindingModeDirectionAngle && uSemanticID == 0 && uGroupID == 0 && vSemanticID == 0 && vGroupID == 0 && directionSemanticID != 0; if (!vector && !direction) { setError(error, MLNParticleFieldRuntimeErrorInvalidArgument, @"Inactive particle selectors must be exactly semanticID = 0 and groupID = 0."); return NO; } const BOOL completed = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &source, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &) { mln::particle::ParticleBinding binding; binding.fieldKey = stringFromNSString(fieldKey); binding.expectedUnitID = expectedUnitID; if (vector) { binding.mode = mln::particle::ParticleBindingMode::VectorComponents; binding.uPlane = {uSemanticID, uGroupID}; binding.vPlane = {vSemanticID, vGroupID}; } else { binding.mode = mln::particle::ParticleBindingMode::DirectionAngle; binding.directionPlane = {directionSemanticID, directionGroupID}; } source.setParticleBinding(std::move(binding)); return true; }]; if (completed) { _v4ParticleBindingFieldKey = [fieldKey copy]; [self refreshV4CadenceWake]; } return completed; } - (BOOL)setEncodedForecastTime:(uint64_t)timestamp error:(NSError **)error { return [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &source, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &) { return source.setRequestedForecastTime(timestamp); }]; } - (BOOL)setEncodedForecastPlaybackState:(BOOL)playing error:(NSError **)error { const BOOL completed = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &source, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &) { source.setForecastPlaybackState(playing ? mln::particle::ForecastPlaybackState::Playing : mln::particle::ForecastPlaybackState::Paused); return true; }]; if (completed) { _v4ForecastPlaying = playing; [self refreshV4CadenceWake]; } return completed; } - (BOOL)setEncodedForecastPlaybackSpeed:(float)speed error:(NSError **)error { if (!std::isfinite(speed) || speed <= 0) { setError(error, MLNParticleFieldRuntimeErrorInvalidArgument, @"Forecast playback speed must be finite and greater than zero."); return NO; } return [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &source, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &) { return source.setForecastPlaybackSpeed(speed); }]; } - (BOOL)clearEncodedFieldWithFieldKey:(NSString *)fieldKey error:(NSError **)error { if (!hasValidIdentifier(fieldKey)) { setError(error, MLNParticleFieldRuntimeErrorInvalidArgument, @"Invalid encoded field key."); return NO; } const BOOL completed = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &source, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &) { return source.clearEncodedField(stringFromNSString(fieldKey)); }]; if (completed) { [_submittedEncodedFieldKeys removeObject:fieldKey]; [self refreshV4CadenceWake]; } return completed; } - (BOOL)clearAllEncodedFieldsWithError:(NSError **)error { const BOOL completed = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &source, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &) { source.clearAllEncodedFields(); return true; }]; if (completed) { [_submittedEncodedFieldKeys removeAllObjects]; [self refreshV4CadenceWake]; } return completed; } - (MLNParticleHostFieldSubmitResult)submitWindFieldWithMetadataJSON:(NSString *)metadataJSON payload:(NSData *)payload error:(NSError **)error { if (_state == MLNParticleFieldRuntimeStateDisabled) { setError(error, MLNParticleFieldRuntimeErrorDisposed, @"Particle field runtime is disabled; enable it before submitting fields."); return MLNParticleHostFieldSubmitResultNone; } if (!metadataJSON.length || [metadataJSON lengthOfBytesUsingEncoding:NSUTF8StringEncoding] > MaxMetadataUTF8Bytes || !payload.length || payload.length > MaxQbinBytes) { setError(error, MLNParticleFieldRuntimeErrorInvalidArgument, @"Invalid V3 wind field payload."); return MLNParticleHostFieldSubmitResultNone; } __block MLNParticleHostFieldSubmitResult result = MLNParticleHostFieldSubmitResultNone; BOOL completed = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &source, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &) { std::vector bytes = charsFromData(payload); result = static_cast(source.submitHostField(stringFromNSString(metadataJSON), bytes)); return true; }]; if (completed && result > 0) _state = result == MLNParticleHostFieldSubmitResultAcceptedPendingInitialWindow ? MLNParticleFieldRuntimeStateWaitingForFields : (result == MLNParticleHostFieldSubmitResultDuplicate ? _state : MLNParticleFieldRuntimeStateReady); else if (completed && result == MLNParticleHostFieldSubmitResultRejectedSourceMode) _state = MLNParticleFieldRuntimeStateError; return completed ? result : MLNParticleHostFieldSubmitResultNone; } - (MLNParticleHostFieldSubmitResult)submitFieldWithMetadataJSON:(NSString *)metadataJSON scalar:(NSData *)scalar vector:(NSData *)vector validity:(NSData *)validity error:(NSError **)error { if (_state == MLNParticleFieldRuntimeStateDisabled) { setError(error, MLNParticleFieldRuntimeErrorDisposed, @"Particle field runtime is disabled; enable it before submitting fields."); return MLNParticleHostFieldSubmitResultNone; } const NSUInteger scalarLength = scalar.length; const NSUInteger vectorLength = vector.length; const NSUInteger validityLength = validity.length; if (!metadataJSON.length || [metadataJSON lengthOfBytesUsingEncoding:NSUTF8StringEncoding] > MaxMetadataUTF8Bytes || !validityLength || (!scalar && !vector) || (scalar && !scalarLength) || (vector && !vectorLength) || scalarLength > MaxQbinBytes || vectorLength > MaxQbinBytes || validityLength > MaxQbinBytes || vectorLength > MaxQbinBytes - scalarLength || validityLength > MaxQbinBytes - scalarLength - vectorLength) { setError(error, MLNParticleFieldRuntimeErrorInvalidArgument, @"Invalid V3 field payload."); return MLNParticleHostFieldSubmitResultNone; } __block MLNParticleHostFieldSubmitResult result = MLNParticleHostFieldSubmitResultNone; BOOL completed = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &source, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &) { mln::particle::ParticleFieldPayloadBundle payloads; if (scalar) payloads.scalar = charsFromData(scalar); if (vector) payloads.vector = charsFromData(vector); payloads.validity = charsFromData(validity); result = static_cast(source.submitHostField(stringFromNSString(metadataJSON), payloads)); return true; }]; if (completed && result > 0) _state = result == MLNParticleHostFieldSubmitResultAcceptedPendingInitialWindow ? MLNParticleFieldRuntimeStateWaitingForFields : (result == MLNParticleHostFieldSubmitResultDuplicate ? _state : MLNParticleFieldRuntimeStateReady); else if (completed && result == MLNParticleHostFieldSubmitResultRejectedSourceMode) _state = MLNParticleFieldRuntimeStateError; return completed ? result : MLNParticleHostFieldSubmitResultNone; } - (MLNParticleFieldRuntimeCommandResult)clearFieldsWithError:(NSError **)error { if (_disposed || _state == MLNParticleFieldRuntimeStateDisabled) return MLNParticleFieldRuntimeCommandResultRejected; __block bool accepted = false; BOOL completed = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &source, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &) { accepted = source.clearHostFields(); return true; }]; if (completed && accepted) _state = MLNParticleFieldRuntimeStateWaitingForFields; return commandResult(completed && accepted); } - (MLNParticleFieldRuntimeCommandResult)setWeatherEnabled:(BOOL)enabled error:(NSError **)error { if (_disposed) return MLNParticleFieldRuntimeCommandResultRejected; if (enabled && _state == MLNParticleFieldRuntimeStateError) return MLNParticleFieldRuntimeCommandResultRejected; if (enabled && _state != MLNParticleFieldRuntimeStateDisabled) return MLNParticleFieldRuntimeCommandResultAccepted; if (!enabled && _state == MLNParticleFieldRuntimeStateDisabled) return MLNParticleFieldRuntimeCommandResultAccepted; __block bool accepted = false; BOOL completed = [self withCurrentSource:error action:^bool( mln::style::RasterArraySource &source, mln::style::WeatherColorLayer &weather, mln::style::RasterParticleLayer &particle) { if (!enabled) { weather.setVisibility(mln::style::VisibilityType::None); particle.setVisibility(mln::style::VisibilityType::None); accepted = source.resetWeatherRuntimeState(); } else { weather.setVisibility(_weatherColorVisible ? mln::style::VisibilityType::Visible : mln::style::VisibilityType::None); particle.setVisibility(_particleVisible ? mln::style::VisibilityType::Visible : mln::style::VisibilityType::None); accepted = true; } return accepted; }]; if (completed && accepted) { _state = enabled ? MLNParticleFieldRuntimeStateWaitingForFields : MLNParticleFieldRuntimeStateDisabled; if (!enabled) { [_submittedEncodedFieldKeys removeAllObjects]; _v4ParticleBindingFieldKey = nil; _v4ForecastPlaying = NO; _playbackState = MLNParticleFieldRuntimePlaybackStatePause; } } else if (completed) { _state = MLNParticleFieldRuntimeStateError; } [self refreshV4CadenceWake]; return commandResult(completed && accepted); } - (MLNParticleFieldRuntimeCommandResult)setWeatherColorVisible:(BOOL)visible error:(NSError **)error { if (_disposed) return MLNParticleFieldRuntimeCommandResultRejected; _weatherColorVisible = visible; return [self setVisibility:visible weather:YES error:error]; } - (MLNParticleFieldRuntimeCommandResult)setParticleVisible:(BOOL)visible error:(NSError **)error { if (_disposed) return MLNParticleFieldRuntimeCommandResultRejected; _particleVisible = visible; MLNParticleFieldRuntimeCommandResult result = [self setVisibility:visible weather:NO error:error]; [self refreshV4CadenceWake]; return result; } - (MLNParticleFieldRuntimeCommandResult)setVisibility:(BOOL)visible weather:(BOOL)weatherLayer error:(NSError **)error { BOOL completed = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &, mln::style::WeatherColorLayer &weather, mln::style::RasterParticleLayer &particle) { (weatherLayer ? static_cast(weather) : static_cast(particle)).setVisibility(visible && _state != MLNParticleFieldRuntimeStateDisabled ? mln::style::VisibilityType::Visible : mln::style::VisibilityType::None); return true; }]; return commandResult(completed); } - (MLNParticleFieldRuntimeCommandResult)setTargetFps:(MLNParticleFieldRuntimeTargetFps)target error:(NSError **)error { uint8_t value = target == MLNParticleFieldRuntimeTargetFps30 ? 30 : target == MLNParticleFieldRuntimeTargetFps60 ? 60 : target == MLNParticleFieldRuntimeTargetFpsAuto ? 0 : 255; if (value == 255) { setError(error, MLNParticleFieldRuntimeErrorInvalidArgument, @"Invalid target FPS."); return MLNParticleFieldRuntimeCommandResultRejected; } __block bool ok = false; BOOL done = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &source, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &) { ok = source.setRuntimeTargetFps(value); return true; }]; if (done && ok) { _targetFps = target; [self refreshV4CadenceWake]; } return commandResult(done && ok); } - (MLNParticleFieldRuntimeCommandResult)setForecastTime:(uint64_t)timestamp error:(NSError **)error { if (_state == MLNParticleFieldRuntimeStateDisabled) return MLNParticleFieldRuntimeCommandResultRejected; __block bool ok = false; BOOL done = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &source, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &) { ok = source.seekRuntimeTimelineToTimestamp(timestamp); return true; }]; return commandResult(done && ok); } - (MLNParticleFieldRuntimeCommandResult)setPlaybackState:(MLNParticleFieldRuntimePlaybackState)playback error:(NSError **)error { if (_state == MLNParticleFieldRuntimeStateDisabled || (playback != MLNParticleFieldRuntimePlaybackStatePlay && playback != MLNParticleFieldRuntimePlaybackStatePause)) return MLNParticleFieldRuntimeCommandResultRejected; __block bool ok = false; BOOL done = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &source, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &) { ok = source.controlRuntimeTimeline(playback == MLNParticleFieldRuntimePlaybackStatePlay ? 0 : 1); return true; }]; if (done && ok) _playbackState = playback; return commandResult(done && ok); } - (MLNParticleFieldRuntimeCommandResult)setPlaybackSpeed:(float)speed error:(NSError **)error { if (!validFloat(speed) || _state == MLNParticleFieldRuntimeStateDisabled) return MLNParticleFieldRuntimeCommandResultRejected; __block bool ok = false; BOOL done = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &source, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &) { ok = source.controlRuntimeTimeline(2, speed); return true; }]; return commandResult(done && ok); } - (MLNParticleFieldRuntimeCommandResult)setFieldValueSource:(MLNParticleFieldValueSource)value error:(NSError **)error { if (_disposed || value > MLNParticleFieldValueSourceVectorMagnitude) return MLNParticleFieldRuntimeCommandResultRejected; BOOL done = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &, mln::style::WeatherColorLayer &weather, mln::style::RasterParticleLayer &) { weather.setFieldValueSource(static_cast(value)); return true; }]; return commandResult(done); } - (MLNParticleFieldRuntimeCommandResult)setWeatherColorStops:(NSArray *)stops error:(NSError **)error { if (_disposed || !stops) return MLNParticleFieldRuntimeCommandResultRejected; std::vector coreStops; coreStops.reserve(stops.count); for (MLNParticleWeatherColorStop *stop in stops) coreStops.push_back({stop.value, {stop.red, stop.green, stop.blue, stop.alpha}}); __block bool ok = false; BOOL done = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &, mln::style::WeatherColorLayer &weather, mln::style::RasterParticleLayer &) { ok = weather.setColorStops(std::move(coreStops)); return true; }]; return commandResult(done && ok); } - (MLNParticleFieldRuntimeCommandResult)setWeatherColorOpacity:(float)value error:(NSError **)error { if (_disposed || !validFloat(value)) return MLNParticleFieldRuntimeCommandResultRejected; BOOL done = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &, mln::style::WeatherColorLayer &weather, mln::style::RasterParticleLayer &) { weather.setOpacity(value); return true; }]; return commandResult(done); } - (MLNParticleFieldRuntimeCommandResult)setParticleCount:(uint32_t)value error:(NSError **)error { if (_disposed) return MLNParticleFieldRuntimeCommandResultRejected; BOOL done = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &particle) { particle.setParticleCount(value); return particle.getParticleCount() == value; }]; return commandResult(done); } - (MLNParticleFieldRuntimeCommandResult)setParticleLineWidth:(float)value error:(NSError **)error { if (_disposed || !validFloat(value)) return MLNParticleFieldRuntimeCommandResultRejected; BOOL done = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &particle) { particle.setLineWidth(value); return true; }]; return commandResult(done); } - (MLNParticleFieldRuntimeCommandResult)setParticleLength:(float)value error:(NSError **)error { if (_disposed || !validFloat(value)) return MLNParticleFieldRuntimeCommandResultRejected; BOOL done = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &particle) { particle.setParticleLength(value); return true; }]; return commandResult(done); } - (MLNParticleFieldRuntimeCommandResult)setParticleOpacity:(float)value error:(NSError **)error { if (_disposed || !validFloat(value)) return MLNParticleFieldRuntimeCommandResultRejected; BOOL done = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &particle) { particle.setParticleOpacity(value); return true; }]; return commandResult(done); } - (MLNParticleFieldRuntimeCommandResult)setTrailOpacity:(float)value error:(NSError **)error { if (_disposed || !validFloat(value)) return MLNParticleFieldRuntimeCommandResultRejected; BOOL done = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &particle) { particle.setTrailOpacity(value); return true; }]; return commandResult(done); } - (MLNParticleFieldRuntimeCommandResult)setTrailFade:(float)value error:(NSError **)error { if (_disposed || !validFloat(value)) return MLNParticleFieldRuntimeCommandResultRejected; BOOL done = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &particle) { particle.setTrailFade(value); return true; }]; return commandResult(done); } - (MLNParticleFieldRuntimeCommandResult)setParticleAdvectionScale:(float)value error:(NSError **)error { if (_disposed || !validFloat(value) || value <= 0) return MLNParticleFieldRuntimeCommandResultRejected; BOOL done = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &particle) { particle.setAdvectionScale(value); return true; }]; return commandResult(done); } - (MLNParticleFieldRuntimeCommandResult)setParticleColorRed:(float)red green:(float)green blue:(float)blue alpha:(float)alpha error:(NSError **)error { if (_disposed || !mln::style::validWeatherRGBA({red, green, blue, alpha})) return MLNParticleFieldRuntimeCommandResultRejected; BOOL done = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &particle) { particle.setParticleColor({red, green, blue, alpha}); return true; }]; return commandResult(done); } - (MLNParticleFieldRuntimeCommandResult)setTrailColorRed:(float)red green:(float)green blue:(float)blue alpha:(float)alpha error:(NSError **)error { if (_disposed || !mln::style::validWeatherRGBA({red, green, blue, alpha})) return MLNParticleFieldRuntimeCommandResultRejected; BOOL done = [self withCurrentSource:error action:^bool(mln::style::RasterArraySource &, mln::style::WeatherColorLayer &, mln::style::RasterParticleLayer &particle) { particle.setTrailColor({red, green, blue, alpha}); return true; }]; return commandResult(done); } @end namespace { const void *ParticleFieldRuntimeAssociationKey = &ParticleFieldRuntimeAssociationKey; } @implementation MLNMapView (ParticleFieldRuntime) - (MLNParticleFieldRuntime *)replaceParticleFieldRuntimeWithConfiguration:(MLNParticleFieldRuntimeConfiguration *)configuration error:(NSError **)error { if (![self disposeParticleFieldRuntimeWithError:error]) return nil; if (!configuration) { setError(error, MLNParticleFieldRuntimeErrorInvalidArgument, @"A particle field runtime configuration is required."); return nil; } MLNParticleFieldRuntime *runtime = [[MLNParticleFieldRuntime alloc] initWithMapView:self configuration:configuration error:error]; if (!runtime) return nil; objc_setAssociatedObject(self, ParticleFieldRuntimeAssociationKey, runtime, OBJC_ASSOCIATION_RETAIN_NONATOMIC); return runtime; } - (MLNParticleFieldRuntime *)particleFieldRuntime { return objc_getAssociatedObject(self, ParticleFieldRuntimeAssociationKey); } - (void)disposeParticleFieldRuntime { NSError *error = nil; if (![self disposeParticleFieldRuntimeWithError:&error]) { NSLog(@"WeatherRuntime: legacy map dispose cleanup failed: %@", error.localizedDescription ?: @"unknown"); } } - (BOOL)disposeParticleFieldRuntimeWithError:(NSError **)error { MLNParticleFieldRuntime *runtime = self.particleFieldRuntime; if (!runtime) return YES; if (![runtime disposeWithError:error]) return NO; objc_setAssociatedObject(self, ParticleFieldRuntimeAssociationKey, nil, OBJC_ASSOCIATION_RETAIN_NONATOMIC); return YES; } @end