Oyranos
git-devel
Oyranos is a full featured Color Management System
|
A basic filter to manipulate data. More...
#include <oyFilterCore_s.h>
Public Member Functions | |
OYAPI oyFilterCore_s *OYEXPORT | oyFilterCore_New (oyObject_s object) |
allocate a new FilterCore object More... | |
OYAPI oyFilterCore_s *OYEXPORT | oyFilterCore_Copy (oyFilterCore_s *filtercore, oyObject_s object) |
Copy or Reference a FilterCore object. More... | |
OYAPI int OYEXPORT | oyFilterCore_Release (oyFilterCore_s **filtercore) |
release and possibly deallocate a oyFilterCore_s object More... | |
const char * | oyFilterCore_GetCategory (oyFilterCore_s *filter, int nontranslated OY_UNUSED) |
Get category string. More... | |
const char * | oyFilterCore_GetName (oyFilterCore_s *filter, oyNAME_e name_type) |
Get name. More... | |
const char * | oyFilterCore_GetText (oyFilterCore_s *filter, oyNAME_e name_type) |
Get text. More... | |
oyFilterCore_s * | oyFilterCore_NewWith (const char *registration, oyOptions_s *options, oyObject_s object) |
Lookup and initialise a new filter object. More... | |
OYAPI const char *OYEXPORT | oyFilterCore_GetRegistration (oyFilterCore_s *filter) |
Get registration text. More... | |
OYAPI int OYEXPORT | oyFilterCore_SetBackendContext (oyFilterCore_s *obj, oyPointer_s *ptr) |
set backend specific runtime data More... | |
OYAPI oyPointer_s *OYEXPORT | oyFilterCore_GetBackendContext (oyFilterCore_s *obj) |
get backend specific runtime data More... | |
void | oyFilterCore_Release__Members (oyFilterCore_s_ *filtercore) |
Custom FilterCore destructor. More... | |
int | oyFilterCore_Init__Members (oyFilterCore_s_ *filtercore OY_UNUSED) |
Custom FilterCore constructor. More... | |
int | oyFilterCore_Copy__Members (oyFilterCore_s_ *dst, oyFilterCore_s_ *src) |
Custom FilterCore copy constructor. More... | |
int | oyFilterCore_SetCMMapi4_ (oyFilterCore_s_ *s, oyCMMapi4_s_ *cmm_api4) |
Lookup and initialise a new filter 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... | |
int | oyStruct_RegisterStaticMessageFunc (int type, oyStruct_RegisterStaticMessageFunc_f msg, oyStruct_RegisterStaticFreeFunc_f free_func) |
register a function for verbosity More... | |
const char * | oyStruct_GetInfo (oyPointer context_object, oyNAME_e type, int flags) |
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... | |
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... | |
A basic filter to manipulate data.
This is the Oyranos filter object. Filters are categorised into basic classes of filters described in the Registration (//xxx) member. Filters implement a container for data and options. Filters can be manipulated by changing their options or data set.
Filters are chained into a oyConversion_s in order to get applied to data. The relation of filters in a graph is defined through the oyFilterNode_s struct.
It is possible to chain filters in different ways together. The aimed way here is to use members and queries to find possible connections. For instance a one in one out filter can not be connected to two sources at once.
The Registration describes different basic types of filters (//xxx).
OYAPI oyFilterCore_s *OYEXPORT oyFilterCore_Copy | ( | oyFilterCore_s * | filtercore, |
oyObject_s | object | ||
) |
Copy or Reference a FilterCore object.
Function oyFilterCore_Copy
The function is for copying and for referencing. The reference is the most often used way, which saves resourcs and time.
[in] | filtercore | FilterCore struct object |
object | NULL - means reference, the optional object triggers a real copy |
int oyFilterCore_Copy__Members | ( | oyFilterCore_s_ * | dst, |
oyFilterCore_s_ * | src | ||
) |
Custom FilterCore copy constructor.
Function oyFilterCore_Copy__Members
OYAPI oyPointer_s *OYEXPORT oyFilterCore_GetBackendContext | ( | oyFilterCore_s * | obj | ) |
get backend specific runtime data
Backend context is used by a filter type during execution.
[in] | obj | the node object |
const char * oyFilterCore_GetCategory | ( | oyFilterCore_s * | filter, |
int nontranslated | OY_UNUSED | ||
) |
Get category string.
Function oyFilterCore_GetCategory
[in,out] | filter | filter object |
nontranslated | switch for translation; not implemented |
const char * oyFilterCore_GetName | ( | oyFilterCore_s * | filter, |
oyNAME_e | name_type | ||
) |
Get name.
Function oyFilterCore_GetName
provides the original filter names
[in,out] | filter | filter object |
name_type | type of name |
OYAPI const char *OYEXPORT oyFilterCore_GetRegistration | ( | oyFilterCore_s * | filter | ) |
Get registration text.
Function oyFilterCore_GetRegistration
[in] | filter | filter object |
const char * oyFilterCore_GetText | ( | oyFilterCore_s * | filter, |
oyNAME_e | name_type | ||
) |
Get text.
Function oyFilterCore_GetText
oyNAME_NAME provides a XML element with child elements and attributes
[in,out] | filter | filter object |
name_type | type of name |
int oyFilterCore_Init__Members | ( | oyFilterCore_s_ *filtercore | OY_UNUSED | ) |
Custom FilterCore constructor.
Function oyFilterCore_Init__Members
OYAPI oyFilterCore_s *OYEXPORT oyFilterCore_New | ( | oyObject_s | object | ) |
allocate a new FilterCore object
Function oyFilterCore_New
oyFilterCore_s * oyFilterCore_NewWith | ( | const char * | registration, |
oyOptions_s * | options, | ||
oyObject_s | object | ||
) |
Lookup and initialise a new filter object.
Function oyFilterCore_NewWith
back end selection:
[in] | registration | the filter Registration pattern |
[in] | options | the supplied filter options |
[in] | object | the optional object |
Referenced by oyFilterNode_s::oyFilterNode_NewWith().
OYAPI int OYEXPORT oyFilterCore_Release | ( | oyFilterCore_s ** | filtercore | ) |
release and possibly deallocate a oyFilterCore_s object
Function oyFilterCore_Release
[in,out] | filtercore | FilterCore struct object |
Referenced by oyFilterNode_s::oyFilterNode_NewWith().
void oyFilterCore_Release__Members | ( | oyFilterCore_s_ * | filtercore | ) |
Custom FilterCore destructor.
Function oyFilterCore_Release__Members
OYAPI int OYEXPORT oyFilterCore_SetBackendContext | ( | oyFilterCore_s * | obj, |
oyPointer_s * | ptr | ||
) |
set backend specific runtime data
Runtime data can be used as context by a backend during execution. The data is typical set during oyCMMapi4_s creation. This function provides access for a backend inside a DAC in order to change that data during backend lifetime.
[in,out] | obj | the node object |
[in] | ptr | the data needed to run the filter type |
int oyFilterCore_SetCMMapi4_ | ( | oyFilterCore_s_ * | s, |
oyCMMapi4_s_ * | cmm_api4 | ||
) |
Lookup and initialise a new filter object.
Function oyFilterCore_SetCMMapi4_
oyStruct_Copy_f oyFilterCore_s::copy |
Copy function.
oyObject_s oyFilterCore_s::oy_ |
Oyranos internal object.
Features name and hash. Do not change during object life time.
oyStruct_Release_f oyFilterCore_s::release |
Release function.
const oyOBJECT_e oyFilterCore_s::type_ |
Type of object.
The struct type tells Oyranos how to interprete hidden fields.