Add angle kwarg to patches.Rectangle

[dmcdougall]

Allows rotation of a rectangle upon instantiation.

Addresses #987.
The old attempt was #1156.

[dmcdougall]

Here's an example:

import matplotlib
matplotlib.use('agg')
import matplotlib.pyplot as plt
from matplotlib.patches import Rectangle

fig = plt.figure()
ax = fig.add_subplot(1, 1, 1)
r = Rectangle((0.5, 1.0), 2, 1, angle=45.0)
ax.add_patch(r)
ax.set_xlim(0, 3)
ax.set_ylim(0, 3)
ax.set_aspect('equal')
fig.savefig('rect.pdf')

[wkerzendorf]

@dmcdougall Thanks!!

[pelson]

Nice solution to the problem. 👍

[wkerzendorf]

When will this be merged? It's really useful to me.

[dmcdougall]

I should add an entry to api_changes or whats_new (one of the other devs should advise me on this). It may be the case we are able to extend this for other artists, too. That should be done in a different pull request, though. This PR was only meant to satisfy the feature request in #987.

[WeatherGod]

On Sunday, November 4, 2012, Damon McDougall wrote:

I should add an entry to api_changes or whats_new (one of the other devs
should advise me on this). It may be the case we are able to extend this
for other artists, too. That should be done in a different pull request,
though. This PR was only meant to satisfy the feature request in #987#987
.

It should go into "what's new" because it doesn't require any changes to
existing code.

[dmcdougall]

Added a note in whats_new and added a test, too. Go me. When my friend Travis goes green, I consider this ready to merge. Others should review the code for any heinous style issues or hidden treasures.

[WeatherGod]

should be :class:~matplotlib.patches.Rectangle``

[dmcdougall]

Thanks.

[wkerzendorf]

@dmcdougall How's your friend Travis going?

[dmcdougall]

@wkerzendorf He gave this PR the all-clear. I'm just waiting on some of the other devs to give feedback and merge it. I am against merging my own pull requests unless they're trivial changes.

[pelson]

Thanks @dmcdougall (and @wkerzendorf for the nudging 😉 ). Merged.