All Data Structures Functions Variables Typedefs Enumerations Enumerator Groups
Graphics Context

Detailed Description

The "canvas" into which an application draws.

The Pebble OS graphics engine, inspired by several notable graphics systems, including Apple’s Quartz 2D and its predecessor QuickDraw, provides your app with a canvas into which to draw, namely, the graphics context. A graphics context is the target into which graphics functions can paint, using Pebble drawing routines (see Drawing Primitives, Drawing Paths and Drawing Text).

A graphics context holds a reference to the bitmap into which to paint. It also holds the current drawing state, like the current fill color, stroke color, clipping box, drawing box, compositing mode, and so on. The GContext struct is the type representing the graphics context.

For drawing in your Pebble watchface or watchapp, you won't need to create a GContext yourself. In most cases, it is provided by Pebble OS as an argument passed into a render callback (the .update_proc of a Layer).

Your app can’t call drawing functions at any given point in time: Pebble OS will request your app to render. Typically, your app will be calling out to graphics functions in the .update_proc callback of a Layer.

See Also
Layers
Drawing Primitives
Drawing Paths
Drawing Text

Function Documentation

void graphics_context_set_compositing_mode ( GContext *  ctx,
GCompOp  mode 
)

Sets the current bitmap compositing mode of the graphics context.

Parameters
ctxThe graphics context onto which to set the compositing mode
modeThe new compositing mode
See Also
GCompOp
bitmap_layer_set_compositing_mode()
Note
At the moment, this only affects the bitmaps drawing operations – graphics_draw_bitmap_in_rect() and anything that uses that –, but it currently does not affect the filling or stroking operations.
void graphics_context_set_fill_color ( GContext *  ctx,
GColor  color 
)

Sets the current fill color of the graphics context.

Parameters
ctxThe graphics context onto which to set the fill color
colorThe new fill color
void graphics_context_set_stroke_color ( GContext *  ctx,
GColor  color 
)

Sets the current stroke color of the graphics context.

Parameters
ctxThe graphics context onto which to set the stroke color
colorThe new stroke color
void graphics_context_set_text_color ( GContext *  ctx,
GColor  color 
)

Sets the current text color of the graphics context.

Parameters
ctxThe graphics context onto which to set the text color
colorThe new text color