Manipulate and abstract values. More...

Collaboration diagram for Values Handling:

Data Structures
struct	oyBlob_s
	A data blob object. More...
struct	oyConfig_s
	A group of options for a device. More...
struct	oyConfigs_s
	A Configs list. More...
union	oyValue_u
	a value More...
struct	oyOption_s
	Option object. More...
struct	oyOptions_s
	generic Options More...

Macros
#define	OY_CREATE_NEW 0x02
#define	OY_ADD_ALWAYS 0x04
#define	OY_MATCH_KEY 0x08
#define	OY_SELECT_FILTER 2048
	select from filter
#define	OY_SELECT_COMMON 4096
	select from policySelect typical from a associatable oyCMMapi9_s type of filter for providing common options.

Enumerations
enum	oyOPTIONATTRIBUTE_e { oyOPTIONATTRIBUTE_BASIC = 0, oyOPTIONATTRIBUTE_EDIT = 32, oyOPTIONATTRIBUTE_AUTOMATIC = 64, oyOPTIONATTRIBUTE_ADVANCED = 128, oyOPTIONATTRIBUTE_FRONT = 256, oyOPTIONATTRIBUTE_DOUBLE = 512 }
	usage typeThe types of Oyranos default settings to include into the options set. So proofing makes no sense for toolkit widgets, but for advanced graphics displaying. All other Oyranos behaviour settings should be taken over untouched. More...

Functions
int	oyDbHandlingReady (void)
	tell if DB handling is ready
int	oyDbHandlingSet (const oyDbAPI_s *db_api)
	set DB functions for persistent settingsBe careful to set the APIs only before any call to the oyDB_s functions. Otherwise the behaviour is undefined.
int	oyGetPersistentStrings (const char *top_key_name)
	cache strings from DB
char *	oyGetPersistentString (const char *key_name, uint32_t flags, oySCOPE_e scope, oyAlloc_f alloc_func)
	get a cached string from DB
int	oySetPersistentString (const char key_name, oySCOPE_e scope, const char value, const char *comment)
	set string into DB and cache
OYAPI oyConfDomain_s *OYEXPORT	oyConfDomain_s::oyConfDomain_FromReg (const char *registration_domain, oyObject_s object)
	allocate a new ConfDomain object
OYAPI oyConfDomain_s *OYEXPORT	oyConfDomain_s::oyConfDomain_Copy (oyConfDomain_s *obj, oyObject_s object)
	copy or reference a ConfDomain object
OYAPI int OYEXPORT	oyConfDomain_s::oyConfDomain_Release (oyConfDomain_s **obj)
	release and possibly deallocate a ConfDomain object
OYAPI const char *OYEXPORT	oyConfDomain_s::oyConfDomain_GetText (oyConfDomain_s obj, const char name, oyNAME_e type)
	obtain a UI text from a ConfDomain object
OYAPI const char **OYEXPORT	oyConfDomain_s::oyConfDomain_GetTexts (oyConfDomain_s *obj)
	obtain a list of possible UI text from a ConfDomain object

Detailed Description

Manipulate and abstract values.

Macro Definition Documentation

#define OY_ADD_ALWAYS 0x04

no check for double occurencies; do not use for configurations

#define OY_CREATE_NEW 0x02

create

Examples:: image_display.cpp, oyranos_cmm_oJPG.c, tutorial1.c, tutorial_json_options.c, and tutorial_taxi.c.

Referenced by oyArray2d_s::oyArray2d_Show(), oyConfig_s::oyConfig_SaveToDB(), oyConfigs_s::oyConfigs_FromDB(), oyDeviceFromJSON(), oyDeviceSelectSimiliar(), oyDeviceSetProfile(), oyDeviceSetup(), oyDevicesFromTaxiDB(), oyImage_s::oyImage_Create(), oyImage_s::oyImage_CreateForDisplay(), oyImage_s::oyImage_FromFile(), oyImage_s::oyImage_ToFile(), oyObject_SetName(), and oyProfile_s::oyProfile_GetFileName().

#define OY_MATCH_KEY 0x08

check for double occurencies of key name, ignoring the path

Referenced by oyOptions_s::oyOptions_MoveInStruct(), oyOptions_s::oyOptions_SetFromData(), oyOptions_s::oyOptions_SetFromDouble(), oyOptions_s::oyOptions_SetFromInt(), and oyOptions_s::oyOptions_SetFromText().

#define OY_SELECT_COMMON 4096

select from policySelect typical from a associatable oyCMMapi9_s type of filter for providing common options.

Version: Oyranos: 0.1.10

Since: 2009/07/27 (Oyranos: 0.1.10)

Date: 2009/07/27

Referenced by oyOptions_s::oyOptions_ForFilter_().

#define OY_SELECT_FILTER 2048

select from filter

Version: Oyranos: 0.1.10

Since: 2009/07/27 (Oyranos: 0.1.10)

Date: 2009/07/27

Examples:: image_display.cpp.

Referenced by oyImage_s::oyImage_FromFile(), oyImage_s::oyImage_ToFile(), and oyOptions_s::oyOptions_ForFilter_().

Enumeration Type Documentation

enum oyOPTIONATTRIBUTE_e

usage typeThe types of Oyranos default settings to include into the options set. So proofing makes no sense for toolkit widgets, but for advanced graphics displaying. All other Oyranos behaviour settings should be taken over untouched.

The ".invisible" attribute says a option shall not be displayed in a GUI. The ".readonly" attribute alllows for unchangeable, static options. They might be used for passing additional informations. The ".font" and ".advanced" attributes are described for the according enum values.

See as well Registration

Version: Oyranos: 0.1.9

Since: 2008/10/08 (Oyranos: 0.1.8)

Date: 2008/11/27

Enumerator:

oyOPTIONATTRIBUTE_BASIC	basic settings, as typical for toolkits and office/web applications, e.g. disable proofing or disable mark out of gamut colors
oyOPTIONATTRIBUTE_EDIT	user modified, e.g. after oyOption_SetFromText()
oyOPTIONATTRIBUTE_AUTOMATIC	automatically modified, e.g. by a CMM
oyOPTIONATTRIBUTE_ADVANCED	advanced settings, as typical for editing, e.g. include proofing (options appended with ".advanced")
oyOPTIONATTRIBUTE_FRONT	front end options, handled by the framework or policy module, e.g. ".front"
oyOPTIONATTRIBUTE_DOUBLE	tell this options is included twice

Function Documentation

OYAPI oyConfDomain_s *OYEXPORT oyConfDomain_Copy	(	oyConfDomain_s *	obj,
		oyObject_s	object
	)

copy or reference a ConfDomain object

Function oyConfDomain_Copy

Parameters

[in]	obj	struct object
	object	the optional object

Version: Oyranos: 0.1.10

Since: 2009/12/30 (Oyranos: 0.1.10)

Date: 2009/12/30

References oyOBJECT_CONF_DOMAIN_S.

OYAPI oyConfDomain_s *OYEXPORT oyConfDomain_FromReg	(	const char *	registration_domain,
		oyObject_s	object
	)

allocate a new ConfDomain object

Function oyConfDomain_New

Version: Oyranos: 0.1.10

Since: 2009/12/30 (Oyranos: 0.1.10)

Date: 2009/12/30

Referenced by oyDeviceToJSON().

OYAPI const char *OYEXPORT oyConfDomain_GetText	(	oyConfDomain_s *	obj,
		const char *	name,
		oyNAME_e	type
	)

obtain a UI text from a ConfDomain object

Function oyConfDomain_GetText

Parameters

[in,out]	obj	struct object
[in]	name	the category to return
[in]	type	the type of string

Version: Oyranos: 0.1.10

Since: 2009/12/30 (Oyranos: 0.1.10)

Date: 2009/12/30

References oyOBJECT_CONF_DOMAIN_S.

Referenced by oyDeviceToJSON().

OYAPI const char **OYEXPORT oyConfDomain_GetTexts ( oyConfDomain_s * obj )

obtain a list of possible UI text from a ConfDomain object

Function oyConfDomain_GetTexts

Returns: zero terminated list of strings, Each string is a "name" option to oyConfDomain_GetText().

Version: Oyranos: 0.1.10

Since: 2009/12/30 (Oyranos: 0.1.10)

Date: 2009/12/30

References oyOBJECT_CONF_DOMAIN_S.

OYAPI int OYEXPORT oyConfDomain_Release ( oyConfDomain_s ** obj )

release and possibly deallocate a ConfDomain object

Function oyConfDomain_Release

Parameters

[in,out] obj struct object

Version: Oyranos: 0.1.10

Since: 2009/12/30 (Oyranos: 0.1.10)

Date: 2009/12/30

References oyOBJECT_CONF_DOMAIN_S.

Referenced by oyDeviceToJSON().

int oyDbHandlingReady ( void )

tell if DB handling is ready

Version: Oyranos: 0.9.6

Date: 2016/10/23

Since: 2016/10/23 (Oyranos: 0.9.6)

int oyDbHandlingSet ( const oyDbAPI_s * db_api )

set DB functions for persistent settingsBe careful to set the APIs only before any call to the oyDB_s functions. Otherwise the behaviour is undefined.

Version: Oyranos: 0.9.6

Date: 2016/10/23

Since: 2016/10/23 (Oyranos: 0.9.6)

char* oyGetPersistentString	(	const char *	key_name,
		uint32_t	flags,
		oySCOPE_e	scope,
		oyAlloc_f	alloc_func
	)

get a cached string from DB

Function oyGetPersistentString

Parameters

key_name	the DB key name
flags	0 for cached string or oySOURCE_DATA for a likely expensive DB lookup
scope	user/system or both, works together with flags \|= oySOURCE_DATA
alloc_func	the user allocator

Returns: the cached value

Version: Oyranos: 0.9.6

Date: 2015/02/06

Since: 2015/02/06 (Oyranos: 0.9.6)

Referenced by oyDeviceSetup(), oyDeviceUnset(), oyGetFilterNodeRegFromDB(), and oyOption_s::oyOption_SetValueFromDB().

int oyGetPersistentStrings ( const char * top_key_name )

cache strings from DB

Function oyGetPersistentStrings

Parameters

[in] top_key_name the DB root key, zero clears the DB cache; use for example OY_STD

Returns: error

Version: Oyranos: 0.9.6

Date: 2016/03/02

Since: 2015/02/26 (Oyranos: 0.9.6)

int oySetPersistentString	(	const char *	key_name,
		oySCOPE_e	scope,
		const char *	value,
		const char *	comment
	)

set string into DB and cache

Function oySetPersistentString

Parameters

key_name	the DB key name
scope	possible values are: oySCOPE_USER oySCOPE_SYS oySCOPE_USER_SYS means, you are your own with prefixing
value	the value string
comment	the comment string

Returns: DB specific return code

Version: Oyranos: 0.9.6

Date: 2015/02/06

Since: 2015/02/06 (Oyranos: 0.9.6)

Examples:: image_display.cpp.

Referenced by oyDeviceSetup(), oyDeviceUnset(), and oyOptions_s::oyOptions_SaveToDB().

Data Structures

Macros

Enumerations

Functions

Detailed Description

Macro Definition Documentation

Enumeration Type Documentation

Function Documentation