/* gui_box.c - GUI container that stack components. */ /* * GRUB -- GRand Unified Bootloader * Copyright (C) 2008,2009 Free Software Foundation, Inc. * * GRUB is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * GRUB is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with GRUB. If not, see . */ #include #include #include #include struct component_node { grub_gui_component_t component; struct component_node *next; struct component_node *prev; }; typedef struct grub_gui_box *grub_gui_box_t; typedef void (*layout_func_t) (grub_gui_box_t self, int modify_layout, int *width, int *height); struct grub_gui_box { struct grub_gui_container_ops *container; grub_gui_container_t parent; grub_video_rect_t bounds; char *id; int preferred_width; int preferred_height; /* Doubly linked list of components with dummy head & tail nodes. */ struct component_node chead; struct component_node ctail; /* The layout function: differs for vertical and horizontal boxes. */ layout_func_t layout_func; }; static void box_destroy (void *vself) { grub_gui_box_t self = vself; struct component_node *cur; struct component_node *next; for (cur = self->chead.next; cur != &self->ctail; cur = next) { /* Copy the 'next' pointer, since we need it for the next iteration, and we're going to free the memory it is stored in. */ next = cur->next; /* Destroy the child component. */ cur->component->ops->destroy (cur->component); /* Free the linked list node. */ grub_free (cur); } grub_free (self); } static const char * box_get_id (void *vself) { grub_gui_box_t self = vself; return self->id; } static int box_is_instance (void *vself __attribute__((unused)), const char *type) { return (grub_strcmp (type, "component") == 0 || grub_strcmp (type, "container") == 0); } static void layout_horizontally (grub_gui_box_t self, int modify_layout, int *width, int *height) { /* Start at the left (chead) and set the x coordinates as we go right. */ /* All components have their width set to the box's width. */ struct component_node *cur; int x = 0; if (height) *height = 0; for (cur = self->chead.next; cur != &self->ctail; cur = cur->next) { grub_gui_component_t c = cur->component; grub_video_rect_t r; c->ops->get_preferred_size (c, &r.width, &r.height); /* Check and possibly update the maximum width, if non-null. */ if (height && r.height > *height) *height = r.height; /* Set the component's bounds, if the flag is set. */ if (modify_layout) { r.x = x; r.y = 0; /* Width comes from the component's preferred size. */ r.height = self->bounds.height; c->ops->set_bounds (c, &r); } x += r.width; } /* Return the sum of the children's preferred widths. */ if (width) *width = x; } static void layout_vertically (grub_gui_box_t self, int modify_layout, int *width, int *height) { /* Start at the top (chead) and set the y coordinates as we go down. */ /* All components have their width set to the vbox's width. */ struct component_node *cur; int y = 0; if (width) *width = 0; for (cur = self->chead.next; cur != &self->ctail; cur = cur->next) { grub_gui_component_t c = cur->component; grub_video_rect_t r; c->ops->get_preferred_size (c, &r.width, &r.height); /* Check and possibly update the maximum width, if non-null. */ if (width && r.width > *width) *width = r.width; /* Set the component's bounds, if the flag is set. */ if (modify_layout) { r.x = 0; r.y = y; r.width = self->bounds.width; /* Height comes from the component's preferred size. */ c->ops->set_bounds (c, &r); } y += r.height; } /* Return the sum of the children's preferred heights. */ if (height) *height = y; } static void box_paint (void *vself, const grub_video_rect_t *region) { grub_gui_box_t self = vself; struct component_node *cur; grub_video_rect_t vpsave; grub_gui_set_viewport (&self->bounds, &vpsave); for (cur = self->chead.next; cur != &self->ctail; cur = cur->next) { grub_gui_component_t comp = cur->component; comp->ops->paint (comp, region); } grub_gui_restore_viewport (&vpsave); } static void box_set_parent (void *vself, grub_gui_container_t parent) { grub_gui_box_t self = vself; self->parent = parent; } static grub_gui_container_t box_get_parent (void *vself) { grub_gui_box_t self = vself; return self->parent; } static void box_set_bounds (void *vself, const grub_video_rect_t *bounds) { grub_gui_box_t self = vself; self->bounds = *bounds; self->layout_func (self, 1, 0, 0); /* Relayout the children. */ } static void box_get_bounds (void *vself, grub_video_rect_t *bounds) { grub_gui_box_t self = vself; *bounds = self->bounds; } /* The box's preferred size is based on the preferred sizes of its children. */ static void box_get_preferred_size (void *vself, int *width, int *height) { grub_gui_box_t self = vself; self->layout_func (self, 0, width, height); /* Just calculate the size. */ /* Allow preferred dimensions to override the computed dimensions. */ if (self->preferred_width >= 0) *width = self->preferred_width; if (self->preferred_height >= 0) *height = self->preferred_height; } static grub_err_t box_set_property (void *vself, const char *name, const char *value) { grub_gui_box_t self = vself; if (grub_strcmp (name, "id") == 0) { grub_free (self->id); if (value) { self->id = grub_strdup (value); if (! self->id) return grub_errno; } else self->id = 0; } else if (grub_strcmp (name, "preferred_size") == 0) { int w; int h; if (grub_gui_parse_2_tuple (value, &w, &h) != GRUB_ERR_NONE) return grub_errno; self->preferred_width = w; self->preferred_height = h; } return grub_errno; } static void box_add (void *vself, grub_gui_component_t comp) { grub_gui_box_t self = vself; struct component_node *node; node = grub_malloc (sizeof (*node)); if (! node) return; /* Note: probably should handle the error. */ node->component = comp; /* Insert the node before the tail. */ node->prev = self->ctail.prev; node->prev->next = node; node->next = &self->ctail; node->next->prev = node; comp->ops->set_parent (comp, (grub_gui_container_t) self); self->layout_func (self, 1, 0, 0); /* Relayout the children. */ } static void box_remove (void *vself, grub_gui_component_t comp) { grub_gui_box_t self = vself; struct component_node *cur; for (cur = self->chead.next; cur != &self->ctail; cur = cur->next) { if (cur->component == comp) { /* Unlink 'cur' from the list. */ cur->prev->next = cur->next; cur->next->prev = cur->prev; /* Free the node's memory (but don't destroy the component). */ grub_free (cur); /* Must not loop again, since 'cur' would be dereferenced! */ return; } } } static void box_iterate_children (void *vself, grub_gui_component_callback cb, void *userdata) { grub_gui_box_t self = vself; struct component_node *cur; for (cur = self->chead.next; cur != &self->ctail; cur = cur->next) cb (cur->component, userdata); } static struct grub_gui_container_ops box_ops = { .component = { .destroy = box_destroy, .get_id = box_get_id, .is_instance = box_is_instance, .paint = box_paint, .set_parent = box_set_parent, .get_parent = box_get_parent, .set_bounds = box_set_bounds, .get_bounds = box_get_bounds, .get_preferred_size = box_get_preferred_size, .set_property = box_set_property }, .add = box_add, .remove = box_remove, .iterate_children = box_iterate_children }; /* Box constructor. Specify the appropriate layout function to create a horizontal or vertical stacking box. */ static grub_gui_box_t box_new (layout_func_t layout_func) { grub_gui_box_t box; box = grub_malloc (sizeof (*box)); if (! box) return 0; box->container = &box_ops; box->parent = 0; box->bounds.x = 0; box->bounds.y = 0; box->bounds.width = 0; box->bounds.height = 0; box->id = 0; box->preferred_width = -1; box->preferred_height = -1; box->chead.component = 0; box->chead.prev = 0; box->chead.next = &box->ctail; box->ctail.component = 0; box->ctail.prev = &box->chead; box->ctail.next = 0; box->layout_func = layout_func; return box; } /* Create a new container that stacks its child components horizontally, from left to right. Each child get a width corresponding to its preferred width. The height of each child is set the maximum of the preferred heights of all children. */ grub_gui_container_t grub_gui_hbox_new (void) { return (grub_gui_container_t) box_new (layout_horizontally); } /* Create a new container that stacks its child components verticallyj, from top to bottom. Each child get a height corresponding to its preferred height. The width of each child is set the maximum of the preferred widths of all children. */ grub_gui_container_t grub_gui_vbox_new (void) { return (grub_gui_container_t) box_new (layout_vertically); }