--- title: "Drawing Paths" canonical_url: https://developer.repebble.com/docs/c/Graphics/Drawing_Paths/ last_updated: 2026-10-22 sdk_version: 4.33.1 --- # Drawing Paths Source: https://developer.repebble.com/docs/c/Graphics/Drawing_Paths/ Functions to draw polygons into a graphics context Code example: ``` static GPath \*s\_my\_path\_ptr = NULL;static const GPathInfo BOLT\_PATH\_INFO = {.num\_points = 6,.points = (GPoint []) {{21, 0}, {14, 26}, {28, 26}, {7, 60}, {14, 34}, {0, 34}}};// .update\_proc of my\_layer:void my\_layer\_update\_proc(Layer \*my\_layer, GContext\* ctx) {// Fill the path:graphics\_context\_set\_fill\_color(ctx, GColorWhite);gpath\_draw\_filled(ctx, s\_my\_path\_ptr);// Stroke the path:graphics\_context\_set\_stroke\_color(ctx, GColorBlack);gpath\_draw\_outline(ctx, s\_my\_path\_ptr);}void setup\_my\_path(void) {s\_my\_path\_ptr = gpath\_create(&BOLT\_PATH\_INFO);// Rotate 15 degrees:gpath\_rotate\_to(s\_my\_path\_ptr, TRIG\_MAX\_ANGLE / 360 \* 15);// Translate by (5, 5):gpath\_move\_to(s\_my\_path\_ptr, GPoint(5, 5));}// For brevity, the setup of my\_layer is not written out... ``` ## Function Documentation [GPath](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#GPath) \* gpath\_create(const [GPathInfo](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#GPathInfo) \* init) Creates a new [GPath](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#GPath) on the heap based on a series of points described by a [GPathInfo](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#GPathInfo). Values after initialization: - `num_points` and `points` pointer: copied from the [GPathInfo](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#GPathInfo). - `rotation`: 0 - `offset`: (0, 0) #### Returns A pointer to the [GPath](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#GPath). `NULL` if the [GPath](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#GPath) could not be created void gpath\_destroy([GPath](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#GPath) \* gpath) Free a dynamically allocated gpath created with [gpath\_create()](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#gpath_create) void gpath\_draw\_filled(GContext \* ctx, [GPath](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#GPath) \* path) Draws the fill of a path into a graphics context, using the current fill color, relative to the drawing area as set up by the layering system. #### Parameters ctx The graphics context to draw into path The path to fill #### See Also [graphics\_context\_set\_fill\_color()](https://developer.repebble.com/docs/c/Graphics/Graphics_Context.md#graphics_context_set_fill_color) void gpath\_draw\_outline(GContext \* ctx, [GPath](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#GPath) \* path) Draws the outline of a path into a graphics context, using the current stroke color and width, relative to the drawing area as set up by the layering system. The first and last points in the path do have a line between them. #### Parameters ctx The graphics context to draw into path The path to draw #### See Also [graphics\_context\_set\_stroke\_color()](https://developer.repebble.com/docs/c/Graphics/Graphics_Context.md#graphics_context_set_stroke_color) [gpath\_draw\_outline\_open()](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#gpath_draw_outline_open) void gpath\_rotate\_to([GPath](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#GPath) \* path, int32\_t angle) Sets the absolute rotation of the path. The current rotation will be replaced by the specified angle. ##### Note Setting a rotation does not affect the points in the path directly. The rotation is applied on-the-fly during drawing, either using [gpath\_draw\_filled()](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#gpath_draw_filled) or [gpath\_draw\_outline()](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#gpath_draw_outline). #### Parameters path The path onto which to set the rotation angle The absolute angle of the rotation. The angle is represented in the same way that is used with [sin\_lookup()](https://developer.repebble.com/docs/c/Foundation/Math.md#sin_lookup). See [TRIG\_MAX\_ANGLE](https://developer.repebble.com/docs/c/Foundation/Math.md#TRIG_MAX_ANGLE) for more information. void gpath\_move\_to([GPath](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#GPath) \* path, [GPoint](https://developer.repebble.com/docs/c/Graphics/Graphics_Types.md#GPoint) point) Sets the absolute offset of the path. The current translation will be replaced by the specified offset. ##### Note Setting a translation does not affect the points in the path directly. The translation is applied on-the-fly during drawing, either using [gpath\_draw\_filled()](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#gpath_draw_filled) or [gpath\_draw\_outline()](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#gpath_draw_outline). #### Parameters path The path onto which to set the translation point The point which is used as the vector for the translation. void gpath\_draw\_outline\_open(GContext \* ctx, [GPath](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#GPath) \* path) Draws an open outline of a path into a graphics context, using the current stroke color and width, relative to the drawing area as set up by the layering system. The first and last points in the path do not have a line between them. #### Parameters ctx The graphics context to draw into path The path to draw #### See Also [graphics\_context\_set\_stroke\_color()](https://developer.repebble.com/docs/c/Graphics/Graphics_Context.md#graphics_context_set_stroke_color) [gpath\_draw\_outline()](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#gpath_draw_outline) ## Data Structure Documentation struct GPath Data structure describing a path, plus its rotation and translation. ##### Note See the remark with [GPathInfo](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#GPathInfo) #### Data Fields [uint32\_t](https://developer.repebble.com/docs/c/Standard_C.md#uint32_t) num\_points The number of points in the `points` array. [GPoint](https://developer.repebble.com/docs/c/Graphics/Graphics_Types.md#GPoint) \* points Pointer to an array of points. int32\_t rotation The rotation that will be used when drawing the path with [gpath\_draw\_filled()](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#gpath_draw_filled) or [gpath\_draw\_outline()](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#gpath_draw_outline) [GPoint](https://developer.repebble.com/docs/c/Graphics/Graphics_Types.md#GPoint) offset The translation that will to be used when drawing the path with [gpath\_draw\_filled()](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#gpath_draw_filled) or [gpath\_draw\_outline()](https://developer.repebble.com/docs/c/Graphics/Drawing_Paths.md#gpath_draw_outline) struct GPathInfo Data structure describing a naked path. ##### Note Note that this data structure only refers to an array of points; the points are not stored inside this data structure itself. In most cases, one cannot use a stack-allocated array of GPoints. Instead one often needs to provide longer-lived (static or "global") storage for the points. #### Data Fields [uint32\_t](https://developer.repebble.com/docs/c/Standard_C.md#uint32_t) num\_points The number of points in the `points` array. [GPoint](https://developer.repebble.com/docs/c/Graphics/Graphics_Types.md#GPoint) \* points Pointer to an array of points.