X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=gtk%2Fgtkprintjob.c;h=49c664d88fcd5d228b8dd2a06841239d3f39c0ab;hb=61344219d4ba6d81854cc5bea8cf90f600358501;hp=2781c996caf73e4e91eaa93b7298d57681dfaec4;hpb=480803d5baa8414e13588d10f7ca694eb5eec433;p=~andy%2Fgtk diff --git a/gtk/gtkprintjob.c b/gtk/gtkprintjob.c index 2781c996c..49c664d88 100644 --- a/gtk/gtkprintjob.c +++ b/gtk/gtkprintjob.c @@ -12,11 +12,24 @@ * 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. + * License along with this library. If not, see . */ +/** + * SECTION:gtkprintjob + * @Title: GtkPrintJob + * @Short_description: Represents a print job + * + * A #GtkPrintJob object represents a job that is sent to a + * printer. You only need to deal directly with print jobs if + * you use the non-portable #GtkPrintUnixDialog API. + * + * Use gtk_print_job_get_surface() to obtain the cairo surface + * onto which the pages must be drawn. Use gtk_print_job_send() + * to send the finished job to the printer. If you don't use cairo + * #GtkPrintJob also supports printing of manually generated postscript, + * via gtk_print_job_set_source_file(). + */ #include "config.h" #include #include @@ -37,7 +50,6 @@ #include "gtkprinter.h" #include "gtkprinter-private.h" #include "gtkprintbackend.h" -#include "gtkalias.h" #ifndef O_BINARY #define O_BINARY 0 @@ -47,22 +59,33 @@ struct _GtkPrintJobPrivate { gchar *title; - int spool_file_fd; + GIOChannel *spool_io; cairo_surface_t *surface; GtkPrintStatus status; - GtkPrintBackend *backend; + GtkPrintBackend *backend; GtkPrinter *printer; GtkPrintSettings *settings; GtkPageSetup *page_setup; - guint printer_set : 1; - guint page_setup_set : 1; - guint settings_set : 1; - guint track_print_status : 1; + GtkPrintPages print_pages; + GtkPageRange *page_ranges; + gint num_page_ranges; + GtkPageSet page_set; + gint num_copies; + gdouble scale; + guint number_up; + GtkNumberUpLayout number_up_layout; + + guint printer_set : 1; + guint page_setup_set : 1; + guint settings_set : 1; + guint track_print_status : 1; + guint rotate_to_orientation : 1; + guint collate : 1; + guint reverse : 1; }; - #define GTK_PRINT_JOB_GET_PRIVATE(o) \ (G_TYPE_INSTANCE_GET_PRIVATE ((o), GTK_TYPE_PRINT_JOB, GtkPrintJobPrivate)) @@ -86,10 +109,11 @@ enum { enum { PROP_0, - GTK_PRINT_JOB_PROP_TITLE, - GTK_PRINT_JOB_PROP_PRINTER, - GTK_PRINT_JOB_PROP_PAGE_SETUP, - GTK_PRINT_JOB_PROP_SETTINGS + PROP_TITLE, + PROP_PRINTER, + PROP_PAGE_SETUP, + PROP_SETTINGS, + PROP_TRACK_PRINT_STATUS }; static guint signals[LAST_SIGNAL] = { 0 }; @@ -109,8 +133,8 @@ gtk_print_job_class_init (GtkPrintJobClass *class) g_type_class_add_private (class, sizeof (GtkPrintJobPrivate)); - g_object_class_install_property (G_OBJECT_CLASS (class), - GTK_PRINT_JOB_PROP_TITLE, + g_object_class_install_property (object_class, + PROP_TITLE, g_param_spec_string ("title", P_("Title"), P_("Title of the print job"), @@ -118,8 +142,8 @@ gtk_print_job_class_init (GtkPrintJobClass *class) GTK_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY)); - g_object_class_install_property (G_OBJECT_CLASS (class), - GTK_PRINT_JOB_PROP_PRINTER, + g_object_class_install_property (object_class, + PROP_PRINTER, g_param_spec_object ("printer", P_("Printer"), P_("Printer to print the job to"), @@ -127,8 +151,8 @@ gtk_print_job_class_init (GtkPrintJobClass *class) GTK_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY)); - g_object_class_install_property (G_OBJECT_CLASS (class), - GTK_PRINT_JOB_PROP_SETTINGS, + g_object_class_install_property (object_class, + PROP_SETTINGS, g_param_spec_object ("settings", P_("Settings"), P_("Printer settings"), @@ -136,8 +160,8 @@ gtk_print_job_class_init (GtkPrintJobClass *class) GTK_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY)); - g_object_class_install_property (G_OBJECT_CLASS (class), - GTK_PRINT_JOB_PROP_PAGE_SETUP, + g_object_class_install_property (object_class, + PROP_PAGE_SETUP, g_param_spec_object ("page-setup", P_("Page Setup"), P_("Page Setup"), @@ -145,6 +169,17 @@ gtk_print_job_class_init (GtkPrintJobClass *class) GTK_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY)); + g_object_class_install_property (object_class, + PROP_TRACK_PRINT_STATUS, + g_param_spec_boolean ("track-print-status", + P_("Track Print Status"), + P_("TRUE if the print job will continue to emit " + "status-changed signals after the print data " + "has been sent to the printer or print server."), + FALSE, + GTK_PARAM_READWRITE)); + + /** * GtkPrintJob::status-changed: * @job: the #GtkPrintJob object on which the signal was emitted @@ -169,9 +204,9 @@ gtk_print_job_init (GtkPrintJob *job) { GtkPrintJobPrivate *priv; - priv = job->priv = GTK_PRINT_JOB_GET_PRIVATE (job); + priv = job->priv = GTK_PRINT_JOB_GET_PRIVATE (job); - priv->spool_file_fd = -1; + priv->spool_io = NULL; priv->title = g_strdup (""); priv->surface = NULL; @@ -183,16 +218,18 @@ gtk_print_job_init (GtkPrintJob *job) priv->page_setup_set = FALSE; priv->status = GTK_PRINT_STATUS_INITIAL; priv->track_print_status = FALSE; - - job->print_pages = GTK_PRINT_PAGES_ALL; - job->page_ranges = NULL; - job->num_page_ranges = 0; - job->collate = FALSE; - job->reverse = FALSE; - job->num_copies = 1; - job->scale = 1.0; - job->page_set = GTK_PAGE_SET_ALL; - job->rotate_to_orientation = FALSE; + + priv->print_pages = GTK_PRINT_PAGES_ALL; + priv->page_ranges = NULL; + priv->num_page_ranges = 0; + priv->collate = FALSE; + priv->reverse = FALSE; + priv->num_copies = 1; + priv->scale = 1.0; + priv->page_set = GTK_PAGE_SET_ALL; + priv->rotate_to_orientation = FALSE; + priv->number_up = 1; + priv->number_up_layout = GTK_NUMBER_UP_LAYOUT_LEFT_TO_RIGHT_TOP_TO_BOTTOM; } @@ -232,12 +269,12 @@ gtk_print_job_finalize (GObject *object) GtkPrintJob *job = GTK_PRINT_JOB (object); GtkPrintJobPrivate *priv = job->priv; - if (priv->spool_file_fd >= 0) + if (priv->spool_io != NULL) { - close (priv->spool_file_fd); - priv->spool_file_fd = -1; + g_io_channel_unref (priv->spool_io); + priv->spool_io = NULL; } - + if (priv->backend) g_object_unref (priv->backend); @@ -249,13 +286,13 @@ gtk_print_job_finalize (GObject *object) if (priv->settings) g_object_unref (priv->settings); - + if (priv->page_setup) g_object_unref (priv->page_setup); - g_free (job->page_ranges); - job->page_ranges = NULL; - + g_free (priv->page_ranges); + priv->page_ranges = NULL; + g_free (priv->title); priv->title = NULL; @@ -297,7 +334,7 @@ gtk_print_job_new (const gchar *title, * * Gets the #GtkPrintSettings of the print job. * - * Return value: the settings of @job + * Return value: (transfer none): the settings of @job * * Since: 2.10 */ @@ -315,7 +352,7 @@ gtk_print_job_get_settings (GtkPrintJob *job) * * Gets the #GtkPrinter of the print job. * - * Return value: the printer of @job + * Return value: (transfer none): the printer of @job * * Since: 2.10 */ @@ -337,7 +374,7 @@ gtk_print_job_get_printer (GtkPrintJob *job) * * Since: 2.10 */ -G_CONST_RETURN gchar * +const gchar * gtk_print_job_get_title (GtkPrintJob *job) { g_return_val_if_fail (GTK_IS_PRINT_JOB (job), NULL); @@ -383,13 +420,14 @@ gtk_print_job_set_status (GtkPrintJob *job, /** * gtk_print_job_set_source_file: * @job: a #GtkPrintJob - * @filename: the file to be printed + * @filename: (type filename): the file to be printed * @error: return location for errors * * Make the #GtkPrintJob send an existing document to the * printing system. The file can be in any format understood * by the platforms printing system (typically PostScript, - * but on many platforms PDF may work too). + * but on many platforms PDF may work too). See + * gtk_printer_accepts_pdf() and gtk_printer_accepts_ps(). * * Returns: %FALSE if an error occurred * @@ -401,40 +439,37 @@ gtk_print_job_set_source_file (GtkPrintJob *job, GError **error) { GtkPrintJobPrivate *priv; + GError *tmp_error; + + tmp_error = NULL; g_return_val_if_fail (GTK_IS_PRINT_JOB (job), FALSE); priv = job->priv; - priv->spool_file_fd = g_open (filename, O_RDONLY|O_BINARY); - if (priv->spool_file_fd < 0) - { - gchar *display_filename = g_filename_display_name (filename); - int save_errno = errno; - - g_set_error (error, - G_FILE_ERROR, - g_file_error_from_errno (save_errno), - _("Failed to open file '%s': %s"), - display_filename, - g_strerror (save_errno)); - - g_free (display_filename); + priv->spool_io = g_io_channel_new_file (filename, "r", &tmp_error); + if (tmp_error == NULL) + g_io_channel_set_encoding (priv->spool_io, NULL, &tmp_error); + + if (tmp_error != NULL) + { + g_propagate_error (error, tmp_error); return FALSE; } - return TRUE; + + return TRUE; } /** * gtk_print_job_get_surface: * @job: a #GtkPrintJob - * @error: return location for errors, or %NULL + * @error: (allow-none): return location for errors, or %NULL * * Gets a cairo surface onto which the pages of * the print job should be rendered. * - * Return value: the cairo surface of @job + * Return value: (transfer none): the cairo surface of @job * * Since: 2.10 **/ @@ -446,7 +481,11 @@ gtk_print_job_get_surface (GtkPrintJob *job, gchar *filename; gdouble width, height; GtkPaperSize *paper_size; - + int fd; + GError *tmp_error; + + tmp_error = NULL; + g_return_val_if_fail (GTK_IS_PRINT_JOB (job), NULL); priv = job->priv; @@ -454,25 +493,48 @@ gtk_print_job_get_surface (GtkPrintJob *job, if (priv->surface) return priv->surface; - g_return_val_if_fail (priv->spool_file_fd == -1, NULL); + g_return_val_if_fail (priv->spool_io == NULL, NULL); - priv->spool_file_fd = g_file_open_tmp ("gtkprint_XXXXXX", - &filename, - error); - if (priv->spool_file_fd == -1) - return NULL; + fd = g_file_open_tmp ("gtkprint_XXXXXX", + &filename, + &tmp_error); + if (fd == -1) + { + g_free (filename); + g_propagate_error (error, tmp_error); + return NULL; + } - fchmod (priv->spool_file_fd, S_IRUSR | S_IWUSR); - unlink (filename); + fchmod (fd, S_IRUSR | S_IWUSR); + +#ifdef G_ENABLE_DEBUG + /* If we are debugging printing don't delete the tmp files */ + if (!(gtk_get_debug_flags () & GTK_DEBUG_PRINTING)) +#endif /* G_ENABLE_DEBUG */ + g_unlink (filename); + g_free (filename); paper_size = gtk_page_setup_get_paper_size (priv->page_setup); width = gtk_paper_size_get_width (paper_size, GTK_UNIT_POINTS); height = gtk_paper_size_get_height (paper_size, GTK_UNIT_POINTS); + + priv->spool_io = g_io_channel_unix_new (fd); + g_io_channel_set_close_on_unref (priv->spool_io, TRUE); + g_io_channel_set_encoding (priv->spool_io, NULL, &tmp_error); + if (tmp_error != NULL) + { + g_io_channel_unref (priv->spool_io); + priv->spool_io = NULL; + g_propagate_error (error, tmp_error); + return NULL; + } + priv->surface = _gtk_printer_create_cairo_surface (priv->printer, - width, height, - priv->spool_file_fd); - + priv->settings, + width, height, + priv->spool_io); + return priv->surface; } @@ -493,7 +555,7 @@ gtk_print_job_get_surface (GtkPrintJob *job, */ void gtk_print_job_set_track_print_status (GtkPrintJob *job, - gboolean track_status) + gboolean track_status) { GtkPrintJobPrivate *priv; @@ -501,7 +563,14 @@ gtk_print_job_set_track_print_status (GtkPrintJob *job, priv = job->priv; - priv->track_print_status = track_status; + track_status = track_status != FALSE; + + if (priv->track_print_status != track_status) + { + priv->track_print_status = track_status; + + g_object_notify (G_OBJECT (job), "track-print-status"); + } } /** @@ -540,22 +609,23 @@ gtk_print_job_set_property (GObject *object, switch (prop_id) { - case GTK_PRINT_JOB_PROP_TITLE: + case PROP_TITLE: + g_free (priv->title); priv->title = g_value_dup_string (value); break; - case GTK_PRINT_JOB_PROP_PRINTER: + case PROP_PRINTER: priv->printer = GTK_PRINTER (g_value_dup_object (value)); priv->printer_set = TRUE; priv->backend = g_object_ref (gtk_printer_get_backend (priv->printer)); break; - case GTK_PRINT_JOB_PROP_PAGE_SETUP: + case PROP_PAGE_SETUP: priv->page_setup = GTK_PAGE_SETUP (g_value_dup_object (value)); priv->page_setup_set = TRUE; break; - case GTK_PRINT_JOB_PROP_SETTINGS: + case PROP_SETTINGS: /* We save a copy of the settings since we modify * if when preparing the printer job. */ settings = GTK_PRINT_SETTINGS (g_value_get_object (value)); @@ -563,6 +633,10 @@ gtk_print_job_set_property (GObject *object, priv->settings_set = TRUE; break; + case PROP_TRACK_PRINT_STATUS: + gtk_print_job_set_track_print_status (job, g_value_get_boolean (value)); + break; + default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; @@ -580,18 +654,21 @@ gtk_print_job_get_property (GObject *object, switch (prop_id) { - case GTK_PRINT_JOB_PROP_TITLE: + case PROP_TITLE: g_value_set_string (value, priv->title); break; - case GTK_PRINT_JOB_PROP_PRINTER: + case PROP_PRINTER: g_value_set_object (value, priv->printer); break; - case GTK_PRINT_JOB_PROP_SETTINGS: + case PROP_SETTINGS: g_value_set_object (value, priv->settings); break; - case GTK_PRINT_JOB_PROP_PAGE_SETUP: + case PROP_PAGE_SETUP: g_value_set_object (value, priv->page_setup); break; + case PROP_TRACK_PRINT_STATUS: + g_value_set_boolean (value, priv->track_print_status); + break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; @@ -601,42 +678,361 @@ gtk_print_job_get_property (GObject *object, /** * gtk_print_job_send: * @job: a GtkPrintJob - * @callback: function to call when the job completes + * @callback: function to call when the job completes or an error occurs * @user_data: user data that gets passed to @callback * @dnotify: destroy notify for @user_data - * @error: return location for errors, or %NULL * * Sends the print job off to the printer. * - * Return value: %FALSE if an error occurred - * * Since: 2.10 **/ -gboolean +void gtk_print_job_send (GtkPrintJob *job, GtkPrintJobCompleteFunc callback, gpointer user_data, - GDestroyNotify dnotify, - GError **error) + GDestroyNotify dnotify) { GtkPrintJobPrivate *priv; - g_return_val_if_fail (GTK_IS_PRINT_JOB (job), FALSE); + g_return_if_fail (GTK_IS_PRINT_JOB (job)); priv = job->priv; - g_return_val_if_fail (priv->spool_file_fd > 0, FALSE); + g_return_if_fail (priv->spool_io != NULL); gtk_print_job_set_status (job, GTK_PRINT_STATUS_SENDING_DATA); - lseek (priv->spool_file_fd, 0, SEEK_SET); - gtk_print_backend_print_stream (priv->backend, - job, - priv->spool_file_fd, - callback, - user_data, - dnotify); + + g_io_channel_seek_position (priv->spool_io, 0, G_SEEK_SET, NULL); + + gtk_print_backend_print_stream (priv->backend, job, + priv->spool_io, + callback, user_data, dnotify); +} - return TRUE; +/** + * gtk_print_job_get_pages: + * @job: a #GtkPrintJob + * + * Gets the #GtkPrintPages setting for this job. + * + * Returns: the #GtkPrintPages setting + * + * Since: 3.0 + */ +GtkPrintPages +gtk_print_job_get_pages (GtkPrintJob *job) +{ + return job->priv->print_pages; +} + +/** + * gtk_print_job_set_pages: + * @job: a #GtkPrintJob + * @pages: the #GtkPrintPages setting + * + * Sets the #GtkPrintPages setting for this job. + * + * Since: 3.0 + */ +void +gtk_print_job_set_pages (GtkPrintJob *job, + GtkPrintPages pages) +{ + job->priv->print_pages = pages; +} + +/** + * gtk_print_job_get_page_ranges: + * @job: a #GtkPrintJob + * @n_ranges: (out): return location for the number of ranges + * + * Gets the page ranges for this job. + * + * Returns: (array length=n_ranges) (transfer none): a pointer to an + * array of #GtkPageRange structs + * + * Since: 3.0 + */ +GtkPageRange * +gtk_print_job_get_page_ranges (GtkPrintJob *job, + gint *n_ranges) +{ + *n_ranges = job->priv->num_page_ranges; + return job->priv->page_ranges; +} + +/** + * gtk_print_job_set_page_ranges: + * @job: a #GtkPrintJob + * @ranges: (array length=n_ranges): pointer to an array of + * #GtkPageRange structs + * @n_ranges: the length of the @ranges array + * + * Sets the page ranges for this job. + * + * Since: 3.0 + */ +void +gtk_print_job_set_page_ranges (GtkPrintJob *job, + GtkPageRange *ranges, + gint n_ranges) +{ + job->priv->page_ranges = ranges; + job->priv->num_page_ranges = n_ranges; +} + +/** + * gtk_print_job_get_page_set: + * @job: a #GtkPrintJob + * + * Gets the #GtkPageSet setting for this job. + * + * Returns: the #GtkPageSet setting + * + * Since: 3.0 + */ +GtkPageSet +gtk_print_job_get_page_set (GtkPrintJob *job) +{ + return job->priv->page_set; +} + +/** + * gtk_print_job_set_page_set: + * @job: a #GtkPrintJob + * @page_set: a #GtkPageSet setting + * + * Sets the #GtkPageSet setting for this job. + * + * Since: 3.0 + */ +void +gtk_print_job_set_page_set (GtkPrintJob *job, + GtkPageSet page_set) +{ + job->priv->page_set = page_set; +} + +/** + * gtk_print_job_get_num_copies: + * @job: a #GtkPrintJob + * + * Gets the number of copies of this job. + * + * Returns: the number of copies + * + * Since: 3.0 + */ +gint +gtk_print_job_get_num_copies (GtkPrintJob *job) +{ + return job->priv->num_copies; +} + +/** + * gtk_print_job_set_num_copies: + * @job: a #GtkPrintJob + * @num_copies: the number of copies + * + * Sets the number of copies for this job. + * + * Since: 3.0 + */ +void +gtk_print_job_set_num_copies (GtkPrintJob *job, + gint num_copies) +{ + job->priv->num_copies = num_copies; +} + +/** + * gtk_print_job_get_scale: + * @job: a #GtkPrintJob + * + * Gets the scale for this job (where 1.0 means unscaled). + * + * Returns: the scale + * + * Since: 3.0 + */ +gdouble +gtk_print_job_get_scale (GtkPrintJob *job) + +{ + return job->priv->scale; +} + +/** + * gtk_print_job_set_scale: + * @job: a #GtkPrintJob + * @scale: the scale + * + * Sets the scale for this job (where 1.0 means unscaled). + * + * Since: 3.0 + */ +void +gtk_print_job_set_scale (GtkPrintJob *job, + gdouble scale) +{ + job->priv->scale = scale; +} + +/** + * gtk_print_job_get_n_up: + * @job: a #GtkPrintJob + * + * Gets the n-up setting for this job. + * + * Returns: the n-up setting + * + * Since: 3.0 + */ +guint +gtk_print_job_get_n_up (GtkPrintJob *job) +{ + return job->priv->number_up; +} + +/** + * gtk_print_job_set_n_up: + * @job: a #GtkPrintJob + * @n_up: the n-up value + * + * Sets the n-up setting for this job. + * + * Since: 3.0 + */ +void +gtk_print_job_set_n_up (GtkPrintJob *job, + guint n_up) +{ + job->priv->number_up = n_up; +} + +/** + * gtk_print_job_get_n_up_layout: + * @job: a #GtkPrintJob + * + * Gets the n-up layout setting for this job. + * + * Returns: the n-up layout + * + * Since: 3.0 + */ +GtkNumberUpLayout +gtk_print_job_get_n_up_layout (GtkPrintJob *job) +{ + return job->priv->number_up_layout; +} + +/** + * gtk_print_job_set_n_up_layout: + * @job: a #GtkPrintJob + * @layout: the n-up layout setting + * + * Sets the n-up layout setting for this job. + * + * Since: 3.0 + */ +void +gtk_print_job_set_n_up_layout (GtkPrintJob *job, + GtkNumberUpLayout layout) +{ + job->priv->number_up_layout = layout; +} + +/** + * gtk_print_job_get_rotate: + * @job: a #GtkPrintJob + * + * Gets whether the job is printed rotated. + * + * Returns: whether the job is printed rotated + * + * Since: 3.0 + */ +gboolean +gtk_print_job_get_rotate (GtkPrintJob *job) +{ + return job->priv->rotate_to_orientation; +} + +/** + * gtk_print_job_set_rotate: + * @job: a #GtkPrintJob + * @rotate: whether to print rotated + * + * Sets whether this job is printed rotated. + * + * Since: 3.0 + */ +void +gtk_print_job_set_rotate (GtkPrintJob *job, + gboolean rotate) +{ + job->priv->rotate_to_orientation = rotate; +} + +/** + * gtk_print_job_get_collate: + * @job: a #GtkPrintJob + * + * Gets whether this job is printed collated. + * + * Returns: whether the job is printed collated + * + * Since: 3.0 + */ +gboolean +gtk_print_job_get_collate (GtkPrintJob *job) +{ + return job->priv->collate; } -#define __GTK_PRINT_JOB_C__ -#include "gtkaliasdef.c" +/** + * gtk_print_job_set_collate: + * @job: a #GtkPrintJob + * @collate: whether the job is printed collated + * + * Sets whether this job is printed collated. + * + * Since: 3.0 + */ +void +gtk_print_job_set_collate (GtkPrintJob *job, + gboolean collate) +{ + job->priv->collate = collate; +} + +/** + * gtk_print_job_get_reverse: + * @job: a #GtkPrintJob + * + * Gets whether this job is printed reversed. + * + * Returns: whether the job is printed reversed. + * + * Since: 3.0 + */ +gboolean +gtk_print_job_get_reverse (GtkPrintJob *job) +{ + return job->priv->reverse; +} + +/** + * gtk_print_job_set_reverse: + * @job: a #GtkPrintJob + * @reverse: whether the job is printed reversed + * + * Sets whether this job is printed reversed. + * + * Since: 3.0 + */ +void +gtk_print_job_set_reverse (GtkPrintJob *job, + gboolean reverse) +{ + job->priv->reverse = reverse; +}