/* 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 <glib.h>
#include <time.h>


/* Functions of this type must translate the list item into two time_t values for the start and end
 * of an event.
 */
typedef void (* LayoutQueryTimeFunc) (GList *event, time_t *start, time_t *end);


/* This is the main layout function for overlapping events.  You pass in a list of (presumably)
 * events and a function that should take a list element and return the start and end times for the
 * event corresponding to that list element.
 *
 * 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.
 *
 * You will get somewhat better-looking results if the list of events is sorted by using the start
 * time as the primary sort key and the end time as the secondary sort key -- so that "longer"
 * events go first in the list.
 */
void layout_events (GList *events, LayoutQueryTimeFunc func, int *num_slots, int **allocations, int **slots);


#endif