hi::v1::widget_layout Class Reference

#include <hikogui/GUI/widget_layout.hpp>

Public Member Functions
constexpr	widget_layout (widget_layout const &) noexcept=default
constexpr	widget_layout (widget_layout &&) noexcept=default
constexpr widget_layout &	operator= (widget_layout const &) noexcept=default
constexpr widget_layout &	operator= (widget_layout &&) noexcept=default
constexpr bool	empty () const noexcept
constexpr	operator bool () const noexcept
constexpr translate3	to_window3 () const noexcept
constexpr bool	contains (point3 mouse_position) const noexcept
	Check if the mouse position is inside the widget.
constexpr aarectangle	rectangle () const noexcept
constexpr aarectangle	rectangle_on_window () const noexcept
	Get the rectangle in window coordinate system.
constexpr aarectangle	clipping_rectangle_on_window () const noexcept
	Get the clipping rectangle in window coordinate system.
constexpr aarectangle	clipping_rectangle_on_window (aarectangle narrow_clipping_rectangle) const noexcept
	Get the clipping rectangle in window coordinate system.
constexpr float	width () const noexcept
constexpr float	height () const noexcept
constexpr extent2	size () const noexcept
constexpr	widget_layout (extent2 window_size, gui_window_size window_size_state, hi::subpixel_orientation subpixel_orientation, utc_nanoseconds display_time_point) noexcept
	Construct a widget_layout from inside the window.
constexpr widget_layout	transform (box_shape const &child_shape, float child_elevation, aarectangle new_clipping_rectangle) const noexcept
	Create a new widget_layout for the child widget.
constexpr widget_layout	transform (box_shape const &child_shape, float child_elevation=1.0f) const noexcept
	Create a new widget_layout for the child widget.
constexpr widget_layout	override_clip (aarectangle new_clipping_rectangle) const noexcept
	Override e context with the new clipping rectangle.

Data Fields
box_shape	shape
	Shape of the widget.
translate2	to_parent = {}
	This matrix transforms local coordinates to the coordinates of the parent widget.
translate2	from_parent = {}
	This matrix transforms parent widget's coordinates to local coordinates.
translate2	to_window = {}
	This matrix transforms local coordinates to window coordinates.
translate2	from_window = {}
	This matrix transforms window coordinates to local coordinates.
extent2	window_size = {}
	Size of the window.
float	elevation = 0.0f
	The elevation of the widget above the window.
gui_window_size	window_size_state = gui_window_size::normal
aarectangle	clipping_rectangle = {}
	The clipping rectangle.
extent2	sub_pixel_size = {1.0f, 1.0f}
	The size of a sub-pixel.
utc_nanoseconds	display_time_point = {}
	The layout created for displaying at this time point.

Static Public Attributes
static constexpr float	redraw_overhang = 2
	The amount of pixels that the redraw request will overhang the widget.

Friends
constexpr friend bool	operator== (widget_layout const &, widget_layout const &) noexcept=default

Detailed Description

The layout of a widget.

This object is created by a container to position a child-widget within it.

The layout includes:

• the size of the widget.
• translation matrices between the parent and child widget.
• translation matrices between the child widget and the window.
• the clipping rectangle when the parent only wants to display a part the child.
• if the widget should display itself in left-to-right or right-to-left language mode.
• the baseline where text should be drawn.

Constructor & Destructor Documentation

widget_layout()

hi::v1::widget_layout::widget_layout ( extent2 window_size, gui_window_size window_size_state, hi::subpixel_orientation subpixel_orientation, utc_nanoseconds display_time_point )

inlineconstexprnoexcept

Construct a widget_layout from inside the window.

Member Function Documentation

clipping_rectangle_on_window() [1/2]

aarectangle hi::v1::widget_layout::clipping_rectangle_on_window ( ) const

inlinenodiscardconstexprnoexcept

Get the clipping rectangle in window coordinate system.

clipping_rectangle_on_window() [2/2]

aarectangle hi::v1::widget_layout::clipping_rectangle_on_window ( aarectangle narrow_clipping_rectangle ) const

inlinenodiscardconstexprnoexcept

Get the clipping rectangle in window coordinate system.

Parameters

narrow_clipping_rectangle

A clipping rectangle in local coordinate system that will be intersected with the layout's clipping rectangle.

contains()

bool hi::v1::widget_layout::contains ( point3 mouse_position ) const

inlinenodiscardconstexprnoexcept

Check if the mouse position is inside the widget.

Parameters

mouse_position

The mouse position in local coordinates.

Returns

True if the mouse position is on the widget and is not clipped.

override_clip()

widget_layout hi::v1::widget_layout::override_clip ( aarectangle new_clipping_rectangle ) const

inlinenodiscardconstexprnoexcept

Override e context with the new clipping rectangle.

Parameters

new_clipping_rectangle

The new clipping rectangle.

Returns

A new context that is clipped..

rectangle_on_window()

aarectangle hi::v1::widget_layout::rectangle_on_window ( ) const

inlinenodiscardconstexprnoexcept

Get the rectangle in window coordinate system.

transform() [1/2]

widget_layout hi::v1::widget_layout::transform ( box_shape const & child_shape, float child_elevation, aarectangle new_clipping_rectangle ) const

inlinenodiscardconstexprnoexcept

Create a new widget_layout for the child widget.

Parameters

child_shape	The location and size of the child widget, relative to the current widget.
child_elevation	The elevation of the child widget, relative to the current widget.
new_clipping_rectangle	The new clipping rectangle of the child widget, relative to the current widget.

Returns

A new widget_layout for use by the child widget.

transform() [2/2]

widget_layout hi::v1::widget_layout::transform ( box_shape const & child_shape, float child_elevation = 1.0f ) const

inlinenodiscardconstexprnoexcept

Create a new widget_layout for the child widget.

Parameters

child_shape	The location and size of the child widget, relative to the current widget.
child_elevation	The elevation of the child widget, relative to the current widget.

Returns

A new widget_layout for use by the child widget.

Field Documentation

clipping_rectangle

aarectangle hi::v1::widget_layout::clipping_rectangle = {}

The clipping rectangle.

This is the rectangle that all drawing must be clipped to. This rectangle often includes the margin, as widget may draw in their own margin.

The clipping rectangle may be smaller than the widget, or even empty when the widget is scrolled outside of the aperture of a scroll widget.

Note

widget's coordinate system.

display_time_point

utc_nanoseconds hi::v1::widget_layout::display_time_point = {}

The layout created for displaying at this time point.

elevation

float hi::v1::widget_layout::elevation = 0.0f

The elevation of the widget above the window.

from_parent

translate2 hi::v1::widget_layout::from_parent = {}

This matrix transforms parent widget's coordinates to local coordinates.

from_window

translate2 hi::v1::widget_layout::from_window = {}

This matrix transforms window coordinates to local coordinates.

redraw_overhang

float hi::v1::widget_layout::redraw_overhang = 2

staticconstexpr

The amount of pixels that the redraw request will overhang the widget.

Widgets are allowed to draw inside their margins, in most cases this will just be a border.

shape

box_shape hi::v1::widget_layout::shape

Shape of the widget.

Since a widget_layout is always in local coordinates, the left and bottom values are zero.

sub_pixel_size

extent2 hi::v1::widget_layout::sub_pixel_size = {1.0f, 1.0f}

The size of a sub-pixel.

Note

the sub-pixel-size is represented in the widget's coordinate system.

to_parent

translate2 hi::v1::widget_layout::to_parent = {}

This matrix transforms local coordinates to the coordinates of the parent widget.

to_window

translate2 hi::v1::widget_layout::to_window = {}

This matrix transforms local coordinates to window coordinates.

window_size

extent2 hi::v1::widget_layout::window_size = {}

Size of the window.

---

The documentation for this class was generated from the following file:

• hikogui/src/hikogui/GUI/widget_layout.hpp