oyranos_core.h File Reference

public Oyranos API's More...

#include <stdarg.h>
#include "oyranos_version.h"
#include "oyranos_types.h"

Enumerations
enum	oyNAME_e { oyNAME_NAME, oyNAME_NICK, oyNAME_DESCRIPTION }
	Information levelMessages consist of text, which contains information depending on the purpose. The information provider obtains with this enum a brief request, what to put into a information request. More...

Functions
int	oyMessageFormat (char **message_text, int code, const void *context, const char *string)
	default function to form a message string More...
int	oyMessageFunc (int code, const void *context_object, const char *format,...)
	default message function to console More...
int	oyMessageFuncSet (oyMessage_f message_func)
int	oyVersion (int type)
	give the compiled in library version More...
char *	oyVersionString (int type, oyAlloc_f allocateFunc)
	give the configure options for Oyranos More...
void	oyI18NSet (int active, int reserved)
	switch internationalisation of strings on or off More...
const char *	oyLanguage (void)
	get language code More...
const char *	oyCountry (void)
	get country code More...
const char *	oyLang (void)
	get LANG code/variable More...
void	oyI18Nreset (void)
	reset i18n language and country variables More...
int	oyStringAddPrintf (char **text, oyAlloc_f allocateFunc, oyDeAlloc_f deallocFunc, const char *format,...)
	Append a string and handle memory. More...
char **	oyStringSplit (const char *text, const char delimiter, int *count, oyAlloc_f allocateFunc)
	Create a array of strings. More...
void	oyStringListRelease (char ***l, int size, oyDeAlloc_f deallocFunc)
	Release a array of strings. More...
char *	oyStringCopy (const char *text, oyAlloc_f allocateFunc)
	Copy with allocator. More...

Variables
int	oy_debug
	Set debug level. More...
const char *	oy_domain_codeset
	codeset for Oyranos More...

Detailed Description

public Oyranos API's

Oyranos is an open source Color Management System

Copyright:

2004-2011 (C) Kai-Uwe Behrmann

Author

Kai-Uwe Behrmann ku.b@.nosp@m.gmx..nosp@m.de

License:

new BSD http://www.opensource.org/licenses/BSD-3-Clause

Since

2004/11/25

Function Documentation

int oyMessageFormat	(	char **	message_text,
		int	code,
		const void *	context_object,
		const char *	string
	)

default function to form a message string

Function oyMessageFormat This default message function is used as a message formatter. The resulting string can be placed anywhere, e.g. in a GUI.

See Also

the oyMessageFunc() needs just to replace the fprintf with your favourite GUI call.

Version

Oyranos: 0.2.1

Since

2008/04/03 (Oyranos: 0.2.1)

Date

2011/01/15

References oyStruct_s::oy_, oy_debug, oyNAME_NAME, oyObject_GetId(), oyStruct_s::oyStruct_GetInfo(), oyStruct_s::oyStructTypeToText(), and oyStruct_s::type_.

Referenced by oyMessageFunc().

int oyMessageFunc	(	int	code,
		const void *	context_object,
		const char *	format,
			...
	)

default message function to console

Function oyMessageFunc The default message function is used as a message printer to the console from library start.

Parameters

code	a message code understood be your message handler or oyMSG_e
context_object	a oyStruct_s is expected from Oyranos
format	the text format string for following args
...	the variable args fitting to format

Returns

0 - success; 1 - error

Version

Oyranos: 0.3.0

Since

2008/04/03 (Oyranos: 0.1.8)

Date

2009/07/20

Examples:

oyranos_cmm_oJPG.c.

References oyMessageFormat().

int oyMessageFuncSet

(

oyMessage_f

message_func

)

Function oyMessageFuncSet

Version

Oyranos: 0.1.8

Date

2008/04/03

Since

2008/04/03 (Oyranos: 0.1.8)

Variable Documentation

int oy_debug

Set debug level.

Variable oy_debug

Version

Oyranos: 0.0.1

Date

2005/02/01

Since

2005/02/01 (Oyranos: 0.0.1)

Examples:

image_display.cpp, and oyranos_cmm_oJPG.c.

Referenced by Config_Rank(), Configs_FromPattern(), l2cmsAddProfile(), l2cmsAddProofProfile(), l2cmsCMMConversionContextCreate_(), l2cmsCMMData_Open(), l2cmsCMMProfile_GetWrap_(), l2cmsFilterNode_CmmIccContextToMem(), l2cmsFilterPlug_CmmIccRun(), l2cmsGamutCheckAbstract(), l2cmsModuleData_Convert(), l2cmsTransformWrap_Set_(), lcm2AbstractWhitePoint(), lcm2AbstractWhitePointBradford(), lcmsAddProofProfile(), lcmsCMMConversionContextCreate_(), lcmsFilterNode_CmmIccContextToMem(), lcmsGamutCheckAbstract(), lrawFilterPlug_ImageInputRAWRun(), oiccChangeNodeOption(), ojpgApi7CmmCreate(), ojpgFilter_CmmRun(), oyArray2d_s::oyArray2d_SetFocus(), oyConfig_s::oyConfig_Match(), oyConfigs_s::oyConfigDomainList(), oyConversion_s::oyConversion_RunPixels(), oyDeviceSetup(), oyDevicesFromTaxiDB(), oydiFilterPlug_ImageDisplayRun(), oyFilterGraph_s::oyFilterGraph_ToText(), oyFilterNode_s::oyFilterNode_Run(), oyGetCMMs(), oyImage_s::oyImage_FillArray(), oyImage_s::oyImage_GetArray2dLineContinous(), oyImage_s::oyImage_ReadArray(), oyImage_s::oyImage_SetCritical(), oyIMProfileTag_GetValues(), oyMessageFormat(), oyObjectDebugMessage_(), oyPixelAccess_s::oyPixelAccess_SetArrayFocus(), oyPixelAccess_s::oyPixelAccess_SynchroniseROI(), oyPointer_s::oyPointer_LookUpFromObject(), oyProfile_s::oyProfile_FromFile(), oyraFilter_ImageChannelRun(), oyraFilter_ImageExposeRun(), oyraFilterPlug_ImageRectanglesRun(), oyraGetSaturationLine_(), and oyConfig_s::oyRankMapList().