oyConversion_s Struct Reference

a filter chain or graph to manipulate a image More...

#include <oyranos_alpha.h>

Collaboration diagram for oyConversion_s:

Data Fields
oyStruct_Copy_f	copy
oyStruct_Release_f	release
oyFilterNode_s *	input

---

Detailed Description

a filter chain or graph to manipulate a image

Order of filters matters. The processing direction is a bit like raytracing as nodes request their parent.

The graph is allowed to be a directed graph without cycles.

oyConversion_s shall provide access to the graph and help in processing and managing nodes.

Creating Graphs:
Most simple is to use the oyConversion_CreateBasicPixles() function to create a profile to profile and possible image buffer to image buffer linear graph.
The other possibility is to create a non linear graph. The input member can be accessed for this directly.

While it would be possible to have several open ends in a graph, there are two endpoints considered as special. The input member prepresents the top most required node to be provided in a oyConversion_s graph. The input node is accessible for user manipulation. The other one is the out_ member. It is the closing node in the graph. It will be set by Oyranos during closing the graph, e.g. in oyConversion_LinOutputAdd().

Using Graphs:
To obtain the data the oyConversion_GetNextPixel() and oyConversion_GetOnePixel() functions are available.

Version:

Oyranos: 0.1.8

Since:

2008/06/08 (Oyranos: 0.1.8)

Date:

2008/06/08

---

Field Documentation

oyStruct_Copy_f oyConversion_s::copy

copy function

oyFilterNode_s* oyConversion_s::input

the input image filter; Most users will start logically with this pice and chain their filters to get the final result.

oyStruct_Release_f oyConversion_s::release

release function