Import of the watch repository from Pebble

src/fw/applib/graphics/graphics_bitmap.h

@@ -0,0 +1,67 @@
+/*
+ * 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 "gtypes.h"
+
+//! Draws a bitmap into the graphics context, inside the specified rectangle, using the specified
+//! processor.
+//! @param ctx The destination graphics context in which to draw the bitmap
+//! @param bitmap The bitmap to draw
+//! @param rect The rectangle in which to draw the bitmap
+//! @param processor Optional processor to use in drawing the bitmap
+//! @note If the size of `rect` is smaller than the size of the bitmap,
+//! the bitmap will be clipped on right and bottom edges.
+//! If the size of `rect` is larger than the size of the bitmap,
+//! the bitmap will be tiled automatically in both horizontal and vertical
+//! directions, effectively drawing a repeating pattern.
+//! @see GBitmap
+//! @see GContext
+//! @internal
+//! @see app_get_current_graphics_context
+void graphics_draw_bitmap_in_rect_processed(GContext *ctx, const GBitmap *bitmap,
+                                            const GRect *rect, GBitmapProcessor *processor);
+
+//! Draws a bitmap into the graphics context, inside the specified rectangle
+//! @param ctx The destination graphics context in which to draw the bitmap
+//! @param bitmap The bitmap to draw
+//! @param rect The rectangle in which to draw the bitmap
+//! @note If the size of `rect` is smaller than the size of the bitmap,
+//! the bitmap will be clipped on right and bottom edges.
+//! If the size of `rect` is larger than the size of the bitmap,
+//! the bitmap will be tiled automatically in both horizontal and vertical
+//! directions, effectively drawing a repeating pattern.
+//! @see GBitmap
+//! @see GContext
+//! @internal
+//! @see app_get_current_graphics_context
+void graphics_draw_bitmap_in_rect_by_value(GContext *ctx, const GBitmap *bitmap, GRect rect);
+void graphics_draw_bitmap_in_rect(GContext *ctx, const GBitmap *bitmap, const GRect *rect);
+
+//! Draws a rotated bitmap with a memory-sensitive 2x anti-aliasing technique
+//! (using ray-finding instead of super-sampling), which is thresholded into a b/w bitmap for 1-bit
+//! and color blended for 8-bit.
+//! @note This API has performance limitations that can degrade user experience. Use sparingly.
+//! @param ctx The destination graphics context in which to draw
+//! @param src The source bitmap to draw
+//! @param src_ic Instance center (single point unaffected by rotation) relative to source bitmap
+//! @param rotation Angle of rotation. Rotation is an integer between 0 (no rotation)
+//! and TRIG_MAX_ANGLE (360 degree rotation). Use \ref DEG_TO_TRIGANGLE to easily convert degrees
+//! to the appropriate value.
+//! @param dest_ic Where to draw the instance center of the rotated bitmap in the context.
+void graphics_draw_rotated_bitmap(GContext* ctx, GBitmap *src, GPoint src_ic, int rotation,
+                                  GPoint dest_ic);