Menu Graphical User Interface Components. More...

Data Structures
struct	component_context_menu_t
	Context menu structure. More...

struct	component_boxart_t
	Box Art Structure. More...

struct	component_context_menu_t.list

Macros
#define	COMPONENT_CONTEXT_MENU_LIST_END { .text = NULL }

Enumerations
enum	file_image_type_t { IMAGE_BOXART_FRONT , IMAGE_BOXART_BACK , IMAGE_BOXART_TOP , IMAGE_BOXART_BOTTOM , IMAGE_BOXART_LEFT , IMAGE_BOXART_RIGHT , IMAGE_GAMEPAK_FRONT , IMAGE_GAMEPAK_BACK , IMAGE_THUMBNAIL , IMAGE_TYPE_END }
	File image Enumeration. More...

Functions
void	ui_components_box_draw (int x0, int y0, int x1, int y1, color_t color)
	Draw a box component.

void	ui_components_border_draw (int x0, int y0, int x1, int y1)
	Draw a border component.

void	ui_components_layout_draw_tabbed (void)
	Draw the layout component with tabs.

void	ui_components_layout_draw (void)
	Draw the layout component.

void	ui_components_progressbar_draw (int x0, int y0, int x1, int y1, float progress)
	Draw a progress bar component.

void	ui_components_seekbar_draw (float progress)
	Draw a seek bar component.

void	ui_components_loader_draw (float position)
	Draw a loader component.

void	ui_components_scrollbar_draw (int x, int y, int width, int height, int position, int items, int visible_items)
	Draw a scrollbar component.

void	ui_components_list_scrollbar_draw (int position, int items, int visible_items)
	Draw a list scrollbar component.

void	ui_components_dialog_draw (int width, int height)
	Draw a dialog component.

void	ui_components_messagebox_draw (char *fmt,...)
	Draw a message box component.

void	ui_components_main_text_draw (rdpq_align_t align, rdpq_valign_t valign, char *fmt,...)
	Draw the main text component.

void	ui_components_actions_bar_text_draw (rdpq_align_t align, rdpq_valign_t valign, char *fmt,...)
	Draw the actions bar text component.

void	ui_components_background_init (char *cache_location)
	Initialize the background component.

void	ui_components_background_free (void)
	Free the background component resources.

void	ui_components_background_replace_image (surface_t *image)
	Replace the background image.

void	ui_components_background_draw (void)
	Draw the background component.

void	ui_components_file_list_draw (entry_t *list, int entries, int selected)
	Draw the file list component.

void	ui_components_context_menu_init (component_context_menu_t *cm)
	Initialize the context menu component.

void	ui_components_context_menu_show (component_context_menu_t *cm)
	Show the context menu component.

bool	ui_components_context_menu_process (menu_t menu, component_context_menu_t cm)
	Process the context menu component.

void	ui_components_context_menu_draw (component_context_menu_t *cm)
	Draw the context menu component.

component_boxart_t *	ui_components_boxart_init (const char storage_prefix, char game_code, file_image_type_t current_image_view)
	Initialize the box art component.

void	ui_components_boxart_free (component_boxart_t *b)
	Free the box art component resources.

void	ui_components_boxart_draw (component_boxart_t *b)
	Draw the box art component.

void	ui_components_tabs_draw (const char **text, int count, int selected, float width)
	Draw the tabs component.

void	ui_components_tabs_common_draw (int selected)
	Draw the common part of the tabs component.

Detailed Description

Menu Graphical User Interface Components.

Data Structure Documentation

◆ component_context_menu_t

struct component_context_menu_t

Context menu structure.

Data Fields
int	row_count	Number of rows in the context menu
int	row_selected	Index of the selected row
bool	hide_pending	Flag to indicate if hiding is pending
struct component_context_menu *	parent	Pointer to the parent context menu
struct component_context_menu *	submenu	Pointer to the submenu
struct component_context_menu_t.list	list[]	List of menu items

◆ component_boxart_t

struct component_boxart_t

Box Art Structure.

Data Fields
bool	loading	Flag to indicate if the box art is loading
surface_t *	image	Pointer to the box art image

◆ component_context_menu_t.list

struct component_context_menu_t.list

Data Fields
const char *	text	Text of the menu item
void()(menu_t menu, void *arg)	action	Action function for the menu item
void *	arg	Argument for the action function
struct component_context_menu *	submenu	Pointer to the submenu

Macro Definition Documentation

◆ COMPONENT_CONTEXT_MENU_LIST_END

#define COMPONENT_CONTEXT_MENU_LIST_END { .text = NULL }

End marker for the context menu list

Enumeration Type Documentation

◆ file_image_type_t

enum file_image_type_t

File image Enumeration.

Enumeration for different types of file images used in the user interface.

Enumerator
IMAGE_BOXART_FRONT	Boxart image from the front
IMAGE_BOXART_BACK	Boxart image from the back
IMAGE_BOXART_TOP	Boxart image from the top
IMAGE_BOXART_BOTTOM	Boxart image from the bottom
IMAGE_BOXART_LEFT	Boxart image from the left side
IMAGE_BOXART_RIGHT	Boxart image from the right side
IMAGE_GAMEPAK_FRONT	GamePak image from the front
IMAGE_GAMEPAK_BACK	GamePak image from the back
IMAGE_THUMBNAIL	File image thumbnail
IMAGE_TYPE_END	List end marker

Function Documentation

◆ ui_components_box_draw()

void ui_components_box_draw	(	int	x0,
		int	y0,
		int	x1,
		int	y1,
		color_t	color )

Draw a box component.

Parameters

x0	Starting x-coordinate.
y0	Starting y-coordinate.
x1	Ending x-coordinate.
y1	Ending y-coordinate.
color	Color of the box.

Draw a box component.

Parameters

x0	The x-coordinate of the top-left corner.
y0	The y-coordinate of the top-left corner.
x1	The x-coordinate of the bottom-right corner.
y1	The y-coordinate of the bottom-right corner.
color	The color of the box.

◆ ui_components_border_draw()

void ui_components_border_draw	(	int	x0,
		int	y0,
		int	x1,
		int	y1 )

Draw a border component.

Parameters

x0	Starting x-coordinate.
y0	Starting y-coordinate.
x1	Ending x-coordinate.
y1	Ending y-coordinate.

Draw a border component.

Parameters

x0	The x-coordinate of the top-left corner.
y0	The y-coordinate of the top-left corner.
x1	The x-coordinate of the bottom-right corner.
y1	The y-coordinate of the bottom-right corner.

◆ ui_components_layout_draw_tabbed()

void ui_components_layout_draw_tabbed ( void )

Draw the layout component with tabs.

◆ ui_components_layout_draw()

void ui_components_layout_draw ( void )

Draw the layout component.

◆ ui_components_progressbar_draw()

void ui_components_progressbar_draw	(	int	x0,
		int	y0,
		int	x1,
		int	y1,
		float	progress )

Draw a progress bar component.

Parameters

x0	Starting x-coordinate.
y0	Starting y-coordinate.
x1	Ending x-coordinate.
y1	Ending y-coordinate.
progress	Progress value (0.0 to 1.0).

Draw a progress bar component.

Parameters

x0	The x-coordinate of the top-left corner.
y0	The y-coordinate of the top-left corner.
x1	The x-coordinate of the bottom-right corner.
y1	The y-coordinate of the bottom-right corner.
progress	The progress value (0.0 to 1.0).

◆ ui_components_seekbar_draw()

void ui_components_seekbar_draw ( float position )

Draw a seek bar component.

Parameters

progress Progress value (0.0 to 1.0).

Draw a seek bar component.

Parameters

position The position value (0.0 to 1.0).

◆ ui_components_loader_draw()

void ui_components_loader_draw ( float progress )

Draw a loader component.

Parameters

position Position value (0.0 to 1.0).

Draw a loader component.

Parameters

progress The progress value (0.0 to 1.0).

◆ ui_components_scrollbar_draw()

void ui_components_scrollbar_draw	(	int	x,
		int	y,
		int	width,
		int	height,
		int	position,
		int	items,
		int	visible_items )

Draw a scrollbar component.

Parameters

x	Starting x-coordinate.
y	Starting y-coordinate.
width	Width of the scrollbar.
height	Height of the scrollbar.
position	Current position.
items	Total number of items.
visible_items	Number of visible items.

Draw a scrollbar component.

Parameters

x	The x-coordinate of the top-left corner.
y	The y-coordinate of the top-left corner.
width	The width of the scrollbar.
height	The height of the scrollbar.
position	The current position.
items	The total number of items.
visible_items	The number of visible items.

◆ ui_components_list_scrollbar_draw()

void ui_components_list_scrollbar_draw	(	int	position,
		int	items,
		int	visible_items )

Draw a list scrollbar component.

Parameters

position	Current position.
items	Total number of items.
visible_items	Number of visible items.

Draw a list scrollbar component.

Parameters

position	The current position.
items	The total number of items.
visible_items	The number of visible items.

◆ ui_components_dialog_draw()

void ui_components_dialog_draw	(	int	width,
		int	height )

Draw a dialog component.

Parameters

width	Width of the dialog.
height	Height of the dialog.

Draw a dialog component.

Parameters

width	The width of the dialog box.
height	The height of the dialog box.

◆ ui_components_messagebox_draw()

void ui_components_messagebox_draw	(	char *	fmt,
			... )

Draw a message box component.

Parameters

fmt	Format string for the message.
...	Additional arguments for the format string.

Draw a message box component.

Parameters

fmt	The format string.
...	The format arguments.

◆ ui_components_main_text_draw()

void ui_components_main_text_draw	(	rdpq_align_t	align,
		rdpq_valign_t	valign,
		char *	fmt,
			... )

Draw the main text component.

Parameters

align	Horizontal alignment.
valign	Vertical alignment.
fmt	Format string for the text.
...	Additional arguments for the format string.

Draw the main text component.

Parameters

align	The horizontal alignment.
valign	The vertical alignment.
fmt	The format string.
...	The format arguments.

◆ ui_components_actions_bar_text_draw()

void ui_components_actions_bar_text_draw	(	rdpq_align_t	align,
		rdpq_valign_t	valign,
		char *	fmt,
			... )

Draw the actions bar text component.

Parameters

align	Horizontal alignment.
valign	Vertical alignment.
fmt	Format string for the text.
...	Additional arguments for the format string.

Draw the actions bar text component.

Parameters

align	The horizontal alignment.
valign	The vertical alignment.
fmt	The format string.
...	The format arguments.

◆ ui_components_background_init()

void ui_components_background_init ( char * cache_location )

Initialize the background component.

Parameters

cache_location	Location of the cache.
cache_location	The cache location.

◆ ui_components_background_free()

void ui_components_background_free ( void )

Free the background component resources.

◆ ui_components_background_replace_image()

void ui_components_background_replace_image ( surface_t * image )

Replace the background image.

Parameters

image	New background image.
image	The new background image.

◆ ui_components_background_draw()

void ui_components_background_draw ( void )

Draw the background component.

◆ ui_components_file_list_draw()

void ui_components_file_list_draw	(	entry_t *	list,
		int	entries,
		int	selected )

Draw the file list component.

Parameters

list	List of entries.
entries	Number of entries.
selected	Index of the selected entry.
list	Pointer to the list of entries.
entries	Number of entries in the list.
selected	Index of the currently selected entry.

◆ ui_components_context_menu_init()

void ui_components_context_menu_init ( component_context_menu_t * cm )

Initialize the context menu component.

Parameters

cm	Pointer to the context menu structure.
cm	Pointer to the context menu component.

◆ ui_components_context_menu_show()

void ui_components_context_menu_show ( component_context_menu_t * cm )

Show the context menu component.

Parameters

cm	Pointer to the context menu structure.
cm	Pointer to the context menu component.

◆ ui_components_context_menu_process()

bool ui_components_context_menu_process	(	menu_t *	menu,
		component_context_menu_t *	cm )

Process the context menu component.

Parameters

menu	Pointer to the menu structure.
cm	Pointer to the context menu structure.

Returns: True if the context menu was processed, false otherwise.

Process the context menu component.

Parameters

menu	Pointer to the menu structure.
cm	Pointer to the context menu component.

Returns: true if the context menu is processed, false otherwise.

◆ ui_components_context_menu_draw()

void ui_components_context_menu_draw ( component_context_menu_t * cm )

Draw the context menu component.

Parameters

cm	Pointer to the context menu structure.
cm	Pointer to the context menu component.

◆ ui_components_boxart_init()

component_boxart_t * ui_components_boxart_init	(	const char *	storage_prefix,
		char *	game_code,
		file_image_type_t	current_image_view )

Initialize the box art component.

Parameters

storage_prefix	Prefix for the storage location.
game_code	Game code for the box art.
current_image_view	Current image view type.

Returns: Pointer to the initialized box art component.

Initialize the box art component.

Parameters

storage_prefix	The storage prefix.
game_code	The game code.
current_image_view	The current image view type.

Returns: component_boxart_t* Pointer to the initialized boxart component.

◆ ui_components_boxart_free()

void ui_components_boxart_free ( component_boxart_t * b )

Free the box art component resources.

Parameters

b	Pointer to the box art component.

Free the box art component resources.

Parameters

b	Pointer to the boxart component.

◆ ui_components_boxart_draw()

void ui_components_boxart_draw ( component_boxart_t * b )

Draw the box art component.

Parameters

b	Pointer to the box art component.

Draw the box art component.

Parameters

b	Pointer to the boxart component.

◆ ui_components_tabs_draw()

void ui_components_tabs_draw	(	const char **	text,
		int	count,
		int	selected,
		float	width )

Draw the tabs component.

Parameters

text	Array of tab labels.
count	Number of tabs.
selected	Index of the selected tab.
width	Width of the tabs.

Draw the tabs component.

Parameters

text	Array of tab text.
count	Number of tabs.
selected	Index of the selected tab.
width	Width of each tab.

◆ ui_components_tabs_common_draw()

void ui_components_tabs_common_draw ( int selected )

Draw the common part of the tabs component.

Parameters

selected Index of the selected tab.

Draw the common part of the tabs component.

Parameters

selected The index of the currently selected tab.

Data Structures

Macros

Enumerations

Functions

Detailed Description

Data Structure Documentation

◆ component_context_menu_t

◆ component_boxart_t

◆ component_context_menu_t.list

Macro Definition Documentation

◆ COMPONENT_CONTEXT_MENU_LIST_END

Enumeration Type Documentation

◆ file_image_type_t

Function Documentation

◆ ui_components_box_draw()

◆ ui_components_border_draw()

◆ ui_components_layout_draw_tabbed()

◆ ui_components_layout_draw()

◆ ui_components_progressbar_draw()

◆ ui_components_seekbar_draw()

◆ ui_components_loader_draw()

◆ ui_components_scrollbar_draw()

◆ ui_components_list_scrollbar_draw()

◆ ui_components_dialog_draw()

◆ ui_components_messagebox_draw()

◆ ui_components_main_text_draw()

◆ ui_components_actions_bar_text_draw()

◆ ui_components_background_init()

◆ ui_components_background_free()

◆ ui_components_background_replace_image()

◆ ui_components_background_draw()

◆ ui_components_file_list_draw()

◆ ui_components_context_menu_init()

◆ ui_components_context_menu_show()

◆ ui_components_context_menu_process()

◆ ui_components_context_menu_draw()

◆ ui_components_boxart_init()

◆ ui_components_boxart_free()

◆ ui_components_boxart_draw()

◆ ui_components_tabs_draw()

◆ ui_components_tabs_common_draw()