← Back to branch summary

~ubuntu-branches/ubuntu/vivid/rawstudio/vivid

« back to all changes in this revision

Viewing changes to librawstudio/rs-job-queue.h

  • Committer: Bazaar Package Importer
  • Author(s): Bernd Zeimetz
  • Date: 2011-07-28 17:36:32 UTC
  • mfrom: (2.1.11 upstream)
  • Revision ID: james.westby@ubuntu.com-20110728173632-5czluz9ye3c83zc5
Tags: 2.0-1
* [3750b2cf] Merge commit 'upstream/2.0'
* [63637468] Removing Patch, not necessary anymore.
* [2fb580dc] Add new build-dependencies.
* [c57d953b] Run dh_autoreconf due to patches in configure.in
* [13febe39] Add patch to remove the libssl requirement.
* [5ae773fe] Replace libjpeg62-dev by libjpeg8-dev :)
* [1969d755] Don't build static libraries.
* [7cfe0a2e] Add a patch to fix the plugin directory path.
  As plugins are shared libraries, they need to go into /usr/lib,
  not into /usr/share.
  Thanks to Andrew McMillan
* [c1d0d9dd] Don't install .la files for all plugins and libraries.

Show diffs side-by-side

added added

removed removed

Lines of Context:
librawstudio/rs-job-queue.h
 
1
/*
 
2
 * * Copyright (C) 2006-2011 Anders Brander <anders@brander.dk>, 
 
3
 * * Anders Kvist <akv@lnxbx.dk> and Klaus Post <klauspost@gmail.com>
 
4
 *
 
5
 * This program is free software; you can redistribute it and/or
 
6
 * modify it under the terms of the GNU General Public License
 
7
 * as published by the Free Software Foundation; either version 2
 
8
 * of the License, or (at your option) any later version.
 
9
 *
 
10
 * This program is distributed in the hope that it will be useful,
 
11
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 
12
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
13
 * GNU General Public License for more details.
 
14
 *
 
15
 * You should have received a copy of the GNU General Public License
 
16
 * along with this program; if not, write to the Free Software
 
17
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 
18
 */
 
19
 
 
20
#ifndef RS_JOB_QUEUE_H
 
21
#define RS_JOB_QUEUE_H
 
22
 
 
23
#include <glib-object.h>
 
24
 
 
25
G_BEGIN_DECLS
 
26
 
 
27
#define RS_TYPE_JOB_QUEUE rs_job_queue_get_type()
 
28
#define RS_JOB_QUEUE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), RS_TYPE_JOB_QUEUE, RSJobQueue))
 
29
#define RS_JOB_QUEUE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), RS_TYPE_JOB_QUEUE, RSJobQueueClass))
 
30
#define RS_IS_JOB_QUEUE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), RS_TYPE_JOB_QUEUE))
 
31
#define RS_IS_JOB_QUEUE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), RS_TYPE_JOB_QUEUE))
 
32
#define RS_JOB_QUEUE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), RS_TYPE_JOB_QUEUE, RSJobQueueClass))
 
33
 
 
34
typedef struct _RSJobQueueSlot RSJobQueueSlot;
 
35
typedef struct _RSJob RSJob;
 
36
typedef struct _RSJobQueue RSJobQueue;
 
37
 
 
38
typedef struct {
 
39
        GObjectClass parent_class;
 
40
} RSJobQueueClass;
 
41
 
 
42
typedef gpointer (*RSJobFunc)(RSJobQueueSlot *, gpointer);
 
43
 
 
44
GType rs_job_queue_get_type(void);
 
45
 
 
46
/**
 
47
 * Add a new job to the job queue
 
48
 * @note When func is called, it WILL be from another thread, it may be
 
49
 *       required to acquire the GDK lock if any GTK+ stuff is done in the
 
50
 *       callback!
 
51
 * @param func A function to call for performing the job
 
52
 * @param data Data to pass to func
 
53
 * @param waitable If TRUE, rs_job_queue_wait() will wait until completion
 
54
 */
 
55
RSJob *
 
56
rs_job_queue_add_job(RSJobFunc func, gpointer data, gboolean waitable);
 
57
 
 
58
/**
 
59
 * Wait (hang) until a job is finished and then free the memory allocated to job
 
60
 * @param job The RSJob to wait for
 
61
 * @return The value returned by the func given to rs_job_queue_add()
 
62
 */
 
63
gpointer
 
64
rs_job_queue_wait(RSJob *job);
 
65
 
 
66
/**
 
67
 * Update the job description
 
68
 * @note You should NOT have aquired the GDK thread lock when calling this
 
69
 *       function.
 
70
 * @param slot A job_slot as recieved in the job callback function
 
71
 * @param description The new description or NULL to show nothing
 
72
 */
 
73
void
 
74
rs_job_update_description(RSJobQueueSlot *slot, const gchar *description);
 
75
 
 
76
/**
 
77
 * Update the job progress bar
 
78
 * @note You should NOT have aquired the GDK thread lock when calling this
 
79
 *       function.
 
80
 * @param slot A job_slot as recieved in the job callback function
 
81
 * @param fraction A value between 0.0 and 1.0 to set the progress bar at
 
82
 *                 the specific fraction or -1.0 to pulse the progress bar.
 
83
 */
 
84
void
 
85
rs_job_update_progress(RSJobQueueSlot *slot, const gdouble fraction);
 
86
 
 
87
G_END_DECLS
 
88
 
 
89
#endif /* RS_JOB_QUEUE_H */