Add another dataset style: ACRE_STYLE_BARS

This is a mode to draw a dataset unconditionally as a bar chart,
(unlike BARS_OR_LINE which will use BARS when zoomed in sufficiently
or LINE when zoomed out).

Add a new BARS_OR_LINE style for drawing data sets.

If there is sufficient room, this will draw the dataset as a bar
chart. But if the bars would run into each other, it will draw as a
line chart instead.

Add support for a new TIMELINE style for drawing a data-set.

For the TIMELINE style, each (X,Y) pair represents (start,stop) time
in the X dimension for a timeline bar to be drawn. The recently added
"_named" variant of add_data is also useful for supplying a name to be
drawn on the bar.

With multiple timelines within a chart, each one is positioned at a
different integer position along the Y axis, (and the Y axis range
computation is changed to preserve this).

There's only minimal cleverness to avoid collision of timeline label,
(the vertical position is cycled unconditionally).

More clever approaches would not change the vertical position if there
is no possibility of conflict, and would also reset to the top
position as soon as possible.

Other potential improvements to the TIMELINE style include:

  * Ensuring that a timeline label is visible whenever any portion of
    a timeline bar is visible.

  * Eliminating the rendering of numbers and ticks on the Y axis.

Force an identity matrix when creating a pango layout

I've been seeing strange effects in the font rendering when zooming in
dramatically. Inter-character and inter-word spacing was becoming
radically large or radically close to zero, (with overlapping
characters, etc.).

I assume the problem has something to do with numbers outside the
representable range of Pango's fixed-width implementation, (see "pango
units"). Simply setting an identity matrix before creating the layout
and selecting the font clears up all problems that I have seen so far.

Fix 0.0 value on axis to be 0.0.

I recently saw cases where the %g format was cauing a value that
should be 0.0 on the axis to appear as something insane like 5.58e-17.

If the value is within a thousandth of a sub-step, (a sub-step is the
space between two minor ticks on the axis), of 0.0 then force it to be
truly 0.0.

acre-x: Fix zooming so that zoom-in and zoom-out use the same amounts

The intent was always that one zoom-in followed by one zoom-out, (or
vice versa) would lead to the original zoom level. But the zoom-out
code had some incorrect arithmetic in it such that zooming out was
much faster than zooming in.

acre-x: Don't redraw for unrecognized keypresses.

Until we add double-buffering, any unnecessary redrawing causes
annoying blinking. Eliminating redraws from unknown keypresses fixes
at least some, (but likely not that many).

Add the notion of a style for each data set.

There's no real change here yet, since the only style offered so far
is the default ACRE_STYLE_LINE, (which is the same as how acre has
always drawn things). But things will get more interesting as new
styles are added in the future.

Add new add_data_point_2d_named

Nothing is actually done with the names yet, but this will be useful
when we add new timeline-like rendering modes for data sets.

Add xstrdup

Which is analagous to xmalloc and friends.

Close up some memory leaks.

Thanks to valgrind for catching these, of course.

Initialize colors_size.

Valgrind caught this read of an uninitialized value.

acre-x: Allow Escape key to quit

I kept finding myself having trouble quitting because I was hitting
Escape rather than Q. Make the program conform to my expectations.

Compile with debugging symbols

Because we always want them, of course.

Silence pango warning if X or Y-axis label is unset.

Pango emits an annoying warning if we pass it a NULL string, (though
it seems to do the right thing regardless). Quiet it down by passing
it an empty string instead.

Update .gitignore

To ignore new acre-x binary (and temporary files).

Zoom and pan a bit less with each keypress

This makes it a bit smoother and less jumpy for better control.

Add interactive zooming and panning.

Left and right to pan, plus and minus to zoom, and Home to return to
full data range.

Add a simple X-based demo program

This is the same chart as in acre-test, but in an interactive program
using Xlib and cairo.

So far, the only interactivity is that it redraws the chart to match
any changes to window size.

Drop the "tick avoidance" code.

This didn't always work, (plotted lines could still run into the ticks
after zooming), so it just provided inconsistent padding around the
edges of the chart.

Drop an unused function.

This has been unused for several commits, and has just been annoying
me by triggering a compiler warning.

Use cairo_clip to trim out any out-of-view data

Previously, we were simply not drawing line segments where one
endpoint of the segment was outside the bounds of the chart. This had
the problem of omitting a (potentially large) portion of the line
segment that should be visible.

We get the correct result, and more easily, by simply calling
cairo_clip.

Allow zooming in or out by setting ranges of data to be shown on either axis.

The second axis can also be explicitly set to a desired range, or it
can be allowed to be automatically set to fit the data.

Keep track of data ranges as data is added

This avoids the need to loop over the data to find its range just
before drawing. This is in preparation for code that will allow for a
custom viewing range (such as for zooming) rather than always
displaying all available data.

Add necessary -lm flag to link command

I don't know how this ever worked without this.

Use CIE L*a*b colors instead of HSV

This gives perceptually uniform colors, (rather than totally
different lightness as one gets with HSV---which is based on
RGB primaries).

Thanks to LittleCMS for the colorspace conversion.

Change acre-test to have 3 dataset lines instead of 1.

This allows us to see the results of the new color-selection code.

Select N colors from HSV color space.

This is as opposed to the three hard-coded RGB primaries which
we had before.

Add a simple legend

We're now not missing any features that the original motorsim plot had.

Add some distinguishing colors for the datasets

This is quite cheesy for now. It's just three hard-coded, primary colors.
(Much nicer would be to take N evenly-spaced colors from a percpetually
linear space.) But this gives us parity with the functionality of the
original motorsim plot, so it's enough for getting us closer to being
able to replace that.

Shrink title font size a bit.

When comparing an acre-made plot to a similar motorsim plot,
it became clear that the acre title font was too large, (but
also the original motorsim title font was too small). Attempt
to find a happy medium.

Fix rounding when deciding between major and minor tick

We noticed that some charts were missing a major tick, (like
0, 0.5,  ,1.5, 2.0, 2.5). Fix this.

Adjust axis ranges so data doesn't collide with ticks.

There. I think I'm done making the ticks and frame look nice now.
I'm totally happy with the result.

Use 4 minor divisions instead of 5 for major steps of 1 or 10

Otherwise there's no minor tick at the half-way point and that's
just not nice.

Fix pixel snapping for minor ticks

It's a tiny tweak to the axis-expansion code to get it to think about
minor ticks as well as major ticks.

Add minor ticks

For now, do 5 divisions of each major tick, regardless of whether the
major tick spacing is 1, 2.5, 5, or 10. Also, we don't yet fix the
axes to guarantee integer spacing of the minor ticks.

Remove code duplication for X and Y ticks

I knew this code was repeated, and fortunately it wasn't as hard to
share it as I thought it might be. Adding minor-tick rendering will
be much easier now that this is shared.

Account for space between tick values and frames

With this correctly accounted for the axis labels now have consistent
padding above and below.

Change test data to go all the way to 100

This makes the value 100 appear along the X axis which just looks nicer.

Leave sufficient space for Y-axis value labels

Things look much nicer now that the Y-axis label isn't crashing into
the value labels along the Y axis.

Add function to create a pango layout with a printf-style format string

This eliminates a tiny bit of redundant code now, and then more in
the future.

Add code to cleanup PangoLayout objects when done with them

We're still not even close to being leak free, but this is one
baby step on the way.

Add some value labels next to the ticks.

Not yet accounting for these when doing the chart layout, so
we'll still need to fix that obviously.

Eliminate some code duplication in the tick adjustment phase.

We were repeating calculations for X and Y that can just happen
once in _expand_range_for_width.

Finish adjustment of tick positions for pixel-snapping.

This is the final step of adjusting the axis ranges so that
the ticks aligne nicely with integer pixel boundaries. Notably
we don't round the ticks at all while drawing them---instead
we only adjust the axis ranges so that when we draw the ticks
at their numerical positions they will look good.

Cleverly adjust axis ranges for integer tick spacing.

This will help avoid one of my major pet peeves with chartting
packages, which is non-pixel-aligned ticks. This is part of
the problem solved, (integer spacing between ticks), but we
still need integer alignment.

Remove bogus 0.5 offset when setting up data transform.

I think my intuition here had been to provide at least some padding
between the frame and data. But we should do that explicitly (and
correctly) rather than just throwing in a 0.5 offset.

Draw major ticks along the X and Y axes.

Many thanks to Keith Packard for suggesting the math to
normalize and choose a step spacing.

Add preliminary data plotting.

It's all in black for now, with no colors or styles.

Also, we don't yet have ticks nor axis value labels nor a key.

Put frame and ticks into its own function as well.

Split drawing of title and labels into its own function.

This will make things much more clear as we now add functions
for drawing the chart outline, the ticks, and the data itself.

Draw title and axis labels with pango

Many thanks to Owen and Behdad for all the pango love.

The layout iterates if necessary do to any wrapping from overly long
title or axis labels.

Add preliminary implementation of acre

This is a simple chart-drawing library using cairo. We will use
this to replace the image-magick and perl-using csv2png script,
(and then also use this to do interactive charts within a GUI).

Create README file

Just need an initial commit to boostrap this repository.