Import of the watch repository from Pebble

src/fw/applib/unobstructed_area_service_private.h

@@ -0,0 +1,62 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#pragma once
+
+#include "unobstructed_area_service.h"
+
+#include "applib/event_service_client.h"
+
+//! @internal
+typedef struct UnobstructedAreaState {
+  EventServiceInfo event_info;
+  UnobstructedAreaHandlers handlers;
+  GRect area;
+  void *context;
+  bool is_subscribed;
+  bool is_changing;
+} UnobstructedAreaState;
+
+//! @internal
+//! Initializes the unobstructed area state
+//! @param state Unobstructed area state belonging to the consuming task
+//! @param current_y The current obstruction y to initialize the unobstructed area with
+void unobstructed_area_service_init(UnobstructedAreaState *state, int16_t current_y);
+
+//! @internal
+//! Deinitializes the unobstructed area state
+//! @param state Unobstructed area state belonging to the consuming task
+void unobstructed_area_service_deinit(UnobstructedAreaState *state);
+
+//! @internal
+//! Returns the last unobstructed area
+//! @param state Unobstructed area state belonging to the consuming task
+//! @param area The GRect to write the unobstructed area to
+void unobstructed_area_service_get_area(UnobstructedAreaState *state, GRect *area);
+
+//! @internal
+//! Subscribe to be notified when the app's unobstructed area changes.
+//! @param state Unobstructed area state belonging to the consuming task
+//! @param handlers The handlers that should be called when the unobstructed area changes.
+//! @param context A user-provided context that will be passed to the callback handlers.
+void unobstructed_area_service_subscribe(UnobstructedAreaState *state,
+                                         const UnobstructedAreaHandlers *handlers,
+                                         void *context);
+
+//! @internal
+//! @param state Unobstructed area state belonging to the consuming task
+//! Unsubscribe from notifications about changes to the app's unobstructed area.
+void unobstructed_area_service_unsubscribe(UnobstructedAreaState *state);