Doh, add the files - Federico

svn path=/trunk/; revision=433

4 files changed, 586 insertions, 0 deletions

diff --git a/calendar/gui/layout.c b/calendar/gui/layout.c
new file mode 100644
index 0000000000..03fac94cc6
--- /dev/null
+++ b/calendar/gui/layout.c
@@ -0,0 +1,268 @@
+/* Event layout engine for Gnomecal
+ *
+ * Copyright (C) 1998 The Free Software Foundation
+ *
+ * Authors: Miguel de Icaza <miguel@nuclecu.unam.mx>
+ *          Federico Mena <federico@nuclecu.unam.mx>
+ */
+
+#include "layout.h"
+
+
+/* This defines the maximum number of events to overlap per row.  More than that number of events
+ * will not be displayed.  This is not ideal, so sue me.
+ */
+#define MAX_EVENTS_PER_ROW 32
+
+
+/* Compares two time_t values, used for qsort() */
+static int
+compare_time_t (const void *a, const void *b)
+{
+	time_t ta, tb;
+
+	ta = *((time_t *) a);
+	tb = *((time_t *) b);
+
+	if (ta < tb)
+		return -1;
+	else if (ta > tb)
+		return 1;
+	else
+		return 0;
+}
+
+/* Builds a partition of the time range occupied by the events in the list.  It returns an array
+ * with the times that define the partition and the number of items in the partition.
+ */
+static time_t *
+build_partition (GList *events, int num_events, int *num_rows)
+{
+	time_t *rows, *p, *q;
+	GList *list;
+	CalendarObject *co;
+	int i, unique_vals;
+
+	/* This is the maximum number of rows we would need */
+
+	*num_rows = num_events * 2;
+
+	/* Fill the rows with the times */
+
+	rows = g_new (time_t, *num_rows);
+
+	for (list = events, p = rows; list; list = list->next) {
+		co = list->data;
+		*p++ = co->ev_start;
+		*p++ = co->ev_end;
+	}
+
+	/* Do a sort | uniq on the array */
+
+	qsort (rows, *num_rows, sizeof (time_t), compare_time_t);
+
+	p = rows;
+	q = rows + 1;
+	unique_vals = 1;
+
+	for (i = 1; i < *num_rows; i++, q++)
+		if (*q != *p) {
+			unique_vals++;
+			p++;
+			*p = *q;
+		}
+
+	/* Return the number of unique values in the partition and the partition array itself */
+
+	*num_rows = unique_vals;
+	return rows;
+}
+
+/* Returns the index of the element in the partition that corresponds to the specified time */
+int
+find_index (time_t *partition, time_t t)
+{
+	int i;
+
+	for (i = 0; ; i++)
+		if (partition[i] == t)
+			return i;
+}
+
+#define xy(slot_array, x, y) slot_array[(y * MAX_EVENTS_PER_ROW) + (x)]
+
+/* Checks that all the cells in the slot array at the specified slot column are free to use by an
+ * event that has the specified range.
+ */
+static int
+range_is_empty (time_t *partition, int *slot_array, int slot, time_t start, time_t end)
+{
+	int i;
+
+	for (i = find_index (partition, start); partition[i] < end; i++)
+		if (xy (slot_array, slot, i) != -1)
+			return FALSE;
+
+	return TRUE;
+}
+
+/* Allocates a time in the slot array for the specified event's index */
+static void
+range_allocate (time_t *partition, int *slot_array, int slot, time_t start, time_t end, int ev_num)
+{
+	int i;
+
+	for (i = find_index (partition, start); partition[i] < end; i++)
+		xy (slot_array, slot, i) = ev_num;
+}
+
+/* Performs the initial allocation of slots for events.  Each event gets one column; they will be
+ * expanded in a later stage.  Returns the number of columns used.
+ */
+static int
+initial_allocate (GList *events, time_t *partition, int *slot_array, int *allocations, int *columns_used)
+{
+	CalendarObject *co;
+	int i;
+	int slot;
+	int num_slots;
+
+	num_slots = 0;
+
+	for (i = 0; events; events = events->next, i++) {
+		co = events->data;
+
+		/* Start with no allocation, no columns */
+
+		allocations[i] = -1;
+		columns_used[i] = 0;
+
+		/* Find a free column for the event */
+
+		for (slot = 0; slot < MAX_EVENTS_PER_ROW; slot++)
+			if (range_is_empty (partition, slot_array, slot, co->ev_start, co->ev_end)) {
+				range_allocate (partition, slot_array, slot, co->ev_start, co->ev_end, i);
+
+				allocations[i] = slot;
+				columns_used[i] = 1;
+
+				if ((slot + 1) > num_slots)
+					num_slots = slot + 1;
+
+				break;
+			}
+	}
+
+	return num_slots;
+}
+
+/* Returns the maximum number of columns that an event can expanded by in the slot array */
+static int
+columns_to_expand (time_t *partition, int *slot_array, int *allocations, int num_slots, int ev_num,
+		   time_t start, time_t end)
+{
+	int cols;
+	int slot;
+	int i_start;
+	int i;
+
+	cols = 0;
+
+	i_start = find_index (partition, start);
+
+	for (slot = allocations[ev_num] + 1; slot < num_slots; slot++) {
+		for (i = i_start; partition[i] < end; i++)
+			if (xy (slot_array, slot, i) != -1)
+				return cols;
+
+		cols++;
+	}
+
+	return cols;
+}
+
+/* Expands an event to occupy the specified number of columns */
+static void
+do_expansion (time_t *partition, int *slot_array, int *allocations, int ev_num, time_t start, time_t end, int num_cols)
+{
+	int i, j;
+	int slot;
+
+	for (i = find_index (partition, start); partition[i] < end; i++) {
+		slot = allocations[ev_num] + 1;
+
+		for (j = 0; j < num_cols; j++)
+			xy (slot_array, slot + j, i) = ev_num;
+	}
+}
+
+/* Expands the events in the slot array to occupy as many columns as possible.  This is the second
+ * pass of the layout algorithm.
+ */
+static void
+expand_events (GList *events, time_t *partition, int *slot_array, int num_slots, int *allocations, int *columns_used)
+{
+	int i;
+	CalendarObject *co;
+	int cols;
+
+	for (i = 0; events; events = events->next, i++) {
+		co = events->data;
+
+		cols = columns_to_expand (partition, slot_array, allocations, num_slots, i, co->ev_start, co->ev_end);
+
+		if (cols == 0)
+			continue; /* We can't expand this event */
+
+		do_expansion (partition, slot_array, allocations, i, co->ev_start, co->ev_end, cols);
+
+		columns_used[i] += cols;
+	}
+}
+
+void
+layout_events (GList *events, int *num_slots, int **allocations, int **slots)
+{
+	time_t *time_partition;
+	int *slot_array;
+	int num_events;
+	int num_rows;
+	int i;
+
+	g_return_if_fail (num_slots != NULL);
+	g_return_if_fail (allocations != NULL);
+	g_return_if_fail (slots != NULL);
+
+	if (!events) {
+		*num_slots = 0;
+		*allocations = NULL;
+		*slots = NULL;
+
+		return;
+	}
+
+	num_events = g_list_length (events);
+
+	/* Build the partition of the time range, and then build the array of slots */
+
+	time_partition = build_partition (events, num_events, &num_rows);
+
+	slot_array = g_new (int, num_rows * MAX_EVENTS_PER_ROW);
+	for (i = 0; i < (num_rows * MAX_EVENTS_PER_ROW); i++)
+		slot_array[i] = -1; /* This is our 'empty' value */
+
+	/* Build the arrays for allocations and columns used */
+
+	*allocations = g_new (int, num_events);
+	*slots = g_new (int, num_events);
+
+	/* Perform initial allocation -- each event gets one column */
+
+	*num_slots = initial_allocate (events, time_partition, slot_array, *allocations, *slots);
+
+	/* Expand the events to as many columns as possible */
+
+	expand_events (events, time_partition, slot_array, *num_slots, *allocations, *slots);
+
+	g_free (slot_array);
+}
diff --git a/calendar/gui/layout.h b/calendar/gui/layout.h
new file mode 100644
index 0000000000..b87cf7e36b
--- /dev/null
+++ b/calendar/gui/layout.h
@@ -0,0 +1,25 @@
+/* Event layout engine for Gnomecal
+ *
+ * Copyright (C) 1998 The Free Software Foundation
+ *
+ * Authors: Miguel de Icaza <miguel@nuclecu.unam.mx>
+ *          Federico Mena <federico@nuclecu.unam.mx>
+ */
+
+#ifndef LAYOUT_H
+#define LAYOUT_H
+
+#include "calendar.h"
+
+
+/* This is the main layout function for overlapping events.  You pass in a list of CalendarObject
+ * structures and it will calculate a nice non-overlapping layout for them.
+ *
+ * It returns the number of slots ("columns") that you need to take into account when actually
+ * painting the events, the array of the first slot index that each event occupies, and the array of
+ * number of slots that each event occupies.  You have to free both arrays.
+ */
+void layout_events (GList *events, int *num_slots, int **allocations, int **slots);
+
+
+#endif
diff --git a/calendar/layout.c b/calendar/layout.c
new file mode 100644
index 0000000000..03fac94cc6
--- /dev/null
+++ b/calendar/layout.c
@@ -0,0 +1,268 @@
+/* Event layout engine for Gnomecal
+ *
+ * Copyright (C) 1998 The Free Software Foundation
+ *
+ * Authors: Miguel de Icaza <miguel@nuclecu.unam.mx>
+ *          Federico Mena <federico@nuclecu.unam.mx>
+ */
+
+#include "layout.h"
+
+
+/* This defines the maximum number of events to overlap per row.  More than that number of events
+ * will not be displayed.  This is not ideal, so sue me.
+ */
+#define MAX_EVENTS_PER_ROW 32
+
+
+/* Compares two time_t values, used for qsort() */
+static int
+compare_time_t (const void *a, const void *b)
+{
+	time_t ta, tb;
+
+	ta = *((time_t *) a);
+	tb = *((time_t *) b);
+
+	if (ta < tb)
+		return -1;
+	else if (ta > tb)
+		return 1;
+	else
+		return 0;
+}
+
+/* Builds a partition of the time range occupied by the events in the list.  It returns an array
+ * with the times that define the partition and the number of items in the partition.
+ */
+static time_t *
+build_partition (GList *events, int num_events, int *num_rows)
+{
+	time_t *rows, *p, *q;
+	GList *list;
+	CalendarObject *co;
+	int i, unique_vals;
+
+	/* This is the maximum number of rows we would need */
+
+	*num_rows = num_events * 2;
+
+	/* Fill the rows with the times */
+
+	rows = g_new (time_t, *num_rows);
+
+	for (list = events, p = rows; list; list = list->next) {
+		co = list->data;
+		*p++ = co->ev_start;
+		*p++ = co->ev_end;
+	}
+
+	/* Do a sort | uniq on the array */
+
+	qsort (rows, *num_rows, sizeof (time_t), compare_time_t);
+
+	p = rows;
+	q = rows + 1;
+	unique_vals = 1;
+
+	for (i = 1; i < *num_rows; i++, q++)
+		if (*q != *p) {
+			unique_vals++;
+			p++;
+			*p = *q;
+		}
+
+	/* Return the number of unique values in the partition and the partition array itself */
+
+	*num_rows = unique_vals;
+	return rows;
+}
+
+/* Returns the index of the element in the partition that corresponds to the specified time */
+int
+find_index (time_t *partition, time_t t)
+{
+	int i;
+
+	for (i = 0; ; i++)
+		if (partition[i] == t)
+			return i;
+}
+
+#define xy(slot_array, x, y) slot_array[(y * MAX_EVENTS_PER_ROW) + (x)]
+
+/* Checks that all the cells in the slot array at the specified slot column are free to use by an
+ * event that has the specified range.
+ */
+static int
+range_is_empty (time_t *partition, int *slot_array, int slot, time_t start, time_t end)
+{
+	int i;
+
+	for (i = find_index (partition, start); partition[i] < end; i++)
+		if (xy (slot_array, slot, i) != -1)
+			return FALSE;
+
+	return TRUE;
+}
+
+/* Allocates a time in the slot array for the specified event's index */
+static void
+range_allocate (time_t *partition, int *slot_array, int slot, time_t start, time_t end, int ev_num)
+{
+	int i;
+
+	for (i = find_index (partition, start); partition[i] < end; i++)
+		xy (slot_array, slot, i) = ev_num;
+}
+
+/* Performs the initial allocation of slots for events.  Each event gets one column; they will be
+ * expanded in a later stage.  Returns the number of columns used.
+ */
+static int
+initial_allocate (GList *events, time_t *partition, int *slot_array, int *allocations, int *columns_used)
+{
+	CalendarObject *co;
+	int i;
+	int slot;
+	int num_slots;
+
+	num_slots = 0;
+
+	for (i = 0; events; events = events->next, i++) {
+		co = events->data;
+
+		/* Start with no allocation, no columns */
+
+		allocations[i] = -1;
+		columns_used[i] = 0;
+
+		/* Find a free column for the event */
+
+		for (slot = 0; slot < MAX_EVENTS_PER_ROW; slot++)
+			if (range_is_empty (partition, slot_array, slot, co->ev_start, co->ev_end)) {
+				range_allocate (partition, slot_array, slot, co->ev_start, co->ev_end, i);
+
+				allocations[i] = slot;
+				columns_used[i] = 1;
+
+				if ((slot + 1) > num_slots)
+					num_slots = slot + 1;
+
+				break;
+			}
+	}
+
+	return num_slots;
+}
+
+/* Returns the maximum number of columns that an event can expanded by in the slot array */
+static int
+columns_to_expand (time_t *partition, int *slot_array, int *allocations, int num_slots, int ev_num,
+		   time_t start, time_t end)
+{
+	int cols;
+	int slot;
+	int i_start;
+	int i;
+
+	cols = 0;
+
+	i_start = find_index (partition, start);
+
+	for (slot = allocations[ev_num] + 1; slot < num_slots; slot++) {
+		for (i = i_start; partition[i] < end; i++)
+			if (xy (slot_array, slot, i) != -1)
+				return cols;
+
+		cols++;
+	}
+
+	return cols;
+}
+
+/* Expands an event to occupy the specified number of columns */
+static void
+do_expansion (time_t *partition, int *slot_array, int *allocations, int ev_num, time_t start, time_t end, int num_cols)
+{
+	int i, j;
+	int slot;
+
+	for (i = find_index (partition, start); partition[i] < end; i++) {
+		slot = allocations[ev_num] + 1;
+
+		for (j = 0; j < num_cols; j++)
+			xy (slot_array, slot + j, i) = ev_num;
+	}
+}
+
+/* Expands the events in the slot array to occupy as many columns as possible.  This is the second
+ * pass of the layout algorithm.
+ */
+static void
+expand_events (GList *events, time_t *partition, int *slot_array, int num_slots, int *allocations, int *columns_used)
+{
+	int i;
+	CalendarObject *co;
+	int cols;
+
+	for (i = 0; events; events = events->next, i++) {
+		co = events->data;
+
+		cols = columns_to_expand (partition, slot_array, allocations, num_slots, i, co->ev_start, co->ev_end);
+
+		if (cols == 0)
+			continue; /* We can't expand this event */
+
+		do_expansion (partition, slot_array, allocations, i, co->ev_start, co->ev_end, cols);
+
+		columns_used[i] += cols;
+	}
+}
+
+void
+layout_events (GList *events, int *num_slots, int **allocations, int **slots)
+{
+	time_t *time_partition;
+	int *slot_array;
+	int num_events;
+	int num_rows;
+	int i;
+
+	g_return_if_fail (num_slots != NULL);
+	g_return_if_fail (allocations != NULL);
+	g_return_if_fail (slots != NULL);
+
+	if (!events) {
+		*num_slots = 0;
+		*allocations = NULL;
+		*slots = NULL;
+
+		return;
+	}
+
+	num_events = g_list_length (events);
+
+	/* Build the partition of the time range, and then build the array of slots */
+
+	time_partition = build_partition (events, num_events, &num_rows);
+
+	slot_array = g_new (int, num_rows * MAX_EVENTS_PER_ROW);
+	for (i = 0; i < (num_rows * MAX_EVENTS_PER_ROW); i++)
+		slot_array[i] = -1; /* This is our 'empty' value */
+
+	/* Build the arrays for allocations and columns used */
+
+	*allocations = g_new (int, num_events);
+	*slots = g_new (int, num_events);
+
+	/* Perform initial allocation -- each event gets one column */
+
+	*num_slots = initial_allocate (events, time_partition, slot_array, *allocations, *slots);
+
+	/* Expand the events to as many columns as possible */
+
+	expand_events (events, time_partition, slot_array, *num_slots, *allocations, *slots);
+
+	g_free (slot_array);
+}
diff --git a/calendar/layout.h b/calendar/layout.h
new file mode 100644
index 0000000000..b87cf7e36b
--- /dev/null
+++ b/calendar/layout.h
@@ -0,0 +1,25 @@
+/* Event layout engine for Gnomecal
+ *
+ * Copyright (C) 1998 The Free Software Foundation
+ *
+ * Authors: Miguel de Icaza <miguel@nuclecu.unam.mx>
+ *          Federico Mena <federico@nuclecu.unam.mx>
+ */
+
+#ifndef LAYOUT_H
+#define LAYOUT_H
+
+#include "calendar.h"
+
+
+/* This is the main layout function for overlapping events.  You pass in a list of CalendarObject
+ * structures and it will calculate a nice non-overlapping layout for them.
+ *
+ * It returns the number of slots ("columns") that you need to take into account when actually
+ * painting the events, the array of the first slot index that each event occupies, and the array of
+ * number of slots that each event occupies.  You have to free both arrays.
+ */
+void layout_events (GList *events, int *num_slots, int **allocations, int **slots);
+
+
+#endif