1
# -*- coding: UTF-8 -*-
 
 
2
"""Cell renderer for directed graph.
 
 
4
This module contains the implementation of a custom GtkCellRenderer that
 
 
5
draws part of the directed graph based on the lines suggested by the code
 
 
8
Because we're shiny, we use Cairo to do this, and because we're naughty
 
 
9
we cheat and draw over the bits of the TreeViewColumn that are supposed to
 
 
10
just be for the background.
 
 
13
__copyright__ = "Copyright © 2005 Canonical Ltd."
 
 
14
__author__    = "Scott James Remnant <scott@ubuntu.com>"
 
 
25
class CellRendererGraph(gtk.GenericCellRenderer):
 
 
26
    """Cell renderer for directed graph.
 
 
29
      node              (column, colour) tuple to draw revision node,
 
 
30
      in_lines          (start, end, colour) tuple list to draw inward lines,
 
 
31
      out_lines         (start, end, colour) tuple list to draw outward lines.
 
 
37
        "node":         ( gobject.TYPE_PYOBJECT, "node",
 
 
38
                          "revision node instruction",
 
 
39
                          gobject.PARAM_WRITABLE
 
 
41
        "in-lines":     ( gobject.TYPE_PYOBJECT, "in-lines",
 
 
42
                          "instructions to draw lines into the cell",
 
 
43
                          gobject.PARAM_WRITABLE
 
 
45
        "out-lines":    ( gobject.TYPE_PYOBJECT, "out-lines",
 
 
46
                          "instructions to draw lines out of the cell",
 
 
47
                          gobject.PARAM_WRITABLE
 
 
51
    def do_set_property(self, property, value):
 
 
52
        """Set properties from GObject properties."""
 
 
53
        if property.name == "node":
 
 
55
        elif property.name == "in-lines":
 
 
57
        elif property.name == "out-lines":
 
 
58
            self.out_lines = value
 
 
60
            raise AttributeError, "no such property: '%s'" % property.name
 
 
62
    def box_size(self, widget):
 
 
63
        """Calculate box size based on widget's font.
 
 
65
        Cache this as it's probably expensive to get.  It ensures that we
 
 
66
        draw the graph at least as large as the text.
 
 
70
        except AttributeError:
 
 
71
            pango_ctx = widget.get_pango_context()
 
 
72
            font_desc = widget.get_style().font_desc
 
 
73
            metrics = pango_ctx.get_metrics(font_desc)
 
 
75
            ascent = pango.PIXELS(metrics.get_ascent())
 
 
76
            descent = pango.PIXELS(metrics.get_descent())
 
 
78
            self._box_size = ascent + descent + 6
 
 
81
    def set_colour(self, ctx, colour, bg, fg):
 
 
82
        """Set the context source colour.
 
 
84
        Picks a distinct colour based on an internal wheel; the bg
 
 
85
        parameter provides the value that should be assigned to the 'zero'
 
 
86
        colours and the fg parameter provides the multiplier that should be
 
 
87
        applied to the foreground colours.
 
 
89
        mainline_color = ( 0.0, 0.0, 0.0 )
 
 
100
            colour_rgb = mainline_color
 
 
102
            colour_rgb = colours[colour % len(colours)]
 
 
104
        red   = (colour_rgb[0] * fg) or bg
 
 
105
        green = (colour_rgb[1] * fg) or bg
 
 
106
        blue  = (colour_rgb[2] * fg) or bg
 
 
108
        ctx.set_source_rgb(red, green, blue)
 
 
110
    def on_get_size(self, widget, cell_area):
 
 
111
        """Return the size we need for this cell.
 
 
113
        Each cell is drawn individually and is only as wide as it needs
 
 
114
        to be, we let the TreeViewColumn take care of making them all
 
 
117
        box_size = self.box_size(widget) + 1
 
 
119
        width = box_size * (self.columns_len + 1)
 
 
122
        # FIXME I have no idea how to use cell_area properly
 
 
123
        return (0, 0, width, height)
 
 
125
    def on_render(self, window, widget, bg_area, cell_area, exp_area, flags):
 
 
126
        """Render an individual cell.
 
 
128
        Draws the cell contents using cairo, taking care to clip what we
 
 
129
        do to within the background area so we don't draw over other cells.
 
 
130
        Note that we're a bit naughty there and should really be drawing
 
 
131
        in the cell_area (or even the exposed area), but we explicitly don't
 
 
134
        We try and be a little clever, if the line we need to draw is going
 
 
135
        to cross other columns we actually draw it as in the .---' style
 
 
136
        instead of a pure diagonal ... this reduces confusion by an
 
 
139
        ctx = window.cairo_create()
 
 
140
        ctx.rectangle(bg_area.x, bg_area.y, bg_area.width, bg_area.height)
 
 
143
        box_size = self.box_size(widget)
 
 
145
        ctx.set_line_width(box_size / 8)
 
 
146
        ctx.set_line_cap(cairo.LINE_CAP_ROUND)
 
 
148
        # Draw lines into the cell
 
 
149
        for start, end, colour in self.in_lines:
 
 
150
            self.render_line (ctx, cell_area, box_size,
 
 
151
                         bg_area.y, bg_area.height,
 
 
154
        # Draw lines out of the cell
 
 
155
        for start, end, colour in self.out_lines:
 
 
156
            self.render_line (ctx, cell_area, box_size,
 
 
157
                         bg_area.y + bg_area.height, bg_area.height,
 
 
160
        # Draw the revision node in the right column
 
 
161
        (column, colour) = self.node
 
 
162
        ctx.arc(cell_area.x + box_size * column + box_size / 2,
 
 
163
                cell_area.y + cell_area.height / 2,
 
 
164
                box_size / 4, 0, 2 * math.pi)
 
 
166
        self.set_colour(ctx, colour, 0.0, 0.5)
 
 
167
        ctx.stroke_preserve()
 
 
169
        self.set_colour(ctx, colour, 0.5, 1.0)
 
 
172
    def render_line (self, ctx, cell_area, box_size, mid, height, start, end, colour):
 
 
174
            x = cell_area.x + box_size * end + box_size / 2
 
 
175
            ctx.move_to(x, mid + height / 3)
 
 
176
            ctx.line_to(x, mid + height / 3)
 
 
177
            ctx.move_to(x, mid + height / 6)
 
 
178
            ctx.line_to(x, mid + height / 6)
 
 
181
            x = cell_area.x + box_size * start + box_size / 2
 
 
182
            ctx.move_to(x, mid - height / 3)
 
 
183
            ctx.line_to(x, mid - height / 3)
 
 
184
            ctx.move_to(x, mid - height / 6)
 
 
185
            ctx.line_to(x, mid - height / 6)
 
 
187
            startx = cell_area.x + box_size * start + box_size / 2
 
 
188
            endx = cell_area.x + box_size * end + box_size / 2
 
 
190
            ctx.move_to(startx, mid - height / 2)
 
 
192
            if start - end == 0 :
 
 
193
                ctx.line_to(endx, mid + height / 2)
 
 
195
                ctx.curve_to(startx, mid - height / 5,
 
 
196
                             startx, mid - height / 5,
 
 
197
                             startx + (endx - startx) / 2, mid)
 
 
199
                ctx.curve_to(endx, mid + height / 5,
 
 
200
                             endx, mid + height / 5 ,
 
 
201
                             endx, mid + height / 2)
 
 
203
        self.set_colour(ctx, colour, 0.0, 0.65)
 
 
 
b'\\ No newline at end of file'