Oyranos Color Management System API - Version 0.9.6
Public Member Functions | Data Fields
oyJob_s Struct Reference

Asynchron job ticket. More...

#include <oyranos_threads.h>

Inheritance diagram for oyJob_s:
Inheritance graph
Collaboration diagram for oyJob_s:
Collaboration graph

Public Member Functions

void oyJobHandlingSet (oyJob_Add_f jadd, oyJob_Get_f jget, oyMsg_Add_f madd, oyJobResult_f result, const char *nick)
 Initialise the oyJob_s APIs. More...
 
 oyJob_New
 Allocate a new oyJob_s object. More...
 
 oyJob_Release
 Deallocate a oyJob_s object. More...
 
- Public Member Functions inherited from oyStruct_s
const char * oyStruct_GetTextFromModule (oyStruct_s *obj, oyNAME_e name_type, uint32_t flags)
 get object infos from a module More...
 
const char * oyStruct_GetText (oyStruct_s *obj, oyNAME_e name_type, uint32_t flags)
 Get a text dump. More...
 
 oyStruct_RegisterStaticMessageFunc
 register a function for verbosity More...
 
 oyStruct_GetInfo
 get a additional string from a object More...
 
const char * oyStructTypeToText (oyOBJECT_e type)
 Objects type to small string. More...
 

Data Fields

oyOBJECT_e type_
 oyOBJECT_JOB_S More...
 
oyStruct_Copy_f copy_not
 keep to zero; as it is dangerous in a threaded context More...
 
oyStruct_Release_f release
 Release function; optional. More...
 
oyObject_s oy_
 Oyranos internal object; not needed, keep to zero. More...
 
oyStruct_scontext
 the workload More...
 
int(* work )(oyJob_s *job)
 the working thread callback More...
 
int status_work_return
 return value of the work() function More...
 
int(* finish )(oyJob_s *job)
 the observating thread callback More...
 
oyJobCallback_f cb_progress
 the progress callback, called by observating thread More...
 
oyStruct_scb_progress_context
 the progress callback context More...
 
int id_
 
int thread_id_
 
int status_done_
 
oyJob_Add_f oyJob_Add = oyJob_AddInit
 Add one unique oyJob_s to the job qeue. More...
 
oyJob_Get_f oyJob_Get = oyJob_GetInit
 Get one unique oyJob_s from the job qeue. More...
 
oyMsg_Add_f oyMsg_Add = oyMsg_AddInit
 Add one unique message from the message qeue. More...
 
oyJobResult_f oyJobResult = oyJobResultInit
 Poll for new Jobs. More...
 
- Data Fields inherited from oyStruct_s
const oyOBJECT_e type_
 Type of object. More...
 
oyStruct_Copy_f copy
 Copy function. More...
 
oyStruct_Release_f release
 Release function. More...
 
oyObject_s oy_
 Oyranos internal object. More...
 

Detailed Description

Asynchron job ticket.

A generic job is added to the single job queue with oyJob_Add(). The job queue is worked on by an internal maintained thead.

Version
Oyranos: 0.9.6
Date
2016/05/01
Since
2014/01/27 (Oyranos: 0.9.5)

Field Documentation

oyJobCallback_f oyJob_s::cb_progress

the progress callback, called by observating thread

oyStruct_s* oyJob_s::cb_progress_context

the progress callback context

oyStruct_s* oyJob_s::context

the workload

oyStruct_Copy_f oyJob_s::copy_not

keep to zero; as it is dangerous in a threaded context

int(* oyJob_s::finish) (oyJob_s *job)

the observating thread callback

int oyJob_s::id_

Oyranos provided work ID, keep read only

oyObject_s oyJob_s::oy_

Oyranos internal object; not needed, keep to zero.

oyStruct_Release_f oyJob_s::release

Release function; optional.

int oyJob_s::status_done_

Oyranos internal variable

int oyJob_s::status_work_return

return value of the work() function

int oyJob_s::thread_id_

Oyranos provided ID; keep read only

oyOBJECT_e oyJob_s::type_

oyOBJECT_JOB_S

int(* oyJob_s::work) (oyJob_s *job)

the working thread callback