GI.Pango.Structs.LayoutLine

The LayoutLine structure represents one of the lines resulting from laying out a paragraph via Layout. LayoutLine structures are obtained by calling layoutGetLine and are only valid until the text, attributes, or settings of the parent Layout are modified.

Routines for rendering PangoLayout objects are provided in code specific to each rendering system.

Exported types

newtype LayoutLine

Constructors

LayoutLine (ManagedPtr LayoutLine)

Instances

BoxedObject LayoutLine

Methods

boxedType :: LayoutLine -> IO GType

(~) AttrOpTag tag AttrSet => Constructible LayoutLine tag

Methods

new :: MonadIO m => (ManagedPtr LayoutLine -> LayoutLine) -> [AttrOp LayoutLine tag] -> m LayoutLine

((~) * info (ResolveLayoutLineMethod t LayoutLine), MethodInfo * info LayoutLine p) => IsLabel t (LayoutLine -> p)

Methods

fromLabel :: Proxy# Symbol t -> LayoutLine -> p

((~) * info (ResolveLayoutLineMethod t LayoutLine), MethodInfo * info LayoutLine p) => IsLabelProxy t (LayoutLine -> p)

Methods

fromLabelProxy :: Proxy Symbol t -> LayoutLine -> p

HasAttributeList * LayoutLine

((~) * signature (Int32 -> m (Bool, Int32, Int32)), MonadIO m) => MethodInfo * LayoutLineXToIndexMethodInfo LayoutLine signature

Methods

overloadedMethod :: MethodProxy LayoutLineXToIndexMethodInfo LayoutLine -> signature -> s

((~) * signature (m ()), MonadIO m) => MethodInfo * LayoutLineUnrefMethodInfo LayoutLine signature

Methods

overloadedMethod :: MethodProxy LayoutLineUnrefMethodInfo LayoutLine -> signature -> s

((~) * signature (m LayoutLine), MonadIO m) => MethodInfo * LayoutLineRefMethodInfo LayoutLine signature

Methods

overloadedMethod :: MethodProxy LayoutLineRefMethodInfo LayoutLine -> signature -> s

((~) * signature (Int32 -> Bool -> m Int32), MonadIO m) => MethodInfo * LayoutLineIndexToXMethodInfo LayoutLine signature

Methods

overloadedMethod :: MethodProxy LayoutLineIndexToXMethodInfo LayoutLine -> signature -> s

((~) * signature (Int32 -> Int32 -> m [Int32]), MonadIO m) => MethodInfo * LayoutLineGetXRangesMethodInfo LayoutLine signature

Methods

overloadedMethod :: MethodProxy LayoutLineGetXRangesMethodInfo LayoutLine -> signature -> s

((~) * signature (m (Rectangle, Rectangle)), MonadIO m) => MethodInfo * LayoutLineGetPixelExtentsMethodInfo LayoutLine signature

Methods

overloadedMethod :: MethodProxy LayoutLineGetPixelExtentsMethodInfo LayoutLine -> signature -> s

((~) * signature (m (Rectangle, Rectangle)), MonadIO m) => MethodInfo * LayoutLineGetExtentsMethodInfo LayoutLine signature

Methods

overloadedMethod :: MethodProxy LayoutLineGetExtentsMethodInfo LayoutLine -> signature -> s

type AttributeList LayoutLine

type AttributeList LayoutLine

newZeroLayoutLine :: MonadIO m => m LayoutLine

Construct a LayoutLine struct initialized to zero.

noLayoutLine :: Maybe LayoutLine

Methods

getExtents

data LayoutLineGetExtentsMethodInfo

Instances

((~) * signature (m (Rectangle, Rectangle)), MonadIO m) => MethodInfo * LayoutLineGetExtentsMethodInfo LayoutLine signature

Methods

overloadedMethod :: MethodProxy LayoutLineGetExtentsMethodInfo LayoutLine -> signature -> s

layoutLineGetExtents

Arguments

:: (HasCallStack, MonadIO m)

=> LayoutLine

line: a LayoutLine

-> m (Rectangle, Rectangle)

Computes the logical and ink extents of a layout line. See fontGetGlyphExtents for details about the interpretation of the rectangles.

getPixelExtents

data LayoutLineGetPixelExtentsMethodInfo

Instances

((~) * signature (m (Rectangle, Rectangle)), MonadIO m) => MethodInfo * LayoutLineGetPixelExtentsMethodInfo LayoutLine signature

Methods

overloadedMethod :: MethodProxy LayoutLineGetPixelExtentsMethodInfo LayoutLine -> signature -> s

layoutLineGetPixelExtents

Arguments

:: (HasCallStack, MonadIO m)

=> LayoutLine

layoutLine: a LayoutLine

-> m (Rectangle, Rectangle)

Computes the logical and ink extents of layoutLine in device units. This function just calls layoutLineGetExtents followed by two extentsToPixels calls, rounding inkRect and logicalRect such that the rounded rectangles fully contain the unrounded one (that is, passes them as first argument to extentsToPixels).

getXRanges

data LayoutLineGetXRangesMethodInfo

Instances

((~) * signature (Int32 -> Int32 -> m [Int32]), MonadIO m) => MethodInfo * LayoutLineGetXRangesMethodInfo LayoutLine signature

Methods

overloadedMethod :: MethodProxy LayoutLineGetXRangesMethodInfo LayoutLine -> signature -> s

layoutLineGetXRanges

Arguments

:: (HasCallStack, MonadIO m)

=> LayoutLine

line: a LayoutLine

-> Int32

startIndex: Start byte index of the logical range. If this value is less than the start index for the line, then the first range will extend all the way to the leading edge of the layout. Otherwise it will start at the leading edge of the first character.

-> Int32

endIndex: Ending byte index of the logical range. If this value is greater than the end index for the line, then the last range will extend all the way to the trailing edge of the layout. Otherwise, it will end at the trailing edge of the last character.

-> m [Int32]

Gets a list of visual ranges corresponding to a given logical range. This list is not necessarily minimal - there may be consecutive ranges which are adjacent. The ranges will be sorted from left to right. The ranges are with respect to the left edge of the entire layout, not with respect to the line.

indexToX

data LayoutLineIndexToXMethodInfo

Instances

((~) * signature (Int32 -> Bool -> m Int32), MonadIO m) => MethodInfo * LayoutLineIndexToXMethodInfo LayoutLine signature

Methods

overloadedMethod :: MethodProxy LayoutLineIndexToXMethodInfo LayoutLine -> signature -> s

layoutLineIndexToX

Arguments

:: (HasCallStack, MonadIO m)

=> LayoutLine

line: a LayoutLine

-> Int32

index_: byte offset of a grapheme within the layout

-> Bool

trailing: an integer indicating the edge of the grapheme to retrieve the position of. If > 0, the trailing edge of the grapheme, if 0, the leading of the grapheme.

-> m Int32

Converts an index within a line to a X position.

ref

data LayoutLineRefMethodInfo

Instances

((~) * signature (m LayoutLine), MonadIO m) => MethodInfo * LayoutLineRefMethodInfo LayoutLine signature

Methods

overloadedMethod :: MethodProxy LayoutLineRefMethodInfo LayoutLine -> signature -> s

layoutLineRef

Arguments

:: (HasCallStack, MonadIO m)

=> LayoutLine

line: a LayoutLine, may be Nothing

-> m LayoutLine

Returns: the line passed in.

Increase the reference count of a LayoutLine by one.

Since: 1.10

unref

data LayoutLineUnrefMethodInfo

Instances

((~) * signature (m ()), MonadIO m) => MethodInfo * LayoutLineUnrefMethodInfo LayoutLine signature

Methods

overloadedMethod :: MethodProxy LayoutLineUnrefMethodInfo LayoutLine -> signature -> s

layoutLineUnref

Arguments

:: (HasCallStack, MonadIO m)

=> LayoutLine

line: a LayoutLine

-> m ()

Decrease the reference count of a LayoutLine by one. If the result is zero, the line and all associated memory will be freed.

xToIndex

data LayoutLineXToIndexMethodInfo

Instances

((~) * signature (Int32 -> m (Bool, Int32, Int32)), MonadIO m) => MethodInfo * LayoutLineXToIndexMethodInfo LayoutLine signature

Methods

overloadedMethod :: MethodProxy LayoutLineXToIndexMethodInfo LayoutLine -> signature -> s

layoutLineXToIndex

Arguments

:: (HasCallStack, MonadIO m)

=> LayoutLine

line: a LayoutLine

-> Int32

xPos: the X offset (in Pango units) from the left edge of the line.

-> m (Bool, Int32, Int32)

Returns: False if xPos was outside the line, True if inside

Converts from x offset to the byte index of the corresponding character within the text of the layout. If xPos is outside the line, index_ and trailing will point to the very first or very last position in the line. This determination is based on the resolved direction of the paragraph; for example, if the resolved direction is right-to-left, then an X position to the right of the line (after it) results in 0 being stored in index_ and trailing. An X position to the left of the line results in index_ pointing to the (logical) last grapheme in the line and trailing being set to the number of characters in that grapheme. The reverse is true for a left-to-right line.

Properties

isParagraphStart

getLayoutLineIsParagraphStart :: MonadIO m => LayoutLine -> m Word32

layoutLine_isParagraphStart :: AttrLabelProxy "isParagraphStart"

setLayoutLineIsParagraphStart :: MonadIO m => LayoutLine -> Word32 -> m ()

layout

clearLayoutLineLayout :: MonadIO m => LayoutLine -> m ()

getLayoutLineLayout :: MonadIO m => LayoutLine -> m (Maybe Layout)

layoutLine_layout :: AttrLabelProxy "layout"

setLayoutLineLayout :: MonadIO m => LayoutLine -> Ptr Layout -> m ()

length

getLayoutLineLength :: MonadIO m => LayoutLine -> m Int32

layoutLine_length :: AttrLabelProxy "length"

setLayoutLineLength :: MonadIO m => LayoutLine -> Int32 -> m ()

resolvedDir

getLayoutLineResolvedDir :: MonadIO m => LayoutLine -> m Word32

layoutLine_resolvedDir :: AttrLabelProxy "resolvedDir"

setLayoutLineResolvedDir :: MonadIO m => LayoutLine -> Word32 -> m ()

runs

clearLayoutLineRuns :: MonadIO m => LayoutLine -> m ()

getLayoutLineRuns :: MonadIO m => LayoutLine -> m [Ptr ()]

layoutLine_runs :: AttrLabelProxy "runs"

setLayoutLineRuns :: MonadIO m => LayoutLine -> Ptr (GSList (Ptr ())) -> m ()

startIndex

getLayoutLineStartIndex :: MonadIO m => LayoutLine -> m Int32

layoutLine_startIndex :: AttrLabelProxy "startIndex"

setLayoutLineStartIndex :: MonadIO m => LayoutLine -> Int32 -> m ()