Ir Olivier Samyn osamyn@ulb.ac.be 2003ko otsaila 0.1 2003ko otsaila 0.2 2003ko apirila 0.3 2004ko urtarrila Oro har, C gcompris_xxx funtzio guztiak dagozkien gcompris.xxx funtzioekin bilduta daude; parametroak eta itzulera-motak berdin gelditzen dira. Egitura batzuk ere bildu dira. Ikus honi buruzko ohar zehatzak behean. Bildutako funtzioak paketetan banatuta daude. Pakete bakoitza gcompris goiburu-fitxategi bati dagokio (gameutil.h, score.h, ...) Baina ez dira bildu pakete/goiburu bakoitzaren funtzio guztiak. Plugin-entzat erabilgarri diren funtzioak bakarrik bildu dira. Kontuan hartu ez direla funtzio guztiak probatu (denborarekin eta python plugin berriekin egingo da, baina..). Bildukiak idatzi dira, konpilatzen dira, baina ez dago bermerik haien portaerari buruz... Programa-errore bat aurkitzen baduzu, eman horren berri! Python-en idatzitako taula bakoitzak "Gcompris_xxx" izeneko klase bat eduki behar du (xxx taularen izena da). Adibidez: Gcompris taula bat egin dut, python-en idatzita eta "pythontest" izenekoa. Taula honentzat badago gcompris pythontest.xml fitxategi bat, "pythontest" taula-izenerako eta "pythonboard" taula-motarako duena. Gainera, pythontest.py fitxategiak taula-kodea dauka. Eta, amaitzeko, fitxategi honek "Gcompris_pythontest" klase-definizio bat dauka, txandaka behar diren gcompris taula-funtzioak dituena. Python taulan definitutako klaseak ondoko metodoak eduki behar ditu:__init__(self, gcomprisBoard) start(self) end(self) ok(self) repeat(self) config(self) key_press(self, keyval) pause(self, pause) set_level(self, level) Metodoaren funtzioaz eta erabileraz gehiago jakiteko, ikus pythontest.py taula eta beste C taulak. Python-en egitura honen instantzia batek C egituraren instantzia balitz bezala jokatuko du. Hona Python dei-adibide batzuk: ... gcomprisBoard.level = 1 gcomprisBoard.maxlevel = 1 ... gcompris.bar_start(gcomprisBoard.canvas) ... Hona Python egituraren kide-izena eta mota, eta ohar bat atributua irakurgarria edota idazgarria den adierazten. Egituraren kidea Mota Irakurgarria Idazgarria typestringYNboard_readybooleanYNmodestringYNnamestringYNtitlestringYNdescriptionstringYNicon_namestringYNauthorstringYNboarddirstringYNfilenamestringYNdifficultystringYNmandatory_sound_filestringYNsectionstringYNmenuposotionstringYNprerequisitestringYNgoalstringYNmanualstringYNcreditstringYNwidthintYNheightintYNcanvasgnome.canvas.CanvasYNprevious_boardGcomprisBoardYNlevelintYYmaxlevelintYYsublevelintYYnumber_of_sublevelintYY Python funtzioa C baliokidea Oharrak gcompris.end_board() void gcompris_end_board(void) gcompris.bar_start(gnomeCanvas) void gcompris_bar_start(GnomeCanvas *theCanvas) gcompris.set_background(gnomeCanvasGroup, file) GnomeCanvasItem *gcompris_set_background(GnomeCanvasGroup *parent, gchar *file) return a gnome.canvas.CanvasItem object gcompris.bar_set_level(gcomprisBoard) void gcompris_bar_set_level(GcomprisBoard *gcomprisBoard) gcompris.bar_set_repeat_icon(pixmap) void gcompris_bar_set_repeat_icon(GdkPixbuf *pixmap) gcompris.bar_set(flags) void gcompris_bar_set(const GComprisBarFlags flags) gcompris.bar_hide(hide) void gcompris_bar_hide(gboolean hide) gcompris.board_has_help(gcomprisBoard) gboolean gcompris_board_has_help(GcomprisBoard *gcomprisBoard) return a boolean gcompris.help_start(gcomprisBoard) void gcompris_help_start(GcomprisBoard *gcomprisBoard) gcompris.help_stop() void gcompris_help_stop(void) gcompris.get_canvas() GnomeCanvas* gcompris_get_canvas() return a gnome.canvas.Canvas gcompris.get_window() GtkWidget* gcompris_get_window(void) return a gtk.Widget gcompris.get_locale() gchar* gcompris_get_locale(void) return a string gcompris.set_locale(locale) void gcompris_set_locale(gchar *locale) gcompris.set_cursor(cursor_type) void gcompris_set_cursor(guint gdk_cursor_type) gcompris.images_selector_start(gcomprisBoard, dataset, callback) void gcompris_images_selector_start (GcomprisBoard *gcomprisBoard, gchar *dataset, ImageSelectorCallBack imscb) The callback must be a callable object gcompris.images_selector_stop() void gcompris_images_selector_stop(void) gcompris.exit() void gcompris_exit(void) gcompris.log_set_reason (gcomprisBoard, expected, got) gcompris_log_set_reason (GcomprisBoard *gcomprisBoard, gchar *expected, gchar *got) gcompris.log_end (gcomprisBoard, status) gcompris_log_end (GcomprisBoard *gcomprisBoard, gchar *status) Python konstantea C baliokidea gcompris.BAR_LEVEL GCOMPRIS_BAR_LEVEL gcompris.BAR_OK GCOMPRIS_BAR_OK gcompris.BAR_REPEAT GCOMPRIS_BAR_REPEAT gcompris.BAR_CONFIG GCOMPRIS_BAR_CONFIG gcompris.BAR_ABOUT GCOMPRIS_BAR_ABOUT Python konstantea C baliokidea gcompris.BOARD_HEIGHT BOARDHEIGHT gcompris.BOARD_WIDTH BOARDWIDTH gcompris.BAR_HEIGHT BAR_HEIGHT gcompris.DEFAULT_SKIN DEFAULT_SKIN Python konstantea C baliokidea gcompris.COLOR_TITLECOLOR_TITLE gcompris.COLOR_TEXT_BUTTONCOLOR_TEXT_BUTTON gcompris.COLOR_CONTENTCOLOR_CONTENT gcompris.COLOR_SUBTITLECOLOR_SUBTITLE Python konstantea C baliokidea gcompris.FONT_TITLEFONT_TITLE gcompris.FONT_TITLE_FALLBACKFONT_TITLE_FALLBACK gcompris.FONT_SUBTITLEFONT_SUBTITLE gcompris.FONT_SUBTITLE_FALLBACKFONT_SUBTITLE_FALLBACK gcompris.FONT_CONTENTFONT_CONTENT gcompris.FONT_CONTENT_FALLBACKFONT_CONTENT_FALLBACK Python konstantea C baliokidea gcompris.FONT_BOARD_TINYFONT_BOARD_TINY gcompris.FONT_BOARD_SMALLFONT_BOARD_SMALL gcompris.FONT_BOARD_MEDIUMFONT_BOARD_MEDIUM gcompris.FONT_BOARD_BIGFONT_BOARD_BIG gcompris.FONT_BOARD_BIG_BOLDFONT_BOARD_BIG_BOLD gcompris.FONT_BOARD_FIXEDFONT_BOARD_FIXED gcompris.FONT_BOARD_TITLEFONT_BOARD_TITLE gcompris.FONT_BOARD_TITLE_BOLDFONT_BOARD_TITLE_BOLD gcompris.FONT_BOARD_HUGEFONT_BOARD_HUGE gcompris.FONT_BOARD_HUGE_BOLDFONT_BOARD_HUGE_BOLD Python konstantea C baliokidea gcompris.CURSOR_FIRST_CUSTOM GCOMPRIS_FIRST_CUSTOM_CURSOR gcompris.CURSOR_BIG_RED_ARROW GCOMPRIS_BIG_RED_ARROW_CURSOR gcompris.CURSOR_BIRDGCOMPRIS_BIRD_CURSOR gcompris.CURSOR_LINEGCOMPRIS_LINE_CURSOR gcompris.CURSOR_FILLRECTGCOMPRIS_FILLRECT_CURSOR gcompris.CURSOR_RECTGCOMPRIS_RECT_CURSOR gcompris.CURSOR_FILLCIRCLEGCOMPRIS_FILLCIRCLE_CURSOR gcompris.CURSOR_CIRCLEGCOMPRIS_CIRCLE_CURSOR gcompris.CURSOR_DELGCOMPRIS_DEL_CURSOR gcompris.CURSOR_FILLGCOMPRIS_FILL_CURSOR gcompris.CURSOR_SELECTGCOMPRIS_SELECT_CURSOR gcompris.CURSOR_DEFAULTGCOMPRIS_DEFAULT_CURSOR Python funtzioa C baliokidea Oharrak gcompris.utils.image_to_skin(imagename) gchar *gcompris_image_to_skin(gchar *imagename) return a string gcompris.utils.load_skin_pixmap(pixmapfile) GdkPixbuf *gcompris_load_skin_pixmap(char *pixmapfile) return a gtk.gdk.Pixbuf gcompris.utils.load_pixmap(pixmapfile) GdkPixbuf *gcompris_load_pixmap(char *pixmapfile) return a gtk.gdk.Pixbuf gcompris.utils.set_image_focus(item, focus) void gcompris_set_image_focus(GnomeCanvasItem *item, gboolean focus) gcompris.utils.item_event_focus(item, event, dest_item) gint gcompris_item_event_focus(GnomeCanvasItem *item, GdkEvent *event, GnomeCanvasItem *dest_item) return an integer gcompris.utils.item_absolute_move(item, x, y) void item_absolute_move(GnomeCanvasItem *item, int x, int y) gcompris.utils.item_rotate(item, angle) void item_rotate(GnomeCanvasItem *item, double angle) gcompris.utils.item_rotate_relative(item, angle) void item_rotate_relative(GnomeCanvasItem *item, double angle) gcompris.utils.item_rotate_with_center(item, angle, x, y) void item_rotate_with_center(GnomeCanvasItem *item, double angle, int x, int y) gcompris.utils.item_rotate_relative_with_center(item, angle, x, y) void item_rotate_relative_with_center(GnomeCanvasItem *item, double angle, int x, int y) gcompris.utils.dialog(str, callback) void gcompris_dialog(gchar *str, DialogBoxCallBack callback) The callback must be a callable object gcompris.utils.load_pixmap_asset(dataset, categories, mimetype, name) GdkPixbuf *gcompris_load_pixmap_asset(gchar *dataset, gchar* categories, gchar* mimetype, gchar* name) return a gtk.gdk.Pixbuf gcompris.utils.get_asset_file(dataset, categories, mimetype, name) gchar *gcompris_get_asset_file(gchar *dataset, gchar* categories, gchar* mimetype, gchar* name) return a string Pakete honetan ez dago konstanterik. Python funtzioa C baliokidea Oharrak gcompris.bonus.display(gamewon, bonus_id) void gcompris_display_bonus(int gamewon, int bonus_id) gcompris.bonus.board_finished(type) void board_finished(int type) Python konstantea C baliokidea gcompris.bonus.TIME_CLICK_TO TIME_CLICK_TO_BONUS gcompris.bonus.RANDOM BONUS_RANDOM gcompris.bonus.SMILEY BONUS_SMILEY gcompris.bonus.FLOWER BONUS_FLOWER gcompris.bonus.LAST BONUS_LAST gcompris.bonus.FINISHED_RANDOM BOARD_FINISHED_RANDOM gcompris.bonus.FINISHED_TUXPLANE BOARD_FINISHED_TUXPLANE gcompris.bonus.FINISHED_TUXLOCO BOARD_FINISHED_TUXLOCO gcompris.bonus.FINISHED_TOOMANYERRORS BOARD_FINISHED_TOOMANYERRORS gcompris.bonus.FINISHED_LAST BOARD_FINISHED_LAST Python funtzioa C baliokidea Oharrak gcompris.score.start(style, x, y, max) void gcompris_score_start(ScoreStyleList style, guint x, guint y, guint max) gcompris.score.end() void gcompris_score_end() gcompris.score.set(value) void gcompris_score_set(guint value) Python konstantea C baliokidea gcompris.score.STYLE_NOTE SCORESTYLE_NOTE gcompris.score.STYLE_LIFE SCORESTYLE_LIFE gcompris.score.LAST SCORE_LAST Python funtzioa C baliokidea Oharrak gcompris.sound.play_ogg_list(list) void gcompris_play_ogg_list( GList* files ) The list argument is a GList gcompris.sound.play_ogg(list) void gcompris_play_ogg(char *, ...) Zerrenda-argumentua kateak dauzkan python zerrenda bat da Pakete honetan ez dago konstanterik. Python funtzioa C baliokidea Oharrak gcompris.timer.display(x, y, type, second, callback) void gcompris_timer_display (int x, int y, TimerList type, int second, GcomprisTimerEnd gcomprisTimerEnd); The callback must be a callable object gcompris.timer.add(second) void gcompris_timer_add(int second) gcompris.timer.end() void gcompris_timer_end(void) gcompris.timer.get_remaining() guint gcompris_timer_get_remaining() Return an integer gcompris.timer.pause(pause) void gcompris_timer_pause(gboolean pause) Python konstantea C baliokidea gcompris.timer.TEXT GCOMPRIS_TIMER_TEXT gcompris.timer.SAND GCOMPRIS_TIMER_SAND gcompris.timer.BALLOON GCOMPRIS_TIMER_BALLOON gcompris.timer.CLOCK GCOMPRIS_TIMER_CLOCK