GI.Gsk.Structs.RoundedRect

A rectangular region with rounded corners.

Application code should normalize rectangles using roundedRectNormalize; this function will ensure that the bounds of the rectanlge are normalized and ensure that the corner values are positive and the corners do not overlap. All functions taking a RoundedRect as an argument will internally operate on a normalized copy; all functions returning a RoundedRect will always return a normalized one.

Exported types

newtype RoundedRect

Memory-managed wrapper type.

Constructors

RoundedRect (ManagedPtr RoundedRect)

Instances

Eq RoundedRect

Defined in GI.Gsk.Structs.RoundedRect

Methods

(==) :: RoundedRect -> RoundedRect -> Bool

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

ManagedPtrNewtype RoundedRect

Defined in GI.Gsk.Structs.RoundedRect

Methods

toManagedPtr :: RoundedRect -> ManagedPtr RoundedRect

BoxedPtr RoundedRect

Defined in GI.Gsk.Structs.RoundedRect

Methods

boxedPtrCopy :: RoundedRect -> IO RoundedRect

boxedPtrFree :: RoundedRect -> IO ()

CallocPtr RoundedRect

Defined in GI.Gsk.Structs.RoundedRect

Methods

boxedPtrCalloc :: IO (Ptr RoundedRect)

tag ~ 'AttrSet => Constructible RoundedRect tag

Defined in GI.Gsk.Structs.RoundedRect

Methods

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

newZeroRoundedRect :: MonadIO m => m RoundedRect

Construct a RoundedRect struct initialized to zero.

Methods

Overloaded methods

containsPoint

roundedRectContainsPoint

Arguments

:: (HasCallStack, MonadIO m)

=> RoundedRect

self: a RoundedRect

-> Point

point: the point to check

-> m Bool

Returns: True if the point is inside the rounded rectangle

Checks if the given point is inside the rounded rectangle. This function returns False if the point is in the rounded corner areas.

containsRect

roundedRectContainsRect

Arguments

:: (HasCallStack, MonadIO m)

=> RoundedRect

self: a RoundedRect

-> Rect

rect: the rectangle to check

-> m Bool

Returns: True if the rect is fully contained inside the rounded rectangle

Checks if the given rect is contained inside the rounded rectangle. This function returns False if rect extends into one of the rounded corner areas.

init

roundedRectInit

Arguments

:: (HasCallStack, MonadIO m)

=> RoundedRect

self: The RoundedRect to initialize

-> Rect

bounds: a Rect describing the bounds

-> Size

topLeft: the rounding radius of the top left corner

-> Size

topRight: the rounding radius of the top right corner

-> Size

bottomRight: the rounding radius of the bottom right corner

-> Size

bottomLeft: the rounding radius of the bottom left corner

-> m RoundedRect

Returns: the initialized rectangle

Initializes the given RoundedRect with the given values.

This function will implicitly normalize the RoundedRect before returning.

initCopy

roundedRectInitCopy

Arguments

:: (HasCallStack, MonadIO m)

=> RoundedRect

self: a RoundedRect

-> RoundedRect

src: a RoundedRect

-> m RoundedRect

Returns: the initialized rectangle

Initializes self using the given src rectangle.

This function will not normalize the RoundedRect, so make sure the source is normalized.

initFromRect

roundedRectInitFromRect

Arguments

:: (HasCallStack, MonadIO m)

=> RoundedRect

self: a RoundedRect

-> Rect

bounds: a Rect

-> Float

radius: the border radius

-> m RoundedRect

Returns: the initialized rectangle

Initializes self to the given bounds and sets the radius of all four corners to radius.

intersectsRect

roundedRectIntersectsRect

Arguments

:: (HasCallStack, MonadIO m)

=> RoundedRect

self: a RoundedRect

-> Rect

rect: the rectangle to check

-> m Bool

Returns: True if the rect intersects with the rounded rectangle

Checks if part of the given rect is contained inside the rounded rectangle. This function returns False if rect only extends into one of the rounded corner areas but not into the rounded rectangle itself.

isRectilinear

roundedRectIsRectilinear

Arguments

:: (HasCallStack, MonadIO m)

=> RoundedRect

self: the RoundedRect to check

-> m Bool

Returns: True if the rectangle is rectilinear

Checks if all corners of self are right angles and the rectangle covers all of its bounds.

This information can be used to decide if clipNodeNew or roundedClipNodeNew should be called.

normalize

roundedRectNormalize

Arguments

:: (HasCallStack, MonadIO m)

=> RoundedRect

self: a RoundedRect

-> m RoundedRect

Returns: the normalized rectangle

Normalizes the passed rectangle.

this function will ensure that the bounds of the rectanlge are normalized and ensure that the corner values are positive and the corners do not overlap.

offset

roundedRectOffset

Arguments

:: (HasCallStack, MonadIO m)

=> RoundedRect

self: a RoundedRect

-> Float

dx: the horizontal offset

-> Float

dy: the vertical offset

-> m RoundedRect

Returns: the offset rectangle

Offsets the bound's origin by dx and dy.

The size and corners of the rectangle are unchanged.

shrink

roundedRectShrink

Arguments

:: (HasCallStack, MonadIO m)

=> RoundedRect

self: The RoundedRect to shrink or grow

-> Float

top: How far to move the top side downwards

-> Float

right: How far to move the right side to the left

-> Float

bottom: How far to move the bottom side upwards

-> Float

left: How far to move the left side to the right

-> m RoundedRect

Returns: the resized RoundedRect

Shrinks (or grows) the given rectangle by moving the 4 sides according to the offsets given. The corner radii will be changed in a way that tries to keep the center of the corner circle intact. This emulates CSS behavior.

This function also works for growing rectangles if you pass negative values for the top, right, bottom or left.

Properties

bounds

the bounds of the rectangle

getRoundedRectBounds :: MonadIO m => RoundedRect -> m Rect

Get the value of the “bounds” field. When overloading is enabled, this is equivalent to

get roundedRect #bounds