![]() |
Oyranos Color Management System API |
A FilterGraph object. More...
#include <oyFilterGraph_s.h>
Public Member Functions | |
OYAPI oyFilterGraph_s *OYEXPORT | oyFilterGraph_New (oyObject_s object) |
allocate a new FilterGraph object More... | |
OYAPI oyFilterGraph_s *OYEXPORT | oyFilterGraph_Copy (oyFilterGraph_s *filtergraph, oyObject_s object) |
copy or reference a FilterGraph object More... | |
OYAPI int OYEXPORT | oyFilterGraph_Release (oyFilterGraph_s **filtergraph) |
release and possibly deallocate a oyFilterGraph_s object More... | |
OYAPI oyFilterGraph_s *OYEXPORT | oyFilterGraph_FromNode (oyFilterNode_s *node, int flags) |
Get a graphs adjazency list. More... | |
OYAPI oyFilterNode_s *OYEXPORT | oyFilterGraph_GetNode (oyFilterGraph_s *graph, int pos, const char *registration, const char *mark) |
Select a node. More... | |
OYAPI int OYEXPORT | oyFilterGraph_CountNodes (oyFilterGraph_s *graph, const char *registration, const char *mark) |
Count nodes. More... | |
OYAPI oyFilterPlug_s *OYEXPORT | oyFilterGraph_GetEdge (oyFilterGraph_s *graph, int pos) |
Get edges. More... | |
OYAPI int OYEXPORT | oyFilterGraph_CountEdges (oyFilterGraph_s *graph) |
Count edges. More... | |
OYAPI int OYEXPORT | oyFilterGraph_PrepareContexts (oyFilterGraph_s *graph, int flags) |
Iterate over a filter graph and possibly prepare contexts. More... | |
OYAPI int OYEXPORT | oyFilterGraph_SetFromNode (oyFilterGraph_s *graph, oyFilterNode_s *node, const char *mark, int flags) |
Get a graphs adjazency list. More... | |
OYAPI oyOptions_s *OYEXPORT | oyFilterGraph_GetOptions (oyFilterGraph_s *graph) |
Get options. More... | |
OYAPI char *OYEXPORT | oyFilterGraph_ToText (oyFilterGraph_s *graph, oyFilterNode_s *input, oyFilterNode_s *output, const char *head_line, int reserved, oyAlloc_f allocateFunc) |
Text description of a graph. 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... | |
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... | |
A FilterGraph object.
OYAPI oyFilterGraph_s *OYEXPORT oyFilterGraph_Copy | ( | oyFilterGraph_s * | filtergraph, |
oyObject_s | object | ||
) |
copy or reference a FilterGraph object
Function oyFilterGraph_Copy
The function is for copying and for referencing. The reference is the most often used way, which saves resourcs and time.
[in] | filtergraph | FilterGraph struct object |
object | NULL - means reference, the optional object triggers a real copy |
References oyOBJECT_FILTER_GRAPH_S.
Referenced by oyPixelAccess_s::oyPixelAccess_GetGraph().
OYAPI int OYEXPORT oyFilterGraph_CountEdges | ( | oyFilterGraph_s * | graph | ) |
Count edges.
Function oyFilterGraph_CountEdges
[in] | graph | a filter graph |
References oyFilterPlugs_s::oyFilterPlugs_Count(), and oyOBJECT_FILTER_GRAPH_S.
OYAPI int OYEXPORT oyFilterGraph_CountNodes | ( | oyFilterGraph_s * | graph, |
const char * | registration, | ||
const char * | mark | ||
) |
Count nodes.
Function oyFilterGraph_CountNodes
[in] | graph | a filter graph |
[in] | registration | criterium to generate the matching list, or zero for no criterium |
[in] | mark | marking string to use as a selector |
References oyFilterNode_s::oyFilterNode_Release(), oyFilterNodes_s::oyFilterNodes_Count(), oyFilterNodes_s::oyFilterNodes_Get(), oyFilterRegistrationMatch(), oyOBJECT_FILTER_GRAPH_S, and oyOptions_s::oyOptions_FindString().
OYAPI oyFilterGraph_s *OYEXPORT oyFilterGraph_FromNode | ( | oyFilterNode_s * | node, |
int | flags | ||
) |
Get a graphs adjazency list.
Function oyFilterGraph_FromNode
[in] | node | filter node |
[in] | flags | - OY_INPUT omit input direction
|
References oyFilterGraph_New(), oyFilterGraph_SetFromNode(), and oyOBJECT_FILTER_NODE_S.
Referenced by oyConversion_s::oyConversion_GetGraph(), oyFilterSocket_s::oyFilterSocket_SignalToGraph(), and oyPixelAccess_s::oyPixelAccess_Create().
OYAPI oyFilterPlug_s *OYEXPORT oyFilterGraph_GetEdge | ( | oyFilterGraph_s * | graph, |
int | pos | ||
) |
Get edges.
Function oyFilterGraph_GetEdge
[in] | graph | a filter graph |
References oyFilterPlugs_s::oyFilterPlugs_Get(), and oyOBJECT_FILTER_GRAPH_S.
OYAPI oyFilterNode_s *OYEXPORT oyFilterGraph_GetNode | ( | oyFilterGraph_s * | graph, |
int | pos, | ||
const char * | registration, | ||
const char * | mark | ||
) |
Select a node.
Function oyFilterGraph_GetNode
[in] | graph | a filter graph |
[in] | pos | the position in a matching list, or -1 to select the first match |
[in] | registration | criterium to generate the matching list, or zero for no criterium |
[in] | mark | marking string to use as a selector |
References oyFilterNode_s::oyFilterNode_Release(), oyFilterNodes_s::oyFilterNodes_Count(), oyFilterNodes_s::oyFilterNodes_Get(), oyFilterRegistrationMatch(), oyOBJECT_FILTER_GRAPH_S, and oyOptions_s::oyOptions_FindString().
OYAPI oyOptions_s *OYEXPORT oyFilterGraph_GetOptions | ( | oyFilterGraph_s * | graph | ) |
Get options.
Function oyFilterGraph_GetOptions
[in] | graph | a filter graph |
References oyOBJECT_FILTER_GRAPH_S, and oyOptions_s::oyOptions_Copy().
OYAPI oyFilterGraph_s *OYEXPORT oyFilterGraph_New | ( | oyObject_s | object | ) |
allocate a new FilterGraph object
Function oyFilterGraph_New
References oyOBJECT_OBJECT_S.
Referenced by oyConversion_s::oyConversion_ToText(), and oyFilterGraph_FromNode().
OYAPI int OYEXPORT oyFilterGraph_PrepareContexts | ( | oyFilterGraph_s * | graph, |
int | flags | ||
) |
Iterate over a filter graph and possibly prepare contexts.
Function oyFilterGraph_PrepareContexts
[in,out] | graph | a filter graph |
[in] | flags | 1 - enforce a context preparation |
References oyFilterNode_s::oyFilterNode_Release(), oyFilterNodes_s::oyFilterNodes_Count(), oyFilterNodes_s::oyFilterNodes_Get(), oyOBJECT_FILTER_GRAPH_S, oyOption_s::oyOption_SetFromText(), and oyOptions_s::oyOptions_Find().
Referenced by oyConversion_s::oyConversion_RunPixels().
OYAPI int OYEXPORT oyFilterGraph_Release | ( | oyFilterGraph_s ** | filtergraph | ) |
release and possibly deallocate a oyFilterGraph_s object
Function oyFilterGraph_Release
[in,out] | filtergraph | FilterGraph struct object |
References oyOBJECT_FILTER_GRAPH_S.
Referenced by oyConversion_s::oyConversion_ToText(), and oyFilterSocket_s::oyFilterSocket_SignalToGraph().
OYAPI int OYEXPORT oyFilterGraph_SetFromNode | ( | oyFilterGraph_s * | graph, |
oyFilterNode_s * | node, | ||
const char * | mark, | ||
int | flags | ||
) |
Get a graphs adjazency list.
Function oyFilterGraph_SetFromNode
[in] | graph | a graph object |
[in] | node | filter node |
[in] | mark | a selection |
[in] | flags | - OY_INPUT omit input direction
|
References oyFilterNodes_s::oyFilterNodes_New(), oyFilterNodes_s::oyFilterNodes_Release(), oyFilterPlugs_s::oyFilterPlugs_New(), oyFilterPlugs_s::oyFilterPlugs_Release(), and oyOBJECT_FILTER_GRAPH_S.
Referenced by oyConversion_s::oyConversion_RunPixels(), oyConversion_s::oyConversion_ToText(), and oyFilterGraph_FromNode().
OYAPI char *OYEXPORT oyFilterGraph_ToText | ( | oyFilterGraph_s * | graph, |
oyFilterNode_s * | input, | ||
oyFilterNode_s * | output, | ||
const char * | head_line, | ||
int | reserved, | ||
oyAlloc_f | allocateFunc | ||
) |
Text description of a graph.
Function oyFilterGraph_ToText
[in] | graph | graphy object |
[in] | input | start node of a oyConversion_s |
[in] | output | end node and if present a switch to interprete input and output as start and end node of a oyConversion_s |
[in] | head_line | text for inclusion |
[in] | reserved | future format selector (dot, xml ...) |
[in] | allocateFunc | allocation function |
The function is more verbose with the oy_debug variable set.
References oyStruct_s::oy_, oyFilterSocket_s::oy_, oyFilterNode_s::oy_, oy_debug, OY_FILTEREDGE_CONNECTED, OY_SLASH_C, oyFilterCore_s::oyFilterCore_GetCategory(), oyFilterCore_s::oyFilterCore_Release(), oyFilterNode_s::oyFilterNode_EdgeCount(), oyFilterNode_s::oyFilterNode_GetContext(), oyFilterNode_s::oyFilterNode_GetCore(), oyFilterNode_s::oyFilterNode_GetId(), oyFilterNode_s::oyFilterNode_GetOptions(), oyFilterNode_s::oyFilterNode_GetRegistration(), oyFilterNode_s::oyFilterNode_GetSocket(), oyFilterNode_s::oyFilterNode_GetText(), oyFilterNode_s::oyFilterNode_Release(), oyFilterNodes_s::oyFilterNodes_Count(), oyFilterNodes_s::oyFilterNodes_Get(), oyFilterPlug_s::oyFilterPlug_Release(), oyFilterPlugs_s::oyFilterPlugs_Count(), oyFilterPlugs_s::oyFilterPlugs_Get(), oyFilterSocket_s::oyFilterSocket_GetData(), oyFilterSocket_s::oyFilterSocket_Release(), oyNAME_NICK, oyOBJECT_FILTER_GRAPH_S, oyOptions_s::oyOptions_GetText(), oyOptions_s::oyOptions_Release(), oyStructTypeToText(), oyStruct_s::release, and oyStruct_s::type_.
Referenced by oyConversion_s::oyConversion_ToText().
oyStruct_Copy_f oyFilterGraph_s::copy |
Copy function.
oyObject_s oyFilterGraph_s::oy_ |
Oyranos internal object.
Features name and hash. Do not change during object life time.
Referenced by oyPixelAccess_s::oyPixelAccess_Create().
oyStruct_Release_f oyFilterGraph_s::release |
Release function.
const oyOBJECT_e oyFilterGraph_s::type_ |
Type of object.
The struct type tells Oyranos how to interprete hidden fields.