2389bd7bed
1998-10-08 Federico Mena Quintero <federico@nuclecu.unam.mx> * layout.c: Do some cleanup; now we pass a struct with the layout algorithm's state instead of passing a trillion parameters around. * gncal-full-day.c (layout_children): Use the new generic layout engine. (child_compare): Sort keys are start time then end time, not just start time. This produces somewhat nicer results for the layout algorithm. The new layout code uses a partition of the time range occupied by the events, rather than using a fixed time granularity. This is better since the different parts of the program that use the layout module will have different semantics regarding snapping the event bounds to a fixed "time grid". svn path=/trunk/; revision=434
38 lines
1.3 KiB
C
38 lines
1.3 KiB
C
/* 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
|