tabletarea
index
/home/pdubroy/dev/sugar-toolkit/sugar/graphics/tabletarea.py

# Copyright (C) 2008, Patrick Dubroy <pdubroy@gmail.com>
#
# 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.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# 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.

 
Modules
       
gtk

 
Classes
       
gtk.DrawingArea(gtk.Widget)
TabletArea

 
class TabletArea(gtk.DrawingArea)
    Maps input from the XO Pen Tablet to an on-screen DrawingArea.
 
Intended for applications that want to get input from the XO's Pen Tablet
device and map it to an on-screen area that has the same aspect ratio
as the physical tablet. For example, a penmanship activity might allow
a child to practice writing by using the tablet.
 
For mapping the tablet to a larger area, e.g. in the Paint activity,
use the TabletBox instead.
 
 
Method resolution order:
TabletArea
gtk.DrawingArea
gtk.Widget
gtk.Object
gobject.GObject
atk.ImplementorIface
gtk.Buildable
gobject.GInterface
__builtin__.object

Methods defined here:
__init__(self, **gc_kwargs)
Create a new TabletArea.
 
gc_args, if specified, is a set of keyword arguments that will
be passed to gtk.gdk.Drawable.new_gc() to create the GC for drawing
the strokes. For example:
 
    tablet_area = TabletArea(line_width=2, 
                             cap_style=gtk.gdk.CAP_BUTT,
                             join_style=gtk.gdk.JOIN_MITER)
add_stroke(self, x1, y1, x2, y2)
Add a stroke from (x1, y1) to (x2, y2) to the TabletArea.
 
This method is called whenever a stroke is detected on the physical
tablet area, but can also be called by any code that wants to emulate
a tablet stroke.
clear(self)
Clear the tablet area -- both the pixmap and the list of strokes.
do_expose_event(self, event)
get_gc(self)
Return the gtk.gdk.GC that is used for drawing the strokes.
 
Note: The GC will be None until the widget is first shown on-screen.
get_pixmap(self)
Return a copy of the gtk.gdk.Pixmap displayed on the tablet area.
 
Note: This will return None until the widget is shown on-screen.
get_strokes(self)
Return a list of strokes that have been made inside the Tablet area.
 
A stroke is a tuple (p1, p2) representing a stroke from point p1 to 
point p2, where p1 and p2 are object with attributes 'x' and 'y'.
set_gc(self, gc)
Set the gtk.gdk.GC to be used for drawing the strokes.

Data and other attributes defined here:
__gtype__ = <GType SugarTabletArea (138138048)>
__gtype_name__ = 'SugarTabletArea'

Methods inherited from gtk.DrawingArea:
size(...)

Methods inherited from gtk.Widget:
activate(...)
add_accelerator(...)
add_events(...)
add_mnemonic_label(...)
can_activate_accel(...)
child_focus(...)
child_notify(...)
class_path(...)
create_pango_context(...)
create_pango_layout(...)
destroy(...)
drag_begin(...)
drag_check_threshold(...)
drag_dest_add_image_targets(...)
drag_dest_add_text_targets(...)
drag_dest_add_uri_targets(...)
drag_dest_find_target(...)
drag_dest_get_target_list(...)
drag_dest_get_track_motion(...)
drag_dest_set(...)
drag_dest_set_proxy(...)
drag_dest_set_target_list(...)
drag_dest_set_track_motion(...)
drag_dest_unset(...)
drag_get_data(...)
drag_highlight(...)
drag_source_add_image_targets(...)
drag_source_add_text_targets(...)
drag_source_add_uri_targets(...)
drag_source_get_target_list(...)
drag_source_set(...)
drag_source_set_icon(...)
drag_source_set_icon_name(...)
drag_source_set_icon_pixbuf(...)
drag_source_set_icon_stock(...)
drag_source_set_target_list(...)
drag_source_unset(...)
drag_unhighlight(...)
draw(...)
ensure_style(...)
error_bell(...)
event(...)
freeze_child_notify(...)
get_accessible(...)
get_action(...)
get_allocation(...)
get_ancestor(...)
get_child_requisition(...)
get_child_visible(...)
get_clipboard(...)
get_colormap(...)
get_composite_name(...)
get_direction(...)
get_display(...)
get_events(...)
get_extension_events(...)
get_has_tooltip(...)
get_modifier_style(...)
get_name(...)
get_no_show_all(...)
get_pango_context(...)
get_parent(...)
get_parent_window(...)
get_pointer(...)
get_root_window(...)
get_screen(...)
get_settings(...)
get_size_request(...)
get_style(...)
get_tooltip_markup(...)
get_tooltip_text(...)
get_tooltip_window(...)
get_toplevel(...)
get_visual(...)
grab_add(...)
grab_default(...)
grab_focus(...)
grab_remove(...)
has_screen(...)
hide(...)
hide_all(...)
hide_on_delete(...)
input_shape_combine_mask(...)
intersect(...)
is_ancestor(...)
is_composited(...)
is_focus(...)
keynav_failed(...)
list_mnemonic_labels(...)
map(...)
menu_get_for_attach_widget(...)
mnemonic_activate(...)
modify_base(...)
modify_bg(...)
modify_cursor(...)
modify_fg(...)
modify_font(...)
modify_style(...)
modify_text(...)
path(...)
queue_clear(...)
queue_clear_area(...)
queue_draw(...)
queue_draw_area(...)
queue_resize(...)
queue_resize_no_redraw(...)
rc_get_style(...)
realize(...)
region_intersect(...)
remove_accelerator(...)
remove_mnemonic_label(...)
render_icon(...)
reparent(...)
reset_rc_styles(...)
reset_shapes(...)
selection_add_target(...)
selection_add_targets(...)
selection_clear_targets(...)
selection_convert(...)
selection_owner_set(...)
selection_remove_all(...)
send_expose(...)
set_accel_path(...)
set_app_paintable(...)
set_child_visible(...)
set_colormap(...)
set_composite_name(...)
set_direction(...)
set_double_buffered(...)
set_events(...)
set_extension_events(...)
set_name(...)
set_no_show_all(...)
set_parent(...)
set_parent_window(...)
set_redraw_on_allocate(...)
set_scroll_adjustments(...)
set_sensitive(...)
set_size_request(...)
set_state(...)
set_style(...)
set_tooltip_markup(...)
set_tooltip_text(...)
set_tooltip_window(...)
set_uposition(...)
set_usize(...)
shape_combine_mask(...)
show(...)
show_all(...)
show_now(...)
size_allocate(...)
size_request(...)
style_get_property(...)
thaw_child_notify(...)
translate_coordinates(...)
trigger_tooltip_query(...)
unmap(...)
unparent(...)
unrealize(...)

Data descriptors inherited from gtk.Widget:
allocation
name
parent
saved_state
state
style
window

Data and other attributes inherited from gtk.Widget:
do_button_press_event = <built-in method do_button_press_event of GObjectMeta object at 0x82380c4>
do_button_release_event = <built-in method do_button_release_event of GObjectMeta object at 0x82380c4>
do_can_activate_accel = <built-in method do_can_activate_accel of GObjectMeta object at 0x82380c4>
do_client_event = <built-in method do_client_event of GObjectMeta object at 0x82380c4>
do_composited_changed = <built-in method do_composited_changed of GObjectMeta object at 0x82380c4>
do_configure_event = <built-in method do_configure_event of GObjectMeta object at 0x82380c4>
do_delete_event = <built-in method do_delete_event of GObjectMeta object at 0x82380c4>
do_destroy_event = <built-in method do_destroy_event of GObjectMeta object at 0x82380c4>
do_direction_changed = <built-in method do_direction_changed of GObjectMeta object at 0x82380c4>
do_drag_begin = <built-in method do_drag_begin of GObjectMeta object at 0x82380c4>
do_drag_data_delete = <built-in method do_drag_data_delete of GObjectMeta object at 0x82380c4>
do_drag_data_get = <built-in method do_drag_data_get of GObjectMeta object at 0x82380c4>
do_drag_data_received = <built-in method do_drag_data_received of GObjectMeta object at 0x82380c4>
do_drag_drop = <built-in method do_drag_drop of GObjectMeta object at 0x82380c4>
do_drag_end = <built-in method do_drag_end of GObjectMeta object at 0x82380c4>
do_drag_leave = <built-in method do_drag_leave of GObjectMeta object at 0x82380c4>
do_drag_motion = <built-in method do_drag_motion of GObjectMeta object at 0x82380c4>
do_enter_notify_event = <built-in method do_enter_notify_event of GObjectMeta object at 0x82380c4>
do_event = <built-in method do_event of GObjectMeta object at 0x82380c4>
do_focus = <built-in method do_focus of GObjectMeta object at 0x82380c4>
do_focus_in_event = <built-in method do_focus_in_event of GObjectMeta object at 0x82380c4>
do_focus_out_event = <built-in method do_focus_out_event of GObjectMeta object at 0x82380c4>
do_get_accessible = <built-in method do_get_accessible of GObjectMeta object at 0x82380c4>
do_grab_broken_event = <built-in method do_grab_broken_event of GObjectMeta object at 0x82380c4>
do_grab_focus = <built-in method do_grab_focus of GObjectMeta object at 0x82380c4>
do_grab_notify = <built-in method do_grab_notify of GObjectMeta object at 0x82380c4>
do_hide = <built-in method do_hide of GObjectMeta object at 0x82380c4>
do_hide_all = <built-in method do_hide_all of GObjectMeta object at 0x82380c4>
do_hierarchy_changed = <built-in method do_hierarchy_changed of GObjectMeta object at 0x82380c4>
do_key_press_event = <built-in method do_key_press_event of GObjectMeta object at 0x82380c4>
do_key_release_event = <built-in method do_key_release_event of GObjectMeta object at 0x82380c4>
do_leave_notify_event = <built-in method do_leave_notify_event of GObjectMeta object at 0x82380c4>
do_map = <built-in method do_map of GObjectMeta object at 0x82380c4>
do_map_event = <built-in method do_map_event of GObjectMeta object at 0x82380c4>
do_mnemonic_activate = <built-in method do_mnemonic_activate of GObjectMeta object at 0x82380c4>
do_motion_notify_event = <built-in method do_motion_notify_event of GObjectMeta object at 0x82380c4>
do_no_expose_event = <built-in method do_no_expose_event of GObjectMeta object at 0x82380c4>
do_parent_set = <built-in method do_parent_set of GObjectMeta object at 0x82380c4>
do_popup_menu = <built-in method do_popup_menu of GObjectMeta object at 0x82380c4>
do_property_notify_event = <built-in method do_property_notify_event of GObjectMeta object at 0x82380c4>
do_proximity_in_event = <built-in method do_proximity_in_event of GObjectMeta object at 0x82380c4>
do_proximity_out_event = <built-in method do_proximity_out_event of GObjectMeta object at 0x82380c4>
do_realize = <built-in method do_realize of GObjectMeta object at 0x82380c4>
do_screen_changed = <built-in method do_screen_changed of GObjectMeta object at 0x82380c4>
do_scroll_event = <built-in method do_scroll_event of GObjectMeta object at 0x82380c4>
do_selection_clear_event = <built-in method do_selection_clear_event of GObjectMeta object at 0x82380c4>
do_selection_get = <built-in method do_selection_get of GObjectMeta object at 0x82380c4>
do_selection_notify_event = <built-in method do_selection_notify_event of GObjectMeta object at 0x82380c4>
do_selection_received = <built-in method do_selection_received of GObjectMeta object at 0x82380c4>
do_selection_request_event = <built-in method do_selection_request_event of GObjectMeta object at 0x82380c4>
do_show = <built-in method do_show of GObjectMeta object at 0x82380c4>
do_show_all = <built-in method do_show_all of GObjectMeta object at 0x82380c4>
do_show_help = <built-in method do_show_help of GObjectMeta object at 0x82380c4>
do_size_allocate = <built-in method do_size_allocate of GObjectMeta object at 0x82380c4>
do_size_request = <built-in method do_size_request of GObjectMeta object at 0x82380c4>
do_state_changed = <built-in method do_state_changed of GObjectMeta object at 0x82380c4>
do_style_set = <built-in method do_style_set of GObjectMeta object at 0x82380c4>
do_unmap = <built-in method do_unmap of GObjectMeta object at 0x82380c4>
do_unmap_event = <built-in method do_unmap_event of GObjectMeta object at 0x82380c4>
do_unrealize = <built-in method do_unrealize of GObjectMeta object at 0x82380c4>
do_visibility_notify_event = <built-in method do_visibility_notify_event of GObjectMeta object at 0x82380c4>
do_window_state_event = <built-in method do_window_state_event of GObjectMeta object at 0x82380c4>
get_activate_signal = <built-in method get_activate_signal of GObjectMeta object at 0x82380c4>
set_activate_signal = <built-in method set_activate_signal of GObjectMeta object at 0x82380c4>
set_set_scroll_adjustments_signal = <built-in method set_set_scroll_adjustments_signal of GObjectMeta object at 0x82380c4>

Methods inherited from gtk.Object:
flags(...)
remove_data(...)
remove_no_notify(...)
set_flags(...)
unset_flags(...)

Data and other attributes inherited from gtk.Object:
do_destroy = <built-in method do_destroy of GObjectMeta object at 0x82380c4>

Methods inherited from gobject.GObject:
__cmp__(...)
x.__cmp__(y) <==> cmp(x,y)
__delattr__(...)
x.__delattr__('name') <==> del x.name
__gobject_init__(...)
__hash__(...)
x.__hash__() <==> hash(x)
__repr__(...)
x.__repr__() <==> repr(x)
__setattr__(...)
x.__setattr__('name', value) <==> x.name = value
chain(...)
connect(...)
connect_after(...)
connect_object(...)
connect_object_after(...)
disconnect(...)
disconnect_by_func(...)
emit(...)
emit_stop_by_name(...)
freeze_notify(...)
get_data(...)
get_properties(...)
get_property(...)
handler_block(...)
handler_block_by_func(...)
handler_disconnect(...)
handler_is_connected(...)
handler_unblock(...)
handler_unblock_by_func(...)
notify(...)
set_data(...)
set_properties(...)
set_property(...)
stop_emission(...)
thaw_notify(...)
weak_ref(...)

Data descriptors inherited from gobject.GObject:
__dict__
__grefcount__

Data and other attributes inherited from gobject.GObject:
__gdoc__ = 'Object SugarTabletArea\n\n Maps input from the XO ...ointer\n\nSignals from GObject:\n notify (GParam)\n\n'
__new__ = <built-in method __new__ of GObjectMeta object at 0xb7cf8480>
T.__new__(S, ...) -> a new object with type S, a subtype of T
props = <gobject.GProps object at 0x8353e0c>

Methods inherited from atk.ImplementorIface:
ref_accessible(...)

Methods inherited from gtk.Buildable:
add_child(...)
construct_child(...)
get_internal_child(...)
parser_finished(...)

Data and other attributes inherited from gtk.Buildable:
do_add_child = <built-in method do_add_child of GObjectMeta object at 0x82380c4>
do_construct_child = <built-in method do_construct_child of GObjectMeta object at 0x82380c4>
do_get_internal_child = <built-in method do_get_internal_child of GObjectMeta object at 0x82380c4>
do_parser_finished = <built-in method do_parser_finished of GObjectMeta object at 0x82380c4>
do_set_name = <built-in method do_set_name of GObjectMeta object at 0x82380c4>