gtk2/gtk/gtkprintjob.c
2020-08-21 15:29:34 +02:00

976 lines
23 KiB
C
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/* GtkPrintJob
* Copyright (C) 2006 John (J5) Palmieri <johnp@redhat.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, see <http://www.gnu.org/licenses/>.
*/
/**
* SECTION:gtkprintjob
* @Title: GtkPrintJob
* @Short_description: Represents a print job
* @Include: gtk/gtkunixprint.h
*
* 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 dont use cairo
* #GtkPrintJob also supports printing of manually generated postscript,
* via gtk_print_job_set_source_file().
*/
#include "config.h"
#include <stdlib.h>
#include <string.h>
#include <stdio.h>
#include <fcntl.h>
#include <errno.h>
#ifdef HAVE_UNISTD_H
#include <unistd.h>
#endif
#include <sys/types.h>
#include <sys/stat.h>
#include <glib/gstdio.h>
#include "gtkintl.h"
#include "gtkprivate.h"
#include "gtkprintjob.h"
#include "gtkprinter.h"
#include "gtkprinterprivate.h"
#include "gtkprintbackendprivate.h"
#ifndef O_BINARY
#define O_BINARY 0
#endif
typedef struct _GtkPrintJobClass GtkPrintJobClass;
struct _GtkPrintJob
{
GObject parent_instance;
char *title;
GIOChannel *spool_io;
cairo_surface_t *surface;
GtkPrintStatus status;
GtkPrintBackend *backend;
GtkPrinter *printer;
GtkPrintSettings *settings;
GtkPageSetup *page_setup;
GtkPrintPages print_pages;
GtkPageRange *page_ranges;
int num_page_ranges;
GtkPageSet page_set;
int num_copies;
double 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;
};
struct _GtkPrintJobClass
{
GObjectClass parent_class;
void (*status_changed) (GtkPrintJob *job);
};
static void gtk_print_job_finalize (GObject *object);
static void gtk_print_job_set_property (GObject *object,
guint prop_id,
const GValue *value,
GParamSpec *pspec);
static void gtk_print_job_get_property (GObject *object,
guint prop_id,
GValue *value,
GParamSpec *pspec);
static void gtk_print_job_constructed (GObject *object);
enum {
STATUS_CHANGED,
LAST_SIGNAL
};
enum {
PROP_0,
PROP_TITLE,
PROP_PRINTER,
PROP_PAGE_SETUP,
PROP_SETTINGS,
PROP_TRACK_PRINT_STATUS
};
static guint signals[LAST_SIGNAL] = { 0 };
G_DEFINE_TYPE (GtkPrintJob, gtk_print_job, G_TYPE_OBJECT)
static void
gtk_print_job_class_init (GtkPrintJobClass *class)
{
GObjectClass *object_class;
object_class = (GObjectClass *) class;
object_class->finalize = gtk_print_job_finalize;
object_class->constructed = gtk_print_job_constructed;
object_class->set_property = gtk_print_job_set_property;
object_class->get_property = gtk_print_job_get_property;
g_object_class_install_property (object_class,
PROP_TITLE,
g_param_spec_string ("title",
P_("Title"),
P_("Title of the print job"),
NULL,
GTK_PARAM_READWRITE |
G_PARAM_CONSTRUCT_ONLY));
g_object_class_install_property (object_class,
PROP_PRINTER,
g_param_spec_object ("printer",
P_("Printer"),
P_("Printer to print the job to"),
GTK_TYPE_PRINTER,
GTK_PARAM_READWRITE |
G_PARAM_CONSTRUCT_ONLY));
g_object_class_install_property (object_class,
PROP_SETTINGS,
g_param_spec_object ("settings",
P_("Settings"),
P_("Printer settings"),
GTK_TYPE_PRINT_SETTINGS,
GTK_PARAM_READWRITE |
G_PARAM_CONSTRUCT_ONLY));
g_object_class_install_property (object_class,
PROP_PAGE_SETUP,
g_param_spec_object ("page-setup",
P_("Page Setup"),
P_("Page Setup"),
GTK_TYPE_PAGE_SETUP,
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
*
* Gets emitted when the status of a job changes. The signal handler
* can use gtk_print_job_get_status() to obtain the new status.
*/
signals[STATUS_CHANGED] =
g_signal_new (I_("status-changed"),
G_TYPE_FROM_CLASS (class),
G_SIGNAL_RUN_LAST,
G_STRUCT_OFFSET (GtkPrintJobClass, status_changed),
NULL, NULL,
NULL,
G_TYPE_NONE, 0);
}
static void
gtk_print_job_init (GtkPrintJob *job)
{
job->spool_io = NULL;
job->title = g_strdup ("");
job->surface = NULL;
job->backend = NULL;
job->printer = NULL;
job->printer_set = FALSE;
job->settings_set = FALSE;
job->page_setup_set = FALSE;
job->status = GTK_PRINT_STATUS_INITIAL;
job->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;
job->number_up = 1;
job->number_up_layout = GTK_NUMBER_UP_LAYOUT_LEFT_TO_RIGHT_TOP_TO_BOTTOM;
}
static void
gtk_print_job_constructed (GObject *object)
{
GtkPrintJob *job = GTK_PRINT_JOB (object);
G_OBJECT_CLASS (gtk_print_job_parent_class)->constructed (object);
g_assert (job->printer_set &&
job->settings_set &&
job->page_setup_set);
_gtk_printer_prepare_for_print (job->printer,
job,
job->settings,
job->page_setup);
}
static void
gtk_print_job_finalize (GObject *object)
{
GtkPrintJob *job = GTK_PRINT_JOB (object);
if (job->surface)
cairo_surface_destroy (job->surface);
if (job->backend)
g_object_unref (job->backend);
if (job->spool_io != NULL)
{
g_io_channel_unref (job->spool_io);
job->spool_io = NULL;
}
if (job->printer)
g_object_unref (job->printer);
if (job->settings)
g_object_unref (job->settings);
if (job->page_setup)
g_object_unref (job->page_setup);
g_free (job->page_ranges);
job->page_ranges = NULL;
g_free (job->title);
job->title = NULL;
G_OBJECT_CLASS (gtk_print_job_parent_class)->finalize (object);
}
/**
* gtk_print_job_new:
* @title: the job title
* @printer: a #GtkPrinter
* @settings: a #GtkPrintSettings
* @page_setup: a #GtkPageSetup
*
* Creates a new #GtkPrintJob.
*
* Returns: a new #GtkPrintJob
**/
GtkPrintJob *
gtk_print_job_new (const char *title,
GtkPrinter *printer,
GtkPrintSettings *settings,
GtkPageSetup *page_setup)
{
GObject *result;
result = g_object_new (GTK_TYPE_PRINT_JOB,
"title", title,
"printer", printer,
"settings", settings,
"page-setup", page_setup,
NULL);
return (GtkPrintJob *) result;
}
/**
* gtk_print_job_get_settings:
* @job: a #GtkPrintJob
*
* Gets the #GtkPrintSettings of the print job.
*
* Returns: (transfer none): the settings of @job
*/
GtkPrintSettings *
gtk_print_job_get_settings (GtkPrintJob *job)
{
g_return_val_if_fail (GTK_IS_PRINT_JOB (job), NULL);
return job->settings;
}
/**
* gtk_print_job_get_printer:
* @job: a #GtkPrintJob
*
* Gets the #GtkPrinter of the print job.
*
* Returns: (transfer none): the printer of @job
*/
GtkPrinter *
gtk_print_job_get_printer (GtkPrintJob *job)
{
g_return_val_if_fail (GTK_IS_PRINT_JOB (job), NULL);
return job->printer;
}
/**
* gtk_print_job_get_title:
* @job: a #GtkPrintJob
*
* Gets the job title.
*
* Returns: the title of @job
*/
const char *
gtk_print_job_get_title (GtkPrintJob *job)
{
g_return_val_if_fail (GTK_IS_PRINT_JOB (job), NULL);
return job->title;
}
/**
* gtk_print_job_get_status:
* @job: a #GtkPrintJob
*
* Gets the status of the print job.
*
* Returns: the status of @job
*/
GtkPrintStatus
gtk_print_job_get_status (GtkPrintJob *job)
{
g_return_val_if_fail (GTK_IS_PRINT_JOB (job), GTK_PRINT_STATUS_FINISHED);
return job->status;
}
void
gtk_print_job_set_status (GtkPrintJob *job,
GtkPrintStatus status)
{
g_return_if_fail (GTK_IS_PRINT_JOB (job));
if (job->status == status)
return;
job->status = status;
g_signal_emit (job, signals[STATUS_CHANGED], 0);
}
/**
* gtk_print_job_set_source_file:
* @job: a #GtkPrintJob
* @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). See
* gtk_printer_accepts_pdf() and gtk_printer_accepts_ps().
*
* Returns: %FALSE if an error occurred
**/
gboolean
gtk_print_job_set_source_file (GtkPrintJob *job,
const char *filename,
GError **error)
{
GError *tmp_error;
tmp_error = NULL;
g_return_val_if_fail (GTK_IS_PRINT_JOB (job), FALSE);
job->spool_io = g_io_channel_new_file (filename, "r", &tmp_error);
if (tmp_error == NULL)
g_io_channel_set_encoding (job->spool_io, NULL, &tmp_error);
if (tmp_error != NULL)
{
g_propagate_error (error, tmp_error);
return FALSE;
}
return TRUE;
}
/**
* gtk_print_job_set_source_fd:
* @job: a #GtkPrintJob
* @fd: a file descriptor
* @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). See
* gtk_printer_accepts_pdf() and gtk_printer_accepts_ps().
*
* This is similar to gtk_print_job_set_source_file(),
* but takes expects an open file descriptor for the file,
* instead of a filename.
*
* Returns: %FALSE if an error occurred
*/
gboolean
gtk_print_job_set_source_fd (GtkPrintJob *job,
int fd,
GError **error)
{
g_return_val_if_fail (GTK_IS_PRINT_JOB (job), FALSE);
g_return_val_if_fail (fd >= 0, FALSE);
job->spool_io = g_io_channel_unix_new (fd);
if (g_io_channel_set_encoding (job->spool_io, NULL, error) != G_IO_STATUS_NORMAL)
return FALSE;
return TRUE;
}
/**
* gtk_print_job_get_surface:
* @job: a #GtkPrintJob
* @error: (allow-none): return location for errors, or %NULL
*
* Gets a cairo surface onto which the pages of
* the print job should be rendered.
*
* Returns: (transfer none): the cairo surface of @job
**/
cairo_surface_t *
gtk_print_job_get_surface (GtkPrintJob *job,
GError **error)
{
char *filename = NULL;
double width, height;
GtkPaperSize *paper_size;
int fd;
GError *tmp_error;
tmp_error = NULL;
g_return_val_if_fail (GTK_IS_PRINT_JOB (job), NULL);
if (job->surface)
return job->surface;
g_return_val_if_fail (job->spool_io == NULL, 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 (fd, S_IRUSR | S_IWUSR);
#ifdef G_ENABLE_DEBUG
/* If we are debugging printing don't delete the tmp files */
if (GTK_DEBUG_CHECK (PRINTING)) ;
else
#endif /* G_ENABLE_DEBUG */
g_unlink (filename);
g_free (filename);
paper_size = gtk_page_setup_get_paper_size (job->page_setup);
width = gtk_paper_size_get_width (paper_size, GTK_UNIT_POINTS);
height = gtk_paper_size_get_height (paper_size, GTK_UNIT_POINTS);
job->spool_io = g_io_channel_unix_new (fd);
g_io_channel_set_close_on_unref (job->spool_io, TRUE);
g_io_channel_set_encoding (job->spool_io, NULL, &tmp_error);
if (tmp_error != NULL)
{
g_io_channel_unref (job->spool_io);
job->spool_io = NULL;
g_propagate_error (error, tmp_error);
return NULL;
}
job->surface = _gtk_printer_create_cairo_surface (job->printer,
job->settings,
width, height,
job->spool_io);
return job->surface;
}
/**
* gtk_print_job_set_track_print_status:
* @job: a #GtkPrintJob
* @track_status: %TRUE to track status after printing
*
* If track_status is %TRUE, the print job will try to continue report
* on the status of the print job in the printer queues and printer. This
* can allow your application to show things like “out of paper” issues,
* and when the print job actually reaches the printer.
*
* This function is often implemented using some form of polling, so it should
* not be enabled unless needed.
*/
void
gtk_print_job_set_track_print_status (GtkPrintJob *job,
gboolean track_status)
{
g_return_if_fail (GTK_IS_PRINT_JOB (job));
track_status = track_status != FALSE;
if (job->track_print_status != track_status)
{
job->track_print_status = track_status;
g_object_notify (G_OBJECT (job), "track-print-status");
}
}
/**
* gtk_print_job_get_track_print_status:
* @job: a #GtkPrintJob
*
* Returns whether jobs will be tracked after printing.
* For details, see gtk_print_job_set_track_print_status().
*
* Returns: %TRUE if print job status will be reported after printing
*/
gboolean
gtk_print_job_get_track_print_status (GtkPrintJob *job)
{
g_return_val_if_fail (GTK_IS_PRINT_JOB (job), FALSE);
return job->track_print_status;
}
static void
gtk_print_job_set_property (GObject *object,
guint prop_id,
const GValue *value,
GParamSpec *pspec)
{
GtkPrintJob *job = GTK_PRINT_JOB (object);
GtkPrintSettings *settings;
switch (prop_id)
{
case PROP_TITLE:
g_free (job->title);
job->title = g_value_dup_string (value);
break;
case PROP_PRINTER:
job->printer = GTK_PRINTER (g_value_dup_object (value));
job->printer_set = TRUE;
job->backend = g_object_ref (gtk_printer_get_backend (job->printer));
break;
case PROP_PAGE_SETUP:
job->page_setup = GTK_PAGE_SETUP (g_value_dup_object (value));
job->page_setup_set = TRUE;
break;
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));
job->settings = gtk_print_settings_copy (settings);
job->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;
}
}
static void
gtk_print_job_get_property (GObject *object,
guint prop_id,
GValue *value,
GParamSpec *pspec)
{
GtkPrintJob *job = GTK_PRINT_JOB (object);
switch (prop_id)
{
case PROP_TITLE:
g_value_set_string (value, job->title);
break;
case PROP_PRINTER:
g_value_set_object (value, job->printer);
break;
case PROP_SETTINGS:
g_value_set_object (value, job->settings);
break;
case PROP_PAGE_SETUP:
g_value_set_object (value, job->page_setup);
break;
case PROP_TRACK_PRINT_STATUS:
g_value_set_boolean (value, job->track_print_status);
break;
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
break;
}
}
/**
* gtk_print_job_send:
* @job: a GtkPrintJob
* @callback: function to call when the job completes or an error occurs
* @user_data: (closure): user data that gets passed to @callback
* @dnotify: destroy notify for @user_data
*
* Sends the print job off to the printer.
**/
void
gtk_print_job_send (GtkPrintJob *job,
GtkPrintJobCompleteFunc callback,
gpointer user_data,
GDestroyNotify dnotify)
{
g_return_if_fail (GTK_IS_PRINT_JOB (job));
g_return_if_fail (job->spool_io != NULL);
gtk_print_job_set_status (job, GTK_PRINT_STATUS_SENDING_DATA);
g_io_channel_seek_position (job->spool_io, 0, G_SEEK_SET, NULL);
gtk_print_backend_print_stream (job->backend, job,
job->spool_io,
callback, user_data, dnotify);
}
/**
* gtk_print_job_get_pages:
* @job: a #GtkPrintJob
*
* Gets the #GtkPrintPages setting for this job.
*
* Returns: the #GtkPrintPages setting
*/
GtkPrintPages
gtk_print_job_get_pages (GtkPrintJob *job)
{
return job->print_pages;
}
/**
* gtk_print_job_set_pages:
* @job: a #GtkPrintJob
* @pages: the #GtkPrintPages setting
*
* Sets the #GtkPrintPages setting for this job.
*/
void
gtk_print_job_set_pages (GtkPrintJob *job,
GtkPrintPages pages)
{
job->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
*/
GtkPageRange *
gtk_print_job_get_page_ranges (GtkPrintJob *job,
int *n_ranges)
{
*n_ranges = job->num_page_ranges;
return job->page_ranges;
}
/**
* gtk_print_job_set_page_ranges:
* @job: a #GtkPrintJob
* @ranges: (array length=n_ranges) (transfer full): pointer to an array of
* #GtkPageRange structs
* @n_ranges: the length of the @ranges array
*
* Sets the page ranges for this job.
*/
void
gtk_print_job_set_page_ranges (GtkPrintJob *job,
GtkPageRange *ranges,
int n_ranges)
{
g_free (job->page_ranges);
job->page_ranges = ranges;
job->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
*/
GtkPageSet
gtk_print_job_get_page_set (GtkPrintJob *job)
{
return job->page_set;
}
/**
* gtk_print_job_set_page_set:
* @job: a #GtkPrintJob
* @page_set: a #GtkPageSet setting
*
* Sets the #GtkPageSet setting for this job.
*/
void
gtk_print_job_set_page_set (GtkPrintJob *job,
GtkPageSet page_set)
{
job->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
*/
int
gtk_print_job_get_num_copies (GtkPrintJob *job)
{
return job->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.
*/
void
gtk_print_job_set_num_copies (GtkPrintJob *job,
int num_copies)
{
job->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
*/
double
gtk_print_job_get_scale (GtkPrintJob *job)
{
return job->scale;
}
/**
* gtk_print_job_set_scale:
* @job: a #GtkPrintJob
* @scale: the scale
*
* Sets the scale for this job (where 1.0 means unscaled).
*/
void
gtk_print_job_set_scale (GtkPrintJob *job,
double scale)
{
job->scale = scale;
}
/**
* gtk_print_job_get_n_up:
* @job: a #GtkPrintJob
*
* Gets the n-up setting for this job.
*
* Returns: the n-up setting
*/
guint
gtk_print_job_get_n_up (GtkPrintJob *job)
{
return job->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.
*/
void
gtk_print_job_set_n_up (GtkPrintJob *job,
guint n_up)
{
job->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
*/
GtkNumberUpLayout
gtk_print_job_get_n_up_layout (GtkPrintJob *job)
{
return job->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.
*/
void
gtk_print_job_set_n_up_layout (GtkPrintJob *job,
GtkNumberUpLayout layout)
{
job->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
*/
gboolean
gtk_print_job_get_rotate (GtkPrintJob *job)
{
return job->rotate_to_orientation;
}
/**
* gtk_print_job_set_rotate:
* @job: a #GtkPrintJob
* @rotate: whether to print rotated
*
* Sets whether this job is printed rotated.
*/
void
gtk_print_job_set_rotate (GtkPrintJob *job,
gboolean rotate)
{
job->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
*/
gboolean
gtk_print_job_get_collate (GtkPrintJob *job)
{
return job->collate;
}
/**
* gtk_print_job_set_collate:
* @job: a #GtkPrintJob
* @collate: whether the job is printed collated
*
* Sets whether this job is printed collated.
*/
void
gtk_print_job_set_collate (GtkPrintJob *job,
gboolean collate)
{
job->collate = collate;
}
/**
* gtk_print_job_get_reverse:
* @job: a #GtkPrintJob
*
* Gets whether this job is printed reversed.
*
* Returns: whether the job is printed reversed.
*/
gboolean
gtk_print_job_get_reverse (GtkPrintJob *job)
{
return job->reverse;
}
/**
* gtk_print_job_set_reverse:
* @job: a #GtkPrintJob
* @reverse: whether the job is printed reversed
*
* Sets whether this job is printed reversed.
*/
void
gtk_print_job_set_reverse (GtkPrintJob *job,
gboolean reverse)
{
job->reverse = reverse;
}