Get values from ICC profile tags.
oyIMProfileTag_GetValues() The function implements oyCMMProfileTag_GetValues_t for oyCMMapi3_s::oyCMMProfileTag_GetValues.
- See also
- oyProfileTag_Get()
- function description are obtained by following steps:
- set the tag argument to zero
- the returned list will be filled in with oyName_s' each matching a tag_type
- oyNAME_NICK contains the module info, e.g. 'oyIM'
- oyNAME_NAME contains the tag_type, e.g. 'icSigMultiLocalizedUnicodeType' or 'mluc'
- oyNAME_DESCRIPTION contains text as in above documentation
- do not reference the list as content may be statically allocated
The output depends on the tags type signature in tag->tag_type_ as follows:
- icSigColorantOrderType and :
- since Oyranos 0.1.12 (API 0.9.7)
- returns: text list
- the number of channels
- the position of the normal channel names as strings 1 + i
- icSigColorantTableType:
- since Oyranos 0.1.12 (API 0.9.7)
- The PCS values are integers in the range of 0-65535.
- The PCS value interpretation depends on the profiles PCS header field.
- the short channel name as string in 1 + 2 * i
- PCS representation as three space separated integers in 1 + 2 * i + 1
- icSigCurveType:
- since Oyranos 0.3.1 (API 0.3.1)
- returns:
- a string describing the curve
- a option containing doubles
- first entry : count with zero means idendity, one means gamma
- more doubles means a segmented curve
- second entry : values start
- icSigTextType and icSigWCSProfileTag:
- since Oyranos 0.1.8 (API 0.9.7)
- returns one string
- icSigParametricCurveType:
- since Oyranos 0.3.1 (API 0.3.1)
- returns
- position 0 : the type of the curve as of ICC spec 10.15\
- position 1 : count of parameters - param_n\
- position 2 : first paramter for the parametric formula\
- position 2 + param_n : the number of a segmented curve - seg_count\
- position 2 + param_n + 1 : the curves value for 0.0\
- position 2 + param_n + 1 + seg_count - 1 : the curves value for 1.0
- icSigTextDescriptionType:
- since Oyranos 0.1.8 (API 0.9.7)
- returns one string
- icSigMultiLocalizedUnicodeType:
- since Oyranos 0.1.8 (API 0.9.7)
- list: should contain only strings from oyStructList_GetName()\
- oyNAME_NAME is considered to hold the name\
- oyNAME_LC is required to hold i18n specifier, e.g. "en_GB"\
- icSigSignatureType:
- since Oyranos 0.1.8 (API 0.9.7)
- returns one string
- for the value see oyICCTechnologyDescription
- icSigDescriptiveNameValueMuArrayType_:
- since Oyranos 0.1.10 (API 0.9.7)
- returns
- introduction text
- ascii string with the number (i) of the found elements
- a key string in 2 + i * 2
- a value string in in 2 + i * 2 + 1
- icSigLutAtoBType
- icSigMakeAndModelType:
- since Oyranos 0.1.8 (API 0.9.7)
- returns eigth strings, uneven is descriptive, even from a uint32_t
- manufacturer id
- model id
- serialNumber id
- manufacturer date id
- icSigNativeDisplayInfoType:
- since Oyranos 0.1.11 (API 0.9.7)
- returns a list of strings, uneven is descriptive, even contains values
- icSigNamedColor2Type:
- since Oyranos 0.9.5 (API 0.9.7)
- list: should contain the objects to create the tag
- a string describing the tag
- icSigDictType:
- since Oyranos 0.1.10 (API 0.9.7)
- returns four strings each originating from a uint32_t
- the size of components (c) as ascii string (2 - key/value pairs; 3 - key/value pairs + key UI translations, 3 - key/value pairs + key UI translations + value UI translations)
- the number (i) of the found elements as ascii string
- key string in 2 + i * c
- value string in 2 + i * c + 1
- oyStructList_s with language strings in 2 + i * c + 2
- oyStructList_s with language strings in 2 + i * c + 3
- icSigProfileSequenceDescType:
- since Oyranos 0.1.8 (API 0.9.7)
- returns
- first string as ascii the number (i) of the found elements
- a profile anounce string in 1 + i * 7
- the translated "Manufacturer:" string in 1 + i * 7 + 1
- the manufacturer string in 1 + i * 7 + 2, the full lenght or 4 byte
- the translated "Model:" string in 1 + i * 7 + 3
- the model string in 1 + i * 7 + 4, the full lenght or 4 byte one
- the translated "Technology:" string in 1 + i * 7 + 5
- the tech string in 1 + i * 7 + 6, see oyICCTechnologyDescription
- icSigProfileSequenceIdentifierType:
- since Oyranos 0.1.8 (API 0.9.7)
- returns
- first string as ascii the number (i) of the found elements
- a profile anounce string in 1 + i * 5
- the string "md5id:" in in 1 + i * 5 + 1
- the low letter hexadecimal hash value in 1 + i * 5 + 2
- mluc translated by oyICCTagDescription in 1 + i * 5 + 3
- the icSigProfileDescriptionTag according to language in 1 + i * 5 + 4
- icSigDeviceSettingsType:
- since Oyranos 0.1.10 (API 0.9.7)
- returns
- version announce string
- string version
- announce string
- device serial
- announce string
- driver name
- announce string
- driver version
- announce string
- driver signature/encoding
- announce string
- priority (0-255)
- announce string
- oyBlob_s data blob
icSigXYZType:
- since Oyranos 0.9.0 (API 0.9.7)
- a string describing the values
- a option containing doubles
- first entry : CIE *X
- second entry: CIE *Y
- third entry : CIE *Z
- Version
- Oyranos: 0.9.7
- Date
- 2017/10/24
- Since
- 2008/01/02 (Oyranos: 0.1.8)
References oy_debug, OY_PROFILE_NONE, oyDOUBLE, oyEDITING_LAB, oyICCGetColorSpaceWithChannelCount(), oyICCTagDescription(), oyICCTagName(), oyICCTagTypeName(), oyICCTechnologyDescription(), oyIMIconv(), oyNAME_LC, oyNAME_NAME, oyOBJECT_NAME_S, oySIGNATURE_COLOR_SPACE, oyValueInt32(), oyValueUInt16(), and oyValueUInt32().
Referenced by oyIMProfileTag_Create().