sugar-toolkit-gtk3/lib/sugar/graphics/palette.py

723 lines
23 KiB
Python
Raw Normal View History

# Copyright (C) 2007, Eduardo Silva <edsiper@gmail.com>
2007-05-24 19:37:48 +02:00
#
2007-06-14 22:04:25 +02:00
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2 of the License, or (at your option) any later version.
2007-05-24 19:37:48 +02:00
#
2007-06-14 22:04:25 +02:00
# This library is distributed in the hope that it will be useful,
2007-05-24 19:37:48 +02:00
# but WITHOUT ANY WARRANTY; without even the implied warranty of
2007-06-14 22:04:25 +02:00
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# Lesser General Public License for more details.
2007-05-24 19:37:48 +02:00
#
2007-06-14 22:04:25 +02:00
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the
# Free Software Foundation, Inc., 59 Temple Place - Suite 330,
# Boston, MA 02111-1307, USA.
2007-05-24 19:37:48 +02:00
import logging
2007-05-24 19:37:48 +02:00
import gtk
import gobject
2007-06-06 23:21:33 +02:00
import time
import hippo
2007-05-24 19:37:48 +02:00
from sugar.graphics import palettegroup
from sugar.graphics import animator
from sugar.graphics import style
2007-10-16 11:04:59 +02:00
from sugar import _sugarext
# Helper function to find the gap position and size of widget a
def _calculate_gap(a, b):
# Test for each side if the palette and invoker are
# adjacent to each other.
gap = True
if a.y + a.height == b.y:
gap_side = gtk.POS_BOTTOM
elif a.x + a.width == b.x:
gap_side = gtk.POS_RIGHT
elif a.x == b.x + b.width:
gap_side = gtk.POS_LEFT
elif a.y == b.y + b.height:
gap_side = gtk.POS_TOP
else:
gap = False
if gap:
if gap_side == gtk.POS_BOTTOM or gap_side == gtk.POS_TOP:
gap_start = min(a.width, max(0, b.x - a.x))
gap_size = max(0, min(a.width,
(b.x + b.width) - a.x) - gap_start)
elif gap_side == gtk.POS_RIGHT or gap_side == gtk.POS_LEFT:
gap_start = min(a.height, max(0, b.y - a.y))
gap_size = max(0, min(a.height,
(b.y + b.height) - a.y) - gap_start)
if gap and gap_size > 0:
return (gap_side, gap_start, gap_size)
else:
return False
class Palette(gtk.Window):
2007-08-24 14:21:07 +02:00
PRIMARY = 0
SECONDARY = 1
2007-05-24 19:37:48 +02:00
__gtype_name__ = 'SugarPalette'
__gproperties__ = {
2007-06-25 11:39:51 +02:00
'invoker' : (object, None, None,
2007-09-06 18:55:51 +02:00
gobject.PARAM_READWRITE)
2007-05-24 19:37:48 +02:00
}
__gsignals__ = {
'popup' : (gobject.SIGNAL_RUN_FIRST,
gobject.TYPE_NONE, ([])),
'popdown' : (gobject.SIGNAL_RUN_FIRST,
gobject.TYPE_NONE, ([]))
}
def __init__(self, label, accel_path=None, menu_after_content=False):
gtk.Window.__init__(self)
self.set_decorated(False)
self.set_resizable(False)
# Just assume xthickness and ythickness are the same
self.set_border_width(self.style.xthickness)
self.connect('realize', self._realize_cb)
2007-05-24 19:37:48 +02:00
2007-08-24 14:21:07 +02:00
self.palette_state = self.PRIMARY
2007-09-01 11:59:16 +02:00
self._alignment = None
self._old_alloc = None
self._full_request = [0, 0]
self._cursor_x = 0
self._cursor_y = 0
2007-07-06 16:51:18 +02:00
self._invoker = None
self._group_id = None
self._up = False
self._palette_popup_sid = None
2007-06-01 06:08:24 +02:00
2007-06-26 14:28:31 +02:00
self._popup_anim = animator.Animator(0.3, 10)
self._popup_anim.add(_PopupAnimation(self))
self._secondary_anim = animator.Animator(1.0, 10)
2007-07-02 12:05:42 +02:00
self._secondary_anim.add(_SecondaryAnimation(self))
self._popdown_anim = animator.Animator(0.6, 10)
self._popdown_anim.add(_PopdownAnimation(self))
vbox = gtk.VBox()
self._label = gtk.Label()
self._label.set_size_request(-1, style.zoom(style.GRID_CELL_SIZE))
self._label.set_alignment(0, 0.5)
self._label.set_padding(style.zoom(15), 0)
vbox.pack_start(self._label, False)
self._secondary_box = gtk.VBox()
vbox.pack_start(self._secondary_box)
self._separator = gtk.HSeparator()
self._secondary_box.pack_start(self._separator)
self._menu_content_separator = gtk.HSeparator()
if menu_after_content:
self._add_content()
self._secondary_box.pack_start(self._menu_content_separator)
self._add_menu()
else:
self._add_menu()
self._secondary_box.pack_start(self._menu_content_separator)
self._add_content()
2007-06-02 06:33:41 +02:00
2007-08-08 13:03:09 +02:00
self.action_bar = PaletteActionBar()
self._secondary_box.pack_start(self.action_bar)
self.action_bar.show()
2007-06-06 06:51:01 +02:00
self.add(vbox)
vbox.show()
2007-06-25 11:39:51 +02:00
# The menu is not shown here until an item is added
self.menu = _Menu(self)
self.connect('enter-notify-event',
self._enter_notify_event_cb)
self.connect('leave-notify-event',
self._leave_notify_event_cb)
2007-06-06 04:43:42 +02:00
self.set_primary_text(label, accel_path)
self.set_group_id('default')
2007-05-24 19:37:48 +02:00
def _add_menu(self):
self._menu_box = gtk.VBox()
self._secondary_box.pack_start(self._menu_box)
self._menu_box.show()
def _add_content(self):
# The content is not shown until a widget is added
self._content = gtk.VBox()
self._content.set_border_width(style.zoom(15))
self._secondary_box.pack_start(self._content)
def do_style_set(self, previous_style):
# Prevent a warning from pygtk
if previous_style is not None:
gtk.Window.do_style_set(self, previous_style)
self.set_border_width(self.style.xthickness)
def is_up(self):
return self._up
def get_rect(self):
win_x, win_y = self.window.get_origin()
rectangle = self.get_allocation()
x = win_x + rectangle.x
y = win_y + rectangle.y
width = rectangle.width
height = rectangle.height
return gtk.gdk.Rectangle(x, y, width, height)
2007-07-01 12:31:23 +02:00
def set_primary_text(self, label, accel_path=None):
if label is not None:
self._label.set_markup("<b>"+label+"</b>")
self._label.show()
def set_content(self, widget):
if len(self._content.get_children()) > 0:
self._content.remove(self._content.get_children()[0])
2007-06-26 18:19:26 +02:00
if widget is not None:
self._content.add(widget)
self._content.show()
else:
self._content.hide()
2007-06-26 18:19:26 +02:00
self._update_accept_focus()
self._update_separators()
2007-05-24 19:37:48 +02:00
def set_group_id(self, group_id):
if self._group_id:
group = palettegroup.get_group(self._group_id)
group.remove(self)
if group_id:
self._group_id = group_id
group = palettegroup.get_group(group_id)
group.add(self)
2007-06-01 06:08:24 +02:00
def do_set_property(self, pspec, value):
if pspec.name == 'invoker':
if self._invoker is not None:
self._invoker.disconnect(self._enter_invoker_hid)
self._invoker.disconnect(self._leave_invoker_hid)
self._invoker = value
if value is not None:
self._enter_invoker_hid = self._invoker.connect(
'mouse-enter', self._invoker_mouse_enter_cb)
self._leave_invoker_hid = self._invoker.connect(
'mouse-leave', self._invoker_mouse_leave_cb)
2007-05-24 19:37:48 +02:00
else:
raise AssertionError
2007-07-06 16:51:18 +02:00
def do_get_property(self, pspec):
if pspec.name == 'invoker':
return self._invoker
else:
raise AssertionError
def do_size_request(self, requisition):
gtk.Window.do_size_request(self, requisition)
requisition.width = max(requisition.width, self._full_request[0])
# Minimum width
requisition.width = max(requisition.width,
style.zoom(style.GRID_CELL_SIZE*2))
def do_size_allocate(self, allocation):
gtk.Window.do_size_allocate(self, allocation)
if self._old_alloc is None or \
self._old_alloc.x != allocation.x or \
self._old_alloc.y != allocation.y or \
self._old_alloc.width != allocation.width or \
self._old_alloc.height != allocation.height:
self.queue_draw()
# We need to store old allocation because when size_allocate
# is called widget.allocation is already updated.
# gtk.Window resizing is different from normal containers:
# the X window is resized, widget.allocation is updated from
# the configure request handler and finally size_allocate is called.
self._old_alloc = allocation
def do_expose_event(self, event):
# We want to draw a border with a beautiful gap
if self._invoker is not None and self._invoker.has_rectangle_gap():
invoker = self._invoker.get_rect()
palette = self.get_rect()
gap = _calculate_gap(palette, invoker)
else:
gap = False
if gap:
self.style.paint_box_gap(event.window, gtk.STATE_PRELIGHT,
gtk.SHADOW_IN, event.area, self, "palette",
0, 0,
self.allocation.width,
self.allocation.height,
gap[0], gap[1], gap[2])
else:
self.style.paint_box(event.window, gtk.STATE_PRELIGHT,
gtk.SHADOW_IN, event.area, self, "palette",
0, 0,
self.allocation.width,
self.allocation.height)
# Fall trough to the container expose handler.
# (Leaving out the window expose handler which redraws everything)
gtk.Bin.do_expose_event(self, event)
def _update_separators(self):
visible = len(self.menu.get_children()) > 0 or \
len(self._content.get_children()) > 0
self._separator.props.visible = visible
visible = len(self.menu.get_children()) > 0 and \
len(self._content.get_children()) > 0
self._menu_content_separator.props.visible = visible
def _update_accept_focus(self):
accept_focus = len(self._content.get_children())
if self.window:
self.window.set_accept_focus(accept_focus)
def _realize_cb(self, widget):
self.window.set_type_hint(gtk.gdk.WINDOW_TYPE_HINT_DIALOG)
self._update_accept_focus()
def _update_full_request(self):
2007-08-24 14:21:07 +02:00
state = self.palette_state
2007-08-24 14:21:07 +02:00
self._set_state(self.SECONDARY)
self._full_request = self.size_request()
self._set_state(state)
2007-07-24 16:21:21 +02:00
def _update_position(self):
2007-09-01 11:59:16 +02:00
invoker = self._invoker
if invoker is None or self._alignment is None:
logging.error('Cannot update the palette position.')
return
2007-09-01 11:59:16 +02:00
rect = self.size_request()
position = invoker.get_position_for_alignment(self._alignment, rect)
if position is None:
position = invoker.get_position(rect)
2007-09-01 11:59:16 +02:00
self.move(position.x, position.y)
2007-07-24 16:21:21 +02:00
def _show(self):
if self._up:
return
self._palette_popup_sid = _palette_observer.connect(
'popup', self._palette_observer_popup_cb)
2007-07-24 16:21:21 +02:00
2007-09-01 11:59:16 +02:00
if self._invoker is not None:
self._update_full_request()
self._alignment = self._invoker.get_alignment(self._full_request)
self._update_position()
self.menu.set_active(True)
self.show()
2007-09-01 11:59:16 +02:00
self._invoker.notify_popup()
self._up = True
_palette_observer.emit('popup', self)
self.emit('popup')
2007-05-24 19:37:48 +02:00
2007-06-26 14:55:16 +02:00
def _hide(self):
2007-09-02 23:34:22 +02:00
self._secondary_anim.stop()
if not self._palette_popup_sid is None:
_palette_observer.disconnect(self._palette_popup_sid)
self._palette_popup_sid = None
self.menu.set_active(False)
self.hide()
2007-05-24 19:37:48 +02:00
if self._invoker:
self._invoker.notify_popdown()
self._up = False
self.emit('popdown')
def popup(self, immediate=False):
self._popdown_anim.stop()
if not immediate:
self._popup_anim.start()
else:
self._show()
2007-07-02 12:05:42 +02:00
self._secondary_anim.start()
def popdown(self, immediate=False):
self._popup_anim.stop()
if not immediate:
self._popdown_anim.start()
else:
self._hide()
2007-05-29 18:27:54 +02:00
def _set_state(self, state):
2007-08-24 14:21:07 +02:00
if self.palette_state == state:
return
2007-08-24 14:21:07 +02:00
if state == self.PRIMARY:
self.menu.unembed()
self._secondary_box.hide()
2007-08-24 14:21:07 +02:00
elif state == self.SECONDARY:
self.menu.embed(self._menu_box)
self._secondary_box.show()
2007-08-24 14:21:07 +02:00
self.palette_state = state
def _invoker_mouse_enter_cb(self, invoker):
immediate = False
2007-09-01 17:58:47 +02:00
if self.is_up():
self._popdown_anim.stop()
return
if self._group_id:
group = palettegroup.get_group(self._group_id)
if group and group.is_up():
2007-08-24 14:21:07 +02:00
self._set_state(group.get_state())
immediate = True
group.popdown()
self.popup(immediate=immediate)
2007-05-30 19:29:29 +02:00
def _invoker_mouse_leave_cb(self, invoker):
self.popdown()
2007-05-30 19:29:29 +02:00
def _enter_notify_event_cb(self, widget, event):
if event.detail != gtk.gdk.NOTIFY_INFERIOR:
self._popdown_anim.stop()
self._secondary_anim.start()
2007-05-30 19:29:29 +02:00
def _leave_notify_event_cb(self, widget, event):
if event.detail != gtk.gdk.NOTIFY_INFERIOR:
self.popdown()
2007-05-30 19:29:29 +02:00
def _palette_observer_popup_cb(self, observer, palette):
if self != palette:
self._hide()
2007-08-08 13:03:09 +02:00
class PaletteActionBar(gtk.HButtonBox):
def add_action(label, icon_name=None):
button = Button(label)
if icon_name:
icon = Icon(icon_name)
button.set_image(icon)
icon.show()
self.pack_start(button)
button.show()
2007-10-16 11:04:59 +02:00
class _Menu(_sugarext.Menu):
__gtype_name__ = 'SugarPaletteMenu'
def __init__(self, palette):
2007-10-16 11:04:59 +02:00
_sugarext.Menu.__init__(self)
self._palette = palette
def do_insert(self, item, position):
2007-10-16 11:04:59 +02:00
_sugarext.Menu.do_insert(self, item, position)
self._palette._update_separators()
self.show()
def do_expose_event(self, event):
# Ignore the Menu expose, just do the MenuShell expose to prevent any
# border from being drawn here. A border is drawn by the palette object
# around everything.
gtk.MenuShell.do_expose_event(self, event)
def do_grab_notify(self, was_grabbed):
# Ignore grab_notify as the menu would close otherwise
pass
def do_deactivate(self):
self._palette._hide()
class _PopupAnimation(animator.Animation):
def __init__(self, palette):
animator.Animation.__init__(self, 0.0, 1.0)
self._palette = palette
def next_frame(self, current):
if current == 1.0:
2007-08-24 14:21:07 +02:00
self._palette._set_state(Palette.PRIMARY)
2007-06-26 14:55:16 +02:00
self._palette._show()
2007-05-30 19:29:29 +02:00
2007-07-02 12:05:42 +02:00
class _SecondaryAnimation(animator.Animation):
def __init__(self, palette):
animator.Animation.__init__(self, 0.0, 1.0)
self._palette = palette
def next_frame(self, current):
if current == 1.0:
2007-08-24 14:21:07 +02:00
self._palette._set_state(Palette.SECONDARY)
2007-07-24 16:21:21 +02:00
self._palette._update_position()
2007-07-02 12:39:16 +02:00
class _PopdownAnimation(animator.Animation):
def __init__(self, palette):
animator.Animation.__init__(self, 0.0, 1.0)
self._palette = palette
def next_frame(self, current):
if current == 1.0:
2007-06-26 14:55:16 +02:00
self._palette._hide()
2007-05-29 18:27:54 +02:00
class Invoker(gobject.GObject):
__gtype_name__ = 'SugarPaletteInvoker'
2007-06-06 04:43:42 +02:00
__gsignals__ = {
'mouse-enter': (gobject.SIGNAL_RUN_FIRST, gobject.TYPE_NONE, ([])),
'mouse-leave': (gobject.SIGNAL_RUN_FIRST, gobject.TYPE_NONE, ([])),
'focus-out': (gobject.SIGNAL_RUN_FIRST, gobject.TYPE_NONE, ([]))
}
2007-09-01 11:59:16 +02:00
ANCHORED = 0
AT_CURSOR = 1
BOTTOM = [(0.0, 0.0, 0.0, 1.0),
(-1.0, 0.0, 1.0, 1.0)]
RIGHT = [(0.0, 0.0, 1.0, 0.0),
(0.0, -1.0, 1.0, 1.0)]
TOP = [(0.0, -1.0, 0.0, 0.0),
(-1.0, -1.0, 1.0, 0.0)]
LEFT = [(-1.0, 0.0, 0.0, 0.0),
(-1.0, -1.0, 0.0, 1.0)]
def __init__(self):
gobject.GObject.__init__(self)
2007-09-01 11:59:16 +02:00
self._screen_area = gtk.gdk.Rectangle(0, 0, gtk.gdk.screen_width(),
gtk.gdk.screen_height())
self._position_hint = self.ANCHORED
self._cursor_x = -1
self._cursor_y = -1
def _get_position_for_alignment(self, alignment, palette_dim):
palette_halign = alignment[0]
palette_valign = alignment[1]
invoker_halign = alignment[2]
invoker_valign = alignment[3]
if self._cursor_x == -1 or self._cursor_y == -1:
display = gtk.gdk.display_get_default()
screen, x, y, mask = display.get_pointer()
self._cursor_x = x
self._cursor_y = y
if self._position_hint is self.ANCHORED:
rect = self.get_rect()
else:
dist = style.PALETTE_CURSOR_DISTANCE
rect = gtk.gdk.Rectangle(self._cursor_x - dist,
self._cursor_y - dist,
dist * 2, dist * 2)
palette_width, palette_height = palette_dim
x = rect.x + rect.width * invoker_halign + \
palette_width * palette_halign
y = rect.y + rect.height * invoker_valign + \
palette_height * palette_valign
return gtk.gdk.Rectangle(int(x), int(y),
palette_width, palette_height)
def _in_screen(self, rect):
return rect.x >= self._screen_area.x and \
rect.y >= self._screen_area.y and \
rect.x + rect.width <= self._screen_area.width and \
rect.y + rect.height <= self._screen_area.height
def _get_alignments(self):
if self._position_hint is self.AT_CURSOR:
return [(0.0, 0.0, 1.0, 1.0),
(0.0, -1.0, 1.0, 0.0),
(-1.0, -1.0, 0.0, 0.0),
(-1.0, 0.0, 0.0, 1.0)]
else:
return self.BOTTOM + self.RIGHT + self.TOP + self.LEFT
2007-09-01 11:59:16 +02:00
def get_position_for_alignment(self, alignment, palette_dim):
rect = self._get_position_for_alignment(alignment, palette_dim)
if self._in_screen(rect):
return rect
else:
return None
def get_position(self, palette_dim):
for alignment in self._get_alignments():
rect = self._get_position_for_alignment(alignment, palette_dim)
if self._in_screen(rect):
break
return rect
def get_alignment(self, palette_dim):
for alignment in self._get_alignments():
rect = self._get_position_for_alignment(alignment, palette_dim)
if self._in_screen(rect):
break
return alignment
def has_rectangle_gap(self):
return False
def draw_rectangle(self, event, palette):
pass
def notify_popup(self):
pass
def notify_popdown(self):
2007-09-01 11:59:16 +02:00
self._cursor_x = -1
self._cursor_y = -1
class WidgetInvoker(Invoker):
def __init__(self, widget):
Invoker.__init__(self)
self._widget = widget
widget.connect('enter-notify-event', self._enter_notify_event_cb)
widget.connect('leave-notify-event', self._leave_notify_event_cb)
def get_rect(self):
win_x, win_y = self._widget.window.get_origin()
rectangle = self._widget.get_allocation()
x = win_x + rectangle.x
y = win_y + rectangle.y
width = rectangle.width
height = rectangle.height
return gtk.gdk.Rectangle(x, y, width, height)
def has_rectangle_gap(self):
return True
def draw_rectangle(self, event, palette):
style = self._widget.style
gap = _calculate_gap(self.get_rect(), palette.get_rect())
if gap:
style.paint_box_gap(event.window, gtk.STATE_PRELIGHT,
gtk.SHADOW_IN, event.area, self._widget,
"palette-invoker",
self._widget.allocation.x,
self._widget.allocation.y,
self._widget.allocation.width,
self._widget.allocation.height,
gap[0], gap[1], gap[2])
else:
style.paint_box(event.window, gtk.STATE_PRELIGHT,
gtk.SHADOW_IN, event.area, self._widget,
"palette-invoker",
self._widget.allocation.x,
self._widget.allocation.y,
self._widget.allocation.width,
self._widget.allocation.height)
def _enter_notify_event_cb(self, widget, event):
self.emit('mouse-enter')
def _leave_notify_event_cb(self, widget, event):
self.emit('mouse-leave')
def get_toplevel(self):
return self._widget.get_toplevel()
def notify_popup(self):
2007-09-01 11:59:16 +02:00
Invoker.notify_popup(self)
self._widget.queue_draw()
def notify_popdown(self):
2007-09-01 11:59:16 +02:00
Invoker.notify_popdown(self)
self._widget.queue_draw()
class CanvasInvoker(Invoker):
def __init__(self, item):
Invoker.__init__(self)
2007-09-01 11:59:16 +02:00
self._item = item
2007-09-01 11:59:16 +02:00
self._position_hint = self.AT_CURSOR
item.connect('motion-notify-event',
self._motion_notify_event_cb)
def get_default_position(self):
2007-09-04 20:22:58 +02:00
return self.AT_CURSOR
def get_rect(self):
context = self._item.get_context()
2007-06-26 14:28:31 +02:00
if context:
x, y = context.translate_to_screen(self._item)
width, height = self._item.get_allocation()
return gtk.gdk.Rectangle(x, y, width, height)
else:
return gtk.gdk.Rectangle()
def _motion_notify_event_cb(self, button, event):
if event.detail == hippo.MOTION_DETAIL_ENTER:
2007-09-01 11:59:16 +02:00
context = self._item.get_context()
self.emit('mouse-enter')
elif event.detail == hippo.MOTION_DETAIL_LEAVE:
self.emit('mouse-leave')
return False
def get_toplevel(self):
return hippo.get_canvas_for_item(self._item).get_toplevel()
class ToolInvoker(WidgetInvoker):
def __init__(self, widget):
WidgetInvoker.__init__(self, widget.child)
2007-09-01 13:40:57 +02:00
def _get_alignments(self):
parent = self._widget.get_parent()
if parent is None:
return WidgetInvoker.get_alignments()
2007-09-01 13:40:57 +02:00
if parent.get_orientation() is gtk.ORIENTATION_HORIZONTAL:
return self.BOTTOM + self.TOP
else:
return self.LEFT + self.RIGHT
class _PaletteObserver(gobject.GObject):
__gtype_name__ = 'SugarPaletteObserver'
__gsignals__ = {
'popup': (gobject.SIGNAL_RUN_FIRST, gobject.TYPE_NONE, ([object]))
}
def __init__(self):
gobject.GObject.__init__(self)
_palette_observer = _PaletteObserver()