libview/ev-jobs.h

   1 /* this file is part of evince, a gnome document viewer
   2  *
   3  *  Copyright (C) 2008 Carlos Garcia Campos <carlosgc@gnome.org>
   4  *  Copyright (C) 2005 Red Hat, Inc
   5  *
   6  * Evince is free software; you can redistribute it and/or modify it
   7  * under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; either version 2 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * Evince is distributed in the hope that it will be useful, but
  12  * WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program; if not, write to the Free Software
  18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
  19  */
  20
  21 #if !defined (__EV_EVINCE_VIEW_H_INSIDE__) && !defined (EVINCE_COMPILATION)
  22 #error "Only <evince-view.h> can be included directly."
  23 #endif
  24
  25 #ifndef __EV_JOBS_H__
  26 #define __EV_JOBS_H__
  27
  28 #include <gio/gio.h>
  29 #include <gtk/gtk.h>
  30
  31 #include <evince-document.h>
  32
  33 G_BEGIN_DECLS
  34
  35 typedef struct _EvJob EvJob;
  36 typedef struct _EvJobClass EvJobClass;
  37
  38 typedef struct _EvJobRender EvJobRender;
  39 typedef struct _EvJobRenderClass EvJobRenderClass;
  40
  41 typedef struct _EvJobThumbnail EvJobThumbnail;
  42 typedef struct _EvJobThumbnailClass EvJobThumbnailClass;
  43
  44 typedef struct _EvJobLinks EvJobLinks;
  45 typedef struct _EvJobLinksClass EvJobLinksClass;
  46
  47 typedef struct _EvJobAttachments EvJobAttachments;
  48 typedef struct _EvJobAttachmentsClass EvJobAttachmentsClass;
  49
  50 typedef struct _EvJobFonts EvJobFonts;
  51 typedef struct _EvJobFontsClass EvJobFontsClass;
  52
  53 typedef struct _EvJobLoad EvJobLoad;
  54 typedef struct _EvJobLoadClass EvJobLoadClass;
  55
  56 typedef struct _EvJobSave EvJobSave;
  57 typedef struct _EvJobSaveClass EvJobSaveClass;
  58
  59 typedef struct _EvJobFind EvJobFind;
  60 typedef struct _EvJobFindClass EvJobFindClass;
  61
  62 typedef struct _EvJobLayers EvJobLayers;
  63 typedef struct _EvJobLayersClass EvJobLayersClass;
  64
  65 typedef struct _EvJobExport EvJobExport;
  66 typedef struct _EvJobExportClass EvJobExportClass;
  67
  68 #define EV_TYPE_JOB                          (ev_job_get_type())
  69 #define EV_JOB(object)                       (G_TYPE_CHECK_INSTANCE_CAST((object), EV_TYPE_JOB, EvJob))
  70 #define EV_JOB_CLASS(klass)                  (G_TYPE_CHECK_CLASS_CAST((klass), EV_TYPE_JOB, EvJobClass))
  71 #define EV_IS_JOB(object)                    (G_TYPE_CHECK_INSTANCE_TYPE((object), EV_TYPE_JOB))
  72 #define EV_JOB_GET_CLASS(object)             (G_TYPE_INSTANCE_GET_CLASS((object), EV_TYPE_JOB, EvJobClass))
  73
  74 #define EV_TYPE_JOB_LINKS                    (ev_job_links_get_type())
  75 #define EV_JOB_LINKS(object)                 (G_TYPE_CHECK_INSTANCE_CAST((object), EV_TYPE_JOB_LINKS, EvJobLinks))
  76 #define EV_JOB_LINKS_CLASS(klass)            (G_TYPE_CHECK_CLASS_CAST((klass), EV_TYPE_JOB_LINKS, EvJobLinksClass))
  77 #define EV_IS_JOB_LINKS(object)              (G_TYPE_CHECK_INSTANCE_TYPE((object), EV_TYPE_JOB_LINKS))
  78
  79 #define EV_TYPE_JOB_ATTACHMENTS              (ev_job_attachments_get_type())
  80 #define EV_JOB_ATTACHMENTS(object)           (G_TYPE_CHECK_INSTANCE_CAST((object), EV_TYPE_JOB_ATTACHMENTS, EvJobAttachments))
  81 #define EV_JOB_ATTACHMENTS_CLASS(klass)      (G_TYPE_CHECK_CLASS_CAST((klass), EV_TYPE_JOB_ATTACHMENTS, EvJobAttachmentsClass))
  82 #define EV_IS_JOB_ATTACHMENTS(object)        (G_TYPE_CHECK_INSTANCE_TYPE((object), EV_TYPE_JOB_ATTACHMENTS))
  83
  84 #define EV_TYPE_JOB_RENDER                   (ev_job_render_get_type())
  85 #define EV_JOB_RENDER(object)                (G_TYPE_CHECK_INSTANCE_CAST((object), EV_TYPE_JOB_RENDER, EvJobRender))
  86 #define EV_JOB_RENDER_CLASS(klass)           (G_TYPE_CHECK_CLASS_CAST((klass), EV_TYPE_JOB_RENDER, EvJobRenderClass))
  87 #define EV_IS_JOB_RENDER(object)             (G_TYPE_CHECK_INSTANCE_TYPE((object), EV_TYPE_JOB_RENDER))
  88
  89 #define EV_TYPE_JOB_THUMBNAIL                (ev_job_thumbnail_get_type())
  90 #define EV_JOB_THUMBNAIL(object)             (G_TYPE_CHECK_INSTANCE_CAST((object), EV_TYPE_JOB_THUMBNAIL, EvJobThumbnail))
  91 #define EV_JOB_THUMBNAIL_CLASS(klass)        (G_TYPE_CHECK_CLASS_CAST((klass), EV_TYPE_JOB_THUMBNAIL, EvJobThumbnailClass))
  92 #define EV_IS_JOB_THUMBNAIL(object)          (G_TYPE_CHECK_INSTANCE_TYPE((object), EV_TYPE_JOB_THUMBNAIL))
  93
  94 #define EV_TYPE_JOB_FONTS                    (ev_job_fonts_get_type())
  95 #define EV_JOB_FONTS(object)                 (G_TYPE_CHECK_INSTANCE_CAST((object), EV_TYPE_JOB_FONTS, EvJobFonts))
  96 #define EV_JOB_FONTS_CLASS(klass)            (G_TYPE_CHECK_CLASS_CAST((klass), EV_TYPE_JOB_FONTS, EvJobFontsClass))
  97 #define EV_IS_JOB_FONTS(object)              (G_TYPE_CHECK_INSTANCE_TYPE((object), EV_TYPE_JOB_FONTS))
  98
  99 #define EV_TYPE_JOB_LOAD                     (ev_job_load_get_type())
 100 #define EV_JOB_LOAD(object)                  (G_TYPE_CHECK_INSTANCE_CAST((object), EV_TYPE_JOB_LOAD, EvJobLoad))
 101 #define EV_JOB_LOAD_CLASS(klass)             (G_TYPE_CHECK_CLASS_CAST((klass), EV_TYPE_JOB_LOAD, EvJobLoadClass))
 102 #define EV_IS_JOB_LOAD(object)               (G_TYPE_CHECK_INSTANCE_TYPE((object), EV_TYPE_JOB_LOAD))
 103
 104 #define EV_TYPE_JOB_SAVE                     (ev_job_save_get_type())
 105 #define EV_JOB_SAVE(object)                  (G_TYPE_CHECK_INSTANCE_CAST((object), EV_TYPE_JOB_SAVE, EvJobSave))
 106 #define EV_JOB_SAVE_CLASS(klass)             (G_TYPE_CHECK_CLASS_CAST((klass), EV_TYPE_JOB_SAVE, EvJobSaveClass))
 107 #define EV_IS_JOB_SAVE(object)               (G_TYPE_CHECK_INSTANCE_TYPE((object), EV_TYPE_JOB_SAVE))
 108
 109 #define EV_TYPE_JOB_FIND                     (ev_job_find_get_type())
 110 #define EV_JOB_FIND(object)                  (G_TYPE_CHECK_INSTANCE_CAST((object), EV_TYPE_JOB_FIND, EvJobFind))
 111 #define EV_JOB_FIND_CLASS(klass)             (G_TYPE_CHECK_CLASS_CAST((klass), EV_TYPE_JOB_FIND, EvJobFindClass))
 112 #define EV_IS_JOB_FIND(object)               (G_TYPE_CHECK_INSTANCE_TYPE((object), EV_TYPE_JOB_FIND))
 113
 114 #define EV_TYPE_JOB_LAYERS                   (ev_job_layers_get_type())
 115 #define EV_JOB_LAYERS(object)                (G_TYPE_CHECK_INSTANCE_CAST((object), EV_TYPE_JOB_LAYERS, EvJobLayers))
 116 #define EV_JOB_LAYERS_CLASS(klass)           (G_TYPE_CHECK_CLASS_CAST((klass), EV_TYPE_JOB_LAYERS, EvJobLayersClass))
 117 #define EV_IS_JOB_LAYERS(object)             (G_TYPE_CHECK_INSTANCE_TYPE((object), EV_TYPE_JOB_LAYERS))
 118
 119 #define EV_TYPE_JOB_EXPORT                    (ev_job_export_get_type())
 120 #define EV_JOB_EXPORT(object)                 (G_TYPE_CHECK_INSTANCE_CAST((object), EV_TYPE_JOB_EXPORT, EvJobExport))
 121 #define EV_JOB_EXPORT_CLASS(klass)            (G_TYPE_CHECK_CLASS_CAST((klass), EV_TYPE_JOB_EXPORT, EvJobExportClass))
 122 #define EV_IS_JOB_EXPORT(object)              (G_TYPE_CHECK_INSTANCE_TYPE((object), EV_TYPE_JOB_EXPORT))
 123
 124 typedef enum {
 125         EV_JOB_RUN_THREAD,
 126         EV_JOB_RUN_MAIN_LOOP
 127 } EvJobRunMode;
 128
 129 struct _EvJob
 130 {
 131         GObject parent;
 132
 133         EvDocument *document;
 134
 135         EvJobRunMode run_mode;
 136
 137         guint cancelled : 1;
 138         guint finished : 1;
 139         guint failed : 1;
 140
 141         GError *error;
 142         GCancellable *cancellable;
 143
 144         guint idle_finished_id;
 145         guint idle_cancelled_id;
 146 };
 147
 148 struct _EvJobClass
 149 {
 150         GObjectClass parent_class;
 151
 152         gboolean (*run)         (EvJob *job);
 153
 154         /* Signals */
 155         void     (* cancelled)  (EvJob *job);
 156         void     (* finished)   (EvJob *job);
 157 };
 158
 159 struct _EvJobLinks
 160 {
 161         EvJob parent;
 162
 163         GtkTreeModel *model;
 164 };
 165
 166 struct _EvJobLinksClass
 167 {
 168         EvJobClass parent_class;
 169 };
 170
 171 struct _EvJobAttachments
 172 {
 173         EvJob parent;
 174
 175         GList *attachments;
 176 };
 177
 178 struct _EvJobAttachmentsClass
 179 {
 180         EvJobClass parent_class;
 181 };
 182
 183 typedef enum {
 184         EV_RENDER_INCLUDE_NONE      = 0,
 185         EV_RENDER_INCLUDE_LINKS     = 1 << 0,
 186         EV_RENDER_INCLUDE_TEXT      = 1 << 1,
 187         EV_RENDER_INCLUDE_SELECTION = 1 << 2,
 188         EV_RENDER_INCLUDE_IMAGES    = 1 << 3,
 189         EV_RENDER_INCLUDE_FORMS     = 1 << 4,
 190         EV_RENDER_INCLUDE_ALL       = (1 << 5) - 1
 191 } EvRenderFlags;
 192
 193 struct _EvJobRender
 194 {
 195         EvJob parent;
 196
 197         gint page;
 198         gint rotation;
 199         gdouble scale;
 200
 201         EvPage *ev_page;
 202         gboolean page_ready;
 203         gint target_width;
 204         gint target_height;
 205         cairo_surface_t *surface;
 206
 207         GList *link_mapping;
 208         GdkRegion *text_mapping;
 209         GList *image_mapping;
 210         GList *form_field_mapping;
 211
 212         cairo_surface_t *selection;
 213         GdkRegion *selection_region;
 214         EvRectangle selection_points;
 215         EvSelectionStyle selection_style;
 216         GdkColor base;
 217         GdkColor text;
 218
 219         EvRenderFlags flags;
 220 };
 221
 222 struct _EvJobRenderClass
 223 {
 224         EvJobClass parent_class;
 225
 226         void    (* page_ready) (EvJobRender *job);
 227 };
 228
 229 struct _EvJobThumbnail
 230 {
 231         EvJob parent;
 232
 233         gint page;
 234         gint rotation;
 235         gdouble scale;
 236
 237         GdkPixbuf *thumbnail;
 238 };
 239
 240 struct _EvJobThumbnailClass
 241 {
 242         EvJobClass parent_class;
 243 };
 244
 245 struct _EvJobFonts
 246 {
 247         EvJob parent;
 248         gboolean scan_completed;
 249 };
 250
 251 struct _EvJobFontsClass
 252 {
 253         EvJobClass parent_class;
 254
 255         /* Signals */
 256         void (* updated)  (EvJobFonts *job,
 257                            gdouble     progress);
 258 };
 259
 260 struct _EvJobLoad
 261 {
 262         EvJob parent;
 263
 264         gchar *uri;
 265         gchar *password;
 266 };
 267
 268 struct _EvJobLoadClass
 269 {
 270         EvJobClass parent_class;
 271 };
 272
 273 struct _EvJobSave
 274 {
 275         EvJob parent;
 276
 277         gchar *uri;
 278         gchar *document_uri;
 279 };
 280
 281 struct _EvJobSaveClass
 282 {
 283         EvJobClass parent_class;
 284 };
 285
 286 struct _EvJobFind
 287 {
 288         EvJob parent;
 289
 290         gint start_page;
 291         gint current_page;
 292         gint n_pages;
 293         GList **pages;
 294         gchar *text;
 295         gboolean case_sensitive;
 296         gboolean has_results;
 297 };
 298
 299 struct _EvJobFindClass
 300 {
 301         EvJobClass parent_class;
 302
 303         /* Signals */
 304         void (* updated)  (EvJobFind *job,
 305                            gint       page);
 306 };
 307
 308 struct _EvJobLayers
 309 {
 310         EvJob parent;
 311
 312         GtkTreeModel *model;
 313 };
 314
 315 struct _EvJobLayersClass
 316 {
 317         EvJobClass parent_class;
 318 };
 319
 320 struct _EvJobExport
 321 {
 322         EvJob parent;
 323
 324         gint page;
 325         EvRenderContext *rc;
 326 };
 327
 328 struct _EvJobExportClass
 329 {
 330         EvJobClass parent_class;
 331 };
 332
 333 /* Base job class */
 334 GType           ev_job_get_type           (void) G_GNUC_CONST;
 335 gboolean        ev_job_run                (EvJob          *job);
 336 void            ev_job_cancel             (EvJob          *job);
 337 void            ev_job_failed             (EvJob          *job,
 338                                            GQuark          domain,
 339                                            gint            code,
 340                                            const gchar    *format,
 341                                            ...);
 342 void            ev_job_failed_from_error  (EvJob          *job,
 343                                            GError         *error);
 344 void            ev_job_succeeded          (EvJob          *job);
 345 gboolean        ev_job_is_cancelled       (EvJob          *job);
 346 gboolean        ev_job_is_finished        (EvJob          *job);
 347 gboolean        ev_job_is_failed          (EvJob          *job);
 348 EvJobRunMode    ev_job_get_run_mode       (EvJob          *job);
 349 void            ev_job_set_run_mode       (EvJob          *job,
 350                                            EvJobRunMode    run_mode);
 351
 352 /* EvJobLinks */
 353 GType           ev_job_links_get_type     (void) G_GNUC_CONST;
 354 EvJob          *ev_job_links_new          (EvDocument     *document);
 355
 356 /* EvJobAttachments */
 357 GType           ev_job_attachments_get_type (void) G_GNUC_CONST;
 358 EvJob          *ev_job_attachments_new      (EvDocument     *document);
 359
 360 /* EvJobRender */
 361 GType           ev_job_render_get_type    (void) G_GNUC_CONST;
 362 EvJob          *ev_job_render_new         (EvDocument      *document,
 363                                            gint             page,
 364                                            gint             rotation,
 365                                            gdouble          scale,
 366                                            gint             width,
 367                                            gint             height,
 368                                            EvRenderFlags    flags);
 369 void     ev_job_render_set_selection_info (EvJobRender     *job,
 370                                            EvRectangle     *selection_points,
 371                                            EvSelectionStyle selection_style,
 372                                            GdkColor        *text,
 373                                            GdkColor        *base);
 374 /* EvJobThumbnail */
 375 GType           ev_job_thumbnail_get_type (void) G_GNUC_CONST;
 376 EvJob          *ev_job_thumbnail_new      (EvDocument      *document,
 377                                            gint             page,
 378                                            gint             rotation,
 379                                            gdouble          scale);
 380 /* EvJobFonts */
 381 GType           ev_job_fonts_get_type     (void) G_GNUC_CONST;
 382 EvJob          *ev_job_fonts_new          (EvDocument      *document);
 383
 384 /* EvJobLoad */
 385 GType           ev_job_load_get_type      (void) G_GNUC_CONST;
 386 EvJob          *ev_job_load_new           (const gchar     *uri);
 387 void            ev_job_load_set_uri       (EvJobLoad       *load,
 388                                            const gchar     *uri);
 389 void            ev_job_load_set_password  (EvJobLoad       *job,
 390                                            const gchar     *password);
 391
 392 /* EvJobSave */
 393 GType           ev_job_save_get_type      (void) G_GNUC_CONST;
 394 EvJob          *ev_job_save_new           (EvDocument      *document,
 395                                            const gchar     *uri,
 396                                            const gchar     *document_uri);
 397 /* EvJobFind */
 398 GType           ev_job_find_get_type      (void) G_GNUC_CONST;
 399 EvJob          *ev_job_find_new           (EvDocument      *document,
 400                                            gint             start_page,
 401                                            gint             n_pages,
 402                                            const gchar     *text,
 403                                            gboolean         case_sensitive);
 404 gint            ev_job_find_get_n_results (EvJobFind       *job,
 405                                            gint             pages);
 406 gdouble         ev_job_find_get_progress  (EvJobFind       *job);
 407 gboolean        ev_job_find_has_results   (EvJobFind       *job);
 408 GList         **ev_job_find_get_results   (EvJobFind       *job);
 409
 410 /* EvJobLayers */
 411 GType           ev_job_layers_get_type    (void) G_GNUC_CONST;
 412 EvJob          *ev_job_layers_new         (EvDocument     *document);
 413
 414 /* EvJobExport */
 415 GType           ev_job_export_get_type    (void) G_GNUC_CONST;
 416 EvJob          *ev_job_export_new         (EvDocument     *document);
 417 void            ev_job_export_set_page    (EvJobExport    *job,
 418                                            gint            page);
 419
 420 G_END_DECLS
 421
 422 #endif /* __EV_JOBS_H__ */