Se corrige un bug. Los colores se ponían presuponiendo un Display de 24 bits. Ahora...

[z.facultad/75.42/figuras.git] / callbacks.h

diff --git a/callbacks.h b/callbacks.h
index 508bf24bb9ca3953d1ba86eb1806d57272ff0ce7..d6b98991fe5611ed1a25331bff0dae131a7103ee 100644 (file)
--- a/callbacks.h
+++ b/callbacks.h
@@ -16,16 +16,98 @@
 
 #include <gtk/gtk.h>
 
+/**
+ * Función llamada cuando hay que redibujar una porción del área de dibujo.
+ * 
+ * \param widget Área de dibujo que recibió el evento.
+ * \param event Evento (tiene información del área que necesita ser repintada).
+ * \param user_data Dibujo con las figuras a redibujar.
+ */
 gboolean on_drawingarea_expose_event(GtkWidget *widget, GdkEventExpose *event,
         gpointer user_data);
 
+/**
+ * Función llamada cuando se presiona el botón de Limpiar.
+ *
+ * \param button Botón presionado.
+ * \param user_data Dibujo con las figuras a borrar.
+ */
 void on_button_borrar_clicked(GtkButton *button, gpointer user_data);
 
+/**
+ * Función llamada cuando se presiona el botón de Actualizar.
+ *
+ * \param button Botón presionado.
+ * \param user_data Área de dibujo a actualizar.
+ */
 void on_button_graficar_clicked(GtkButton *button, gpointer user_data);
 
+/**
+ * Función llamada cuando se presiona el botón de Salir.
+ *
+ * \param button Botón presionado.
+ * \param user_data No utilizado.
+ */
 void on_button_salir_clicked(GtkButton *button, gpointer user_data);
 
+/**
+ * Función llamada cuando se presiona el botón de Agregar.
+ *
+ * \param button Botón presionado.
+ * \param user_data TP5Window con todos los widget necesarios para tomar la
+ * entrada del usuario y crear la nueva figura.
+ */
 void on_button_agregar_clicked(GtkButton *button, gpointer user_data);
 
+/**
+ * Función llamada cuando el manejador de ventanas manda el evento Delete.
+ * Típicamente esto sucede cuando se presiona la X en la decoración de la
+ * ventana).
+ * 
+ * \param widget Ventana que recibió el evento.
+ * \param event Evento.
+ * \param user_data No utilizado.
+ */
 gboolean on_window_delete_event(GtkWidget *widget, GdkEvent *event,
         gpointer user_data);
+
+/**
+ * Función llamada cuando se presiona el botón de selección Línea.
+ *
+ * \param togglebutton Botón presionado.
+ * \param user_data TP5Window con los widgets que hay que activar y desactivar
+ * para que el usuario sólo pueda ingresar los datos que tengan sentido.
+ */
+void on_radiobutton_linea_toggled(GtkToggleButton *togglebutton,
+        gpointer user_data);
+
+/**
+ * Función llamada cuando se presiona el botón de selección Cuadrado.
+ *
+ * \param togglebutton Botón presionado.
+ * \param user_data TP5Window con los widgets que hay que activar y desactivar
+ * para que el usuario sólo pueda ingresar los datos que tengan sentido.
+ */
+void on_radiobutton_cuadrado_toggled(GtkToggleButton *togglebutton,
+        gpointer user_data);
+
+/**
+ * Función llamada cuando se presiona el botón de selección Rectángulo.
+ *
+ * \param togglebutton Botón presionado.
+ * \param user_data TP5Window con los widgets que hay que activar y desactivar
+ * para que el usuario sólo pueda ingresar los datos que tengan sentido.
+ */
+void on_radiobutton_rectangulo_toggled(GtkToggleButton *togglebutton,
+        gpointer user_data);
+
+/**
+ * Función llamada cuando se presiona el botón de selección Círculo.
+ *
+ * \param togglebutton Botón presionado.
+ * \param user_data TP5Window con los widgets que hay que activar y desactivar
+ * para que el usuario sólo pueda ingresar los datos que tengan sentido.
+ */
+void on_radiobutton_circulo_toggled(GtkToggleButton *togglebutton,
+        gpointer user_data);
+