Diagram.py

   1 #!/usr/bin/env python
   2 #
   3 # A Diagram abstraction based on Cairo
   4 #
   5 # Copyright (C) 2015  Antonio Ospite <ao2@ao2.it>
   6 #
   7 # This program is free software: you can redistribute it and/or modify
   8 # it under the terms of the GNU General Public License as published by
   9 # the Free Software Foundation, either version 3 of the License, or
  10 # (at your option) any later version.
  11 #
  12 # This program is distributed in the hope that it will be useful,
  13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 # GNU General Public License for more details.
  16 #
  17 # You should have received a copy of the GNU General Public License
  18 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
  19
  20 import cairo
  21 from math import *
  22
  23
  24 class Diagram(object):
  25
  26     def __init__(self, width, height, background=[1, 1, 1], font_size=20):
  27         self.width = width
  28         self.height = height
  29         self.background = background
  30
  31         # TODO: use a RecordingSurface
  32         self.surface = cairo.SVGSurface(None, width, height)
  33         self.cr = cr = cairo.Context(self.surface)
  34
  35         # convert to left-bottom-origin cartesian coordinates
  36         cr.translate(0, self.height)
  37         cr.scale(1, -1)
  38
  39         cr.select_font_face("Georgia", cairo.FONT_SLANT_NORMAL,
  40                             cairo.FONT_WEIGHT_NORMAL)
  41         cr.set_font_size(font_size)
  42
  43         # Adjust the font matrix to left-bottom origin
  44         M = cr.get_font_matrix()
  45         M.scale(1, -1)
  46         cr.set_font_matrix(M)
  47
  48     def clear(self):
  49         cr = self.cr
  50
  51         r, g, b, a = self.color_to_rgba(self.background)
  52         cr.set_source_rgba(r, g, b, a)
  53         cr.paint()
  54
  55     def save_svg(self, filename):
  56         surface = cairo.SVGSurface(filename + '.svg', self.width, self.height)
  57         cr = cairo.Context(surface)
  58         cr.set_source_surface(self.surface, 0, 0)
  59         cr.paint()
  60
  61     def save_png(self, filename):
  62         surface = cairo.ImageSurface(cairo.FORMAT_ARGB32, self.width, self.height)
  63         cr = cairo.Context(surface)
  64         cr.set_source_surface(self.surface, 0, 0)
  65         cr.paint()
  66         surface.write_to_png(filename + '.png')
  67
  68     def show(self):
  69         import Image
  70         import StringIO
  71         f = StringIO.StringIO()
  72         surface = cairo.ImageSurface(cairo.FORMAT_ARGB32, self.width, self.height)
  73         cr = cairo.Context(surface)
  74         cr.set_source_surface(self.surface, 0, 0)
  75         cr.paint()
  76         surface.write_to_png(f)
  77         f.seek(0)
  78         im = Image.open(f)
  79         im.show()
  80
  81     def get_regular_polygon(self, x, y, sides, r, theta0=0.0):
  82         theta = 2 * pi / sides
  83
  84         verts = []
  85         for i in range(0, sides):
  86             px = x + r * sin(theta0 + i * theta)
  87             py = y + r * cos(theta0 + i * theta)
  88             verts.append((px, py))
  89
  90         return verts
  91
  92     def color_to_rgba(self, color):
  93         if len(color) == 3:
  94             return color[0], color[1], color[2], 1.0
  95         elif len(color) == 4:
  96             return color[0], color[1], color[2], color[3]
  97         else:
  98             return None
  99
 100     def _draw_polygon(self, verts):
 101         cr = self.cr
 102
 103         v = verts[0]
 104         cr.move_to(v[0], v[1])
 105         for v in verts[1:]:
 106             cr.line_to(v[0], v[1])
 107         cr.close_path()
 108
 109     def draw_polygon_by_verts(self, verts, fill_color=None, stroke_color=[0, 0, 0]):
 110         cr = self.cr
 111
 112         if fill_color:
 113             self._draw_polygon(verts)
 114             r, g, b, a = self.color_to_rgba(fill_color)
 115             cr.set_source_rgba(r, g, b, a)
 116             cr.fill()
 117
 118         if stroke_color:
 119             self._draw_polygon(verts)
 120             r, g, b, a = self.color_to_rgba(stroke_color)
 121             cr.set_source_rgba(r, g, b, a)
 122             cr.stroke()
 123
 124     def draw_polygon(self, cx, cy, sides, r, theta=0.0, fill_color=None, stroke_color=[0, 0, 0]):
 125         verts = self.get_regular_polygon(cx, cy, sides, r, theta)
 126         self.draw_polygon_by_verts(verts, fill_color, stroke_color)
 127
 128     def draw_star(self, cx, cy, verts, stroke_color=[0, 0, 0]):
 129         cr = self.cr
 130
 131         for v in verts:
 132             cr.move_to(cx, cy)
 133             cr.line_to(v[0], v[1])
 134
 135         r, g, b, a = self.color_to_rgba(stroke_color)
 136         cr.set_source_rgba(r, g, b, a)
 137         cr.stroke()
 138
 139     def draw_circle(self, cx, cy, size=10.0, fill_color=[0, 0, 0, 0.5],
 140                     stroke_color=None):
 141         cr = self.cr
 142
 143         cr.save()
 144         cr.arc(cx, cy, size, 0, 2 * pi)
 145
 146         if fill_color:
 147             r, g, b, a = self.color_to_rgba(fill_color)
 148             cr.set_source_rgba(r, g, b, a)
 149             cr.fill()
 150
 151         if stroke_color:
 152             r, g, b, a = self.color_to_rgba(stroke_color)
 153             cr.set_source_rgba(r, g, b, a)
 154             cr.stroke()
 155
 156         cr.restore()
 157
 158     def normalized_angle_01(self, theta):
 159         return fmod(theta, 2 * pi) / (2 * pi)
 160
 161     def draw_line(self, x1, y1, x2, y2, stroke_color=[0, 0, 0, 1]):
 162         cr = self.cr
 163         cr.move_to(x1, y1)
 164         cr.line_to(x2, y2)
 165         r, g, b, a = self.color_to_rgba(stroke_color)
 166         cr.set_source_rgba(r, g, b, a)
 167         cr.stroke()
 168
 169     def draw_rect_from_center(self, cx, cy, width, height, theta=0,
 170                               fill_color=[1, 1, 1, 0.8], stroke_color=None):
 171         cr = self.cr
 172
 173         # the position of the center of a rectangle at (0,0)
 174         mx = width / 2.0
 175         my = height / 2.0
 176
 177         # calculate the position of the bottom-left corner after rotating the
 178         # rectangle around the center
 179         rx = cx - (mx * cos(theta) - my * sin(theta))
 180         ry = cy - (mx * sin(theta) + my * cos(theta))
 181
 182         self.draw_rect(rx, ry, width, height, theta, fill_color, stroke_color)
 183
 184     def draw_rect(self, x, y, width, height, theta=0,
 185                   fill_color=[1, 1, 1, 0.8], stroke_color=None):
 186         cr = self.cr
 187
 188         cr.save()
 189         cr.translate(x, y)
 190         cr.rotate(theta)
 191
 192         if fill_color:
 193             cr.rectangle(0, 0, width, height)
 194             r, g, b, a = self.color_to_rgba(fill_color)
 195             cr.set_source_rgba(r, g, b, a)
 196             cr.fill()
 197
 198         if stroke_color:
 199             cr.rectangle(0, 0, width, height)
 200             r, g, b, a = self.color_to_rgba(stroke_color)
 201             cr.set_source_rgba(r, g, b, a)
 202             cr.stroke()
 203
 204         cr.restore()
 205
 206     def draw_centered_text(self, cx, cy, text, theta=0,
 207                            color=[0, 0, 0],
 208                            align_baseline=False,
 209                            bb_fill_color=[1, 1, 1, 0.8],
 210                            bb_stroke_color=None):
 211         cr = self.cr
 212
 213         x_bearing, y_bearing, width, height, x_advance = cr.text_extents(text)[:5]
 214         ascent, descent = cr.font_extents()[:2]
 215
 216         # The offset of the lower-left corner of the text.
 217         tx = width / 2.0 + x_bearing
 218
 219         if align_baseline:
 220             # When aligning to the  baseline it is convenient the make the
 221             # bounding box depend on the font vertical extent and not from the
 222             # text content.
 223             ty = 0
 224             bb = [0, -descent, width, ascent]
 225         else:
 226             ty = height / 2.0 + y_bearing
 227             bb = [0, y_bearing, width, height]
 228
 229         # Angles are intended clockwise by the caller, but the trigonometric
 230         # functions below consider angles counter-clockwise
 231         theta = -theta
 232
 233         # The coordinate of the lower-left corner of the rotated rectangle
 234         rx = cx - tx * cos(theta) + ty * sin(theta)
 235         ry = cy - tx * sin(theta) - ty * cos(theta)
 236
 237         cr.save()
 238         cr.translate(rx, ry)
 239         cr.rotate(theta)
 240
 241         if bb_fill_color or bb_stroke_color:
 242             self.draw_rect(bb[0], bb[1], bb[2], bb[3], 0, bb_fill_color, bb_stroke_color)
 243
 244         r, g, b, a = self.color_to_rgba(color)
 245         cr.set_source_rgba(r, g, b, a)
 246         cr.move_to(0, 0)
 247         cr.show_text(text)
 248         cr.fill()
 249         cr.restore()
 250
 251         return x_advance
 252
 253
 254 if __name__ == "__main__":
 255     diagram = Diagram(400, 400)
 256
 257     diagram.clear()
 258
 259     x = 40
 260     y = 200
 261
 262     x_offset = x
 263
 264     theta = 0
 265
 266     advance = diagram.draw_centered_text(x_offset, y, "Ciao", theta, align_baseline=True, bb_stroke_color=[0, 0, 0, 0.5])
 267     x_offset += advance
 268
 269     advance = diagram.draw_centered_text(x_offset, y, "____", theta + pi / 4, align_baseline=True, bb_stroke_color=[0, 0, 0, 0.5])
 270     x_offset += advance
 271
 272     advance = diagram.draw_centered_text(x_offset, y, "jxpqdlf", theta + pi / 2, align_baseline=True, bb_stroke_color=[0, 0, 0, 0.5])
 273     x_offset += advance
 274
 275     advance = diagram.draw_centered_text(x_offset, y, "pppp", theta + 3 * pi / 4, align_baseline=True, bb_stroke_color=[0, 0, 0, 0.5])
 276     x_offset += advance
 277
 278     advance = diagram.draw_centered_text(x_offset, y, "dddd", theta + pi, align_baseline=True, bb_stroke_color=[0, 0, 0, 0.5])
 279     x_offset += advance
 280
 281     advance = diagram.draw_centered_text(x_offset, y, "Jjjj", theta + 5 * pi / 4, align_baseline=True, bb_stroke_color=[0, 0, 0, 0.5])
 282     x_offset += advance
 283
 284     advance = diagram.draw_centered_text(x_offset, y, "1369", theta + 3 * pi / 2, align_baseline=True, bb_stroke_color=[0, 0, 0, 0.5])
 285     x_offset += advance
 286
 287     advance = diagram.draw_centered_text(x_offset, y, "qqqq", theta + 7 * pi / 4, align_baseline=True, bb_stroke_color=[0, 0, 0, 0.5])
 288     x_offset += advance
 289
 290     diagram.draw_line(0, y, 400, y, [0, 0, 1, 0.2])
 291
 292     diagram.draw_rect(40, 40, 300, 100, stroke_color=[0, 0, 0, 0.8])
 293     diagram.draw_rect(40, 40, 300, 100, pi / 30, stroke_color=[0, 0, 0, 0.8])
 294
 295     diagram.draw_rect(40, 250, 300, 100, stroke_color=[0, 0, 0, 0.8])
 296     diagram.draw_rect_from_center(40 + 150, 250 + 50, 300, 100, theta=(pi / 40), stroke_color=[1, 0, 0], fill_color=None)
 297
 298     diagram.show()