gtk2/gtk/gtkcellareabox.c

/* gtkcellareabox.c
 *
 * Copyright (C) 2010 Openismus GmbH
 *
 * Authors:
 *      Tristan Van Berkom <tristanvb@openismus.com>
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library 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
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */

#include "config.h"
#include "gtkintl.h"
#include "gtkorientable.h"
#include "gtkcelllayout.h"
#include "gtkcellareabox.h"
#include "gtkcellareaboxiter.h"
#include "gtkprivate.h"


/* GObjectClass */
static void      gtk_cell_area_box_finalize                       (GObject              *object);
static void      gtk_cell_area_box_dispose                        (GObject              *object);
static void      gtk_cell_area_box_set_property                   (GObject              *object,
								   guint                 prop_id,
								   const GValue         *value,
								   GParamSpec           *pspec);
static void      gtk_cell_area_box_get_property                   (GObject              *object,
								   guint                 prop_id,
								   GValue               *value,
								   GParamSpec           *pspec);

/* GtkCellAreaClass */
static void      gtk_cell_area_box_add                            (GtkCellArea          *area,
								   GtkCellRenderer      *renderer);
static void      gtk_cell_area_box_remove                         (GtkCellArea          *area,
								   GtkCellRenderer      *renderer);
static void      gtk_cell_area_box_forall                         (GtkCellArea          *area,
								   GtkCellCallback       callback,
								   gpointer              callback_data);
static gint      gtk_cell_area_box_event                          (GtkCellArea          *area,
								   GtkCellAreaIter      *iter,
								   GtkWidget            *widget,
								   GdkEvent             *event,
								   const GdkRectangle   *cell_area,
								   GtkCellRendererState  flags);
static void      gtk_cell_area_box_render                         (GtkCellArea          *area,
								   GtkCellAreaIter      *iter,
								   GtkWidget            *widget,
								   cairo_t              *cr,
								   const GdkRectangle   *cell_area,
								   GtkCellRendererState  flags);
static void      gtk_cell_area_box_set_cell_property              (GtkCellArea          *area,
								   GtkCellRenderer      *renderer,
								   guint                 prop_id,
								   const GValue         *value,
								   GParamSpec           *pspec);
static void      gtk_cell_area_box_get_cell_property              (GtkCellArea          *area,
								   GtkCellRenderer      *renderer,
								   guint                 prop_id,
								   GValue               *value,
								   GParamSpec           *pspec);
static GtkCellAreaIter    *gtk_cell_area_box_create_iter          (GtkCellArea          *area);
static GtkSizeRequestMode  gtk_cell_area_box_get_request_mode     (GtkCellArea          *area);
static void      gtk_cell_area_box_get_preferred_width            (GtkCellArea          *area,
								   GtkCellAreaIter      *iter,
								   GtkWidget            *widget,
								   gint                 *minimum_width,
								   gint                 *natural_width);
static void      gtk_cell_area_box_get_preferred_height           (GtkCellArea          *area,
								   GtkCellAreaIter      *iter,
								   GtkWidget            *widget,
								   gint                 *minimum_height,
								   gint                 *natural_height);
static void      gtk_cell_area_box_get_preferred_height_for_width (GtkCellArea          *area,
								   GtkCellAreaIter      *iter,
								   GtkWidget            *widget,
								   gint                  width,
								   gint                 *minimum_height,
								   gint                 *natural_height);
static void      gtk_cell_area_box_get_preferred_width_for_height (GtkCellArea          *area,
								   GtkCellAreaIter      *iter,
								   GtkWidget            *widget,
								   gint                  height,
								   gint                 *minimum_width,
								   gint                 *natural_width);
static void      gtk_cell_area_box_grab_focus                     (GtkCellArea          *area,
								   GtkDirectionType      direction);

/* GtkCellLayoutIface */
static void      gtk_cell_area_box_cell_layout_init               (GtkCellLayoutIface *iface);
static void      gtk_cell_area_box_layout_pack_start              (GtkCellLayout      *cell_layout,
								   GtkCellRenderer    *renderer,
								   gboolean            expand);
static void      gtk_cell_area_box_layout_pack_end                (GtkCellLayout      *cell_layout,
								   GtkCellRenderer    *renderer,
								   gboolean            expand);
static void      gtk_cell_area_box_layout_reorder                 (GtkCellLayout      *cell_layout,
								   GtkCellRenderer    *renderer,
								   gint                position);


/* CellInfo/CellGroup metadata handling and convenience functions */
typedef struct {
  GtkCellRenderer *renderer;

  guint            expand : 1; /* Whether the cell expands */
  guint            pack   : 1; /* Whether the cell is packed from the start or end */
  guint            align  : 1; /* Whether to align this cell's position with adjacent rows */
} CellInfo;

typedef struct {
  GList *cells;

  guint  id           : 8;
  guint  n_cells      : 8;
  guint  expand_cells : 8;
} CellGroup;

typedef struct {
  GtkCellRenderer *renderer;

  gint             position;
  gint             size;
} AllocatedCell;

static CellInfo      *cell_info_new          (GtkCellRenderer    *renderer, 
					      GtkPackType         pack,
					      gboolean            expand,
					      gboolean            align);
static void           cell_info_free         (CellInfo           *info);
static gint           cell_info_find         (CellInfo           *info,
					      GtkCellRenderer    *renderer);
static CellGroup     *cell_group_new         (guint               id);
static void           cell_group_free        (CellGroup          *group);
static AllocatedCell *allocated_cell_new     (GtkCellRenderer    *renderer,
					      gint                position,
					      gint                size);
static void           allocated_cell_free    (AllocatedCell      *cell);
static GList         *list_consecutive_cells (GtkCellAreaBox     *box);
static GList         *construct_cell_groups  (GtkCellAreaBox     *box);
static gint           count_expand_groups    (GtkCellAreaBox     *box);
static void           iter_weak_notify       (GtkCellAreaBox     *box,
					      GtkCellAreaBoxIter *dead_iter);
static void           flush_iters            (GtkCellAreaBox     *box);
static void           init_iter_groups       (GtkCellAreaBox     *box);
static void           init_iter_group        (GtkCellAreaBox     *box,
					      GtkCellAreaBoxIter *iter);
static GSList        *get_allocated_cells    (GtkCellAreaBox     *box,
					      GtkCellAreaBoxIter *iter,
					      GtkWidget          *widget);


struct _GtkCellAreaBoxPrivate
{
  GtkOrientation  orientation;

  GList          *cells;
  GList          *groups;

  GSList         *iters;

  gint            spacing;
};

enum {
  PROP_0,
  PROP_ORIENTATION,
  PROP_SPACING
};

enum {
  CELL_PROP_0,
  CELL_PROP_EXPAND,
  CELL_PROP_ALIGN,
  CELL_PROP_PACK_TYPE
};

G_DEFINE_TYPE_WITH_CODE (GtkCellAreaBox, gtk_cell_area_box, GTK_TYPE_CELL_AREA,
			 G_IMPLEMENT_INTERFACE (GTK_TYPE_CELL_LAYOUT,
						gtk_cell_area_box_cell_layout_init)
			 G_IMPLEMENT_INTERFACE (GTK_TYPE_ORIENTABLE, NULL));

#define OPPOSITE_ORIENTATION(orientation)			\
  ((orientation) == GTK_ORIENTATION_HORIZONTAL ?		\
   GTK_ORIENTATION_VERTICAL : GTK_ORIENTATION_HORIZONTAL)

static void
gtk_cell_area_box_init (GtkCellAreaBox *box)
{
  GtkCellAreaBoxPrivate *priv;

  box->priv = G_TYPE_INSTANCE_GET_PRIVATE (box,
                                           GTK_TYPE_CELL_AREA_BOX,
                                           GtkCellAreaBoxPrivate);
  priv = box->priv;

  priv->orientation = GTK_ORIENTATION_HORIZONTAL;
  priv->cells       = NULL;
  priv->groups      = NULL;
  priv->iters       = NULL;
  priv->spacing     = 0;
}

static void 
gtk_cell_area_box_class_init (GtkCellAreaBoxClass *class)
{
  GObjectClass     *object_class = G_OBJECT_CLASS (class);
  GtkCellAreaClass *area_class   = GTK_CELL_AREA_CLASS (class);

  /* GObjectClass */
  object_class->finalize     = gtk_cell_area_box_finalize;
  object_class->dispose      = gtk_cell_area_box_dispose;
  object_class->set_property = gtk_cell_area_box_set_property;
  object_class->get_property = gtk_cell_area_box_get_property;

  /* GtkCellAreaClass */
  area_class->add               = gtk_cell_area_box_add;
  area_class->remove            = gtk_cell_area_box_remove;
  area_class->forall            = gtk_cell_area_box_forall;
  area_class->event             = gtk_cell_area_box_event;
  area_class->render            = gtk_cell_area_box_render;
  area_class->set_cell_property = gtk_cell_area_box_set_cell_property;
  area_class->get_cell_property = gtk_cell_area_box_get_cell_property;
  
  area_class->create_iter                    = gtk_cell_area_box_create_iter;
  area_class->get_request_mode               = gtk_cell_area_box_get_request_mode;
  area_class->get_preferred_width            = gtk_cell_area_box_get_preferred_width;
  area_class->get_preferred_height           = gtk_cell_area_box_get_preferred_height;
  area_class->get_preferred_height_for_width = gtk_cell_area_box_get_preferred_height_for_width;
  area_class->get_preferred_width_for_height = gtk_cell_area_box_get_preferred_width_for_height;

  area_class->grab_focus = gtk_cell_area_box_grab_focus;

  /* Properties */
  g_object_class_override_property (object_class, PROP_ORIENTATION, "orientation");

  g_object_class_install_property (object_class,
                                   PROP_SPACING,
                                   g_param_spec_int ("spacing",
						     P_("Spacing"),
						     P_("Space which is inserted between cells"),
						     0,
						     G_MAXINT,
						     0,
						     GTK_PARAM_READWRITE));

  /* Cell Properties */
  gtk_cell_area_class_install_cell_property (area_class,
					     CELL_PROP_EXPAND,
					     g_param_spec_boolean 
					     ("expand",
					      P_("Expand"),
					      P_("Whether the cell expands"),
					      FALSE,
					      GTK_PARAM_READWRITE));
  
  gtk_cell_area_class_install_cell_property (area_class,
					     CELL_PROP_ALIGN,
					     g_param_spec_boolean
					     ("align",
					      P_("Align"),
					      P_("Whether cell should align with adjacent rows"),
					      TRUE,
					      GTK_PARAM_READWRITE));

  gtk_cell_area_class_install_cell_property (area_class,
					     CELL_PROP_PACK_TYPE,
					     g_param_spec_enum
					     ("pack-type",
					      P_("Pack Type"),
					      P_("A GtkPackType indicating whether the cell is packed with "
						 "reference to the start or end of the cell area"),
					      GTK_TYPE_PACK_TYPE, GTK_PACK_START,
					      GTK_PARAM_READWRITE));

  g_type_class_add_private (object_class, sizeof (GtkCellAreaBoxPrivate));
}


/*************************************************************
 *    CellInfo/CellGroup basics and convenience functions    *
 *************************************************************/
static CellInfo *
cell_info_new  (GtkCellRenderer *renderer, 
		GtkPackType      pack,
		gboolean         expand,
		gboolean         align)
{
  CellInfo *info = g_slice_new (CellInfo);
  
  info->renderer = g_object_ref_sink (renderer);
  info->pack     = pack;
  info->expand   = expand;
  info->align    = align;

  return info;
}

static void
cell_info_free (CellInfo *info)
{
  g_object_unref (info->renderer);

  g_slice_free (CellInfo, info);
}

static gint
cell_info_find (CellInfo        *info,
		GtkCellRenderer *renderer)
{
  return (info->renderer == renderer) ? 0 : -1;
}

static CellGroup *
cell_group_new (guint id)
{
  CellGroup *group = g_slice_new0 (CellGroup);

  group->id = id;

  return group;
}

static void
cell_group_free (CellGroup *group)
{
  g_list_free (group->cells);
  g_slice_free (CellGroup, group);  
}

static AllocatedCell *
allocated_cell_new (GtkCellRenderer *renderer,
		    gint             position,
		    gint             size)
{
  AllocatedCell *cell = g_slice_new (AllocatedCell);

  cell->renderer = renderer;
  cell->position = position;
  cell->size     = size;

  return cell;
}

static void
allocated_cell_free (AllocatedCell *cell)
{
  g_slice_free (AllocatedCell, cell);
}

static GList *
list_consecutive_cells (GtkCellAreaBox *box)
{
  GtkCellAreaBoxPrivate *priv = box->priv;
  GList                 *l, *consecutive_cells = NULL, *pack_end_cells = NULL;
  CellInfo              *info;

  /* List cells in consecutive order taking their 
   * PACK_START/PACK_END options into account 
   */
  for (l = priv->cells; l; l = l->next)
    {
      info = l->data;
      
      if (info->pack == GTK_PACK_START)
	consecutive_cells = g_list_prepend (consecutive_cells, info);
    }

  for (l = priv->cells; l; l = l->next)
    {
      info = l->data;
      
      if (info->pack == GTK_PACK_END)
	pack_end_cells = g_list_prepend (pack_end_cells, info);
    }

  consecutive_cells = g_list_reverse (consecutive_cells);
  consecutive_cells = g_list_concat (consecutive_cells, pack_end_cells);

  return consecutive_cells;
}

static GList *
construct_cell_groups (GtkCellAreaBox  *box)
{
  GtkCellAreaBoxPrivate *priv = box->priv;
  CellGroup             *group;
  GList                 *cells, *l;
  GList                 *groups = NULL;
  guint                  id = 0;

  if (!priv->cells)
    return NULL;

  cells  = list_consecutive_cells (box);
  group  = cell_group_new (id++);
  groups = g_list_prepend (groups, group);

  for (l = cells; l; l = l->next)
    {
      CellInfo *info = l->data;

      /* A new group starts with any aligned cell, the first group is implied */
      if (info->align && l != cells)
	{
	  group  = cell_group_new (id++);
	  groups = g_list_prepend (groups, group);
	}

      group->cells = g_list_prepend (group->cells, info);
      group->n_cells++;

      /* A group expands if it contains any expand cells */
      if (info->expand)
	group->expand_cells ++;
    }

  g_list_free (cells);

  for (l = cells; l; l = l->next)
    {
      group = l->data;
      group->cells = g_list_reverse (group->cells);
    }

  return g_list_reverse (groups);
}

static gint
count_expand_groups (GtkCellAreaBox  *box)
{
  GtkCellAreaBoxPrivate *priv = box->priv;
  GList                 *l;
  gint                   expand_groups = 0;

  for (l = priv->groups; l; l = l->next)
    {
      CellGroup *group = l->data;

      if (group->expand_cells > 0)
	expand_groups++;
    }

  return expand_groups;
}

static void 
iter_weak_notify (GtkCellAreaBox     *box,
		  GtkCellAreaBoxIter *dead_iter)
{
  GtkCellAreaBoxPrivate *priv = box->priv;

  priv->iters = g_slist_remove (priv->iters, dead_iter);
}

static void
init_iter_group (GtkCellAreaBox     *box,
		 GtkCellAreaBoxIter *iter)
{
  GtkCellAreaBoxPrivate *priv = box->priv;
  gint                   n_groups, *expand_groups, i;
  GList                 *l;

  n_groups      = g_list_length (priv->groups);
  expand_groups = g_new (gboolean, n_groups);

  for (i = 0, l = priv->groups; l; l = l->next, i++)
    {
      CellGroup *group = l->data;

      expand_groups[i] = (group->expand_cells > 0);
    }

  gtk_cell_area_box_init_groups (iter, n_groups, expand_groups);
  g_free (expand_groups);
}

static void
init_iter_groups (GtkCellAreaBox *box)
{
  GtkCellAreaBoxPrivate *priv = box->priv;
  GSList                *l;

  /* When the box's groups are reconstructed, iters need to
   * be reinitialized.
   */
  for (l = priv->iters; l; l = l->next)
    {
      GtkCellAreaBoxIter *iter = l->data;

      init_iter_group (box, iter);
    }
}

static void
flush_iters (GtkCellAreaBox *box)
{
  GtkCellAreaBoxPrivate *priv = box->priv;
  GSList                *l;

  /* When the box layout changes, iters need to
   * be flushed and sizes for the box get requested again
   */
  for (l = priv->iters; l; l = l->next)
    {
      GtkCellAreaIter *iter = l->data;

      gtk_cell_area_iter_flush (iter);
    }
}

/* Returns an allocation for each cell in the orientation of the box,
 * used in ->render()/->event() implementations to get a straight-forward
 * list of allocated cells to operate on.
 */
static GSList *
get_allocated_cells (GtkCellAreaBox     *box,
		     GtkCellAreaBoxIter *iter,
		     GtkWidget          *widget)
{
  const GtkCellAreaBoxAllocation *group_allocs;
  GtkCellArea                    *area = GTK_CELL_AREA (box);
  GtkCellAreaBoxPrivate          *priv = box->priv;
  GList                          *group_list, *cell_list;
  GSList                         *allocated_cells = NULL;
  gint                            i, j, n_allocs;

  group_allocs = gtk_cell_area_box_iter_get_orientation_allocs (iter, &n_allocs);
  if (!group_allocs)
    {
      g_warning ("Trying to operate on an unallocated GtkCellAreaIter, "
		 "GtkCellAreaBox requires that the iter be allocated at least "
		 "in the orientation of the box");
      return NULL;
    }

  for (i = 0, group_list = priv->groups; group_list; i++, group_list = group_list->next)
    {
      CellGroup *group = group_list->data;

      /* Exception for single cell groups */
      if (group->n_cells == 1)
	{
	  CellInfo      *info = group->cells->data;
	  AllocatedCell *cell = 
	    allocated_cell_new (info->renderer, group_allocs[i].position, group_allocs[i].size);

	  allocated_cells = g_slist_prepend (allocated_cells, cell);
	}
      else
	{
	  GtkRequestedSize *sizes      = g_new (GtkRequestedSize, group->n_cells);
	  gint              avail_size = group_allocs[i].size;
	  gint              position   = group_allocs[i].position;
	  gint              extra_size, extra_extra;

	  for (j = 0, cell_list = group->cells; cell_list; j++, cell_list = cell_list->next)
	    {
	      CellInfo *info = cell_list->data;

	      gtk_cell_area_request_renderer (area, info->renderer,
					      priv->orientation,
					      widget, -1,
					      &sizes[j].minimum_size,
					      &sizes[j].natural_size);

	      avail_size -= sizes[j].minimum_size;
	    }

	  /* Distribute cells naturally within the group */
	  avail_size -= (group->n_cells - 1) * priv->spacing;
	  avail_size = gtk_distribute_natural_allocation (avail_size, group->n_cells, sizes);

	  /* Calculate/distribute expand for cells */
	  if (group->expand_cells > 0)
	    {
	      extra_size  = avail_size / group->expand_cells;
	      extra_extra = avail_size % group->expand_cells;
	    }
	  else
	    extra_size = extra_extra = 0;

	  /* Create the allocated cells */
	  for (j = 0, cell_list = group->cells; cell_list; j++, cell_list = cell_list->next)
	    {
	      CellInfo      *info = cell_list->data;
	      AllocatedCell *cell;

	      if (info->expand)
		{
		  sizes[j].minimum_size += extra_size;
		  if (extra_extra)
		    {
		      sizes[j].minimum_size++;
		      extra_extra--;
		    }
		}
	      
	      cell = allocated_cell_new (info->renderer, position, sizes[j].minimum_size);

	      allocated_cells = g_slist_prepend (allocated_cells, cell);
	      
	      position += sizes[j].minimum_size;
	      position += priv->spacing;
	    }

	  g_free (sizes);
	}
    }

  return g_slist_reverse (allocated_cells);
}

/*************************************************************
 *                      GObjectClass                         *
 *************************************************************/
static void
gtk_cell_area_box_finalize (GObject *object)
{
  GtkCellAreaBox        *box = GTK_CELL_AREA_BOX (object);
  GtkCellAreaBoxPrivate *priv = box->priv;
  GSList                *l;

  for (l = priv->iters; l; l = l->next)
    g_object_weak_unref (G_OBJECT (l->data), (GWeakNotify)iter_weak_notify, box);

  g_slist_free (priv->iters);

  G_OBJECT_CLASS (gtk_cell_area_box_parent_class)->finalize (object);
}

static void
gtk_cell_area_box_dispose (GObject *object)
{
  G_OBJECT_CLASS (gtk_cell_area_box_parent_class)->dispose (object);
}

static void
gtk_cell_area_box_set_property (GObject       *object,
				guint          prop_id,
				const GValue  *value,
				GParamSpec    *pspec)
{
  GtkCellAreaBox *box = GTK_CELL_AREA_BOX (object);

  switch (prop_id)
    {
    case PROP_ORIENTATION:
      box->priv->orientation = g_value_get_enum (value);

      /* Notify that size needs to be requested again */
      flush_iters (box);
      break;
    case PROP_SPACING:
      gtk_cell_area_box_set_spacing (box, g_value_get_int (value));
      break;
    default:
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
      break;
    }
}

static void
gtk_cell_area_box_get_property (GObject     *object,
				guint        prop_id,
				GValue      *value,
				GParamSpec  *pspec)
{
  GtkCellAreaBox *box = GTK_CELL_AREA_BOX (object);

  switch (prop_id)
    {
    case PROP_ORIENTATION:
      g_value_set_enum (value, box->priv->orientation);
      break;
    case PROP_SPACING:
      g_value_set_int (value, gtk_cell_area_box_get_spacing (box));
      break;
    default:
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
      break;
    }
}

/*************************************************************
 *                    GtkCellAreaClass                       *
 *************************************************************/
static void      
gtk_cell_area_box_add (GtkCellArea        *area,
		       GtkCellRenderer    *renderer)
{
  gtk_cell_area_box_pack_start (GTK_CELL_AREA_BOX (area),
				renderer, FALSE, TRUE);
}

static void
gtk_cell_area_box_remove (GtkCellArea        *area,
			  GtkCellRenderer    *renderer)
{
  GtkCellAreaBox        *box  = GTK_CELL_AREA_BOX (area);
  GtkCellAreaBoxPrivate *priv = box->priv;
  GList                 *node;

  node = g_list_find_custom (priv->cells, renderer, 
			     (GCompareFunc)cell_info_find);

  if (node)
    {
      CellInfo *info = node->data;

      cell_info_free (info);

      priv->cells = g_list_delete_link (priv->cells, node);

      /* Reconstruct cell groups */
      g_list_foreach (priv->groups, (GFunc)cell_group_free, NULL);
      g_list_free (priv->groups);
      priv->groups = construct_cell_groups (box);

      /* Reinitialize groups on iters */
      init_iter_groups (box);
    }
  else
    g_warning ("Trying to remove a cell renderer that is not present GtkCellAreaBox");
}

static void
gtk_cell_area_box_forall (GtkCellArea        *area,
			  GtkCellCallback     callback,
			  gpointer            callback_data)
{
  GtkCellAreaBox        *box  = GTK_CELL_AREA_BOX (area);
  GtkCellAreaBoxPrivate *priv = box->priv;
  GList                 *list;

  for (list = priv->cells; list; list = list->next)
    {
      CellInfo *info = list->data;

      callback (info->renderer, callback_data);
    }
}

static gint
gtk_cell_area_box_event (GtkCellArea          *area,
			 GtkCellAreaIter      *iter,
			 GtkWidget            *widget,
			 GdkEvent             *event,
			 const GdkRectangle   *cell_area,
			 GtkCellRendererState  flags)
{


  return 0;
}

static void
gtk_cell_area_box_render (GtkCellArea          *area,
			  GtkCellAreaIter      *iter,
			  GtkWidget            *widget,
			  cairo_t              *cr,
			  const GdkRectangle   *cell_area,
			  GtkCellRendererState  flags)
{
  GtkCellAreaBox        *box      = GTK_CELL_AREA_BOX (area);
  GtkCellAreaBoxPrivate *priv     = box->priv;
  GtkCellAreaBoxIter    *box_iter = GTK_CELL_AREA_BOX_ITER (iter);
  GSList                *allocated_cells, *l;
  GdkRectangle           background_area, inner_area;

  background_area = *cell_area;

  /* Get a list of cells with allocation sizes decided regardless
   * of alignments and pack order etc. */
  allocated_cells = get_allocated_cells (box, box_iter, widget);

  for (l = allocated_cells; l; l = l->next)
    {
      AllocatedCell *cell = l->data;

      if (priv->orientation == GTK_ORIENTATION_HORIZONTAL)
	{
	  background_area.x     = cell_area->x + cell->position;
	  background_area.width = cell->size;
	}
      else
	{
	  background_area.y      = cell_area->y + cell->position;
	  background_area.height = cell->size;
	}

      /* Remove margins from the background area to produce the cell area
       */
      gtk_cell_area_inner_cell_area (area, &background_area, &inner_area);

      /* XXX We have to do some per-cell considerations for the 'flags'
       * for focus handling */
      gtk_cell_renderer_render (cell->renderer, cr, widget,
				&background_area, &inner_area,
				flags);

    }

  g_slist_foreach (allocated_cells, (GFunc)allocated_cell_free, NULL);
  g_slist_free (allocated_cells);
}

static void
gtk_cell_area_box_set_cell_property (GtkCellArea        *area,
				     GtkCellRenderer    *renderer,
				     guint               prop_id,
				     const GValue       *value,
				     GParamSpec         *pspec)
{
  GtkCellAreaBox        *box  = GTK_CELL_AREA_BOX (area); 
  GtkCellAreaBoxPrivate *priv = box->priv;
  GList                 *node;
  CellInfo              *info;
  gboolean               rebuild = FALSE;
  gboolean               flush = FALSE;
  gboolean               val;
  GtkPackType            pack_type;

  node = g_list_find_custom (priv->cells, renderer, 
			     (GCompareFunc)cell_info_find);
  if (!node)
    return;

  info = node->data;

  switch (prop_id)
    {
    case CELL_PROP_EXPAND:
      val = g_value_get_boolean (value);

      if (info->expand != val)
	{
	  info->expand = val;
	  flush        = TRUE;
	}
      break;

    case CELL_PROP_ALIGN:
      val = g_value_get_boolean (value);

      if (info->align != val)
	{
	  info->align = val;
	  flush       = TRUE;
	}
      break;

    case CELL_PROP_PACK_TYPE:
      pack_type = g_value_get_enum (value);

      if (info->pack != pack_type)
	{
	  info->pack = pack_type;
	  rebuild    = TRUE;
	}
      break;
    default:
      GTK_CELL_AREA_WARN_INVALID_CHILD_PROPERTY_ID (area, prop_id, pspec);
      break;
    }

  /* Groups need to be rebuilt */
  if (rebuild)
    {
      /* Reconstruct cell groups */
      g_list_foreach (priv->groups, (GFunc)cell_group_free, NULL);
      g_list_free (priv->groups);
      priv->groups = construct_cell_groups (box);
      
      /* Reinitialize groups on iters */
      init_iter_groups (box);
    }
  else if (flush)
    {
      flush_iters (box);
    }
}

static void
gtk_cell_area_box_get_cell_property (GtkCellArea        *area,
				     GtkCellRenderer    *renderer,
				     guint               prop_id,
				     GValue             *value,
				     GParamSpec         *pspec)
{
  GtkCellAreaBox        *box  = GTK_CELL_AREA_BOX (area); 
  GtkCellAreaBoxPrivate *priv = box->priv;
  GList                 *node;
  CellInfo              *info;

  node = g_list_find_custom (priv->cells, renderer, 
			     (GCompareFunc)cell_info_find);
  if (!node)
    return;

  info = node->data;

  switch (prop_id)
    {
    case CELL_PROP_EXPAND:
      g_value_set_boolean (value, info->expand);
      break;

    case CELL_PROP_ALIGN:
      g_value_set_boolean (value, info->align);
      break;

    case CELL_PROP_PACK_TYPE:
      g_value_set_enum (value, info->pack);
      break;
    default:
      GTK_CELL_AREA_WARN_INVALID_CHILD_PROPERTY_ID (area, prop_id, pspec);
      break;
    }
}


static GtkCellAreaIter *
gtk_cell_area_box_create_iter (GtkCellArea *area)
{
  GtkCellAreaBox        *box  = GTK_CELL_AREA_BOX (area);
  GtkCellAreaBoxPrivate *priv = box->priv;
  GtkCellAreaIter       *iter =
    (GtkCellAreaIter *)g_object_new (GTK_TYPE_CELL_AREA_BOX_ITER, NULL);

  priv->iters = g_slist_prepend (priv->iters, iter);

  g_object_weak_ref (G_OBJECT (iter), (GWeakNotify)iter_weak_notify, box);

  /* Tell the new group about our cell layout */
  init_iter_group (box, GTK_CELL_AREA_BOX_ITER (iter));

  return iter;
}

static GtkSizeRequestMode 
gtk_cell_area_box_get_request_mode (GtkCellArea *area)
{
  GtkCellAreaBox        *box  = GTK_CELL_AREA_BOX (area);
  GtkCellAreaBoxPrivate *priv = box->priv;

  return (priv->orientation) == GTK_ORIENTATION_HORIZONTAL ?
    GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH :
    GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT;
}

static void
compute_size (GtkCellAreaBox     *box,
	      GtkOrientation      orientation,
	      GtkCellAreaBoxIter *iter,
	      GtkWidget          *widget,
	      gint                for_size,
	      gint               *minimum_size,
	      gint               *natural_size)
{
  GtkCellAreaBoxPrivate *priv = box->priv;
  GtkCellArea           *area = GTK_CELL_AREA (box);
  CellGroup             *group;
  CellInfo              *info;
  GList                 *cell_list, *group_list;
  gint                   min_size = 0;
  gint                   nat_size = 0;
  
  for (group_list = priv->groups; group_list; group_list = group_list->next)
    {
      gint group_min_size = 0;
      gint group_nat_size = 0;

      group = group_list->data;

      for (cell_list = group->cells; cell_list; cell_list = cell_list->next)
	{
	  gint renderer_min_size, renderer_nat_size;
	  
	  info = cell_list->data;
	  
	  gtk_cell_area_request_renderer (area, info->renderer, orientation, widget, for_size, 
					  &renderer_min_size, &renderer_nat_size);

	  if (orientation == priv->orientation)
	    {
	      if (min_size > 0)
		{
		  min_size += priv->spacing;
		  nat_size += priv->spacing;
		}
	      
	      if (group_min_size > 0)
		{
		  group_min_size += priv->spacing;
		  group_nat_size += priv->spacing;
		}
	      
	      min_size       += renderer_min_size;
	      nat_size       += renderer_nat_size;
	      group_min_size += renderer_min_size;
	      group_nat_size += renderer_nat_size;
	    }
	  else
	    {
	      min_size       = MAX (min_size, renderer_min_size);
	      nat_size       = MAX (nat_size, renderer_nat_size);
	      group_min_size = MAX (group_min_size, renderer_min_size);
	      group_nat_size = MAX (group_nat_size, renderer_nat_size);
	    }
	}

      if (orientation == GTK_ORIENTATION_HORIZONTAL)
	{
	  if (for_size < 0)
	    gtk_cell_area_box_iter_push_group_width (iter, group->id, group_min_size, group_nat_size);
	  else
	    gtk_cell_area_box_iter_push_group_width_for_height (iter, group->id, for_size,
								group_min_size, group_nat_size);
	}
      else
	{
	  if (for_size < 0)
	    gtk_cell_area_box_iter_push_group_height (iter, group->id, group_min_size, group_nat_size);
	  else
	    gtk_cell_area_box_iter_push_group_height_for_width (iter, group->id, for_size,
								group_min_size, group_nat_size);
	}
    }

  *minimum_size = min_size;
  *natural_size = nat_size;
}

GtkRequestedSize *
get_group_sizes (GtkCellArea    *area,
		 CellGroup      *group,
		 GtkOrientation  orientation,
		 GtkWidget      *widget,
		 gint           *n_sizes)
{
  GtkRequestedSize *sizes;
  GList            *l;
  gint              i;

  *n_sizes = g_list_length (group->cells);
  sizes    = g_new (GtkRequestedSize, *n_sizes);

  for (l = group->cells, i = 0; l; l = l->next, i++)
    {
      CellInfo *info = l->data;

      sizes[i].data = info;
      
      gtk_cell_area_request_renderer (area, info->renderer,
				      orientation, widget, -1,
				      &sizes[i].minimum_size,
				      &sizes[i].natural_size);
    }

  return sizes;
}

static void
compute_group_size_for_opposing_orientation (GtkCellAreaBox     *box,
					     CellGroup          *group,
					     GtkWidget          *widget, 
					     gint                for_size,
					     gint               *minimum_size, 
					     gint               *natural_size)
{
  GtkCellAreaBoxPrivate *priv = box->priv;
  GtkCellArea           *area = GTK_CELL_AREA (box);

  /* Exception for single cell groups */
  if (group->n_cells == 1)
    {
      CellInfo *info = group->cells->data;

      gtk_cell_area_request_renderer (area, info->renderer,
				      OPPOSITE_ORIENTATION (priv->orientation),
				      widget, for_size, minimum_size, natural_size);
    }
  else
    {
      GtkRequestedSize *orientation_sizes;
      CellInfo         *info;
      gint              n_sizes, i;
      gint              avail_size     = for_size;
      gint              extra_size, extra_extra;
      gint              min_size = 0, nat_size = 0;

      orientation_sizes = get_group_sizes (area, group, priv->orientation, widget, &n_sizes);

      /* First naturally allocate the cells in the group into the for_size */
      avail_size -= (n_sizes - 1) * priv->spacing;
      for (i = 0; i < n_sizes; i++)
	avail_size -= orientation_sizes[i].minimum_size;

      avail_size = gtk_distribute_natural_allocation (avail_size, n_sizes, orientation_sizes);

      /* Calculate/distribute expand for cells */
      if (group->expand_cells > 0)
	{
	  extra_size  = avail_size / group->expand_cells;
	  extra_extra = avail_size % group->expand_cells;
	}
      else
	extra_size = extra_extra = 0;

      for (i = 0; i < n_sizes; i++)
	{
	  gint cell_min, cell_nat;

	  info = orientation_sizes[i].data;

	  if (info->expand)
	    {
	      orientation_sizes[i].minimum_size += extra_size;
	      if (extra_extra)
		{
		  orientation_sizes[i].minimum_size++;
		  extra_extra--;
		}
	    }

	  gtk_cell_area_request_renderer (area, info->renderer,
					  OPPOSITE_ORIENTATION (priv->orientation),
					  widget, 
					  orientation_sizes[i].minimum_size,
					  &cell_min, &cell_nat);

	  min_size = MAX (min_size, cell_min);
	  nat_size = MAX (nat_size, cell_nat);
	}

      *minimum_size = min_size;
      *natural_size = nat_size;

      g_free (orientation_sizes);
    }
}

static void
compute_size_for_opposing_orientation (GtkCellAreaBox     *box, 
				       GtkCellAreaBoxIter *iter, 
				       GtkWidget          *widget, 
				       gint                for_size,
				       gint               *minimum_size, 
				       gint               *natural_size)
{
  GtkCellAreaBoxPrivate *priv = box->priv;
  CellGroup             *group;
  GList                 *group_list;
  GtkRequestedSize      *orientation_sizes;
  gint                   n_groups, n_expand_groups, i;
  gint                   avail_size = for_size;
  gint                   extra_size, extra_extra;
  gint                   min_size = 0, nat_size = 0;

  n_expand_groups = count_expand_groups (box);

  if (priv->orientation == GTK_ORIENTATION_HORIZONTAL)
    orientation_sizes = gtk_cell_area_box_iter_get_widths (iter, &n_groups);
  else
    orientation_sizes = gtk_cell_area_box_iter_get_heights (iter, &n_groups);

  /* First start by naturally allocating space among groups of cells */
  avail_size -= (n_groups - 1) * priv->spacing;
  for (i = 0; i < n_groups; i++)
    avail_size -= orientation_sizes[i].minimum_size;

  avail_size = gtk_distribute_natural_allocation (avail_size, n_groups, orientation_sizes);

  /* Calculate/distribute expand for groups */
  if (n_expand_groups > 0)
    {
      extra_size  = avail_size / n_expand_groups;
      extra_extra = avail_size % n_expand_groups;
    }
  else
    extra_size = extra_extra = 0;

  /* Now we need to naturally allocate sizes for cells in each group
   * and push the height-for-width for each group accordingly while accumulating
   * the overall height-for-width for this row.
   */
  for (group_list = priv->groups; group_list; group_list = group_list->next)
    {
      gint group_min, group_nat;

      group = group_list->data;

      if (group->expand_cells > 0)
	{
	  orientation_sizes[group->id].minimum_size += extra_size;
	  if (extra_extra)
	    {
	      orientation_sizes[group->id].minimum_size++;
	      extra_extra--;
	    }
	}

      /* Now we have the allocation for the group, request it's height-for-width */
      compute_group_size_for_opposing_orientation (box, group, widget,
						   orientation_sizes[group->id].minimum_size,
						   &group_min, &group_nat);

      min_size = MAX (min_size, group_min);
      nat_size = MAX (nat_size, group_nat);

      if (priv->orientation == GTK_ORIENTATION_HORIZONTAL)
	{
	  gtk_cell_area_box_iter_push_group_height_for_width (iter, group->id, for_size,
							      group_min, group_nat);
	}
      else
	{
	  gtk_cell_area_box_iter_push_group_width_for_height (iter, group->id, for_size,
							      group_min, group_nat);
	}
    }

  *minimum_size = min_size;
  *natural_size = nat_size;

  g_free (orientation_sizes);
}



static void
gtk_cell_area_box_get_preferred_width (GtkCellArea        *area,
				       GtkCellAreaIter    *iter,
				       GtkWidget          *widget,
				       gint               *minimum_width,
				       gint               *natural_width)
{
  GtkCellAreaBox        *box = GTK_CELL_AREA_BOX (area);
  GtkCellAreaBoxIter    *box_iter;
  gint                   min_width, nat_width;

  g_return_if_fail (GTK_IS_CELL_AREA_BOX_ITER (iter));

  box_iter = GTK_CELL_AREA_BOX_ITER (iter);

  /* Compute the size of all renderers for current row data, 
   * bumping cell alignments in the iter along the way */
  compute_size (box, GTK_ORIENTATION_HORIZONTAL,
		box_iter, widget, -1, &min_width, &nat_width);

  if (minimum_width)
    *minimum_width = min_width;

  if (natural_width)
    *natural_width = nat_width;
}

static void
gtk_cell_area_box_get_preferred_height (GtkCellArea        *area,
					GtkCellAreaIter    *iter,
					GtkWidget          *widget,
					gint               *minimum_height,
					gint               *natural_height)
{
  GtkCellAreaBox        *box = GTK_CELL_AREA_BOX (area);
  GtkCellAreaBoxIter    *box_iter;
  gint                   min_height, nat_height;

  g_return_if_fail (GTK_IS_CELL_AREA_BOX_ITER (iter));

  box_iter = GTK_CELL_AREA_BOX_ITER (iter);

  /* Compute the size of all renderers for current row data, 
   * bumping cell alignments in the iter along the way */
  compute_size (box, GTK_ORIENTATION_VERTICAL,
		box_iter, widget, -1, &min_height, &nat_height);

  if (minimum_height)
    *minimum_height = min_height;

  if (natural_height)
    *natural_height = nat_height;
}

static void
gtk_cell_area_box_get_preferred_height_for_width (GtkCellArea        *area,
						  GtkCellAreaIter    *iter,
						  GtkWidget          *widget,
						  gint                width,
						  gint               *minimum_height,
						  gint               *natural_height)
{
  GtkCellAreaBox        *box = GTK_CELL_AREA_BOX (area);
  GtkCellAreaBoxIter    *box_iter;
  GtkCellAreaBoxPrivate *priv;
  gint                   min_height, nat_height;

  g_return_if_fail (GTK_IS_CELL_AREA_BOX_ITER (iter));

  box_iter = GTK_CELL_AREA_BOX_ITER (iter);
  priv     = box->priv;

  if (priv->orientation == GTK_ORIENTATION_VERTICAL)
    {
      /* Add up vertical requests of height for width and push the overall 
       * cached sizes for alignments */
      compute_size (box, priv->orientation, box_iter, widget, width, &min_height, &nat_height);
    }
  else
    {
      /* Juice: virtually allocate cells into the for_width using the 
       * alignments and then return the overall height for that width, and cache it */
      compute_size_for_opposing_orientation (box, box_iter, widget, width, &min_height, &nat_height);
    }

  if (minimum_height)
    *minimum_height = min_height;

  if (natural_height)
    *natural_height = nat_height;
}

static void
gtk_cell_area_box_get_preferred_width_for_height (GtkCellArea        *area,
						  GtkCellAreaIter    *iter,
						  GtkWidget          *widget,
						  gint                height,
						  gint               *minimum_width,
						  gint               *natural_width)
{
  GtkCellAreaBox        *box = GTK_CELL_AREA_BOX (area);
  GtkCellAreaBoxIter    *box_iter;
  GtkCellAreaBoxPrivate *priv;
  gint                   min_width, nat_width;

  g_return_if_fail (GTK_IS_CELL_AREA_BOX_ITER (iter));

  box_iter = GTK_CELL_AREA_BOX_ITER (iter);
  priv     = box->priv;

  if (priv->orientation == GTK_ORIENTATION_HORIZONTAL)
    {
      /* Add up horizontal requests of width for height and push the overall 
       * cached sizes for alignments */
      compute_size (box, priv->orientation, box_iter, widget, height, &min_width, &nat_width);
    }
  else
    {
      /* Juice: horizontally allocate cells into the for_height using the 
       * alignments and then return the overall width for that height, and cache it */
      compute_size_for_opposing_orientation (box, box_iter, widget, height, &min_width, &nat_width);
    }

  if (minimum_width)
    *minimum_width = min_width;

  if (natural_width)
    *natural_width = nat_width;
}

static void
gtk_cell_area_box_grab_focus (GtkCellArea      *area,
			      GtkDirectionType  direction)
{
  GtkCellAreaBox        *box = GTK_CELL_AREA_BOX (area);
  GtkCellAreaBoxPrivate *priv;
  gboolean               first_cell = FALSE;
  GList                 *group_list, *cell_list;

  priv = box->priv;

  switch (direction)
    {
    case GTK_DIR_TAB_FORWARD:
    case GTK_DIR_DOWN:
    case GTK_DIR_RIGHT:
      first_cell = TRUE;
      break;

    case GTK_DIR_TAB_BACKWARD:
    case GTK_DIR_UP:
    case GTK_DIR_LEFT:
    default:
      first_cell = FALSE;
      break;
    }

  if (first_cell)
    group_list = g_list_first (priv->groups);
  else 
    group_list = g_list_last (priv->groups);

  for ( ; group_list; 
	first_cell ? group_list = group_list->next :
	  group_list = group_list->prev)
    {
      CellGroup *group = group_list->data;

      if (first_cell)
	cell_list = g_list_first (group->cells);
      else 
	cell_list = g_list_last (group->cells);

      for ( ; cell_list; 
	    first_cell ? cell_list = cell_list->next :
	      cell_list = cell_list->prev)
	{
	  GtkCellRendererMode  mode;
	  CellInfo            *info = cell_list->data;

	  /* XXX This does not handle cases where the cell
	   * is not visible as it is not row specific, 
	   * that's a problem.
	   */
	  g_object_get (info->renderer, "mode", &mode, NULL);
	  if (mode == GTK_CELL_RENDERER_MODE_EDITABLE ||
	      mode == GTK_CELL_RENDERER_MODE_ACTIVATABLE)
	    {
	      gtk_cell_area_set_focus_cell (area, info->renderer);
	      break;
	    }
	}
    }
}


/*************************************************************
 *                    GtkCellLayoutIface                     *
 *************************************************************/
static void
gtk_cell_area_box_cell_layout_init (GtkCellLayoutIface *iface)
{
  iface->pack_start = gtk_cell_area_box_layout_pack_start;
  iface->pack_end   = gtk_cell_area_box_layout_pack_end;
  iface->reorder    = gtk_cell_area_box_layout_reorder;
}

static void
gtk_cell_area_box_layout_pack_start (GtkCellLayout      *cell_layout,
				     GtkCellRenderer    *renderer,
				     gboolean            expand)
{
  gtk_cell_area_box_pack_start (GTK_CELL_AREA_BOX (cell_layout), renderer, expand, TRUE);
}

static void
gtk_cell_area_box_layout_pack_end (GtkCellLayout      *cell_layout,
				   GtkCellRenderer    *renderer,
				   gboolean            expand)
{
  gtk_cell_area_box_pack_end (GTK_CELL_AREA_BOX (cell_layout), renderer, expand, TRUE);
}

static void
gtk_cell_area_box_layout_reorder (GtkCellLayout      *cell_layout,
				  GtkCellRenderer    *renderer,
				  gint                position)
{
  GtkCellAreaBox        *box  = GTK_CELL_AREA_BOX (cell_layout);
  GtkCellAreaBoxPrivate *priv = box->priv;
  GList                 *node;
  CellInfo              *info;
  
  node = g_list_find_custom (priv->cells, renderer, 
			     (GCompareFunc)cell_info_find);

  if (node)
    {
      info = node->data;

      priv->cells = g_list_delete_link (priv->cells, node);
      priv->cells = g_list_insert (priv->cells, info, position);

      /* Reconstruct cell groups */
      g_list_foreach (priv->groups, (GFunc)cell_group_free, NULL);
      g_list_free (priv->groups);
      priv->groups = construct_cell_groups (box);
      
      /* Reinitialize groups on iters */
      init_iter_groups (box);
    }
}

/*************************************************************
 *                            API                            *
 *************************************************************/
GtkCellArea *
gtk_cell_area_box_new (void)
{
  return (GtkCellArea *)g_object_new (GTK_TYPE_CELL_AREA_BOX, NULL);
}

void
gtk_cell_area_box_pack_start  (GtkCellAreaBox  *box,
			       GtkCellRenderer *renderer,
			       gboolean         expand,
			       gboolean         align)
{
  GtkCellAreaBoxPrivate *priv;
  CellInfo              *info;

  g_return_if_fail (GTK_IS_CELL_AREA_BOX (box));
  g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));

  priv = box->priv;

  if (g_list_find_custom (priv->cells, renderer, 
			  (GCompareFunc)cell_info_find))
    {
      g_warning ("Refusing to add the same cell renderer to a GtkCellAreaBox twice");
      return;
    }

  info = cell_info_new (renderer, GTK_PACK_START, expand, align);

  priv->cells = g_list_append (priv->cells, info);

  /* Reconstruct cell groups */
  g_list_foreach (priv->groups, (GFunc)cell_group_free, NULL);
  g_list_free (priv->groups);
  priv->groups = construct_cell_groups (box);

  /* Reinitialize groups on iters */
  init_iter_groups (box);
}

void
gtk_cell_area_box_pack_end (GtkCellAreaBox  *box,
			    GtkCellRenderer *renderer,
			    gboolean         expand, 
			    gboolean         align)
{
  GtkCellAreaBoxPrivate *priv;
  CellInfo              *info;

  g_return_if_fail (GTK_IS_CELL_AREA_BOX (box));
  g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));

  priv = box->priv;

  if (g_list_find_custom (priv->cells, renderer, 
			  (GCompareFunc)cell_info_find))
    {
      g_warning ("Refusing to add the same cell renderer to a GtkCellArea twice");
      return;
    }

  info = cell_info_new (renderer, GTK_PACK_END, expand, align);

  priv->cells = g_list_append (priv->cells, info);

  /* Reconstruct cell groups */
  g_list_foreach (priv->groups, (GFunc)cell_group_free, NULL);
  g_list_free (priv->groups);
  priv->groups = construct_cell_groups (box);

  /* Reinitialize groups on iters */
  init_iter_groups (box);
}

gint
gtk_cell_area_box_get_spacing (GtkCellAreaBox  *box)
{
  g_return_val_if_fail (GTK_IS_CELL_AREA_BOX (box), 0);

  return box->priv->spacing;
}

void
gtk_cell_area_box_set_spacing (GtkCellAreaBox  *box,
			       gint             spacing)
{
  GtkCellAreaBoxPrivate *priv;

  g_return_if_fail (GTK_IS_CELL_AREA_BOX (box));

  priv = box->priv;

  if (priv->spacing != spacing)
    {
      priv->spacing = spacing;

      g_object_notify (G_OBJECT (box), "spacing");

      /* Notify that size needs to be requested again */
      flush_iters (box);
    }
}