Graphics.UI.Gtk.Gdk.GC

Graphics contexts - objects to encapsulate drawing properties

Detail

All drawing operations in Gdk take a graphics context (GC) argument. A graphics context encapsulates information about the way things are drawn, such as the foreground color or line width. By using graphics contexts, the number of arguments to each drawing call is greatly reduced, and communication overhead is minimized, since identical arguments do not need to be passed repeatedly.

Most values of a graphics context can be set at creation time by using gcNewWithValues. A few of the values in the GC, such as the dash pattern, can only be set by the latter method.

Graphics Contexts are removed in Gtk3, so this module is empty.

data GC

Instances

Eq GC

Methods

(==) :: GC -> GC -> Bool

(/=) :: GC -> GC -> Bool

Ord GC

Methods

compare :: GC -> GC -> Ordering

(<) :: GC -> GC -> Bool

(<=) :: GC -> GC -> Bool

(>) :: GC -> GC -> Bool

(>=) :: GC -> GC -> Bool

max :: GC -> GC -> GC

min :: GC -> GC -> GC

GObjectClass GC

Methods

toGObject :: GC -> GObject

unsafeCastGObject :: GObject -> GC

GCClass GC

class GObjectClass o => GCClass o

Instances

GCClass GC

castToGC :: GObjectClass obj => obj -> GC

gTypeGC :: GType

gcNew :: DrawableClass d => d -> IO GC

Create an empty graphics context.

data GCValues

Intermediate data structure for GCs.

• If graphicsExposure is set then copying portions into a drawable will generate an "exposure" event, even if the destination area is not currently visible.

Removed in Gtk3.

Constructors

GCValues

Fields

• foreground :: Color
• background :: Color
• function :: Function
• fill :: Fill
• tile :: Maybe Pixmap
• stipple :: Maybe Pixmap
• clipMask :: Maybe Pixmap
• subwindowMode :: SubwindowMode
• tsXOrigin :: Int
• tsYOrigin :: Int
• clipXOrigin :: Int
• clipYOrigin :: Int
• graphicsExposure :: Bool
• lineWidth :: Int
• lineStyle :: LineStyle
• capStyle :: CapStyle
• joinStyle :: JoinStyle

Instances

Storable GCValues

Methods

sizeOf :: GCValues -> Int

alignment :: GCValues -> Int

peekElemOff :: Ptr GCValues -> Int -> IO GCValues

pokeElemOff :: Ptr GCValues -> Int -> GCValues -> IO ()

peekByteOff :: Ptr b -> Int -> IO GCValues

pokeByteOff :: Ptr b -> Int -> GCValues -> IO ()

peek :: Ptr GCValues -> IO GCValues

poke :: Ptr GCValues -> GCValues -> IO ()

newGCValues :: GCValues

data Color :: *

Color

• Specifies a color with three integer values for red, green and blue. All values range from 0 (least intense) to 65535 (highest intensity).

Constructors

Color Word16 Word16 Word16

Instances

Eq Color

Methods

(==) :: Color -> Color -> Bool

(/=) :: Color -> Color -> Bool

Show Color

Methods

showsPrec :: Int -> Color -> ShowS

show :: Color -> String

showList :: [Color] -> ShowS

data Function

Determine how bitmap operations are carried out.

Removed in Gtk3.

Constructors

Copy

Invert

Xor

Clear

And

AndReverse

AndInvert

Noop

Or

Equiv

OrReverse

CopyInvert

OrInvert

Nand

Nor

Set

Instances

Enum Function

Methods

succ :: Function -> Function

pred :: Function -> Function

toEnum :: Int -> Function

fromEnum :: Function -> Int

enumFrom :: Function -> [Function]

enumFromThen :: Function -> Function -> [Function]

enumFromTo :: Function -> Function -> [Function]

enumFromThenTo :: Function -> Function -> Function -> [Function]

Eq Function

Methods

(==) :: Function -> Function -> Bool

(/=) :: Function -> Function -> Bool

Show Function

Methods

showsPrec :: Int -> Function -> ShowS

show :: Function -> String

showList :: [Function] -> ShowS

data Fill

How objects are filled.

Removed in Gtk3.

Constructors

Solid

Tiled

Stippled

OpaqueStippled

Instances

Enum Fill

Methods

succ :: Fill -> Fill

pred :: Fill -> Fill

toEnum :: Int -> Fill

fromEnum :: Fill -> Int

enumFrom :: Fill -> [Fill]

enumFromThen :: Fill -> Fill -> [Fill]

enumFromTo :: Fill -> Fill -> [Fill]

enumFromThenTo :: Fill -> Fill -> Fill -> [Fill]

Eq Fill

Methods

(==) :: Fill -> Fill -> Bool

(/=) :: Fill -> Fill -> Bool

Show Fill

Methods

showsPrec :: Int -> Fill -> ShowS

show :: Fill -> String

showList :: [Fill] -> ShowS

data SubwindowMode

Determine if child widget may be overdrawn.

Removed in Gtk3.

Constructors

ClipByChildren

IncludeInferiors

Instances

Enum SubwindowMode

visibility of a window

Methods

succ :: SubwindowMode -> SubwindowMode

pred :: SubwindowMode -> SubwindowMode

toEnum :: Int -> SubwindowMode

fromEnum :: SubwindowMode -> Int

enumFrom :: SubwindowMode -> [SubwindowMode]

enumFromThen :: SubwindowMode -> SubwindowMode -> [SubwindowMode]

enumFromTo :: SubwindowMode -> SubwindowMode -> [SubwindowMode]

enumFromThenTo :: SubwindowMode -> SubwindowMode -> SubwindowMode -> [SubwindowMode]

Eq SubwindowMode

Methods

(==) :: SubwindowMode -> SubwindowMode -> Bool

(/=) :: SubwindowMode -> SubwindowMode -> Bool

Show SubwindowMode

Methods

showsPrec :: Int -> SubwindowMode -> ShowS

show :: SubwindowMode -> String

showList :: [SubwindowMode] -> ShowS

data LineStyle

Determines if a line is solid or dashed.

Removed in Gtk3.

Constructors

LineSolid

LineOnOffDash

LineDoubleDash

Instances

Enum LineStyle

Methods

succ :: LineStyle -> LineStyle

pred :: LineStyle -> LineStyle

toEnum :: Int -> LineStyle

fromEnum :: LineStyle -> Int

enumFrom :: LineStyle -> [LineStyle]

enumFromThen :: LineStyle -> LineStyle -> [LineStyle]

enumFromTo :: LineStyle -> LineStyle -> [LineStyle]

enumFromThenTo :: LineStyle -> LineStyle -> LineStyle -> [LineStyle]

Eq LineStyle

Methods

(==) :: LineStyle -> LineStyle -> Bool

(/=) :: LineStyle -> LineStyle -> Bool

Show LineStyle

Methods

showsPrec :: Int -> LineStyle -> ShowS

show :: LineStyle -> String

showList :: [LineStyle] -> ShowS

data CapStyle

Specify the how the ends of a line is drawn.

Removed in Gtk3.

Constructors

CapNotLast

CapButt

CapRound

CapProjecting

Instances

Enum CapStyle

Methods

succ :: CapStyle -> CapStyle

pred :: CapStyle -> CapStyle

toEnum :: Int -> CapStyle

fromEnum :: CapStyle -> Int

enumFrom :: CapStyle -> [CapStyle]

enumFromThen :: CapStyle -> CapStyle -> [CapStyle]

enumFromTo :: CapStyle -> CapStyle -> [CapStyle]

enumFromThenTo :: CapStyle -> CapStyle -> CapStyle -> [CapStyle]

Eq CapStyle

Methods

(==) :: CapStyle -> CapStyle -> Bool

(/=) :: CapStyle -> CapStyle -> Bool

Show CapStyle

Methods

showsPrec :: Int -> CapStyle -> ShowS

show :: CapStyle -> String

showList :: [CapStyle] -> ShowS

data JoinStyle

Constructors

JoinMiter

JoinRound

JoinBevel

Instances

Enum JoinStyle

Methods

succ :: JoinStyle -> JoinStyle

pred :: JoinStyle -> JoinStyle

toEnum :: Int -> JoinStyle

fromEnum :: JoinStyle -> Int

enumFrom :: JoinStyle -> [JoinStyle]

enumFromThen :: JoinStyle -> JoinStyle -> [JoinStyle]

enumFromTo :: JoinStyle -> JoinStyle -> [JoinStyle]

enumFromThenTo :: JoinStyle -> JoinStyle -> JoinStyle -> [JoinStyle]

Eq JoinStyle

Methods

(==) :: JoinStyle -> JoinStyle -> Bool

(/=) :: JoinStyle -> JoinStyle -> Bool

Show JoinStyle

Methods

showsPrec :: Int -> JoinStyle -> ShowS

show :: JoinStyle -> String

showList :: [JoinStyle] -> ShowS

gcNewWithValues :: DrawableClass d => d -> GCValues -> IO GC

Creates a graphics context with specific values.

gcSetValues :: GC -> GCValues -> IO ()

Change some of the values of a graphics context.

gcGetValues :: GC -> IO GCValues

Retrieve the values in a graphics context.

gcSetClipRectangle :: GC -> Rectangle -> IO ()

Set a clipping rectangle.

• All drawing operations are restricted to this rectangle. This rectangle is interpreted relative to the clip origin.

gcSetClipRegion :: GC -> Region -> IO ()

Set a clipping region.

• All drawing operations are restricted to this region. This region is interpreted relative to the clip origin.

gcSetDashes :: GC -> Int -> [(Int, Int)] -> IO ()

Specify the pattern with which lines are drawn.

• Every tuple in the list contains an even and an odd segment. Even segments are drawn normally, whereby the lineStyle member of the graphics context defines if odd segements are drawn or not. A phase argument greater than 0 will drop phase pixels before starting to draw.