Features/GTK3/Porting/Implode: Difference between revisions

← Older edit

@@ Line 5: / Line 5: @@
 I will take [[User:Humitos/PortingGetBooks|this guide]] as reference on the Gtk3 porting.
-= Focus =
+= Porting Gtk.DrawingArea =
-Replace:
+There are some things related with <tt>gtk.DrawingArea</tt> that we have to change when we are porting an activity to Gtk3. The names of the signals change and the way that they work as well.
+== Get allocation size ==
+''self.allocation'' property is no longer available and we should use <tt>self.get_allocation_width</tt> to get the allocation size:
+ self.allocation.width
+ self.allocation.height
+should be replaced by:
+ self.get_allocated_width()
+ self.get_allocated_height()
+== Signals ==
+=== expose-event ===
+This signal was override by '''draw''' and it have to be connected with the method that was connected with the ''expose-event'' before. The method itself does not change but the arguments that it receives do. This is the new definition of the function in my case:
+ def _draw_event_cb(self, widget, cr):
+=== size-allocate ===
+This signal was used to resize the gtk.DrawingArea every time the window grows and at the startup of the activity. This is useful to re-draw the widget for different resolutions (desktops and XOs for example).
+I used the same function connected to this signal but I change the signal connected by '''configure-event'''. Here is the definition of the callback:
+ def _configure_event_cb(self, widget, event):
+== Focus ==
+Implode defines a new widget called ''GridWidget'' and it should be focusable because we want to move a cursor with the key arrows on it. So, this widget was using:
   self.set_flags(Gtk.CAN_FOCUS)
-by
+but that method (''set_flags'') is no longer available and we have to replace it by:
   self.set_can_focus(True)
+Another thing related with the focus is to know who has the actual focus. In gtk2 it was done by
+ .focus_child
+and in Gtk3 it should be replaced by:
+ .get_focus_child()
+= Handling .svg with rsvg =
+'''rsvg''' is a library to manage ''.svg'' files. The only thing that I found that should be updated is the import and the loading of a rsvg from data.
+Replace the usual import:
+ import rsgv
+by the Gtk3 one:
+ from gi.repository import Rsvg
+This way to load a rsvg from data should be replaced:
+ rsvg.Handle(data=data)
+by this new way
+ Rsvg.Handle.new_from_data(data)
+= Invalidate rectangle =
+<tt>Gdk.Window.invalidate_rect</tt> takes a ''Gdk.Rectangle'' instead a tuple in Gtk3.
+ rect = Gdk.Rectangle()
+ rect.x, rect.y, rect.width, rect.height = (0, 0, width, height)
+ self.get_window().invalidate_rect(rect, True)
+= Notes =
+* I had to add a third argument (None) to Gtk.Notebook.append_page but I don't know why
+* Use '''json''' instead of ''simplejson'' or so
+* Replace <tt>gtk.VISIBLE</tt> by '''Gtk.AccelFlags.VISIBLE'''
+= Missing things (not ported yet) =
+* ''sugarless.py'' is not working. The board is not shown. Do we update this to keep it working? I mean, do we need to maintain this code?
+* [<span style="color: green;">DONE</span>] <del>help dialogue is not working. It shows the example board but it's one pixel size when it opens</del>
+* When the help dialogue is shown and you hover the animation with the mouse something strange happens and it starts to flap. [http://bugs.sugarlabs.org/attachment/ticket/3715/53.png Screenshot]
+= Useful Links =
+* http://developer.gnome.org/gtk3/3.5/GtkWidget.html#GtkWidget-draw
+* http://developer.gnome.org/gtk3/3.5/GtkWidget.html#GtkWidget-configure-event
+* http://developer.gnome.org/rsvg/stable/
+* http://developer.gnome.org/gdk3/stable/gdk3-Windows.html#gdk-window-invalidate-rect
+* http://developer.gnome.org/gtk3/3.5/GtkWidget.html#gtk-widget-get-allocated-width
+* http://developer.gnome.org/gtk3/3.5/GtkNotebook.html#gtk-notebook-append-page