![]() |
Oyranos Color Management System API - Version 0.9.6 |
the basic API interface More...
#include <oyCMMapi_s.h>
Public Types | |
typedef int(* | oyCMMInit_f) (oyStruct_s *filter) |
optional CMM init function More... | |
typedef int(* | oyCMMMessageFuncSet_f) (oyMessage_f message_func) |
optionaly sets a CMM message function More... | |
typedef int(* | oyCMMCanHandle_f) (oyCMMQUERY_e type, uint32_t value) |
CMM feature declaration function. More... | |
typedef const char *(* | oyCMMGetText_f) (const char *select, oyNAME_e type, oyStruct_s *context) |
get strings from a CMM More... | |
Public Member Functions | |
OYAPI oyCMMapi_s *OYEXPORT | oyCMMapi_New (oyObject_s object) |
allocate a new CMMapi object More... | |
oyCMMapi_Copy | |
Copy or Reference a CMMapi object. More... | |
OYAPI int OYEXPORT | oyCMMapi_Release (oyCMMapi_s **cmmapi) |
release and possibly deallocate a oyCMMapi_s object More... | |
void | oyCMMapi_Set (oyCMMapi_s *api, oyCMMInit_f init, oyCMMMessageFuncSet_f msg_set, const char *registration, int32_t version[3], int32_t module_api[3]) |
CMMapi member setter. More... | |
void | oyCMMapi_SetNext (oyCMMapi_s *api, oyCMMapi_s *next) |
chain CMMapi's More... | |
oyCMMapi_s * | oyCMMapi_GetNext (oyCMMapi_s *api) |
get next CMMapi More... | |
![]() | |
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 | |
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... | |
![]() | |
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... | |
the basic API interface
The registration should provide keywords for selection. The api5_ member is missed for oyCMMapi5_s.
oyCMMapi_Copy |
Copy or Reference a CMMapi object.
The function is for copying and for referencing. The reference is the most often used way, which saves resourcs and time.
[in] | cmmapi | CMMapi struct object |
object | NULL - means reference, the optional object triggers a real copy |
oyCMMapi_s * oyCMMapi_GetNext | ( | oyCMMapi_s * | api | ) |
get next CMMapi
Function oyCMMapi_GetNext
oyCMMapi_s forms a single linked list. The start must be set in oyCMMinfo_s to be parsed by the module loader.
api | the struct |
OYAPI oyCMMapi_s *OYEXPORT oyCMMapi_New | ( | oyObject_s | object | ) |
OYAPI int OYEXPORT oyCMMapi_Release | ( | oyCMMapi_s ** | cmmapi | ) |
release and possibly deallocate a oyCMMapi_s object
Function oyCMMapi_Release
[in,out] | cmmapi | CMMapi struct object |
References oyOBJECT_CMM_API_S.
void oyCMMapi_Set | ( | oyCMMapi_s * | api, |
oyCMMInit_f | init, | ||
oyCMMMessageFuncSet_f | msg_set, | ||
const char * | registration, | ||
int32_t | version[3], | ||
int32_t | module_api[3] | ||
) |
CMMapi member setter.
Function oyCMMapi_Set
api | the struct |
init | custom initialisation |
msg_set | message function setter |
registration | the modules Registration string, |
version | module version
|
module_api | tell compatibility with Oyranos API
|
void oyCMMapi_SetNext | ( | oyCMMapi_s * | api, |
oyCMMapi_s * | next | ||
) |
chain CMMapi's
Function oyCMMapi_SetNext
A oyCMMapi_s is initially not chained and will thus not be detected during parsing the oyCMMinfo_s structure. Append a CMMapi by searching for a empty place through oyCMMapi_s::oyCMMapi_GetNext ( api ) == NULL . Then append the new CMMapi with oyCMMapi_s::oyCMMapi_SetNext ( old_api, my_new_api ).
api | the struct |
next | struct to chain |
oyStruct_Copy_f oyCMMapi_s::copy |
Copy function.
oyObject_s oyCMMapi_s::oy_ |
Oyranos internal object.
Features name and hash. Do not change during object life time.
oyStruct_Release_f oyCMMapi_s::release |
Release function.
const oyOBJECT_e oyCMMapi_s::type_ |
Type of object.
The struct type tells Oyranos how to interprete hidden fields.
Referenced by oyCMMapis_s::oyCMMapis_MoveIn().