GI.Gdk.Objects.DrawingContext

DrawingContext is an object that represents the current drawing state of a Window.

It's possible to use a DrawingContext to draw on a Window via rendering API like Cairo or OpenGL.

A DrawingContext can only be created by calling windowBeginDrawFrame and will be valid until a call to windowEndDrawFrame.

DrawingContext is available since GDK 3.22

Exported types

newtype DrawingContext

Constructors

DrawingContext (ManagedPtr DrawingContext)

Instances

GObject DrawingContext

Methods

gobjectType :: DrawingContext -> IO GType

IsObject DrawingContext

IsDrawingContext DrawingContext

class GObject o => IsDrawingContext o

Instances

(GObject a, UnknownAncestorError Constraint DrawingContext a) => IsDrawingContext a

IsDrawingContext DrawingContext

toDrawingContext :: (MonadIO m, IsDrawingContext o) => o -> m DrawingContext

noDrawingContext :: Maybe DrawingContext

Methods

getCairoContext

drawingContextGetCairoContext

Arguments

:: (HasCallStack, MonadIO m, IsDrawingContext a)

=> a

-> m Context

Returns: a Cairo context to be used to draw the contents of the Window. The context is owned by the DrawingContext and should not be destroyed

Retrieves a Cairo context to be used to draw on the Window that created the DrawingContext.

The returned context is guaranteed to be valid as long as the DrawingContext is valid, that is between a call to windowBeginDrawFrame and windowEndDrawFrame.

Since: 3.22

getClip

drawingContextGetClip

Arguments

:: (HasCallStack, MonadIO m, IsDrawingContext a)

=> a

context: a DrawingContext

-> m (Maybe Region)

Returns: a Cairo region

Retrieves a copy of the clip region used when creating the context.

Since: 3.22

getWindow

drawingContextGetWindow

Arguments

:: (HasCallStack, MonadIO m, IsDrawingContext a)

=> a

context: a DrawingContext

-> m Window

Returns: a Window

Retrieves the window that created the drawing context.

Since: 3.22

isValid

drawingContextIsValid

Arguments

:: (HasCallStack, MonadIO m, IsDrawingContext a)

=> a

context: a DrawingContext

-> m Bool

Returns: True if the context is valid

Checks whether the given DrawingContext is valid.

Since: 3.22

Properties

clip

constructDrawingContextClip :: IsDrawingContext o => Region -> IO (GValueConstruct o)

getDrawingContextClip :: (MonadIO m, IsDrawingContext o) => o -> m (Maybe Region)

window

constructDrawingContextWindow :: (IsDrawingContext o, IsWindow a) => a -> IO (GValueConstruct o)

getDrawingContextWindow :: (MonadIO m, IsDrawingContext o) => o -> m Window