test

KCMS Application Developer's Guide

KcsAttributeValue 

typedef struct KcsAttributeValue_s {
      KcsAttributeBase                               base;
      union KcsAttributeValueValue_s {
           struct tm                 dateTimeVal;
           long                      longVal[KcsExtendableArray];
           double                    doubleVal[KcsExtendableArray];
           char                      byteVal[KcsExtendableArray];
           unsigned char             uByteVal[KcsExtendableArray];
           short                     shortVal[KcsExtendableArray];
           unsigned short            uShortVal[KcsExtendableArray];
           unsigned long             uLongVal[KcsExtendableArray];
           KcsPixelLayoutSpeeds      layoutVal[KcsExtendablePixelLayout];
           /* ICC 3.0 values */
           icText                    icText;
           icData                    icData;
           icCurve                   icCurve;
           icUcrBg                   icUcrBg;
           icNamedColor2             icNamedColor2;
           icScreening               icScreening;
           icSignature               icSignature;
           icMeasurement             icMeasurement;
           icDateTimeNumber          icDateTime;
           icViewingCondition        icViewingCondition;
           icTextDescription         icTextDescription;
           icProfileSequenceDesc     icProfileSequenceDescription;
           icXYZArray                icXYZ;
           icInt8Array               icInt8Array;
           icInt16Array              icInt16Array;
           icInt32Array              icInt32Array;
           icInt64Array              icInt64Array;
           icUInt8Array              icUInt8Array;
           icUInt16Array             icUInt16Array;
           icUInt32Array             icUInt32Array;
           icUInt64Array             icUInt64Array;
           icS15Fixed16Array         icS15Fixed16Array;
           icU16Fixed16Array         icU16Fixed16Array
           icHeader                  icHeader
      } KcsAttributeValueValue;
 } KcsAttributeValue;
Note -

The KcsAttributeValueValue data type is included in this type definition.

The KcsAttributeValue structure is the data type of one argument in:

A variable of data type KcsAttributeValue holds the value of an attribute. An attribute's value fits in a normal KcsAttributeValue structure. However, your application may have to extend the KcsAttributeValue structure if the number of values an attribute contains is greater than the number in the default size of the structure. The "C" API macro KCS_DEFAULT_ATTRIB_COUNT returns the values that a variable of this type can hold. (For more information on KCS_DEFAULT_ATTRIB_COUNT, see the description of KcsAttributeBase on "KcsAttributeBase".) For example, to have more values in an attribute than the value returned from the macro, your application can extend the structure by allocating more memory and then casting it as a pointer to a KcsAttributeValue structure. Because it is specified as an array at the end of the structure, and C does not check array bounds, your application can allocate a piece of memory larger than KcsAttributeValue and treat the extra memory as an extension of the val arrays. This allows your application to access the values using the array operator (myAttributeValuePtr->val.doubleVal[i]).

For example, the following code shows you how to get the colorant from a profile.

Example 3-1 KcsAttributeValue 

/* Get the colorants */
 /* Red */
 KcsAttributeValue     *attrValuePtr;

 attrValuePtr = (KcsAttributeValue *)malloc(sizeof(KcsAttributeBase) +
                sizeof(icXYZNumber) );
 attrValuePtr->base.type = icSigXYZArrayType;
 attrValuePtr->base.countSupplied = 1;
 status = KcsGetAttribute(profileid, icSigRedColorantTag, attrValuePtr);
 if(status != KCS_SUCCESS) {
      status = KcsGetLastError(&errDesc);
      printf("GetAttribute error: %s\n", errDesc.desc);
      KcsFreeProfile(profileid);
      exit(1);
 }

 XYZval = (icXYZNumber *)attrValuePtr->val.icXYZ.data;
 printf("Red X=%f Y=%f Z=%f\n", icfixed2double(XYZval->X, icSigS15Fixed16ArrayType),
             icfixed2double(XYZval->Y, icSigS15Fixed16ArrayType), icfixed2double(XYZval->Z,
             icSigS15Fixed16ArrayType));
 /* Green */   
 status = KcsGetAttribute(profileid, icSigGreenColorantTag, attrValuePtr);
 if(status != KCS_SUCCESS) {
      status = KcsGetLastError(&errDesc);
      printf("SetAttribute error: %s\n", errDesc.desc);
      KcsFreeProfile(profileid);
      exit(1);
 }

 XYZval = (icXYZNumber *)attrValuePtr->val.icXYZ.data;
 printf("Green X=%f Y=%f Z=%f\n", icfixed2double(XYZval->X, icSigS15Fixed16ArrayType),
             icfixed2double(XYZval->Y, icSigS15Fixed16ArrayType), icfixed2double(XYZval->Z,
             icSigS15Fixed16ArrayType));

 /* Blue */
 status = KcsGetAttribute(profileid, icSigBlueColorantTag, attrValuePtr);
 if(status != KCS_SUCCESS) {
      status = KcsGetLastError(&errDesc);
      printf("SetAttribute error: %s\n", errDesc.desc);
      KcsFreeProfile(profileid);
      exit(1);
 }

 XYZval = (icXYZNumber *)attrValuePtr->val.icXYZ.data;
 printf("Blue X=%f Y=%f Z=%f\n", icfixed2double(XYZval->X, icSigS15Fixed16ArrayType),
             icfixed2double(XYZval->Y, icSigS15Fixed16ArrayType), icfixed2double(XYZval->Z,
             icSigS15Fixed16ArrayType));
 free(attrValuePtr);

If an attribute returns just one long value, use the following code fragment: 


KcsAttributeValue myAttributeValue;
 myAttributeValue.base.countSupplied = 1;
 KcsGetAttribute(myProfile, myAttributeName, &myAttributeValue);