Oyranos  git-devel
Oyranos is a full featured Color Management System
Public Member Functions | Data Fields
oyFilterSocket_s Struct Reference

A filter connection structure. More...

#include <oyFilterSocket_s.h>

Inheritance diagram for oyFilterSocket_s:
Inheritance graph
Collaboration diagram for oyFilterSocket_s:
Collaboration graph

Public Member Functions

OYAPI oyFilterSocket_s *OYEXPORT oyFilterSocket_New (oyObject_s object)
 allocate a new FilterSocket object More...
 
OYAPI oyFilterSocket_s *OYEXPORT oyFilterSocket_Copy (oyFilterSocket_s *filtersocket, oyObject_s object)
 Copy or Reference a FilterSocket object. More...
 
OYAPI int OYEXPORT oyFilterSocket_Release (oyFilterSocket_s **filtersocket)
 release and possibly deallocate a oyFilterSocket_s object More...
 
OYAPI int OYEXPORT oyFilterSocket_Callback (oyFilterPlug_s *c, oyCONNECTOR_EVENT_e e)
 Tell about a oyConversion_s event. More...
 
OYAPI int OYEXPORT oyFilterSocket_SignalToGraph (oyFilterSocket_s *c, oyCONNECTOR_EVENT_e e)
 Send a signal through the graph. More...
 
OYAPI oyFilterNode_s *OYEXPORT oyFilterSocket_GetNode (oyFilterSocket_s *socket)
 Access oyFilterSocket_s::node. More...
 
OYAPI oyStruct_s *OYEXPORT oyFilterSocket_GetData (oyFilterSocket_s *socket)
 Access oyFilterSocket_s::data. More...
 
OYAPI int OYEXPORT oyFilterSocket_SetData (oyFilterSocket_s *socket, oyStruct_s *data)
 Set oyFilterSocket_s::data. More...
 
OYAPI oyFilterPlugs_s *OYEXPORT oyFilterSocket_GetPlugs (oyFilterSocket_s *socket)
 Access oyFilterSocket_s::requesting_plugs_. More...
 
OYAPI const char *OYEXPORT oyFilterSocket_GetRelatives (oyFilterSocket_s *socket)
 get short description of belonging filter More...
 
void oyFilterSocket_Release__Members (oyFilterSocket_s_ *filtersocket)
 Custom FilterSocket destructor. More...
 
int oyFilterSocket_Init__Members (oyFilterSocket_s_ *filtersocket OY_UNUSED)
 Custom FilterSocket constructor. More...
 
int oyFilterSocket_Copy__Members (oyFilterSocket_s_ *dst, oyFilterSocket_s_ *src)
 Custom FilterSocket copy constructor. 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...
 

Detailed Description

A filter connection structure.

The passive output version of a oyConnector_s.

Version
Oyranos: 0.1.8
Since
2008/07/29 (Oyranos: 0.1.8)
Date
2008/07/29
Examples:
oyranos_cmm_oJPG.c.

Member Function Documentation

◆ oyFilterSocket_Callback()

OYAPI int OYEXPORT oyFilterSocket_Callback ( oyFilterPlug_s c,
oyCONNECTOR_EVENT_e  e 
)

Tell about a oyConversion_s event.

Function oyFilterSocket_Callback

Parameters
[in,out]cthe connector
ethe event type
Returns
0 on success, else error
Version
Oyranos: 0.9.7
Date
2018/09/28
Since
2008/07/28 (Oyranos: 0.1.8)

◆ oyFilterSocket_Copy()

OYAPI oyFilterSocket_s *OYEXPORT oyFilterSocket_Copy ( oyFilterSocket_s filtersocket,
oyObject_s  object 
)

Copy or Reference a FilterSocket object.

Function oyFilterSocket_Copy

The function is for copying and for referencing. The reference is the most often used way, which saves resourcs and time.

Parameters
[in]filtersocketFilterSocket struct object
objectNULL - means reference, the optional object triggers a real copy

◆ oyFilterSocket_Copy__Members()

int oyFilterSocket_Copy__Members ( oyFilterSocket_s_ *  dst,
oyFilterSocket_s_ *  src 
)

Custom FilterSocket copy constructor.

Function oyFilterSocket_Copy__Members

◆ oyFilterSocket_GetData()

OYAPI oyStruct_s *OYEXPORT oyFilterSocket_GetData ( oyFilterSocket_s socket)

Access oyFilterSocket_s::data.

Function oyFilterSocket_GetData

Parameters
[in]socketthe socket
Returns
the data
Version
Oyranos: 0.5.0
Date
2012/10/11
Since
2012/09/23 (Oyranos: 0.5.0)

Referenced by oyFilterPlug_ImageRootRun(), and oyConnectorImaging_s::oyFilterSocket_MatchImagingPlug().

◆ oyFilterSocket_GetNode()

OYAPI oyFilterNode_s *OYEXPORT oyFilterSocket_GetNode ( oyFilterSocket_s socket)

Access oyFilterSocket_s::node.

Function oyFilterSocket_GetNode

Parameters
[in]socketthe socket
Returns
the node
Version
Oyranos: 0.5.0
Since
2012/09/05 (Oyranos: 0.5.0)
Date
2012/09/05

◆ oyFilterSocket_GetPlugs()

OYAPI oyFilterPlugs_s *OYEXPORT oyFilterSocket_GetPlugs ( oyFilterSocket_s socket)

Access oyFilterSocket_s::requesting_plugs_.

Function oyFilterSocket_GetPlugs

Parameters
[in]socketthe socket
Returns
the requesting plugs
Version
Oyranos: 0.5.0
Since
2012/09/05 (Oyranos: 0.5.0)
Date
2012/09/05

◆ oyFilterSocket_GetRelatives()

OYAPI const char *OYEXPORT oyFilterSocket_GetRelatives ( oyFilterSocket_s socket)

get short description of belonging filter

Function oyFilterSocket_GetRelatives

Parameters
[in]socketthe socket
Returns
short text
Version
Oyranos: 0.5.0
Since
2012/09/05 (Oyranos: 0.5.0)
Date
2012/09/05

◆ oyFilterSocket_Init__Members()

int oyFilterSocket_Init__Members ( oyFilterSocket_s_ *filtersocket  OY_UNUSED)

Custom FilterSocket constructor.

Function oyFilterSocket_Init__Members

◆ oyFilterSocket_New()

OYAPI oyFilterSocket_s *OYEXPORT oyFilterSocket_New ( oyObject_s  object)

allocate a new FilterSocket object

Function oyFilterSocket_New

◆ oyFilterSocket_Release()

OYAPI int OYEXPORT oyFilterSocket_Release ( oyFilterSocket_s **  filtersocket)

release and possibly deallocate a oyFilterSocket_s object

Function oyFilterSocket_Release

Parameters
[in,out]filtersocketFilterSocket struct object

◆ oyFilterSocket_Release__Members()

void oyFilterSocket_Release__Members ( oyFilterSocket_s_ *  filtersocket)

Custom FilterSocket destructor.

Function oyFilterSocket_Release__Members

◆ oyFilterSocket_SetData()

OYAPI int OYEXPORT oyFilterSocket_SetData ( oyFilterSocket_s socket,
oyStruct_s data 
)

Set oyFilterSocket_s::data.

Function oyFilterSocket_SetData

Parameters
[in]socketthe socket
[in]datathe data
Returns
error
Version
Oyranos: 0.5.0
Since
2012/09/25 (Oyranos: 0.5.0)
Date
2012/09/25

◆ oyFilterSocket_SignalToGraph()

OYAPI int OYEXPORT oyFilterSocket_SignalToGraph ( oyFilterSocket_s c,
oyCONNECTOR_EVENT_e  e 
)

Send a signal through the graph.

Function oyFilterSocket_SignalToGraph

The traversal direction is defined as from the starting node to the output.

Returns
1 if handled or zero
Version
Oyranos: 0.3.2
Since
2009/10/27 (Oyranos: 0.1.10)
Date
2011/07/10

< kind of ping

< connection established

< released the connection

< call to update image views

< new data accessors

< can not process image

< can not handle option

< can not handle profile

< can not completely process

Field Documentation

◆ copy

oyStruct_Copy_f oyFilterSocket_s::copy

Copy function.

◆ oy_

oyObject_s oyFilterSocket_s::oy_

Oyranos internal object.

Features name and hash. Do not change during object life time.

◆ release

oyStruct_Release_f oyFilterSocket_s::release

Release function.

◆ type_

const oyOBJECT_e oyFilterSocket_s::type_

Type of object.

The struct type tells Oyranos how to interprete hidden fields.

Referenced by oyConnectorImaging_s::oyFilterSocket_MatchImagingPlug().